@mlightcad/data-model 1.9.1 → 1.9.3

package/lib/entity/AcDbProxyEntity.d.ts

@@ -0,0 +1,244 @@
+import { AcGeBox3d, AcGeMatrix3d, AcGePoint3d } from '@mlightcad/geometry-engine';
+import { AcGiEntity, AcGiRenderer } from '@mlightcad/graphic-interface';
+import { AcDbDxfFiler } from '../base/AcDbDxfFiler';
+import { AcDbEntity } from './AcDbEntity';
+/**
+ * Represents a proxy entity for custom objects not natively supported by the
+ * host application.
+ *
+ * When AutoCAD loads a drawing that contains custom ObjectARX entities whose
+ * class definitions are unavailable, those objects are stored as
+ * `ACAD_PROXY_ENTITY` records. Each proxy entity carries metadata about the
+ * original class and a binary **proxy graphic** stream that encodes drawable
+ * primitives (lines, arcs, text, and so on).
+ *
+ * {@link subWorldDraw} decodes that stream through {@link AcDbProxyGraphic}
+ * and renders the contained primitives via {@link AcGiRenderer}, allowing
+ * viewers such as cad-viewer to display third-party objects without the
+ * original ARX module.
+ *
+ * @see https://help.autodesk.com/view/OARX/2024/ENU/?guid=OARX-RefGuide-AcDbProxyEntity
+ *
+ * @example
+ * ```typescript
+ * const proxy = new AcDbProxyEntity()
+ * proxy.originalDxfName = 'AECC_TIN_SURFACE'
+ * proxy.setProxyGraphic(binaryData)
+ * const drawable = proxy.subWorldDraw(renderer)
+ * ```
+ */
+export declare class AcDbProxyEntity extends AcDbEntity {
+    /**
+     * The runtime entity type name used by {@link AcDbEntity.type}.
+     *
+     * Always `'ProxyEntity'`.
+     */
+    static typeName: string;
+    /**
+     * Gets the DXF entity type name written to and read from drawing files.
+     *
+     * @returns The literal `'ACAD_PROXY_ENTITY'`.
+     */
+    get dxfTypeName(): string;
+    /**
+     * Original DXF entity name of the proxied class.
+     *
+     * Stored in DXF group code **1**. Example: `'AECC_TIN_SURFACE'`.
+     */
+    private _originalDxfName;
+    /**
+     * Original ObjectARX class name of the proxied object.
+     *
+     * Stored in DXF group code **3** when present.
+     */
+    private _originalClassName;
+    /**
+     * Registered application name that created the proxied object.
+     *
+     * Stored in DXF extended-data group code **1001** when present.
+     */
+    private _applicationName;
+    /**
+     * Proxy-entity class identifier assigned by the creating application.
+     *
+     * Stored in DXF group code **90**.
+     */
+    private _proxyEntityClassId;
+    /**
+     * Graphics metafile type flag describing how proxy graphics were captured.
+     *
+     * Stored in DXF group code **91**. Also referred to as the object drawing
+     * format in some DXF parsers.
+     */
+    private _graphicsMetafileType;
+    /**
+     * Raw binary proxy-graphics payload.
+     *
+     * Length is stored in DXF group code **160**; the bytes themselves are
+     * serialized as hexadecimal strings in group code **310** chunks.
+     */
+    private _proxyGraphic?;
+    /**
+     * Optional entity-origin anchor points associated with the proxy entity.
+     *
+     * Count is stored in DXF group code **92**; each point uses group code **10**.
+     */
+    private _entityOrigins;
+    /**
+     * Gets the original DXF name of the proxied entity class.
+     *
+     * Mirrors the ObjectARX original-class DXF name and corresponds to DXF
+     * group code **1**.
+     *
+     * @returns The proxied class DXF name, or an empty string when unset.
+     */
+    get originalDxfName(): string;
+    /**
+     * Sets the original DXF name of the proxied entity class.
+     *
+     * @param value - Proxied class DXF name (DXF group code **1**).
+     */
+    set originalDxfName(value: string);
+    /**
+     * Gets the original ObjectARX class name of the proxied object.
+     *
+     * Corresponds to DXF group code **3** when exported.
+     *
+     * @returns The ObjectARX class name, or an empty string when unset.
+     */
+    get originalClassName(): string;
+    /**
+     * Sets the original ObjectARX class name of the proxied object.
+     *
+     * @param value - ObjectARX class name (DXF group code **3**).
+     */
+    set originalClassName(value: string);
+    /**
+     * Gets the registered application name that created the proxied object.
+     *
+     * Corresponds to DXF extended-data group code **1001** when exported.
+     *
+     * @returns The creating application name, or an empty string when unset.
+     */
+    get applicationName(): string;
+    /**
+     * Sets the registered application name that created the proxied object.
+     *
+     * @param value - Application name (DXF group code **1001**).
+     */
+    set applicationName(value: string);
+    /**
+     * Gets the proxy-entity class identifier.
+     *
+     * Corresponds to DXF group code **90**.
+     *
+     * @returns The class identifier assigned by the creating application.
+     */
+    get proxyEntityClassId(): number;
+    /**
+     * Sets the proxy-entity class identifier.
+     *
+     * @param value - Class identifier (DXF group code **90**).
+     */
+    set proxyEntityClassId(value: number);
+    /**
+     * Gets the graphics metafile type flag.
+     *
+     * Corresponds to DXF group code **91**.
+     *
+     * @returns The metafile / object-drawing-format flag.
+     */
+    get graphicsMetafileType(): number;
+    /**
+     * Sets the graphics metafile type flag.
+     *
+     * @param value - Metafile type (DXF group code **91**).
+     */
+    set graphicsMetafileType(value: number);
+    /**
+     * Gets the decoded proxy-graphics binary payload.
+     *
+     * @returns A copy of the stored bytes, or `undefined` when no graphics are
+     *   attached.
+     */
+    get proxyGraphic(): Uint8Array | undefined;
+    /**
+     * Sets the proxy-graphics binary payload.
+     *
+     * The supplied buffer is copied so subsequent mutations of the caller's array
+     * do not affect this entity.
+     *
+     * @param data - Raw proxy-graphic bytes, or `null`/`undefined` to clear.
+     */
+    setProxyGraphic(data?: Uint8Array | null): void;
+    /**
+     * Gets the entity-origin anchor points stored on this proxy entity.
+     *
+     * @returns A read-only view of the origin points. Mutate through
+     *   {@link setEntityOrigins}.
+     */
+    get entityOrigins(): AcGePoint3d[];
+    /**
+     * Replaces the entity-origin anchor points stored on this proxy entity.
+     *
+     * Each input point is cloned into an {@link AcGePoint3d} instance.
+     *
+     * @param origins - New origin points (DXF group codes **92** / **10**).
+     */
+    setEntityOrigins(origins: AcGePoint3d[]): void;
+    /**
+     * Gets the geometric extents of this proxy entity.
+     *
+     * When the proxy-graphic stream contains an {@link AcDbProxyGraphicType.Extents}
+     * chunk, the returned box is built from its minimum and maximum corners.
+     * Otherwise an empty {@link AcGeBox3d} is returned.
+     *
+     * @returns The axis-aligned bounding box derived from proxy graphics.
+     */
+    get geometricExtents(): AcGeBox3d;
+    /**
+     * Transforms this proxy entity by the specified matrix.
+     *
+     * Only {@link entityOrigins} are modified. The proxy-graphic byte stream is
+     * left unchanged because transforms are encoded as {@link AcDbProxyGraphicType.PushMatrix}
+     * / {@link AcDbProxyGraphicType.PopMatrix} commands inside the stream and
+     * applied at render time by {@link AcDbProxyGraphic}.
+     *
+     * @param matrix - Transformation matrix to apply to entity origins.
+     * @returns This entity for chaining.
+     */
+    transformBy(matrix: AcGeMatrix3d): this;
+    /**
+     * Draws proxy graphics by decoding the binary stream and emitting primitives
+     * through the renderer.
+     *
+     * This is the primary world-space draw entry point for proxy entities. It
+     * delegates to {@link AcDbProxyGraphic.worldDraw} using the entity database
+     * and layer as rendering context.
+     *
+     * @param renderer - Target graphics renderer.
+     * @returns A grouped {@link AcGiEntity} when geometry was emitted, otherwise
+     *   `undefined`.
+     */
+    subWorldDraw(renderer: AcGiRenderer): AcGiEntity | undefined;
+    /**
+     * Writes DXF subclass fields for this proxy entity.
+     *
+     * Emits the `AcDbProxyEntity` subclass marker followed by group codes **1**,
+     * **3**, **1001**, **90**, **91**, **92**, **10**, **160**, and **310** as
+     * appropriate.
+     *
+     * @param filer - DXF output filer.
+     * @returns This entity for chaining.
+     */
+    dxfOutFields(filer: AcDbDxfFiler): this;
+    /**
+     * Loads proxy-graphic bytes from DXF group codes **160** and **310**.
+     *
+     * @param length - Expected byte length from group code **160**. When provided
+     *   and positive, the result is truncated to this length.
+     * @param hexChunks - One or more hexadecimal strings from group code **310**.
+     */
+    loadProxyGraphicFromDxf(length?: number, hexChunks?: string[]): void;
+}
+//# sourceMappingURL=AcDbProxyEntity.d.ts.map

package/lib/entity/AcDbProxyEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbProxyEntity.d.ts","sourceRoot":"","sources":["../../src/entity/AcDbProxyEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAMnD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;;;OAIG;IACH,OAAgB,QAAQ,EAAE,MAAM,CAAgB;IAEhD;;;;OAIG;IACH,IAAa,WAAW,WAEvB;IAED;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAAK;IAE/B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAI;IAE/B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB,CAAI;IAEjC;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAC,CAAY;IAElC;;;;OAIG;IACH,OAAO,CAAC,cAAc,CAAoB;IAE1C;;;;;;;OAOG;IACH,IAAI,eAAe,IASQ,MAAM,CAPhC;IAED;;;;OAIG;IACH,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED;;;;;;OAMG;IACH,IAAI,iBAAiB,IASQ,MAAM,CAPlC;IAED;;;;OAIG;IACH,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAElC;IAED;;;;;;OAMG;IACH,IAAI,eAAe,IASQ,MAAM,CAPhC;IAED;;;;OAIG;IACH,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED;;;;;;OAMG;IACH,IAAI,kBAAkB,IASQ,MAAM,CAPnC;IAED;;;;OAIG;IACH,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAEnC;IAED;;;;;;OAMG;IACH,IAAI,oBAAoB,IASQ,MAAM,CAPrC;IAED;;;;OAIG;IACH,IAAI,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAErC;IAED;;;;;OAKG;IACH,IAAI,YAAY,2BAEf;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI;IAIxC;;;;;OAKG;IACH,IAAI,aAAa,kBAEhB;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE;IAMvC;;;;;;;;OAQG;IACH,IAAI,gBAAgB,IAAI,SAAS,CAchC;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY;IAKhC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS;IAa5D;;;;;;;;;OASG;IACM,YAAY,CAAC,KAAK,EAAE,YAAY;IAiCzC;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE;CAM9D"}

package/lib/entity/AcDbProxyEntity.js

@@ -0,0 +1,410 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { AcGeBox3d, AcGePoint3d } from '@mlightcad/geometry-engine';
+import { AcDbProxyGraphic, bytesToHexString, loadAcDbProxyGraphicFromDxf } from '../misc/proxyGraphic';
+import { AcDbEntity } from './AcDbEntity';
+/**
+ * Represents a proxy entity for custom objects not natively supported by the
+ * host application.
+ *
+ * When AutoCAD loads a drawing that contains custom ObjectARX entities whose
+ * class definitions are unavailable, those objects are stored as
+ * `ACAD_PROXY_ENTITY` records. Each proxy entity carries metadata about the
+ * original class and a binary **proxy graphic** stream that encodes drawable
+ * primitives (lines, arcs, text, and so on).
+ *
+ * {@link subWorldDraw} decodes that stream through {@link AcDbProxyGraphic}
+ * and renders the contained primitives via {@link AcGiRenderer}, allowing
+ * viewers such as cad-viewer to display third-party objects without the
+ * original ARX module.
+ *
+ * @see https://help.autodesk.com/view/OARX/2024/ENU/?guid=OARX-RefGuide-AcDbProxyEntity
+ *
+ * @example
+ * ```typescript
+ * const proxy = new AcDbProxyEntity()
+ * proxy.originalDxfName = 'AECC_TIN_SURFACE'
+ * proxy.setProxyGraphic(binaryData)
+ * const drawable = proxy.subWorldDraw(renderer)
+ * ```
+ */
+var AcDbProxyEntity = /** @class */ (function (_super) {
+    __extends(AcDbProxyEntity, _super);
+    function AcDbProxyEntity() {
+        var _this = _super.apply(this, __spreadArray([], __read(arguments), false)) || this;
+        /**
+         * Original DXF entity name of the proxied class.
+         *
+         * Stored in DXF group code **1**. Example: `'AECC_TIN_SURFACE'`.
+         */
+        _this._originalDxfName = '';
+        /**
+         * Original ObjectARX class name of the proxied object.
+         *
+         * Stored in DXF group code **3** when present.
+         */
+        _this._originalClassName = '';
+        /**
+         * Registered application name that created the proxied object.
+         *
+         * Stored in DXF extended-data group code **1001** when present.
+         */
+        _this._applicationName = '';
+        /**
+         * Proxy-entity class identifier assigned by the creating application.
+         *
+         * Stored in DXF group code **90**.
+         */
+        _this._proxyEntityClassId = 0;
+        /**
+         * Graphics metafile type flag describing how proxy graphics were captured.
+         *
+         * Stored in DXF group code **91**. Also referred to as the object drawing
+         * format in some DXF parsers.
+         */
+        _this._graphicsMetafileType = 0;
+        /**
+         * Optional entity-origin anchor points associated with the proxy entity.
+         *
+         * Count is stored in DXF group code **92**; each point uses group code **10**.
+         */
+        _this._entityOrigins = [];
+        return _this;
+    }
+    Object.defineProperty(AcDbProxyEntity.prototype, "dxfTypeName", {
+        /**
+         * Gets the DXF entity type name written to and read from drawing files.
+         *
+         * @returns The literal `'ACAD_PROXY_ENTITY'`.
+         */
+        get: function () {
+            return 'ACAD_PROXY_ENTITY';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "originalDxfName", {
+        /**
+         * Gets the original DXF name of the proxied entity class.
+         *
+         * Mirrors the ObjectARX original-class DXF name and corresponds to DXF
+         * group code **1**.
+         *
+         * @returns The proxied class DXF name, or an empty string when unset.
+         */
+        get: function () {
+            return this._originalDxfName;
+        },
+        /**
+         * Sets the original DXF name of the proxied entity class.
+         *
+         * @param value - Proxied class DXF name (DXF group code **1**).
+         */
+        set: function (value) {
+            this._originalDxfName = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "originalClassName", {
+        /**
+         * Gets the original ObjectARX class name of the proxied object.
+         *
+         * Corresponds to DXF group code **3** when exported.
+         *
+         * @returns The ObjectARX class name, or an empty string when unset.
+         */
+        get: function () {
+            return this._originalClassName;
+        },
+        /**
+         * Sets the original ObjectARX class name of the proxied object.
+         *
+         * @param value - ObjectARX class name (DXF group code **3**).
+         */
+        set: function (value) {
+            this._originalClassName = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "applicationName", {
+        /**
+         * Gets the registered application name that created the proxied object.
+         *
+         * Corresponds to DXF extended-data group code **1001** when exported.
+         *
+         * @returns The creating application name, or an empty string when unset.
+         */
+        get: function () {
+            return this._applicationName;
+        },
+        /**
+         * Sets the registered application name that created the proxied object.
+         *
+         * @param value - Application name (DXF group code **1001**).
+         */
+        set: function (value) {
+            this._applicationName = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "proxyEntityClassId", {
+        /**
+         * Gets the proxy-entity class identifier.
+         *
+         * Corresponds to DXF group code **90**.
+         *
+         * @returns The class identifier assigned by the creating application.
+         */
+        get: function () {
+            return this._proxyEntityClassId;
+        },
+        /**
+         * Sets the proxy-entity class identifier.
+         *
+         * @param value - Class identifier (DXF group code **90**).
+         */
+        set: function (value) {
+            this._proxyEntityClassId = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "graphicsMetafileType", {
+        /**
+         * Gets the graphics metafile type flag.
+         *
+         * Corresponds to DXF group code **91**.
+         *
+         * @returns The metafile / object-drawing-format flag.
+         */
+        get: function () {
+            return this._graphicsMetafileType;
+        },
+        /**
+         * Sets the graphics metafile type flag.
+         *
+         * @param value - Metafile type (DXF group code **91**).
+         */
+        set: function (value) {
+            this._graphicsMetafileType = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcDbProxyEntity.prototype, "proxyGraphic", {
+        /**
+         * Gets the decoded proxy-graphics binary payload.
+         *
+         * @returns A copy of the stored bytes, or `undefined` when no graphics are
+         *   attached.
+         */
+        get: function () {
+            return this._proxyGraphic;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Sets the proxy-graphics binary payload.
+     *
+     * The supplied buffer is copied so subsequent mutations of the caller's array
+     * do not affect this entity.
+     *
+     * @param data - Raw proxy-graphic bytes, or `null`/`undefined` to clear.
+     */
+    AcDbProxyEntity.prototype.setProxyGraphic = function (data) {
+        this._proxyGraphic = data ? new Uint8Array(data) : undefined;
+    };
+    Object.defineProperty(AcDbProxyEntity.prototype, "entityOrigins", {
+        /**
+         * Gets the entity-origin anchor points stored on this proxy entity.
+         *
+         * @returns A read-only view of the origin points. Mutate through
+         *   {@link setEntityOrigins}.
+         */
+        get: function () {
+            return this._entityOrigins;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Replaces the entity-origin anchor points stored on this proxy entity.
+     *
+     * Each input point is cloned into an {@link AcGePoint3d} instance.
+     *
+     * @param origins - New origin points (DXF group codes **92** / **10**).
+     */
+    AcDbProxyEntity.prototype.setEntityOrigins = function (origins) {
+        this._entityOrigins = origins.map(function (origin) { return new AcGePoint3d(origin.x, origin.y, origin.z); });
+    };
+    Object.defineProperty(AcDbProxyEntity.prototype, "geometricExtents", {
+        /**
+         * Gets the geometric extents of this proxy entity.
+         *
+         * When the proxy-graphic stream contains an {@link AcDbProxyGraphicType.Extents}
+         * chunk, the returned box is built from its minimum and maximum corners.
+         * Otherwise an empty {@link AcGeBox3d} is returned.
+         *
+         * @returns The axis-aligned bounding box derived from proxy graphics.
+         */
+        get: function () {
+            var graphic = this._proxyGraphic;
+            if (!(graphic === null || graphic === void 0 ? void 0 : graphic.length)) {
+                return new AcGeBox3d();
+            }
+            var parser = new AcDbProxyGraphic(graphic, {
+                database: this.database,
+                defaultLayer: this.layer
+            });
+            var extents = parser.scanExtents();
+            if (extents) {
+                return new AcGeBox3d().setFromPoints(extents);
+            }
+            return new AcGeBox3d();
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Transforms this proxy entity by the specified matrix.
+     *
+     * Only {@link entityOrigins} are modified. The proxy-graphic byte stream is
+     * left unchanged because transforms are encoded as {@link AcDbProxyGraphicType.PushMatrix}
+     * / {@link AcDbProxyGraphicType.PopMatrix} commands inside the stream and
+     * applied at render time by {@link AcDbProxyGraphic}.
+     *
+     * @param matrix - Transformation matrix to apply to entity origins.
+     * @returns This entity for chaining.
+     */
+    AcDbProxyEntity.prototype.transformBy = function (matrix) {
+        this._entityOrigins.forEach(function (origin) { return origin.applyMatrix4(matrix); });
+        return this;
+    };
+    /**
+     * Draws proxy graphics by decoding the binary stream and emitting primitives
+     * through the renderer.
+     *
+     * This is the primary world-space draw entry point for proxy entities. It
+     * delegates to {@link AcDbProxyGraphic.worldDraw} using the entity database
+     * and layer as rendering context.
+     *
+     * @param renderer - Target graphics renderer.
+     * @returns A grouped {@link AcGiEntity} when geometry was emitted, otherwise
+     *   `undefined`.
+     */
+    AcDbProxyEntity.prototype.subWorldDraw = function (renderer) {
+        var graphic = this._proxyGraphic;
+        if (!(graphic === null || graphic === void 0 ? void 0 : graphic.length)) {
+            return undefined;
+        }
+        var parser = new AcDbProxyGraphic(graphic, {
+            database: this.database,
+            defaultLayer: this.layer
+        });
+        return parser.worldDraw(renderer);
+    };
+    /**
+     * Writes DXF subclass fields for this proxy entity.
+     *
+     * Emits the `AcDbProxyEntity` subclass marker followed by group codes **1**,
+     * **3**, **1001**, **90**, **91**, **92**, **10**, **160**, and **310** as
+     * appropriate.
+     *
+     * @param filer - DXF output filer.
+     * @returns This entity for chaining.
+     */
+    AcDbProxyEntity.prototype.dxfOutFields = function (filer) {
+        var _a;
+        _super.prototype.dxfOutFields.call(this, filer);
+        filer.writeSubclassMarker('AcDbProxyEntity');
+        filer.writeString(1, this._originalDxfName);
+        if (this._originalClassName) {
+            filer.writeString(3, this._originalClassName);
+        }
+        if (this._applicationName) {
+            filer.writeString(1001, this._applicationName);
+        }
+        filer.writeInt32(90, this._proxyEntityClassId);
+        filer.writeInt32(91, this._graphicsMetafileType);
+        if (this._entityOrigins.length > 0) {
+            filer.writeInt32(92, this._entityOrigins.length);
+            this._entityOrigins.forEach(function (origin) {
+                filer.writePoint3d(10, origin);
+            });
+        }
+        if ((_a = this._proxyGraphic) === null || _a === void 0 ? void 0 : _a.length) {
+            filer.writeInt32(160, this._proxyGraphic.length);
+            var index = 0;
+            while (index < this._proxyGraphic.length) {
+                var chunk = this._proxyGraphic.subarray(index, index + 127);
+                filer.writeString(310, bytesToHexString(chunk));
+                index += 127;
+            }
+        }
+        return this;
+    };
+    /**
+     * Loads proxy-graphic bytes from DXF group codes **160** and **310**.
+     *
+     * @param length - Expected byte length from group code **160**. When provided
+     *   and positive, the result is truncated to this length.
+     * @param hexChunks - One or more hexadecimal strings from group code **310**.
+     */
+    AcDbProxyEntity.prototype.loadProxyGraphicFromDxf = function (length, hexChunks) {
+        var data = loadAcDbProxyGraphicFromDxf(length, hexChunks);
+        if (data) {
+            this.setProxyGraphic(data);
+        }
+    };
+    /**
+     * The runtime entity type name used by {@link AcDbEntity.type}.
+     *
+     * Always `'ProxyEntity'`.
+     */
+    AcDbProxyEntity.typeName = 'ProxyEntity';
+    return AcDbProxyEntity;
+}(AcDbEntity));
+export { AcDbProxyEntity };
+//# sourceMappingURL=AcDbProxyEntity.js.map

package/lib/entity/AcDbProxyEntity.js.map

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

package/lib/entity/index.d.ts

@@ -27,6 +27,7 @@ export type { AcDbTableBorderColors, AcDbTableCell, AcDbTableCellTypeOverride }
 export { AcDbText, AcDbTextHorizontalMode, AcDbTextVerticalMode } from './AcDbText';
 export { AcDbTrace } from './AcDbTrace';
 export { AcDbPolyline, offsetVertexPathAsPolyline } from './AcDbPolyline';
+export { AcDbProxyEntity } from './AcDbProxyEntity';
 export { AcDbPoint } from './AcDbPoint';
 export { AcDbRasterImage, AcDbRasterImageClipBoundaryType, AcDbRasterImageImageDisplayOpt } from './AcDbRasterImage';
 export { AcDbRay } from './AcDbRay';