@spinajs/templates-puppeteer 2.0.438

package/README.md

@@ -0,0 +1,9 @@
+# @spinajs/templates-puppeteer
+
+Base Puppeteer renderer for SpineJS templates. This package provides shared logic for rendering templates using Puppeteer.
+
+## Installation
+
+``bash
+npm install @spinajs/templates-puppeteer
+``

package/lib/cjs/config/pdf.d.ts

@@ -0,0 +1,15 @@
+declare const pdf: {
+    templates: {
+        pdf: {
+            static: {
+                portRange: number[];
+            };
+            args: {
+                headless: boolean;
+            };
+            options: {};
+        };
+    };
+};
+export default pdf;
+//# sourceMappingURL=pdf.d.ts.map

package/lib/cjs/config/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/config/pdf.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,GAAG;;;;;;;;;;;;CAYR,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/lib/cjs/config/pdf.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pdf = {
+    templates: {
+        pdf: {
+            static: {
+                portRange: [3000, 4000],
+            },
+            args: {
+                headless: true,
+            },
+            options: {},
+        },
+    },
+};
+exports.default = pdf;
+//# sourceMappingURL=pdf.js.map

package/lib/cjs/config/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../../src/config/pdf.ts"],"names":[],"mappings":";;AAAA,MAAM,GAAG,GAAG;IACV,SAAS,EAAE;QACT,GAAG,EAAE;YACH,MAAM,EAAE;gBACN,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;aACxB;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,EAAE;SACZ;KACF;CACF,CAAC;AAEF,kBAAe,GAAG,CAAC"}

package/lib/cjs/index.d.ts

@@ -0,0 +1,60 @@
+import { Browser, Page, LaunchOptions } from 'puppeteer';
+import { TemplateRenderer, Templates } from '@spinajs/templates';
+import { Log } from '@spinajs/log';
+import * as http from 'http';
+import '@spinajs/templates-pug';
+export interface IPuppeteerRendererOptions {
+    static: {
+        portRange: number[];
+    };
+    args: LaunchOptions;
+    /**
+     * Optional path to Chrome/Chromium executable.
+     * Useful when running in environments where Puppeteer cannot download Chromium.
+     * If provided, overrides args.executablePath.
+     */
+    executablePath?: string;
+    renderDurationWarning: number;
+    navigationTimeout?: number;
+    renderTimeout?: number;
+    /**
+     * Debug options
+     */
+    debug?: {
+        /**
+         * If true, browser will remain open after rendering for inspection
+         * Use it with headless: false in args to see the browser window ( puppetter.launch args )
+         */
+        close?: boolean;
+    };
+}
+export declare abstract class PuppeteerRenderer extends TemplateRenderer {
+    protected abstract Options: IPuppeteerRendererOptions;
+    protected Log: Log;
+    protected TemplatingService: Templates;
+    renderToFile(template: string, model: any, filePath: string, language?: string): Promise<void>;
+    /**
+     * Abstract method to perform specific rendering (PDF or image)
+     */
+    protected abstract performRender(page: Page, filePath: string): Promise<void>;
+    render(_templateName: string, _model: unknown, _language?: string): Promise<string>;
+    protected compile(_path: string): Promise<void>;
+    protected runLocalServer(basePath: string): Promise<http.Server>;
+    /**
+     * Enhanced browser cleanup with error handling
+     */
+    protected safeBrowserCleanup(browser: Browser): Promise<void>;
+    /**
+     * Force close browser with process termination
+     */
+    protected forceCloseBrowser(browser: Browser): Promise<void>;
+    /**
+     * Enhanced server cleanup with timeout
+     */
+    protected safeServerCleanup(server: http.Server): Promise<void>;
+    /**
+     * Add page event listeners with cleanup function
+     */
+    protected addPageEventListeners(page: any): () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAwB,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,OAAO,wBAAwB,CAAC;AAIhC,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE;QAEN;;;WAGG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAA;CACF;AAED,8BAAsB,iBAAkB,SAAQ,gBAAgB;IAC9D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAGtD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAGnB,SAAS,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAE1B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgH3G;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAKhF,OAAO,CAAC,KAAK,EAAE,MAAM;cAErB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IA2CtE;;OAEG;cACa,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE;;OAEG;cACa,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;OAEG;cACa,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrE;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,IAAI;CA0BvD"}

package/lib/cjs/index.js

@@ -0,0 +1,273 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PuppeteerRenderer = void 0;
+const puppeteer_1 = __importDefault(require("puppeteer"));
+const exceptions_1 = require("@spinajs/exceptions");
+const templates_1 = require("@spinajs/templates");
+const di_1 = require("@spinajs/di");
+const path_1 = require("path");
+const log_1 = require("@spinajs/log");
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+require("@spinajs/templates-pug");
+const lodash_1 = __importDefault(require("lodash"));
+class PuppeteerRenderer extends templates_1.TemplateRenderer {
+    async renderToFile(template, model, filePath, language) {
+        let server = null;
+        let browser = null;
+        try {
+            this.Log.timeStart(`puppeteer-template-rendering-${filePath}`);
+            this.Log.trace(`Rendering template ${template} to file ${filePath}`);
+            const templateBasePath = (0, path_1.dirname)(template);
+            // fire up local http server for serving images etc
+            // becouse chromium prevents from reading local files when not
+            // rendering file with file:// protocol for security reasons
+            server = await this.runLocalServer(templateBasePath);
+            const httpPort = server.address().port;
+            const compiledTemplate = await this.TemplatingService.render((0, path_1.join)(templateBasePath, (0, path_1.basename)(template, this.Extension)) + '.pug', {
+                // add template temporary server port
+                // so we can use it to render images in template
+                __http_template_port__: httpPort,
+                // for convinience add full url to local http server
+                __http_template_address__: `http://localhost:${httpPort}`,
+                ...model,
+            }, language);
+            const launchOptions = {
+                ...(this.Options?.args || {}),
+                ...(this.Options?.executablePath && {
+                    executablePath: this.Options.executablePath,
+                }),
+            };
+            browser = await puppeteer_1.default.launch(launchOptions);
+            const page = await browser.newPage();
+            // Skip timeouts in debug mode
+            if (!this.Options?.debug?.close) {
+                page.setDefaultNavigationTimeout(this.Options?.navigationTimeout || 30000); // Default 30s
+                page.setDefaultTimeout(this.Options?.renderTimeout || 30000); // Default 30s
+            }
+            // Set up render timeout (skip in debug mode)
+            let renderTimeout;
+            if (!this.Options?.debug?.close) {
+                const timeoutMs = this.Options?.renderTimeout || 30000;
+                renderTimeout = setTimeout(async () => {
+                    this.Log.warn(`Render timeout (${timeoutMs}ms) - forcing cleanup`);
+                    try {
+                        if (page)
+                            await page.close().catch(() => { });
+                        if (browser)
+                            await this.forceCloseBrowser(browser);
+                    }
+                    catch (err) {
+                        this.Log.error('Error during timeout cleanup:', err);
+                    }
+                }, timeoutMs);
+            }
+            // Add event listeners with explicit cleanup tracking
+            const eventCleanup = this.addPageEventListeners(page);
+            try {
+                await page.setBypassCSP(true);
+                await page.setContent(compiledTemplate);
+                // Call abstract method to perform specific rendering (PDF or image)
+                await this.performRender(page, filePath);
+                // Clear timeout on successful completion
+                if (renderTimeout) {
+                    clearTimeout(renderTimeout);
+                    renderTimeout = undefined;
+                }
+                // Clean up event listeners
+                eventCleanup();
+            }
+            catch (renderError) {
+                // Clear timeout on error
+                if (renderTimeout) {
+                    clearTimeout(renderTimeout);
+                    renderTimeout = undefined;
+                }
+                this.Log.error(renderError, `Error during rendering for template ${template}`);
+                throw renderError;
+            }
+        }
+        catch (err) {
+            this.Log.error(err, `Error rendering template ${template} to file ${filePath}`);
+            throw err;
+        }
+        finally {
+            const duration = this.Log.timeEnd(`puppeteer-template-rendering-${filePath}`);
+            this.Log.trace(`Ended rendering template ${template} to file ${filePath}, took: ${duration}ms`);
+            if (this.Options && duration > this.Options.renderDurationWarning) {
+                this.Log.warn(`Rendering template ${template} to file ${filePath} took too long.`);
+            }
+            // Skip browser cleanup if debug.close is false (keep browser open for inspection)
+            if (browser && (!this.Options || this.Options.debug?.close !== false)) {
+                await this.safeBrowserCleanup(browser);
+            }
+            else if (browser) {
+                this.Log.info('Browser kept open for debugging (debug.close=false)');
+            }
+            if (server) {
+                await this.safeServerCleanup(server);
+            }
+        }
+    }
+    async render(_templateName, _model, _language) {
+        throw new exceptions_1.NotSupported('cannot render puppeteer template to string');
+    }
+    // no compilation at start
+    async compile(_path) { }
+    async runLocalServer(basePath) {
+        const self = this;
+        const app = (0, express_1.default)();
+        app.use((0, cors_1.default)());
+        app.use(express_1.default.static(basePath));
+        return new Promise((resolve, reject) => {
+            const server = app
+                // if no port is provided express will choose random port to start (available)
+                // if not, we will get random from range in config
+                .listen(!this.Options?.static?.portRange || this.Options.static.portRange.length === 0
+                ? 0
+                : lodash_1.default.random(this.Options.static.portRange[0], this.Options.static.portRange[1]))
+                .on('listening', function () {
+                self.Log.trace(`Puppeteer image server started on port ${this.address().port}`);
+                self.Log.trace(`Puppeteer static file dir at ${basePath}`);
+                resolve(this);
+            })
+                .on('error', (err) => {
+                self.Log.error(err, `Puppeteer image server cannot start`);
+                // Clean up the failed server
+                if (server) {
+                    server.close(() => {
+                        reject(err);
+                    });
+                }
+                else {
+                    reject(err);
+                }
+            });
+            // Set a timeout for server startup
+            setTimeout(() => {
+                if (!server.listening) {
+                    server.close();
+                    reject(new Error('Server startup timeout'));
+                }
+            }, 10000);
+        });
+    }
+    /**
+     * Enhanced browser cleanup with error handling
+     */
+    async safeBrowserCleanup(browser) {
+        try {
+            // First try to close all pages
+            const pages = await browser.pages();
+            await Promise.allSettled(pages.map(page => page.close()));
+            // Then close the browser normally
+            await browser.close();
+        }
+        catch (err) {
+            this.Log.warn(`Error during normal browser cleanup: ${err.message}`);
+            // Force kill if normal close fails
+            try {
+                await this.forceCloseBrowser(browser);
+            }
+            catch (killErr) {
+                this.Log.error(`Failed to force kill browser: ${killErr.message}`);
+            }
+        }
+    }
+    /**
+     * Force close browser with process termination
+     */
+    async forceCloseBrowser(browser) {
+        try {
+            const process = browser.process();
+            if (process) {
+                process.kill('SIGKILL');
+                this.Log.warn('Browser process force killed');
+            }
+        }
+        catch (err) {
+            this.Log.error(`Error force killing browser process: ${err.message}`);
+        }
+    }
+    /**
+     * Enhanced server cleanup with timeout
+     */
+    async safeServerCleanup(server) {
+        try {
+            await new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    reject(new Error('Server close timeout'));
+                }, 5000);
+                server.close((err) => {
+                    clearTimeout(timeout);
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+        catch (err) {
+            this.Log.warn(`Error closing server: ${err.message}`);
+            // Force close connections if available
+            try {
+                if ('closeAllConnections' in server) {
+                    server.closeAllConnections();
+                }
+            }
+            catch (forceErr) {
+                this.Log.error(`Error force closing server connections: ${forceErr.message}`);
+            }
+        }
+    }
+    /**
+     * Add page event listeners with cleanup function
+     */
+    addPageEventListeners(page) {
+        const listeners = {
+            console: (message) => this.Log.trace(`${message.type().substr(0, 3).toUpperCase()} ${message.text()}`),
+            pageerror: ({ message }) => this.Log.error(message),
+            response: (response) => this.Log.trace(`${response.status()} ${response.url()}`),
+            requestfailed: (request) => this.Log.error(`${request.failure().errorText} ${request.url()}`)
+        };
+        // Add listeners
+        page.on('console', listeners.console);
+        page.on('pageerror', listeners.pageerror);
+        page.on('response', listeners.response);
+        page.on('requestfailed', listeners.requestfailed);
+        // Return cleanup function
+        return () => {
+            try {
+                page.removeListener('console', listeners.console);
+                page.removeListener('pageerror', listeners.pageerror);
+                page.removeListener('response', listeners.response);
+                page.removeListener('requestfailed', listeners.requestfailed);
+            }
+            catch (err) {
+                this.Log.warn(`Error removing page listeners: ${err.message}`);
+            }
+        };
+    }
+}
+exports.PuppeteerRenderer = PuppeteerRenderer;
+__decorate([
+    (0, log_1.Logger)('puppeteer-templates'),
+    __metadata("design:type", log_1.Log)
+], PuppeteerRenderer.prototype, "Log", void 0);
+__decorate([
+    (0, di_1.LazyInject)(),
+    __metadata("design:type", templates_1.Templates)
+], PuppeteerRenderer.prototype, "TemplatingService", void 0);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

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

package/lib/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/mjs/config/pdf.d.ts

@@ -0,0 +1,15 @@
+declare const pdf: {
+    templates: {
+        pdf: {
+            static: {
+                portRange: number[];
+            };
+            args: {
+                headless: boolean;
+            };
+            options: {};
+        };
+    };
+};
+export default pdf;
+//# sourceMappingURL=pdf.d.ts.map

package/lib/mjs/config/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/config/pdf.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,GAAG;;;;;;;;;;;;CAYR,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/lib/mjs/config/pdf.js

@@ -0,0 +1,15 @@
+const pdf = {
+    templates: {
+        pdf: {
+            static: {
+                portRange: [3000, 4000],
+            },
+            args: {
+                headless: true,
+            },
+            options: {},
+        },
+    },
+};
+export default pdf;
+//# sourceMappingURL=pdf.js.map

package/lib/mjs/config/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../../src/config/pdf.ts"],"names":[],"mappings":"AAAA,MAAM,GAAG,GAAG;IACV,SAAS,EAAE;QACT,GAAG,EAAE;YACH,MAAM,EAAE;gBACN,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;aACxB;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,EAAE;SACZ;KACF;CACF,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/lib/mjs/index.d.ts

@@ -0,0 +1,60 @@
+import { Browser, Page, LaunchOptions } from 'puppeteer';
+import { TemplateRenderer, Templates } from '@spinajs/templates';
+import { Log } from '@spinajs/log';
+import * as http from 'http';
+import '@spinajs/templates-pug';
+export interface IPuppeteerRendererOptions {
+    static: {
+        portRange: number[];
+    };
+    args: LaunchOptions;
+    /**
+     * Optional path to Chrome/Chromium executable.
+     * Useful when running in environments where Puppeteer cannot download Chromium.
+     * If provided, overrides args.executablePath.
+     */
+    executablePath?: string;
+    renderDurationWarning: number;
+    navigationTimeout?: number;
+    renderTimeout?: number;
+    /**
+     * Debug options
+     */
+    debug?: {
+        /**
+         * If true, browser will remain open after rendering for inspection
+         * Use it with headless: false in args to see the browser window ( puppetter.launch args )
+         */
+        close?: boolean;
+    };
+}
+export declare abstract class PuppeteerRenderer extends TemplateRenderer {
+    protected abstract Options: IPuppeteerRendererOptions;
+    protected Log: Log;
+    protected TemplatingService: Templates;
+    renderToFile(template: string, model: any, filePath: string, language?: string): Promise<void>;
+    /**
+     * Abstract method to perform specific rendering (PDF or image)
+     */
+    protected abstract performRender(page: Page, filePath: string): Promise<void>;
+    render(_templateName: string, _model: unknown, _language?: string): Promise<string>;
+    protected compile(_path: string): Promise<void>;
+    protected runLocalServer(basePath: string): Promise<http.Server>;
+    /**
+     * Enhanced browser cleanup with error handling
+     */
+    protected safeBrowserCleanup(browser: Browser): Promise<void>;
+    /**
+     * Force close browser with process termination
+     */
+    protected forceCloseBrowser(browser: Browser): Promise<void>;
+    /**
+     * Enhanced server cleanup with timeout
+     */
+    protected safeServerCleanup(server: http.Server): Promise<void>;
+    /**
+     * Add page event listeners with cleanup function
+     */
+    protected addPageEventListeners(page: any): () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/mjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAwB,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,OAAO,wBAAwB,CAAC;AAIhC,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE;QAEN;;;WAGG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAA;CACF;AAED,8BAAsB,iBAAkB,SAAQ,gBAAgB;IAC9D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAGtD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAGnB,SAAS,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAE1B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgH3G;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAKhF,OAAO,CAAC,KAAK,EAAE,MAAM;cAErB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IA2CtE;;OAEG;cACa,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE;;OAEG;cACa,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;OAEG;cACa,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrE;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,IAAI;CA0BvD"}