@pallasoft/ps-file-components 1.3.0 → 1.4.0

package/dist/services/ps-scan-output-service.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanOutputService = void 0;
+const ps_scan_output_format_1 = require("../constants/ps-scan-output-format");
+const ps_scan_file_name_service_1 = require("./ps-scan-file-name-service");
+const ps_scan_pdf_service_1 = require("./ps-scan-pdf-service");
+const ps_scan_pipeline_service_1 = require("./ps-scan-pipeline-service");
+class PsScanOutputService {
+    static async build(pages, options) {
+        const rendered = [];
+        for (const page of pages)
+            rendered.push(await ps_scan_pipeline_service_1.PsScanPipelineService.render(page, options.maxDimension, options.jpegQuality));
+        const type = ps_scan_file_name_service_1.PsScanFileNameService.mimeType(options.format);
+        if (options.format === ps_scan_output_format_1.PsScanOutputFormat.Jpeg)
+            return rendered.map((item, index) => new File([item.blob], ps_scan_file_name_service_1.PsScanFileNameService.build(options.fileName, options.format, index, rendered.length), { type }));
+        const jpegs = await Promise.all(rendered.map(async (item) => ({
+            height: item.height,
+            jpeg: new Uint8Array(await item.blob.arrayBuffer()),
+            width: item.width,
+        })));
+        return [
+            new File([ps_scan_pdf_service_1.PsScanPdfService.build(jpegs)], ps_scan_file_name_service_1.PsScanFileNameService.build(options.fileName, options.format, 0, 1), {
+                type,
+            }),
+        ];
+    }
+}
+exports.PsScanOutputService = PsScanOutputService;

package/dist/services/ps-scan-pdf-service.d.ts

@@ -0,0 +1,5 @@
+import type { PsScanPdfPage } from '../models/ps-scan-pdf-page';
+export declare class PsScanPdfService {
+    static build(pages: PsScanPdfPage[]): Uint8Array<ArrayBuffer>;
+    private static points;
+}

package/dist/services/ps-scan-pdf-service.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanPdfService = void 0;
+const ps_scan_config_1 = require("../constants/ps-scan-config");
+class PsScanPdfService {
+    static build(pages) {
+        const encoder = new TextEncoder();
+        const chunks = [];
+        const offsets = [];
+        let length = 0;
+        const push = (chunk) => {
+            chunks.push(chunk);
+            length += chunk.length;
+        };
+        const text = (value) => push(encoder.encode(value));
+        const begin = (id) => {
+            offsets[id] = length;
+            text(`${id} 0 obj\n`);
+        };
+        const kids = pages.map((_, index) => `${3 + index * 3} 0 R`).join(' ');
+        push(Uint8Array.from([
+            0x25, 0x50, 0x44, 0x46, 0x2d, 0x31, 0x2e, 0x34, 0x0a, 0x25, 0xe2, 0xe3, 0xcf, 0xd3, 0x0a,
+        ]));
+        begin(1);
+        text('<< /Type /Catalog /Pages 2 0 R >>\nendobj\n');
+        begin(2);
+        text(`<< /Type /Pages /Kids [${kids}] /Count ${pages.length} >>\nendobj\n`);
+        pages.forEach((page, index) => {
+            const pageId = 3 + index * 3;
+            const widthPt = PsScanPdfService.points(page.width);
+            const heightPt = PsScanPdfService.points(page.height);
+            const content = `q ${widthPt} 0 0 ${heightPt} 0 0 cm /Im0 Do Q`;
+            begin(pageId);
+            text(`<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${widthPt} ${heightPt}] /Resources << /XObject << /Im0 ${pageId + 2} 0 R >> >> /Contents ${pageId + 1} 0 R >>\nendobj\n`);
+            begin(pageId + 1);
+            text(`<< /Length ${content.length} >>\nstream\n${content}\nendstream\nendobj\n`);
+            begin(pageId + 2);
+            text(`<< /Type /XObject /Subtype /Image /Width ${page.width} /Height ${page.height} /ColorSpace /DeviceRGB /BitsPerComponent 8 /Filter /DCTDecode /Length ${page.jpeg.length} >>\nstream\n`);
+            push(page.jpeg);
+            text('\nendstream\nendobj\n');
+        });
+        const count = 3 + pages.length * 3;
+        const xrefAt = length;
+        text(`xref\n0 ${count}\n0000000000 65535 f \n`);
+        for (let id = 1; id < count; id += 1)
+            text(`${String(offsets[id]).padStart(10, '0')} 00000 n \n`);
+        text(`trailer\n<< /Size ${count} /Root 1 0 R >>\nstartxref\n${xrefAt}\n%%EOF\n`);
+        const out = new Uint8Array(length);
+        let at = 0;
+        chunks.forEach((chunk) => {
+            out.set(chunk, at);
+            at += chunk.length;
+        });
+        return out;
+    }
+    static points(pixels) {
+        return Math.round((pixels * ps_scan_config_1.PsScanConfig.pdfPointsPerInch * 100) / ps_scan_config_1.PsScanConfig.pdfDpi) / 100;
+    }
+}
+exports.PsScanPdfService = PsScanPdfService;

package/dist/services/ps-scan-pipeline-service.d.ts

@@ -0,0 +1,10 @@
+import type { PsScanPage } from '../models/ps-scan-page';
+import type { PsScanPrepared } from '../models/ps-scan-prepared';
+import type { PsScanRaster } from '../models/ps-scan-raster';
+import type { PsScanRenderedPage } from '../models/ps-scan-rendered-page';
+export declare class PsScanPipelineService {
+    static prepare(source: Blob): Promise<PsScanPrepared>;
+    static measure(source: Blob): Promise<PsScanRaster>;
+    static process(page: Pick<PsScanPage, 'corners' | 'filter' | 'rotation'>, raster: PsScanRaster, maxDimension: number): PsScanRaster;
+    static render(page: PsScanPage, maxDimension: number, quality: number): Promise<PsScanRenderedPage>;
+}

package/dist/services/ps-scan-pipeline-service.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanPipelineService = void 0;
+const ps_scan_config_1 = require("../constants/ps-scan-config");
+const ps_scan_canvas_service_1 = require("./ps-scan-canvas-service");
+const ps_scan_edge_service_1 = require("./ps-scan-edge-service");
+const ps_scan_enhance_service_1 = require("./ps-scan-enhance-service");
+const ps_scan_geometry_service_1 = require("./ps-scan-geometry-service");
+const ps_scan_raster_service_1 = require("./ps-scan-raster-service");
+const ps_scan_warp_service_1 = require("./ps-scan-warp-service");
+class PsScanPipelineService {
+    static async prepare(source) {
+        const decoded = await ps_scan_canvas_service_1.PsScanCanvasService.decode(source, ps_scan_config_1.PsScanConfig.detectMaxDimension * 2);
+        const detected = ps_scan_edge_service_1.PsScanEdgeService.detect(decoded.raster);
+        return {
+            corners: detected === null ? ps_scan_geometry_service_1.PsScanGeometryService.defaultQuad() : detected,
+            height: decoded.naturalHeight,
+            isDetected: detected !== null,
+            width: decoded.naturalWidth,
+        };
+    }
+    static async measure(source) {
+        const decoded = await ps_scan_canvas_service_1.PsScanCanvasService.decode(source, ps_scan_config_1.PsScanConfig.previewMaxDimension);
+        return decoded.raster;
+    }
+    static process(page, raster, maxDimension) {
+        const size = ps_scan_geometry_service_1.PsScanGeometryService.fitWithin(ps_scan_geometry_service_1.PsScanGeometryService.outputSize(page.corners, raster), maxDimension);
+        const warped = ps_scan_warp_service_1.PsScanWarpService.warp(raster, ps_scan_geometry_service_1.PsScanGeometryService.toPixels(page.corners, {
+            height: raster.height - 1,
+            width: raster.width - 1,
+        }), size.width, size.height);
+        return ps_scan_raster_service_1.PsScanRasterService.rotate(ps_scan_enhance_service_1.PsScanEnhanceService.apply(warped, page.filter), page.rotation);
+    }
+    static async render(page, maxDimension, quality) {
+        const decoded = await ps_scan_canvas_service_1.PsScanCanvasService.decode(page.source, ps_scan_config_1.PsScanConfig.decodeMaxDimension);
+        const raster = PsScanPipelineService.process(page, decoded.raster, maxDimension);
+        return {
+            blob: await ps_scan_canvas_service_1.PsScanCanvasService.encode(raster, quality),
+            height: raster.height,
+            width: raster.width,
+        };
+    }
+}
+exports.PsScanPipelineService = PsScanPipelineService;

package/dist/services/ps-scan-raster-service.d.ts

@@ -0,0 +1,6 @@
+import type { PsScanRaster } from '../models/ps-scan-raster';
+export declare class PsScanRasterService {
+    static create(width: number, height: number): PsScanRaster;
+    static resize(source: PsScanRaster, width: number, height: number): PsScanRaster;
+    static rotate(source: PsScanRaster, degrees: number): PsScanRaster;
+}

package/dist/services/ps-scan-raster-service.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanRasterService = void 0;
+class PsScanRasterService {
+    static create(width, height) {
+        return { data: new Uint8ClampedArray(width * height * 4), height, width };
+    }
+    static resize(source, width, height) {
+        if (width === source.width && height === source.height)
+            return source;
+        const target = PsScanRasterService.create(width, height);
+        const scaleX = source.width / width;
+        const scaleY = source.height / height;
+        for (let y = 0; y < height; y += 1) {
+            const y0 = Math.floor(y * scaleY);
+            const y1 = Math.min(source.height, Math.max(y0 + 1, Math.ceil((y + 1) * scaleY)));
+            for (let x = 0; x < width; x += 1) {
+                const x0 = Math.floor(x * scaleX);
+                const x1 = Math.min(source.width, Math.max(x0 + 1, Math.ceil((x + 1) * scaleX)));
+                let r = 0;
+                let g = 0;
+                let b = 0;
+                let a = 0;
+                let count = 0;
+                for (let sy = y0; sy < y1; sy += 1)
+                    for (let sx = x0; sx < x1; sx += 1) {
+                        const at = (sy * source.width + sx) * 4;
+                        r += source.data[at];
+                        g += source.data[at + 1];
+                        b += source.data[at + 2];
+                        a += source.data[at + 3];
+                        count += 1;
+                    }
+                const out = (y * width + x) * 4;
+                target.data[out] = r / count;
+                target.data[out + 1] = g / count;
+                target.data[out + 2] = b / count;
+                target.data[out + 3] = a / count;
+            }
+        }
+        return target;
+    }
+    static rotate(source, degrees) {
+        const turns = ((Math.round(degrees / 90) % 4) + 4) % 4;
+        if (turns === 0)
+            return source;
+        const swapped = turns % 2 === 1;
+        const width = swapped ? source.height : source.width;
+        const height = swapped ? source.width : source.height;
+        const target = PsScanRasterService.create(width, height);
+        for (let y = 0; y < source.height; y += 1)
+            for (let x = 0; x < source.width; x += 1) {
+                let tx = x;
+                let ty = y;
+                if (turns === 1)
+                    [tx, ty] = [source.height - 1 - y, x];
+                else if (turns === 2)
+                    [tx, ty] = [source.width - 1 - x, source.height - 1 - y];
+                else
+                    [tx, ty] = [y, source.width - 1 - x];
+                const from = (y * source.width + x) * 4;
+                const to = (ty * width + tx) * 4;
+                target.data[to] = source.data[from];
+                target.data[to + 1] = source.data[from + 1];
+                target.data[to + 2] = source.data[from + 2];
+                target.data[to + 3] = source.data[from + 3];
+            }
+        return target;
+    }
+}
+exports.PsScanRasterService = PsScanRasterService;

package/dist/services/ps-scan-template-service.d.ts

@@ -0,0 +1,3 @@
+export declare class PsScanTemplateService {
+    static fill(template: string, values: Record<string, string | number>): string;
+}

package/dist/services/ps-scan-template-service.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanTemplateService = void 0;
+class PsScanTemplateService {
+    static fill(template, values) {
+        return template.replace(/\{(\w+)\}/g, (match, key) => key in values ? String(values[key]) : match);
+    }
+}
+exports.PsScanTemplateService = PsScanTemplateService;

package/dist/services/ps-scan-warp-service.d.ts

@@ -0,0 +1,6 @@
+import type { PsScanQuad } from '../models/ps-scan-quad';
+import type { PsScanRaster } from '../models/ps-scan-raster';
+export declare class PsScanWarpService {
+    static warp(source: PsScanRaster, pixelQuad: PsScanQuad, width: number, height: number): PsScanRaster;
+    private static sample;
+}

package/dist/services/ps-scan-warp-service.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsScanWarpService = void 0;
+const ps_scan_homography_service_1 = require("./ps-scan-homography-service");
+const ps_scan_raster_service_1 = require("./ps-scan-raster-service");
+class PsScanWarpService {
+    static warp(source, pixelQuad, width, height) {
+        const matrix = ps_scan_homography_service_1.PsScanHomographyService.fromUnitSquare(pixelQuad);
+        const target = ps_scan_raster_service_1.PsScanRasterService.create(width, height);
+        const spanX = Math.max(1, width - 1);
+        const spanY = Math.max(1, height - 1);
+        for (let y = 0; y < height; y += 1)
+            for (let x = 0; x < width; x += 1) {
+                const point = ps_scan_homography_service_1.PsScanHomographyService.apply(matrix, x / spanX, y / spanY);
+                PsScanWarpService.sample(source, point.x, point.y, target.data, (y * width + x) * 4);
+            }
+        return target;
+    }
+    static sample(source, x, y, out, at) {
+        const cx = Math.min(source.width - 1, Math.max(0, x));
+        const cy = Math.min(source.height - 1, Math.max(0, y));
+        const x0 = Math.floor(cx);
+        const y0 = Math.floor(cy);
+        const x1 = Math.min(source.width - 1, x0 + 1);
+        const y1 = Math.min(source.height - 1, y0 + 1);
+        const fx = cx - x0;
+        const fy = cy - y0;
+        const a = (y0 * source.width + x0) * 4;
+        const b = (y0 * source.width + x1) * 4;
+        const c = (y1 * source.width + x0) * 4;
+        const d = (y1 * source.width + x1) * 4;
+        for (let channel = 0; channel < 4; channel += 1) {
+            const top = source.data[a + channel] * (1 - fx) + source.data[b + channel] * fx;
+            const bottom = source.data[c + channel] * (1 - fx) + source.data[d + channel] * fx;
+            out[at + channel] = top * (1 - fy) + bottom * fy;
+        }
+    }
+}
+exports.PsScanWarpService = PsScanWarpService;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pallasoft/ps-file-components",
-	"version": "1.3.0",
+	"version": "1.4.0",
 	"private": false,
 	"main": "./dist/index.js",
 	"module": "./dist/esm/index.js",
@@ -32,10 +32,10 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@pallasoft/ps-core-components": "^2.13.0",
-		"@pallasoft/ps-icons": "^1.6.0",
-		"@pallasoft/ps-popovers": "^1.5.2",
-		"@pallasoft/ps-utilities": "^2.9.0",
+		"@pallasoft/ps-core-components": "^2.27.0",
+		"@pallasoft/ps-icons": "^1.8.1",
+		"@pallasoft/ps-popovers": "^1.10.2",
+		"@pallasoft/ps-utilities": "^2.19.1",
 		"pdfjs-dist": "^6.3.289"
 	},
 	"peerDependencies": {
@@ -47,13 +47,15 @@
 		"@commitlint/config-conventional": "^20.0.0",
 		"@eslint/compat": "^2.0.0",
 		"@ianvs/prettier-plugin-sort-imports": "^4.7.0",
-		"@pallasoft/ps-design-system": "^1.14.0",
+		"@pallasoft/ps-design-system": "^1.15.0",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/commit-analyzer": "^13.0.0",
 		"@semantic-release/git": "^10.0.1",
 		"@semantic-release/github": "^11.0.1",
 		"@semantic-release/npm": "^12.0.0",
 		"@semantic-release/release-notes-generator": "^14.0.1",
+		"@testing-library/dom": "^10.4.2",
+		"@testing-library/react": "^16.3.3",
 		"@types/react": "^18.3.28",
 		"@types/react-dom": "^18.3.7",
 		"@typescript-eslint/eslint-plugin": "^8.48.0",
@@ -65,6 +67,7 @@
 		"eslint-plugin-import": "^2.32.0",
 		"eslint-plugin-prettier": "^5.5.4",
 		"husky": "^9.1.7",
+		"jsdom": "^30.1.2",
 		"lint-staged": "^16.2.7",
 		"prettier": "^3.6.2",
 		"react": "^19.3.0",