@pallasoft/ps-file-components 1.3.0 → 1.5.0

package/dist/constants/ps-file-picker-labels.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PsFilePickerLabels = void 0;
 exports.PsFilePickerLabels = {
-    browse: 'or click to browse your files',
-    browseTouch: 'or tap to choose from your device',
+    choose: 'Choose files',
+    chooseOne: 'Choose a file',
+    dragHint: 'Drag and drop files here',
+    dragHintOne: 'Drag and drop a file here',
     dropActive: 'Drop to upload',
-    formats: 'Accepted formats:',
     invalidType: 'is not a supported file type.',
+    scan: 'Scan with camera',
     tooLarge: 'is too large.',
 };

package/dist/constants/ps-scan-camera-status.d.ts

@@ -0,0 +1,11 @@
+export declare const PsScanCameraStatus: {
+    readonly Busy: "busy";
+    readonly Checking: "checking";
+    readonly Denied: "denied";
+    readonly Insecure: "insecure";
+    readonly Prompt: "prompt";
+    readonly Ready: "ready";
+    readonly Starting: "starting";
+    readonly Unavailable: "unavailable";
+};
+export type PsScanCameraStatus = (typeof PsScanCameraStatus)[keyof typeof PsScanCameraStatus];

package/dist/constants/ps-scan-camera-status.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanCameraStatus = void 0;
+exports.PsScanCameraStatus = {
+    Busy: 'busy',
+    Checking: 'checking',
+    Denied: 'denied',
+    Insecure: 'insecure',
+    Prompt: 'prompt',
+    Ready: 'ready',
+    Starting: 'starting',
+    Unavailable: 'unavailable',
+};

package/dist/constants/ps-scan-chrome-classes.d.ts

@@ -0,0 +1,12 @@
+export declare const PsScanChromeClasses: {
+    readonly button: "ps-focus-ring ps-control ps-control-padding inline-flex max-w-full items-center justify-center gap-2 rounded-ps-control border text-sm font-semibold leading-5 transition disabled:pointer-events-none disabled:opacity-40";
+    readonly buttonLarge: "ps-control-large ps-control-padding-large";
+    readonly buttonPrimary: "border-primary bg-primary text-[color:var(--ps-color-primary-contrast)] hover:border-primary-dark hover:bg-primary-dark";
+    readonly buttonQuiet: "border-white/15 bg-white/10 text-white hover:border-white/25 hover:bg-white/20";
+    readonly chip: "ps-focus-ring ps-control inline-flex min-w-0 items-center justify-center rounded-ps-control px-2 text-sm font-semibold transition";
+    readonly icon: "ps-focus-ring ps-control ps-control-square inline-flex shrink-0 items-center justify-center rounded-ps-control text-white transition disabled:pointer-events-none disabled:opacity-40";
+    readonly iconOff: "bg-black/45 backdrop-blur-md hover:bg-white/20";
+    readonly iconOn: "bg-white text-black hover:bg-white/90";
+    readonly pill: "pointer-events-none rounded-ps-pill bg-black/55 px-3.5 py-1.5 text-sm font-medium text-white backdrop-blur-md";
+    readonly tool: "ps-focus-ring flex min-h-14 min-w-16 flex-col items-center justify-center gap-1 rounded-ps-control px-2 text-xs font-medium text-white/80 transition hover:bg-white/10 hover:text-white disabled:pointer-events-none disabled:opacity-40";
+};

package/dist/constants/ps-scan-chrome-classes.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanChromeClasses = void 0;
+exports.PsScanChromeClasses = {
+    button: 'ps-focus-ring ps-control ps-control-padding inline-flex max-w-full items-center justify-center gap-2 rounded-ps-control border text-sm font-semibold leading-5 transition disabled:pointer-events-none disabled:opacity-40',
+    buttonLarge: 'ps-control-large ps-control-padding-large',
+    buttonPrimary: 'border-primary bg-primary text-[color:var(--ps-color-primary-contrast)] hover:border-primary-dark hover:bg-primary-dark',
+    buttonQuiet: 'border-white/15 bg-white/10 text-white hover:border-white/25 hover:bg-white/20',
+    chip: 'ps-focus-ring ps-control inline-flex min-w-0 items-center justify-center rounded-ps-control px-2 text-sm font-semibold transition',
+    icon: 'ps-focus-ring ps-control ps-control-square inline-flex shrink-0 items-center justify-center rounded-ps-control text-white transition disabled:pointer-events-none disabled:opacity-40',
+    iconOff: 'bg-black/45 backdrop-blur-md hover:bg-white/20',
+    iconOn: 'bg-white text-black hover:bg-white/90',
+    pill: 'pointer-events-none rounded-ps-pill bg-black/55 px-3.5 py-1.5 text-sm font-medium text-white backdrop-blur-md',
+    tool: 'ps-focus-ring flex min-h-14 min-w-16 flex-col items-center justify-center gap-1 rounded-ps-control px-2 text-xs font-medium text-white/80 transition hover:bg-white/10 hover:text-white disabled:pointer-events-none disabled:opacity-40',
+};

package/dist/constants/ps-scan-config.d.ts

@@ -0,0 +1,48 @@
+export declare const PsScanConfig: {
+    readonly adaptiveRatio: 0.92;
+    readonly adaptiveWindowDivisor: 16;
+    readonly adaptiveWindowMin: 15;
+    readonly autoCaptureMs: 1000;
+    readonly cameraPermission: "camera";
+    readonly capturedJpegQuality: 0.92;
+    readonly cornerNudge: 0.005;
+    readonly cornerNudgeLarge: 0.025;
+    readonly decodeMaxDimension: 3000;
+    readonly defaultFileName: "scan";
+    readonly defaultJpegQuality: 0.82;
+    readonly defaultMaxDimension: 2000;
+    readonly defaultMaxPages: 30;
+    readonly detectDilations: 2;
+    readonly detectInset: 3;
+    readonly detectMaxDimension: 320;
+    readonly detectMinAreaRatio: 0.12;
+    readonly detectMaxAreaRatio: 0.995;
+    readonly detectMinEdgeStrength: 24;
+    readonly detectMinHullFill: 0.85;
+    readonly detectPercentile: 0.98;
+    readonly detectRelativeStrength: 0.3;
+    readonly guideArm: 36;
+    readonly guideArmRatio: 0.18;
+    readonly guideAspect: 0.72;
+    readonly guideHeightRatio: 0.58;
+    readonly guideLift: 0.03;
+    readonly guideWidthRatio: 0.76;
+    readonly hullCandidateLimit: 18;
+    readonly levelHighPercentile: 0.99;
+    readonly levelLowPercentile: 0.01;
+    readonly liveDetectIntervalMs: 160;
+    readonly liveDetectMaxDimension: 240;
+    readonly liveMissLimit: 2;
+    readonly liveRearmMovement: 0.08;
+    readonly liveSmoothing: 0.5;
+    readonly liveStillMovement: 0.02;
+    readonly loupeOffset: 72;
+    readonly loupeSize: 112;
+    readonly loupeZoom: 2.5;
+    readonly minCornerGap: 0.02;
+    readonly pdfDpi: 150;
+    readonly pdfPointsPerInch: 72;
+    readonly previewDebounceMs: 120;
+    readonly previewMaxDimension: 1400;
+    readonly torchConstraint: "torch";
+};

package/dist/constants/ps-scan-config.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanConfig = void 0;
+exports.PsScanConfig = {
+    adaptiveRatio: 0.92,
+    adaptiveWindowDivisor: 16,
+    adaptiveWindowMin: 15,
+    autoCaptureMs: 1000,
+    cameraPermission: 'camera',
+    capturedJpegQuality: 0.92,
+    cornerNudge: 0.005,
+    cornerNudgeLarge: 0.025,
+    decodeMaxDimension: 3000,
+    defaultFileName: 'scan',
+    defaultJpegQuality: 0.82,
+    defaultMaxDimension: 2000,
+    defaultMaxPages: 30,
+    detectDilations: 2,
+    detectInset: 3,
+    detectMaxDimension: 320,
+    detectMinAreaRatio: 0.12,
+    detectMaxAreaRatio: 0.995,
+    detectMinEdgeStrength: 24,
+    detectMinHullFill: 0.85,
+    detectPercentile: 0.98,
+    detectRelativeStrength: 0.3,
+    guideArm: 36,
+    guideArmRatio: 0.18,
+    guideAspect: 0.72,
+    guideHeightRatio: 0.58,
+    guideLift: 0.03,
+    guideWidthRatio: 0.76,
+    hullCandidateLimit: 18,
+    levelHighPercentile: 0.99,
+    levelLowPercentile: 0.01,
+    liveDetectIntervalMs: 160,
+    liveDetectMaxDimension: 240,
+    liveMissLimit: 2,
+    liveRearmMovement: 0.08,
+    liveSmoothing: 0.5,
+    liveStillMovement: 0.02,
+    loupeOffset: 72,
+    loupeSize: 112,
+    loupeZoom: 2.5,
+    minCornerGap: 0.02,
+    pdfDpi: 150,
+    pdfPointsPerInch: 72,
+    previewDebounceMs: 120,
+    previewMaxDimension: 1400,
+    torchConstraint: 'torch',
+};

package/dist/constants/ps-scan-corner-order.d.ts

@@ -0,0 +1 @@
+export declare const PsScanCornerOrder: readonly ["topLeft", "topRight", "bottomRight", "bottomLeft"];

package/dist/constants/ps-scan-corner-order.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanCornerOrder = void 0;
+exports.PsScanCornerOrder = ['topLeft', 'topRight', 'bottomRight', 'bottomLeft'];

package/dist/constants/ps-scan-filter.d.ts

@@ -0,0 +1,7 @@
+export declare const PsScanFilter: {
+    readonly Colour: "colour";
+    readonly Document: "document";
+    readonly Greyscale: "greyscale";
+    readonly Original: "original";
+};
+export type PsScanFilter = (typeof PsScanFilter)[keyof typeof PsScanFilter];

package/dist/constants/ps-scan-filter.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanFilter = void 0;
+exports.PsScanFilter = {
+    Colour: 'colour',
+    Document: 'document',
+    Greyscale: 'greyscale',
+    Original: 'original',
+};

package/dist/constants/ps-scan-output-format.d.ts

@@ -0,0 +1,5 @@
+export declare const PsScanOutputFormat: {
+    readonly Jpeg: "jpeg";
+    readonly Pdf: "pdf";
+};
+export type PsScanOutputFormat = (typeof PsScanOutputFormat)[keyof typeof PsScanOutputFormat];

package/dist/constants/ps-scan-output-format.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanOutputFormat = void 0;
+exports.PsScanOutputFormat = {
+    Jpeg: 'jpeg',
+    Pdf: 'pdf',
+};

package/dist/constants/ps-scan-platform.d.ts

@@ -0,0 +1,6 @@
+export declare const PsScanPlatform: {
+    readonly Android: "android";
+    readonly Desktop: "desktop";
+    readonly Ios: "ios";
+};
+export type PsScanPlatform = (typeof PsScanPlatform)[keyof typeof PsScanPlatform];

package/dist/constants/ps-scan-platform.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanPlatform = void 0;
+exports.PsScanPlatform = {
+    Android: 'android',
+    Desktop: 'desktop',
+    Ios: 'ios',
+};

package/dist/constants/ps-scan-step.d.ts

@@ -0,0 +1,6 @@
+export declare const PsScanStep: {
+    readonly Camera: "camera";
+    readonly Crop: "crop";
+    readonly Review: "review";
+};
+export type PsScanStep = (typeof PsScanStep)[keyof typeof PsScanStep];

package/dist/constants/ps-scan-step.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanStep = void 0;
+exports.PsScanStep = {
+    Camera: 'camera',
+    Crop: 'crop',
+    Review: 'review',
+};

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

@@ -0,0 +1,4 @@
+import { lazy } from 'react';
+export const PsDocumentScannerLoader = lazy(() => import('./ps-document-scanner-sheet').then((module) => ({
+    default: module.PsDocumentScannerSheet,
+})));

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

@@ -0,0 +1,182 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useRef, useState } from 'react';
+import { PsLayer, usePsLayerZIndex, usePsRestoreFocus, usePsScrollLock, usePsViewport, } from '@pallasoft/ps-core-components';
+import { PallasoftViewportTier, PallasoftZIndex } from '@pallasoft/ps-design-system';
+import { PsIconKey } from '@pallasoft/ps-icons';
+import { createPortal } from 'react-dom';
+import { PsScanCameraStatus } from '../constants/ps-scan-camera-status';
+import { PsScanStep } from '../constants/ps-scan-step';
+import { usePsFocusTrap } from '../hooks/use-ps-focus-trap';
+import { usePsScanCamera } from '../hooks/use-ps-scan-camera';
+import { usePsScanLiveDetection } from '../hooks/use-ps-scan-live-detection';
+import { usePsScanPages } from '../hooks/use-ps-scan-pages';
+import { usePsScanPreviews } from '../hooks/use-ps-scan-previews';
+import { PsScanOutputService } from '../services/ps-scan-output-service';
+import { PsScanPipelineService } from '../services/ps-scan-pipeline-service';
+import { PsScanTemplateService } from '../services/ps-scan-template-service';
+import { PsScanCameraView } from './ps-scan-camera-view';
+import { PsScanCropEditor } from './ps-scan-crop-editor';
+import { PsScanIconButton } from './ps-scan-icon-button';
+import { PsScanPermissionView } from './ps-scan-permission-view';
+import { PsScanReview } from './ps-scan-review';
+export const PsDocumentScannerSheet = ({ fileName, isAutoCapture, jpegQuality, labels, maxDimension, maxPages, onClose, onComplete, outputFormat, }) => {
+    const tier = usePsViewport();
+    const zIndex = usePsLayerZIndex(PallasoftZIndex.Modal);
+    const content = useRef(null);
+    const { add, move, pages, remove, replace, setCorners, update } = usePsScanPages();
+    const [step, setStep] = useState(PsScanStep.Camera);
+    const [cropReturn, setCropReturn] = useState(PsScanStep.Camera);
+    const [activeId, setActiveId] = useState('');
+    const [retakeId, setRetakeId] = useState('');
+    const [announcement, setAnnouncement] = useState('');
+    const [error, setError] = useState('');
+    const [isBusy, setIsBusy] = useState(false);
+    const [isCapturing, setIsCapturing] = useState(false);
+    const [isAuto, setIsAuto] = useState(isAutoCapture);
+    const [flashKey, setFlashKey] = useState(0);
+    const camera = usePsScanCamera(step === PsScanStep.Camera);
+    const isReady = camera.status === PsScanCameraStatus.Ready;
+    const isFull = pages.length >= maxPages;
+    const previews = usePsScanPreviews(pages);
+    const page = pages.find((item) => item.id === activeId);
+    const lastPage = pages[pages.length - 1];
+    const isDesktop = tier === PallasoftViewportTier.Desktop;
+    const isCameraStep = step === PsScanStep.Camera;
+    const showsCamera = isReady || camera.status === PsScanCameraStatus.Starting;
+    usePsScrollLock(true);
+    usePsRestoreFocus(true);
+    usePsFocusTrap(content, true, onClose);
+    const edgeMessage = (isDetected) => isDetected ? labels.edgesFound : labels.edgesNotFound;
+    const addFiles = async (files, after) => {
+        setError('');
+        try {
+            const images = files.filter((file) => file.type === '' || file.type.startsWith('image/'));
+            if (retakeId !== '' && images.length > 0) {
+                const added = await replace(retakeId, images[0]);
+                setActiveId(retakeId);
+                setRetakeId('');
+                setStep(PsScanStep.Crop);
+                setAnnouncement(edgeMessage(added.isDetected));
+                return;
+            }
+            const room = Math.max(0, maxPages - pages.length);
+            if (images.length > room)
+                setError(labels.maxPages);
+            const added = await add(images.slice(0, room));
+            if (added.length === 0)
+                return;
+            const position = pages.length + added.length;
+            setActiveId(added[added.length - 1].page.id);
+            setAnnouncement(PsScanTemplateService.fill(labels.pageAdded, { position }));
+            if (after === null)
+                return;
+            if (added.length === 1) {
+                setCropReturn(after);
+                setStep(PsScanStep.Crop);
+                setAnnouncement(edgeMessage(added[0].isDetected));
+            }
+            else
+                setStep(PsScanStep.Review);
+        }
+        catch {
+            setError(labels.processFailed);
+        }
+    };
+    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 : PsScanStep.Camera);
+        }
+        finally {
+            setIsCapturing(false);
+        }
+    };
+    const detection = usePsScanLiveDetection(camera.videoRef, isCameraStep && isReady, isAuto, () => capture(true));
+    const autoDetect = async () => {
+        if (page === undefined)
+            return;
+        const prepared = await PsScanPipelineService.prepare(page.source);
+        setCorners(page.id, prepared.corners);
+        setAnnouncement(edgeMessage(prepared.isDetected));
+    };
+    const keep = () => setStep(cropReturn === PsScanStep.Camera && !isFull ? PsScanStep.Camera : PsScanStep.Review);
+    const retake = () => {
+        if (page === undefined)
+            return;
+        if (step === PsScanStep.Review)
+            setCropReturn(PsScanStep.Review);
+        setRetakeId(page.id);
+        setStep(PsScanStep.Camera);
+    };
+    const openCamera = () => {
+        setRetakeId('');
+        setCropReturn(PsScanStep.Camera);
+        setStep(PsScanStep.Camera);
+    };
+    const openReview = () => {
+        if (pages.length === 0)
+            return;
+        setRetakeId('');
+        if (page === undefined)
+            setActiveId(lastPage.id);
+        setStep(PsScanStep.Review);
+    };
+    const editCrop = () => {
+        setCropReturn(PsScanStep.Review);
+        setStep(PsScanStep.Crop);
+    };
+    const deletePage = () => {
+        if (page === undefined)
+            return;
+        const index = pages.findIndex((item) => item.id === page.id);
+        const rest = pages.filter((item) => item.id !== page.id);
+        remove(page.id);
+        setAnnouncement(labels.pageDeleted);
+        if (rest.length === 0) {
+            setActiveId('');
+            openCamera();
+        }
+        else
+            setActiveId(rest[Math.min(index, rest.length - 1)].id);
+    };
+    const finish = async () => {
+        setIsBusy(true);
+        setError('');
+        try {
+            const files = await PsScanOutputService.build(pages, {
+                fileName,
+                format: outputFormat,
+                jpegQuality,
+                maxDimension,
+            });
+            onComplete(files);
+            onClose();
+        }
+        catch {
+            setError(labels.processFailed);
+            setIsBusy(false);
+        }
+    };
+    const moveTo = useCallback((from, to) => {
+        move(from, to);
+        setAnnouncement(PsScanTemplateService.fill(labels.pageMoved, {
+            count: pages.length,
+            page: `${labels.page} ${from + 1}`,
+            position: to + 1,
+        }));
+    }, [move, pages.length, labels]);
+    const fromLibrary = (files) => addFiles(files, PsScanStep.Review);
+    if (typeof document === 'undefined')
+        return null;
+    return createPortal(_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: _jsx(PsLayer, { zIndex: zIndex, children: _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: [_jsx("p", { "aria-live": 'polite', className: 'sr-only', role: 'status', children: announcement }), isCameraStep && showsCamera ? (_jsx(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 ? (_jsxs(_Fragment, { children: [_jsx(PsScanPermissionView, { isMultiple: maxPages > 1, labels: labels, onAllow: camera.allow, onFiles: fromLibrary, status: camera.status }), _jsx("div", { className: 'absolute left-4 top-[max(1rem,env(safe-area-inset-top))] flex gap-2', children: _jsx(PsScanIconButton, { iconKey: PsIconKey.Close, label: labels.close, onClick: onClose }) }), pages.length > 0 ? (_jsx("div", { className: 'absolute right-4 top-[max(1rem,env(safe-area-inset-top))]', children: _jsx(PsScanIconButton, { iconKey: PsIconKey.Check, label: PsScanTemplateService.fill(labels.viewPages, { count: pages.length }), onClick: openReview }) })) : null] })) : null, step === PsScanStep.Crop && page !== undefined ? (_jsx(PsScanCropEditor, { labels: labels, onAutoDetect: autoDetect, onChange: (corners) => setCorners(page.id, corners), onKeep: keep, onRetake: retake, page: page })) : null, step === PsScanStep.Review && page !== undefined ? (_jsx(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 !== '' ? (_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);
+};

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

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense } from 'react';
+import { usePsHydrated } from '@pallasoft/ps-core-components';
+import { PsDocumentScannerLabels } from '../constants/ps-document-scanner-labels';
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanOutputFormat } from '../constants/ps-scan-output-format';
+import { PsDocumentScannerLoader } from './ps-document-scanner-loader';
+export const PsDocumentScanner = ({ fileName = PsScanConfig.defaultFileName, isAutoCapture = false, isOpen, jpegQuality = PsScanConfig.defaultJpegQuality, labels, maxDimension = PsScanConfig.defaultMaxDimension, maxPages = PsScanConfig.defaultMaxPages, onClose, onComplete, outputFormat = PsScanOutputFormat.Pdf, }) => {
+    const isHydrated = usePsHydrated();
+    if (!isOpen || !isHydrated)
+        return null;
+    return (_jsx(Suspense, { fallback: null, children: _jsx(PsDocumentScannerLoader, { fileName: fileName, isAutoCapture: isAutoCapture, jpegQuality: jpegQuality, labels: { ...PsDocumentScannerLabels, ...labels }, maxDimension: maxDimension, maxPages: maxPages, onClose: onClose, onComplete: onComplete, outputFormat: outputFormat }) }));
+};

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

@@ -0,0 +1,17 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { PsButton } from '@pallasoft/ps-core-components';
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+export const PsFilePickerActions = ({ chooseLabel, className, disabled, isTouch, onChoose, onScan, scanLabel, }) => {
+    const hasScan = scanLabel !== undefined;
+    const choose = (_jsx(PsButton, { className: isTouch ? 'w-full' : '', disabled: disabled, leadingIcon: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Upload }), onClick: (event) => {
+            event.stopPropagation();
+            onChoose();
+        }, size: isTouch ? 'large' : 'default', variant: hasScan && isTouch ? 'surface' : hasScan || isTouch ? 'primary' : 'surface', children: chooseLabel }));
+    return (_jsx("div", { className: 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 ? (_jsxs(_Fragment, { children: [isTouch ? null : choose, _jsx(PsButton, { className: isTouch ? 'w-full' : '', disabled: disabled, leadingIcon: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Camera }), onClick: (event) => {
+                        event.stopPropagation();
+                        onScan();
+                    }, size: isTouch ? 'large' : 'default', variant: isTouch ? 'primary' : 'surface', children: scanLabel }), isTouch ? choose : null] })) : (choose) }));
+};

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

@@ -1,15 +1,26 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo, useState } from 'react';
+import { useMemo, useRef, useState } from 'react';
 import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
 import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
 import { PsFilePickerLabels } from '../constants/ps-file-picker-labels';
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsUploadLabels } from '../constants/ps-upload-labels';
 import { PsFileSelectionService } from '../services/ps-file-selection-service';
-export const PsFilePicker = ({ accept, acceptLabel, className, disabled = false, dropLabel, isLoading = false, labels, maxSizeBytes, maxSizeLabel, multiple = false, onError, onFileLoad, onFilesSelect, touchLabel, }) => {
+import { PsDocumentScanner } from './ps-document-scanner';
+import { PsFilePickerActions } from './ps-file-picker-actions';
+import { PsUploadRow } from './ps-upload-row';
+export 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] = useState(false);
+    const [scanName, setScanName] = useState(null);
+    const input = useRef(null);
     const acceptAttr = useMemo(() => accept.join(','), [accept]);
     const text = { ...PsFilePickerLabels, ...labels };
+    const rowLabels = { ...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 (_jsx("span", { "aria-busy": 'true', className: PallasoftClassNameService.merge('ps-skeleton block min-h-32 w-full rounded-ps-panel', className), role: 'status' }));
+        return (_jsx("span", { "aria-busy": 'true', className: PallasoftClassNameService.merge('ps-skeleton block min-h-48 w-full rounded-ps-control', className), role: 'status' }));
     const select = (list) => {
         if (list === null || disabled)
             return;
@@ -28,6 +39,15 @@ export const PsFilePicker = ({ accept, acceptLabel, className, disabled = false,
         else
             onFileLoad?.(accepted[0]);
     };
+    const browse = () => {
+        if (!disabled)
+            input.current?.click();
+    };
+    const openScan = () => {
+        if (disabled || scan === undefined)
+            return;
+        setScanName(scan.getFileName === undefined ? PsScanConfig.defaultFileName : scan.getFileName());
+    };
     const onChange = (event) => {
         select(event.target.files);
         event.target.value = '';
@@ -37,8 +57,12 @@ export const PsFilePicker = ({ accept, acceptLabel, className, disabled = false,
         if (!disabled)
             setIsDragging(isOver);
     };
-    return (_jsxs("div", { className: 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: [_jsxs("div", { className: 'pointer-events-none flex flex-col items-center gap-3 text-center', children: [_jsx(PsIcon, { className: 'h-8 w-8 text-primary', iconKey: PsIconKey.Upload }), _jsxs("div", { children: [_jsx("p", { className: 'text-body-2 font-medium text-ink sm:text-body-1', children: isDragging ? (text.dropActive) : (_jsxs(_Fragment, { children: [_jsx("span", { className: touchLabel === undefined ? '' : '[@media(pointer:coarse)]:hidden', children: dropLabel }), touchLabel === undefined ? null : (_jsx("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: touchLabel }))] })) }), _jsxs("p", { className: 'mt-1 text-body-3 text-ink/60 sm:text-body-2', children: [_jsx("span", { className: '[@media(pointer:coarse)]:hidden', children: text.browse }), _jsx("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: text.browseTouch })] }), maxSizeLabel ? _jsx("p", { className: 'mt-3 text-body-3 text-ink/60', children: maxSizeLabel }) : null, _jsxs("p", { className: 'text-body-3 text-ink/60', children: [text.formats, " ", acceptLabel] })] })] }), _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 (_jsxs("div", { className: PallasoftClassNameService.merge('flex w-full flex-col gap-3', className), children: [_jsxs("div", { "aria-disabled": disabled || undefined, className: 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: [_jsx("span", { "aria-hidden": 'true', className: 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: _jsx(PsIcon, { className: 'size-6', iconKey: PsIconKey.Upload }) }), _jsxs("div", { className: 'flex flex-col gap-1', children: [_jsx("p", { className: 'text-base font-semibold text-ink', children: isDragging ? (text.dropActive) : (_jsxs(_Fragment, { children: [_jsx("span", { className: touchLabel === undefined ? '' : '[@media(pointer:coarse)]:hidden', children: dropLabel }), touchLabel === undefined ? null : (_jsx("span", { className: 'hidden [@media(pointer:coarse)]:inline', children: touchLabel }))] })) }), _jsx("p", { className: 'text-sm text-ink/60 [@media(pointer:coarse)]:hidden', children: multiple ? text.dragHint : text.dragHintOne })] }), _jsx(PsFilePickerActions, { chooseLabel: chooseLabel, className: 'flex [@media(pointer:coarse)]:hidden', disabled: disabled, isTouch: false, onChoose: browse, onScan: openScan, scanLabel: scanLabel }), _jsx(PsFilePickerActions, { chooseLabel: chooseLabel, className: 'hidden [@media(pointer:coarse)]:flex', disabled: disabled, isTouch: true, onChoose: browse, onScan: openScan, scanLabel: scanLabel }), details.length > 0 ? _jsx("p", { className: 'text-xs text-ink/50', children: details.join(' · ') }) : null, _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 : (_jsx("ul", { "aria-label": rowLabels.title, className: 'flex flex-col gap-2', children: queue.items.map((item) => (_jsx(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 : (_jsx(PsDocumentScanner, { ...scan, fileName: scanName === null ? PsScanConfig.defaultFileName : scanName, isOpen: scanName !== null, onClose: () => setScanName(null), onComplete: select }))] }));
 };

package/dist/esm/components/ps-file-viewer-pane.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from 'react';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+import { PsFileViewerConfig } from '../constants/ps-file-viewer-config';
+import { PsFileViewerKinds } from '../constants/ps-file-viewer-kinds';
+import { PsFileViewerLabels } from '../constants/ps-file-viewer-labels';
+import { PsFileTypeService } from '../services/ps-file-type-service';
+import { PsFileViewerButton } from './ps-file-viewer-button';
+import { PsFileViewerContent } from './ps-file-viewer-content';
+export const PsFileViewerPane = ({ contentType, headerActions, id, labels = PsFileViewerLabels, name, pdfWorkerSrc, url, }) => {
+    const [zoom, setZoom] = useState(1);
+    const [rotation, setRotation] = useState(0);
+    const kind = PsFileTypeService.kindOf(contentType, name);
+    const canZoom = PsFileViewerKinds.zoomable.includes(kind);
+    const canRotate = PsFileViewerKinds.rotatable.includes(kind);
+    const changeZoom = (step) => setZoom((current) => Math.min(PsFileViewerConfig.maxZoom, Math.max(PsFileViewerConfig.minZoom, current + step)));
+    const fileKey = id === undefined ? url : id;
+    const rotate = () => setRotation((current) => (current + PsFileViewerConfig.rotateStep) % 360);
+    const onKeyDown = (event) => {
+        if (event.metaKey || event.ctrlKey || event.altKey)
+            return;
+        if (canZoom && (event.key === '+' || event.key === '='))
+            changeZoom(PsFileViewerConfig.zoomStep);
+        else if (canZoom && (event.key === '-' || event.key === '_'))
+            changeZoom(-PsFileViewerConfig.zoomStep);
+        else if (canZoom && event.key === '0')
+            setZoom(1);
+        else if (canRotate && event.key.toLowerCase() === 'r')
+            rotate();
+        else
+            return;
+        event.preventDefault();
+    };
+    return (_jsxs("div", { className: 'flex h-full min-h-0 min-w-0 flex-col overflow-hidden rounded-ps-panel bg-black/85', children: [_jsxs("div", { className: 'flex shrink-0 flex-wrap items-center justify-between gap-x-2 border-b border-white/10 px-2 py-1 text-white', children: [_jsx("p", { className: 'min-w-0 flex-1 basis-32 truncate px-1 text-xs text-white/70', title: name, children: name }), _jsxs("div", { className: 'flex items-center gap-0.5', role: 'toolbar', children: [canZoom ? (_jsxs(_Fragment, { children: [_jsx(PsFileViewerButton, { disabled: zoom <= PsFileViewerConfig.minZoom, label: labels.zoomOut, onClick: () => changeZoom(-PsFileViewerConfig.zoomStep), children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.ZoomOut }) }), _jsxs(PsFileViewerButton, { className: 'w-14 text-xs', label: labels.zoomReset, onClick: () => setZoom(1), children: [Math.round(zoom * 100), "%"] }), _jsx(PsFileViewerButton, { disabled: zoom >= PsFileViewerConfig.maxZoom, label: labels.zoomIn, onClick: () => changeZoom(PsFileViewerConfig.zoomStep), children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.ZoomIn }) })] })) : null, canRotate ? (_jsx(PsFileViewerButton, { label: labels.rotate, onClick: rotate, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Rotate }) })) : null, headerActions] })] }), _jsx("div", { className: 'ps-focus-ring flex min-h-0 flex-1 p-2', onKeyDown: onKeyDown, tabIndex: 0, children: _jsx(PsFileViewerContent, { activeMatch: 0, file: { contentType, id: fileKey, name, url }, labels: labels, onMatchCount: () => undefined, pdfWorkerSrc: pdfWorkerSrc, query: '', rotation: rotation, zoom: zoom }, fileKey) })] }));
+};

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

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PsSpinner } from '@pallasoft/ps-core-components';
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+import { PsScanChromeClasses } from '../constants/ps-scan-chrome-classes';
+export const PsScanButton = ({ children, className, disabled = false, isLarge = false, isLoading = false, isPrimary = false, leadingIcon, loadingLabel, onClick, }) => (_jsxs("button", { "aria-busy": isLoading || undefined, className: PallasoftClassNameService.merge(PsScanChromeClasses.button, isLarge ? PsScanChromeClasses.buttonLarge : '', isPrimary ? PsScanChromeClasses.buttonPrimary : PsScanChromeClasses.buttonQuiet, 'relative', className), disabled: disabled || isLoading, onClick: onClick, type: 'button', children: [isLoading ? (_jsx(PsSpinner, { className: 'absolute inset-0 m-auto', color: 'current', label: loadingLabel === undefined ? '' : loadingLabel, size: 'small' })) : null, _jsxs("span", { "aria-hidden": isLoading || undefined, className: `inline-flex min-w-0 items-center gap-2 ${isLoading ? 'invisible' : ''}`, children: [leadingIcon === undefined ? null : _jsx("span", { className: 'shrink-0', children: leadingIcon }), _jsx("span", { className: 'truncate', children: children })] })] }));