@mlightcad/data-model 1.7.34 → 1.7.36

package/lib/database/AcDbSystemVariables.js

@@ -15,24 +15,26 @@ export var AcDbSystemVariables = {
     ANGDIR: 'ANGDIR',
     /** Angular unit display mode, such as decimal degrees or degrees/minutes/seconds. */
     AUNITS: 'AUNITS',
+    /** Number of decimal places (or display precision) for angular values; used together with AUNITS. */
+    AUPREC: 'AUPREC',
     /** Current color applied to newly created entities. */
     CECOLOR: 'CECOLOR',
-    /** Current linetype name used when creating new entities. */
-    CELTYPE: 'CELTYPE',
     /** Current entity linetype scale multiplier for newly created entities. */
     CELTSCALE: 'CELTSCALE',
+    /** Current linetype name used when creating new entities. */
+    CELTYPE: 'CELTYPE',
     /** Current lineweight applied to newly created entities. */
     CELWEIGHT: 'CELWEIGHT',
     /** Current transparency level for newly created entities. */
     CETRANSPARENCY: 'CETRANSPARENCY',
     /** Current layer name used when creating new entities. */
     CLAYER: 'CLAYER',
-    /** Current multiline style name used when creating new MLINE entities. */
-    CMLSTYLE: 'CMLSTYLE',
-    /** Current multiline scale used when creating new MLINE entities. */
-    CMLSCALE: 'CMLSCALE',
     /** Current multileader style name used when creating new MLEADER entities. */
     CMLEADERSTYLE: 'CMLEADERSTYLE',
+    /** Current multiline scale used when creating new MLINE entities. */
+    CMLSCALE: 'CMLSCALE',
+    /** Current multiline style name used when creating new MLINE entities. */
+    CMLSTYLE: 'CMLSTYLE',
     /** UI color theme selector used by the application shell or viewer integration. */
     COLORTHEME: 'COLORTHEME',
     /**
@@ -46,10 +48,10 @@ export var AcDbSystemVariables = {
     EXTMAX: 'EXTMAX',
     /** Lower-left corner of the model-space drawing extents. */
     EXTMIN: 'EXTMIN',
-    /** Controls whether newly created hatches are associative. */
-    HPASSOC: 'HPASSOC',
     /** Default angle, in radians, for newly created hatch patterns. */
     HPANG: 'HPANG',
+    /** Controls whether newly created hatches are associative. */
+    HPASSOC: 'HPASSOC',
     /** Default background color for newly created hatch patterns. */
     HPBACKGROUNDCOLOR: 'HPBACKGROUNDCOLOR',
     /** Default color for newly created hatches. */
@@ -72,8 +74,17 @@ export var AcDbSystemVariables = {
     INSUNITS: 'INSUNITS',
     /** Global linetype scale multiplier for the drawing database. */
     LTSCALE: 'LTSCALE',
+    /** Linear unit display format for coordinates and distances (scientific, decimal, engineering, etc.). */
+    LUNITS: 'LUNITS',
+    /** Decimal places (or display precision) for linear values; used together with LUNITS. */
+    LUPREC: 'LUPREC',
     /** Flag indicating whether lineweights are displayed in the editor/viewer. */
     LWDISPLAY: 'LWDISPLAY',
+    /**
+     * Legacy drawing measurement system: `0` = English (imperial), `1` = metric.
+     * Used with unitless **INSUNITS** to choose default unit labeling.
+     */
+    MEASUREMENT: 'MEASUREMENT',
     /** Color used for measurement tool overlays (distance, area, arc). */
     MEASUREMENTCOLOR: 'MEASUREMENTCOLOR',
     /** Running object snap mode bitmask (OSNAP settings). */
@@ -88,6 +99,11 @@ export var AcDbSystemVariables = {
     SHORTCUTMENU: 'SHORTCUTMENU',
     /** Current text style name used when creating new text entities. */
     TEXTSTYLE: 'TEXTSTYLE',
+    /**
+     * Controls feet-inch and fractional display delimiters together with **LUNITS**
+     * (`0` = report format, `1` = input format).
+     */
+    UNITMODE: 'UNITMODE',
     /** Flag indicating whether the drawing background should be rendered as white. */
     WHITEBKCOLOR: 'WHITEBKCOLOR'
 };

package/lib/database/AcDbSystemVariables.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbSystemVariables.js","sourceRoot":"","sources":["../../src/database/AcDbSystemVariables.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG;IACjC,wDAAwD;IACxD,OAAO,EAAE,SAAS;IAClB,mFAAmF;IACnF,OAAO,EAAE,SAAS;IAClB,kFAAkF;IAClF,MAAM,EAAE,QAAQ;IAChB,qFAAqF;IACrF,MAAM,EAAE,QAAQ;IAChB,uDAAuD;IACvD,OAAO,EAAE,SAAS;IAClB,6DAA6D;IAC7D,OAAO,EAAE,SAAS;IAClB,2EAA2E;IAC3E,SAAS,EAAE,WAAW;IACtB,4DAA4D;IAC5D,SAAS,EAAE,WAAW;IACtB,6DAA6D;IAC7D,cAAc,EAAE,gBAAgB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,QAAQ;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,UAAU;IACpB,qEAAqE;IACrE,QAAQ,EAAE,UAAU;IACpB,8EAA8E;IAC9E,aAAa,EAAE,eAAe;IAC9B,mFAAmF;IACnF,UAAU,EAAE,YAAY;IACxB;;;OAGG;IACH,OAAO,EAAE,SAAS;IAClB,6DAA6D;IAC7D,SAAS,EAAE,WAAW;IACtB,6DAA6D;IAC7D,MAAM,EAAE,QAAQ;IAChB,4DAA4D;IAC5D,MAAM,EAAE,QAAQ;IAChB,8DAA8D;IAC9D,OAAO,EAAE,SAAS;IAClB,mEAAmE;IACnE,KAAK,EAAE,OAAO;IACd,iEAAiE;IACjE,iBAAiB,EAAE,mBAAmB;IACtC,+CAA+C;IAC/C,OAAO,EAAE,SAAS;IAClB,gEAAgE;IAChE,QAAQ,EAAE,UAAU;IACpB,8EAA8E;IAC9E,iBAAiB,EAAE,mBAAmB;IACtC,yDAAyD;IACzD,OAAO,EAAE,SAAS;IAClB,sEAAsE;IACtE,MAAM,EAAE,QAAQ;IAChB,6DAA6D;IAC7D,OAAO,EAAE,SAAS;IAClB,0FAA0F;IAC1F,UAAU,EAAE,YAAY;IACxB,gEAAgE;IAChE,cAAc,EAAE,gBAAgB;IAChC,sEAAsE;IACtE,QAAQ,EAAE,UAAU;IACpB,iEAAiE;IACjE,OAAO,EAAE,SAAS;IAClB,8EAA8E;IAC9E,SAAS,EAAE,WAAW;IACtB,sEAAsE;IACtE,gBAAgB,EAAE,kBAAkB;IACpC,yDAAyD;IACzD,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,MAAM,EAAE,QAAQ;IAChB,iFAAiF;IACjF,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,OAAO,EAAE,SAAS;IAClB,yGAAyG;IACzG,YAAY,EAAE,cAAc;IAC5B,oEAAoE;IACpE,SAAS,EAAE,WAAW;IACtB,kFAAkF;IAClF,YAAY,EAAE,cAAc;CACpB,CAAA;AAUV;;;;GAIG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CACtD,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CACnC,CAAA"}
+{"version":3,"file":"AcDbSystemVariables.js","sourceRoot":"","sources":["../../src/database/AcDbSystemVariables.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG;IACjC,wDAAwD;IACxD,OAAO,EAAE,SAAS;IAClB,mFAAmF;IACnF,OAAO,EAAE,SAAS;IAClB,kFAAkF;IAClF,MAAM,EAAE,QAAQ;IAChB,qFAAqF;IACrF,MAAM,EAAE,QAAQ;IAChB,qGAAqG;IACrG,MAAM,EAAE,QAAQ;IAChB,uDAAuD;IACvD,OAAO,EAAE,SAAS;IAClB,2EAA2E;IAC3E,SAAS,EAAE,WAAW;IACtB,6DAA6D;IAC7D,OAAO,EAAE,SAAS;IAClB,4DAA4D;IAC5D,SAAS,EAAE,WAAW;IACtB,6DAA6D;IAC7D,cAAc,EAAE,gBAAgB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,aAAa,EAAE,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,EAAE,UAAU;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,UAAU;IACpB,mFAAmF;IACnF,UAAU,EAAE,YAAY;IACxB;;;OAGG;IACH,OAAO,EAAE,SAAS;IAClB,6DAA6D;IAC7D,SAAS,EAAE,WAAW;IACtB,6DAA6D;IAC7D,MAAM,EAAE,QAAQ;IAChB,4DAA4D;IAC5D,MAAM,EAAE,QAAQ;IAChB,mEAAmE;IACnE,KAAK,EAAE,OAAO;IACd,8DAA8D;IAC9D,OAAO,EAAE,SAAS;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,mBAAmB;IACtC,+CAA+C;IAC/C,OAAO,EAAE,SAAS;IAClB,gEAAgE;IAChE,QAAQ,EAAE,UAAU;IACpB,8EAA8E;IAC9E,iBAAiB,EAAE,mBAAmB;IACtC,yDAAyD;IACzD,OAAO,EAAE,SAAS;IAClB,sEAAsE;IACtE,MAAM,EAAE,QAAQ;IAChB,6DAA6D;IAC7D,OAAO,EAAE,SAAS;IAClB,0FAA0F;IAC1F,UAAU,EAAE,YAAY;IACxB,gEAAgE;IAChE,cAAc,EAAE,gBAAgB;IAChC,sEAAsE;IACtE,QAAQ,EAAE,UAAU;IACpB,iEAAiE;IACjE,OAAO,EAAE,SAAS;IAClB,yGAAyG;IACzG,MAAM,EAAE,QAAQ;IAChB,0FAA0F;IAC1F,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,SAAS,EAAE,WAAW;IACtB;;;OAGG;IACH,WAAW,EAAE,aAAa;IAC1B,sEAAsE;IACtE,gBAAgB,EAAE,kBAAkB;IACpC,yDAAyD;IACzD,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,MAAM,EAAE,QAAQ;IAChB,iFAAiF;IACjF,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,OAAO,EAAE,SAAS;IAClB,yGAAyG;IACzG,YAAY,EAAE,cAAc;IAC5B,oEAAoE;IACpE,SAAS,EAAE,WAAW;IACtB;;;OAGG;IACH,QAAQ,EAAE,UAAU;IACpB,kFAAkF;IAClF,YAAY,EAAE,cAAc;CACpB,CAAA;AAUV;;;;GAIG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CACtD,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CACnC,CAAA"}

package/lib/misc/AcDbConstants.d.ts

@@ -69,4 +69,30 @@ export declare const MLIGHTCAD_APPID = "mlightcad";
  * Built-in AutoCAD application ID used for standard XData registration.
  */
 export declare const ACAD_APPID = "ACAD";
+/**
+ * Frozen 2D/3D placeholders when a VPORT table row omits geometry (partial DXF
+ * groups, incomplete DWG decode). Used before `AcGePoint2d.copy` / `AcGePoint3d.copy`.
+ */
+export declare const VPORT_FALLBACK_CENTER_2D: Readonly<{
+    x: 0;
+    y: 0;
+}>;
+export declare const VPORT_FALLBACK_LLC: Readonly<{
+    x: 0;
+    y: 0;
+}>;
+export declare const VPORT_FALLBACK_URC: Readonly<{
+    x: 1;
+    y: 1;
+}>;
+export declare const VPORT_FALLBACK_VIEW_DIR: Readonly<{
+    x: 0;
+    y: 0;
+    z: 1;
+}>;
+export declare const VPORT_FALLBACK_VIEW_TARGET: Readonly<{
+    x: 0;
+    y: 0;
+    z: 0;
+}>;
 //# sourceMappingURL=AcDbConstants.d.ts.map

package/lib/misc/AcDbConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbConstants.d.ts","sourceRoot":"","sources":["../../src/misc/AcDbConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,eAAe,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,aAAa,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,8BAA8B,WAAW,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,4BAA4B,UAAU,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAA;AAExC;;GAEG;AACH,eAAO,MAAM,2BAA2B,WAAW,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,YAAY,CAAA;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,YAAY,CAAA;AAEhC;;GAEG;AACH,eAAO,MAAM,eAAe,cAAc,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,UAAU,SAAS,CAAA"}
+{"version":3,"file":"AcDbConstants.d.ts","sourceRoot":"","sources":["../../src/misc/AcDbConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,eAAe,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,aAAa,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,8BAA8B,WAAW,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,4BAA4B,UAAU,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAA;AAExC;;GAEG;AACH,eAAO,MAAM,2BAA2B,WAAW,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,YAAY,CAAA;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,YAAY,CAAA;AAEhC;;GAEG;AACH,eAAO,MAAM,eAAe,cAAc,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,UAAU,SAAS,CAAA;AAEhC;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;EAAgC,CAAA;AACrE,eAAO,MAAM,kBAAkB;;;EAAgC,CAAA;AAC/D,eAAO,MAAM,kBAAkB;;;EAAgC,CAAA;AAC/D,eAAO,MAAM,uBAAuB;;;;EAAsC,CAAA;AAC1E,eAAO,MAAM,0BAA0B;;;;EAAsC,CAAA"}

package/lib/misc/AcDbConstants.js

@@ -69,4 +69,13 @@ export var MLIGHTCAD_APPID = 'mlightcad';
  * Built-in AutoCAD application ID used for standard XData registration.
  */
 export var ACAD_APPID = 'ACAD';
+/**
+ * Frozen 2D/3D placeholders when a VPORT table row omits geometry (partial DXF
+ * groups, incomplete DWG decode). Used before `AcGePoint2d.copy` / `AcGePoint3d.copy`.
+ */
+export var VPORT_FALLBACK_CENTER_2D = Object.freeze({ x: 0, y: 0 });
+export var VPORT_FALLBACK_LLC = Object.freeze({ x: 0, y: 0 });
+export var VPORT_FALLBACK_URC = Object.freeze({ x: 1, y: 1 });
+export var VPORT_FALLBACK_VIEW_DIR = Object.freeze({ x: 0, y: 0, z: 1 });
+export var VPORT_FALLBACK_VIEW_TARGET = Object.freeze({ x: 0, y: 0, z: 0 });
 //# sourceMappingURL=AcDbConstants.js.map

package/lib/misc/AcDbConstants.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbConstants.js","sourceRoot":"","sources":["../../src/misc/AcDbConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,IAAM,iBAAiB,GAAG,YAAY,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,IAAM,kBAAkB,GAAG,UAAU,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG,UAAU,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,IAAM,qBAAqB,GAAG,UAAU,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,IAAM,8BAA8B,GAAG,QAAQ,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,IAAM,4BAA4B,GAAG,OAAO,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG,OAAO,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,IAAM,kBAAkB,GAAG,MAAM,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG,QAAQ,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,IAAM,OAAO,GAAG,SAAS,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,CAAC,IAAM,OAAO,GAAG,SAAS,CAAA;AAEhC;;GAEG;AACH,MAAM,CAAC,IAAM,eAAe,GAAG,WAAW,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,IAAM,UAAU,GAAG,MAAM,CAAA"}
+{"version":3,"file":"AcDbConstants.js","sourceRoot":"","sources":["../../src/misc/AcDbConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,IAAM,iBAAiB,GAAG,YAAY,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,IAAM,kBAAkB,GAAG,UAAU,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG,UAAU,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,IAAM,qBAAqB,GAAG,UAAU,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,IAAM,8BAA8B,GAAG,QAAQ,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,IAAM,4BAA4B,GAAG,OAAO,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG,OAAO,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,IAAM,kBAAkB,GAAG,MAAM,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG,QAAQ,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,IAAM,OAAO,GAAG,SAAS,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,CAAC,IAAM,OAAO,GAAG,SAAS,CAAA;AAEhC;;GAEG;AACH,MAAM,CAAC,IAAM,eAAe,GAAG,WAAW,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,IAAM,UAAU,GAAG,MAAM,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,IAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACrE,MAAM,CAAC,IAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AAC/D,MAAM,CAAC,IAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AAC/D,MAAM,CAAC,IAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AAC1E,MAAM,CAAC,IAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA"}

package/lib/misc/AcDbFormatter.d.ts

@@ -0,0 +1,215 @@
+import { AcGePoint2d, AcGePoint3d } from '@mlightcad/geometry-engine';
+import { AcDbDatabase } from '../database/AcDbDatabase';
+/**
+ * Per-call options for {@link AcDbFormatter} methods.
+ *
+ * These options layer on top of the drawing system variables held by the bound
+ * {@link AcDbDatabase}; they do not change the database itself.
+ */
+export interface AcDbFormatterOptions {
+    /**
+     * Whether to append real-world unit suffixes to formatted values.
+     *
+     * When `true`:
+     * - Decimal/scientific/fractional linear values may receive a suffix derived from
+     *   {@link AcDbDatabase.insunits | INSUNITS} (or {@link AcDbDatabase.measurement | MEASUREMENT}
+     *   when **INSUNITS** is unitless), for example `12.35 mm` or `10"`.
+     * - Angles may receive `°`, `g`, `rad`, or inch marks in DMS/surveyor formats.
+     * - Engineering and architectural lengths already embed `'` / `"` in the **LUNITS** pattern;
+     *   this flag mainly adds the inch quote for those modes when appropriate.
+     *
+     * When `false` (default), only the numeric pattern dictated by **LUNITS** / **AUNITS** is
+     * returned (for example `12.35`, `1'-3 1/2`, `45d30'15"`).
+     */
+    showUnits?: boolean;
+    /**
+     * Whether to prefix the formatted value with `~ ` when display precision rounds the input.
+     *
+     * When `true`, values that are not exactly representable at the current **LUPREC** / **AUPREC**
+     * (or fractional denominator for architectural modes) are returned as `~ ${formatted}` — for
+     * example `~ 12.35` instead of `12.35` for `12.3456` with two decimal places.
+     *
+     * When `false` (default), no approximate prefix is added.
+     */
+    showApproximate?: boolean;
+    /**
+     * Whether to apply {@link AcDbDatabase.angbase | ANGBASE} and
+     * {@link AcDbDatabase.angdir | ANGDIR} before formatting an angle.
+     *
+     * When `true` (default), the input is treated as an absolute WCS angle (counterclockwise
+     * from +X before adjustment), matching status-bar bearing-style display.
+     *
+     * When `false`, the input radians are formatted directly (after normalization to
+     * \([0, 2\pi)\)), for included angles, relative rotations, rubber-band sweep angles,
+     * and dynamic-input relative angle values.
+     */
+    applyAngbaseAngdir?: boolean;
+}
+/**
+ * Formats linear distances, point coordinates, and angles for display in the UI,
+ * matching AutoCAD drawing-unit behavior as closely as the supported system variables allow.
+ *
+ * An instance is bound to one {@link AcDbDatabase}. On each call it reads the current values of
+ * the relevant header/system variables from that database (not a snapshot taken at construction).
+ *
+ * ### Linear distances and coordinates
+ *
+ * | Variable | Role |
+ * |----------|------|
+ * | **LUNITS** | Display format (scientific, decimal, engineering, …); see {@link AcDbDatabase.lunits} |
+ * | **LUPREC** | Precision (decimal places or fractional denominator); see {@link AcDbDatabase.luprec} |
+ * | **INSUNITS** | Unit suffix when {@link AcDbFormatterOptions.showUnits} is `true`; see {@link AcDbDatabase.insunits} |
+ * | **UNITMODE** | Report vs input delimiters for feet-inch and fractions; see {@link AcDbDatabase.unitmode} |
+ * | **MEASUREMENT** | Imperial vs metric suffix when **INSUNITS** is unitless; see {@link AcDbDatabase.measurement} |
+ *
+ * Engineering (**LUNITS** = 3) and architectural (**LUNITS** = 4) formats treat the numeric
+ * value as **inches**, consistent with AutoCAD.
+ *
+ * ### Angles
+ *
+ * Input angles are **radians in WCS**. Before formatting, the value is adjusted by
+ * {@link AcDbDatabase.angbase | ANGBASE} and {@link AcDbDatabase.angdir | ANGDIR}, then converted
+ * per {@link AcDbDatabase.aunits | AUNITS} and {@link AcDbDatabase.auprec | AUPREC}.
+ *
+ * ### Out of scope
+ *
+ * Dimension entity text uses per-style **DIM\*** variables (for example **DIMLUNIT**, **DIMDEC**),
+ * not this class. **SNAPANG** and UCS settings affect snapping/input, not WCS coordinate strings here.
+ *
+ * @example
+ * ```typescript
+ * database.lunits = AcDbLinearUnits.Decimal;
+ * database.luprec = 2;
+ *
+ * database.formatter.formatLength(12.3456); // "12.35"
+ * database.formatter.formatLength(12.3456, { showUnits: true }); // "12.35 mm" (with INSUNITS = mm)
+ * database.formatter.formatPoint2d(new AcGePoint2d(1, 2)); // "1, 2"
+ * database.formatter.formatAngle(Math.PI / 4, { showUnits: true }); // "45°"
+ * ```
+ */
+export declare class AcDbFormatter {
+    private readonly database;
+    /**
+     * Creates a formatter that reads unit settings from the given database.
+     *
+     * @param database - Drawing database whose **LUNITS**, **AUNITS**, and related variables
+     *   are consulted on every format call.
+     */
+    constructor(database: AcDbDatabase);
+    /**
+     * Formats a single linear distance in **drawing units**.
+     *
+     * The output pattern follows {@link AcDbDatabase.lunits | LUNITS} and
+     * {@link AcDbDatabase.luprec | LUPREC}. When {@link AcDbFormatterOptions.showUnits} is `true`,
+     * a suffix may be appended based on {@link AcDbDatabase.insunits | INSUNITS} and
+     * {@link AcDbDatabase.measurement | MEASUREMENT}.
+     *
+     * | **LUNITS** | Typical output (no unit suffix) |
+     * |-----------:|--------------------------------|
+     * | `1` Scientific | `1.23E+02` |
+     * | `2` Decimal | `12.35` |
+     * | `3` Engineering | `1'-3.5` (value interpreted as inches) |
+     * | `4` Architectural | `1'-3 1/2` |
+     * | `5` Fractional | `15 1/2` |
+     * | `6` Windows desktop | Same as decimal |
+     *
+     * {@link AcDbDatabase.unitmode | UNITMODE} changes delimiters for engineering, architectural,
+     * and fractional modes (for example `1'3-1/2` when **UNITMODE** = 1).
+     *
+     * @param value - Distance in drawing units (WCS length, not pre-converted to feet or degrees).
+     * @param options - Optional display flags; see {@link AcDbFormatterOptions}.
+     * @returns Formatted string suitable for status bars, measurement overlays, or tooltips.
+     *
+     * @remarks
+     * Non-finite values (`NaN`, `±Infinity`) are formatted as `"0"`.
+     *
+     * @example
+     * ```typescript
+     * database.lunits = AcDbLinearUnits.Architectural;
+     * database.luprec = 2;
+     * formatter.formatLength(15.5); // "1'-3 1/2"
+     * ```
+     */
+    formatLength(value: number, options?: AcDbFormatterOptions): string;
+    /**
+     * Formats a 2D point as `"x, y"`, formatting each component with {@link formatLength}.
+     *
+     * Both coordinates use the same {@link AcDbDatabase.lunits | LUNITS} / **LUPREC** rules and the
+     * same {@link AcDbFormatterOptions} for the call. The separator is a comma followed by a space
+     * (`, `), which matches common Cartesian display in measurement UIs.
+     *
+     * @param point - Point in drawing units (WCS **x** / **y**).
+     * @param options - Optional display flags applied to each coordinate.
+     * @returns Formatted coordinate pair, for example `"1.2, 4.6"` or `"1'-0, 2'-6"` depending on **LUNITS**.
+     *
+     * @example
+     * ```typescript
+     * database.lunits = AcDbLinearUnits.Decimal;
+     * database.luprec = 1;
+     * formatter.formatPoint2d(new AcGePoint2d(1.23, 4.56)); // "1.2, 4.6"
+     * ```
+     */
+    formatPoint2d(point: AcGePoint2d, options?: AcDbFormatterOptions): string;
+    /**
+     * Formats a 3D point as `"x, y, z"`, formatting each component with {@link formatLength}.
+     *
+     * Behavior is the same as {@link formatPoint2d} for **x** and **y**, with **z** appended using
+     * the same linear formatting and options.
+     *
+     * @param point - Point in drawing units (WCS **x** / **y** / **z**).
+     * @param options - Optional display flags applied to each coordinate.
+     * @returns Formatted coordinate triple, for example `"1.2, 4.6, 7.9"`.
+     *
+     * @example
+     * ```typescript
+     * formatter.formatPoint3d(new AcGePoint3d(1, 2, 3)); // "1, 2, 3" (with default decimal LUNITS)
+     * ```
+     */
+    formatPoint3d(point: AcGePoint3d, options?: AcDbFormatterOptions): string;
+    /**
+     * Formats an angle given in **radians** (WCS), for display according to the drawing angle units.
+     *
+     * Processing order:
+     * 1. Subtract {@link AcDbDatabase.angbase | ANGBASE} (zero direction).
+     * 2. Negate if {@link AcDbDatabase.angdir | ANGDIR} = 1 (clockwise positive).
+     * 3. Normalize to \([0, 2\pi)\) via {@link AcGeMathUtil.normalizeAngle}.
+     * 4. Format using {@link AcDbDatabase.aunits | AUNITS} and {@link AcDbDatabase.auprec | AUPREC}.
+     *
+     * | **AUNITS** | Typical output (no unit suffix) |
+     * |-----------:|--------------------------------|
+     * | `0` Decimal degrees | `45` or `45.5` |
+     * | `1` Degrees/minutes/seconds | `45d30'15"` |
+     * | `2` Gradians | `50` |
+     * | `3` Radians | `0.785` |
+     * | `4` Surveyor's | `N 45d30'15" E` |
+     *
+     * @param radians - Angle in radians. When {@link AcDbFormatterOptions.applyAngbaseAngdir} is
+     *   `true` (default), this is an absolute WCS angle (counterclockwise from +X before
+     *   **ANGBASE** / **ANGDIR** adjustment). When `false`, this is the scalar angle to display.
+     * @param options - Optional display flags; when {@link AcDbFormatterOptions.showUnits} is `true`,
+     *   unit markers such as `°`, `g`, or `rad` may be appended.
+     * @returns Formatted angle string.
+     *
+     * @remarks
+     * For included or relative angles, pass {@link AcDbFormatterOptions.applyAngbaseAngdir} = `false`.
+     * For arc sweep or dimension overrides, supply the appropriate radians value and flags.
+     *
+     * @example
+     * ```typescript
+     * database.aunits = AcDbAngleUnits.DecimalDegrees;
+     * database.auprec = 0;
+     * formatter.formatAngle(Math.PI / 4); // "45"
+     * formatter.formatAngle(Math.PI / 4, { showUnits: true }); // "45°"
+     * ```
+     */
+    formatAngle(radians: number, options?: AcDbFormatterOptions): string;
+    /**
+     * Builds the formatting context from the bound database and call options.
+     *
+     * @param options - Per-call overrides; omitted fields use database defaults.
+     * @returns Snapshot of linear and angular unit settings for one format call.
+     * @internal
+     */
+    private createContext;
+}
+//# sourceMappingURL=AcDbFormatter.d.ts.map

package/lib/misc/AcDbFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbFormatter.d.ts","sourceRoot":"","sources":["../../src/misc/AcDbFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,WAAW,EACZ,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AASvD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,aAAa;IAOZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC;;;;;OAKG;gBAC0B,QAAQ,EAAE,YAAY;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAKnE;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAKzE;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAKzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAapE;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAatB"}