@reekon-tools/boldr-utils 1.6.27 → 1.6.29

package/dist/annotation/canvas/tools/selectTool.d.ts

@@ -1,2 +1,5 @@
 import type { Tool } from '../Tool.js';
-export declare const createSelectTool: () => Tool;
+export interface SelectToolOptions {
+    panOnEmptyDrag?: boolean;
+}
+export declare const createSelectTool: (options?: SelectToolOptions) => Tool;

package/dist/annotation/canvas/tools/selectTool.js

@@ -472,7 +472,7 @@ const dragPatch = (s, doc, delta, zoom) => {
     const op = translatePatch(s.elementKind, s.id, doc, delta);
     return op ? { ops: [op] } : null;
 };
-export const createSelectTool = () => ({
+export const createSelectTool = (options = {}) => ({
     id: 'select',
     label: 'Select',
     cursor: 'default',
@@ -582,6 +582,11 @@ export const createSelectTool = () => ({
         const hit = findHit(ctx.document, world, zoom, ctx.tileViewportScale);
         if (!hit) {
             ctx.setSelection(null);
+            // Nothing under the pointer: with panOnEmptyDrag the gesture pans the
+            // viewport instead of dead-ending, so bare drags navigate the canvas.
+            if (options.panOnEmptyDrag) {
+                return { kind: 'panning', lastScreen: event.screen };
+            }
             return { kind: 'idle' };
         }
         // Re-tapping an already-selected text shape (without dragging) opens its
@@ -610,6 +615,13 @@ export const createSelectTool = () => ({
     },
     onPointerMove(event, ctx, state) {
         const s = state;
+        if (s?.kind === 'panning') {
+            ctx.applyPan({
+                x: event.screen.x - s.lastScreen.x,
+                y: event.screen.y - s.lastScreen.y,
+            });
+            return { ...s, lastScreen: event.screen };
+        }
         if (s?.kind !== 'dragging')
             return s;
         const delta = {

package/dist/annotation/data/hooks/useAnnotationCanvasDoc.d.ts

@@ -6,6 +6,7 @@ export interface UseAnnotationCanvasDocOptions {
     fileId: string | null;
     fallbackViewport?: Partial<AnnotationViewport>;
     debounceMs?: number;
+    autoSave?: boolean;
     createSeed?: {
         name?: string;
         fileType?: 'sketch' | 'document';

package/dist/annotation/data/hooks/useAnnotationCanvasDoc.js

@@ -32,7 +32,7 @@ const makeClientId = () => `${Date.now().toString(36)}-${Math.floor(Math.random(
 // no `fileId` was supplied. Composes the existing low-level hooks so it stays
 // decoupled from any specific Firebase SDK.
 export const useAnnotationCanvasDoc = (options) => {
-    const { scope, fileId, fallbackViewport, debounceMs = 800, createSeed, onFileCreated, onSaveError, captureThumbnail, debugLogging = false, } = options;
+    const { scope, fileId, fallbackViewport, debounceMs = 800, autoSave = true, createSeed, onFileCreated, onSaveError, captureThumbnail, debugLogging = false, } = options;
     const { data, loading, error } = useAnnotationDoc(scope, fileId);
     const { create, update, uploadImage, deleteImage } = useAnnotationMutations(scope ?? EMPTY_SCOPE);
     const [working, setWorking] = useState(null);
@@ -142,8 +142,12 @@ export const useAnnotationCanvasDoc = (options) => {
             return;
         }
         // A write of ours is queued or in flight — ignore the snapshot; it is
-        // either the echo of our write or about to be superseded by it.
-        if (statusRef.current === 'saving' || timerRef.current !== null)
+        // either the echo of our write or about to be superseded by it. 'dirty'
+        // matters for the explicit-save mode (autoSave false), where local edits
+        // sit unsaved indefinitely and must not be clobbered by a remote write.
+        if (statusRef.current === 'saving' ||
+            statusRef.current === 'dirty' ||
+            timerRef.current !== null)
             return;
         const incoming = data?.fileData.canvas;
         if (!incoming)
@@ -292,13 +296,17 @@ export const useAnnotationCanvasDoc = (options) => {
             return next;
         });
         setStatus('dirty');
+        // Explicit-save mode: the edit stays local (status 'dirty') until the
+        // caller invokes save() — no debounce, no write.
+        if (!autoSave)
+            return;
         if (timerRef.current)
             clearTimeout(timerRef.current);
         timerRef.current = setTimeout(() => {
             timerRef.current = null;
             void flush();
         }, debounceMs);
-    }, [debounceMs, flush, setStatus]);
+    }, [autoSave, debounceMs, flush, setStatus]);
     // Explicit save (Save button, "done" actions): also refreshes the file's
     // thumbnail, which autosaves deliberately skip. Resolves only after the
     // capture+upload too, so a caller may unmount the view right after.

package/dist/exports.d.ts

@@ -8,6 +8,7 @@ export * from './types/layout.js';
 export * from './types/annotation.js';
 export { getToleranceColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, type ToleranceThreshold, type ToleranceConfig, } from './utils/tolerance.js';
 export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, } from './utils/groups.js';
+export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
 export { isFieldOp, type AnnotationDataProvider, type AnnotationFile, type AnnotationFileSummary, type FieldOp, type ImageBlob, type JobGroupScope, type JobScope, type Patch, type Unsubscribe, type UploadedImageRef, } from './annotation/data/AnnotationDataProvider.js';
 export { AnnotationDataProviderContext, useAnnotationData, type AnnotationDataProviderProps, } from './annotation/data/AnnotationDataContext.js';
 export { useAnnotationDoc, type UseAnnotationDocResult, } from './annotation/data/hooks/useAnnotationDoc.js';
@@ -24,7 +25,7 @@ export type { MeasurementStampRenderArgs, RenderMeasurementStamp, } from './anno
 export { STAMP_TILE_SIZE, DEFAULT_TILE_SCALE, TILE_SCALE_MIN, TILE_SCALE_MAX, clampTileScale, stampTileSize, isUnassociatedStamp, } from './annotation/canvas/stampLayout.js';
 export { createViewportApi, fitToScreen, fitRectToScreen, imageDocRect, panBy, zoomAt, DEFAULT_VIEWPORT, type ViewportApi, type ViewportState, } from './annotation/canvas/viewport.js';
 export { createPenTool, type PenToolOptions, } from './annotation/canvas/tools/penTool.js';
-export { createSelectTool } from './annotation/canvas/tools/selectTool.js';
+export { createSelectTool, type SelectToolOptions, } from './annotation/canvas/tools/selectTool.js';
 export { createMeasurementStampTool, type MeasurementStampToolOptions, } from './annotation/canvas/tools/measurementStampTool.js';
 export { createPanTool, type PanToolOptions, } from './annotation/canvas/tools/panTool.js';
 export { createTextTool, type TextToolOptions, } from './annotation/canvas/tools/textTool.js';

package/dist/exports.js

@@ -12,6 +12,7 @@ export * from './types/layout.js';
 export * from './types/annotation.js';
 export { getToleranceColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, } from './utils/tolerance.js';
 export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, } from './utils/groups.js';
+export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
 // Annotation data layer (SDK-neutral; apps provide their own provider).
 export { isFieldOp, } from './annotation/data/AnnotationDataProvider.js';
 export { AnnotationDataProviderContext, useAnnotationData, } from './annotation/data/AnnotationDataContext.js';
@@ -24,7 +25,7 @@ export { InMemoryAnnotationProvider } from './annotation/data/InMemoryAnnotation
 export { STAMP_TILE_SIZE, DEFAULT_TILE_SCALE, TILE_SCALE_MIN, TILE_SCALE_MAX, clampTileScale, stampTileSize, isUnassociatedStamp, } from './annotation/canvas/stampLayout.js';
 export { createViewportApi, fitToScreen, fitRectToScreen, imageDocRect, panBy, zoomAt, DEFAULT_VIEWPORT, } from './annotation/canvas/viewport.js';
 export { createPenTool, } from './annotation/canvas/tools/penTool.js';
-export { createSelectTool } from './annotation/canvas/tools/selectTool.js';
+export { createSelectTool, } from './annotation/canvas/tools/selectTool.js';
 export { createMeasurementStampTool, } from './annotation/canvas/tools/measurementStampTool.js';
 export { createPanTool, } from './annotation/canvas/tools/panTool.js';
 export { createTextTool, } from './annotation/canvas/tools/textTool.js';

package/dist/utils/indexLabels.d.ts

@@ -0,0 +1,3 @@
+export declare const numberToLetterIndex: (index: number) => string;
+export declare const formGroupInputLabel: (columnIndex: number, groupIndex: number) => string;
+export declare const listGroupMeasurementLabel: (deviceMeasurementNumber: number | null | undefined, groupIndex: number) => string;

package/dist/utils/indexLabels.js

@@ -0,0 +1,40 @@
+// Canonical measurement / input index labels, shared by rock-desktop and
+// rock-pro-app so every surface (tables, forms, PDF tile overlays, mobile
+// lists) renders the same identifier for the same datum.
+//
+// Two schemes exist:
+//
+// - FORM groups: inputs are identified positionally — the column's index in
+//   the section's tableConfig as a letter, plus the group's 1-based number.
+//   First column in the second group → "A2"; fifth column in the third
+//   group → "E3".
+//
+// - LIST groups: entries are always measurements, identified by their stable
+//   deviceMeasurementNumber (capture sequence) as the letter, plus the same
+//   group number. deviceMeasurementNumber 4 in the second group → "E2".
+//   Legacy measurements without a deviceMeasurementNumber fall back to the
+//   bare group number ("2") — positional letters would shift as the list
+//   re-sorts, so no letter is shown.
+// 0-based index → spreadsheet-style letters: 0 → "A", 25 → "Z", 26 → "AA".
+// Negative / non-finite input yields ''.
+export const numberToLetterIndex = (index) => {
+    if (!Number.isFinite(index) || index < 0)
+        return '';
+    let n = Math.floor(index) + 1;
+    let result = '';
+    while (n > 0) {
+        n--;
+        result = String.fromCharCode((n % 26) + 65) + result;
+        n = Math.floor(n / 26);
+    }
+    return result;
+};
+// Label for a FORM-group input: column position (0-based) + group number.
+// formGroupInputLabel(0, 1) → "A2"
+export const formGroupInputLabel = (columnIndex, groupIndex) => `${numberToLetterIndex(columnIndex)}${groupIndex + 1}`;
+// Label for a LIST-group measurement: deviceMeasurementNumber (0-based) +
+// group number, or the bare group number when the measurement has no device
+// number. listGroupMeasurementLabel(4, 1) → "E2"; (null, 1) → "2".
+export const listGroupMeasurementLabel = (deviceMeasurementNumber, groupIndex) => deviceMeasurementNumber != null && deviceMeasurementNumber >= 0
+    ? `${numberToLetterIndex(deviceMeasurementNumber)}${groupIndex + 1}`
+    : `${groupIndex + 1}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-utils",
-  "version": "1.6.27",
+  "version": "1.6.29",
   "description": "Shared utilities for formulas and measurement conversion used in Reekon apps",
   "author": "REEKON Tools",
   "license": "MIT",