@mlightcad/cad-simple-viewer 1.2.2 → 1.2.3

package/lib/app/AcApDocManager.js

@@ -0,0 +1,498 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { AcCmEventManager, acdbHostApplicationServices, AcGeBox2d } from '@mlightcad/data-model';
+import { AcTrMTextRenderer } from '@mlightcad/three-renderer';
+import { AcApConvertToSvgCmd, AcApOpenCmd, AcApPanCmd, AcApQNewCmd, AcApRegenCmd, AcApSelectCmd, AcApZoomCmd, AcApZoomToBoxCmd, AcEdCommandStack } from '../command';
+import { eventBus } from '../editor';
+import { AcTrView2d } from '../view';
+import { AcApContext } from './AcApContext';
+import { AcApDocument } from './AcApDocument';
+import { AcApFontLoader } from './AcApFontLoader';
+var DEFAULT_BASE_URL = 'https://mlightcad.gitlab.io/cad-data/';
+/**
+ * Document manager that handles CAD document lifecycle and provides the main entry point for the CAD viewer.
+ *
+ * This singleton class manages:
+ * - Document creation and opening (from URLs or file content)
+ * - View and context management
+ * - Command registration and execution
+ * - Font loading for text rendering
+ * - Event handling for document lifecycle
+ *
+ * The manager follows a singleton pattern to ensure only one instance manages the application state.
+ */
+var AcApDocManager = /** @class */ (function () {
+    /**
+     * Private constructor for singleton pattern.
+     *
+     * Creates an empty document with a 2D view and sets up the application context.
+     * Registers default commands and creates an example document.
+     *
+     * @param options -Options for creating AcApDocManager instance
+     * @private
+     */
+    function AcApDocManager(options) {
+        if (options === void 0) { options = {}; }
+        var _a;
+        /** Events fired during document lifecycle */
+        this.events = {
+            /** Fired when a new document is created */
+            documentCreated: new AcCmEventManager(),
+            /** Fired when a document becomes active */
+            documentActivated: new AcCmEventManager()
+        };
+        this._baseUrl = (_a = options.baseUrl) !== null && _a !== void 0 ? _a : DEFAULT_BASE_URL;
+        if (options.useMainThreadDraw) {
+            AcTrMTextRenderer.getInstance().setRenderMode('main');
+        }
+        else {
+            AcTrMTextRenderer.getInstance().setRenderMode('worker');
+        }
+        // Create one empty drawing
+        var doc = new AcApDocument();
+        doc.database.events.openProgress.addEventListener(function (args) {
+            eventBus.emit('open-file-progress', {
+                database: doc.database,
+                percentage: args.percentage,
+                stage: args.stage,
+                subStage: args.subStage,
+                subStageStatus: args.subStageStatus,
+                data: args.data
+            });
+        });
+        var callback = function () {
+            return {
+                width: window.innerWidth,
+                height: window.innerHeight - 30
+            };
+        };
+        var view = new AcTrView2d({
+            canvas: options.canvas,
+            calculateSizeCallback: callback
+        });
+        this._context = new AcApContext(view, doc);
+        this._fontLoader = new AcApFontLoader();
+        this._fontLoader.baseUrl = this._baseUrl + 'fonts/';
+        acdbHostApplicationServices().workingDatabase = doc.database;
+        this.registerCommands();
+    }
+    /**
+     * Creates the singleton instance with an optional canvas element.
+     *
+     * This method should be called before accessing the `instance` property
+     * if you want to provide a specific canvas element.
+     *
+     * @param options -Options for creating AcApDocManager instance
+     * @returns The singleton instance
+     */
+    AcApDocManager.createInstance = function (options) {
+        if (options === void 0) { options = {}; }
+        if (AcApDocManager._instance == null) {
+            AcApDocManager._instance = new AcApDocManager(options);
+        }
+        return this._instance;
+    };
+    Object.defineProperty(AcApDocManager, "instance", {
+        /**
+         * Gets the singleton instance of the document manager.
+         *
+         * Creates a new instance if one doesn't exist yet.
+         *
+         * @returns The singleton document manager instance
+         */
+        get: function () {
+            if (!AcApDocManager._instance) {
+                AcApDocManager._instance = new AcApDocManager();
+            }
+            return AcApDocManager._instance;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "context", {
+        /**
+         * Gets the current application context.
+         *
+         * The context binds the current document with its associated view.
+         *
+         * @returns The current application context
+         */
+        get: function () {
+            return this._context;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "curDocument", {
+        /**
+         * Gets the currently open CAD document.
+         *
+         * @returns The current document instance
+         */
+        get: function () {
+            return this._context.doc;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "mdiActiveDocument", {
+        /**
+         * Gets the currently active document.
+         *
+         * For now, this is the same as `curDocument` since only one document
+         * can be active at a time.
+         *
+         * @returns The current active document
+         */
+        get: function () {
+            return this._context.doc;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "curView", {
+        /**
+         * Gets the current 2D view used to display the drawing.
+         *
+         * @returns The current 2D view instance
+         */
+        get: function () {
+            return this._context.view;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "editor", {
+        /**
+         * Gets the editor instance for handling user input.
+         *
+         * @returns The current editor instance
+         */
+        get: function () {
+            return this._context.view.editor;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "baseUrl", {
+        /**
+         * Base URL to load fonts
+         */
+        get: function () {
+            return this._baseUrl;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApDocManager.prototype, "avaiableFonts", {
+        /**
+         * Gets the list of available fonts that can be loaded.
+         *
+         * Note: These fonts are available for loading but may not be loaded yet.
+         *
+         * @returns Array of available font names
+         */
+        get: function () {
+            return this._fontLoader.avaiableFonts;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Loads the specified fonts for text rendering.
+     *
+     * @param fonts - Array of font names to load
+     * @returns Promise that resolves when fonts are loaded
+     *
+     * @example
+     * ```typescript
+     * await docManager.loadFonts(['Arial', 'Times New Roman']);
+     * ```
+     */
+    AcApDocManager.prototype.loadFonts = function (fonts) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this._fontLoader.load(fonts)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Loads default fonts for CAD text rendering.
+     *
+     * This method loads either the specified fonts or falls back to default Chinese fonts
+     * (specifically 'simkai') if no fonts are provided. The loaded fonts are used for
+     * rendering CAD text entities like MText and Text in the viewer.
+     *
+     * It is better to load default fonts when viewer is initialized so that the viewer can
+     * render text correctly if fonts used in the document are not available.
+     *
+     * @param fonts - Optional array of font names to load. If not provided or null,
+     *               defaults to ['simkai'] for Chinese text support
+     * @returns Promise that resolves when all specified fonts are loaded
+     *
+     * @example
+     * ```typescript
+     * // Load default fonts (simkai)
+     * await docManager.loadDefaultFonts();
+     *
+     * // Load specific fonts
+     * await docManager.loadDefaultFonts(['Arial', 'SimSun']);
+     *
+     * // Load no fonts (empty array)
+     * await docManager.loadDefaultFonts([]);
+     * ```
+     *
+     * @see {@link AcApFontLoader.load} - The underlying font loading implementation
+     * @see {@link createExampleDoc} - Method that uses this for example document creation
+     */
+    AcApDocManager.prototype.loadDefaultFonts = function (fonts) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!(fonts == null)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this._fontLoader.load(['simkai'])];
+                    case 1:
+                        _a.sent();
+                        return [3 /*break*/, 4];
+                    case 2: return [4 /*yield*/, this._fontLoader.load(fonts)];
+                    case 3:
+                        _a.sent();
+                        _a.label = 4;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Opens a CAD document from a URL.
+     *
+     * This method loads a document from the specified URL and replaces the current document.
+     * It handles the complete document lifecycle including before/after open events.
+     *
+     * @param url - The URL of the CAD file to open
+     * @param options - Optional database opening options. If not provided, default options with font loader will be used
+     * @returns Promise that resolves to true if the document was successfully opened, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const success = await docManager.openUrl('https://example.com/drawing.dwg');
+     * if (success) {
+     *   console.log('Document opened successfully');
+     * }
+     * ```
+     */
+    AcApDocManager.prototype.openUrl = function (url, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var isSuccess;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.onBeforeOpenDocument();
+                        options = this.setOptions(options);
+                        return [4 /*yield*/, this.context.doc.openUri(url, options)];
+                    case 1:
+                        isSuccess = _a.sent();
+                        this.onAfterOpenDocument(isSuccess);
+                        return [2 /*return*/, isSuccess];
+                }
+            });
+        });
+    };
+    /**
+     * Opens a CAD document from file content.
+     *
+     * This method loads a document from the provided file content (binary data)
+     * and replaces the current document. It handles the complete document lifecycle
+     * including before/after open events.
+     *
+     * @param fileName - The name of the file being opened (used for format detection)
+     * @param content - The file content
+     * @param options - Database opening options including font loader settings
+     * @returns Promise that resolves to true if the document was successfully opened, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const fileContent = await file.arrayBuffer();
+     * const success = await docManager.openDocument('drawing.dwg', fileContent, options);
+     * ```
+     */
+    AcApDocManager.prototype.openDocument = function (fileName, content, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var isSuccess;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.onBeforeOpenDocument();
+                        options = this.setOptions(options);
+                        return [4 /*yield*/, this.context.doc.openDocument(fileName, content, options)];
+                    case 1:
+                        isSuccess = _a.sent();
+                        this.onAfterOpenDocument(isSuccess);
+                        return [2 /*return*/, isSuccess];
+                }
+            });
+        });
+    };
+    /**
+     * Redraws the current view. Currently it is used once you modified font mapping
+     * for missed fonts so that the drawing can apply new fonts.
+     */
+    AcApDocManager.prototype.regen = function () {
+        this.curView.clear();
+        this.context.doc.database.regen();
+    };
+    /**
+     * Registers all default commands available in the CAD viewer.
+     *
+     * This method sets up the command system by registering built-in commands including:
+     * - pan: Pan/move the view
+     * - select: Select entities
+     * - zoom: Zoom in/out
+     * - zoomw: Zoom to window/box
+     * - csvg: Convert to SVG
+     * - qnew: Quick new document
+     * - open: Open document
+     *
+     * All commands are registered under the system command group.
+     */
+    AcApDocManager.prototype.registerCommands = function () {
+        var register = AcEdCommandStack.instance;
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'pan', 'pan', new AcApPanCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'regen', 'regen', new AcApRegenCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'select', 'select', new AcApSelectCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'zoom', 'zoom', new AcApZoomCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'zoomw', 'zoomw', new AcApZoomToBoxCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'csvg', 'csvg', new AcApConvertToSvgCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'qnew', 'qnew', new AcApQNewCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'open', 'open', new AcApOpenCmd());
+    };
+    /**
+     * Executes a command by its string name.
+     *
+     * This method looks up a registered command by name and executes it with the current context.
+     * If the command is not found, no action is taken.
+     *
+     * @param cmdStr - The command string to execute (e.g., 'pan', 'zoom', 'select')
+     *
+     * @example
+     * ```typescript
+     * docManager.sendStringToExecute('zoom');
+     * docManager.sendStringToExecute('pan');
+     * ```
+     */
+    AcApDocManager.prototype.sendStringToExecute = function (cmdStr) {
+        var register = AcEdCommandStack.instance;
+        var cmd = register.lookupGlobalCmd(cmdStr);
+        cmd === null || cmd === void 0 ? void 0 : cmd.execute(this.context);
+    };
+    /**
+     * Configures layout information for the current view.
+     *
+     * Sets up the active layout block table record ID and model space block table
+     * record ID based on the current document's space configuration.
+     */
+    AcApDocManager.prototype.setActiveLayout = function () {
+        var currentView = this.curView;
+        currentView.activeLayoutBtrId = this.curDocument.database.currentSpaceId;
+        currentView.modelSpaceBtrId = this.curDocument.database.currentSpaceId;
+    };
+    /**
+     * Performs cleanup operations before opening a new document.
+     *
+     * This protected method is called automatically before any document opening operation.
+     * It clears the current view to prepare for the new document content.
+     *
+     * @protected
+     */
+    AcApDocManager.prototype.onBeforeOpenDocument = function () {
+        this.curView.clear();
+    };
+    /**
+     * Performs setup operations after a document opening attempt.
+     *
+     * This protected method is called automatically after any document opening operation.
+     * If the document was successfully opened, it dispatches the documentActivated event,
+     * sets up layout information, and zooms the view to fit the content.
+     *
+     * @param isSuccess - Whether the document was successfully opened
+     * @protected
+     */
+    AcApDocManager.prototype.onAfterOpenDocument = function (isSuccess) {
+        if (isSuccess) {
+            var doc = this.context.doc;
+            this.events.documentActivated.dispatch({ doc: doc });
+            this.setActiveLayout();
+            var db = doc.database;
+            // The extents of drawing database may be empty. Espically dxf files.
+            if (db.extents.isEmpty()) {
+                this.curView.zoomToFit();
+            }
+            else {
+                this.curView.zoomTo(new AcGeBox2d(db.extmin, db.extmax));
+            }
+        }
+    };
+    /**
+     * Sets up or validates database opening options.
+     *
+     * This private method ensures that the options object has a font loader configured.
+     * If no options are provided, creates new options with the font loader.
+     * If options are provided but missing a font loader, adds the font loader.
+     *
+     * @param options - Optional database opening options to validate/modify
+     * @returns The validated options object with font loader configured
+     * @private
+     */
+    AcApDocManager.prototype.setOptions = function (options) {
+        if (options == null) {
+            options = { fontLoader: this._fontLoader };
+        }
+        else if (options.fontLoader == null) {
+            options.fontLoader = this._fontLoader;
+        }
+        return options;
+    };
+    return AcApDocManager;
+}());
+export { AcApDocManager };
+//# sourceMappingURL=AcApDocManager.js.map

package/lib/app/AcApDocManager.js.map

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

package/lib/app/AcApDocument.d.ts

@@ -0,0 +1,101 @@
+import { AcDbDatabase, AcDbOpenDatabaseOptions } from '@mlightcad/data-model';
+/**
+ * Represents a CAD document that manages a drawing database and associated metadata.
+ *
+ * This class handles:
+ * - Opening CAD files from URIs or file content (DWG/DXF formats)
+ * - Managing document properties (title, read-only state)
+ * - Providing access to the underlying database
+ * - Handling file loading errors through event emission
+ */
+export declare class AcApDocument {
+    /** The URI of the opened document, if opened from a URI */
+    private _uri?;
+    /** The underlying CAD database containing all drawing data */
+    private _database;
+    /** The file name of the document */
+    private _fileName;
+    /** The display title of the document */
+    private _docTitle;
+    /** Whether the document is opened in read-only mode */
+    private _isReadOnly;
+    /**
+     * Creates a new document instance with an empty database.
+     *
+     * The document is initialized with an "Untitled" title and read-only mode enabled.
+     */
+    constructor();
+    /**
+     * Opens a CAD document from a URI.
+     *
+     * @param uri - The URI of the CAD file to open
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const success = await document.openUri('https://example.com/drawing.dwg', {
+     *   readOnly: true
+     * });
+     * ```
+     */
+    openUri(uri: string, options: AcDbOpenDatabaseOptions): Promise<boolean>;
+    /**
+     * Opens a CAD document from file content.
+     *
+     * @param fileName - The name of the file (used to determine file type from extension)
+     * @param content - The file content as string or ArrayBuffer
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const fileContent = await fetch('drawing.dwg').then(r => r.arrayBuffer());
+     * const success = await document.openDocument('drawing.dwg', fileContent, {
+     *   readOnly: false
+     * });
+     * ```
+     */
+    openDocument(fileName: string, content: ArrayBuffer, options: AcDbOpenDatabaseOptions): Promise<boolean>;
+    /**
+     * Gets the URI of the document if opened from a URI.
+     *
+     * @returns The document URI, or undefined if not opened from URI
+     */
+    get uri(): string | undefined;
+    /**
+     * Gets the database object containing all drawing data.
+     *
+     * @returns The underlying CAD database instance
+     */
+    get database(): AcDbDatabase;
+    /**
+     * Gets the display title of the document.
+     *
+     * @returns The document title displayed in the window/tab
+     */
+    get docTitle(): string;
+    /**
+     * Sets the display title of the document.
+     *
+     * Also updates the browser tab title if running in a browser environment.
+     *
+     * @param value - The new document title
+     */
+    set docTitle(value: string);
+    /**
+     * Gets whether the document is opened in read-only mode.
+     *
+     * @returns True if the document is read-only, false if editable
+     */
+    get isReadOnly(): boolean;
+    /**
+     * Extracts the file name from a URI.
+     *
+     * @param uri - The URI to extract the file name from
+     * @returns The extracted file name, or empty string if extraction fails
+     * @private
+     */
+    private getFileNameFromUri;
+}
+//# sourceMappingURL=AcApDocument.d.ts.map

package/lib/app/AcApDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApDocument.d.ts","sourceRoot":"","sources":["../../src/app/AcApDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAI9B;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,2DAA2D;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAQ;IACrB,8DAA8D;IAC9D,OAAO,CAAC,SAAS,CAAc;IAC/B,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAAa;IAC9B,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAa;IAC9B,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;OAIG;;IAMH;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;IAe3D;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,uBAAuB;IAoBlC;;;;OAIG;IACH,IAAI,GAAG,uBAEN;IAED;;;;OAIG;IACH,IAAI,QAAQ,iBAEX;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAWQ,MAAM,CATzB;IAED;;;;;;OAMG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAMzB;IAED;;;;OAIG;IACH,IAAI,UAAU,YAEb;IAED;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}