@pallasoft/ps-file-components 1.3.0 → 1.4.0

package/dist/esm/hooks/use-ps-scan-camera.js

@@ -0,0 +1,62 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { PsScanCameraStatus } from '../constants/ps-scan-camera-status';
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanCameraService } from '../services/ps-scan-camera-service';
+import { PsScanCanvasService } from '../services/ps-scan-canvas-service';
+export const usePsScanCamera = (isActive) => {
+    const videoRef = useRef(null);
+    const sessionRef = useRef(null);
+    const [status, setStatus] = useState(PsScanCameraStatus.Starting);
+    const [canTorch, setCanTorch] = useState(false);
+    const [isTorchOn, setIsTorchOn] = useState(false);
+    useEffect(() => {
+        if (!isActive)
+            return;
+        let isCancelled = false;
+        setIsTorchOn(false);
+        if (!PsScanCameraService.isSupported()) {
+            setStatus(PsScanCameraStatus.Unavailable);
+            return;
+        }
+        setStatus(PsScanCameraStatus.Starting);
+        PsScanCameraService.open()
+            .then(async (session) => {
+            if (isCancelled) {
+                PsScanCameraService.stop(session.stream);
+                return;
+            }
+            sessionRef.current = session;
+            setCanTorch(session.canTorch);
+            const video = videoRef.current;
+            if (video !== null) {
+                video.srcObject = session.stream;
+                await video.play().catch(() => undefined);
+            }
+            setStatus(PsScanCameraStatus.Ready);
+        })
+            .catch((error) => {
+            if (!isCancelled)
+                setStatus(PsScanCameraService.classify(error));
+        });
+        return () => {
+            isCancelled = true;
+            PsScanCameraService.stop(sessionRef.current === null ? null : sessionRef.current.stream);
+            sessionRef.current = null;
+            if (videoRef.current !== null)
+                videoRef.current.srcObject = null;
+        };
+    }, [isActive]);
+    const toggleTorch = useCallback(async () => {
+        const session = sessionRef.current;
+        if (session === null)
+            return;
+        setIsTorchOn(await PsScanCameraService.setTorch(session.track, !isTorchOn));
+    }, [isTorchOn]);
+    const capture = useCallback(async () => {
+        const video = videoRef.current;
+        if (video === null || video.videoWidth === 0)
+            return null;
+        return await PsScanCanvasService.fromVideo(video, PsScanConfig.capturedJpegQuality);
+    }, []);
+    return { canTorch, capture, isTorchOn, status, toggleTorch, videoRef };
+};

package/dist/esm/hooks/use-ps-scan-pages.js

@@ -0,0 +1,62 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { PsScanFilter } from '../constants/ps-scan-filter';
+import { PsScanOrderService } from '../services/ps-scan-order-service';
+import { PsScanPipelineService } from '../services/ps-scan-pipeline-service';
+export const usePsScanPages = () => {
+    const [pages, setPages] = useState([]);
+    const urls = useRef(new Set());
+    const counter = useRef(0);
+    useEffect(() => () => {
+        urls.current.forEach((url) => URL.revokeObjectURL(url));
+        urls.current.clear();
+    }, []);
+    const build = useCallback(async (source) => {
+        const prepared = await PsScanPipelineService.prepare(source);
+        const sourceUrl = URL.createObjectURL(source);
+        counter.current += 1;
+        urls.current.add(sourceUrl);
+        return {
+            isDetected: prepared.isDetected,
+            page: {
+                corners: prepared.corners,
+                filter: PsScanFilter.Document,
+                height: prepared.height,
+                id: `scan-page-${counter.current}`,
+                rotation: 0,
+                source,
+                sourceUrl,
+                width: prepared.width,
+            },
+        };
+    }, []);
+    const add = useCallback(async (sources) => {
+        const built = [];
+        for (const source of sources)
+            built.push(await build(source));
+        setPages((current) => [...current, ...built.map((item) => item.page)]);
+        return built;
+    }, [build]);
+    const replace = useCallback(async (id, source) => {
+        const built = await build(source);
+        setPages((current) => current.map((page) => {
+            if (page.id !== id)
+                return page;
+            URL.revokeObjectURL(page.sourceUrl);
+            urls.current.delete(page.sourceUrl);
+            return { ...built.page, filter: page.filter, id: page.id };
+        }));
+        return built;
+    }, [build]);
+    const update = useCallback((id, patch) => setPages((current) => current.map((page) => (page.id === id ? { ...page, ...patch } : page))), []);
+    const setCorners = useCallback((id, corners) => update(id, { corners }), [update]);
+    const remove = useCallback((id) => setPages((current) => {
+        const target = current.find((page) => page.id === id);
+        if (target !== undefined) {
+            URL.revokeObjectURL(target.sourceUrl);
+            urls.current.delete(target.sourceUrl);
+        }
+        return current.filter((page) => page.id !== id);
+    }), []);
+    const move = useCallback((from, to) => setPages((current) => PsScanOrderService.move(current, from, to)), []);
+    return { add, move, pages, remove, replace, setCorners, update };
+};

package/dist/esm/hooks/use-ps-scan-previews.js

@@ -0,0 +1,57 @@
+import { useEffect, useRef, useState } from 'react';
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanCanvasService } from '../services/ps-scan-canvas-service';
+import { PsScanPipelineService } from '../services/ps-scan-pipeline-service';
+export const usePsScanPreviews = (pages) => {
+    const rasters = useRef(new Map());
+    const urls = useRef(new Map());
+    const [previews, setPreviews] = useState({});
+    const signature = pages
+        .map((page) => `${page.id}:${page.filter}:${page.rotation}:${page.corners.map((point) => `${point.x.toFixed(4)},${point.y.toFixed(4)}`).join(';')}`)
+        .join('|');
+    useEffect(() => {
+        let isCancelled = false;
+        const timer = setTimeout(async () => {
+            const stale = [];
+            for (const page of pages) {
+                if (isCancelled)
+                    return;
+                let raster = rasters.current.get(page.id);
+                if (raster === undefined) {
+                    raster = await PsScanPipelineService.measure(page.source);
+                    rasters.current.set(page.id, raster);
+                }
+                const processed = PsScanPipelineService.process(page, raster, PsScanConfig.previewMaxDimension);
+                const blob = await PsScanCanvasService.encode(processed, PsScanConfig.defaultJpegQuality);
+                if (isCancelled)
+                    return;
+                const previous = urls.current.get(page.id);
+                if (previous !== undefined)
+                    stale.push(previous);
+                urls.current.set(page.id, URL.createObjectURL(blob));
+            }
+            if (isCancelled)
+                return;
+            const ids = new Set(pages.map((page) => page.id));
+            urls.current.forEach((url, id) => {
+                if (ids.has(id))
+                    return;
+                stale.push(url);
+                urls.current.delete(id);
+                rasters.current.delete(id);
+            });
+            setPreviews(Object.fromEntries(urls.current));
+            setTimeout(() => stale.forEach((url) => URL.revokeObjectURL(url)), 1000);
+        }, PsScanConfig.previewDebounceMs);
+        return () => {
+            isCancelled = true;
+            clearTimeout(timer);
+        };
+    }, [signature]);
+    useEffect(() => () => {
+        urls.current.forEach((url) => URL.revokeObjectURL(url));
+        urls.current.clear();
+        rasters.current.clear();
+    }, []);
+    return previews;
+};

package/dist/esm/index.js

@@ -5,6 +5,7 @@ export * from './components/ps-file-list';
 export * from './components/ps-file-picker';
 export * from './components/ps-file-viewer-button';
 export * from './components/ps-file-viewer-content';
+export * from './components/ps-file-viewer-pane';
 export * from './components/ps-file-viewer';
 export * from './components/ps-highlighted-text';
 export * from './components/ps-image-viewer';
@@ -39,6 +40,7 @@ export * from './models/ps-file-selection';
 export * from './models/ps-file-text-state';
 export * from './models/ps-file-viewer-button-tone';
 export * from './models/ps-file-viewer-content-props';
+export * from './models/ps-file-viewer-pane-props';
 export * from './models/ps-label-set';
 export * from './models/ps-page-size';
 export * from './models/ps-pdf-match';
@@ -67,3 +69,8 @@ export * from './hooks/use-ps-active-match-scroll';
 export * from './hooks/use-ps-file-text';
 export * from './hooks/use-ps-in-view';
 export * from './hooks/use-ps-upload-queue';
+export * from './components/ps-document-scanner';
+export * from './constants/ps-document-scanner-labels';
+export * from './constants/ps-scan-filter';
+export * from './constants/ps-scan-output-format';
+export * from './models/ps-document-scanner-props';

package/dist/esm/models/ps-document-scanner-props.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-document-scanner-sheet-props.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-file-viewer-pane-props.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-added-page.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-camera-session.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-decoded-image.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-levels.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-output-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-page.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-pdf-page.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-prepared.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-quad.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-raster.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-scan-rendered-page.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/services/ps-scan-camera-service.js

@@ -0,0 +1,50 @@
+import { PsScanCameraStatus } from '../constants/ps-scan-camera-status';
+import { PsScanConfig } from '../constants/ps-scan-config';
+export class PsScanCameraService {
+    static classify(error) {
+        const name = typeof error === 'object' && error !== null && 'name' in error ? String(error.name) : '';
+        return name === 'NotAllowedError' ||
+            name === 'SecurityError' ||
+            name === 'PermissionDeniedError'
+            ? PsScanCameraStatus.Denied
+            : PsScanCameraStatus.Unavailable;
+    }
+    static isSupported() {
+        return (typeof navigator !== 'undefined' &&
+            typeof navigator.mediaDevices !== 'undefined' &&
+            typeof navigator.mediaDevices.getUserMedia === 'function');
+    }
+    static async open() {
+        const stream = await navigator.mediaDevices.getUserMedia({
+            audio: false,
+            video: {
+                facingMode: { ideal: 'environment' },
+                height: { ideal: 1440 },
+                width: { ideal: 1920 },
+            },
+        });
+        const track = stream.getVideoTracks()[0];
+        return { canTorch: PsScanCameraService.supportsTorch(track), stream, track };
+    }
+    static async setTorch(track, isOn) {
+        try {
+            await track.applyConstraints({
+                advanced: [{ [PsScanConfig.torchConstraint]: isOn }],
+            });
+            return isOn;
+        }
+        catch {
+            return false;
+        }
+    }
+    static stop(stream) {
+        if (stream === null)
+            return;
+        stream.getTracks().forEach((track) => track.stop());
+    }
+    static supportsTorch(track) {
+        if (track === undefined || typeof track.getCapabilities !== 'function')
+            return false;
+        return PsScanConfig.torchConstraint in track.getCapabilities();
+    }
+}

package/dist/esm/services/ps-scan-canvas-service.js

@@ -0,0 +1,46 @@
+import { PsScanGeometryService } from './ps-scan-geometry-service';
+export class PsScanCanvasService {
+    static async decode(blob, maxDimension) {
+        const bitmap = await createImageBitmap(blob, { imageOrientation: 'from-image' });
+        const size = PsScanGeometryService.fitWithin({ height: bitmap.height, width: bitmap.width }, maxDimension);
+        const context = PsScanCanvasService.context(size.width, size.height);
+        context.drawImage(bitmap, 0, 0, size.width, size.height);
+        const naturalHeight = bitmap.height;
+        const naturalWidth = bitmap.width;
+        bitmap.close();
+        return {
+            naturalHeight,
+            naturalWidth,
+            raster: context.getImageData(0, 0, size.width, size.height),
+        };
+    }
+    static async encode(raster, quality) {
+        const context = PsScanCanvasService.context(raster.width, raster.height);
+        context.putImageData(new ImageData(raster.data, raster.width, raster.height), 0, 0);
+        const canvas = context.canvas;
+        if (canvas instanceof HTMLCanvasElement)
+            return await new Promise((resolve, reject) => canvas.toBlob((blob) => (blob === null ? reject(new Error('encode')) : resolve(blob)), 'image/jpeg', quality));
+        return await canvas.convertToBlob({ quality, type: 'image/jpeg' });
+    }
+    static async fromVideo(video, quality) {
+        const context = PsScanCanvasService.context(video.videoWidth, video.videoHeight);
+        context.drawImage(video, 0, 0);
+        return await PsScanCanvasService.encode(context.getImageData(0, 0, video.videoWidth, video.videoHeight), quality);
+    }
+    static context(width, height) {
+        if (typeof OffscreenCanvas !== 'undefined') {
+            const context = new OffscreenCanvas(width, height).getContext('2d', {
+                willReadFrequently: true,
+            });
+            if (context !== null)
+                return context;
+        }
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const context = canvas.getContext('2d', { willReadFrequently: true });
+        if (context === null)
+            throw new Error('canvas');
+        return context;
+    }
+}

package/dist/esm/services/ps-scan-edge-service.js

@@ -0,0 +1,156 @@
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanGeometryService } from './ps-scan-geometry-service';
+import { PsScanHullService } from './ps-scan-hull-service';
+import { PsScanImageFilterService } from './ps-scan-image-filter-service';
+import { PsScanRasterService } from './ps-scan-raster-service';
+export class PsScanEdgeService {
+    static detect(source) {
+        const scale = Math.min(1, PsScanConfig.detectMaxDimension / Math.max(source.width, source.height));
+        const width = Math.max(8, Math.round(source.width * scale));
+        const height = Math.max(8, Math.round(source.height * scale));
+        const raster = PsScanRasterService.resize(source, width, height);
+        const gray = PsScanImageFilterService.blur(PsScanImageFilterService.grayscale(raster), width, height);
+        const edges = PsScanImageFilterService.sobel(gray, width, height);
+        let mask = PsScanEdgeService.threshold(edges);
+        for (let step = 0; step < PsScanConfig.detectDilations; step += 1)
+            mask = PsScanEdgeService.dilate(mask, width, height);
+        const foreground = PsScanEdgeService.foreground(mask, width, height);
+        const component = PsScanEdgeService.largestComponent(foreground, width, height);
+        if (component.length < 8)
+            return null;
+        const hull = PsScanHullService.convexHull(component);
+        if (hull.length < 4)
+            return null;
+        const quad = PsScanGeometryService.order(PsScanHullService.bestQuad(hull));
+        const imageArea = width * height;
+        const quadArea = PsScanGeometryService.area(quad);
+        const hullArea = PsScanGeometryService.area(hull);
+        if (quadArea / imageArea < PsScanConfig.detectMinAreaRatio)
+            return null;
+        if (quadArea / imageArea > PsScanConfig.detectMaxAreaRatio)
+            return null;
+        if (hullArea > 0 && quadArea / hullArea < PsScanConfig.detectMinHullFill)
+            return null;
+        if (!PsScanGeometryService.isConvex(quad))
+            return null;
+        return quad.map((point) => ({
+            x: Math.min(1, Math.max(0, point.x / (width - 1))),
+            y: Math.min(1, Math.max(0, point.y / (height - 1))),
+        }));
+    }
+    static dilate(mask, width, height) {
+        const out = new Uint8Array(mask.length);
+        for (let y = 0; y < height; y += 1)
+            for (let x = 0; x < width; x += 1) {
+                if (mask[y * width + x] === 0)
+                    continue;
+                for (let dy = -1; dy <= 1; dy += 1)
+                    for (let dx = -1; dx <= 1; dx += 1) {
+                        const nx = x + dx;
+                        const ny = y + dy;
+                        if (nx >= 0 && ny >= 0 && nx < width && ny < height)
+                            out[ny * width + nx] = 1;
+                    }
+            }
+        return out;
+    }
+    static foreground(mask, width, height) {
+        const background = new Uint8Array(mask.length);
+        const stack = [];
+        const seed = (index) => {
+            if (mask[index] === 0 && background[index] === 0) {
+                background[index] = 1;
+                stack.push(index);
+            }
+        };
+        for (let x = 0; x < width; x += 1) {
+            seed(x);
+            seed((height - 1) * width + x);
+        }
+        for (let y = 0; y < height; y += 1) {
+            seed(y * width);
+            seed(y * width + width - 1);
+        }
+        while (stack.length > 0) {
+            const index = stack.pop();
+            if (index === undefined)
+                break;
+            const x = index % width;
+            const y = (index - x) / width;
+            if (x > 0)
+                seed(index - 1);
+            if (x < width - 1)
+                seed(index + 1);
+            if (y > 0)
+                seed(index - width);
+            if (y < height - 1)
+                seed(index + width);
+        }
+        return background.map((value) => 1 - value);
+    }
+    static largestComponent(mask, width, height) {
+        const seen = new Uint8Array(mask.length);
+        let best = [];
+        let bestSize = 0;
+        for (let start = 0; start < mask.length; start += 1) {
+            if (mask[start] === 0 || seen[start] === 1)
+                continue;
+            const members = [];
+            const stack = [start];
+            let size = 0;
+            seen[start] = 1;
+            while (stack.length > 0) {
+                const index = stack.pop();
+                if (index === undefined)
+                    break;
+                const x = index % width;
+                const y = (index - x) / width;
+                let isBoundary = false;
+                size += 1;
+                for (let dy = -1; dy <= 1; dy += 1)
+                    for (let dx = -1; dx <= 1; dx += 1) {
+                        if (dx === 0 && dy === 0)
+                            continue;
+                        const nx = x + dx;
+                        const ny = y + dy;
+                        if (nx < 0 || ny < 0 || nx >= width || ny >= height) {
+                            isBoundary = true;
+                            continue;
+                        }
+                        const next = ny * width + nx;
+                        if (mask[next] === 0)
+                            isBoundary = true;
+                        else if (seen[next] === 0) {
+                            seen[next] = 1;
+                            stack.push(next);
+                        }
+                    }
+                if (isBoundary)
+                    members.push({ x, y });
+            }
+            if (size > bestSize) {
+                bestSize = size;
+                best = members;
+            }
+        }
+        return best;
+    }
+    static threshold(edges) {
+        const bins = new Uint32Array(512);
+        edges.forEach((value) => {
+            bins[Math.min(511, value)] += 1;
+        });
+        const target = edges.length * PsScanConfig.detectPercentile;
+        let cumulative = 0;
+        let high = 0;
+        for (let bin = 0; bin < bins.length; bin += 1) {
+            cumulative += bins[bin];
+            if (cumulative >= target) {
+                high = bin;
+                break;
+            }
+        }
+        const limit = Math.max(PsScanConfig.detectMinEdgeStrength, high * PsScanConfig.detectRelativeStrength);
+        return Uint8Array.from(edges, (value) => (value >= limit ? 1 : 0));
+    }
+}

package/dist/esm/services/ps-scan-enhance-service.js

@@ -0,0 +1,97 @@
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanFilter } from '../constants/ps-scan-filter';
+import { PsScanImageFilterService } from './ps-scan-image-filter-service';
+import { PsScanRasterService } from './ps-scan-raster-service';
+export class PsScanEnhanceService {
+    static apply(source, filter) {
+        if (filter === PsScanFilter.Original)
+            return source;
+        if (filter === PsScanFilter.Colour)
+            return PsScanEnhanceService.colour(source);
+        if (filter === PsScanFilter.Greyscale)
+            return PsScanEnhanceService.greyscale(source);
+        return PsScanEnhanceService.document(source);
+    }
+    static colour(source) {
+        const gray = PsScanImageFilterService.grayscale(source);
+        const { black, white } = PsScanEnhanceService.levels(gray);
+        const gain = 255 / Math.max(1, white - black);
+        const target = PsScanRasterService.create(source.width, source.height);
+        for (let at = 0; at < source.data.length; at += 4) {
+            target.data[at] = (source.data[at] - black) * gain;
+            target.data[at + 1] = (source.data[at + 1] - black) * gain;
+            target.data[at + 2] = (source.data[at + 2] - black) * gain;
+            target.data[at + 3] = 255;
+        }
+        return target;
+    }
+    static document(source) {
+        const { height, width } = source;
+        const gray = PsScanImageFilterService.grayscale(source);
+        const integral = new Float64Array((width + 1) * (height + 1));
+        for (let y = 0; y < height; y += 1) {
+            let row = 0;
+            for (let x = 0; x < width; x += 1) {
+                row += gray[y * width + x];
+                integral[(y + 1) * (width + 1) + x + 1] = integral[y * (width + 1) + x + 1] + row;
+            }
+        }
+        const half = Math.max(PsScanConfig.adaptiveWindowMin, Math.floor(Math.min(width, height) / PsScanConfig.adaptiveWindowDivisor)) >> 1;
+        const target = PsScanRasterService.create(width, height);
+        for (let y = 0; y < height; y += 1) {
+            const y0 = Math.max(0, y - half);
+            const y1 = Math.min(height, y + half + 1);
+            for (let x = 0; x < width; x += 1) {
+                const x0 = Math.max(0, x - half);
+                const x1 = Math.min(width, x + half + 1);
+                const sum = integral[y1 * (width + 1) + x1] -
+                    integral[y0 * (width + 1) + x1] -
+                    integral[y1 * (width + 1) + x0] +
+                    integral[y0 * (width + 1) + x0];
+                const mean = sum / ((x1 - x0) * (y1 - y0));
+                const value = gray[y * width + x] < mean * PsScanConfig.adaptiveRatio ? 0 : 255;
+                const at = (y * width + x) * 4;
+                target.data[at] = value;
+                target.data[at + 1] = value;
+                target.data[at + 2] = value;
+                target.data[at + 3] = 255;
+            }
+        }
+        return target;
+    }
+    static greyscale(source) {
+        const gray = PsScanImageFilterService.grayscale(source);
+        const { black, white } = PsScanEnhanceService.levels(gray);
+        const gain = 255 / Math.max(1, white - black);
+        const target = PsScanRasterService.create(source.width, source.height);
+        for (let index = 0; index < gray.length; index += 1) {
+            const value = (gray[index] - black) * gain;
+            const at = index * 4;
+            target.data[at] = value;
+            target.data[at + 1] = value;
+            target.data[at + 2] = value;
+            target.data[at + 3] = 255;
+        }
+        return target;
+    }
+    static levels(gray) {
+        const bins = new Uint32Array(256);
+        gray.forEach((value) => {
+            bins[value] += 1;
+        });
+        const find = (fraction) => {
+            const target = gray.length * fraction;
+            let cumulative = 0;
+            for (let bin = 0; bin < 256; bin += 1) {
+                cumulative += bins[bin];
+                if (cumulative >= target)
+                    return bin;
+            }
+            return 255;
+        };
+        return {
+            black: find(PsScanConfig.levelLowPercentile),
+            white: find(PsScanConfig.levelHighPercentile),
+        };
+    }
+}

package/dist/esm/services/ps-scan-file-name-service.js

@@ -0,0 +1,25 @@
+import { PsScanConfig } from '../constants/ps-scan-config';
+import { PsScanOutputFormat } from '../constants/ps-scan-output-format';
+export class PsScanFileNameService {
+    static build(base, format, index, count) {
+        const stem = PsScanFileNameService.sanitize(base);
+        if (format === PsScanOutputFormat.Pdf)
+            return `${stem}.pdf`;
+        if (count <= 1)
+            return `${stem}.jpg`;
+        return `${stem}-${String(index + 1).padStart(String(count).length, '0')}.jpg`;
+    }
+    static mimeType(format) {
+        return format === PsScanOutputFormat.Pdf ? 'application/pdf' : 'image/jpeg';
+    }
+    static sanitize(base) {
+        const cleaned = Array.from(base)
+            .filter((char) => char.charCodeAt(0) >= 32)
+            .join('')
+            .replace(/\.(pdf|jpe?g)$/i, '')
+            .replace(/[\\/:*?"<>|]+/g, '-')
+            .replace(/\s+/g, ' ')
+            .replace(/^[\s.-]+|[\s.-]+$/g, '');
+        return cleaned.length === 0 ? PsScanConfig.defaultFileName : cleaned.slice(0, 80);
+    }
+}