@emkodev/emroute 1.6.2 → 1.6.4

package/dist/src/renderer/spa/hash.renderer.js

@@ -0,0 +1,162 @@
+/**
+ * Hash Router
+ *
+ * Lightweight client-side router for leaf mode mini-apps.
+ * Uses hashchange events + RouteCore pattern matching.
+ *
+ * Routes are defined inline by the consumer, not from the main manifest.
+ * Coexists with SpaHtmlRouter in root mode (SPA router skips hash changes).
+ */
+import { RouteCore } from "../../route/route.core.js";
+import { escapeHtml } from "../../util/html.util.js";
+import { logger } from "../../util/logger.util.js";
+import { BaseRenderer } from "./base.renderer.js";
+/**
+ * Build an internal RoutesManifest from inline hash route definitions.
+ * Each route's pattern is used as the moduleLoaders key so RouteCore.loadModule works.
+ */
+function buildManifest(routes) {
+    return {
+        routes: routes.map((r) => ({
+            pattern: r.pattern,
+            type: 'page',
+            modulePath: r.pattern,
+            files: { ts: r.pattern },
+        })),
+        errorBoundaries: [],
+        statusPages: new Map(),
+        moduleLoaders: Object.fromEntries(routes.map((r) => [r.pattern, r.loader])),
+    };
+}
+/**
+ * Hash-based mini-app router for leaf mode pages.
+ *
+ * Listens to `hashchange`, maps `#/path` → pattern match via RouteCore,
+ * renders matched PageComponent into a slot element.
+ *
+ * @experimental
+ */
+export class HashRouter extends BaseRenderer {
+    boundHandler = null;
+    constructor(manifest, options) {
+        const core = new RouteCore(manifest, {
+            extendContext: options?.extendContext,
+        });
+        super(core);
+    }
+    /**
+     * Initialize: find slot, attach hashchange listener, render initial hash.
+     */
+    async initialize(slot = 'hash-slot') {
+        this.slot = typeof slot === 'string' ? document.querySelector(slot) : slot;
+        if (!this.slot) {
+            console.error(`[HashRouter] Slot not found: ${slot}`);
+            return;
+        }
+        this.boundHandler = () => {
+            this.handleHashChange();
+        };
+        globalThis.addEventListener('hashchange', this.boundHandler);
+        // Render initial hash if present
+        if (location.hash.length > 1) {
+            await this.handleHashChange();
+        }
+    }
+    /**
+     * Navigate to a hash path. Triggers hashchange → render.
+     */
+    navigate(hash) {
+        location.hash = hash.startsWith('#') ? hash : '#' + hash;
+    }
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener) {
+        return this.core.addEventListener(listener);
+    }
+    /**
+     * Remove event listeners and release references.
+     */
+    dispose() {
+        if (this.boundHandler) {
+            globalThis.removeEventListener('hashchange', this.boundHandler);
+            this.boundHandler = null;
+        }
+        this.slot = null;
+    }
+    /**
+     * Handle a hashchange event: parse hash, match, render.
+     */
+    async handleHashChange() {
+        const path = location.hash.slice(1) || '/';
+        const matchUrl = new URL(path, location.origin);
+        logger.nav('hash', path, path);
+        const controller = new AbortController();
+        const { signal } = controller;
+        try {
+            const matched = this.core.match(matchUrl);
+            if (!matched) {
+                logger.nav('hash-not-found', path, path);
+                if (this.slot) {
+                    this.slot.setHTMLUnsafe(`
+            <h1>Not Found</h1>
+            <p>Path: ${escapeHtml(path)}</p>
+          `);
+                }
+                return;
+            }
+            logger.nav('hash-matched', path, matched.route.pattern, { params: matched.params });
+            this.core.currentRoute = matched;
+            const routeInfo = this.core.toRouteInfo(matched, path);
+            await this.renderPage(routeInfo, matched, signal);
+            if (signal.aborted)
+                return;
+            this.core.emit({
+                type: 'navigate',
+                pathname: path,
+                params: matched.params,
+            });
+        }
+        catch (error) {
+            if (signal.aborted)
+                return;
+            console.error('[HashRouter] Render error:', error);
+            this.core.emit({
+                type: 'error',
+                pathname: path,
+                params: {},
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            if (this.slot) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.slot.setHTMLUnsafe(`
+          <h1>Error</h1>
+          <p>${escapeHtml(message)}</p>
+        `);
+            }
+        }
+    }
+}
+/**
+ * Create and initialize a hash router for a leaf-mode mini-app.
+ *
+ * The router instance is stored on `globalThis.__emroute_hash_router` for
+ * programmatic access. Calling twice returns the existing router with a warning.
+ *
+ * @experimental
+ */
+export async function createHashRouter(options) {
+    const g = globalThis;
+    if (g.__emroute_hash_router) {
+        console.warn('eMroute: Hash router already initialized.');
+        return g.__emroute_hash_router;
+    }
+    const manifest = buildManifest(options.routes);
+    const router = new HashRouter(manifest, {
+        extendContext: options.extendContext,
+    });
+    await router.initialize(options.slot ?? 'hash-slot');
+    g.__emroute_hash_router = router;
+    return router;
+}
+//# sourceMappingURL=hash.renderer.js.map

package/dist/src/renderer/spa/hash.renderer.js.map

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

package/dist/src/renderer/spa/html.renderer.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SPA HTML Renderer
+ *
+ * Browser-based Single Page Application renderer.
+ * Handles:
+ * - DOM manipulation (slot.innerHTML)
+ * - Navigation API (navigate event, intercept, scroll restoration)
+ * - Document title via component.getTitle()
+ * - View transitions
+ */
+import type { MatchedRoute, NavigateOptions, RouteParams, RoutesManifest } from '../../type/route.type.ts';
+import type { ContextProvider } from '../../component/abstract.component.ts';
+import { type BasePath, RouteCore } from '../../route/route.core.ts';
+import { BaseRenderer } from './base.renderer.ts';
+/** Options for SPA HTML Router */
+export interface SpaHtmlRouterOptions {
+    /** Enriches every ComponentContext with app-level services before it reaches components. */
+    extendContext?: ContextProvider;
+    /** Base paths for SSR endpoints. SPA uses html basePath for routing, md for passthrough. */
+    basePath?: BasePath;
+}
+/**
+ * SPA Router for browser-based HTML rendering.
+ */
+export declare class SpaHtmlRouter extends BaseRenderer {
+    private abortController;
+    /** Base paths for SSR endpoints. */
+    private htmlBase;
+    private mdBase;
+    constructor(manifest: RoutesManifest, options?: SpaHtmlRouterOptions);
+    /**
+     * Initialize router with slot element.
+     * Sets up Navigation API listener and performs initial navigation.
+     */
+    initialize(slotSelector?: string): Promise<void>;
+    /**
+     * Remove event listeners and release references.
+     */
+    dispose(): void;
+    /**
+     * Navigate to a new URL.
+     */
+    navigate(url: string, options?: NavigateOptions): Promise<void>;
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener: Parameters<RouteCore['addEventListener']>[0]): () => void;
+    /**
+     * Get current route parameters.
+     */
+    getParams(): RouteParams;
+    /**
+     * Get current matched route.
+     */
+    getCurrentRoute(): MatchedRoute | null;
+    /**
+     * Handle navigation to a URL.
+     *
+     * Pure render function — URL updates and scroll restoration are handled
+     * by the Navigation API. Abort is signalled via the navigate event's signal.
+     */
+    private handleNavigation;
+    /**
+     * Render a status-specific page.
+     */
+    private renderStatusPage;
+    /** Try to load and render an error boundary or handler module into the slot. */
+    private tryRenderErrorModule;
+    /**
+     * Handle errors during navigation/rendering.
+     */
+    private handleError;
+}
+/**
+ * Create and initialize SPA HTML router.
+ *
+ * The router instance is stored on `globalThis.__emroute_router` for
+ * programmatic access from consumer scripts (navigate, getParams, etc.).
+ * Calling this function twice returns the existing router with a warning.
+ */
+export declare function createSpaHtmlRouter(manifest: RoutesManifest, options?: SpaHtmlRouterOptions): Promise<SpaHtmlRouter>;

package/dist/src/renderer/spa/html.renderer.js

@@ -0,0 +1,304 @@
+/// <reference path="../../type/navigation-api.d.ts" />
+import { ComponentElement } from "../../element/component.element.js";
+import { assertSafeRedirect, DEFAULT_BASE_PATH, RouteCore, } from "../../route/route.core.js";
+import { escapeHtml, STATUS_MESSAGES } from "../../util/html.util.js";
+import { logger } from "../../util/logger.util.js";
+import { BaseRenderer } from "./base.renderer.js";
+import defaultPageComponent from "../../component/page.component.js";
+/**
+ * SPA Router for browser-based HTML rendering.
+ */
+export class SpaHtmlRouter extends BaseRenderer {
+    abortController = null;
+    /** Base paths for SSR endpoints. */
+    htmlBase;
+    mdBase;
+    constructor(manifest, options) {
+        const bp = options?.basePath ?? DEFAULT_BASE_PATH;
+        const core = new RouteCore(manifest, {
+            extendContext: options?.extendContext,
+            basePath: bp.html,
+        });
+        super(core);
+        this.htmlBase = bp.html;
+        this.mdBase = bp.md;
+        if (options?.extendContext) {
+            ComponentElement.setContextProvider(options.extendContext);
+        }
+    }
+    /**
+     * Initialize router with slot element.
+     * Sets up Navigation API listener and performs initial navigation.
+     */
+    async initialize(slotSelector = 'router-slot') {
+        this.slot = document.querySelector(slotSelector);
+        if (!this.slot) {
+            console.error(`[Router] Slot not found: ${slotSelector}`);
+            return;
+        }
+        // Navigation API required for SPA routing — SSR handles browsers without it
+        if (!('navigation' in globalThis)) {
+            logger.info('init', 'Navigation API not available — using SSR full-page navigation');
+            return;
+        }
+        this.abortController = new AbortController();
+        const { signal } = this.abortController;
+        // Single handler for ALL navigations: link clicks, back/forward,
+        // navigate() calls, form submissions. Replaces popstate + click listeners.
+        navigation.addEventListener('navigate', (event) => {
+            if (!event.canIntercept)
+                return;
+            if (event.hashChange)
+                return;
+            if (event.downloadRequest !== null)
+                return;
+            const url = new URL(event.destination.url);
+            // /md/ paths pass through to server for full page load
+            if (url.pathname.startsWith(this.mdBase + '/') || url.pathname === this.mdBase) {
+                return;
+            }
+            event.intercept({
+                scroll: 'manual',
+                handler: async () => {
+                    await this.handleNavigation(url.pathname + url.search + url.hash, event.signal);
+                    event.scroll();
+                },
+            });
+        }, { signal });
+        // Check for SSR content — skip initial render if route matches.
+        // data-ssr-route stores the full path including basePath (e.g. /html/about).
+        const ssrRoute = this.slot.getAttribute('data-ssr-route');
+        if (ssrRoute) {
+            const currentPath = location.pathname;
+            logger.ssr('check-adoption', `SSR route=${ssrRoute}, current=${currentPath}`);
+            if (currentPath === ssrRoute || currentPath === ssrRoute + '/') {
+                // Adopt SSR content — patterns are prefixed, match directly
+                const matched = this.core.match(new URL(ssrRoute, location.origin));
+                if (matched) {
+                    logger.ssr('adopt', ssrRoute);
+                    this.core.currentRoute = matched;
+                    navigation.updateCurrentEntry({
+                        state: { pathname: ssrRoute, params: matched.params },
+                    });
+                }
+                this.slot.removeAttribute('data-ssr-route');
+                return;
+            }
+            else {
+                logger.ssr('mismatch', `Expected ${ssrRoute}, got ${currentPath}`);
+            }
+        }
+        // No SSR content or route mismatch — full client-side render
+        logger.info('init', `Initial navigation to ${location.pathname}`);
+        await this.handleNavigation(location.pathname + location.search + location.hash, this.abortController.signal);
+    }
+    /**
+     * Remove event listeners and release references.
+     */
+    dispose() {
+        this.abortController?.abort();
+        this.abortController = null;
+        this.slot = null;
+        ComponentElement.setContextProvider(undefined);
+    }
+    /**
+     * Navigate to a new URL.
+     */
+    async navigate(url, options = {}) {
+        const normalizedUrl = this.core.normalizeUrl(url);
+        try {
+            const { finished } = navigation.navigate(normalizedUrl, {
+                state: options.state,
+                history: options.replace ? 'replace' : 'auto',
+            });
+            await finished;
+        }
+        catch (e) {
+            // Navigation interrupted (e.g. by a redirect) — not an error
+            if (e instanceof DOMException && e.name === 'AbortError')
+                return;
+            throw e;
+        }
+    }
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener) {
+        return this.core.addEventListener(listener);
+    }
+    /**
+     * Get current route parameters.
+     */
+    getParams() {
+        return this.core.getParams();
+    }
+    /**
+     * Get current matched route.
+     */
+    getCurrentRoute() {
+        return this.core.currentRoute;
+    }
+    /**
+     * Handle navigation to a URL.
+     *
+     * Pure render function — URL updates and scroll restoration are handled
+     * by the Navigation API. Abort is signalled via the navigate event's signal.
+     */
+    async handleNavigation(url, signal) {
+        const urlObj = new URL(url, location.origin);
+        const pathname = urlObj.pathname;
+        logger.nav('start', location.pathname, pathname);
+        // /md/ paths are handled server-side (initial load only — navigate handler filters these)
+        if (pathname.startsWith(this.mdBase + '/') || pathname === this.mdBase) {
+            logger.nav('redirect-md', pathname, pathname, { reason: 'server-side markdown' });
+            globalThis.location.href = url;
+            return;
+        }
+        try {
+            const matched = this.core.match(urlObj);
+            if (!matched) {
+                logger.nav('not-found', pathname, pathname);
+                await this.renderStatusPage(404, pathname);
+                return;
+            }
+            logger.nav('matched', pathname, matched.route.pattern, { params: matched.params });
+            // Handle redirect — starts a new navigation, aborting this one
+            if (matched.route.type === 'redirect') {
+                const module = await this.core.loadModule(matched.route.modulePath);
+                if (signal.aborted)
+                    return;
+                assertSafeRedirect(module.default.to);
+                navigation.navigate(module.default.to, { history: 'replace' });
+                return;
+            }
+            // Render page
+            this.core.currentRoute = matched;
+            const routeInfo = this.core.toRouteInfo(matched, pathname);
+            if (document.startViewTransition) {
+                const transition = document.startViewTransition(async () => {
+                    await this.renderPage(routeInfo, matched, signal);
+                });
+                signal.addEventListener('abort', () => transition.skipTransition(), { once: true });
+                await transition.updateCallbackDone;
+            }
+            else {
+                await this.renderPage(routeInfo, matched, signal);
+            }
+            if (signal.aborted)
+                return;
+            // Emit navigate event
+            this.core.emit({
+                type: 'navigate',
+                pathname,
+                params: matched.params,
+            });
+        }
+        catch (error) {
+            if (signal.aborted)
+                return;
+            if (error instanceof Response) {
+                await this.renderStatusPage(error.status, pathname);
+                return;
+            }
+            await this.handleError(error, pathname);
+        }
+    }
+    /**
+     * Render a status-specific page.
+     */
+    async renderStatusPage(status, pathname) {
+        if (!this.slot)
+            return;
+        const statusPage = this.core.matcher.getStatusPage(status);
+        if (statusPage) {
+            try {
+                const component = statusPage.files?.ts
+                    ? (await this.core.loadModule(statusPage.files.ts)).default
+                    : defaultPageComponent;
+                const ri = {
+                    pathname,
+                    pattern: statusPage.pattern,
+                    params: {},
+                    searchParams: new URLSearchParams(),
+                };
+                const context = await this.core.buildComponentContext(ri, statusPage);
+                const data = await component.getData({ params: {}, context });
+                this.slot.setHTMLUnsafe(component.renderHTML({ data, params: {}, context }));
+                this.updateTitle();
+                return;
+            }
+            catch (e) {
+                console.error(`[Router] Failed to render ${status} page:`, e);
+            }
+        }
+        this.slot.setHTMLUnsafe(`
+      <h1>${STATUS_MESSAGES[status] ?? 'Error'}</h1>
+      <p>Path: ${escapeHtml(pathname)}</p>
+    `);
+        this.updateTitle();
+    }
+    /** Try to load and render an error boundary or handler module into the slot. */
+    async tryRenderErrorModule(modulePath) {
+        try {
+            const module = await this.core.loadModule(modulePath);
+            const component = module.default;
+            const minCtx = { pathname: '', pattern: '', params: {}, searchParams: new URLSearchParams() };
+            const data = await component.getData({ params: {}, context: minCtx });
+            const html = component.renderHTML({ data, params: {}, context: minCtx });
+            if (this.slot) {
+                this.slot.setHTMLUnsafe(html);
+                this.updateTitle();
+            }
+            return true;
+        }
+        catch (e) {
+            console.error('[Router] Error module failed:', e);
+            return false;
+        }
+    }
+    /**
+     * Handle errors during navigation/rendering.
+     */
+    async handleError(error, pathname) {
+        console.error('[Router] Navigation error:', error);
+        this.core.emit({
+            type: 'error',
+            pathname,
+            params: {},
+            error: error instanceof Error ? error : new Error(String(error)),
+        });
+        const boundary = this.core.matcher.findErrorBoundary(pathname);
+        if (boundary && await this.tryRenderErrorModule(boundary.modulePath))
+            return;
+        const errorHandler = this.core.matcher.getErrorHandler();
+        if (errorHandler && await this.tryRenderErrorModule(errorHandler.modulePath))
+            return;
+        if (this.slot) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.slot.setHTMLUnsafe(`
+        <h1>Error</h1>
+        <p>${escapeHtml(message)}</p>
+      `);
+            this.updateTitle();
+        }
+    }
+}
+/**
+ * Create and initialize SPA HTML router.
+ *
+ * The router instance is stored on `globalThis.__emroute_router` for
+ * programmatic access from consumer scripts (navigate, getParams, etc.).
+ * Calling this function twice returns the existing router with a warning.
+ */
+export async function createSpaHtmlRouter(manifest, options) {
+    const g = globalThis;
+    if (g.__emroute_router) {
+        console.warn('eMroute: SPA router already initialized. Remove duplicate <script> tags.');
+        return g.__emroute_router;
+    }
+    const router = new SpaHtmlRouter(manifest, options);
+    await router.initialize();
+    g.__emroute_router = router;
+    return router;
+}
+//# sourceMappingURL=html.renderer.js.map

package/dist/src/renderer/spa/html.renderer.js.map

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

package/dist/src/renderer/spa/mod.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SPA (Browser) Module
+ *
+ * Everything needed for the browser bundle:
+ * - SPA router with client-side navigation
+ * - Custom elements for rendering and hydrating SSR islands
+ * - Widget registry (built-in widgets are opt-in)
+ */
+import { RouterSlot } from '../../element/slot.element.ts';
+import { MarkdownElement } from '../../element/markdown.element.ts';
+import { ComponentElement } from '../../element/component.element.ts';
+import { WidgetRegistry } from '../../widget/widget.registry.ts';
+export { createSpaHtmlRouter, SpaHtmlRouter, type SpaHtmlRouterOptions } from './html.renderer.ts';
+export { createHashRouter, type HashRouteConfig, HashRouter, type HashRouterOptions, } from './hash.renderer.ts';
+export { ComponentElement, MarkdownElement, RouterSlot, WidgetRegistry };
+export type { SpaMode, WidgetsManifest } from '../../type/widget.type.ts';
+export { PageComponent } from '../../component/page.component.ts';
+export { WidgetComponent } from '../../component/widget.component.ts';
+export { Component, type ComponentContext, type ComponentManifestEntry, type ContextProvider, type RenderContext, } from '../../component/abstract.component.ts';
+export type { MatchedRoute, NavigateOptions, RouteParams, RouterEvent, RouterEventListener, RouterEventType, RoutesManifest, } from '../../type/route.type.ts';
+export type { MarkdownRenderer } from '../../type/markdown.type.ts';
+export { type BasePath, DEFAULT_BASE_PATH } from '../../route/route.core.ts';
+export { escapeHtml, scopeWidgetCss } from '../../util/html.util.ts';
+export type { ErrorBoundary, RedirectConfig, RouteConfig, RouteFiles, RouteFileType, RouteInfo, RouterState, } from '../../type/route.type.ts';
+export type { ParsedWidgetBlock, WidgetManifestEntry } from '../../type/widget.type.ts';
+export { type Logger, setLogger } from '../../type/logger.type.ts';
+export { createOverlayService } from '../../overlay/overlay.service.ts';
+export type { ModalOptions, OverlayService, PopoverOptions, ToastOptions, } from '../../overlay/overlay.type.ts';
+export { PageTitleWidget } from '../../widget/page-title.widget.ts';
+export { BreadcrumbWidget } from '../../widget/breadcrumb.widget.ts';

package/dist/src/renderer/spa/mod.js

@@ -0,0 +1,35 @@
+/**
+ * SPA (Browser) Module
+ *
+ * Everything needed for the browser bundle:
+ * - SPA router with client-side navigation
+ * - Custom elements for rendering and hydrating SSR islands
+ * - Widget registry (built-in widgets are opt-in)
+ */
+import { RouterSlot } from "../../element/slot.element.js";
+import { MarkdownElement } from "../../element/markdown.element.js";
+import { ComponentElement } from "../../element/component.element.js";
+import { WidgetRegistry } from "../../widget/widget.registry.js";
+export { createSpaHtmlRouter, SpaHtmlRouter } from "./html.renderer.js";
+export { createHashRouter, HashRouter, } from "./hash.renderer.js";
+export { ComponentElement, MarkdownElement, RouterSlot, WidgetRegistry };
+// Re-export base classes and types for consumer code (pages, widgets)
+export { PageComponent } from "../../component/page.component.js";
+export { WidgetComponent } from "../../component/widget.component.js";
+export { Component, } from "../../component/abstract.component.js";
+export { DEFAULT_BASE_PATH } from "../../route/route.core.js";
+export { escapeHtml, scopeWidgetCss } from "../../util/html.util.js";
+export { setLogger } from "../../type/logger.type.js";
+// Register core custom elements in the browser
+if (globalThis.customElements) {
+    if (!customElements.get('router-slot'))
+        customElements.define('router-slot', RouterSlot);
+    if (!customElements.get('mark-down'))
+        customElements.define('mark-down', MarkdownElement);
+}
+// Overlay API (tree-shakeable - only bundled if imported)
+export { createOverlayService } from "../../overlay/overlay.service.js";
+// Optional: Built-in widgets (tree-shakeable - only bundled if imported)
+export { PageTitleWidget } from "../../widget/page-title.widget.js";
+export { BreadcrumbWidget } from "../../widget/breadcrumb.widget.js";
+//# sourceMappingURL=mod.js.map

package/dist/src/renderer/spa/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../../src/renderer/spa/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,gBAAgB,EAEhB,UAAU,GAEX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAGzE,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EACL,SAAS,GAKV,MAAM,uCAAuC,CAAC;AAW/C,OAAO,EAAiB,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAWrE,OAAO,EAAe,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEnE,+CAA+C;AAC/C,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACzF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AAC5F,CAAC;AAED,0DAA0D;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAQxE,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}