@pallasoft/ps-file-components 1.4.0 → 1.5.0

package/dist/components/ps-document-scanner-loader.d.ts

@@ -1 +1 @@
-export declare const PsDocumentScannerLoader: import("react").LazyExoticComponent<({ fileName, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: import("../models/ps-document-scanner-sheet-props").PsDocumentScannerSheetProps) => import("react").JSX.Element | null>;
+export declare const PsDocumentScannerLoader: import("react").LazyExoticComponent<({ fileName, isAutoCapture, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: import("../models/ps-document-scanner-sheet-props").PsDocumentScannerSheetProps) => import("react").ReactPortal | null>;

package/dist/components/ps-document-scanner-sheet.d.ts

@@ -1,2 +1,2 @@
 import type { PsDocumentScannerSheetProps } from '../models/ps-document-scanner-sheet-props';
-export declare const PsDocumentScannerSheet: ({ fileName, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: PsDocumentScannerSheetProps) => import("react").JSX.Element | null;
+export declare const PsDocumentScannerSheet: ({ fileName, isAutoCapture, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: PsDocumentScannerSheetProps) => import("react").ReactPortal | null;

package/dist/components/ps-document-scanner-sheet.js

@@ -6,11 +6,12 @@ const react_1 = require("react");
 const ps_core_components_1 = require("@pallasoft/ps-core-components");
 const ps_design_system_1 = require("@pallasoft/ps-design-system");
 const ps_icons_1 = require("@pallasoft/ps-icons");
-const ps_popovers_1 = require("@pallasoft/ps-popovers");
 const react_dom_1 = require("react-dom");
+const ps_scan_camera_status_1 = require("../constants/ps-scan-camera-status");
 const ps_scan_step_1 = require("../constants/ps-scan-step");
 const use_ps_focus_trap_1 = require("../hooks/use-ps-focus-trap");
 const use_ps_scan_camera_1 = require("../hooks/use-ps-scan-camera");
+const use_ps_scan_live_detection_1 = require("../hooks/use-ps-scan-live-detection");
 const use_ps_scan_pages_1 = require("../hooks/use-ps-scan-pages");
 const use_ps_scan_previews_1 = require("../hooks/use-ps-scan-previews");
 const ps_scan_output_service_1 = require("../services/ps-scan-output-service");
@@ -19,27 +20,37 @@ const ps_scan_template_service_1 = require("../services/ps-scan-template-service
 const ps_scan_camera_view_1 = require("./ps-scan-camera-view");
 const ps_scan_crop_editor_1 = require("./ps-scan-crop-editor");
 const ps_scan_icon_button_1 = require("./ps-scan-icon-button");
+const ps_scan_permission_view_1 = require("./ps-scan-permission-view");
 const ps_scan_review_1 = require("./ps-scan-review");
-const PsDocumentScannerSheet = ({ fileName, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }) => {
+const PsDocumentScannerSheet = ({ fileName, isAutoCapture, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }) => {
     const tier = (0, ps_core_components_1.usePsViewport)();
     const zIndex = (0, ps_core_components_1.usePsLayerZIndex)(ps_design_system_1.PallasoftZIndex.Modal);
     const content = (0, react_1.useRef)(null);
     const { add, move, pages, remove, replace, setCorners, update } = (0, use_ps_scan_pages_1.usePsScanPages)();
     const [step, setStep] = (0, react_1.useState)(ps_scan_step_1.PsScanStep.Camera);
+    const [cropReturn, setCropReturn] = (0, react_1.useState)(ps_scan_step_1.PsScanStep.Camera);
     const [activeId, setActiveId] = (0, react_1.useState)('');
     const [retakeId, setRetakeId] = (0, react_1.useState)('');
     const [announcement, setAnnouncement] = (0, react_1.useState)('');
     const [error, setError] = (0, react_1.useState)('');
     const [isBusy, setIsBusy] = (0, react_1.useState)(false);
+    const [isCapturing, setIsCapturing] = (0, react_1.useState)(false);
+    const [isAuto, setIsAuto] = (0, react_1.useState)(isAutoCapture);
+    const [flashKey, setFlashKey] = (0, react_1.useState)(0);
     const camera = (0, use_ps_scan_camera_1.usePsScanCamera)(step === ps_scan_step_1.PsScanStep.Camera);
+    const isReady = camera.status === ps_scan_camera_status_1.PsScanCameraStatus.Ready;
+    const isFull = pages.length >= maxPages;
     const previews = (0, use_ps_scan_previews_1.usePsScanPreviews)(pages);
     const page = pages.find((item) => item.id === activeId);
+    const lastPage = pages[pages.length - 1];
     const isDesktop = tier === ps_design_system_1.PallasoftViewportTier.Desktop;
-    (0, ps_core_components_1.usePsScrollLock)(!isDesktop);
+    const isCameraStep = step === ps_scan_step_1.PsScanStep.Camera;
+    const showsCamera = isReady || camera.status === ps_scan_camera_status_1.PsScanCameraStatus.Starting;
+    (0, ps_core_components_1.usePsScrollLock)(true);
     (0, ps_core_components_1.usePsRestoreFocus)(true);
     (0, use_ps_focus_trap_1.usePsFocusTrap)(content, true, onClose);
     const edgeMessage = (isDetected) => isDetected ? labels.edgesFound : labels.edgesNotFound;
-    const addFiles = async (files) => {
+    const addFiles = async (files, after) => {
         setError('');
         try {
             const images = files.filter((file) => file.type === '' || file.type.startsWith('image/'));
@@ -57,21 +68,39 @@ const PsDocumentScannerSheet = ({ fileName, jpegQuality, labels, maxDimension, m
             const added = await add(images.slice(0, room));
             if (added.length === 0)
                 return;
-            setActiveId(added[0].page.id);
-            setStep(added.length === 1 ? ps_scan_step_1.PsScanStep.Crop : ps_scan_step_1.PsScanStep.Review);
-            setAnnouncement(added.length === 1
-                ? edgeMessage(added[0].isDetected)
-                : ps_scan_template_service_1.PsScanTemplateService.fill(labels.pageAdded, { position: pages.length + added.length }));
+            const position = pages.length + added.length;
+            setActiveId(added[added.length - 1].page.id);
+            setAnnouncement(ps_scan_template_service_1.PsScanTemplateService.fill(labels.pageAdded, { position }));
+            if (after === null)
+                return;
+            if (added.length === 1) {
+                setCropReturn(after);
+                setStep(ps_scan_step_1.PsScanStep.Crop);
+                setAnnouncement(edgeMessage(added[0].isDetected));
+            }
+            else
+                setStep(ps_scan_step_1.PsScanStep.Review);
         }
         catch {
             setError(labels.processFailed);
         }
     };
-    const capture = async () => {
-        const blob = await camera.capture();
-        if (blob !== null)
-            await addFiles([blob]);
+    const capture = async (isAutomatic) => {
+        if (isCapturing || isFull)
+            return;
+        setIsCapturing(true);
+        try {
+            const blob = await camera.capture();
+            if (blob === null)
+                return;
+            setFlashKey((current) => current + 1);
+            await addFiles([blob], isAutomatic && retakeId === '' ? null : ps_scan_step_1.PsScanStep.Camera);
+        }
+        finally {
+            setIsCapturing(false);
+        }
     };
+    const detection = (0, use_ps_scan_live_detection_1.usePsScanLiveDetection)(camera.videoRef, isCameraStep && isReady, isAuto, () => capture(true));
     const autoDetect = async () => {
         if (page === undefined)
             return;
@@ -79,12 +108,32 @@ const PsDocumentScannerSheet = ({ fileName, jpegQuality, labels, maxDimension, m
         setCorners(page.id, prepared.corners);
         setAnnouncement(edgeMessage(prepared.isDetected));
     };
+    const keep = () => setStep(cropReturn === ps_scan_step_1.PsScanStep.Camera && !isFull ? ps_scan_step_1.PsScanStep.Camera : ps_scan_step_1.PsScanStep.Review);
     const retake = () => {
         if (page === undefined)
             return;
+        if (step === ps_scan_step_1.PsScanStep.Review)
+            setCropReturn(ps_scan_step_1.PsScanStep.Review);
         setRetakeId(page.id);
         setStep(ps_scan_step_1.PsScanStep.Camera);
     };
+    const openCamera = () => {
+        setRetakeId('');
+        setCropReturn(ps_scan_step_1.PsScanStep.Camera);
+        setStep(ps_scan_step_1.PsScanStep.Camera);
+    };
+    const openReview = () => {
+        if (pages.length === 0)
+            return;
+        setRetakeId('');
+        if (page === undefined)
+            setActiveId(lastPage.id);
+        setStep(ps_scan_step_1.PsScanStep.Review);
+    };
+    const editCrop = () => {
+        setCropReturn(ps_scan_step_1.PsScanStep.Review);
+        setStep(ps_scan_step_1.PsScanStep.Crop);
+    };
     const deletePage = () => {
         if (page === undefined)
             return;
@@ -94,7 +143,7 @@ const PsDocumentScannerSheet = ({ fileName, jpegQuality, labels, maxDimension, m
         setAnnouncement(labels.pageDeleted);
         if (rest.length === 0) {
             setActiveId('');
-            setStep(ps_scan_step_1.PsScanStep.Camera);
+            openCamera();
         }
         else
             setActiveId(rest[Math.min(index, rest.length - 1)].id);
@@ -125,14 +174,13 @@ const PsDocumentScannerSheet = ({ fileName, jpegQuality, labels, maxDimension, m
             position: to + 1,
         }));
     }, [move, pages.length, labels]);
-    const body = ((0, jsx_runtime_1.jsxs)("div", { className: 'relative h-full min-h-0 bg-surface text-ink', ref: content, children: [(0, jsx_runtime_1.jsx)("p", { "aria-live": 'polite', className: 'sr-only', role: 'status', children: announcement }), step === ps_scan_step_1.PsScanStep.Camera ? ((0, jsx_runtime_1.jsx)(ps_scan_camera_view_1.PsScanCameraView, { canGoBack: pages.length > 0, canTorch: camera.canTorch, isTorchOn: camera.isTorchOn, labels: labels, onBack: () => {
-                    setRetakeId('');
-                    setStep(ps_scan_step_1.PsScanStep.Review);
-                }, onCapture: capture, onFiles: addFiles, onToggleTorch: camera.toggleTorch, status: camera.status, videoRef: camera.videoRef })) : null, step === ps_scan_step_1.PsScanStep.Crop && page !== undefined ? ((0, jsx_runtime_1.jsx)(ps_scan_crop_editor_1.PsScanCropEditor, { labels: labels, onApply: () => setStep(ps_scan_step_1.PsScanStep.Review), onAutoDetect: autoDetect, onChange: (corners) => setCorners(page.id, corners), onRetake: retake, page: page })) : null, step === ps_scan_step_1.PsScanStep.Review && page !== undefined ? ((0, jsx_runtime_1.jsx)(ps_scan_review_1.PsScanReview, { canAddPage: pages.length < maxPages, error: error, isBusy: isBusy, labels: labels, onAddPage: () => setStep(ps_scan_step_1.PsScanStep.Camera), onDelete: deletePage, onEditCrop: () => setStep(ps_scan_step_1.PsScanStep.Crop), onFilter: (filter) => update(page.id, { filter }), onFinish: finish, onMove: moveTo, onRetake: retake, onRotate: () => update(page.id, { rotation: (page.rotation + 90) % 360 }), onSelect: setActiveId, page: page, pages: pages, previews: previews })) : null, step === ps_scan_step_1.PsScanStep.Camera && error !== '' ? ((0, jsx_runtime_1.jsx)("p", { className: 'absolute inset-x-4 top-3 rounded-ps-control bg-danger px-3 py-2 text-sm text-white', role: 'alert', children: error })) : null] }));
-    if (isDesktop)
-        return ((0, jsx_runtime_1.jsx)(ps_popovers_1.PsModal, { isOpen: true, onClose: onClose, size: 'xl', title: labels.title, children: (0, jsx_runtime_1.jsx)("div", { className: '-m-4 h-[min(70dvh,38rem)] overflow-hidden sm:-m-5', children: body }) }));
+    const fromLibrary = (files) => addFiles(files, ps_scan_step_1.PsScanStep.Review);
     if (typeof document === 'undefined')
         return null;
-    return (0, react_dom_1.createPortal)((0, jsx_runtime_1.jsx)("div", { "aria-label": labels.title, "aria-modal": 'true', className: 'fixed inset-0 flex flex-col bg-surface text-ink animate-ps-fade-in', role: 'dialog', style: { zIndex }, children: (0, jsx_runtime_1.jsxs)(ps_core_components_1.PsLayer, { zIndex: zIndex, children: [(0, jsx_runtime_1.jsxs)("header", { className: 'flex shrink-0 items-center justify-between gap-3 border-b border-line px-4 pt-[max(0.5rem,env(safe-area-inset-top))] pb-2', children: [(0, jsx_runtime_1.jsx)("h2", { className: 'truncate text-base font-semibold', children: labels.title }), (0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { label: labels.close, onClick: onClose, children: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: ps_icons_1.PsIconKey.Close }) })] }), (0, jsx_runtime_1.jsx)("div", { className: 'min-h-0 flex-1', children: body })] }) }), document.body);
+    return (0, react_dom_1.createPortal)((0, jsx_runtime_1.jsx)("div", { "aria-label": labels.title, "aria-modal": 'true', className: isDesktop
+            ? 'fixed inset-0 flex items-center justify-center bg-black/70 p-6 backdrop-blur-sm animate-ps-fade-in'
+            : 'fixed inset-0 bg-black animate-ps-fade-in', role: 'dialog', style: { zIndex }, children: (0, jsx_runtime_1.jsx)(ps_core_components_1.PsLayer, { zIndex: zIndex, children: (0, jsx_runtime_1.jsxs)("div", { className: isDesktop
+                    ? 'relative h-[min(52rem,calc(100dvh-3rem))] w-[min(76rem,calc(100vw-3rem))] overflow-hidden rounded-2xl bg-black text-white shadow-2xl ring-1 ring-white/10 animate-ps-scale-in'
+                    : 'relative h-full overflow-hidden bg-black text-white', ref: content, children: [(0, jsx_runtime_1.jsx)("p", { "aria-live": 'polite', className: 'sr-only', role: 'status', children: announcement }), isCameraStep && showsCamera ? ((0, jsx_runtime_1.jsx)(ps_scan_camera_view_1.PsScanCameraView, { canTorch: camera.canTorch, detection: detection, flashKey: flashKey, isAuto: isAuto, isBusy: isCapturing, isFull: isFull, isMultiple: maxPages > 1, isReady: isReady, isTorchOn: camera.isTorchOn, labels: labels, lastPreview: lastPage === undefined ? undefined : previews[lastPage.id], onCapture: () => capture(false), onClose: onClose, onDone: openReview, onFiles: fromLibrary, onToggleAuto: () => setIsAuto((current) => !current), onToggleTorch: camera.toggleTorch, pageCount: pages.length, videoRef: camera.videoRef, videoTarget: camera.attachVideo })) : null, isCameraStep && !showsCamera ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(ps_scan_permission_view_1.PsScanPermissionView, { isMultiple: maxPages > 1, labels: labels, onAllow: camera.allow, onFiles: fromLibrary, status: camera.status }), (0, jsx_runtime_1.jsx)("div", { className: 'absolute left-4 top-[max(1rem,env(safe-area-inset-top))] flex gap-2', children: (0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { iconKey: ps_icons_1.PsIconKey.Close, label: labels.close, onClick: onClose }) }), pages.length > 0 ? ((0, jsx_runtime_1.jsx)("div", { className: 'absolute right-4 top-[max(1rem,env(safe-area-inset-top))]', children: (0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { iconKey: ps_icons_1.PsIconKey.Check, label: ps_scan_template_service_1.PsScanTemplateService.fill(labels.viewPages, { count: pages.length }), onClick: openReview }) })) : null] })) : null, step === ps_scan_step_1.PsScanStep.Crop && page !== undefined ? ((0, jsx_runtime_1.jsx)(ps_scan_crop_editor_1.PsScanCropEditor, { labels: labels, onAutoDetect: autoDetect, onChange: (corners) => setCorners(page.id, corners), onKeep: keep, onRetake: retake, page: page })) : null, step === ps_scan_step_1.PsScanStep.Review && page !== undefined ? ((0, jsx_runtime_1.jsx)(ps_scan_review_1.PsScanReview, { canAddPage: !isFull, error: error, isBusy: isBusy, labels: labels, onAddPage: openCamera, onClose: onClose, onDelete: deletePage, onEditCrop: editCrop, onFilter: (filter) => update(page.id, { filter }), onFinish: finish, onMove: moveTo, onRetake: retake, onRotate: () => update(page.id, { rotation: (page.rotation + 90) % 360 }), onSelect: setActiveId, page: page, pages: pages, previews: previews })) : null, isCameraStep && error !== '' ? ((0, jsx_runtime_1.jsx)("p", { className: 'absolute inset-x-4 bottom-36 mx-auto max-w-sm rounded-ps-control bg-danger px-3 py-2 text-center text-sm text-white', role: 'alert', children: error })) : null] }) }) }), document.body);
 };
 exports.PsDocumentScannerSheet = PsDocumentScannerSheet;

package/dist/components/ps-document-scanner.d.ts

@@ -1,2 +1,2 @@
 import type { PsDocumentScannerProps } from '../models/ps-document-scanner-props';
-export declare const PsDocumentScanner: ({ fileName, isOpen, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: PsDocumentScannerProps) => import("react").JSX.Element | null;
+export declare const PsDocumentScanner: ({ fileName, isAutoCapture, isOpen, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }: PsDocumentScannerProps) => import("react").JSX.Element | null;

package/dist/components/ps-document-scanner.js

@@ -8,10 +8,10 @@ const ps_document_scanner_labels_1 = require("../constants/ps-document-scanner-l
 const ps_scan_config_1 = require("../constants/ps-scan-config");
 const ps_scan_output_format_1 = require("../constants/ps-scan-output-format");
 const ps_document_scanner_loader_1 = require("./ps-document-scanner-loader");
-const PsDocumentScanner = ({ fileName = ps_scan_config_1.PsScanConfig.defaultFileName, isOpen, jpegQuality = ps_scan_config_1.PsScanConfig.defaultJpegQuality, labels, maxDimension = ps_scan_config_1.PsScanConfig.defaultMaxDimension, maxPages = ps_scan_config_1.PsScanConfig.defaultMaxPages, onClose, onComplete, outputFormat = ps_scan_output_format_1.PsScanOutputFormat.Pdf, }) => {
+const PsDocumentScanner = ({ fileName = ps_scan_config_1.PsScanConfig.defaultFileName, isAutoCapture = false, isOpen, jpegQuality = ps_scan_config_1.PsScanConfig.defaultJpegQuality, labels, maxDimension = ps_scan_config_1.PsScanConfig.defaultMaxDimension, maxPages = ps_scan_config_1.PsScanConfig.defaultMaxPages, onClose, onComplete, outputFormat = ps_scan_output_format_1.PsScanOutputFormat.Pdf, }) => {
     const isHydrated = (0, ps_core_components_1.usePsHydrated)();
     if (!isOpen || !isHydrated)
         return null;
-    return ((0, jsx_runtime_1.jsx)(react_1.Suspense, { fallback: null, children: (0, jsx_runtime_1.jsx)(ps_document_scanner_loader_1.PsDocumentScannerLoader, { fileName: fileName, jpegQuality: jpegQuality, labels: { ...ps_document_scanner_labels_1.PsDocumentScannerLabels, ...labels }, maxDimension: maxDimension, maxPages: maxPages, onClose: onClose, onComplete: onComplete, outputFormat: outputFormat }) }));
+    return ((0, jsx_runtime_1.jsx)(react_1.Suspense, { fallback: null, children: (0, jsx_runtime_1.jsx)(ps_document_scanner_loader_1.PsDocumentScannerLoader, { fileName: fileName, isAutoCapture: isAutoCapture, jpegQuality: jpegQuality, labels: { ...ps_document_scanner_labels_1.PsDocumentScannerLabels, ...labels }, maxDimension: maxDimension, maxPages: maxPages, onClose: onClose, onComplete: onComplete, outputFormat: outputFormat }) }));
 };
 exports.PsDocumentScanner = PsDocumentScanner;

package/dist/components/ps-file-picker-actions.d.ts

@@ -0,0 +1,10 @@
+export interface PsFilePickerActionsProps {
+    chooseLabel: string;
+    className?: string;
+    disabled: boolean;
+    isTouch: boolean;
+    onChoose: () => void;
+    onScan: () => void;
+    scanLabel?: string;
+}
+export declare const PsFilePickerActions: ({ chooseLabel, className, disabled, isTouch, onChoose, onScan, scanLabel, }: PsFilePickerActionsProps) => import("react").JSX.Element;

package/dist/components/ps-file-picker-actions.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsFilePickerActions = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ps_core_components_1 = require("@pallasoft/ps-core-components");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_icons_1 = require("@pallasoft/ps-icons");
+const PsFilePickerActions = ({ chooseLabel, className, disabled, isTouch, onChoose, onScan, scanLabel, }) => {
+    const hasScan = scanLabel !== undefined;
+    const choose = ((0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { className: isTouch ? 'w-full' : '', disabled: disabled, leadingIcon: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: ps_icons_1.PsIconKey.Upload }), onClick: (event) => {
+            event.stopPropagation();
+            onChoose();
+        }, size: isTouch ? 'large' : 'default', variant: hasScan && isTouch ? 'surface' : hasScan || isTouch ? 'primary' : 'surface', children: chooseLabel }));
+    return ((0, jsx_runtime_1.jsx)("div", { className: ps_design_system_1.PallasoftClassNameService.merge(isTouch
+            ? 'w-full max-w-xs flex-col gap-2'
+            : 'flex-row flex-wrap items-center justify-center gap-2', className), children: hasScan ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [isTouch ? null : choose, (0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { className: isTouch ? 'w-full' : '', disabled: disabled, leadingIcon: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: ps_icons_1.PsIconKey.Camera }), onClick: (event) => {
+                        event.stopPropagation();
+                        onScan();
+                    }, size: isTouch ? 'large' : 'default', variant: isTouch ? 'primary' : 'surface', children: scanLabel }), isTouch ? choose : null] })) : (choose) }));
+};
+exports.PsFilePickerActions = PsFilePickerActions;

package/dist/components/ps-file-picker.d.ts

@@ -1,5 +1,8 @@
 import { PsFilePickerLabels } from '../constants/ps-file-picker-labels';
+import { PsUploadLabels } from '../constants/ps-upload-labels';
+import type { PsFilePickerScan } from '../models/ps-file-picker-scan';
 import type { PsLabelSet } from '../models/ps-label-set';
+import type { PsUploadQueueState } from '../models/ps-upload-queue-state';
 export interface PsFilePickerProps {
     accept: string[];
     acceptLabel: string;
@@ -11,9 +14,12 @@ export interface PsFilePickerProps {
     maxSizeBytes?: number;
     maxSizeLabel?: string;
     multiple?: boolean;
+    queue?: PsUploadQueueState;
+    scan?: PsFilePickerScan;
     touchLabel?: string;
+    uploadLabels?: Partial<PsLabelSet<typeof PsUploadLabels>>;
     onError?: (message: string) => void;
     onFileLoad?: (file: File) => void;
     onFilesSelect?: (files: File[]) => void;
 }
-export declare const PsFilePicker: ({ accept, acceptLabel, className, disabled, dropLabel, isLoading, labels, maxSizeBytes, maxSizeLabel, multiple, onError, onFileLoad, onFilesSelect, touchLabel, }: PsFilePickerProps) => import("react").JSX.Element;
+export declare const PsFilePicker: ({ accept, acceptLabel, className, disabled, dropLabel, isLoading, labels, maxSizeBytes, maxSizeLabel, multiple, onError, onFileLoad, onFilesSelect, queue, scan, touchLabel, uploadLabels, }: PsFilePickerProps) => import("react").JSX.Element;

package/dist/components/ps-file-picker.js

@@ -6,13 +6,24 @@ const react_1 = require("react");
 const ps_design_system_1 = require("@pallasoft/ps-design-system");
 const ps_icons_1 = require("@pallasoft/ps-icons");
 const ps_file_picker_labels_1 = require("../constants/ps-file-picker-labels");
+const ps_scan_config_1 = require("../constants/ps-scan-config");
+const ps_upload_labels_1 = require("../constants/ps-upload-labels");
 const ps_file_selection_service_1 = require("../services/ps-file-selection-service");
-const PsFilePicker = ({ accept, acceptLabel, className, disabled = false, dropLabel, isLoading = false, labels, maxSizeBytes, maxSizeLabel, multiple = false, onError, onFileLoad, onFilesSelect, touchLabel, }) => {
+const ps_document_scanner_1 = require("./ps-document-scanner");
+const ps_file_picker_actions_1 = require("./ps-file-picker-actions");
+const ps_upload_row_1 = require("./ps-upload-row");
+const PsFilePicker = ({ accept, acceptLabel, className, disabled = false, dropLabel, isLoading = false, labels, maxSizeBytes, maxSizeLabel, multiple = false, onError, onFileLoad, onFilesSelect, queue, scan, touchLabel, uploadLabels, }) => {
     const [isDragging, setIsDragging] = (0, react_1.useState)(false);
+    const [scanName, setScanName] = (0, react_1.useState)(null);
+    const input = (0, react_1.useRef)(null);
     const acceptAttr = (0, react_1.useMemo)(() => accept.join(','), [accept]);
     const text = { ...ps_file_picker_labels_1.PsFilePickerLabels, ...labels };
+    const rowLabels = { ...ps_upload_labels_1.PsUploadLabels, ...uploadLabels };
+    const details = [acceptLabel, maxSizeLabel].filter((value) => value !== undefined && value !== '');
+    const chooseLabel = multiple ? text.choose : text.chooseOne;
+    const scanLabel = scan === undefined ? undefined : text.scan;
     if (isLoading)
-        return ((0, jsx_runtime_1.jsx)("span", { "aria-busy": 'true', className: ps_design_system_1.PallasoftClassNameService.merge('ps-skeleton block min-h-32 w-full rounded-ps-panel', className), role: 'status' }));
+        return ((0, jsx_runtime_1.jsx)("span", { "aria-busy": 'true', className: ps_design_system_1.PallasoftClassNameService.merge('ps-skeleton block min-h-48 w-full rounded-ps-control', className), role: 'status' }));
     const select = (list) => {
         if (list === null || disabled)
             return;
@@ -31,6 +42,15 @@ const PsFilePicker = ({ accept, acceptLabel, className, disabled = false, dropLa
         else
             onFileLoad?.(accepted[0]);
     };
+    const browse = () => {
+        if (!disabled)
+            input.current?.click();
+    };
+    const openScan = () => {
+        if (disabled || scan === undefined)
+            return;
+        setScanName(scan.getFileName === undefined ? ps_scan_config_1.PsScanConfig.defaultFileName : scan.getFileName());
+    };
     const onChange = (event) => {
         select(event.target.files);
         event.target.value = '';
@@ -40,9 +60,13 @@ const PsFilePicker = ({ accept, acceptLabel, className, disabled = false, dropLa
         if (!disabled)
             setIsDragging(isOver);
     };
-    return ((0, jsx_runtime_1.jsxs)("div", { className: ps_design_system_1.PallasoftClassNameService.merge('relative flex h-48 w-full flex-col items-center justify-center rounded-ps-control border-2 border-dashed border-line p-4 transition-all hover:border-primary/50 hover:bg-primary/5 sm:h-64', isDragging ? 'border-primary bg-primary/10' : '', disabled ? 'pointer-events-none opacity-60' : '', className), onDragEnter: (event) => onDrag(event, true), onDragLeave: (event) => onDrag(event, false), onDragOver: (event) => onDrag(event, true), onDrop: (event) => {
-            onDrag(event, false);
-            select(event.dataTransfer.files);
-        }, children: [(0, jsx_runtime_1.jsxs)("div", { className: 'pointer-events-none flex flex-col items-center gap-3 text-center', children: [(0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { className: 'h-8 w-8 text-primary', iconKey: ps_icons_1.PsIconKey.Upload }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-body-2 font-medium text-ink sm:text-body-1', children: isDragging ? (text.dropActive) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("span", { className: touchLabel === undefined ? '' : '[@media(pointer:coarse)]:hidden', children: dropLabel }), touchLabel === undefined ? null : ((0, jsx_runtime_1.jsx)("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: touchLabel }))] })) }), (0, jsx_runtime_1.jsxs)("p", { className: 'mt-1 text-body-3 text-ink/60 sm:text-body-2', children: [(0, jsx_runtime_1.jsx)("span", { className: '[@media(pointer:coarse)]:hidden', children: text.browse }), (0, jsx_runtime_1.jsx)("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: text.browseTouch })] }), maxSizeLabel ? (0, jsx_runtime_1.jsx)("p", { className: 'mt-3 text-body-3 text-ink/60', children: maxSizeLabel }) : null, (0, jsx_runtime_1.jsxs)("p", { className: 'text-body-3 text-ink/60', children: [text.formats, " ", acceptLabel] })] })] }), (0, jsx_runtime_1.jsx)("input", { accept: acceptAttr, "aria-disabled": disabled, "aria-label": dropLabel, className: 'absolute inset-0 h-full w-full cursor-pointer opacity-0', disabled: disabled, multiple: multiple, onChange: onChange, type: 'file' })] }));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: ps_design_system_1.PallasoftClassNameService.merge('flex w-full flex-col gap-3', className), children: [(0, jsx_runtime_1.jsxs)("div", { "aria-disabled": disabled || undefined, className: ps_design_system_1.PallasoftClassNameService.merge('flex w-full cursor-pointer flex-col items-center gap-5 rounded-ps-control border-2 border-dashed px-5 py-8 text-center transition-colors duration-200 sm:px-8', isDragging
+                    ? 'border-primary bg-primary/5'
+                    : 'border-line bg-surface/40 hover:border-primary/40 hover:bg-primary/[0.03]', disabled ? 'pointer-events-none opacity-60' : ''), onClick: browse, onDragEnter: (event) => onDrag(event, true), onDragLeave: (event) => onDrag(event, false), onDragOver: (event) => onDrag(event, true), onDrop: (event) => {
+                    onDrag(event, false);
+                    select(event.dataTransfer.files);
+                }, children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": 'true', className: ps_design_system_1.PallasoftClassNameService.merge('flex size-12 items-center justify-center rounded-full transition-colors duration-200', isDragging
+                            ? 'bg-primary text-[color:var(--ps-color-primary-contrast)]'
+                            : 'bg-primary-soft text-primary'), children: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { className: 'size-6', iconKey: ps_icons_1.PsIconKey.Upload }) }), (0, jsx_runtime_1.jsxs)("div", { className: 'flex flex-col gap-1', children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-base font-semibold text-ink', children: isDragging ? (text.dropActive) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("span", { className: touchLabel === undefined ? '' : '[@media(pointer:coarse)]:hidden', children: dropLabel }), touchLabel === undefined ? null : ((0, jsx_runtime_1.jsx)("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: touchLabel }))] })) }), (0, jsx_runtime_1.jsx)("p", { className: 'text-sm text-ink/60 [@media(pointer:coarse)]:hidden', children: multiple ? text.dragHint : text.dragHintOne })] }), (0, jsx_runtime_1.jsx)(ps_file_picker_actions_1.PsFilePickerActions, { chooseLabel: chooseLabel, className: 'flex [@media(pointer:coarse)]:hidden', disabled: disabled, isTouch: false, onChoose: browse, onScan: openScan, scanLabel: scanLabel }), (0, jsx_runtime_1.jsx)(ps_file_picker_actions_1.PsFilePickerActions, { chooseLabel: chooseLabel, className: 'hidden [@media(pointer:coarse)]:flex', disabled: disabled, isTouch: true, onChoose: browse, onScan: openScan, scanLabel: scanLabel }), details.length > 0 ? (0, jsx_runtime_1.jsx)("p", { className: 'text-xs text-ink/50', children: details.join(' · ') }) : null, (0, jsx_runtime_1.jsx)("input", { accept: acceptAttr, "aria-hidden": 'true', className: 'sr-only', disabled: disabled, multiple: multiple, onChange: onChange, onClick: (event) => event.stopPropagation(), ref: input, tabIndex: -1, type: 'file' })] }), queue === undefined || queue.items.length === 0 ? null : ((0, jsx_runtime_1.jsx)("ul", { "aria-label": rowLabels.title, className: 'flex flex-col gap-2', children: queue.items.map((item) => ((0, jsx_runtime_1.jsx)(ps_upload_row_1.PsUploadRow, { item: item, labels: rowLabels, onCancel: () => queue.cancel(item.id), onRemove: () => queue.remove(item.id), onRetry: () => queue.retry(item.id) }, item.id))) })), scan === undefined ? null : ((0, jsx_runtime_1.jsx)(ps_document_scanner_1.PsDocumentScanner, { ...scan, fileName: scanName === null ? ps_scan_config_1.PsScanConfig.defaultFileName : scanName, isOpen: scanName !== null, onClose: () => setScanName(null), onComplete: select }))] }));
 };
 exports.PsFilePicker = PsFilePicker;

package/dist/components/ps-scan-button.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+export interface PsScanButtonProps {
+    children: ReactNode;
+    className?: string;
+    disabled?: boolean;
+    isLarge?: boolean;
+    isLoading?: boolean;
+    isPrimary?: boolean;
+    leadingIcon?: ReactNode;
+    loadingLabel?: string;
+    onClick: () => void;
+}
+export declare const PsScanButton: ({ children, className, disabled, isLarge, isLoading, isPrimary, leadingIcon, loadingLabel, onClick, }: PsScanButtonProps) => import("react").JSX.Element;

package/dist/components/ps-scan-button.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanButton = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ps_core_components_1 = require("@pallasoft/ps-core-components");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_scan_chrome_classes_1 = require("../constants/ps-scan-chrome-classes");
+const PsScanButton = ({ children, className, disabled = false, isLarge = false, isLoading = false, isPrimary = false, leadingIcon, loadingLabel, onClick, }) => ((0, jsx_runtime_1.jsxs)("button", { "aria-busy": isLoading || undefined, className: ps_design_system_1.PallasoftClassNameService.merge(ps_scan_chrome_classes_1.PsScanChromeClasses.button, isLarge ? ps_scan_chrome_classes_1.PsScanChromeClasses.buttonLarge : '', isPrimary ? ps_scan_chrome_classes_1.PsScanChromeClasses.buttonPrimary : ps_scan_chrome_classes_1.PsScanChromeClasses.buttonQuiet, 'relative', className), disabled: disabled || isLoading, onClick: onClick, type: 'button', children: [isLoading ? ((0, jsx_runtime_1.jsx)(ps_core_components_1.PsSpinner, { className: 'absolute inset-0 m-auto', color: 'current', label: loadingLabel === undefined ? '' : loadingLabel, size: 'small' })) : null, (0, jsx_runtime_1.jsxs)("span", { "aria-hidden": isLoading || undefined, className: `inline-flex min-w-0 items-center gap-2 ${isLoading ? 'invisible' : ''}`, children: [leadingIcon === undefined ? null : (0, jsx_runtime_1.jsx)("span", { className: 'shrink-0', children: leadingIcon }), (0, jsx_runtime_1.jsx)("span", { className: 'truncate', children: children })] })] }));
+exports.PsScanButton = PsScanButton;

package/dist/components/ps-scan-camera-view.d.ts

@@ -1,17 +1,27 @@
-import { type RefObject } from 'react';
+import { type RefCallback, type RefObject } from 'react';
 import { PsDocumentScannerLabels } from '../constants/ps-document-scanner-labels';
-import { PsScanCameraStatus } from '../constants/ps-scan-camera-status';
 import type { PsLabelSet } from '../models/ps-label-set';
+import type { PsScanLiveDetection } from '../models/ps-scan-live-detection';
 export interface PsScanCameraViewProps {
-    canGoBack: boolean;
     canTorch: boolean;
+    detection: PsScanLiveDetection;
+    flashKey: number;
+    isAuto: boolean;
+    isBusy: boolean;
+    isFull: boolean;
+    isMultiple: boolean;
+    isReady: boolean;
     isTorchOn: boolean;
     labels: PsLabelSet<typeof PsDocumentScannerLabels>;
-    onBack: () => void;
+    lastPreview: string | undefined;
     onCapture: () => void;
+    onClose: () => void;
+    onDone: () => void;
     onFiles: (files: File[]) => void;
+    onToggleAuto: () => void;
     onToggleTorch: () => void;
-    status: PsScanCameraStatus;
-    videoRef: RefObject<HTMLVideoElement>;
+    pageCount: number;
+    videoRef: RefObject<HTMLVideoElement | null>;
+    videoTarget: RefCallback<HTMLVideoElement>;
 }
-export declare const PsScanCameraView: ({ canGoBack, canTorch, isTorchOn, labels, onBack, onCapture, onFiles, onToggleTorch, status, videoRef, }: PsScanCameraViewProps) => import("react").JSX.Element;
+export declare const PsScanCameraView: ({ canTorch, detection, flashKey, isAuto, isBusy, isFull, isMultiple, isReady, isTorchOn, labels, lastPreview, onCapture, onClose, onDone, onFiles, onToggleAuto, onToggleTorch, pageCount, videoRef, videoTarget, }: PsScanCameraViewProps) => import("react").JSX.Element;

package/dist/components/ps-scan-camera-view.js

@@ -4,24 +4,31 @@ exports.PsScanCameraView = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const ps_core_components_1 = require("@pallasoft/ps-core-components");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
 const ps_icons_1 = require("@pallasoft/ps-icons");
-const ps_scan_camera_status_1 = require("../constants/ps-scan-camera-status");
+const ps_scan_chrome_classes_1 = require("../constants/ps-scan-chrome-classes");
+const ps_scan_template_service_1 = require("../services/ps-scan-template-service");
+const ps_scan_button_1 = require("./ps-scan-button");
 const ps_scan_icon_button_1 = require("./ps-scan-icon-button");
-const PsScanCameraView = ({ canGoBack, canTorch, isTorchOn, labels, onBack, onCapture, onFiles, onToggleTorch, status, videoRef, }) => {
-    const captureInput = (0, react_1.useRef)(null);
-    const libraryInput = (0, react_1.useRef)(null);
-    const isReady = status === ps_scan_camera_status_1.PsScanCameraStatus.Ready;
-    const message = status === ps_scan_camera_status_1.PsScanCameraStatus.Denied
-        ? labels.cameraDenied
-        : status === ps_scan_camera_status_1.PsScanCameraStatus.Unavailable
-            ? labels.cameraUnavailable
-            : '';
-    const onChange = (event) => {
-        const files = Array.from(event.target.files === null ? [] : event.target.files);
-        event.target.value = '';
-        if (files.length > 0)
-            onFiles(files);
+const ps_scan_page_stack_1 = require("./ps-scan-page-stack");
+const ps_scan_photo_button_1 = require("./ps-scan-photo-button");
+const ps_scan_shutter_1 = require("./ps-scan-shutter");
+const ps_scan_viewfinder_overlay_1 = require("./ps-scan-viewfinder-overlay");
+const PsScanCameraView = ({ canTorch, detection, flashKey, isAuto, isBusy, isFull, isMultiple, isReady, isTorchOn, labels, lastPreview, onCapture, onClose, onDone, onFiles, onToggleAuto, onToggleTorch, pageCount, videoRef, videoTarget, }) => {
+    const [areaRef, area] = (0, ps_core_components_1.usePsElementSize)();
+    const [video, setVideo] = (0, react_1.useState)({ height: 0, width: 0 });
+    const hint = isFull
+        ? labels.maxPages
+        : detection.quad === null
+            ? labels.hintFind
+            : isAuto
+                ? labels.hintHold
+                : labels.hintFound;
+    const measure = () => {
+        const element = videoRef.current;
+        if (element !== null)
+            setVideo({ height: element.videoHeight, width: element.videoWidth });
     };
-    return ((0, jsx_runtime_1.jsxs)("div", { className: 'flex h-full min-h-0 flex-col bg-slate-950 text-white', children: [(0, jsx_runtime_1.jsxs)("div", { className: 'relative min-h-0 flex-1', children: [(0, jsx_runtime_1.jsx)("video", { "aria-label": labels.title, autoPlay: true, className: `size-full object-contain ${isReady ? '' : 'invisible'}`, muted: true, playsInline: true, ref: videoRef }), status === ps_scan_camera_status_1.PsScanCameraStatus.Starting ? ((0, jsx_runtime_1.jsxs)("div", { className: 'absolute inset-0 flex flex-col items-center justify-center gap-3 text-sm text-white/80', role: 'status', children: [(0, jsx_runtime_1.jsx)(ps_core_components_1.PsSpinner, { color: 'current', label: labels.cameraStarting, size: 'small' }), (0, jsx_runtime_1.jsx)("span", { children: labels.cameraStarting })] })) : null, message === '' ? null : ((0, jsx_runtime_1.jsx)("div", { className: 'absolute inset-0 flex items-center justify-center p-6 text-center text-sm text-white/85', role: 'status', children: (0, jsx_runtime_1.jsx)("p", { className: 'max-w-sm', children: message }) }))] }), (0, jsx_runtime_1.jsxs)("div", { className: 'flex shrink-0 flex-wrap items-center justify-center gap-3 px-4 pt-3 pb-[max(0.75rem,env(safe-area-inset-bottom))]', children: [canGoBack ? ((0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { onClick: onBack, variant: 'surface', children: labels.backToPages })) : null, (0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { leadingIcon: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: ps_icons_1.PsIconKey.Image }), onClick: () => libraryInput.current?.click(), variant: 'surface', children: labels.choosePhotos }), isReady ? ((0, jsx_runtime_1.jsx)("button", { "aria-label": labels.capture, className: 'ps-focus-ring flex size-[4.5rem] shrink-0 items-center justify-center rounded-full border-4 border-white bg-white/20 transition active:scale-95', onClick: onCapture, title: labels.capture, type: 'button', children: (0, jsx_runtime_1.jsx)("span", { className: 'size-12 rounded-full bg-white' }) })) : ((0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { onClick: () => captureInput.current?.click(), variant: 'primary', children: labels.takePhoto })), canTorch && isReady ? ((0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { isPressed: isTorchOn, label: isTorchOn ? labels.torchOff : labels.torchOn, onClick: onToggleTorch, children: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: ps_icons_1.PsIconKey.Spark }) })) : null] }), (0, jsx_runtime_1.jsx)("input", { accept: 'image/*', capture: 'environment', className: 'sr-only', onChange: onChange, ref: captureInput, tabIndex: -1, type: 'file' }), (0, jsx_runtime_1.jsx)("input", { accept: 'image/*', className: 'sr-only', multiple: true, onChange: onChange, ref: libraryInput, tabIndex: -1, type: 'file' })] }));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: 'relative h-full min-h-0 overflow-hidden bg-black text-white', children: [(0, jsx_runtime_1.jsxs)("div", { className: 'absolute inset-0', ref: areaRef, children: [(0, jsx_runtime_1.jsx)("video", { "aria-hidden": 'true', autoPlay: true, className: ps_design_system_1.PallasoftClassNameService.merge('size-full object-cover transition-opacity duration-300', isReady ? 'opacity-100' : 'opacity-0'), muted: true, onLoadedMetadata: measure, onResize: measure, playsInline: true, ref: videoTarget }), isReady ? ((0, jsx_runtime_1.jsx)(ps_scan_viewfinder_overlay_1.PsScanViewfinderOverlay, { area: area, quad: detection.quad, video: video })) : null] }), isReady ? null : ((0, jsx_runtime_1.jsxs)("div", { className: 'absolute inset-0 flex flex-col items-center justify-center gap-3 text-sm text-white/75', role: 'status', children: [(0, jsx_runtime_1.jsx)(ps_core_components_1.PsSpinner, { color: 'current', label: labels.cameraStarting, size: 'small' }), (0, jsx_runtime_1.jsx)("span", { children: labels.cameraStarting })] })), flashKey > 0 ? ((0, jsx_runtime_1.jsx)("div", { "aria-hidden": 'true', className: 'pointer-events-none absolute inset-0 bg-white animate-ps-fade-out' }, flashKey)) : null, (0, jsx_runtime_1.jsxs)("div", { className: 'absolute inset-x-0 top-0 flex items-start justify-between gap-3 bg-gradient-to-b from-black/60 to-transparent px-4 pb-10 pt-[max(1rem,env(safe-area-inset-top))]', children: [(0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { iconKey: ps_icons_1.PsIconKey.Close, label: labels.close, onClick: onClose }), (0, jsx_runtime_1.jsxs)("div", { className: 'flex items-center gap-2', children: [canTorch && isReady ? ((0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { iconKey: ps_icons_1.PsIconKey.Flash, isPressed: isTorchOn, label: isTorchOn ? labels.torchOff : labels.torchOn, onClick: onToggleTorch })) : null, (0, jsx_runtime_1.jsx)("button", { "aria-label": labels.autoCapture, "aria-pressed": isAuto, className: ps_design_system_1.PallasoftClassNameService.merge(ps_scan_chrome_classes_1.PsScanChromeClasses.button, 'border-transparent', isAuto ? ps_scan_chrome_classes_1.PsScanChromeClasses.iconOn : ps_scan_chrome_classes_1.PsScanChromeClasses.iconOff), onClick: onToggleAuto, title: labels.autoCapture, type: 'button', children: labels.auto })] })] }), isReady ? ((0, jsx_runtime_1.jsx)("div", { className: 'absolute inset-x-0 top-[calc(max(1rem,env(safe-area-inset-top))+3.75rem)] flex justify-center px-4', children: (0, jsx_runtime_1.jsx)("p", { "aria-live": 'polite', className: ps_scan_chrome_classes_1.PsScanChromeClasses.pill, children: hint }) })) : null, (0, jsx_runtime_1.jsxs)("div", { className: 'absolute inset-x-0 bottom-0 grid grid-cols-[1fr_auto_1fr] items-center gap-4 bg-gradient-to-t from-black/80 to-transparent px-5 pb-[max(1.5rem,env(safe-area-inset-bottom))] pt-12', children: [(0, jsx_runtime_1.jsx)("div", { className: 'flex justify-start', children: pageCount > 0 ? ((0, jsx_runtime_1.jsx)(ps_scan_page_stack_1.PsScanPageStack, { count: pageCount, label: ps_scan_template_service_1.PsScanTemplateService.fill(labels.viewPages, { count: pageCount }), onOpen: onDone, preview: lastPreview })) : ((0, jsx_runtime_1.jsx)(ps_scan_photo_button_1.PsScanPhotoButton, { isIconOnly: true, isMultiple: isMultiple, label: labels.choosePhotos, onFiles: onFiles })) }), (0, jsx_runtime_1.jsx)(ps_scan_shutter_1.PsScanShutter, { disabled: !isReady || isFull || isBusy, label: labels.capture, onCapture: onCapture, progress: detection.progress }), (0, jsx_runtime_1.jsx)("div", { className: 'flex justify-end', children: pageCount > 0 ? ((0, jsx_runtime_1.jsx)(ps_scan_button_1.PsScanButton, { isPrimary: true, onClick: onDone, children: labels.done })) : null })] })] }));
 };
 exports.PsScanCameraView = PsScanCameraView;

package/dist/components/ps-scan-crop-editor.d.ts

@@ -4,10 +4,10 @@ import type { PsScanPage } from '../models/ps-scan-page';
 import type { PsScanQuad } from '../models/ps-scan-quad';
 export interface PsScanCropEditorProps {
     labels: PsLabelSet<typeof PsDocumentScannerLabels>;
-    onApply: () => void;
     onAutoDetect: () => void;
     onChange: (corners: PsScanQuad) => void;
+    onKeep: () => void;
     onRetake: () => void;
     page: PsScanPage;
 }
-export declare const PsScanCropEditor: ({ labels, onApply, onAutoDetect, onChange, onRetake, page, }: PsScanCropEditorProps) => import("react").JSX.Element;
+export declare const PsScanCropEditor: ({ labels, onAutoDetect, onChange, onKeep, onRetake, page, }: PsScanCropEditorProps) => import("react").JSX.Element;

package/dist/components/ps-scan-crop-editor.js

@@ -4,12 +4,18 @@ exports.PsScanCropEditor = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const ps_core_components_1 = require("@pallasoft/ps-core-components");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_icons_1 = require("@pallasoft/ps-icons");
 const ps_scan_config_1 = require("../constants/ps-scan-config");
 const ps_scan_corner_order_1 = require("../constants/ps-scan-corner-order");
 const ps_scan_geometry_service_1 = require("../services/ps-scan-geometry-service");
-const PsScanCropEditor = ({ labels, onApply, onAutoDetect, onChange, onRetake, page, }) => {
+const ps_scan_button_1 = require("./ps-scan-button");
+const ps_scan_icon_button_1 = require("./ps-scan-icon-button");
+const ps_scan_loupe_1 = require("./ps-scan-loupe");
+const PsScanCropEditor = ({ labels, onAutoDetect, onChange, onKeep, onRetake, page, }) => {
     const [areaRef, area] = (0, ps_core_components_1.usePsElementSize)();
     const stageRef = (0, react_1.useRef)(null);
+    const [activeIndex, setActiveIndex] = (0, react_1.useState)(null);
     const hintId = 'ps-scan-crop-hint';
     const size = ps_scan_geometry_service_1.PsScanGeometryService.fit(area, { height: page.height, width: page.width });
     const cornerLabels = [
@@ -18,6 +24,9 @@ const PsScanCropEditor = ({ labels, onApply, onAutoDetect, onChange, onRetake, p
         labels.cornerBottomRight,
         labels.cornerBottomLeft,
     ];
+    const outline = page.corners
+        .map((point) => `${point.x * size.width},${point.y * size.height}`)
+        .join(' L');
     const move = (index, event) => {
         const stage = stageRef.current;
         if (stage === null || !event.currentTarget.hasPointerCapture(event.pointerId))
@@ -31,6 +40,10 @@ const PsScanCropEditor = ({ labels, onApply, onAutoDetect, onChange, onRetake, p
         if (ps_scan_geometry_service_1.PsScanGeometryService.isUsable(next))
             onChange(next);
     };
+    const release = (event) => {
+        event.currentTarget.releasePointerCapture(event.pointerId);
+        setActiveIndex(null);
+    };
     const nudge = (index, event) => {
         const step = event.shiftKey ? ps_scan_config_1.PsScanConfig.cornerNudgeLarge : ps_scan_config_1.PsScanConfig.cornerNudge;
         const deltas = {
@@ -45,9 +58,12 @@ const PsScanCropEditor = ({ labels, onApply, onAutoDetect, onChange, onRetake, p
         event.preventDefault();
         onChange(ps_scan_geometry_service_1.PsScanGeometryService.nudge(page.corners, index, delta[0], delta[1]));
     };
-    return ((0, jsx_runtime_1.jsxs)("div", { className: 'flex h-full min-h-0 flex-col bg-slate-950 text-white', children: [(0, jsx_runtime_1.jsx)("p", { className: 'shrink-0 px-4 pt-3 text-center text-sm text-white/80', id: hintId, children: labels.cropHint }), (0, jsx_runtime_1.jsx)("div", { className: 'flex min-h-0 flex-1 items-center justify-center p-6', ref: areaRef, children: (0, jsx_runtime_1.jsxs)("div", { className: 'relative touch-none select-none', ref: stageRef, style: { height: size.height, width: size.width }, children: [(0, jsx_runtime_1.jsx)("img", { alt: '', className: 'absolute inset-0 size-full', draggable: false, src: page.sourceUrl }), (0, jsx_runtime_1.jsx)("svg", { "aria-hidden": 'true', className: 'pointer-events-none absolute inset-0 size-full', preserveAspectRatio: 'none', viewBox: '0 0 1 1', children: (0, jsx_runtime_1.jsx)("polygon", { fill: 'rgba(255,255,255,0.12)', points: page.corners.map((point) => `${point.x},${point.y}`).join(' '), stroke: 'white', strokeWidth: 2, vectorEffect: 'non-scaling-stroke' }) }), ps_scan_corner_order_1.PsScanCornerOrder.map((key, index) => ((0, jsx_runtime_1.jsx)("button", { "aria-describedby": hintId, "aria-label": cornerLabels[index], className: 'ps-focus-ring absolute flex size-11 -translate-x-1/2 -translate-y-1/2 cursor-grab touch-none items-center justify-center rounded-full active:cursor-grabbing', onKeyDown: (event) => nudge(index, event), onPointerCancel: (event) => event.currentTarget.releasePointerCapture(event.pointerId), onPointerDown: (event) => event.currentTarget.setPointerCapture(event.pointerId), onPointerMove: (event) => move(index, event), onPointerUp: (event) => event.currentTarget.releasePointerCapture(event.pointerId), style: {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: 'flex h-full min-h-0 flex-col bg-black text-white animate-ps-fade-in', children: [(0, jsx_runtime_1.jsxs)("header", { className: 'grid shrink-0 grid-cols-[2.75rem_1fr_2.75rem] items-center gap-3 px-4 pb-1 pt-[max(1rem,env(safe-area-inset-top))]', children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": 'true' }), (0, jsx_runtime_1.jsx)("h2", { className: 'truncate text-center text-base font-semibold', children: labels.cropTitle }), (0, jsx_runtime_1.jsx)(ps_scan_icon_button_1.PsScanIconButton, { iconKey: ps_icons_1.PsIconKey.Spark, label: labels.autoDetect, onClick: onAutoDetect })] }), (0, jsx_runtime_1.jsx)("p", { className: 'shrink-0 px-6 text-center text-sm text-white/65', id: hintId, children: labels.cropHint }), (0, jsx_runtime_1.jsx)("div", { className: 'flex min-h-0 flex-1 items-center justify-center px-8 py-6', ref: areaRef, children: (0, jsx_runtime_1.jsxs)("div", { className: 'relative touch-none select-none', ref: stageRef, style: { height: size.height, width: size.width }, children: [(0, jsx_runtime_1.jsx)("img", { alt: '', className: 'absolute inset-0 size-full rounded-sm', draggable: false, src: page.sourceUrl }), (0, jsx_runtime_1.jsxs)("svg", { "aria-hidden": 'true', className: 'pointer-events-none absolute inset-0 size-full overflow-visible', viewBox: `0 0 ${Math.max(1, size.width)} ${Math.max(1, size.height)}`, children: [(0, jsx_runtime_1.jsx)("path", { className: 'fill-black/55', d: `M0 0H${size.width}V${size.height}H0Z M${outline}Z`, fillRule: 'evenodd' }), (0, jsx_runtime_1.jsx)("path", { className: 'fill-none stroke-primary', d: `M${outline}Z`, strokeLinejoin: 'round', strokeWidth: '2.5' })] }), ps_scan_corner_order_1.PsScanCornerOrder.map((key, index) => ((0, jsx_runtime_1.jsx)("button", { "aria-describedby": hintId, "aria-label": cornerLabels[index], className: 'ps-focus-ring absolute flex size-12 -translate-x-1/2 -translate-y-1/2 cursor-grab touch-none items-center justify-center rounded-full active:cursor-grabbing', onKeyDown: (event) => nudge(index, event), onPointerCancel: release, onPointerDown: (event) => {
+                                event.currentTarget.setPointerCapture(event.pointerId);
+                                setActiveIndex(index);
+                            }, onPointerMove: (event) => move(index, event), onPointerUp: release, style: {
                                 left: `${page.corners[index].x * 100}%`,
                                 top: `${page.corners[index].y * 100}%`,
-                            }, type: 'button', children: (0, jsx_runtime_1.jsx)("span", { className: 'size-5 rounded-full border-2 border-white bg-primary shadow' }) }, key)))] }) }), (0, jsx_runtime_1.jsxs)("div", { className: 'flex shrink-0 flex-wrap items-center justify-center gap-3 px-4 pt-2 pb-[max(0.75rem,env(safe-area-inset-bottom))]', children: [(0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { onClick: onRetake, variant: 'surface', children: labels.retake }), (0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { onClick: onAutoDetect, variant: 'surface', children: labels.autoDetect }), (0, jsx_runtime_1.jsx)(ps_core_components_1.PsButton, { onClick: onApply, variant: 'primary', children: labels.cropApply })] })] }));
+                            }, type: 'button', children: (0, jsx_runtime_1.jsx)("span", { className: ps_design_system_1.PallasoftClassNameService.merge('size-6 rounded-full border-[3px] border-white bg-primary shadow-lg transition-transform duration-150', activeIndex === index ? 'scale-125' : '') }) }, key))), activeIndex === null ? null : ((0, jsx_runtime_1.jsx)(ps_scan_loupe_1.PsScanLoupe, { corners: page.corners, point: page.corners[activeIndex], source: page.sourceUrl, stage: size }))] }) }), (0, jsx_runtime_1.jsxs)("footer", { className: 'mx-auto grid w-full max-w-md shrink-0 grid-cols-2 gap-3 px-4 pb-[max(1.25rem,env(safe-area-inset-bottom))] pt-2', children: [(0, jsx_runtime_1.jsx)(ps_scan_button_1.PsScanButton, { isLarge: true, onClick: onRetake, children: labels.retake }), (0, jsx_runtime_1.jsx)(ps_scan_button_1.PsScanButton, { isLarge: true, isPrimary: true, onClick: onKeep, children: labels.keepScan })] })] }));
 };
 exports.PsScanCropEditor = PsScanCropEditor;

package/dist/components/ps-scan-denied-steps.d.ts

@@ -0,0 +1,6 @@
+import { PsDocumentScannerLabels } from '../constants/ps-document-scanner-labels';
+import type { PsLabelSet } from '../models/ps-label-set';
+export interface PsScanDeniedStepsProps {
+    labels: PsLabelSet<typeof PsDocumentScannerLabels>;
+}
+export declare const PsScanDeniedSteps: ({ labels }: PsScanDeniedStepsProps) => import("react").JSX.Element;

package/dist/components/ps-scan-denied-steps.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanDeniedSteps = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_scan_platform_1 = require("../constants/ps-scan-platform");
+const ps_scan_platform_service_1 = require("../services/ps-scan-platform-service");
+const PsScanDeniedSteps = ({ labels }) => {
+    const [platform, setPlatform] = (0, react_1.useState)(() => ps_scan_platform_service_1.PsScanPlatformService.detect());
+    const platforms = [
+        {
+            key: ps_scan_platform_1.PsScanPlatform.Ios,
+            label: labels.platformIos,
+            steps: [labels.deniedIos1, labels.deniedIos2, labels.deniedIos3],
+        },
+        {
+            key: ps_scan_platform_1.PsScanPlatform.Android,
+            label: labels.platformAndroid,
+            steps: [labels.deniedAndroid1, labels.deniedAndroid2, labels.deniedAndroid3],
+        },
+        {
+            key: ps_scan_platform_1.PsScanPlatform.Desktop,
+            label: labels.platformDesktop,
+            steps: [labels.deniedDesktop1, labels.deniedDesktop2, labels.deniedDesktop3],
+        },
+    ];
+    const active = platforms.find((item) => item.key === platform);
+    return ((0, jsx_runtime_1.jsxs)("div", { className: 'flex w-full flex-col gap-4 rounded-ps-control border border-white/10 bg-white/5 p-4 text-left', children: [(0, jsx_runtime_1.jsx)("div", { className: 'grid grid-cols-3 gap-1 rounded-ps-control bg-black/40 p-1', role: 'group', children: platforms.map((item) => ((0, jsx_runtime_1.jsx)("button", { "aria-pressed": item.key === platform, className: ps_design_system_1.PallasoftClassNameService.merge('ps-focus-ring ps-control min-w-0 truncate rounded-ps-control px-2 text-xs font-semibold transition', item.key === platform
+                        ? 'bg-white text-black'
+                        : 'text-white/70 hover:bg-white/10 hover:text-white'), onClick: () => setPlatform(item.key), type: 'button', children: item.label }, item.key))) }), (0, jsx_runtime_1.jsx)("ol", { className: 'flex flex-col gap-3', children: (active === undefined ? [] : active.steps).map((step, index) => ((0, jsx_runtime_1.jsxs)("li", { className: 'flex items-start gap-3 text-sm leading-5 text-white/85', children: [(0, jsx_runtime_1.jsx)("span", { className: 'flex size-6 shrink-0 items-center justify-center rounded-full bg-primary text-xs font-bold text-[color:var(--ps-color-primary-contrast)]', children: index + 1 }), (0, jsx_runtime_1.jsx)("span", { className: 'pt-0.5', children: step })] }, step))) })] }));
+};
+exports.PsScanDeniedSteps = PsScanDeniedSteps;