@mlightcad/data-model 1.1.2 → 1.1.4

package/lib/database/AcDbDatabase.js

@@ -62,29 +62,48 @@ import { AcDbLinetypeTable } from './AcDbLinetypeTable';
 import { AcDbTextStyleTable } from './AcDbTextStyleTable';
 import { AcDbViewportTable } from './AcDbViewportTable';
 /**
- * The AcDbDatabase class represents the AutoCAD drawing file. Each AcDbDatabase object contains
- * the various header variables, symbol tables, table records, entities, and objects that make up
- * the drawing. The AcDbDatabase class has member functions to allow access to all the symbol tables,
- * to read and write to DWG files, to get or set database defaults, to execute various database-level
- * operations, and to get or set all header variables.
+ * The AcDbDatabase class represents an AutoCAD drawing file.
+ *
+ * Each AcDbDatabase object contains the various header variables, symbol tables,
+ * table records, entities, and objects that make up the drawing. The AcDbDatabase
+ * class has member functions to allow access to all the symbol tables, to read
+ * and write to DWG files, to get or set database defaults, to execute various
+ * database-level operations, and to get or set all header variables.
+ *
+ * @example
+ * ```typescript
+ * const database = new AcDbDatabase();
+ * await database.read(dxfData, { readOnly: true });
+ * const entities = database.tables.blockTable.modelSpace.entities;
+ * ```
  */
 var AcDbDatabase = /** @class */ (function (_super) {
     __extends(AcDbDatabase, _super);
     /**
-     * Default constructor.
-     * If buildDefaultDrawing == true, then the new AcDbDatabase object contains the minimum necessary
-     * for a complete database. If buildDefaultDrawing == false, then the new AcDbDatabase object is
-     * completely empty.
+     * Creates a new AcDbDatabase instance.
      */
     function AcDbDatabase() {
         var _this = _super.call(this) || this;
+        /**
+         * Events that can be triggered by the database.
+         *
+         * These events allow applications to respond to various database operations
+         * such as entity modifications, layer changes, and progress updates.
+         */
         _this.events = {
+            /** Fired when an entity is appended to the database */
             entityAppended: new AcCmEventManager(),
+            /** Fired when an entity is modified in the database */
             entityModified: new AcCmEventManager(),
+            /** Fired when a layer is appended to the database */
             layerAppended: new AcCmEventManager(),
+            /** Fired when a layer is modified in the database */
             layerModified: new AcCmEventManager(),
+            /** Fired when a layer is erased from the database */
             layerErased: new AcCmEventManager(),
+            /** Fired during database opening operations to report progress */
             openProgress: new AcCmEventManager(),
+            /** Fired when a header system variable is changed */
             headerSysVarChanged: new AcCmEventManager()
         };
         _this._angBase = 0;
@@ -113,7 +132,16 @@ var AcDbDatabase = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbDatabase.prototype, "tables", {
         /**
-         * All of tables in this drawing database
+         * Gets all tables in this drawing database.
+         *
+         * @returns Object containing all the symbol tables in the database
+         *
+         * @example
+         * ```typescript
+         * const tables = database.tables;
+         * const layers = tables.layerTable;
+         * const blocks = tables.blockTable;
+         * ```
          */
         get: function () {
             return this._tables;
@@ -123,7 +151,15 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "dictionaries", {
         /**
-         * All of named object dictionaries in this drawing database
+         * Gets all named object dictionaries in this drawing database.
+         *
+         * @returns Object containing all the dictionaries in the database
+         *
+         * @example
+         * ```typescript
+         * const dictionaries = database.dictionaries;
+         * const layouts = dictionaries.layouts;
+         * ```
          */
         get: function () {
             return this._dictionaries;
@@ -133,7 +169,16 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "currentSpaceId", {
         /**
-         * The object ID of the AcDbBlockTableRecord of the current space (e.g., model space or paper space.)
+         * Gets the object ID of the AcDbBlockTableRecord of the current space.
+         *
+         * The current space can be either model space or paper space.
+         *
+         * @returns The object ID of the current space
+         *
+         * @example
+         * ```typescript
+         * const currentSpaceId = database.currentSpaceId;
+         * ```
          */
         get: function () {
             if (!this._currentSpace) {
@@ -141,6 +186,17 @@ var AcDbDatabase = /** @class */ (function (_super) {
             }
             return this._currentSpace.objectId;
         },
+        /**
+         * Sets the current space by object ID.
+         *
+         * @param value - The object ID of the block table record to set as current space
+         * @throws {Error} When the specified block table record ID doesn't exist
+         *
+         * @example
+         * ```typescript
+         * database.currentSpaceId = 'some-block-record-id';
+         * ```
+         */
         set: function (value) {
             var currentSpace = this.tables.blockTable.getIdAt(value);
             if (currentSpace == null) {
@@ -155,11 +211,30 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "aunits", {
         /**
-         * Angle units. It is the current AUNITS value for the database.
+         * Gets the angle units for the database.
+         *
+         * This is the current AUNITS value for the database.
+         *
+         * @returns The angle units value
+         *
+         * @example
+         * ```typescript
+         * const angleUnits = database.aunits;
+         * ```
          */
         get: function () {
             return this._aunits;
         },
+        /**
+         * Sets the angle units for the database.
+         *
+         * @param value - The new angle units value
+         *
+         * @example
+         * ```typescript
+         * database.aunits = AcDbAngleUnits.DecimalDegrees;
+         * ```
+         */
         set: function (value) {
             this._aunits = value || 0;
             this.triggerHeaderSysVarChangedEvent('aunits');
@@ -169,12 +244,30 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "insunits", {
         /**
-         * The drawing-units value for automatic scaling of blocks, images, or xrefs when inserted or attached
-         * to a drawing. It is the current INSUNITS value for the database.
+         * Gets the drawing-units value for automatic scaling of blocks, images, or xrefs.
+         *
+         * This is the current INSUNITS value for the database.
+         *
+         * @returns The insertion units value
+         *
+         * @example
+         * ```typescript
+         * const insertionUnits = database.insunits;
+         * ```
          */
         get: function () {
             return this._insunits;
         },
+        /**
+         * Sets the drawing-units value for automatic scaling.
+         *
+         * @param value - The new insertion units value
+         *
+         * @example
+         * ```typescript
+         * database.insunits = AcDbUnitsValue.Millimeters;
+         * ```
+         */
         set: function (value) {
             // TODO: Default value is 1 (imperial) or 4 (metric)
             this._insunits = value || 4;
@@ -185,11 +278,28 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "ltscale", {
         /**
-         * The line type scale factor.
+         * Gets the line type scale factor.
+         *
+         * @returns The line type scale factor
+         *
+         * @example
+         * ```typescript
+         * const lineTypeScale = database.ltscale;
+         * ```
          */
         get: function () {
             return this._ltscale;
         },
+        /**
+         * Sets the line type scale factor.
+         *
+         * @param value - The new line type scale factor
+         *
+         * @example
+         * ```typescript
+         * database.ltscale = 2.0;
+         * ```
+         */
         set: function (value) {
             this._ltscale = value || 1;
             this.triggerHeaderSysVarChangedEvent('ltscale');
@@ -199,11 +309,28 @@ var AcDbDatabase = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbDatabase.prototype, "cecolor", {
         /**
-         * The color of new objects as you create them.
+         * Gets the color of new objects as they are created.
+         *
+         * @returns The current entity color
+         *
+         * @example
+         * ```typescript
+         * const currentColor = database.cecolor;
+         * ```
          */
         get: function () {
             return this._cecolor;
         },
+        /**
+         * Sets the color of new objects as they are created.
+         *
+         * @param value - The new current entity color
+         *
+         * @example
+         * ```typescript
+         * database.cecolor = new AcCmColor(0xFF0000);
+         * ```
+         */
         set: function (value) {
             this._cecolor = value || 0;
             this.triggerHeaderSysVarChangedEvent('cecolor');
@@ -289,10 +416,28 @@ var AcDbDatabase = /** @class */ (function (_super) {
         configurable: true
     });
     /**
-     * Read AutoCAD drawing specified by data into the database object.
-     * @param data Input contents of one AutoCAD file
-     * @param options Input options to read drawing data
-     * @param fileType Input file type of the drawing
+     * Reads drawing data from a string or ArrayBuffer.
+     *
+     * This method parses the provided data and populates the database with
+     * the resulting entities, tables, and objects. The method supports
+     * both DXF and DWG file formats.
+     *
+     * @param data - The drawing data as a string or ArrayBuffer
+     *   - For DXF files: Pass a string containing the DXF content
+     *   - For DWG files: Pass an ArrayBuffer instance containing the binary DWG data
+     * @param options - Options for reading the database
+     * @param fileType - The type of file being read (defaults to DXF)
+     *
+     * @example
+     * ```typescript
+     * // Reading a DXF file (string)
+     * const database = new AcDbDatabase();
+     * await database.read(dxfString, { readOnly: true }, AcDbFileType.DXF);
+     *
+     * // Reading a DWG file (ArrayBuffer)
+     * const database = new AcDbDatabase();
+     * await database.read(dwgArrayBuffer, { readOnly: true }, AcDbFileType.DWG);
+     * ```
      */
     AcDbDatabase.prototype.read = function (data_1, options_1) {
         return __awaiter(this, arguments, void 0, function (data, options, fileType) {
@@ -314,7 +459,8 @@ var AcDbDatabase = /** @class */ (function (_super) {
                                             this.events.openProgress.dispatch({
                                                 database: this,
                                                 percentage: percentage,
-                                                stage: stage,
+                                                stage: 'CONVERSION',
+                                                subStage: stage,
                                                 stageStatus: stageStatus
                                             });
                                             if (!(options &&
@@ -340,48 +486,93 @@ var AcDbDatabase = /** @class */ (function (_super) {
         });
     };
     /**
-     * Read AutoCAD DXF drawing specified by the URL into the database object.
-     * @param url Input the URL linked to one AutoCAD DXF file
+     * Read AutoCAD DXF or DWG drawing specified by the URL into the database object.
+     * The method automatically detects the file type based on the URL extension:
+     * - .dxf files are read as text using readAsText()
+     * - .dwg files are read as binary data using readAsArrayBuffer()
+     * @param url Input the URL linked to one AutoCAD DXF or DWG file
      * @param options Input options to read drawing data
      */
     AcDbDatabase.prototype.openUri = function (url, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var response, blob, reader;
-            var _this = this;
+            var response, fileExtension, content, content;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, fetch(url)];
+                    case 0:
+                        this.events.openProgress.dispatch({
+                            database: this,
+                            percentage: 0,
+                            stage: 'FETCH_FILE',
+                            stageStatus: 'START'
+                        });
+                        return [4 /*yield*/, fetch(url)];
                     case 1:
                         response = _a.sent();
-                        return [4 /*yield*/, response.blob()];
+                        this.events.openProgress.dispatch({
+                            database: this,
+                            percentage: 100,
+                            stage: 'FETCH_FILE',
+                            stageStatus: 'END'
+                        });
+                        if (!response.ok) {
+                            throw new Error("Failed to fetch file '".concat(url, "' with HTTP status codee '").concat(response.status, "'!"));
+                        }
+                        fileExtension = url.toLowerCase().split('.').pop();
+                        if (!(fileExtension === 'dwg')) return [3 /*break*/, 4];
+                        return [4 /*yield*/, response.arrayBuffer()];
                     case 2:
-                        blob = _a.sent();
-                        reader = new FileReader();
-                        reader.onload = function (event) {
-                            var _a;
-                            var content = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
-                            if (content)
-                                _this.read(content, options);
-                        };
-                        reader.readAsText(blob);
-                        return [2 /*return*/];
+                        content = _a.sent();
+                        return [4 /*yield*/, this.read(content, options, AcDbFileType.DWG)];
+                    case 3:
+                        _a.sent();
+                        return [3 /*break*/, 7];
+                    case 4: return [4 /*yield*/, response.text()];
+                    case 5:
+                        content = _a.sent();
+                        return [4 /*yield*/, this.read(content, options, AcDbFileType.DXF)];
+                    case 6:
+                        _a.sent();
+                        _a.label = 7;
+                    case 7: return [2 /*return*/];
                 }
             });
         });
     };
     /**
-     * Clear drawing database. It is needed when opening one drawing.
+     * Clears all data from the database.
+     *
+     * This method removes all entities, tables, and objects from the database,
+     * effectively resetting it to an empty state.
+     *
+     * @example
+     * ```typescript
+     * database.clear();
+     * ```
      */
     AcDbDatabase.prototype.clear = function () {
-        this.tables.blockTable.removeAll();
-        this.tables.dimStyleTable.removeAll();
-        this.tables.layerTable.removeAll();
-        this.tables.linetypeTable.removeAll();
-        this.tables.textStyleTable.removeAll();
-        this.tables.viewportTable.removeAll();
-        this.dictionaries.layouts.removeAll();
+        // Clear all tables and dictionaries
+        this._tables.blockTable.removeAll();
+        this._tables.dimStyleTable.removeAll();
+        this._tables.linetypeTable.removeAll();
+        this._tables.textStyleTable.removeAll();
+        this._tables.layerTable.removeAll();
+        this._tables.viewportTable.removeAll();
+        this._dictionaries.layouts.removeAll();
         this._currentSpace = undefined;
     };
+    /**
+     * Triggers a header system variable changed event.
+     *
+     * This method is called internally when header system variables
+     * are modified to notify listeners of the change.
+     *
+     * @param sysVarName - The name of the system variable that changed
+     *
+     * @example
+     * ```typescript
+     * database.triggerHeaderSysVarChangedEvent('aunits');
+     * ```
+     */
     AcDbDatabase.prototype.triggerHeaderSysVarChangedEvent = function (sysVarName) {
         this.events.headerSysVarChanged.dispatch({
             database: this,

package/lib/database/AcDbDatabase.js.map

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

package/lib/database/AcDbDatabaseConverter.d.ts

@@ -1,11 +1,17 @@
 import { AcDbDatabase } from './AcDbDatabase';
+/**
+ * Represents the different stages of DXF/DWG file conversion.
+ *
+ * These stages define the order and types of operations performed
+ * during the conversion of a DXF or DWG file into an AcDbDatabase.
+ */
 export type AcDbConversionStage = 
 /**
  * Start DXF/DWG file conversion
  */
 'START'
 /**
- * Prasing DXF/DWG file
+ * Parsing DXF/DWG file
  */
  | 'PARSE'
 /**
@@ -56,9 +62,36 @@ export type AcDbConversionStage =
  * Finish file conversion
  */
  | 'END';
-export type AcDbConversionStageStatus = 'START' | 'END' | 'IN-PROGRESS';
 /**
- * Callback function to update progress when parsing one file
+ * Represents the status of a stage.
+ */
+export type AcDbStageStatus = 'START' | 'END' | 'IN-PROGRESS';
+/**
+ * Callback function to update progress when parsing one file.
+ *
+ * This callback is called during the conversion process to provide
+ * progress updates and stage information.
+ *
+ * @param percentage - Finish percentage (0-100)
+ * @param stage - Name of the current stage
+ * @param stageStatus - Status of the current stage
+ * @param data - Store data associated with the current stage. Its meaning varies by stage:
+ *   - 'FONT' stage: fonts needed by this drawing
+ *
+ * @example
+ * ```typescript
+ * const progressCallback: AcDbConversionProgressCallback = async (
+ *   percentage,
+ *   stage,
+ *   stageStatus,
+ *   data
+ * ) => {
+ *   console.log(`Progress: ${percentage}% - Stage: ${stage} - Status: ${stageStatus}`);
+ *   if (stage === 'FONT' && data) {
+ *     console.log('Fonts needed:', data);
+ *   }
+ * };
+ * ```
  */
 export type AcDbConversionProgressCallback = (
 /**
@@ -72,7 +105,7 @@ stage: AcDbConversionStage,
 /**
  * Status of the current stage.
  */
-stageStatus: AcDbConversionStageStatus, 
+stageStatus: AcDbStageStatus, 
 /**
  * Store data associated with the current stage. Its meaning of different stages are as follows.
  * - 'FONT' stage: fonts needed by this drawing
@@ -80,25 +113,57 @@ stageStatus: AcDbConversionStageStatus,
  * Note: For now, 'FONT' stage uses this field only.
  */
 data?: unknown) => Promise<void>;
+/**
+ * Interface defining performance data for database conversion.
+ */
 export interface AcDbConvertDatabasePerformanceData {
     [key: string]: number;
     total: number;
 }
 /**
- * It defines interface that one drawing database convert should follow. One drawing database converter
- * can convert one dxf/dwg file to one instance of AcDbDatabase.
+ * Abstract base class for database converters.
+ *
+ * This class provides the foundation for converting various file formats
+ * (such as DXF, DWG) into AcDbDatabase objects. It handles the conversion
+ * process in stages and provides progress tracking capabilities.
+ *
+ * @template TModel - The type of the parsed model data
+ *
+ * @example
+ * ```typescript
+ * class MyConverter extends AcDbDatabaseConverter<MyModel> {
+ *   protected parse(data: string | ArrayBuffer): MyModel {
+ *     // Implementation for parsing data
+ *   }
+ *
+ *   protected processEntities(model: MyModel, db: AcDbDatabase) {
+ *     // Implementation for processing entities
+ *   }
+ * }
+ * ```
  */
 export declare abstract class AcDbDatabaseConverter<TModel = unknown> {
+    /** Optional progress callback for tracking conversion progress */
     progress?: AcDbConversionProgressCallback;
     /**
-     * Read the drawing specified by data and store them into the specified database. It will break up
-     * entities in the drawing into smaller chunks that are processed asynchronously to allow the UI to
-     * remain responsive.
-     * @param data Input drawing data in dxf format
-     * @param db Input database to store drawing data
-     * @param progress Input optional callback function to update progress
-     * @param minimumChunkSize Input the minimum number of entities in one chunk. If it is greater than
-     * the total number of entities to process, the total number is used.
+     * Reads and converts data into an AcDbDatabase.
+     *
+     * This method orchestrates the entire conversion process, including
+     * parsing, processing various components (fonts, linetypes, styles, etc.),
+     * and building the final database.
+     *
+     * @param data - The input data to convert (string or ArrayBuffer)
+     * @param db - The database to populate with converted data
+     * @param minimumChunkSize - Minimum chunk size for batch processing
+     * @param progress - Optional progress callback
+     * @returns Promise that resolves when conversion is complete
+     *
+     * @example
+     * ```typescript
+     * const converter = new MyConverter();
+     * const database = new AcDbDatabase();
+     * await converter.read(dxfData, database, 100, progressCallback);
+     * ```
      */
     read(data: string | ArrayBuffer, db: AcDbDatabase, minimumChunkSize: number, progress?: AcDbConversionProgressCallback): Promise<void>;
     protected onFinished(): void;

package/lib/database/AcDbDatabaseConverter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbDatabaseConverter.d.ts","sourceRoot":"","sources":["../../src/database/AcDbDatabaseConverter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,MAAM,MAAM,mBAAmB;AAC7B;;GAEG;AACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,MAAM;AACR;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,UAAU;AACZ;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,cAAc;AAChB;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,KAAK,CAAA;AAET,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,KAAK,GAAG,aAAa,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;AAC3C;;GAEG;AACH,UAAU,EAAE,MAAM;AAClB;;GAEG;AACH,KAAK,EAAE,mBAAmB;AAC1B;;GAEG;AACH,WAAW,EAAE,yBAAyB;AACtC;;;;;GAKG;AACH,IAAI,CAAC,EAAE,OAAO,KACX,OAAO,CAAC,IAAI,CAAC,CAAA;AAqBlB,MAAM,WAAW,kCAAkC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AA6DD;;;GAGG;AACH,8BAAsB,qBAAqB,CAAC,MAAM,GAAG,OAAO;IAC1D,QAAQ,CAAC,EAAE,8BAA8B,CAAA;IAEzC;;;;;;;;;OASG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,EAAE,EAAE,YAAY,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,8BAA8B;IAuO3C,SAAS,CAAC,UAAU;IAQpB,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM;IAIpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI7D,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI9D,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI1D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,eAAe,CACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,YAAY,EACjB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAC9B,SAAS,CAAC,EAAE,8BAA8B;CAI7C"}
+{"version":3,"file":"AcDbDatabaseConverter.d.ts","sourceRoot":"","sources":["../../src/database/AcDbDatabaseConverter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB;AAC7B;;GAEG;AACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,MAAM;AACR;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,UAAU;AACZ;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,cAAc;AAChB;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,OAAO;AACT;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,QAAQ;AACV;;GAEG;GACD,KAAK,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,GAAG,aAAa,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,8BAA8B,GAAG;AAC3C;;GAEG;AACH,UAAU,EAAE,MAAM;AAClB;;GAEG;AACH,KAAK,EAAE,mBAAmB;AAC1B;;GAEG;AACH,WAAW,EAAE,eAAe;AAC5B;;;;;GAKG;AACH,IAAI,CAAC,EAAE,OAAO,KACX,OAAO,CAAC,IAAI,CAAC,CAAA;AA2BlB;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AA+DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,qBAAqB,CAAC,MAAM,GAAG,OAAO;IAC1D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,8BAA8B,CAAA;IAEzC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,EAAE,EAAE,YAAY,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,8BAA8B;IAuO3C,SAAS,CAAC,UAAU;IAQpB,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM;IAIpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI7D,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI5D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI9D,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAI1D,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY;IAIzD,SAAS,CAAC,eAAe,CACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,YAAY,EACjB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAC9B,SAAS,CAAC,EAAE,8BAA8B;CAI7C"}