@linkiez/dxf-renew 7.0.0 → 7.2.0

package/src/handlers/tables.ts

@@ -1,4 +1,16 @@
-import type { DXFTuple, DimStyleInternal, LTypeElement, LTypeInternal, LayerInternal, StyleInternal, VPortInternal } from '../types'
+import type {
+  AppIdInternal,
+  BlockRecordInternal,
+  DXFTuple,
+  DimStyleInternal,
+  LTypeElement,
+  LTypeInternal,
+  LayerInternal,
+  StyleInternal,
+  UcsInternal,
+  VPortInternal,
+  ViewInternal,
+} from '../types'
 
 import logger from '../util/logger'
 
@@ -6,7 +18,7 @@ const ltypeHandler = (tuples: DXFTuple[]): LTypeInternal => {
   let element: LTypeElement | undefined
   let offset: { x: string | number; y: string | number } | undefined
   return tuples.reduce(
-    (layer, tuple) => {
+    (layer, tuple) => { // NOSONAR
       const type = tuple[0]
       const value = tuple[1]
       // https://documentation.help/AutoCAD-DXF/WS1a9193826455f5ff18cb41610ec0a2e719-7a4f.htm
@@ -172,7 +184,7 @@ const vPortHandler = (tuples: DXFTuple[]): VPortInternal => {
     (vport, tuple) => {
       const type = tuple[0]
       const value = tuple[1]
-      switch (type) {
+      switch (type) { // NOSONAR
         case 2:
           vport.name = value
           break
@@ -287,12 +299,100 @@ const vPortHandler = (tuples: DXFTuple[]): VPortInternal => {
   )
 }
 
+const appIdHandler = (tuples: DXFTuple[]): AppIdInternal => {
+  return tuples.reduce(
+    (appId, tuple) => {
+      const type = tuple[0]
+      const value = tuple[1]
+
+      switch (type) {
+        case 2:
+          appId.name = value
+          break
+        case 70:
+          appId.flags = value
+          break
+        default:
+      }
+
+      return appId
+    },
+    { type: 'APPID' } as AppIdInternal,
+  )
+}
+
+const blockRecordHandler = (tuples: DXFTuple[]): BlockRecordInternal => {
+  return tuples.reduce(
+    (blockRecord, tuple) => {
+      const type = tuple[0]
+      const value = tuple[1]
+
+      switch (type) {
+        case 2:
+          blockRecord.name = value
+          break
+        case 70:
+          blockRecord.flags = value
+          break
+        default:
+      }
+
+      return blockRecord
+    },
+    { type: 'BLOCK_RECORD' } as BlockRecordInternal,
+  )
+}
+
+const ucsHandler = (tuples: DXFTuple[]): UcsInternal => {
+  return tuples.reduce(
+    (ucs, tuple) => {
+      const type = tuple[0]
+      const value = tuple[1]
+
+      switch (type) {
+        case 2:
+          ucs.name = value
+          break
+        case 70:
+          ucs.flags = value
+          break
+        default:
+      }
+
+      return ucs
+    },
+    { type: 'UCS' } as UcsInternal,
+  )
+}
+
+const viewHandler = (tuples: DXFTuple[]): ViewInternal => {
+  return tuples.reduce(
+    (view, tuple) => {
+      const type = tuple[0]
+      const value = tuple[1]
+
+      switch (type) {
+        case 2:
+          view.name = value
+          break
+        case 70:
+          view.flags = value
+          break
+        default:
+      }
+
+      return view
+    },
+    { type: 'VIEW' } as ViewInternal,
+  )
+}
+
 const dimStyleHandler = (tuples: DXFTuple[]): DimStyleInternal => {
   return tuples.reduce(
     (dimStyle, tuple) => {
       const type = tuple[0]
       const value = tuple[1]
-      switch (type) {
+      switch (type) { // NOSONAR
         case 2:
           dimStyle.name = value
           break
@@ -508,7 +608,18 @@ const dimStyleHandler = (tuples: DXFTuple[]): DimStyleInternal => {
 const tableHandler = (
   tuples: DXFTuple[],
   tableType: string,
-  handler: (tuples: DXFTuple[]) => LTypeInternal | LayerInternal | StyleInternal | VPortInternal | DimStyleInternal,
+  handler: (
+    tuples: DXFTuple[],
+  ) =>
+    | LTypeInternal
+    | LayerInternal
+    | StyleInternal
+    | VPortInternal
+    | DimStyleInternal
+    | AppIdInternal
+    | BlockRecordInternal
+    | UcsInternal
+    | ViewInternal,
 ): Record<string, any> => {
   const tableRowsTuples: DXFTuple[][] = []
 
@@ -552,30 +663,32 @@ export default function parseTables(tuples: DXFTuple[]) {
     }
   }
 
-  let stylesTuples: DXFTuple[] = []
-  let layersTuples: DXFTuple[] = []
-  let vPortTuples: DXFTuple[] = []
-  let ltypeTuples: DXFTuple[] = []
-  let dimStyleTuples: DXFTuple[] = []
+  const groupsByName: Record<string, DXFTuple[]> = {}
   for (const group of tableGroups) {
-    if (group[0]?.[1] === 'STYLE') {
-      stylesTuples = group
-    } else if (group[0]?.[1] === 'LTYPE') {
-      ltypeTuples = group
-    } else if (group[0]?.[1] === 'LAYER') {
-      layersTuples = group
-    } else if (group[0]?.[1] === 'VPORT') {
-      vPortTuples = group
-    } else if (group[0]?.[1] === 'DIMSTYLE') {
-      dimStyleTuples = group
-    }
+    const name = String(group[0]?.[1] ?? '')
+    if (!name) continue
+    groupsByName[name] = group
   }
 
+  const stylesTuples = groupsByName.STYLE ?? []
+  const layersTuples = groupsByName.LAYER ?? []
+  const vPortTuples = groupsByName.VPORT ?? []
+  const ltypeTuples = groupsByName.LTYPE ?? []
+  const dimStyleTuples = groupsByName.DIMSTYLE ?? []
+  const appIdTuples = groupsByName.APPID ?? []
+  const blockRecordTuples = groupsByName.BLOCK_RECORD ?? []
+  const ucsTuples = groupsByName.UCS ?? []
+  const viewTuples = groupsByName.VIEW ?? []
+
   return {
     layers: tableHandler(layersTuples, 'LAYER', layerHandler),
     styles: tableHandler(stylesTuples, 'STYLE', styleHandler),
     vports: tableHandler(vPortTuples, 'VPORT', vPortHandler),
     ltypes: tableHandler(ltypeTuples, 'LTYPE', ltypeHandler),
     dimStyles: tableHandler(dimStyleTuples, 'DIMSTYLE', dimStyleHandler),
+    appids: tableHandler(appIdTuples, 'APPID', appIdHandler),
+    blockRecords: tableHandler(blockRecordTuples, 'BLOCK_RECORD', blockRecordHandler),
+    ucs: tableHandler(ucsTuples, 'UCS', ucsHandler),
+    views: tableHandler(viewTuples, 'VIEW', viewHandler),
   }
 }

package/src/index.ts

@@ -1,19 +1,10 @@
-import config from './config'
-import parseString from './parseString'
-import denormalise from './denormalise'
-import groupEntitiesByLayer from './groupEntitiesByLayer'
-import toPolylines from './toPolylines'
-import toSVG from './toSVG'
-import colors from './util/colors'
-import Helper from './Helper'
+export { default as config } from './config'
+export { default as denormalise } from './denormalise'
+export { default as groupEntitiesByLayer } from './groupEntitiesByLayer'
+export { default as Helper } from './Helper'
+export { default as parseString } from './parseString'
+export { default as toJson } from './toJson'
+export { default as toPolylines } from './toPolylines'
+export { default as toSVG } from './toSVG'
+export { default as colors } from './util/colors'
 
-export {
-  config,
-  parseString,
-  denormalise,
-  groupEntitiesByLayer,
-  toPolylines,
-  toSVG,
-  colors,
-  Helper,
-}

package/src/toJson.ts

@@ -0,0 +1,8 @@
+import type { ParsedDXF, ToJsonOptions } from './types'
+
+export default function toJson(parsed: ParsedDXF, options: ToJsonOptions = {}): string {
+  const shouldPrettyPrint = options.pretty === true
+  const indentation = shouldPrettyPrint ? (options.space ?? 2) : undefined
+
+  return JSON.stringify(parsed, null, indentation)
+}

package/src/toSVG.ts

@@ -1,9 +1,10 @@
 import { Box2 } from 'vecks'
 
 import denormalise from './denormalise'
-import dimensionToSVG from './dimensionToSVG'
+import dimensionToSVG, { getDimensionGeometryBBox } from './dimensionToSVG'
 import entityToPolyline from './entityToPolyline'
 import getRGBForEntity from './getRGBForEntity'
+import escapeXmlText from './util/escapeXmlText'
 import logger from './util/logger'
 import rgbToColorAttribute from './util/rgbToColorAttribute'
 import rotate from './util/rotate'
@@ -16,10 +17,14 @@ import type {
   DimensionEntity,
   EllipseEntity,
   Entity,
+  LeaderEntity,
   MTextEntity,
   ParsedDXF,
+  ShapeEntity,
   SplineEntity,
   TextEntity,
+  ToleranceEntity,
+  ToSVGOptions,
 } from './types'
 import type { BoundsAndElement } from './types/svg'
 
@@ -90,6 +95,26 @@ const lwpolyline = (entity: Entity): BoundsAndElement => {
   )
 }
 
+const leader = (entity: LeaderEntity): BoundsAndElement | null => {
+  if (!entity.vertices || entity.vertices.length < 2) return null
+
+  const bbox0 = entity.vertices.reduce(
+    (acc, p) => acc.expandByPoint({ x: p.x, y: p.y }),
+    new Box2(),
+  )
+  const d = entity.vertices.reduce((acc, p, i) => {
+    acc += i === 0 ? 'M' : 'L'
+    acc += p.x + ',' + p.y
+    return acc
+  }, '')
+
+  return transformBoundingBoxAndElement(
+    bbox0,
+    `<path d="${d}" />`,
+    entity.transforms ?? [],
+  )
+}
+
 
 /**
  * Create a <circle /> element for the CIRCLE entity.
@@ -311,7 +336,7 @@ const text = (entity: TextEntity): BoundsAndElement => {
     .expandByPoint({ x: x + textWidth, y: y + height })
 
   const rotationDegrees = (rotation * 180) / Math.PI
-  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${content}</text>`
+  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${escapeXmlText(content)}</text>`
 
   const { bbox, element } = addFlipXIfApplicable(entity, {
     bbox: bbox0,
@@ -340,8 +365,62 @@ const mtext = (entity: MTextEntity): BoundsAndElement => {
     ? Math.atan2(entity.xAxisY, entity.xAxisX)
     : 0
   const rotationDegrees = (rotation * 180) / Math.PI
+  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${escapeXmlText(content)}</text>`
+
+  const { bbox, element } = addFlipXIfApplicable(entity, {
+    bbox: bbox0,
+    element: element0,
+  })
+  return transformBoundingBoxAndElement(bbox, element, entity.transforms ?? [])
+}
+
+/**
+ * Minimal <text /> fallback for TOLERANCE entities.
+ * DXF uses special control codes; we preserve the raw string.
+ */
+const tolerance = (entity: ToleranceEntity): BoundsAndElement => {
+  const x = entity.insertionPoint?.x ?? 0
+  const y = entity.insertionPoint?.y ?? 0
+  const height = 1
+  const content = entity.text ?? ''
+
+  const rotation = entity.xAxisDirection
+    ? Math.atan2(entity.xAxisDirection.y, entity.xAxisDirection.x)
+    : 0
+  const rotationDegrees = (rotation * 180) / Math.PI
+
+  const textWidth = content.length * height * 0.6
+  const bbox0 = new Box2()
+    .expandByPoint({ x, y })
+    .expandByPoint({ x: x + textWidth, y: y + height })
+
+  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${escapeXmlText(content)}</text>`
+
+  const { bbox, element } = addFlipXIfApplicable(entity, {
+    bbox: bbox0,
+    element: element0,
+  })
+  return transformBoundingBoxAndElement(bbox, element, entity.transforms ?? [])
+}
+
+/**
+ * Minimal <text /> fallback for SHAPE entities.
+ * Rendering SHX-based shapes is out of scope; we render the name as text.
+ */
+const shape = (entity: ShapeEntity): BoundsAndElement => {
+  const x = entity.insertionPoint?.x ?? 0
+  const y = entity.insertionPoint?.y ?? 0
+  const height = entity.size ?? 1
+  const rotation = entity.rotation ?? 0
+  const content = entity.name ?? ''
+
+  const textWidth = content.length * height * 0.6
+  const bbox0 = new Box2()
+    .expandByPoint({ x, y })
+    .expandByPoint({ x: x + textWidth, y: y + height })
 
-  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${content}</text>`
+  const rotationDegrees = (rotation * 180) / Math.PI
+  const element0 = `<text x="${x}" y="${y}" font-size="${height}" transform="rotate(${-rotationDegrees} ${x} ${y}) scale(1,-1) translate(0 ${-2 * y})">${escapeXmlText(content)}</text>`
 
   const { bbox, element } = addFlipXIfApplicable(entity, {
     bbox: bbox0,
@@ -356,8 +435,10 @@ const mtext = (entity: MTextEntity): BoundsAndElement => {
 const dimension = (
   entity: DimensionEntity,
   dimStyle?: any,
+  options?: ToSVGOptions,
+  viewport?: { width: number; height: number },
 ): BoundsAndElement => {
-  const result = dimensionToSVG(entity, dimStyle)
+  const result = dimensionToSVG(entity, dimStyle, options, viewport)
   return transformBoundingBoxAndElement(
     result.bbox,
     result.element,
@@ -410,6 +491,8 @@ const bezier = (entity: SplineEntity): BoundsAndElement => {
 const entityToBoundsAndElement = (
   entity: Entity,
   dimStyles?: { [name: string]: any },
+  options?: ToSVGOptions,
+  viewport?: { width: number; height: number },
 ): BoundsAndElement | null => {
   switch (entity.type) {
     case 'CIRCLE':
@@ -430,7 +513,7 @@ const entityToBoundsAndElement = (
       const dimStyle = styleName && dimStyles
         ? dimStyles[styleName]
         : undefined
-      return dimension(dimEntity, dimStyle)
+      return dimension(dimEntity, dimStyle, options, viewport)
     }
     case 'SPLINE': {
       const splineEntity = entity as SplineEntity
@@ -448,28 +531,75 @@ const entityToBoundsAndElement = (
       }
     }
     case 'LINE':
+    case 'RAY':
+    case 'XLINE':
     case 'POLYLINE': {
       return polyline(entity)
     }
+    case 'SOLID':
+    case 'TRACE': {
+      return polyline(entity)
+    }
     case 'LWPOLYLINE': {
       return lwpolyline(entity)
     }
+    case 'WIPEOUT': {
+      return polyline(entity)
+    }
+    case 'LEADER': {
+      return leader(entity as LeaderEntity)
+    }
+    case 'TOLERANCE': {
+      return tolerance(entity as ToleranceEntity)
+    }
+    case 'SHAPE': {
+      return shape(entity as ShapeEntity)
+    }
     default:
       logger.warn('entity type not supported in SVG rendering:', entity.type)
       return null
   }
 }
 
-export default function toSVG(parsed: ParsedDXF): string {
+export default function toSVG(parsed: ParsedDXF, options: ToSVGOptions = {}): string {
   const entities = denormalise(parsed)
   const dimStyles = parsed.tables.dimStyles
+
+  const geometryBBox = entities.reduce((acc: Box2, entity: Entity): Box2 => {
+    if (entity.type === 'DIMENSION') {
+      const bbox = getDimensionGeometryBBox(entity as DimensionEntity)
+      if (bbox.valid) {
+        acc.expandByPoint(bbox.min)
+        acc.expandByPoint(bbox.max)
+      }
+      return acc
+    }
+
+    const boundsAndElement = entityToBoundsAndElement(entity, dimStyles, options)
+    if (boundsAndElement?.bbox.valid) {
+      acc.expandByPoint(boundsAndElement.bbox.min)
+      acc.expandByPoint(boundsAndElement.bbox.max)
+    }
+    return acc
+  }, new Box2())
+
+  const viewport = geometryBBox.valid
+    ? {
+        width: geometryBBox.max.x - geometryBBox.min.x,
+        height: geometryBBox.max.y - geometryBBox.min.y,
+      }
+    : {
+        width: 0,
+        height: 0,
+      }
+
   const { bbox, elements } = entities.reduce(
     (
       acc: { bbox: Box2; elements: string[] },
       entity: Entity,
     ): { bbox: Box2; elements: string[] } => {
       const rgb = getRGBForEntity(parsed.tables.layers, entity)
-      const boundsAndElement = entityToBoundsAndElement(entity, dimStyles)
+      const boundsAndElement = entityToBoundsAndElement(entity, dimStyles, options, viewport)
       // Ignore entities that don't produce SVG elements or have unsupported types
       if (boundsAndElement) {
         const { bbox, element } = boundsAndElement
@@ -478,9 +608,12 @@ export default function toSVG(parsed: ParsedDXF): string {
           acc.bbox.expandByPoint(bbox.min)
           acc.bbox.expandByPoint(bbox.max)
         }
-        acc.elements.push(
-          `<g stroke="${rgbToColorAttribute(rgb)}">${element}</g>`,
-        )
+        const color = rgbToColorAttribute(rgb)
+        if (entity.type === 'SOLID' || entity.type === 'TRACE') {
+          acc.elements.push(`<g fill="${color}" stroke="none">${element}</g>`)
+        } else {
+          acc.elements.push(`<g stroke="${color}">${element}</g>`)
+        }
       }
       return acc
     },

package/src/types/dimension-entity.ts

@@ -7,6 +7,17 @@ export interface DimensionEntity extends BaseEntity {
   type: 'DIMENSION'
   block?: string
   start: Point3D
+  /**
+   * Angular vertex for DIMENSION type 5 (Angular 3-point).
+   * This is parsed from group codes 15/25/35.
+   */
+  angleVertex?: Point3D
+
+  /**
+   * Angular arc location point for DIMENSION angular types.
+   * This is parsed from group codes 16/26/36 (OCS in the DXF reference).
+   */
+  arcPoint?: Point3D
   measureStart: Point3D
   measureEnd: Point3D
   textMidpoint: Point3D

package/src/types/entity.ts

@@ -6,14 +6,28 @@ import type { CircleEntity } from './circle-entity'
 import type { DimensionEntity } from './dimension-entity'
 import type { EllipseEntity } from './ellipse-entity'
 import type { HatchEntity } from './hatch-entity'
+import type { ImageEntity } from './image-entity'
 import type { InsertEntity } from './insert-entity'
+import type { LeaderEntity } from './leader-entity'
 import type { LineEntity } from './line-entity'
+import type { MLeaderEntity } from './mleader-entity'
+import type { MLineEntity } from './mline-entity'
 import type { MTextEntity } from './mtext-entity'
+import type { OleFrameEntity } from './oleframe-entity'
 import type { PointEntity } from './point-entity'
 import type { PolylineEntity } from './polyline-entity'
+import type { RayEntity } from './ray-entity'
+import type { RegionEntity } from './region-entity'
+import type { ShapeEntity } from './shape-entity'
 import type { SolidEntity } from './solid-entity'
 import type { SplineEntity } from './spline-entity'
+import type { TableEntity } from './table-entity'
 import type { TextEntity } from './text-entity'
+import type { ToleranceEntity } from './tolerance-entity'
+import type { TraceEntity } from './trace-entity'
+import type { DgnUnderlayEntity, DwfUnderlayEntity, PdfUnderlayEntity } from './underlay-entity'
+import type { WipeoutEntity } from './wipeout-entity'
+import type { XLineEntity } from './xline-entity'
 
 export type Entity =
   | LineEntity
@@ -25,8 +39,24 @@ export type Entity =
   | PointEntity
   | PolylineEntity
   | SplineEntity
+  | TableEntity
   | DimensionEntity
   | SolidEntity
+  | TraceEntity
   | InsertEntity
+  | ImageEntity
+  | LeaderEntity
+  | MLineEntity
+  | MLeaderEntity
+  | ToleranceEntity
+  | DwfUnderlayEntity
+  | DgnUnderlayEntity
+  | PdfUnderlayEntity
   | HatchEntity
   | BaseEntity
+  | OleFrameEntity
+  | RayEntity
+  | RegionEntity
+  | ShapeEntity
+  | WipeoutEntity
+  | XLineEntity

package/src/types/helper.ts

@@ -2,11 +2,12 @@
 
 import type { ParsedDXF } from './dxf'
 import type { Entity } from './entity'
-import type { ToPolylinesOptions, ToSVGOptions } from './options'
+import type { ToJsonOptions, ToPolylinesOptions, ToSVGOptions } from './options'
 
 export interface HelperInterface {
   parsed: ParsedDXF
   denormalised: Entity[]
   toSVG(options?: ToSVGOptions): string
+  toJson(options?: ToJsonOptions): string
   toPolylines(options?: ToPolylinesOptions): any[]
 }

package/src/types/image-entity.ts

@@ -0,0 +1,35 @@
+// IMAGE entity type
+
+import type { BaseEntity } from './base-entity'
+import type { Point3D } from './common'
+
+export interface ImageEntity extends BaseEntity {
+  type: 'IMAGE'
+
+  insertionPoint: Point3D
+  uVector: Point3D
+  vVector: Point3D
+
+  /** Image size in pixels. */
+  pixelSizeX: number
+  pixelSizeY: number
+
+  /** Hard reference to IMAGEDEF object. */
+  imageDefHandle?: string
+
+  /** Hard reference to IMAGEDEF_REACTOR object. */
+  imageDefReactorHandle?: string
+
+  /** Image display properties bitmask. */
+  displayProperties?: number
+
+  /** Clipping state: 0 = Off; 1 = On. */
+  clippingState?: number
+
+  brightness?: number
+  contrast?: number
+  fade?: number
+
+  /** DXF class version. */
+  classVersion?: number
+}

package/src/types/index.ts

@@ -12,16 +12,30 @@ export * from './circle-entity'
 export * from './dimension-entity'
 export * from './ellipse-entity'
 export * from './hatch-entity'
+export * from './image-entity'
 export * from './insert-entity'
+export * from './leader-entity'
 export * from './line-entity'
+export * from './mleader-entity'
+export * from './mline-entity'
 export * from './mtext-entity'
 export * from './ole2frame-entity'
+export * from './oleframe-entity'
 export * from './point-entity'
 export * from './polyline-entity'
+export * from './ray-entity'
+export * from './region-entity'
+export * from './shape-entity'
 export * from './solid-entity'
 export * from './spline-entity'
+export * from './table-entity'
 export * from './text-entity'
+export * from './tolerance-entity'
+export * from './trace-entity'
+export * from './underlay-entity'
 export * from './viewport-entity'
+export * from './wipeout-entity'
+export * from './xline-entity'
 
 // Union type
 export * from './entity'

package/src/types/leader-entity.ts

@@ -0,0 +1,40 @@
+// LEADER entity type
+
+import type { BaseEntity } from './base-entity'
+import type { Point3D } from './common'
+
+export interface LeaderEntity extends BaseEntity {
+  type: 'LEADER'
+
+  /** Leader vertices, in drawing coordinates. */
+  vertices: Point3D[]
+
+  /** Dimension style name. */
+  dimensionStyleName?: string
+
+  /** Arrowhead flag: 0 = Disabled; 1 = Enabled. */
+  arrowheadFlag?: number
+
+  /** Leader path type: 0 = Straight line segments; 1 = Spline. */
+  pathType?: number
+
+  /** Leader creation flag: 0 = text; 1 = tolerance; 2 = insert; 3 = none. */
+  creationFlag?: number
+
+  hooklineDirectionFlag?: number
+  hooklineFlag?: number
+
+  textHeight?: number
+  textWidth?: number
+
+  /** Color to use if leader's DIMCLR D = BYBLOCK. */
+  color?: number
+
+  /** Hard reference to associated annotation entity. */
+  annotationHandle?: string
+
+  normal?: Point3D
+  horizontalDirection?: Point3D
+  blockOffset?: Point3D
+  annotationOffset?: Point3D
+}