@ztwoint/z-ui 0.1.147 → 0.1.148

package/dist/index.d.ts

@@ -36,5 +36,6 @@ export * from './components/primitives/chart-card';
 export * from './components/radio-card/radio-card';
 export * from './components/z2map';
 export * from './components/kpi-card';
+export * from './components/pdf-preview';
 export * from './lib/theme.hook';
 export * from './lib/utils';

package/dist/index.js

@@ -1,5 +1,5 @@
 /* empty css                    */
-import { Alert as p, AlertDescription as n, AlertTitle as f } from "./components/alert/alert.js";
+import { Alert as p, AlertDescription as f, AlertTitle as n } from "./components/alert/alert.js";
 import { AlertCirclesIcon as m } from "./components/alert/icons/circles-icon.js";
 import { Button as x, buttonVariants as i } from "./components/button/button.js";
 import { Z2SideNavBarProvider as Z } from "./components/collapsible-side-nav-bar/side-nav-bar-provider.js";
@@ -8,8 +8,8 @@ import { Z2SideNavBarHeader as S } from "./components/collapsible-side-nav-bar/s
 import { Z2SideNavBarContent as I } from "./components/collapsible-side-nav-bar/side-nav-bar-content.js";
 import { Z2SideNavBarFooter as D } from "./components/collapsible-side-nav-bar/side-nav-bar-footer.js";
 import { Z2SideNavBarGroup as h } from "./components/collapsible-side-nav-bar/side-nav-bar-group.js";
-import { Z2SideNavBarItem as v } from "./components/collapsible-side-nav-bar/side-nav-bar-item.js";
-import { Z2SideNavBarSeparator as M } from "./components/collapsible-side-nav-bar/side-nav-bar-separator.js";
+import { Z2SideNavBarItem as B } from "./components/collapsible-side-nav-bar/side-nav-bar-item.js";
+import { Z2SideNavBarSeparator as P } from "./components/collapsible-side-nav-bar/side-nav-bar-separator.js";
 import { useZ2SideNavBar as R } from "./components/collapsible-side-nav-bar/context.js";
 import { Z2Popover as E } from "./components/collapsible-side-nav-bar/popover/popover.js";
 import "react/jsx-runtime";
@@ -23,23 +23,23 @@ import { SIDEBAR_WIDTH as Q, SIDEBAR_WIDTH_COLLAPSED as j } from "./components/c
 import { CountryFlags as oo } from "./components/country-flags/country-flags.js";
 import { Z2Checkbox as ro } from "./components/checkbox/checkbox.js";
 import { CheckboxFilter as ao } from "./components/checkbox-filter/index.js";
-import { Z2Dialog as no, Z2DialogClose as fo, Z2DialogContent as lo, Z2DialogDescription as mo, Z2DialogFooter as xo, Z2DialogHeader as io, Z2DialogOverlay as uo, Z2DialogPortal as Zo, Z2DialogTitle as co, Z2DialogTrigger as so } from "./components/dialog/dialog.js";
-import { DropdownContext as bo, Z2Dropdown as So, Z2DropdownContent as To, Z2DropdownInput as Io, Z2DropdownItem as go, Z2DropdownSub as Do, Z2DropdownSubContent as wo, Z2DropdownSubItem as ho, Z2DropdownSubTrigger as Bo } from "./components/dropdown/z2-dropdown.js";
-import { Z2DropdownMenu as Lo, Z2DropdownMenuCheckboxItem as Mo, Z2DropdownMenuContent as Po, Z2DropdownMenuGroup as Ro, Z2DropdownMenuItem as Ao, Z2DropdownMenuLabel as Eo, Z2DropdownMenuPortal as yo, Z2DropdownMenuRadioGroup as ko, Z2DropdownMenuRadioItem as No, Z2DropdownMenuSeparator as Ho, Z2DropdownMenuShortcut as _o, Z2DropdownMenuSub as Fo, Z2DropdownMenuSubContent as Oo, Z2DropdownMenuSubTrigger as Go, Z2DropdownMenuTrigger as Vo } from "./components/dropdown-menu/z2-dropdown-menu.js";
+import { Z2Dialog as fo, Z2DialogClose as no, Z2DialogContent as lo, Z2DialogDescription as mo, Z2DialogFooter as xo, Z2DialogHeader as io, Z2DialogOverlay as uo, Z2DialogPortal as Zo, Z2DialogTitle as co, Z2DialogTrigger as so } from "./components/dialog/dialog.js";
+import { DropdownContext as bo, Z2Dropdown as So, Z2DropdownContent as To, Z2DropdownInput as Io, Z2DropdownItem as go, Z2DropdownSub as Do, Z2DropdownSubContent as wo, Z2DropdownSubItem as ho, Z2DropdownSubTrigger as vo } from "./components/dropdown/z2-dropdown.js";
+import { Z2DropdownMenu as Lo, Z2DropdownMenuCheckboxItem as Po, Z2DropdownMenuContent as Mo, Z2DropdownMenuGroup as Ro, Z2DropdownMenuItem as Ao, Z2DropdownMenuLabel as Eo, Z2DropdownMenuPortal as yo, Z2DropdownMenuRadioGroup as ko, Z2DropdownMenuRadioItem as No, Z2DropdownMenuSeparator as Ho, Z2DropdownMenuShortcut as _o, Z2DropdownMenuSub as Fo, Z2DropdownMenuSubContent as Oo, Z2DropdownMenuSubTrigger as Go, Z2DropdownMenuTrigger as Vo } from "./components/dropdown-menu/z2-dropdown-menu.js";
 import { FileUploadArea as Uo } from "./components/file-upload-area/file-upload-area.js";
 import { DEFAULT_ACCEPT as qo } from "./components/file-upload-area/file-upload-area.const.js";
 import { Input as zo } from "./components/input/input.js";
 import { NavHeader as Ko } from "./components/nav-header/nav-header.js";
 import { NavItem as jo } from "./components/nav-header/nav-item/nav-item.js";
-import { Z2Select as oe, Z2SelectContent as ee, Z2SelectGroup as re, Z2SelectItem as te, Z2SelectLabel as ae, Z2SelectScrollDownButton as pe, Z2SelectScrollUpButton as ne, Z2SelectSeparator as fe, Z2SelectTrigger as le, Z2SelectValue as me } from "./components/select/z2-select.js";
+import { Z2Select as oe, Z2SelectContent as ee, Z2SelectGroup as re, Z2SelectItem as te, Z2SelectLabel as ae, Z2SelectScrollDownButton as pe, Z2SelectScrollUpButton as fe, Z2SelectSeparator as ne, Z2SelectTrigger as le, Z2SelectValue as me } from "./components/select/z2-select.js";
 import { Z2SelectCompact as xe } from "./components/primitives/select-compact/select-compact.js";
 import { PopoverCompact as ue } from "./components/primitives/popover-compact/popover-compact.js";
 import { Z2Stepper as ce } from "./components/stepper/stepper.js";
 import { Z2StepperItem as Ce } from "./components/stepper-item/stepper-item.js";
 import { Z2Tabs as Se, Z2TabsContent as Te, Z2TabsList as Ie, Z2TabsTrigger as ge } from "./components/tab/tab.js";
 import { Table as we, TableProvider as he } from "./components/table/table-provider.js";
-import { TableBody as ve } from "./components/table/table.js";
-import { extractCellValue as Me } from "./components/table/table.utils.js";
+import { TableBody as Be } from "./components/table/table.js";
+import { extractCellValue as Pe } from "./components/table/table.utils.js";
 import { DEFAULT_EMPTY_MESSAGE as Re, TABLE_CSS_CLASSES as Ae } from "./components/table/table.const.js";
 import { TableContext as ye, useTableContext as ke } from "./components/table/table.context.js";
 import { TableCell as He } from "./components/table/components/table-cell.js";
@@ -54,7 +54,7 @@ import { default as $e } from "./components/assets/icons/chevron-down.js";
 import { TableRow as er } from "./components/table/components/table-row.js";
 import { TableMessageState as tr } from "./components/table/components/table-message-state.js";
 import { TableLoadingState as pr } from "./components/table/components/table-loading-state.js";
-import { Pagination as fr } from "./components/table/components/pagination/pagination.js";
+import { Pagination as nr } from "./components/table/components/pagination/pagination.js";
 import { TableHeaderWrapper as mr } from "./components/table/components/table-header-wrapper.js";
 import { TableHeaderContent as xr } from "./components/table/components/table-header-content.js";
 import { TableFooter as ur } from "./components/table/components/table-footer.js";
@@ -65,8 +65,8 @@ import { PaginationQuickJumper as Ir } from "./components/table/components/pagin
 import "react";
 import { Z2Tooltip as Dr } from "./components/tooltip/tooltip.js";
 import { default as hr } from "./components/primitives/table-card/table-card.js";
-import { Badge as vr, badgeVariants as Lr } from "./components/badge/badge.js";
-import { Avatar as Pr, AvatarWithLabel as Rr } from "./components/avatar/avatar.js";
+import { Badge as Br, badgeVariants as Lr } from "./components/badge/badge.js";
+import { Avatar as Mr, AvatarWithLabel as Rr } from "./components/avatar/avatar.js";
 import { Z2TextPreset as Er } from "./components/text-preset/text-preset.js";
 import { ColumnReOrder as kr } from "./components/column-reorder/column-reorder.js";
 import { default as Hr } from "./components/tree-checkbox-select/TreeCheckboxSelect.js";
@@ -77,7 +77,7 @@ import { Check as $r } from "./components/assets/icons/check.js";
 import { default as et } from "./components/assets/icons/chevron-left.js";
 import { default as tt } from "./components/assets/icons/chevron-right.js";
 import { default as pt } from "./components/assets/icons/circle-check-filled.js";
-import { default as ft } from "./components/assets/icons/circle-check.js";
+import { default as nt } from "./components/assets/icons/circle-check.js";
 import { default as mt } from "./components/assets/icons/dots.js";
 import { default as xt } from "./components/assets/icons/double-chevron-left.js";
 import { default as ut } from "./components/assets/icons/double-chevron-right.js";
@@ -87,8 +87,8 @@ import { InfoIcon as St } from "./components/assets/icons/info-icon.js";
 import { default as It } from "./components/assets/icons/left-arrow.js";
 import { default as Dt } from "./components/assets/icons/link.js";
 import { default as ht } from "./components/assets/icons/list-tree.js";
-import { default as vt } from "./components/assets/icons/media-record.js";
-import { Minus as Mt } from "./components/assets/icons/minus.js";
+import { default as Bt } from "./components/assets/icons/media-record.js";
+import { Minus as Pt } from "./components/assets/icons/minus.js";
 import { default as Rt } from "./components/assets/icons/octagon-warning-Copy.js";
 import { default as Et } from "./components/assets/icons/pin.js";
 import { default as kt } from "./components/assets/icons/sitemap.js";
@@ -104,7 +104,7 @@ import { default as $t } from "./components/assets/icons/vector_3.js";
 import { default as ea } from "./components/assets/icons/table-cols-2.js";
 import { default as ta } from "./components/assets/icons/triangle-warning.js";
 import { default as pa } from "./components/assets/icons/arrow-left.js";
-import { default as fa } from "./components/assets/icons/filter-icon.js";
+import { default as na } from "./components/assets/icons/filter-icon.js";
 import { default as ma } from "./components/assets/icons/descending.js";
 import { default as xa } from "./components/assets/icons/chain.js";
 import { default as ua } from "./components/assets/icons/eraser.js";
@@ -112,45 +112,46 @@ import { default as ca } from "./components/assets/icons/left-square-bracket.js"
 import { default as Ca } from "./components/assets/icons/right-square-bracket.js";
 import { SegmentedControl as Sa } from "./components/segmented-control/controller.js";
 import { SegmentedControlItem as Ia } from "./components/segmented-control/item.js";
-import { Popover as Da, PopoverAnchor as wa, PopoverContent as ha, PopoverTrigger as Ba } from "./components/popover/popover.js";
+import { Popover as Da, PopoverAnchor as wa, PopoverContent as ha, PopoverTrigger as va } from "./components/popover/popover.js";
 import { Popconfirm as La } from "./components/primitives/popconfirm/popconfirm.js";
-import { Z2Table as Pa, Z2TableBase as Ra, Z2TableBody as Aa, Z2TableBodyRow as Ea, Z2TableBodyRowCell as ya, Z2TableBodyRowExpandded as ka, Z2TableBodyRowSkeleton as Na, Z2TableBodyRowSkeletonCell as Ha, Z2TableEmpty as _a, Z2TableHead as Fa, Z2TableHeadRow as Oa, Z2TableHeadRowCell as Ga, Z2TableHeadRowCellResize as Va, Z2TableLoader as Wa, Z2TableRowSelect as Ua, Z2TableRowSelectAll as Xa, Z2TableRowSpacer as qa } from "./components/dynamic-table/z2-table.js";
+import { Z2Table as Ma, Z2TableBase as Ra, Z2TableBody as Aa, Z2TableBodyRow as Ea, Z2TableBodyRowCell as ya, Z2TableBodyRowExpandded as ka, Z2TableBodyRowSkeleton as Na, Z2TableBodyRowSkeletonCell as Ha, Z2TableEmpty as _a, Z2TableHead as Fa, Z2TableHeadRow as Oa, Z2TableHeadRowCell as Ga, Z2TableHeadRowCellResize as Va, Z2TableLoader as Wa, Z2TableRowSelect as Ua, Z2TableRowSelectAll as Xa, Z2TableRowSpacer as qa } from "./components/dynamic-table/z2-table.js";
 import { Z2TableContainer as za, Z2TableProvider as Ja, Z2TableRoot as Ka, useZ2Table as Qa } from "./components/dynamic-table/z2-table-context.js";
 import { Z2TablePagination as $a } from "./components/dynamic-table/z2-table-pagination.js";
 import { Z2TableColumnHeader as ep } from "./components/dynamic-table/z2-column-header.js";
 import { Chart as tp } from "./components/chart/chart.js";
 import { ChartCard as pp } from "./components/primitives/chart-card/chart-card.js";
-import { EmptyState as fp, ErrorState as lp, LoadingState as mp } from "./components/primitives/chart-card/chart-card-states.js";
+import { EmptyState as np, ErrorState as lp, LoadingState as mp } from "./components/primitives/chart-card/chart-card-states.js";
 import { COLOR_PALETTES as xp, UI_COLORS as ip, getThemePalette as up } from "./components/primitives/chart-card/config/colors.js";
 import { validateChartConfig as cp, validateChartData as sp } from "./components/primitives/chart-card/validators/config-validator.js";
 import { buildBarChartOptions as bp } from "./components/primitives/chart-card/builders/bar-chart-builder.js";
 import { buildLineChartOptions as Tp } from "./components/primitives/chart-card/builders/line-chart-builder.js";
 import { buildChartOptions as gp, isChartTypeSupported as Dp, registeredChartTypes as wp } from "./components/primitives/chart-card/builders/chart-builder-factory.js";
-import { Z2RadioCard as Bp } from "./components/radio-card/radio-card.js";
+import { Z2RadioCard as vp } from "./components/radio-card/radio-card.js";
 import { default as Lp } from "./components/z2map/map.js";
-import { DEFAULT_MAP_CONFIG as Pp, MAP_VARIANTS as Rp, PIN_SIZES as Ap } from "./components/z2map/map.constants.js";
+import { DEFAULT_MAP_CONFIG as Mp, MAP_VARIANTS as Rp, PIN_SIZES as Ap } from "./components/z2map/map.constants.js";
 import { MapPinComponent as yp } from "./components/z2map/components/map-pin.js";
 import { MapPinContent as Np } from "./components/z2map/components/map-pin-content.js";
 import { MapControls as _p } from "./components/z2map/components/map-controls.js";
 import { MapZoomControl as Op } from "./components/z2map/components/map-zoom-control.js";
 import { MapStyleControl as Vp } from "./components/z2map/components/map-style-control.js";
 import { KpiCard as Up, kpiCardVariants as Xp } from "./components/kpi-card/kpi-card.js";
-import { useTheme as Yp } from "./lib/theme.hook.js";
-import { cn as Jp } from "./lib/utils.js";
-import { Z2PopoverTrigger as Qp } from "./components/collapsible-side-nav-bar/popover/popover-trigger.js";
-import { Z2PopoverContent as $p } from "./components/collapsible-side-nav-bar/popover/popover-content.js";
+import { PdfPreview as Yp } from "./components/pdf-preview/pdf-preview.js";
+import { useTheme as Jp } from "./lib/theme.hook.js";
+import { cn as Qp } from "./lib/utils.js";
+import { Z2PopoverTrigger as $p } from "./components/collapsible-side-nav-bar/popover/popover-trigger.js";
+import { Z2PopoverContent as ef } from "./components/collapsible-side-nav-bar/popover/popover-content.js";
 export {
   p as Alert,
   m as AlertCirclesIcon,
-  n as AlertDescription,
-  f as AlertTitle,
+  f as AlertDescription,
+  n as AlertTitle,
   Qr as ApartmentBuildingIcon,
   pa as ArrowLeftIcon,
   J as ArrowsThroughLineY,
-  Pr as Avatar,
+  Mr as Avatar,
   Ye as AvatarCell,
   Rr as AvatarWithLabel,
-  vr as Badge,
+  Br as Badge,
   Ge as BooleanCell,
   x as Button,
   xp as COLOR_PALETTES,
@@ -163,13 +164,13 @@ export {
   et as ChevronLeftIcon,
   tt as ChevronRightIcon,
   pt as CircleCheckFilledIcon,
-  ft as CircleCheckIcon,
+  nt as CircleCheckIcon,
   _ as CirclesIcon,
   kr as ColumnReOrder,
   oo as CountryFlags,
   qo as DEFAULT_ACCEPT,
   Re as DEFAULT_EMPTY_MESSAGE,
-  Pp as DEFAULT_MAP_CONFIG,
+  Mp as DEFAULT_MAP_CONFIG,
   O as DatabaseCopy,
   G as DatabaseCopyIcon,
   ma as DescendingSortingIcon,
@@ -179,11 +180,11 @@ export {
   ut as DoubleChevronRightIcon,
   ct as DragHandleIcon,
   bo as DropdownContext,
-  fp as EmptyState,
+  np as EmptyState,
   ua as EraserIcon,
   lp as ErrorState,
   Uo as FileUploadArea,
-  fa as FilterIcon,
+  na as FilterIcon,
   Ct as HomeIcon,
   St as InfoIcon,
   zo as Input,
@@ -202,8 +203,8 @@ export {
   Np as MapPinContent,
   Vp as MapStyleControl,
   Op as MapZoomControl,
-  vt as MediaRecordIcon,
-  Mt as MinusIcon,
+  Bt as MediaRecordIcon,
+  Pt as MinusIcon,
   Ko as NavHeader,
   jo as NavItem,
   Fe as NumberCell,
@@ -211,13 +212,14 @@ export {
   Ap as PIN_SIZES,
   Sr as PaginationInfo,
   Ir as PaginationQuickJumper,
+  Yp as PdfPreview,
   Et as PinIcon,
   La as Popconfirm,
   Da as Popover,
   wa as PopoverAnchor,
   ue as PopoverCompact,
   ha as PopoverContent,
-  Ba as PopoverTrigger,
+  va as PopoverTrigger,
   Ca as RightSquareBracketIcon,
   Q as SIDEBAR_WIDTH,
   j as SIDEBAR_WIDTH_COLLAPSED,
@@ -231,7 +233,7 @@ export {
   N as SubNavIndicatorIcon,
   Ae as TABLE_CSS_CLASSES,
   we as Table,
-  ve as TableBody,
+  Be as TableBody,
   hr as TableCard,
   He as TableCell,
   ea as TableCols2Icon,
@@ -243,7 +245,7 @@ export {
   mr as TableHeaderWrapper,
   pr as TableLoadingState,
   tr as TableMessageState,
-  fr as TablePagination,
+  nr as TablePagination,
   he as TableProvider,
   er as TableRow,
   Hr as TreeCheckboxSelect,
@@ -265,8 +267,8 @@ export {
   Xr as Z2BreadcrumbSeparator,
   ro as Z2Checkbox,
   Qt as Z2DataIcon,
-  no as Z2Dialog,
-  fo as Z2DialogClose,
+  fo as Z2Dialog,
+  no as Z2DialogClose,
   lo as Z2DialogContent,
   mo as Z2DialogDescription,
   xo as Z2DialogFooter,
@@ -280,8 +282,8 @@ export {
   Io as Z2DropdownInput,
   go as Z2DropdownItem,
   Lo as Z2DropdownMenu,
-  Mo as Z2DropdownMenuCheckboxItem,
-  Po as Z2DropdownMenuContent,
+  Po as Z2DropdownMenuCheckboxItem,
+  Mo as Z2DropdownMenuContent,
   Ro as Z2DropdownMenuGroup,
   Ao as Z2DropdownMenuItem,
   Eo as Z2DropdownMenuLabel,
@@ -297,13 +299,13 @@ export {
   Do as Z2DropdownSub,
   wo as Z2DropdownSubContent,
   ho as Z2DropdownSubItem,
-  Bo as Z2DropdownSubTrigger,
+  vo as Z2DropdownSubTrigger,
   Yt as Z2Icon,
   Lp as Z2Map,
   E as Z2Popover,
-  $p as Z2PopoverContent,
-  Qp as Z2PopoverTrigger,
-  Bp as Z2RadioCard,
+  ef as Z2PopoverContent,
+  $p as Z2PopoverTrigger,
+  vp as Z2RadioCard,
   Yr as Z2RadioGroup,
   zr as Z2RadioGroupIndicator,
   Jr as Z2RadioGroupItem,
@@ -314,8 +316,8 @@ export {
   te as Z2SelectItem,
   ae as Z2SelectLabel,
   pe as Z2SelectScrollDownButton,
-  ne as Z2SelectScrollUpButton,
-  fe as Z2SelectSeparator,
+  fe as Z2SelectScrollUpButton,
+  ne as Z2SelectSeparator,
   le as Z2SelectTrigger,
   me as Z2SelectValue,
   s as Z2SideNavBar,
@@ -323,14 +325,14 @@ export {
   D as Z2SideNavBarFooter,
   h as Z2SideNavBarGroup,
   S as Z2SideNavBarHeader,
-  v as Z2SideNavBarItem,
+  B as Z2SideNavBarItem,
   Z as Z2SideNavBarProvider,
-  M as Z2SideNavBarSeparator,
+  P as Z2SideNavBarSeparator,
   C as Z2SidebarVariants,
   Jt as Z2SlashIcon,
   ce as Z2Stepper,
   Ce as Z2StepperItem,
-  Pa as Z2Table,
+  Ma as Z2Table,
   Ra as Z2TableBase,
   Aa as Z2TableBody,
   Ea as Z2TableBodyRow,
@@ -363,14 +365,14 @@ export {
   gp as buildChartOptions,
   Tp as buildLineChartOptions,
   i as buttonVariants,
-  Jp as cn,
-  Me as extractCellValue,
+  Qp as cn,
+  Pe as extractCellValue,
   up as getThemePalette,
   Dp as isChartTypeSupported,
   Xp as kpiCardVariants,
   wp as registeredChartTypes,
   ke as useTableContext,
-  Yp as useTheme,
+  Jp as useTheme,
   R as useZ2SideNavBar,
   Qa as useZ2Table,
   cp as validateChartConfig,

package/dist/types/components/pdf-preview/components/pdf-error-state.d.ts

@@ -0,0 +1,9 @@
+import * as React from 'react';
+import { PdfPreviewError } from '../pdf-preview.type';
+interface PdfErrorStateProps {
+    error: PdfPreviewError;
+    onRetry: () => void;
+}
+/** Default error UI shown when PDF loading fails. Displays warning icon, error message, and a retry button. */
+export declare const PdfErrorState: React.FC<PdfErrorStateProps>;
+export {};

package/dist/types/components/pdf-preview/components/pdf-loading-state.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+/** Default loading spinner shown while the PDF source is being resolved/fetched. */
+export declare const PdfLoadingState: React.FC;

package/dist/types/components/pdf-preview/components/pdf-toolbar.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+interface PdfToolbarProps {
+    title: string;
+    showDownload: boolean;
+    onDownload: () => void;
+    downloadDisabled?: boolean;
+}
+/**
+ * Toolbar displayed at the top of the PDF preview dialog.
+ * Contains:
+ * - DialogPrimitive.Title: serves as both the visible title and Radix's required accessible title
+ * - Download button (optional): triggers the parent's download handler
+ * - Close button: uses DialogPrimitive.Close to close the dialog via Radix
+ */
+export declare const PdfToolbar: React.FC<PdfToolbarProps>;
+export {};

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

@@ -0,0 +1,22 @@
+import * as React from 'react';
+interface PdfViewerProps {
+    url: string;
+    title: string;
+    className?: string;
+}
+/**
+ * Browser-native PDF renderer with a two-level fallback:
+ *
+ * 1. <object type="application/pdf"> — uses the browser's built-in PDF plugin
+ *    (Chrome, Firefox, Edge all have mature viewers with zoom, search, print)
+ *
+ * 2. <iframe> — fallback rendered as <object>'s child if the plugin is unavailable
+ *
+ * Note: <iframe> does not support child fallback content (unlike <object>), so a
+ * download link inside <iframe> would be unreachable. If the browser can't render
+ * the PDF at all, the iframe will show a blank page or its own error.
+ *
+ * This approach adds zero JS bundle size since it relies entirely on browser capabilities.
+ */
+export declare const PdfViewer: React.FC<PdfViewerProps>;
+export {};

package/dist/types/components/pdf-preview/index.d.ts

@@ -0,0 +1,3 @@
+export { PdfPreview } from './pdf-preview';
+export type { PdfPreviewProps, PdfPreviewError, PdfPreviewStatus } from './pdf-preview.type';
+export type { PdfPreviewSize } from './pdf-preview.const';

package/dist/types/components/pdf-preview/pdf-preview.const.d.ts

@@ -0,0 +1,29 @@
+/** Available dialog size options for the PDF preview modal. */
+export declare const PDF_PREVIEW_SIZES: {
+    readonly SM: "sm";
+    readonly MD: "md";
+    readonly LG: "lg";
+    readonly XL: "xl";
+    readonly FULL: "full";
+};
+export type PdfPreviewSize = (typeof PDF_PREVIEW_SIZES)[keyof typeof PDF_PREVIEW_SIZES];
+/** Default prop values used when the consumer doesn't provide them. */
+export declare const PDF_PREVIEW_DEFAULTS: {
+    readonly size: PdfPreviewSize;
+    readonly showToolbar: true;
+    readonly showDownload: true;
+};
+/**
+ * CVA variants for the dialog content container.
+ * Each size sets a max width/height using min() to stay responsive,
+ * with a 2rem margin from viewport edges. 'full' takes up nearly the entire screen.
+ *
+ * Note: Z2DialogContent's base styles include `grid gap-4 max-w-[calc(100%-2rem)] sm:max-w-lg`
+ * which conflict with our layout. We override them here with:
+ * - `flex flex-col` → overrides `grid` (tailwind-merge handles display conflicts)
+ * - `max-w-none sm:max-w-none` → cancels the max-width caps so our w-[min(...)] sizing works
+ * - `gap-0` → removes the default gap between children
+ */
+export declare const pdfDialogContentVariants: (props?: ({
+    size?: "sm" | "md" | "full" | "lg" | "xl" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;

package/dist/types/components/pdf-preview/pdf-preview.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import { PdfPreviewProps } from './pdf-preview.type';
+/**
+ * PdfPreview — A zero-dependency PDF preview dialog component.
+ *
+ * Uses the browser's built-in PDF renderer (<object> + <iframe> fallback)
+ * instead of pdf.js, resulting in zero additional bundle size.
+ *
+ * Supports:
+ * - Multiple source types: URL string, Blob, File, or async fetch function
+ * - Controlled & uncontrolled open state
+ * - Customizable loading/error states
+ * - `renderPdf` escape hatch for plugging in custom renderers (e.g. react-pdf)
+ */
+declare const PdfPreview: React.FC<PdfPreviewProps>;
+export { PdfPreview };

package/dist/types/components/pdf-preview/pdf-preview.hook.d.ts

@@ -0,0 +1,12 @@
+import { UsePdfPreviewProps, UsePdfPreviewReturn } from './pdf-preview.type';
+/**
+ * Core hook that manages the entire PDF preview lifecycle:
+ * - Controlled/uncontrolled open state (like popconfirm.hook.ts pattern)
+ * - Lazy source resolution — async fetch only runs when dialog opens
+ * - Blob URL memory management — created on open, revoked on close/unmount
+ * - Status state machine: idle → loading → ready | error
+ * - Abort tracking to prevent stale state updates if dialog closes mid-fetch
+ */
+export declare function usePdfPreview(props: UsePdfPreviewProps): UsePdfPreviewReturn & {
+    resolvedTitle: string;
+};

package/dist/types/components/pdf-preview/pdf-preview.type.d.ts

@@ -0,0 +1,81 @@
+import { ReactNode } from 'react';
+import { PdfPreviewSize } from './pdf-preview.const';
+/**
+ * Represents an error that occurred while loading or processing a PDF.
+ * Used by error callbacks and the error state UI.
+ */
+export interface PdfPreviewError {
+    message: string;
+    cause?: unknown;
+}
+/**
+ * State machine for the PDF loading lifecycle:
+ * idle → loading → ready | error
+ * Resets back to 'idle' when the dialog closes.
+ */
+export type PdfPreviewStatus = 'idle' | 'loading' | 'ready' | 'error';
+/**
+ * Props for the PdfPreview component.
+ *
+ * Supports both controlled (open/onOpenChange) and uncontrolled usage.
+ * The `src` prop accepts multiple source types to handle different use cases:
+ * - Static URL string (e.g. "/files/report.pdf")
+ * - Blob or File object (e.g. from a file input)
+ * - Async function that returns any of the above (e.g. server-side fetch)
+ */
+export interface PdfPreviewProps {
+    /** PDF source — URL string, Blob, File, or async function returning any of those.
+     *  Async functions receive an AbortSignal so the fetch can be cancelled when the dialog closes. */
+    src: string | Blob | File | ((signal: AbortSignal) => Promise<string | Blob | File>);
+    /** Dialog title. Auto-detected from filename if not provided */
+    title?: string;
+    /** Dialog size variant */
+    size?: PdfPreviewSize;
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Disable the trigger */
+    disabled?: boolean;
+    /** Show the toolbar (default: true) */
+    showToolbar?: boolean;
+    /** Show the download button in the toolbar (default: true) */
+    showDownload?: boolean;
+    /** Filename used when downloading */
+    downloadFilename?: string;
+    /** Custom download handler */
+    onDownload?: () => void;
+    /** Custom loading content */
+    loadingContent?: ReactNode;
+    /** Custom error content or render function */
+    errorContent?: ReactNode | ((error: PdfPreviewError) => ReactNode);
+    /** Escape hatch: render your own PDF viewer given the resolved URL */
+    renderPdf?: (resolvedUrl: string) => ReactNode;
+    /** Additional class name for the dialog content */
+    className?: string;
+    /** Additional class name for the PDF viewer area */
+    viewerClassName?: string;
+    /** Called when an error occurs */
+    onError?: (error: PdfPreviewError) => void;
+    /** Called when the PDF loads successfully */
+    onLoad?: () => void;
+    /** Click trigger element (rendered via Radix asChild) */
+    children?: ReactNode;
+}
+/** Props passed to the usePdfPreview hook for managing dialog state and PDF source resolution. */
+export interface UsePdfPreviewProps {
+    src: PdfPreviewProps['src'];
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onError?: (error: PdfPreviewError) => void;
+    onLoad?: () => void;
+}
+/** Return value of usePdfPreview — provides state and handlers to the main component. */
+export interface UsePdfPreviewReturn {
+    open: boolean;
+    handleOpenChange: (open: boolean) => void;
+    status: PdfPreviewStatus;
+    resolvedUrl: string | null;
+    error: PdfPreviewError | null;
+    retry: () => void;
+}

package/dist/types/index.d.ts

@@ -37,5 +37,6 @@ export * from './components/primitives/chart-card';
 export * from './components/radio-card/radio-card';
 export * from './components/z2map';
 export * from './components/kpi-card';
+export * from './components/pdf-preview';
 export * from './lib/theme.hook';
 export * from './lib/utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ztwoint/z-ui",
-  "version": "0.1.147",
+  "version": "0.1.148",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",