@reekon-tools/boldr-utils 1.22.0 → 1.24.0

package/dist/export/pdf/tiles.js

@@ -133,15 +133,15 @@ const valueRowOps = (ctx, value, cx, cy, color, availableWidth, tileWidth) => {
     tokens.forEach((t, i) => {
         const w = widths[i];
         if (!t.fraction) {
-            ops.push(...ctx.fonts.textOps(ctx.page, t.text, fs, color, x, baseline));
+            ops.push(...ctx.fonts.textOps(ctx.scope, t.text, fs, color, x, baseline));
         }
         else {
             const stackW = Math.max(ctx.fonts.width(t.fraction.num, fracFs), ctx.fonts.width(t.fraction.den, fracFs));
             const scx = x + stackW / 2;
             // Numerator above the rule, denominator below; rule at the row centre.
-            ops.push(...ctx.fonts.textOps(ctx.page, t.fraction.num, fracFs, color, scx, cy - fracFs * 0.15, { align: 'center' }), pushGraphicsState(), ...fillStateOps(color), rectangle(x, cy - fracFs * 0.05, stackW, Math.max(fracFs * 0.08, 0.8)), fill(), popGraphicsState(), ...ctx.fonts.textOps(ctx.page, t.fraction.den, fracFs, color, scx, cy + fracFs * 0.85, { align: 'center' }));
+            ops.push(...ctx.fonts.textOps(ctx.scope, t.fraction.num, fracFs, color, scx, cy - fracFs * 0.15, { align: 'center' }), pushGraphicsState(), ...fillStateOps(color), rectangle(x, cy - fracFs * 0.05, stackW, Math.max(fracFs * 0.08, 0.8)), fill(), popGraphicsState(), ...ctx.fonts.textOps(ctx.scope, t.fraction.den, fracFs, color, scx, cy + fracFs * 0.85, { align: 'center' }));
             if (t.fraction.suffix) {
-                ops.push(...ctx.fonts.textOps(ctx.page, t.fraction.suffix, fs, color, x + stackW, baseline));
+                ops.push(...ctx.fonts.textOps(ctx.scope, t.fraction.suffix, fs, color, x + stackW, baseline));
             }
         }
         x += w + gap;
@@ -156,7 +156,7 @@ const measurementTileOps = (ctx, c) => {
     const white = GeneralColors.white;
     // Header row: position label, bold, top-left.
     if (c.positionLabel) {
-        ops.push(...ctx.fonts.textOps(ctx.page, c.positionLabel, 12, white, 6, 14));
+        ops.push(...ctx.fonts.textOps(ctx.scope, c.positionLabel, 12, white, 6, 14));
     }
     // Value row, centred on the tile, between the two unit slots.
     const hasUnit = !!c.unit;
@@ -164,7 +164,7 @@ const measurementTileOps = (ctx, c) => {
     const valueText = (c.negative ? '-' : '') + c.value;
     ops.push(...valueRowOps(ctx, valueText, SQUARE / 2, 48, white, available, SQUARE));
     if (hasUnit) {
-        ops.push(...ctx.fonts.textOps(ctx.page, c.unit, UNIT_FONT, white, SQUARE - UNIT_RESERVE / 2, 52, {
+        ops.push(...ctx.fonts.textOps(ctx.scope, c.unit, UNIT_FONT, white, SQUARE - UNIT_RESERVE / 2, 52, {
             align: 'center',
         }));
     }
@@ -175,7 +175,7 @@ const measurementTileOps = (ctx, c) => {
             ops.push(...filledRoundedRect(4, SQUARE - 20, SQUARE - 8, 16, 3, FormulaColors.darkPurple), ...strokedRoundedRect(4, SQUARE - 20, SQUARE - 8, 16, 3, FormulaColors.purple, 1));
         }
         const text = truncate(ctx.fonts, c.label, labelSize, SQUARE - 12);
-        ops.push(...ctx.fonts.textOps(ctx.page, text, labelSize, white, SQUARE / 2, SQUARE - 8, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, text, labelSize, white, SQUARE / 2, SQUARE - 8, { align: 'center' }));
     }
     return ops;
 };
@@ -186,9 +186,9 @@ const emptyTileOps = (ctx, c) => {
         ...strokedRoundedRect(0, 0, SQUARE, SQUARE, CARD_RADIUS, GeneralColors.grey3, 1),
     ];
     if (c.topLeftLabel)
-        ops.push(...ctx.fonts.textOps(ctx.page, c.topLeftLabel, 10, ink, 8, 18));
+        ops.push(...ctx.fonts.textOps(ctx.scope, c.topLeftLabel, 10, ink, 8, 18));
     if (c.topRightLabel) {
-        ops.push(...ctx.fonts.textOps(ctx.page, c.topRightLabel, 10, ink, SQUARE - 8, 18, {
+        ops.push(...ctx.fonts.textOps(ctx.scope, c.topRightLabel, 10, ink, SQUARE - 8, 18, {
             align: 'right',
         }));
     }
@@ -205,7 +205,7 @@ const emptyTileOps = (ctx, c) => {
     ]), stroke(), popGraphicsState());
     if (c.bottomLabel) {
         const text = truncate(ctx.fonts, c.bottomLabel, 10, SQUARE - 16);
-        ops.push(...ctx.fonts.textOps(ctx.page, text, 10, ink, cx, SQUARE - 10, {
+        ops.push(...ctx.fonts.textOps(ctx.scope, text, 10, ink, cx, SQUARE - 10, {
             align: 'center',
         }));
     }
@@ -216,17 +216,17 @@ const literalTileOps = (ctx, c) => {
     const fillColor = filled ? TileColors.activeBlue : GeneralColors.grey2;
     const ink = filled ? GeneralColors.white : GeneralColors.grey4;
     const ops = filledRoundedRect(0, 0, SQUARE, SQUARE, CARD_RADIUS, fillColor);
-    ops.push(...ctx.fonts.textOps(ctx.page, c.topLeftLabel, 10, ink, 8, 18));
-    ops.push(...ctx.fonts.textOps(ctx.page, c.topRightLabel, 10, ink, SQUARE - 8, 18, {
+    ops.push(...ctx.fonts.textOps(ctx.scope, c.topLeftLabel, 10, ink, 8, 18));
+    ops.push(...ctx.fonts.textOps(ctx.scope, c.topRightLabel, 10, ink, SQUARE - 8, 18, {
         align: 'right',
     }));
     ops.push(...filledRoundedRect(8, 28, SQUARE - 16, 40, 4, filled ? TileColors.activeBlue : GeneralColors.grey3));
     if (filled) {
         const size = ctx.fonts.fitSize(c.value, SQUARE - 24, 16, 6);
-        ops.push(...ctx.fonts.textOps(ctx.page, c.value, size, ink, SQUARE / 2, 48 + size * 0.35, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, c.value, size, ink, SQUARE / 2, 48 + size * 0.35, { align: 'center' }));
     }
     const bottom = truncate(ctx.fonts, c.bottomLabel, 10, SQUARE - 16);
-    ops.push(...ctx.fonts.textOps(ctx.page, bottom, 10, ink, SQUARE / 2, SQUARE - 10, {
+    ops.push(...ctx.fonts.textOps(ctx.scope, bottom, 10, ink, SQUARE / 2, SQUARE - 10, {
         align: 'center',
     }));
     return ops;
@@ -273,7 +273,7 @@ const headerTileOps = (ctx, c) => {
                     ops.push(...globeOps(W / 2, by + S.badgeHeight / 2, S.globeSize, S.globeColor));
                 else {
                     const text = truncate(ctx.fonts, b.text, S.badgeFontSize, inner - 10);
-                    ops.push(...ctx.fonts.textOps(ctx.page, text, S.badgeFontSize, S.badgeTextColor, W / 2, by + S.badgeHeight / 2 + S.badgeFontSize * 0.35, { align: 'center' }));
+                    ops.push(...ctx.fonts.textOps(ctx.scope, text, S.badgeFontSize, S.badgeTextColor, W / 2, by + S.badgeHeight / 2 + S.badgeFontSize * 0.35, { align: 'center' }));
                 }
             });
         }
@@ -287,7 +287,7 @@ const headerTileOps = (ctx, c) => {
                     ops.push(...globeOps(bx + bw / 2, y + S.badgeHeight / 2, S.globeSize, S.globeColor));
                 else {
                     const text = truncate(ctx.fonts, b.text, S.badgeFontSize, bw - 10);
-                    ops.push(...ctx.fonts.textOps(ctx.page, text, S.badgeFontSize, S.badgeTextColor, bx + bw / 2, y + S.badgeHeight / 2 + S.badgeFontSize * 0.35, { align: 'center' }));
+                    ops.push(...ctx.fonts.textOps(ctx.scope, text, S.badgeFontSize, S.badgeTextColor, bx + bw / 2, y + S.badgeHeight / 2 + S.badgeFontSize * 0.35, { align: 'center' }));
                 }
             });
         }
@@ -295,7 +295,7 @@ const headerTileOps = (ctx, c) => {
     }
     if (d.name !== null) {
         const text = truncate(ctx.fonts, d.name, S.nameFontSize, inner);
-        ops.push(...ctx.fonts.textOps(ctx.page, text, S.nameFontSize, S.nameColor, W / 2, y + S.nameGap + S.nameFontSize * 0.95, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, text, S.nameFontSize, S.nameColor, W / 2, y + S.nameGap + S.nameFontSize * 0.95, { align: 'center' }));
     }
     return ops;
 };
@@ -311,14 +311,14 @@ const objectTileOps = (ctx, c) => {
     if (!thumb) {
         ops.push(...filledRoundedRect(x, y, w, h, CARD_RADIUS, GeneralColors.grey2));
         const name = truncate(ctx.fonts, c.name || 'Object removed', 9, w - 8);
-        ops.push(...ctx.fonts.textOps(ctx.page, name, 9, GeneralColors.grey4, SQUARE / 2, SQUARE / 2 + 3, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, name, 9, GeneralColors.grey4, SQUARE / 2, SQUARE / 2 + 3, { align: 'center' }));
         return ops;
     }
     // Thumbnail, cover-fit and clipped to the rounded card.
     const scale = Math.max(w / thumb.width, h / thumb.height);
     const iw = thumb.width * scale;
     const ih = thumb.height * scale;
-    ops.push(pushGraphicsState(), ...roundedRectPathOps(x, y, w, h, CARD_RADIUS), clip(), endPath(), ...imageOps(thumb.name, x + (w - iw) / 2, y + (h - ih) / 2, iw, ih), popGraphicsState());
+    ops.push(pushGraphicsState(), ...roundedRectPathOps(x, y, w, h, CARD_RADIUS), clip(), endPath(), ...imageOps(ctx.scope.imageKey(thumb), x + (w - iw) / 2, y + (h - ih) / 2, iw, ih), popGraphicsState());
     // Footer bar by object type: a layout group gets the magenta bar with white
     // ink, a plain photo/background none, every document a white bar with dark ink.
     const type = c.fileType;
@@ -330,7 +330,7 @@ const objectTileOps = (ctx, c) => {
     if (bar) {
         ops.push(pushGraphicsState(), ...roundedRectPathOps(x, y, w, h, CARD_RADIUS), clip(), endPath(), ...fillStateOps(bar.fill), rectangle(x, y + h - OBJECT_BAR_HEIGHT, w, OBJECT_BAR_HEIGHT), fill(), popGraphicsState());
         const name = truncate(ctx.fonts, c.name, 9, w - 8);
-        ops.push(...ctx.fonts.textOps(ctx.page, name, 9, bar.ink, SQUARE / 2, y + h - OBJECT_BAR_HEIGHT / 2 + 3, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, name, 9, bar.ink, SQUARE / 2, y + h - OBJECT_BAR_HEIGHT / 2 + 3, { align: 'center' }));
     }
     return ops;
 };
@@ -365,7 +365,7 @@ const instructionsTileOps = (ctx, c) => {
     const lh = size * 1.25;
     const top = SQUARE / 2 - (lines.length * lh) / 2;
     lines.forEach((line, i) => {
-        ops.push(...ctx.fonts.textOps(ctx.page, truncate(ctx.fonts, line, size, maxW), size, color, SQUARE / 2, top + i * lh + size * 0.9, { align: 'center' }));
+        ops.push(...ctx.fonts.textOps(ctx.scope, truncate(ctx.fonts, line, size, maxW), size, color, SQUARE / 2, top + i * lh + size * 0.9, { align: 'center' }));
     });
     return ops;
 };

package/dist/export/pdf/types.d.ts

@@ -1,5 +1,6 @@
 import type { GroupHeaderDescriptor } from '../../annotation/canvas/groupHeaderLayout.js';
 import type { AnnotationCanvasState, PlacedMeasurementRef } from '../../types/annotation.js';
+import type { PdfCanvasData, PdfCanvasPageState } from '../../types/pdfCanvas.js';
 export interface EmbeddedImage {
     bytes: Uint8Array;
     mime: 'image/png' | 'image/jpeg';
@@ -89,13 +90,36 @@ export interface RenderCanvasToPdfInput {
     calibration?: PdfExportCalibration;
     /** TTF/OTF bytes of the primary font (Metropolis Bold in the apps). */
     primaryFont: Uint8Array;
+    /**
+     * 'annotations' (default): every layer, mark and tile becomes a PDF
+     * annotation object — selectable, movable and deletable in Preview /
+     * Acrobat, with the element's exact drawing as its appearance. 'flatten':
+     * everything is appended to the page content stream and cannot be edited.
+     */
+    mode?: 'annotations' | 'flatten';
+}
+export interface RenderPdfCanvasToPdfInput {
+    /** The PDF the file was uploaded from (`pdfCanvas.document.storagePath`). */
+    sourcePdf: Uint8Array;
+    /** The file-level record (`fileData.pdfCanvas`). */
+    pdfCanvas: PdfCanvasData;
+    /** Page docs by page index; a page without one is exported un-annotated. */
+    pageStates: Partial<Record<number, PdfCanvasPageState>>;
+    resolveTile: (ref: PlacedMeasurementRef) => ResolvedTileContent | undefined;
+    calibration?: PdfExportCalibration;
+    primaryFont: Uint8Array;
+    mode?: 'annotations' | 'flatten';
 }
 export interface RenderCanvasToPdfResult {
     pdf: Uint8Array;
     pageCount: number;
+    /** Annotations written across all pages (0 in flatten mode). */
+    annotationCount: number;
     skipped: SkippedItem[];
 }
 export declare class PdfExportError extends Error {
-    readonly code: 'no-pdf-document' | 'page-count-mismatch' | 'page-geometry-mismatch' | 'encrypted' | 'corrupt';
+    readonly code: 'no-pdf-document' | 'page-count-mismatch' | 'page-geometry-mismatch'
+    /** The renderer was handed an encrypted PDF — run stripPdfEncryption first. */
+     | 'encrypted' | 'password-required' | 'password-incorrect' | 'unsupported' | 'corrupt';
     constructor(code: PdfExportError['code'], message: string);
 }

package/dist/exports.d.ts

@@ -6,6 +6,7 @@ export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';
 export * from './types/annotation.js';
+export * from './types/pdfCanvas.js';
 export { getToleranceColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, type ToleranceThreshold, type ToleranceConfig, } from './utils/tolerance.js';
 export { GeneralColors, SecondaryColors, FormColors, TileColors, FormulaColors, YellowColors, RedColors, GreenColors, tailwindColors, } from './theme/colors.js';
 export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, isFormGroupCompleted, } from './utils/groups.js';
@@ -25,6 +26,7 @@ export { useAnnotationDoc, type UseAnnotationDocResult, } from './annotation/dat
 export { useAnnotationList, type UseAnnotationListResult, } from './annotation/data/hooks/useAnnotationList.js';
 export { useAnnotationMutations, type AnnotationMutations, } from './annotation/data/hooks/useAnnotationMutations.js';
 export { useAnnotationCanvasDoc, type SaveStatus, type UseAnnotationCanvasDocOptions, type UseAnnotationCanvasDocResult, } from './annotation/data/hooks/useAnnotationCanvasDoc.js';
+export { usePdfCanvasDoc, type UsePdfCanvasDocOptions, type UsePdfCanvasDocResult, } from './annotation/data/hooks/usePdfCanvasDoc.js';
 export { hydrateCanvasState } from './annotation/data/canvasPersistence.js';
 export { InMemoryAnnotationProvider } from './annotation/data/InMemoryAnnotationProvider.js';
 export type { AnnotationCanvasHandle } from './annotation/canvas/useAnnotationCanvasState.js';
@@ -37,6 +39,7 @@ export { STAMP_TILE_SIZE, GROUP_HEADER_TILE_WIDTH, GROUP_HEADER_TILE_HEIGHT, GRO
 export { GROUP_HEADER_STYLE, describeGroupHeader, groupHeaderSignature, type GroupHeaderBadge, type GroupHeaderDescriptor, } from './annotation/canvas/groupHeaderLayout.js';
 export { createViewportApi, fitToScreen, fitRectToScreen, imageDocRect, panBy, zoomAt, DEFAULT_VIEWPORT, DEFAULT_ZOOM_LIMITS, type ViewportApi, type ViewportState, type ZoomLimits, } from './annotation/canvas/viewport.js';
 export { DEFAULT_PDF_PAGE_GAP, DEFAULT_MIN_ZOOM, DEFAULT_MAX_ZOOM, makePdfDocumentId, createPdfDocument, pdfPageDocRects, pdfDocumentExtent, pdfFirstPageDocRect, computeZoomFloor, type PdfDocRect, } from './annotation/canvas/pdfDocument.js';
+export { normalizePdfRotation, effectivePageRotation, pdfPageDisplaySize, pdfCanvasPageDocId, emptyPdfCanvasPageState, pdfCanvasPageDocument, pdfCanvasKnobsOf, pdfCanvasKnobsEqual, pageStateToCanvasState, canvasStateToPageState, rotatePointInPage, rotatePageState, rotatePdfCanvasPage, type PdfPageDisplaySize, type PdfRotationDelta, } from './annotation/canvas/pdfCanvasPages.js';
 export { LEGACY_BACKGROUND_LAYER_ID, BACKGROUND_PLACEMENT_GAP_RATIO, backgroundLayersOf, backgroundLayerIsLocked, isBackgroundLayerLocked, defaultBackgroundLayerLocked, backgroundLayerDocRect, backgroundLayersUnionRect, placeNewBackgroundLayer, } from './annotation/canvas/backgroundLayers.js';
 export { fileTileImageSource, expandFileTileToBackground, collapseBackgroundToFileTile, type FileTileImageSource, } from './annotation/canvas/fileTileSwap.js';
 export { createPenTool, type PenToolOptions, } from './annotation/canvas/tools/penTool.js';

package/dist/exports.js

@@ -10,6 +10,7 @@ export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';
 export * from './types/annotation.js';
+export * from './types/pdfCanvas.js';
 export { getToleranceColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, } from './utils/tolerance.js';
 // Shared color palette (canonical source for both apps' brand colors).
 export { GeneralColors, SecondaryColors, FormColors, TileColors, FormulaColors, YellowColors, RedColors, GreenColors, tailwindColors, } from './theme/colors.js';
@@ -37,12 +38,14 @@ export { useAnnotationDoc, } from './annotation/data/hooks/useAnnotationDoc.js';
 export { useAnnotationList, } from './annotation/data/hooks/useAnnotationList.js';
 export { useAnnotationMutations, } from './annotation/data/hooks/useAnnotationMutations.js';
 export { useAnnotationCanvasDoc, } from './annotation/data/hooks/useAnnotationCanvasDoc.js';
+export { usePdfCanvasDoc, } from './annotation/data/hooks/usePdfCanvasDoc.js';
 export { hydrateCanvasState } from './annotation/data/canvasPersistence.js';
 export { InMemoryAnnotationProvider } from './annotation/data/InMemoryAnnotationProvider.js';
 export { STAMP_TILE_SIZE, GROUP_HEADER_TILE_WIDTH, GROUP_HEADER_TILE_HEIGHT, GROUP_HEADER_COLLAPSED_WIDTH, GROUP_HEADER_COLLAPSED_HEIGHT, GROUP_HEADER_DESIGN, groupHeaderBaseDims, DEFAULT_TILE_SCALE, TILE_SCALE_MIN, TILE_SCALE_MAX, clampTileScale, resolveTileScaleFactor, resolveHeaderTileScaleFactor, resolveFileTileScaleFactor, tileDocSizeForFactor, tileScaleFromDocSize, stampTileSize, stampTileDims, isUnassociatedStamp, isFileStamp, } from './annotation/canvas/stampLayout.js';
 export { GROUP_HEADER_STYLE, describeGroupHeader, groupHeaderSignature, } from './annotation/canvas/groupHeaderLayout.js';
 export { createViewportApi, fitToScreen, fitRectToScreen, imageDocRect, panBy, zoomAt, DEFAULT_VIEWPORT, DEFAULT_ZOOM_LIMITS, } from './annotation/canvas/viewport.js';
 export { DEFAULT_PDF_PAGE_GAP, DEFAULT_MIN_ZOOM, DEFAULT_MAX_ZOOM, makePdfDocumentId, createPdfDocument, pdfPageDocRects, pdfDocumentExtent, pdfFirstPageDocRect, computeZoomFloor, } from './annotation/canvas/pdfDocument.js';
+export { normalizePdfRotation, effectivePageRotation, pdfPageDisplaySize, pdfCanvasPageDocId, emptyPdfCanvasPageState, pdfCanvasPageDocument, pdfCanvasKnobsOf, pdfCanvasKnobsEqual, pageStateToCanvasState, canvasStateToPageState, rotatePointInPage, rotatePageState, rotatePdfCanvasPage, } from './annotation/canvas/pdfCanvasPages.js';
 export { LEGACY_BACKGROUND_LAYER_ID, BACKGROUND_PLACEMENT_GAP_RATIO, backgroundLayersOf, backgroundLayerIsLocked, isBackgroundLayerLocked, defaultBackgroundLayerLocked, backgroundLayerDocRect, backgroundLayersUnionRect, placeNewBackgroundLayer, } from './annotation/canvas/backgroundLayers.js';
 export { fileTileImageSource, expandFileTileToBackground, collapseBackgroundToFileTile, } from './annotation/canvas/fileTileSwap.js';
 export { createPenTool, } from './annotation/canvas/tools/penTool.js';

package/dist/server.d.ts

@@ -5,6 +5,8 @@ export { parseMeasurement } from './utils/parseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';
 export * from './types/annotation.js';
+export * from './types/pdfCanvas.js';
+export { normalizePdfRotation, effectivePageRotation, pdfPageDisplaySize, pdfCanvasPageDocId, pageStateToCanvasState, rotatePageState, type PdfPageDisplaySize, type PdfRotationDelta, } from './annotation/canvas/pdfCanvasPages.js';
 export { getToleranceColor, getToleranceSecondaryColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, DEFAULT_TOLERANCE_SECONDARY_COLORS, type ToleranceThreshold, type ToleranceConfig, } from './utils/tolerance.js';
 export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, isFormGroupCompleted, } from './utils/groups.js';
 export { ROLE_RANK, EMPTY_GRANTS, normalizeRole, roleAtLeast, effectiveRole, canView, canEdit, canManage, canManageOrg, isGuest, groupGrants, resolveAccess, type MaybeRole, type GroupedGrants, type ResolvedAccess, } from './utils/permissions.js';

package/dist/server.js

@@ -10,6 +10,8 @@ export { parseMeasurement } from './utils/parseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';
 export * from './types/annotation.js';
+export * from './types/pdfCanvas.js';
+export { normalizePdfRotation, effectivePageRotation, pdfPageDisplaySize, pdfCanvasPageDocId, pageStateToCanvasState, rotatePageState, } from './annotation/canvas/pdfCanvasPages.js';
 export { getToleranceColor, getToleranceSecondaryColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, DEFAULT_TOLERANCE_SECONDARY_COLORS, } from './utils/tolerance.js';
 export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, isFormGroupCompleted, } from './utils/groups.js';
 export { ROLE_RANK, EMPTY_GRANTS, normalizeRole, roleAtLeast, effectiveRole, canView, canEdit, canManage, canManageOrg, isGuest, groupGrants, resolveAccess, } from './utils/permissions.js';

package/dist/types/firestore.d.ts

@@ -1,4 +1,5 @@
 import type { AnnotationCanvasState } from './annotation.js';
+import type { PdfCanvasData } from './pdfCanvas.js';
 import type { CalculatorUnit } from '../calculator/units.js';
 interface FirestoreDoc {
     id: string;
@@ -170,6 +171,7 @@ export interface SelectedTemplate extends FirestoreDoc {
 export declare enum FileUploadType {
     Annotation = "annotation",
     Canvas = "canvas",
+    PdfCanvas = "pdfCanvas",
     Template = "template",
     Background = "background",
     LayoutGroup = "layoutGroup",
@@ -186,6 +188,7 @@ export interface AnnotationFileData {
         clientId: string;
         seq: number;
     };
+    pdfCanvas?: PdfCanvasData;
 }
 export interface CalculatorFileData {
     templateId: string;
@@ -242,6 +245,9 @@ export type FileUpload = FileUploadBase & ({
 } | {
     type: FileUploadType.Canvas;
     fileData: AnnotationFileData;
+} | {
+    type: FileUploadType.PdfCanvas;
+    fileData: AnnotationFileData;
 } | {
     type: FileUploadType.Calculator;
     fileData: CalculatorFileData;

package/dist/types/firestore.js

@@ -52,6 +52,11 @@ export var FileUploadType;
     // v2 Skia photo-annotation canvas. Distinct from the legacy PSPDFKit
     // `Annotation` docs so file-open routing sends it to the canvas editor.
     FileUploadType["Canvas"] = "canvas";
+    // A PDF annotated one page at a time with the Skia canvas (see
+    // types/pdfCanvas.ts). Its PDF sits at `${folderPath}/file` like a legacy
+    // `Annotation` upload, so a client that predates the type still opens it in
+    // the Nutrient viewer instead of failing.
+    FileUploadType["PdfCanvas"] = "pdfCanvas";
     FileUploadType["Template"] = "template";
     FileUploadType["Background"] = "background";
     FileUploadType["LayoutGroup"] = "layoutGroup";

package/dist/types/pdfCanvas.d.ts

@@ -0,0 +1,38 @@
+import type { AnnotationLayer, AnnotationShape, AnnotationStroke, PlacedMeasurementRef, PlaneCalibration } from './annotation.js';
+export type PdfPageRotation = 0 | 90 | 180 | 270;
+export interface PdfCanvasPage {
+    width: number;
+    height: number;
+    rotation: PdfPageRotation;
+}
+export interface PdfCanvasDocument {
+    storagePath: string;
+    fileName?: string;
+    pageCount: number;
+    pages: PdfCanvasPage[];
+}
+export interface PdfCanvasRev {
+    clientId: string;
+    seq: number;
+}
+export interface PdfCanvasData {
+    schemaVersion: 1;
+    document: PdfCanvasDocument;
+    tileScaleFactor?: number;
+    tileScaleFactorMobile?: number;
+    headerTileScaleFactor?: number;
+    headerTileScaleFactorMobile?: number;
+    tileDocSize?: number;
+    annotatedPages: number[];
+}
+export interface PdfCanvasPageState {
+    schemaVersion: 1;
+    pageIndex: number;
+    layers: AnnotationLayer[];
+    strokes: AnnotationStroke[];
+    shapes: AnnotationShape[];
+    placedMeasurements: PlacedMeasurementRef[];
+    planes?: PlaneCalibration[];
+    updatedAt: number;
+    rev?: PdfCanvasRev;
+}

package/dist/types/pdfCanvas.js

@@ -0,0 +1,16 @@
+// Schema of a PDF CANVAS file (FileUploadType.PdfCanvas): a PDF annotated one
+// page at a time with the Skia canvas. Distinct from a Canvas file carrying a
+// `viewport.pdfDocument` filmstrip — there every page shares one doc space;
+// here EVERY PAGE IS ITS OWN CANVAS whose doc space is that page's displayed
+// extent in PDF points (origin top-left, y down), so the canvas engine needs no
+// page concept at all: the editor mounts the current page's state and swaps it
+// on a page turn.
+//
+// Storage split (see pdfCanvasPages.ts for the mapping helpers):
+//  - `fileData.pdfCanvas` on the file doc: the small file-level record —
+//    which PDF, page geometry + user rotations, shared tile-scale knobs, and
+//    which pages have been annotated.
+//  - `files/{fileId}/pages/{pageIndex}`: one doc per annotated page holding
+//    that page's elements. Sharded so a heavy set never approaches the 1 MiB
+//    doc limit, a save rewrites one page, and a listener watches one page.
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-utils",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Shared utilities for formulas and measurement conversion used in Reekon apps",
   "author": "REEKON Tools",
   "license": "MIT",
@@ -52,7 +52,9 @@
     "pdf-lib": "1.17.1",
     "zod": "^4.4.3"
   },
+  "//peerDependencies-embedpdf": "OPTIONAL, server only: `@embedpdf/pdfium` is imported lazily by exactly one module (export/pdf/decrypt.ts, reached through the ./server entry) to strip PDF encryption before pdf-lib appends to a page. The apps never resolve it.",
   "peerDependencies": {
+    "@embedpdf/pdfium": ">=2.15.0",
     "@shopify/react-native-skia": ">=2.5.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-native": ">=0.74.0",
@@ -60,6 +62,9 @@
     "react-native-reanimated": ">=3.0.0"
   },
   "peerDependenciesMeta": {
+    "@embedpdf/pdfium": {
+      "optional": true
+    },
     "react-native": {
       "optional": true
     },