@ifc-lite/drawing-2d 2.1.1 → 3.1.0

package/dist/sheet/index.d.ts

@@ -13,16 +13,14 @@ export type { FrameStyle, FrameBorderConfig, FrameMargins, DrawingFrame, } from
 export { FRAME_PRESETS, createFrame, getDefaultFrame, } from './frame-types.js';
 export type { TitleBlockPosition, TitleBlockLayout, TitleBlockField, TitleBlockLogo, RevisionEntry, TitleBlockConfig, } from './title-block-types.js';
 export { DEFAULT_TITLE_BLOCK_FIELDS, TITLE_BLOCK_PRESETS, createTitleBlock, getDefaultTitleBlock, updateTitleBlockField, } from './title-block-types.js';
-export type { ScaleBarStyle, ScaleBarPosition, ScaleBarUnits, ScaleBarConfig, NorthArrowStyle, NorthArrowConfig, } from './scale-bar-types.js';
+export type { ScaleBarConfig, NorthArrowStyle, NorthArrowConfig, } from './scale-bar-types.js';
 export { DEFAULT_SCALE_BAR, DEFAULT_NORTH_ARROW, calculateOptimalScaleBarLength, calculateOptimalDivisions, } from './scale-bar-types.js';
 export type { ScaleStampRect, ScaleStampText, ScaleStampBar, ScaleStamp, StampedSheetLayout, } from './scale-stamp.js';
 export { addScaleStamp } from './scale-stamp.js';
 export type { ViewportBounds, DrawingSheet, SheetCreationOptions, } from './sheet-types.js';
-export { calculateViewportBounds, calculateDrawingTransform, } from './sheet-types.js';
+export { calculateViewportBounds, calculateDrawingTransform, calculateDrawingTransformForAxis, } from './sheet-types.js';
 export type { FrameRenderResult, } from './frame-renderer.js';
 export { renderFrame } from './frame-renderer.js';
 export type { FrameInnerBounds, TitleBlockRenderResult, TitleBlockExtras, } from './title-block-renderer.js';
 export { renderTitleBlock } from './title-block-renderer.js';
-export type { PositionMm } from './scale-bar-renderer.js';
-export { renderScaleBar, renderNorthArrow } from './scale-bar-renderer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sheet/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sheet/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAGH,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sheet/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAGH,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/sheet/index.js

@@ -6,8 +6,7 @@ export { FRAME_PRESETS, createFrame, getDefaultFrame, } from './frame-types.js';
 export { DEFAULT_TITLE_BLOCK_FIELDS, TITLE_BLOCK_PRESETS, createTitleBlock, getDefaultTitleBlock, updateTitleBlockField, } from './title-block-types.js';
 export { DEFAULT_SCALE_BAR, DEFAULT_NORTH_ARROW, calculateOptimalScaleBarLength, calculateOptimalDivisions, } from './scale-bar-types.js';
 export { addScaleStamp } from './scale-stamp.js';
-export { calculateViewportBounds, calculateDrawingTransform, } from './sheet-types.js';
+export { calculateViewportBounds, calculateDrawingTransform, calculateDrawingTransformForAxis, } from './sheet-types.js';
 export { renderFrame } from './frame-renderer.js';
 export { renderTitleBlock } from './title-block-renderer.js';
-export { renderScaleBar, renderNorthArrow } from './scale-bar-renderer.js';
 //# sourceMappingURL=index.js.map

package/dist/sheet/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sheet/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAkB/D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAWhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAY9B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQjD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sheet/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAkB/D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAY9B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQjD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/sheet/scale-bar-types.d.ts

@@ -1,44 +1,22 @@
 /**
  * Scale Bar Types
  *
- * Configurable scale bar for architectural drawings:
- * - Multiple visual styles
- * - Metric and imperial units
- * - Auto-calculation of optimal length
+ * Configuration for the scale bar drawn in the sheet's title block
+ * (`renderScaleBarInTitleBlock` in `title-block-renderer.ts`, and its
+ * on-screen twin in the viewer's `Drawing2DCanvas`). Both draw one
+ * alternating-segment metric bar with `0` and end-distance labels; every
+ * field below is one that those renderers actually read.
  */
-/** Scale bar style */
-export type ScaleBarStyle = 'linear' | 'alternating' | 'single' | 'graphic';
-/** Scale bar position relative to drawing viewport */
-export type ScaleBarPosition = 'below-viewport' | 'above-viewport' | 'in-title-block' | 'custom';
-/** Scale bar unit system */
-export type ScaleBarUnits = 'metric' | 'imperial' | 'both';
 /** Scale bar configuration */
 export interface ScaleBarConfig {
     /** Whether to show scale bar */
     visible: boolean;
-    /** Scale bar style */
-    style: ScaleBarStyle;
-    /** Position */
-    position: ScaleBarPosition;
-    /** Custom position offset from default (mm) */
-    customOffset?: {
-        x: number;
-        y: number;
-    };
-    /** Unit system */
-    units: ScaleBarUnits;
     /** Total length in model units (meters) */
     totalLengthM: number;
     /** Number of primary divisions */
     primaryDivisions: number;
-    /** Number of subdivisions per primary division */
-    subdivisions: number;
-    /** Bar height in mm */
+    /** Bar height in mm (clamped to 3mm by the renderer) */
     heightMm: number;
-    /** Label font size in mm */
-    labelFontSize: number;
-    /** Show unit label (e.g., "meters") */
-    showUnitLabel: boolean;
     /** Fill color for filled segments */
     fillColor: string;
     /** Stroke color */
@@ -48,6 +26,57 @@ export interface ScaleBarConfig {
 }
 /** Default scale bar configuration */
 export declare const DEFAULT_SCALE_BAR: ScaleBarConfig;
+/**
+ * Round distances a scale bar is allowed to span, ascending.
+ *
+ * Shared by the two things that pick a bar length — the sheet's default
+ * ("what should this bar be?") and the title-block renderer's snap ("largest
+ * one that fits this cell") — so they cannot disagree about what "nice" means.
+ * They were separate literals with identical contents, which is one edit away
+ * from divergence.
+ *
+ * Every entry survives the printed label's formatting exactly: whole
+ * centimetres below 1 m, whole metres above. That is the property that makes
+ * the snap able to promise an exact label, so a new entry has to keep it —
+ * 0.15 would print "15cm" correctly but 0.125 would print "13cm" and lie.
+ *
+ * Reaches 0.02 because `maxBarWidth` is `min(width * 0.3, 50)`. On the shipped
+ * compact preset (120 mm) that is 36 mm, and stopping the ladder at 0.1 left
+ * both 1:1 and 1:2 with no bar at all. At the full 50 mm only 1:1 fails, since
+ * 0.1 m at 1:2 is exactly 50 mm — so 36 is the binding number, which is what
+ * `scale-bar-ladder.test.ts` asserts against.
+ */
+export declare const NICE_BAR_LENGTHS_M: readonly number[];
+/**
+ * Whether `m` survives the scale bar's label formatting without lying:
+ * whole centimetres below 1 m, whole metres above.
+ */
+export declare function barLabelIsExact(m: number): boolean;
+/**
+ * Smallest SEGMENT worth drawing, in millimetres of paper.
+ *
+ * Segment widths are emitted through `toFixed(2)`, so anything under 0.005 mm
+ * prints `width="0.00"` — a label with no bar under it. That is reachable: at
+ * 1:1 on a 760 m model the transform gives 0.42 mm per metre, so a 5 cm bar is
+ * 0.02 mm wide and all five of its segments print zero. The old clamp-to-cell
+ * hid this by always stretching the bar to fill the cell; choosing the distance
+ * first removed that accident, so the floor has to be explicit.
+ *
+ * Deliberately a per-SEGMENT bound rather than a whole-bar one. A blanket bar
+ * minimum of 5 mm rejects a perfectly legible 4 mm bar at 1:500, which is a
+ * real configuration; what actually fails is a segment rounding to zero, and
+ * that is what this measures. 0.01 mm is twice the rounding threshold.
+ *
+ * A correction to an earlier version of this note, because it misattributed
+ * the mechanism: the old `Math.min(barLengthMm, maxBarWidth)` clamp could not
+ * ENLARGE anything. What filled the cell was the reciprocal-units bug — at
+ * 0.42 mm per metre the old formula computed `0.05 * 1000 / 0.42` = 119 mm and
+ * the clamp capped that at 50. So one bug was hiding another, which is why
+ * fixing the arithmetic is what exposed this.
+ */
+export declare const MIN_BAR_SEGMENT_MM = 0.01;
+/** The end label the scale bar prints for a given distance. */
+export declare function formatBarLabel(m: number): string;
 /**
  * Calculate optimal scale bar length based on drawing scale
  * Returns length in model units (meters)
@@ -63,18 +92,19 @@ export declare function calculateOptimalScaleBarLength(scaleFactor: number, maxL
 export declare function calculateOptimalDivisions(totalLengthM: number): number;
 /** North arrow style */
 export type NorthArrowStyle = 'simple' | 'compass' | 'decorative' | 'none';
-/** North arrow configuration */
+/**
+ * North arrow configuration.
+ *
+ * The arrow is drawn at a fixed spot in the title block, so there is no
+ * position field: `style` only selects between drawn ('simple', 'compass',
+ * 'decorative' all render the same glyph today) and not drawn ('none').
+ */
 export interface NorthArrowConfig {
-    /** Arrow style */
+    /** Arrow style; 'none' suppresses the arrow */
     style: NorthArrowStyle;
     /** Rotation in degrees (0 = up) */
     rotation: number;
-    /** Position in mm from top-left of viewport */
-    positionMm: {
-        x: number;
-        y: number;
-    };
-    /** Size in mm */
+    /** Size in mm (clamped by the renderer to 8mm and to the title block) */
     sizeMm: number;
 }
 /** Default north arrow configuration */

package/dist/sheet/scale-bar-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scale-bar-types.d.ts","sourceRoot":"","sources":["../../src/sheet/scale-bar-types.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5E,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEjG,4BAA4B;AAC5B,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3D,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe;IACf,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,+CAA+C;IAC/C,YAAY,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,kBAAkB;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,EAAE,cAc/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAwB;AACxB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAE3E,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC"}
+{"version":3,"file":"scale-bar-types.d.ts","sourceRoot":"","sources":["../../src/sheet/scale-bar-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,EAAE,cAQ/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAsBlD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAwB;AACxB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,gBAIjC,CAAC"}

package/dist/sheet/scale-bar-types.js

@@ -4,19 +4,91 @@
 /** Default scale bar configuration */
 export const DEFAULT_SCALE_BAR = {
     visible: true,
-    style: 'alternating',
-    position: 'below-viewport',
-    units: 'metric',
     totalLengthM: 5, // Will be auto-calculated based on scale
     primaryDivisions: 5,
-    subdivisions: 2,
     heightMm: 3,
-    labelFontSize: 2.5,
-    showUnitLabel: true,
     fillColor: '#000000',
     strokeColor: '#000000',
     lineWeight: 0.25,
 };
+/**
+ * Round distances a scale bar is allowed to span, ascending.
+ *
+ * Shared by the two things that pick a bar length — the sheet's default
+ * ("what should this bar be?") and the title-block renderer's snap ("largest
+ * one that fits this cell") — so they cannot disagree about what "nice" means.
+ * They were separate literals with identical contents, which is one edit away
+ * from divergence.
+ *
+ * Every entry survives the printed label's formatting exactly: whole
+ * centimetres below 1 m, whole metres above. That is the property that makes
+ * the snap able to promise an exact label, so a new entry has to keep it —
+ * 0.15 would print "15cm" correctly but 0.125 would print "13cm" and lie.
+ *
+ * Reaches 0.02 because `maxBarWidth` is `min(width * 0.3, 50)`. On the shipped
+ * compact preset (120 mm) that is 36 mm, and stopping the ladder at 0.1 left
+ * both 1:1 and 1:2 with no bar at all. At the full 50 mm only 1:1 fails, since
+ * 0.1 m at 1:2 is exactly 50 mm — so 36 is the binding number, which is what
+ * `scale-bar-ladder.test.ts` asserts against.
+ */
+export const NICE_BAR_LENGTHS_M = [
+    0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000,
+];
+/**
+ * Whether `m` survives the scale bar's label formatting without lying:
+ * whole centimetres below 1 m, whole metres above.
+ */
+export function barLabelIsExact(m) {
+    // States the contract explicitly. The arithmetic below happens to reject all
+    // of these too — -5 fails the `>= 1` floor, NaN and Infinity fail because
+    // `Math.abs(NaN - NaN)` is not `< 1e-9` — so removing this line changes no
+    // test. It is kept as documentation a reader does not have to derive, not as
+    // a load-bearing check.
+    if (!(m > 0) || !Number.isFinite(m))
+        return false;
+    // Symmetric epsilon on both branches. `Number.isInteger` alone is too strict
+    // for the float artefacts the ladder itself carries (`0.02 * 100` is
+    // 2.0000000000000004), and `Math.round(m * 1000) / 10` was too loose in the
+    // other direction: it tolerates ±0.5 mm, so 0.0201 m passed and printed
+    // "2cm" over a bar 0.1 mm longer than that.
+    //
+    // The `>= 1` is what stops a sub-centimetre length passing. Without it,
+    // anything under 0.005 m rounds to zero centimetres, which is an integer, so
+    // it was "exact" — and drew a 0.4 mm bar labelled "0cm". A bar claiming to
+    // span no distance is less honest than no bar.
+    if (m < 1) {
+        const cm = m * 100;
+        return Math.abs(cm - Math.round(cm)) < 1e-9 && Math.round(cm) >= 1;
+    }
+    return Math.abs(m - Math.round(m)) < 1e-9;
+}
+/**
+ * Smallest SEGMENT worth drawing, in millimetres of paper.
+ *
+ * Segment widths are emitted through `toFixed(2)`, so anything under 0.005 mm
+ * prints `width="0.00"` — a label with no bar under it. That is reachable: at
+ * 1:1 on a 760 m model the transform gives 0.42 mm per metre, so a 5 cm bar is
+ * 0.02 mm wide and all five of its segments print zero. The old clamp-to-cell
+ * hid this by always stretching the bar to fill the cell; choosing the distance
+ * first removed that accident, so the floor has to be explicit.
+ *
+ * Deliberately a per-SEGMENT bound rather than a whole-bar one. A blanket bar
+ * minimum of 5 mm rejects a perfectly legible 4 mm bar at 1:500, which is a
+ * real configuration; what actually fails is a segment rounding to zero, and
+ * that is what this measures. 0.01 mm is twice the rounding threshold.
+ *
+ * A correction to an earlier version of this note, because it misattributed
+ * the mechanism: the old `Math.min(barLengthMm, maxBarWidth)` clamp could not
+ * ENLARGE anything. What filled the cell was the reciprocal-units bug — at
+ * 0.42 mm per metre the old formula computed `0.05 * 1000 / 0.42` = 119 mm and
+ * the clamp capped that at 50. So one bug was hiding another, which is why
+ * fixing the arithmetic is what exposed this.
+ */
+export const MIN_BAR_SEGMENT_MM = 0.01;
+/** The end label the scale bar prints for a given distance. */
+export function formatBarLabel(m) {
+    return m < 1 ? `${(m * 100).toFixed(0)}cm` : `${m.toFixed(0)}m`;
+}
 /**
  * Calculate optimal scale bar length based on drawing scale
  * Returns length in model units (meters)
@@ -29,11 +101,7 @@ export function calculateOptimalScaleBarLength(scaleFactor, maxLengthMm) {
     const targetPaperLengthMm = Math.min(80, maxLengthMm * 0.8);
     // Convert paper length to model units (meters)
     const modelLength = (targetPaperLengthMm * scaleFactor) / 1000;
-    // Round to nice numbers for readability
-    const niceNumbers = [
-        0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000,
-    ];
-    for (const n of niceNumbers) {
+    for (const n of NICE_BAR_LENGTHS_M) {
         if (n >= modelLength * 0.5 && n <= modelLength * 1.5) {
             return n;
         }
@@ -60,7 +128,6 @@ export function calculateOptimalDivisions(totalLengthM) {
 export const DEFAULT_NORTH_ARROW = {
     style: 'simple',
     rotation: 0,
-    positionMm: { x: 30, y: 30 },
     sizeMm: 15,
 };
 //# sourceMappingURL=scale-bar-types.js.map

package/dist/sheet/scale-bar-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"scale-bar-types.js","sourceRoot":"","sources":["../../src/sheet/scale-bar-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAoD/D,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,CAAC,EAAE,yCAAyC;IAC1D,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,QAAQ,EAAE,CAAC;IACX,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,WAAmB;IAEnB,2CAA2C;IAC3C,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;IAE5D,+CAA+C;IAC/C,MAAM,WAAW,GAAG,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;IAE/D,wCAAwC;IACxC,MAAM,WAAW,GAAG;QAClB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI;KACxD,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAAoB;IAC5D,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,IAAI,YAAY,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,YAAY,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,CAAC,yBAAyB;AACrC,CAAC;AAiBD,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;IAC5B,MAAM,EAAE,EAAE;CACX,CAAC"}
+{"version":3,"file":"scale-bar-types.js","sourceRoot":"","sources":["../../src/sheet/scale-bar-types.ts"],"names":[],"mappings":"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"}

package/dist/sheet/sheet-types.d.ts

@@ -81,4 +81,57 @@ export declare function calculateDrawingTransform(drawingBounds: {
     translateY: number;
     scaleFactor: number;
 };
+/**
+ * `calculateDrawingTransform` always derives `translateY` assuming the
+ * caller will map model Y to paper Y with a sign flip (`adjustedY = -y`,
+ * matching a plan view drawn with north/Y+ up on paper) — it centers using
+ * `drawingBounds.maxY` for exactly that reason (see the "Flip Y" comment
+ * above).
+ *
+ * Plan ('down') sections do NOT flip Y (see `Drawing2DCanvas.tsx`'s
+ * `flipY = sectionAxis !== 'down'`): they map `adjustedY = y` directly, so
+ * north stays up without a sign flip. Reusing the flipped `translateY`
+ * unmodified in that case still centers the WIDTH but shifts the centered Y
+ * off by `(minY + maxY) * scaleFactor` — the drawing lands off-center on the
+ * sheet, worse the further the section's bounds sit from being symmetric
+ * about Y=0. This offset was found diverging between the sheet PREVIEW
+ * (`Drawing2DCanvas.tsx`, which already carried this correction) and the
+ * sheet PRINT/EXPORT path (`useDrawingExport.ts`'s `generateSheetSVG`, which
+ * did not) — issue #2940.
+ *
+ * Call this instead of `calculateDrawingTransform` directly wherever the
+ * axis's flip behavior is known, so every sheet consumer (screen preview,
+ * print, SVG/PDF export) derives the flip correction from one place rather
+ * than each re-deriving it. Note this function is the geometry only: it
+ * takes no view state, so two callers still agree only insofar as they pass
+ * the same `flipY`/`flipX` AND resolve any cached/pinned placement the same
+ * way. The viewer routes both sheet consumers through one resolver
+ * (`apps/viewer/src/lib/drawing/sheet-transform.ts`) for exactly that
+ * reason.
+ *
+ * `translateX` needs the mirror-image correction, but gated the OPPOSITE
+ * way from `translateY`: `calculateDrawingTransform`'s `translateX` bakes
+ * in the assumption that the caller maps model X to paper X with NO sign
+ * flip (`adjustedX = x`) — unlike `translateY`, which bakes in a flip. So
+ * `translateX` is only wrong when `flipX` is actually true (`adjustedX =
+ * -x`, used for 'side' sections to view from the conventional direction,
+ * see `Drawing2DCanvas.tsx` / `useDrawingExport.ts`'s `flipX = sectionAxis
+ * === 'side'`): flipping negates and reverses the drawing's X extent to
+ * `[-maxX, -minX]`, so the base translate (keyed off `-minX`) shifts the
+ * centered box by `(minX + maxX) * scaleFactor` — the drawing lands off
+ * the left/right edge of the sheet, worse the further the section's bounds
+ * sit from being symmetric about X=0. Confirmed unfixed prior to this
+ * change (issue #2940's X-axis half): a 'side' section with bounds minX=2,
+ * maxX=12 on a 190mm-wide viewport landed 140mm off-center.
+ */
+export declare function calculateDrawingTransformForAxis(drawingBounds: {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}, viewportBounds: ViewportBounds, scale: DrawingScale, flipY: boolean, flipX?: boolean): {
+    translateX: number;
+    translateY: number;
+    scaleFactor: number;
+};
 //# sourceMappingURL=sheet-types.d.ts.map

package/dist/sheet/sheet-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-types.d.ts","sourceRoot":"","sources":["../../src/sheet/sheet-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,6CAA6C;IAC7C,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,kCAAkC;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,8DAA8D;IAC9D,cAAc,EAAE,cAAc,CAAC;IAC/B,uBAAuB;IACvB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,GAC3B,cAAc,CA4ChB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzE,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,YAAY,GAClB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAgCA"}
+{"version":3,"file":"sheet-types.d.ts","sourceRoot":"","sources":["../../src/sheet/sheet-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,6CAA6C;IAC7C,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,kCAAkC;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,8DAA8D;IAC9D,cAAc,EAAE,cAAc,CAAC;IAC/B,uBAAuB;IACvB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,GAC3B,cAAc,CA4ChB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzE,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,YAAY,GAClB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAgCA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzE,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,OAAO,EACd,KAAK,UAAQ,GACZ;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CASA"}

package/dist/sheet/sheet-types.js

@@ -74,4 +74,57 @@ export function calculateDrawingTransform(drawingBounds, viewportBounds, scale)
         drawingBounds.maxY * scaleFactor; // Flip Y
     return { translateX, translateY, scaleFactor };
 }
+/**
+ * `calculateDrawingTransform` always derives `translateY` assuming the
+ * caller will map model Y to paper Y with a sign flip (`adjustedY = -y`,
+ * matching a plan view drawn with north/Y+ up on paper) — it centers using
+ * `drawingBounds.maxY` for exactly that reason (see the "Flip Y" comment
+ * above).
+ *
+ * Plan ('down') sections do NOT flip Y (see `Drawing2DCanvas.tsx`'s
+ * `flipY = sectionAxis !== 'down'`): they map `adjustedY = y` directly, so
+ * north stays up without a sign flip. Reusing the flipped `translateY`
+ * unmodified in that case still centers the WIDTH but shifts the centered Y
+ * off by `(minY + maxY) * scaleFactor` — the drawing lands off-center on the
+ * sheet, worse the further the section's bounds sit from being symmetric
+ * about Y=0. This offset was found diverging between the sheet PREVIEW
+ * (`Drawing2DCanvas.tsx`, which already carried this correction) and the
+ * sheet PRINT/EXPORT path (`useDrawingExport.ts`'s `generateSheetSVG`, which
+ * did not) — issue #2940.
+ *
+ * Call this instead of `calculateDrawingTransform` directly wherever the
+ * axis's flip behavior is known, so every sheet consumer (screen preview,
+ * print, SVG/PDF export) derives the flip correction from one place rather
+ * than each re-deriving it. Note this function is the geometry only: it
+ * takes no view state, so two callers still agree only insofar as they pass
+ * the same `flipY`/`flipX` AND resolve any cached/pinned placement the same
+ * way. The viewer routes both sheet consumers through one resolver
+ * (`apps/viewer/src/lib/drawing/sheet-transform.ts`) for exactly that
+ * reason.
+ *
+ * `translateX` needs the mirror-image correction, but gated the OPPOSITE
+ * way from `translateY`: `calculateDrawingTransform`'s `translateX` bakes
+ * in the assumption that the caller maps model X to paper X with NO sign
+ * flip (`adjustedX = x`) — unlike `translateY`, which bakes in a flip. So
+ * `translateX` is only wrong when `flipX` is actually true (`adjustedX =
+ * -x`, used for 'side' sections to view from the conventional direction,
+ * see `Drawing2DCanvas.tsx` / `useDrawingExport.ts`'s `flipX = sectionAxis
+ * === 'side'`): flipping negates and reverses the drawing's X extent to
+ * `[-maxX, -minX]`, so the base translate (keyed off `-minX`) shifts the
+ * centered box by `(minX + maxX) * scaleFactor` — the drawing lands off
+ * the left/right edge of the sheet, worse the further the section's bounds
+ * sit from being symmetric about X=0. Confirmed unfixed prior to this
+ * change (issue #2940's X-axis half): a 'side' section with bounds minX=2,
+ * maxX=12 on a 190mm-wide viewport landed 140mm off-center.
+ */
+export function calculateDrawingTransformForAxis(drawingBounds, viewportBounds, scale, flipY, flipX = false) {
+    const base = calculateDrawingTransform(drawingBounds, viewportBounds, scale);
+    const translateY = flipY
+        ? base.translateY
+        : base.translateY - (drawingBounds.maxY + drawingBounds.minY) * base.scaleFactor;
+    const translateX = flipX
+        ? base.translateX + (drawingBounds.minX + drawingBounds.maxX) * base.scaleFactor
+        : base.translateX;
+    return { ...base, translateX, translateY };
+}
 //# sourceMappingURL=sheet-types.js.map

package/dist/sheet/sheet-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"sheet-types.js","sourceRoot":"","sources":["../../src/sheet/sheet-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sheet-types.js","sourceRoot":"","sources":["../../src/sheet/sheet-types.ts"],"names":[],"mappings":"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"}

package/dist/sheet/title-block-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title-block-renderer.d.ts","sourceRoot":"","sources":["../../src/sheet/title-block-renderer.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAsB,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,GAAE,aAAa,EAAO,EAC/B,MAAM,CAAC,EAAE,gBAAgB,GACxB,sBAAsB,CAgFxB"}
+{"version":3,"file":"title-block-renderer.d.ts","sourceRoot":"","sources":["../../src/sheet/title-block-renderer.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAsB,MAAM,wBAAwB,CAAC;AAElG,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,GAAE,aAAa,EAAO,EAC/B,MAAM,CAAC,EAAE,gBAAgB,GACxB,sBAAsB,CAgFxB"}

package/dist/sheet/title-block-renderer.js

@@ -1,6 +1,7 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { NICE_BAR_LENGTHS_M, barLabelIsExact, formatBarLabel, MIN_BAR_SEGMENT_MM } from './scale-bar-types.js';
 /**
  * Render a title block to SVG
  */
@@ -257,18 +258,116 @@ function renderRevisionHistory(revisions, x, y, w, h, config) {
  */
 function renderScaleBarInTitleBlock(scaleBar, scale, x, y, w, h, _hasLogo, effectiveScaleFactor) {
     let svg = '    <g id="title-block-scale-bar">\n';
-    // Use effective scale factor if provided (for dynamic scaling), otherwise use configured scale
-    const scaleFactor = effectiveScaleFactor ?? scale.factor;
+    // These two arguments are in RECIPROCAL units, and this function used to
+    // substitute one for the other in a single formula:
+    //
+    //   effectiveScaleFactor  millimetres per metre  (10 at 1:100)
+    //   scale.factor          the N of 1:N           (100 at 1:100)
+    //
+    // `calculateDrawingTransform` returns the former — `sheet-types.ts` uses it
+    // as `drawingWidth * scaleFactor` to get millimetres — its own doc says "mm
+    // per meter", and `useDrawingExport` passes it on EVERY export. So the branch
+    // the exporter always takes was the wrong one, and every exported bar was
+    // labelled wrong at every scale: a 5 m bar read 0.5 m at 1:100, and 0.1 m at
+    // 1:500 where 25 m is right. Normalise to one unit so there is one formula.
+    const mmPerMetre = effectiveScaleFactor ?? 1000 / scale.factor;
     // Position: bottom left with small margin
     const barX = x + 3;
     const barY = y + h - 8; // 8mm from bottom (leaves room for label)
     const maxBarWidth = Math.min(w * 0.3, 50);
-    const barLengthMm = (scaleBar.totalLengthM * 1000) / scaleFactor;
-    const actualBarLength = Math.min(barLengthMm, maxBarWidth);
-    const barHeight = Math.min(scaleBar.heightMm, 3);
-    const actualTotalLength = (actualBarLength * scaleFactor) / 1000;
-    // Draw alternating bar segments
-    const divisions = scaleBar.primaryDivisions;
+    const barLengthMm = scaleBar.totalLengthM * mmPerMetre;
+    // Checked BEFORE the clamp, and the ordering is load-bearing: testing the
+    // clamped result loses the infinite case, because `Math.min(Infinity, 50)`
+    // is a perfectly finite 50.
+    //
+    // `mmPerMetre > 0` is checked SEPARATELY and is not redundant with
+    // `barLengthMm > 0`. An earlier version claimed one check on the product
+    // covered "any combination" of the two operands. It does not: two negatives
+    // cancel, so `totalLengthM: -5` with `effectiveScaleFactor: -10` gives
+    // `barLengthMm` 50 and passes every clause, after which the labels print
+    // NEGATIVE distances on a bar that draws normally. That is worse than the
+    // malformed rect this guard was written to stop, because nothing about the
+    // output looks wrong. Credit to CodeRabbit for the case and to
+    // @bimvoice-01 for relaying it.
+    //
+    // Deliberately not recording which of the sign checks in this file is
+    // load-bearing. Three versions of this paragraph did — "the snap masks
+    // this", then "this is load-bearing", then "three things reject it" — and
+    // each was a correct measurement made false by the next commit, twice by my
+    // own hand within one session and once by a revert. A mutation result is a
+    // fact about the whole program, so anything anywhere invalidates it, while
+    // it reads like a durable property. The commit message is where such a
+    // measurement belongs, pinned to a tree.
+    //
+    // Without this the bar emitted `<rect width="-10.00">`, invalid SVG dressed
+    // as a drawing. Drawing nothing is the honest degradation: a missing scale
+    // bar is visibly missing.
+    if (!(mmPerMetre > 0) ||
+        !(barLengthMm > 0) ||
+        !Number.isFinite(barLengthMm) ||
+        !(maxBarWidth > 0)) {
+        return '';
+    }
+    // Snap to a ROUND distance that fits, rather than clamping to the cell width
+    // and rounding the label afterwards. Folding the clamp into the label is not
+    // enough on its own: the label prints to 0 dp, so a 120 mm title block (a
+    // shipped preset) caps a 5 m bar at 36 mm = 3.6 m and prints "4m" — 11% off
+    // on a printed sheet, and up to ~33% for a bar landing near 1.5 m.
+    //
+    // Choosing the distance first makes the label exact by construction.
+    //
+    // It does NOT yet make the export agree with the on-screen preview, and an
+    // earlier version of this comment claimed it did. Measured over nine common
+    // (block width x scale) pairs with the default 5 m bar, six disagree:
+    // `Drawing2DCanvas` halves/doubles from the configured length, clamps to the
+    // cell, and rounds the label from the clamped value — the same clamp-then-
+    // round shape this function just stopped doing, so at a 120 mm block and
+    // 1:100 the preview still prints "3m" over a 2.5 m bar while the export
+    // prints an exact "2m". Unifying them means moving the preview onto
+    // `NICE_BAR_LENGTHS_M` too, which is a viewer change and not this diff.
+    // `divisions`, bounded at BOTH ends. The low end stops 0 dividing and 2.5 drawing three
+    // segments of width L/2.5 (the loop runs while `i < 2.5`), overflowing the
+    // bar by 20%. The high end matters too: 100000 divisions emits an 11.5 MB
+    // group of 0.0005 mm rects, and 1e7 is about a gigabyte — it hangs the export
+    // rather than drawing a bad bar. Nothing legible needs more than 20.
+    const divisions = Number.isFinite(scaleBar.primaryDivisions)
+        ? Math.min(20, Math.max(1, Math.floor(scaleBar.primaryDivisions)))
+        : 1;
+    const requestedM = scaleBar.totalLengthM;
+    // Fits the cell AND draws segments that survive `toFixed(2)`. Without the
+    // lower bound a bar can be chosen whose segments all print `width="0.00"`
+    // under a confident label — a label with no bar, which is the dishonesty
+    // this function refuses everywhere else. Reachable at 1:1 on a large model,
+    // where the transform gives well under 1 mm per metre.
+    const fits = (m) => m * mmPerMetre <= maxBarWidth + 1e-9 &&
+        (m * mmPerMetre) / divisions >= MIN_BAR_SEGMENT_MM - 1e-12;
+    // Keep the requested length when it already fits AND already labels exactly.
+    // Snapping unconditionally shrank bars that were fine: a 4 m bar at 1:100 is
+    // 40 mm in a 50 mm cell and prints "4m" exactly, and snapping it to the
+    // nearest ladder value below halved it to 2 m for no reason.
+    let actualTotalLength = fits(requestedM) && barLabelIsExact(requestedM)
+        ? requestedM
+        : undefined;
+    if (actualTotalLength === undefined) {
+        // Otherwise take the largest round distance that fits and does not claim
+        // more than was asked for.
+        const candidates = NICE_BAR_LENGTHS_M.filter((m) => m <= requestedM + 1e-9 && fits(m));
+        actualTotalLength = candidates[candidates.length - 1];
+    }
+    if (actualTotalLength === undefined) {
+        // Not even the smallest round distance fits the cell. A missing bar is
+        // visibly missing; a bar labelled with a distance it does not span is not.
+        return '';
+    }
+    const actualBarLength = actualTotalLength * mmPerMetre;
+    // `heightMm` reaches the emitted `height=` attribute, so it needs the same
+    // treatment as the length: NaN printed `height="NaN"` on every rect and
+    // `y="NaN"` on both labels, and a negative printed `height="-5.00"`. Guarding
+    // one of two attributes that reach the SVG is not guarding.
+    const barHeight = Number.isFinite(scaleBar.heightMm)
+        ? Math.min(Math.max(scaleBar.heightMm, 0.1), 3)
+        : 3;
+    // Draw alternating bar segments; `divisions` was normalised above.
     const divWidth = actualBarLength / divisions;
     for (let i = 0; i < divisions; i++) {
         const segX = barX + i * divWidth;
@@ -283,9 +382,10 @@ function renderScaleBarInTitleBlock(scaleBar, scale, x, y, w, h, _hasLogo, effec
     svg += `      <text x="${barX.toFixed(2)}" y="${labelY.toFixed(2)}" `;
     svg += `font-family="Arial, sans-serif" font-size="${fontSize}" `;
     svg += `text-anchor="start" fill="#000000">0</text>\n`;
-    const endLabel = actualTotalLength < 1
-        ? `${(actualTotalLength * 100).toFixed(0)}cm`
-        : `${actualTotalLength.toFixed(0)}m`;
+    // Shared with `barLabelIsExact`, which decides whether a length CAN be
+    // printed without lying. Those two have to agree, and an inline copy here is
+    // exactly how they would stop agreeing.
+    const endLabel = formatBarLabel(actualTotalLength);
     svg += `      <text x="${(barX + actualBarLength).toFixed(2)}" y="${labelY.toFixed(2)}" `;
     svg += `font-family="Arial, sans-serif" font-size="${fontSize}" `;
     svg += `text-anchor="end" fill="#000000">${endLabel}</text>\n`;