@pallasoft/ps-file-components 1.3.0 → 1.4.0

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

@@ -0,0 +1,31 @@
+export declare const PsScanConfig: {
+    readonly adaptiveRatio: 0.92;
+    readonly adaptiveWindowDivisor: 16;
+    readonly adaptiveWindowMin: 15;
+    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 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 hullCandidateLimit: 18;
+    readonly levelHighPercentile: 0.99;
+    readonly levelLowPercentile: 0.01;
+    readonly minCornerGap: 0.02;
+    readonly pdfDpi: 150;
+    readonly pdfPointsPerInch: 72;
+    readonly previewDebounceMs: 120;
+    readonly previewMaxDimension: 1400;
+    readonly thumbnailHeight: 56;
+    readonly torchConstraint: "torch";
+};

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanConfig = void 0;
+exports.PsScanConfig = {
+    adaptiveRatio: 0.92,
+    adaptiveWindowDivisor: 16,
+    adaptiveWindowMin: 15,
+    capturedJpegQuality: 0.92,
+    cornerNudge: 0.005,
+    cornerNudgeLarge: 0.025,
+    decodeMaxDimension: 3000,
+    defaultFileName: 'scan',
+    defaultJpegQuality: 0.82,
+    defaultMaxDimension: 2000,
+    defaultMaxPages: 30,
+    detectDilations: 2,
+    detectMaxDimension: 320,
+    detectMinAreaRatio: 0.12,
+    detectMaxAreaRatio: 0.995,
+    detectMinEdgeStrength: 24,
+    detectMinHullFill: 0.85,
+    detectPercentile: 0.98,
+    detectRelativeStrength: 0.3,
+    hullCandidateLimit: 18,
+    levelHighPercentile: 0.99,
+    levelLowPercentile: 0.01,
+    minCornerGap: 0.02,
+    pdfDpi: 150,
+    pdfPointsPerInch: 72,
+    previewDebounceMs: 120,
+    previewMaxDimension: 1400,
+    thumbnailHeight: 56,
+    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-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,134 @@
+import { jsx as _jsx, 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 { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+import { PsModal } from '@pallasoft/ps-popovers';
+import { createPortal } from 'react-dom';
+import { PsScanStep } from '../constants/ps-scan-step';
+import { usePsFocusTrap } from '../hooks/use-ps-focus-trap';
+import { usePsScanCamera } from '../hooks/use-ps-scan-camera';
+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 { PsScanReview } from './ps-scan-review';
+export const PsDocumentScannerSheet = ({ fileName, 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 [activeId, setActiveId] = useState('');
+    const [retakeId, setRetakeId] = useState('');
+    const [announcement, setAnnouncement] = useState('');
+    const [error, setError] = useState('');
+    const [isBusy, setIsBusy] = useState(false);
+    const camera = usePsScanCamera(step === PsScanStep.Camera);
+    const previews = usePsScanPreviews(pages);
+    const page = pages.find((item) => item.id === activeId);
+    const isDesktop = tier === PallasoftViewportTier.Desktop;
+    usePsScrollLock(!isDesktop);
+    usePsRestoreFocus(true);
+    usePsFocusTrap(content, true, onClose);
+    const edgeMessage = (isDetected) => isDetected ? labels.edgesFound : labels.edgesNotFound;
+    const addFiles = async (files) => {
+        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;
+            setActiveId(added[0].page.id);
+            setStep(added.length === 1 ? PsScanStep.Crop : PsScanStep.Review);
+            setAnnouncement(added.length === 1
+                ? edgeMessage(added[0].isDetected)
+                : PsScanTemplateService.fill(labels.pageAdded, { position: pages.length + added.length }));
+        }
+        catch {
+            setError(labels.processFailed);
+        }
+    };
+    const capture = async () => {
+        const blob = await camera.capture();
+        if (blob !== null)
+            await addFiles([blob]);
+    };
+    const autoDetect = async () => {
+        if (page === undefined)
+            return;
+        const prepared = await PsScanPipelineService.prepare(page.source);
+        setCorners(page.id, prepared.corners);
+        setAnnouncement(edgeMessage(prepared.isDetected));
+    };
+    const retake = () => {
+        if (page === undefined)
+            return;
+        setRetakeId(page.id);
+        setStep(PsScanStep.Camera);
+    };
+    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('');
+            setStep(PsScanStep.Camera);
+        }
+        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 body = (_jsxs("div", { className: 'relative h-full min-h-0 bg-surface text-ink', ref: content, children: [_jsx("p", { "aria-live": 'polite', className: 'sr-only', role: 'status', children: announcement }), step === PsScanStep.Camera ? (_jsx(PsScanCameraView, { canGoBack: pages.length > 0, canTorch: camera.canTorch, isTorchOn: camera.isTorchOn, labels: labels, onBack: () => {
+                    setRetakeId('');
+                    setStep(PsScanStep.Review);
+                }, onCapture: capture, onFiles: addFiles, onToggleTorch: camera.toggleTorch, status: camera.status, videoRef: camera.videoRef })) : null, step === PsScanStep.Crop && page !== undefined ? (_jsx(PsScanCropEditor, { labels: labels, onApply: () => setStep(PsScanStep.Review), onAutoDetect: autoDetect, onChange: (corners) => setCorners(page.id, corners), onRetake: retake, page: page })) : null, step === PsScanStep.Review && page !== undefined ? (_jsx(PsScanReview, { canAddPage: pages.length < maxPages, error: error, isBusy: isBusy, labels: labels, onAddPage: () => setStep(PsScanStep.Camera), onDelete: deletePage, onEditCrop: () => setStep(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 === PsScanStep.Camera && error !== '' ? (_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 (_jsx(PsModal, { isOpen: true, onClose: onClose, size: 'xl', title: labels.title, children: _jsx("div", { className: '-m-4 h-[min(70dvh,38rem)] overflow-hidden sm:-m-5', children: body }) }));
+    if (typeof document === 'undefined')
+        return null;
+    return createPortal(_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: _jsxs(PsLayer, { zIndex: zIndex, children: [_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: [_jsx("h2", { className: 'truncate text-base font-semibold', children: labels.title }), _jsx(PsScanIconButton, { label: labels.close, onClick: onClose, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Close }) })] }), _jsx("div", { className: 'min-h-0 flex-1', children: body })] }) }), 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, 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, jpegQuality: jpegQuality, labels: { ...PsDocumentScannerLabels, ...labels }, maxDimension: maxDimension, maxPages: maxPages, onClose: onClose, onComplete: onComplete, outputFormat: outputFormat }) }));
+};

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-camera-view.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { PsButton, PsSpinner } from '@pallasoft/ps-core-components';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+import { PsScanCameraStatus } from '../constants/ps-scan-camera-status';
+import { PsScanIconButton } from './ps-scan-icon-button';
+export const PsScanCameraView = ({ canGoBack, canTorch, isTorchOn, labels, onBack, onCapture, onFiles, onToggleTorch, status, videoRef, }) => {
+    const captureInput = useRef(null);
+    const libraryInput = useRef(null);
+    const isReady = status === PsScanCameraStatus.Ready;
+    const message = status === PsScanCameraStatus.Denied
+        ? labels.cameraDenied
+        : status === 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);
+    };
+    return (_jsxs("div", { className: 'flex h-full min-h-0 flex-col bg-slate-950 text-white', children: [_jsxs("div", { className: 'relative min-h-0 flex-1', children: [_jsx("video", { "aria-label": labels.title, autoPlay: true, className: `size-full object-contain ${isReady ? '' : 'invisible'}`, muted: true, playsInline: true, ref: videoRef }), status === PsScanCameraStatus.Starting ? (_jsxs("div", { className: 'absolute inset-0 flex flex-col items-center justify-center gap-3 text-sm text-white/80', role: 'status', children: [_jsx(PsSpinner, { color: 'current', label: labels.cameraStarting, size: 'small' }), _jsx("span", { children: labels.cameraStarting })] })) : null, message === '' ? null : (_jsx("div", { className: 'absolute inset-0 flex items-center justify-center p-6 text-center text-sm text-white/85', role: 'status', children: _jsx("p", { className: 'max-w-sm', children: message }) }))] }), _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 ? (_jsx(PsButton, { onClick: onBack, variant: 'surface', children: labels.backToPages })) : null, _jsx(PsButton, { leadingIcon: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Image }), onClick: () => libraryInput.current?.click(), variant: 'surface', children: labels.choosePhotos }), isReady ? (_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: _jsx("span", { className: 'size-12 rounded-full bg-white' }) })) : (_jsx(PsButton, { onClick: () => captureInput.current?.click(), variant: 'primary', children: labels.takePhoto })), canTorch && isReady ? (_jsx(PsScanIconButton, { isPressed: isTorchOn, label: isTorchOn ? labels.torchOff : labels.torchOn, onClick: onToggleTorch, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Spark }) })) : null] }), _jsx("input", { accept: 'image/*', capture: 'environment', className: 'sr-only', onChange: onChange, ref: captureInput, tabIndex: -1, type: 'file' }), _jsx("input", { accept: 'image/*', className: 'sr-only', multiple: true, onChange: onChange, ref: libraryInput, tabIndex: -1, type: 'file' })] }));
+};

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

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { PsButton, usePsElementSize } from '@pallasoft/ps-core-components';
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanCornerOrder } from '../constants/ps-scan-corner-order';
+import { PsScanGeometryService } from '../services/ps-scan-geometry-service';
+export const PsScanCropEditor = ({ labels, onApply, onAutoDetect, onChange, onRetake, page, }) => {
+    const [areaRef, area] = usePsElementSize();
+    const stageRef = useRef(null);
+    const hintId = 'ps-scan-crop-hint';
+    const size = PsScanGeometryService.fit(area, { height: page.height, width: page.width });
+    const cornerLabels = [
+        labels.cornerTopLeft,
+        labels.cornerTopRight,
+        labels.cornerBottomRight,
+        labels.cornerBottomLeft,
+    ];
+    const move = (index, event) => {
+        const stage = stageRef.current;
+        if (stage === null || !event.currentTarget.hasPointerCapture(event.pointerId))
+            return;
+        const rect = stage.getBoundingClientRect();
+        const point = PsScanGeometryService.clamp({
+            x: (event.clientX - rect.left) / rect.width,
+            y: (event.clientY - rect.top) / rect.height,
+        });
+        const next = page.corners.map((corner, at) => (at === index ? point : corner));
+        if (PsScanGeometryService.isUsable(next))
+            onChange(next);
+    };
+    const nudge = (index, event) => {
+        const step = event.shiftKey ? PsScanConfig.cornerNudgeLarge : PsScanConfig.cornerNudge;
+        const deltas = {
+            ArrowDown: [0, step],
+            ArrowLeft: [-step, 0],
+            ArrowRight: [step, 0],
+            ArrowUp: [0, -step],
+        };
+        const delta = deltas[event.key];
+        if (delta === undefined)
+            return;
+        event.preventDefault();
+        onChange(PsScanGeometryService.nudge(page.corners, index, delta[0], delta[1]));
+    };
+    return (_jsxs("div", { className: 'flex h-full min-h-0 flex-col bg-slate-950 text-white', children: [_jsx("p", { className: 'shrink-0 px-4 pt-3 text-center text-sm text-white/80', id: hintId, children: labels.cropHint }), _jsx("div", { className: 'flex min-h-0 flex-1 items-center justify-center p-6', ref: areaRef, children: _jsxs("div", { className: 'relative touch-none select-none', ref: stageRef, style: { height: size.height, width: size.width }, children: [_jsx("img", { alt: '', className: 'absolute inset-0 size-full', draggable: false, src: page.sourceUrl }), _jsx("svg", { "aria-hidden": 'true', className: 'pointer-events-none absolute inset-0 size-full', preserveAspectRatio: 'none', viewBox: '0 0 1 1', children: _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' }) }), PsScanCornerOrder.map((key, index) => (_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: {
+                                left: `${page.corners[index].x * 100}%`,
+                                top: `${page.corners[index].y * 100}%`,
+                            }, type: 'button', children: _jsx("span", { className: 'size-5 rounded-full border-2 border-white bg-primary shadow' }) }, key)))] }) }), _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: [_jsx(PsButton, { onClick: onRetake, variant: 'surface', children: labels.retake }), _jsx(PsButton, { onClick: onAutoDetect, variant: 'surface', children: labels.autoDetect }), _jsx(PsButton, { onClick: onApply, variant: 'primary', children: labels.cropApply })] })] }));
+};

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

@@ -0,0 +1,3 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+export const PsScanIconButton = ({ children, className, disabled, isPressed, label, onClick, }) => (_jsx("button", { "aria-label": label, "aria-pressed": isPressed, className: PallasoftClassNameService.merge('ps-focus-ring inline-flex size-11 min-h-11 min-w-11 shrink-0 items-center justify-center rounded-ps-control border border-line bg-surface text-ink transition hover:border-primary/40 hover:text-primary disabled:pointer-events-none disabled:opacity-40', isPressed ? 'border-primary bg-primary-soft text-primary' : '', className), disabled: disabled, onClick: onClick, title: label, type: 'button', children: children }));

package/dist/esm/components/ps-scan-page-list.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PsSortableList } from '@pallasoft/ps-core-components';
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+import { PsScanTemplateService } from '../services/ps-scan-template-service';
+import { PsScanIconButton } from './ps-scan-icon-button';
+export const PsScanPageList = ({ activeId, labels, onMove, onSelect, pages, previews, }) => {
+    const items = pages.map((page, index) => ({
+        id: page.id,
+        label: `${labels.page} ${index + 1}`,
+    }));
+    const say = (template, label, position) => PsScanTemplateService.fill(template, { count: pages.length, page: label, position });
+    return (_jsx(PsSortableList, { announcements: {
+            cancelled: (label) => say(labels.reorderCancelled, label, 0),
+            dropped: (label, position) => say(labels.reorderDropped, label, position),
+            lifted: (label, position) => say(labels.reorderLifted, label, position),
+            moved: (label, position) => say(labels.reorderMoved, label, position),
+        }, className: 'flex flex-col gap-2', getHandleLabel: (label) => PsScanTemplateService.fill(labels.dragPage, { page: label }), instructions: labels.reorderInstructions, items: items, onMove: (_id, from, to) => onMove(from, to), renderItem: ({ handle, index, isDragging, item }) => (_jsxs("div", { className: PallasoftClassNameService.merge('flex items-center gap-2 rounded-ps-control border bg-surface p-1.5', item.id === activeId ? 'border-primary' : 'border-line', isDragging ? 'opacity-80 shadow-lg' : ''), children: [handle, _jsxs("button", { "aria-current": item.id === activeId, "aria-label": item.label, className: 'ps-focus-ring flex min-h-11 min-w-0 flex-1 items-center gap-3 rounded-ps-control text-left', onClick: () => onSelect(item.id), type: 'button', children: [previews[item.id] === undefined ? (_jsx("span", { className: 'ps-skeleton h-14 w-10 shrink-0 rounded' })) : (_jsx("img", { alt: '', className: 'h-14 w-10 shrink-0 rounded border border-line bg-white object-cover object-top', src: previews[item.id] })), _jsx("span", { className: 'truncate text-sm font-medium text-ink', children: item.label })] }), _jsx(PsScanIconButton, { disabled: index === 0, label: PsScanTemplateService.fill(labels.moveUp, { page: item.label }), onClick: () => onMove(index, index - 1), children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5 -rotate-90', iconKey: PsIconKey.ChevronRight }) }), _jsx(PsScanIconButton, { disabled: index === pages.length - 1, label: PsScanTemplateService.fill(labels.moveDown, { page: item.label }), onClick: () => onMove(index, index + 1), children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5 rotate-90', iconKey: PsIconKey.ChevronRight }) })] })), role: 'list' }));
+};

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

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PsButton } from '@pallasoft/ps-core-components';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+import { PsScanFilter } from '../constants/ps-scan-filter';
+import { PsScanIconButton } from './ps-scan-icon-button';
+import { PsScanPageList } from './ps-scan-page-list';
+export const PsScanReview = ({ canAddPage, error, isBusy, labels, onAddPage, onDelete, onEditCrop, onFilter, onFinish, onMove, onRetake, onRotate, onSelect, page, pages, previews, }) => {
+    const filters = [
+        { key: PsScanFilter.Original, label: labels.filterOriginal },
+        { key: PsScanFilter.Colour, label: labels.filterColour },
+        { key: PsScanFilter.Greyscale, label: labels.filterGreyscale },
+        { key: PsScanFilter.Document, label: labels.filterDocument },
+    ];
+    const preview = previews[page.id];
+    return (_jsxs("div", { className: 'flex h-full min-h-0 flex-col lg:flex-row', children: [_jsx("div", { className: 'flex min-h-0 flex-1 items-center justify-center bg-slate-950 p-3', children: preview === undefined ? (_jsx("span", { "aria-hidden": 'true', className: 'ps-skeleton h-full w-2/3 rounded' })) : (_jsx("img", { alt: labels.page, className: 'max-h-full max-w-full object-contain', src: preview })) }), _jsxs("div", { className: 'flex max-h-[55%] min-h-0 shrink-0 flex-col gap-3 overflow-y-auto bg-surface px-4 pt-3 lg:max-h-none lg:w-80 lg:border-l lg:border-line', children: [_jsxs("div", { className: 'flex flex-wrap items-center gap-2', children: [_jsx(PsScanIconButton, { label: labels.rotate, onClick: onRotate, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Rotate }) }), _jsx(PsScanIconButton, { label: labels.editCrop, onClick: onEditCrop, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Pencil }) }), _jsx(PsScanIconButton, { label: labels.retake, onClick: onRetake, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Refresh }) }), _jsx(PsScanIconButton, { label: labels.deletePage, onClick: onDelete, children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-5', iconKey: PsIconKey.Trash }) })] }), _jsx("div", { "aria-label": labels.filters, className: 'flex flex-wrap gap-2', role: 'group', children: filters.map((filter) => (_jsx("button", { "aria-pressed": page.filter === filter.key, className: `ps-focus-ring min-h-11 rounded-ps-control border px-3 text-sm font-medium transition ${page.filter === filter.key ? 'border-primary bg-primary-soft text-primary' : 'border-line bg-surface text-ink hover:border-primary/40'}`, onClick: () => onFilter(filter.key), type: 'button', children: filter.label }, filter.key))) }), _jsxs("section", { "aria-label": labels.pages, className: 'min-h-0', children: [_jsxs("h3", { className: 'mb-2 text-sm font-semibold text-ink', children: [labels.pages, " (", pages.length, ")"] }), _jsx(PsScanPageList, { activeId: page.id, labels: labels, onMove: onMove, onSelect: onSelect, pages: pages, previews: previews })] }), error === '' ? null : (_jsx("p", { className: 'text-sm text-danger', role: 'alert', children: error })), _jsxs("div", { className: 'sticky bottom-0 mt-auto flex flex-wrap gap-3 bg-surface pt-2 pb-[max(0.75rem,env(safe-area-inset-bottom))]', children: [_jsx(PsButton, { className: 'flex-1', disabled: !canAddPage || isBusy, leadingIcon: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Plus }), onClick: onAddPage, variant: 'surface', children: labels.addPage }), _jsx(PsButton, { className: 'flex-1', isLoading: isBusy, loadingLabel: labels.finishing, onClick: onFinish, variant: 'primary', children: labels.finish })] })] })] }));
+};

package/dist/esm/constants/ps-document-scanner-labels.js

@@ -0,0 +1,50 @@
+export const PsDocumentScannerLabels = {
+    addPage: 'Add page',
+    autoDetect: 'Auto-detect edges',
+    cameraDenied: 'Camera access was blocked. Allow it in your browser settings, or take a photo or choose existing photos instead.',
+    cameraStarting: 'Starting camera',
+    cameraUnavailable: 'No camera is available here. Take a photo or choose existing photos instead.',
+    backToPages: 'Back to pages',
+    capture: 'Capture page',
+    choosePhotos: 'Choose photos',
+    close: 'Close scanner',
+    cornerBottomLeft: 'Bottom left corner',
+    cornerBottomRight: 'Bottom right corner',
+    cornerTopLeft: 'Top left corner',
+    cornerTopRight: 'Top right corner',
+    cropApply: 'Use crop',
+    cropHint: 'Drag the corners to fit the page, or use the arrow keys on a focused corner.',
+    cropTitle: 'Adjust edges',
+    deletePage: 'Delete page',
+    dragPage: 'Drag {page} to reorder',
+    editCrop: 'Edit edges',
+    edgesFound: 'Page edges found.',
+    edgesNotFound: 'Edges not found. Adjust the corners.',
+    filterColour: 'Colour',
+    filterDocument: 'Black and white',
+    filterGreyscale: 'Greyscale',
+    filterOriginal: 'Original',
+    filters: 'Enhance',
+    finish: 'Use scan',
+    finishing: 'Preparing your scan',
+    maxPages: 'You reached the page limit.',
+    moveDown: 'Move {page} down',
+    moveUp: 'Move {page} up',
+    page: 'Page',
+    pageAdded: 'Page {position} added.',
+    pageDeleted: 'Page deleted.',
+    pageMoved: '{page} moved to position {position} of {count}.',
+    pages: 'Pages',
+    processFailed: 'The scan could not be prepared. Try again.',
+    reorderCancelled: '{page} stays where it was.',
+    reorderDropped: '{page} dropped at {position} of {count}.',
+    reorderInstructions: 'Press space to lift a page, the arrow keys to move it and space to drop it.',
+    reorderLifted: '{page} lifted from {position} of {count}.',
+    reorderMoved: '{page} is now {position} of {count}.',
+    retake: 'Retake',
+    rotate: 'Rotate',
+    takePhoto: 'Take photo',
+    title: 'Scan document',
+    torchOff: 'Turn light off',
+    torchOn: 'Turn light on',
+};

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

@@ -0,0 +1,6 @@
+export const PsScanCameraStatus = {
+    Denied: 'denied',
+    Ready: 'ready',
+    Starting: 'starting',
+    Unavailable: 'unavailable',
+};

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

@@ -0,0 +1,31 @@
+export const PsScanConfig = {
+    adaptiveRatio: 0.92,
+    adaptiveWindowDivisor: 16,
+    adaptiveWindowMin: 15,
+    capturedJpegQuality: 0.92,
+    cornerNudge: 0.005,
+    cornerNudgeLarge: 0.025,
+    decodeMaxDimension: 3000,
+    defaultFileName: 'scan',
+    defaultJpegQuality: 0.82,
+    defaultMaxDimension: 2000,
+    defaultMaxPages: 30,
+    detectDilations: 2,
+    detectMaxDimension: 320,
+    detectMinAreaRatio: 0.12,
+    detectMaxAreaRatio: 0.995,
+    detectMinEdgeStrength: 24,
+    detectMinHullFill: 0.85,
+    detectPercentile: 0.98,
+    detectRelativeStrength: 0.3,
+    hullCandidateLimit: 18,
+    levelHighPercentile: 0.99,
+    levelLowPercentile: 0.01,
+    minCornerGap: 0.02,
+    pdfDpi: 150,
+    pdfPointsPerInch: 72,
+    previewDebounceMs: 120,
+    previewMaxDimension: 1400,
+    thumbnailHeight: 56,
+    torchConstraint: 'torch',
+};

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

@@ -0,0 +1 @@
+export const PsScanCornerOrder = ['topLeft', 'topRight', 'bottomRight', 'bottomLeft'];

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

@@ -0,0 +1,6 @@
+export const PsScanFilter = {
+    Colour: 'colour',
+    Document: 'document',
+    Greyscale: 'greyscale',
+    Original: 'original',
+};

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

@@ -0,0 +1,4 @@
+export const PsScanOutputFormat = {
+    Jpeg: 'jpeg',
+    Pdf: 'pdf',
+};

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

@@ -0,0 +1,5 @@
+export const PsScanStep = {
+    Camera: 'camera',
+    Crop: 'crop',
+    Review: 'review',
+};

package/dist/esm/hooks/use-ps-focus-trap.js

@@ -0,0 +1,45 @@
+import { useEffect } from 'react';
+export const usePsFocusTrap = (ref, isActive, onEscape) => {
+    useEffect(() => {
+        if (!isActive || ref.current === null)
+            return;
+        const dialog = ref.current.closest('[role="dialog"]');
+        const root = dialog === null ? ref.current : dialog;
+        const focusable = () => Array.from(root.querySelectorAll('button:not([disabled]), [href], input:not([disabled]), [tabindex]:not([tabindex="-1"])')).filter((element) => element.offsetParent !== null || element === document.activeElement);
+        if (!root.contains(document.activeElement)) {
+            root.setAttribute('tabindex', '-1');
+            root.focus({ preventScroll: true });
+        }
+        const onKeyDown = (event) => {
+            if (event.key === 'Escape') {
+                event.stopPropagation();
+                onEscape();
+                return;
+            }
+            if (event.key !== 'Tab')
+                return;
+            const items = focusable();
+            if (items.length === 0) {
+                event.preventDefault();
+                return;
+            }
+            const first = items[0];
+            const last = items[items.length - 1];
+            const current = document.activeElement;
+            if (!root.contains(current)) {
+                event.preventDefault();
+                first.focus();
+            }
+            else if (event.shiftKey && (current === first || current === root)) {
+                event.preventDefault();
+                last.focus();
+            }
+            else if (!event.shiftKey && current === last) {
+                event.preventDefault();
+                first.focus();
+            }
+        };
+        document.addEventListener('keydown', onKeyDown, true);
+        return () => document.removeEventListener('keydown', onKeyDown, true);
+    }, [isActive, onEscape]);
+};