@servicetitan/dte-pdf-editor 1.49.0 → 1.51.0

package/src/utils/pdf/__tests__/unit-conversion.utils.test.ts

@@ -0,0 +1,35 @@
+import {
+    EDITOR_PAGE_WIDTH_PX,
+    PDF_PAGE_WIDTH_PT,
+    PIXELS_TO_POINTS_RATIO,
+    pixelsToPoints,
+    pointsToPixels,
+} from '../unit-conversion.utils';
+
+describe('unit-conversion.utils', () => {
+    describe('with PIXELS_TO_POINTS_RATIO', () => {
+        test('matches backend page width conversion', () => {
+            expect(PIXELS_TO_POINTS_RATIO).toBe(PDF_PAGE_WIDTH_PT / EDITOR_PAGE_WIDTH_PX);
+        });
+    });
+
+    describe('with pointsToPixels', () => {
+        const subject = (points: number) => pointsToPixels(points);
+
+        test.each([
+            [612, 980],
+            [14, (14 * EDITOR_PAGE_WIDTH_PX) / PDF_PAGE_WIDTH_PT],
+        ])('converts %p points to %p pixels', (points, expectedPixels) => {
+            expect(subject(points)).toBeCloseTo(expectedPixels);
+        });
+    });
+
+    describe('with pixelsToPoints', () => {
+        const subject = (pixels: number) => pixelsToPoints(pixels);
+
+        test('is the inverse of pointsToPixels', () => {
+            const points = 14;
+            expect(subject(pointsToPixels(points))).toBe(points);
+        });
+    });
+});

package/src/utils/pdf/index.ts

@@ -1 +1,2 @@
 export * from './pdf-rendering.utils';
+export * from './unit-conversion.utils';

package/src/utils/pdf/unit-conversion.utils.ts

@@ -0,0 +1,31 @@
+import { BASE_PAGE_WIDTH } from '../../constants';
+
+/** Page width the FE editor uses to lay out an 8.5" page, in pixels. */
+export const EDITOR_PAGE_WIDTH_PX = BASE_PAGE_WIDTH;
+
+/** Page width PdfSharp uses for an 8.5" page at 72 DPI, in points. */
+export const PDF_PAGE_WIDTH_PT = 612;
+
+/**
+ * Backend `DpiToPointsRatio`: pixels -> points (612 / 980 ≈ 0.6245).
+ * Kept here so any drift from the backend constant is a single-line change.
+ */
+export const PIXELS_TO_POINTS_RATIO = PDF_PAGE_WIDTH_PT / EDITOR_PAGE_WIDTH_PX;
+
+/**
+ * Converts a point value (as used by the backend PDF renderer) to editor pixels.
+ *
+ * Use this for a BYOD field `fontSize` so the editor renders text at the same
+ * physical size the backend draws it in the PDF.
+ */
+export const pointsToPixels = (points: number) => {
+    return points / PIXELS_TO_POINTS_RATIO;
+};
+
+/**
+ * Converts an editor pixels value to points. Inverse of {@link pointsToPixels};
+ * mirrors the backend `ToPoints` conversion.
+ */
+export const pixelsToPoints = (pixels: number) => {
+    return pixels * PIXELS_TO_POINTS_RATIO;
+};

package/src/utils/shared/index.ts

@@ -1,3 +1,4 @@
 export * from './date.utils';
 export * from './number.utils';
+export * from './sample-data.utils';
 export * from './schema.utils';

package/src/utils/shared/sample-data.utils.ts

@@ -0,0 +1,29 @@
+import { PdfFieldSubType } from '../../interface/types';
+
+const DEFAULT_NUMBER_SAMPLE = 350;
+
+const toPrimitiveSample = (value: unknown): string | number | undefined => {
+    if (typeof value === 'string' || typeof value === 'number') {
+        return value;
+    }
+    return undefined;
+};
+
+export const getFieldSampleData = (
+    sampleData: unknown,
+    fieldSubType?: PdfFieldSubType,
+): string | number | null => {
+    const primitiveSample = toPrimitiveSample(sampleData);
+
+    if (fieldSubType === 'date') {
+        const candidate = primitiveSample !== undefined ? new Date(primitiveSample) : new Date();
+        const source = Number.isNaN(candidate.getTime()) ? new Date() : candidate;
+        return source.toISOString().slice(0, 10);
+    }
+
+    if (fieldSubType === 'number') {
+        return primitiveSample ?? DEFAULT_NUMBER_SAMPLE;
+    }
+
+    return primitiveSample ?? null;
+};