@mlightcad/cad-simple-viewer 1.5.0 → 1.5.1

package/lib/command/convert/AcApExportHtmlCmd.js

@@ -0,0 +1,93 @@
+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 __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 { AcEdCommand } from '../../editor';
+import { AcApHtmlConvertor } from './AcApHtmlConvertor';
+/**
+ * Editor command that exports the active drawing as a self-contained HTML file.
+ *
+ * The command delegates to {@link AcApHtmlConvertor}, which serializes the
+ * current Three.js scene into an {@link AcExSnapshotV1} HTML snapshot,
+ * bundles the offline viewer runtime, and triggers a browser download. No
+ * prompts are shown; the output filename is derived from the document name.
+ */
+var AcApExportHtmlCmd = /** @class */ (function (_super) {
+    __extends(AcApExportHtmlCmd, _super);
+    function AcApExportHtmlCmd() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    /**
+     * Runs the HTML export workflow for the drawing in `context`.
+     *
+     * @param context - Active application context; only `context.doc.fileName` is
+     *   used today to suggest the downloaded file name.
+     * @returns Resolves when the HTML file has been generated and the download
+     *   has been initiated, or rejects if runtime loading or packaging fails.
+     */
+    AcApExportHtmlCmd.prototype.execute = function (context) {
+        return __awaiter(this, void 0, void 0, function () {
+            var converter;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        converter = new AcApHtmlConvertor();
+                        return [4 /*yield*/, converter.convert(context.doc.fileName)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return AcApExportHtmlCmd;
+}(AcEdCommand));
+export { AcApExportHtmlCmd };
+//# sourceMappingURL=AcApExportHtmlCmd.js.map

package/lib/command/convert/AcApExportHtmlCmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApExportHtmlCmd.js","sourceRoot":"","sources":["../../../src/command/convert/AcApExportHtmlCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;GAOG;AACH;IAAuC,qCAAW;IAAlD;;IAaA,CAAC;IAZC;;;;;;;OAOG;IACG,mCAAO,GAAb,UAAc,OAAoB;;;;;;wBAC1B,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAA;wBACzC,qBAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAA;;wBAA7C,SAA6C,CAAA;;;;;KAC9C;IACH,wBAAC;AAAD,CAAC,AAbD,CAAuC,WAAW,GAajD"}

package/lib/command/convert/AcApHtmlConvertor.d.ts

@@ -0,0 +1,61 @@
+import { type AcExSnapshotV1 } from '@mlightcad/cad-html-exporter';
+/**
+ * Orchestrates export of the active drawing to a downloadable HTML file.
+ *
+ * Workflow:
+ * 1. Build a display-only {@link AcExSnapshotV1} from the current scene and database.
+ * 2. Fetch the IIFE viewer runtime (inlined into the HTML).
+ * 3. Package snapshot + runtime via `packHtml` and trigger a browser download.
+ *
+ * A busy indicator is shown for the duration of the operation. The UI thread
+ * is yielded between heavy steps so the browser can repaint.
+ */
+export declare class AcApHtmlConvertor {
+    /** Collects geometry and metadata from the live Three.js scene. */
+    private readonly _snapshotBuilder;
+    /**
+     * Exports the document currently open in {@link AcApDocManager}.
+     *
+     * @param fileName - Optional base name for the download (without extension).
+     *   When omitted, the active document's `fileName` is used. A `.html` suffix
+     *   is always applied; `.dwg` / `.dxf` suffixes on the input are stripped.
+     * @returns Resolves when packaging and download complete.
+     */
+    convert(fileName?: string): Promise<void>;
+    /**
+     * Packages a pre-built snapshot into HTML and downloads it.
+     *
+     * Skips scene collection; useful for tests, CLI tooling, or re-exporting a
+     * snapshot produced elsewhere.
+     *
+     * @param snapshot - Complete v1 snapshot to embed in the HTML.
+     * @param downloadName - File name passed to the browser download API (should
+     *   include the `.html` extension).
+     * @returns Resolves when packaging and download complete.
+     */
+    packSnapshot(snapshot: AcExSnapshotV1, downloadName: string): Promise<void>;
+    /**
+     * Fetches the offline viewer runtime as source text for inlining.
+     *
+     * @param url - Absolute or relative URL of `viewer-runtime.iife.js`. When
+     *   omitted, {@link DEFAULT_RUNTIME_URL} is used.
+     * @returns The runtime script body as a string.
+     * @throws If the HTTP response is not OK (missing build artifact, CORS, etc.).
+     */
+    private loadViewerRuntime;
+    /**
+     * Derives the browser download file name from a drawing file name.
+     *
+     * @param fileName - Source drawing name (may include `.dwg` or `.dxf`).
+     * @returns Base name without drawing extension, plus `.html`.
+     */
+    private resolveDownloadName;
+    /**
+     * Triggers a client-side download of the generated HTML string.
+     *
+     * @param content - Full HTML document text.
+     * @param downloadName - Value for the anchor `download` attribute.
+     */
+    private downloadHtml;
+}
+//# sourceMappingURL=AcApHtmlConvertor.d.ts.map

package/lib/command/convert/AcApHtmlConvertor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApHtmlConvertor.d.ts","sourceRoot":"","sources":["../../../src/command/convert/AcApHtmlConvertor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAY,MAAM,8BAA8B,CAAA;AAY5E;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgC;IAEjE;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM;IA0C/B;;;;;;;;;;OAUG;IACG,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM;IAqBjE;;;;;;;OAOG;YACW,iBAAiB;IAY/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAWrB"}

package/lib/command/convert/AcApHtmlConvertor.js

@@ -0,0 +1,223 @@
+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 { packHtml } from '@mlightcad/cad-html-exporter';
+import { AcApDocManager } from '../../app';
+import { yieldToMain } from '../../util';
+import { AcApHtmlSnapshotBuilder } from './AcApHtmlSnapshotBuilder';
+/**
+ * Relative URL of the bundled offline viewer script when no override is
+ * configured on {@link AcApDocManager.htmlViewerRuntimeUrl}.
+ */
+var DEFAULT_RUNTIME_URL = './viewer-runtime.iife.js';
+/**
+ * Orchestrates export of the active drawing to a downloadable HTML file.
+ *
+ * Workflow:
+ * 1. Build a display-only {@link AcExSnapshotV1} from the current scene and database.
+ * 2. Fetch the IIFE viewer runtime (inlined into the HTML).
+ * 3. Package snapshot + runtime via `packHtml` and trigger a browser download.
+ *
+ * A busy indicator is shown for the duration of the operation. The UI thread
+ * is yielded between heavy steps so the browser can repaint.
+ */
+var AcApHtmlConvertor = /** @class */ (function () {
+    function AcApHtmlConvertor() {
+        /** Collects geometry and metadata from the live Three.js scene. */
+        this._snapshotBuilder = new AcApHtmlSnapshotBuilder();
+    }
+    /**
+     * Exports the document currently open in {@link AcApDocManager}.
+     *
+     * @param fileName - Optional base name for the download (without extension).
+     *   When omitted, the active document's `fileName` is used. A `.html` suffix
+     *   is always applied; `.dwg` / `.dxf` suffixes on the input are stripped.
+     * @returns Resolves when packaging and download complete.
+     */
+    AcApHtmlConvertor.prototype.convert = function (fileName) {
+        return __awaiter(this, void 0, void 0, function () {
+            var docManager, document_1, view, snapshot, viewerRuntime, html;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        docManager = AcApDocManager.instance;
+                        docManager.showBusyIndicator();
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, , 8, 9]);
+                        return [4 /*yield*/, yieldToMain()];
+                    case 2:
+                        _a.sent();
+                        document_1 = docManager.curDocument;
+                        view = docManager.curView;
+                        return [4 /*yield*/, this._snapshotBuilder.buildAsync(view.cadScene, document_1.database, {
+                                title: fileName !== null && fileName !== void 0 ? fileName : document_1.fileName,
+                                background: view.backgroundColor
+                            })];
+                    case 3:
+                        snapshot = _a.sent();
+                        return [4 /*yield*/, yieldToMain()];
+                    case 4:
+                        _a.sent();
+                        return [4 /*yield*/, this.loadViewerRuntime(docManager.htmlViewerRuntimeUrl)];
+                    case 5:
+                        viewerRuntime = _a.sent();
+                        return [4 /*yield*/, yieldToMain()];
+                    case 6:
+                        _a.sent();
+                        html = packHtml(snapshot, {
+                            title: snapshot.meta.title,
+                            viewerRuntime: viewerRuntime
+                        });
+                        return [4 /*yield*/, yieldToMain()];
+                    case 7:
+                        _a.sent();
+                        this.downloadHtml(html, this.resolveDownloadName(fileName !== null && fileName !== void 0 ? fileName : document_1.fileName));
+                        return [3 /*break*/, 9];
+                    case 8:
+                        docManager.hideBusyIndicator();
+                        return [7 /*endfinally*/];
+                    case 9: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Packages a pre-built snapshot into HTML and downloads it.
+     *
+     * Skips scene collection; useful for tests, CLI tooling, or re-exporting a
+     * snapshot produced elsewhere.
+     *
+     * @param snapshot - Complete v1 snapshot to embed in the HTML.
+     * @param downloadName - File name passed to the browser download API (should
+     *   include the `.html` extension).
+     * @returns Resolves when packaging and download complete.
+     */
+    AcApHtmlConvertor.prototype.packSnapshot = function (snapshot, downloadName) {
+        return __awaiter(this, void 0, void 0, function () {
+            var docManager, viewerRuntime, html;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        docManager = AcApDocManager.instance;
+                        docManager.showBusyIndicator();
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, , 6, 7]);
+                        return [4 /*yield*/, yieldToMain()];
+                    case 2:
+                        _a.sent();
+                        return [4 /*yield*/, this.loadViewerRuntime(docManager.htmlViewerRuntimeUrl)];
+                    case 3:
+                        viewerRuntime = _a.sent();
+                        return [4 /*yield*/, yieldToMain()];
+                    case 4:
+                        _a.sent();
+                        html = packHtml(snapshot, {
+                            title: snapshot.meta.title,
+                            viewerRuntime: viewerRuntime
+                        });
+                        return [4 /*yield*/, yieldToMain()];
+                    case 5:
+                        _a.sent();
+                        this.downloadHtml(html, downloadName);
+                        return [3 /*break*/, 7];
+                    case 6:
+                        docManager.hideBusyIndicator();
+                        return [7 /*endfinally*/];
+                    case 7: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Fetches the offline viewer runtime as source text for inlining.
+     *
+     * @param url - Absolute or relative URL of `viewer-runtime.iife.js`. When
+     *   omitted, {@link DEFAULT_RUNTIME_URL} is used.
+     * @returns The runtime script body as a string.
+     * @throws If the HTTP response is not OK (missing build artifact, CORS, etc.).
+     */
+    AcApHtmlConvertor.prototype.loadViewerRuntime = function (url) {
+        return __awaiter(this, void 0, void 0, function () {
+            var runtimeUrl, response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        runtimeUrl = url != null ? String(url) : DEFAULT_RUNTIME_URL;
+                        return [4 /*yield*/, fetch(runtimeUrl)];
+                    case 1:
+                        response = _a.sent();
+                        if (!response.ok) {
+                            throw new Error("Failed to load HTML viewer runtime from \"".concat(runtimeUrl, "\" (").concat(response.status, "). ") +
+                                'Build @mlightcad/cad-html-exporter and copy viewer-runtime.iife.js to your app assets.');
+                        }
+                        return [2 /*return*/, response.text()];
+                }
+            });
+        });
+    };
+    /**
+     * Derives the browser download file name from a drawing file name.
+     *
+     * @param fileName - Source drawing name (may include `.dwg` or `.dxf`).
+     * @returns Base name without drawing extension, plus `.html`.
+     */
+    AcApHtmlConvertor.prototype.resolveDownloadName = function (fileName) {
+        var base = fileName.replace(/\.(dwg|dxf)$/i, '') || 'drawing';
+        return "".concat(base, ".html");
+    };
+    /**
+     * Triggers a client-side download of the generated HTML string.
+     *
+     * @param content - Full HTML document text.
+     * @param downloadName - Value for the anchor `download` attribute.
+     */
+    AcApHtmlConvertor.prototype.downloadHtml = function (content, downloadName) {
+        var blob = new Blob([content], { type: 'text/html;charset=utf-8' });
+        var url = URL.createObjectURL(blob);
+        var link = document.createElement('a');
+        link.href = url;
+        link.download = downloadName;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        URL.revokeObjectURL(url);
+    };
+    return AcApHtmlConvertor;
+}());
+export { AcApHtmlConvertor };
+//# sourceMappingURL=AcApHtmlConvertor.js.map

package/lib/command/convert/AcApHtmlConvertor.js.map

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

package/lib/command/convert/AcApHtmlSnapshotBuilder.d.ts

@@ -0,0 +1,65 @@
+import { type AcExSnapshotV1 } from '@mlightcad/cad-html-exporter';
+import type { AcDbDatabase } from '@mlightcad/data-model';
+import type { AcTrScene } from '../../view/AcTrScene';
+/**
+ * Optional overrides applied when constructing an HTML export snapshot.
+ */
+export interface AcApHtmlSnapshotBuilderOptions {
+    /**
+     * Human-readable drawing title stored in snapshot metadata and used as the
+     * HTML document title when not overridden by the packager.
+     */
+    title?: string;
+    /**
+     * Canvas background color as a 24-bit RGB integer (e.g. `0x000000`).
+     * Defaults to the value from {@link buildViewerMetadata} when omitted.
+     */
+    background?: number;
+    /**
+     * UI locale embedded in the exported HTML for i18n (`en`, `zh`, etc.).
+     * Defaults to {@link AcApI18n.currentLocale} when omitted.
+     */
+    locale?: string;
+}
+/**
+ * Serializes the live Three.js scene into a versioned {@link AcExSnapshotV1}.
+ *
+ * The snapshot contains layer visibility, per-layout line/mesh batches, and
+ * viewer metadata (extents, units, background). It is display-only: no DXF/DWG
+ * entities or edit capability are preserved.
+ */
+export declare class AcApHtmlSnapshotBuilder {
+    /**
+     * Builds a snapshot synchronously in one pass.
+     *
+     * Prefer {@link buildAsync} for interactive export so the UI can stay responsive.
+     *
+     * @param scene - Current renderer scene (layouts, layers, active layout).
+     * @param database - Open drawing database used for layout names and metadata.
+     * @param options - Optional title, background, and locale overrides.
+     * @returns A complete v1 snapshot ready for `packHtml`.
+     */
+    build(scene: AcTrScene, database: AcDbDatabase, options?: AcApHtmlSnapshotBuilderOptions): AcExSnapshotV1;
+    /**
+     * Builds a snapshot incrementally, yielding to the main thread between layouts.
+     *
+     * Geometry is collected per layout layer so a busy indicator can repaint
+     * during large drawings.
+     *
+     * @param scene - Current renderer scene (layouts, layers, active layout).
+     * @param database - Open drawing database used for layout names and metadata.
+     * @param options - Optional title, background, and locale overrides.
+     * @returns A complete v1 snapshot ready for `packHtml`.
+     */
+    buildAsync(scene: AcTrScene, database: AcDbDatabase, options?: AcApHtmlSnapshotBuilderOptions): Promise<AcExSnapshotV1>;
+    /**
+     * Synchronous implementation shared by {@link build} and {@link buildAsync}.
+     *
+     * @param scene - Current renderer scene.
+     * @param database - Open drawing database.
+     * @param options - Snapshot overrides.
+     * @returns A complete v1 snapshot.
+     */
+    private buildSync;
+}
+//# sourceMappingURL=AcApHtmlSnapshotBuilder.d.ts.map

package/lib/command/convert/AcApHtmlSnapshotBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApHtmlSnapshotBuilder.d.ts","sourceRoot":"","sources":["../../../src/command/convert/AcApHtmlSnapshotBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EAIpB,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAIzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC;;;;;;;;;OASG;IACH,KAAK,CACH,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,8BAAmC,GAC3C,cAAc;IAIjB;;;;;;;;;;OAUG;IACG,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,cAAc,CAAC;IA+C1B;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;CA0ClB"}