@nexus_js/server 0.6.0

package/dist/error-boundary.js

@@ -0,0 +1,181 @@
+/**
+ * Nexus Error Boundaries — file-based resilience system.
+ *
+ * Convention (mirrors Next.js App Router):
+ *
+ *   routes/
+ *   ├── error.nx              ← catches errors in the root layout
+ *   ├── dashboard/
+ *   │   ├── error.nx          ← catches errors in /dashboard/**
+ *   │   ├── +layout.nx
+ *   │   └── +page.nx
+ *   └── blog/
+ *       ├── [slug]/
+ *       │   ├── error.nx      ← catches errors ONLY in /blog/:slug
+ *       │   └── +page.nx
+ *       └── not-found.nx      ← custom 404 for /blog/**
+ *
+ * The error.nx component receives:
+ *   - error: { message, name, digest? }
+ *   - reset: () => void  (client-side — triggers re-render)
+ *
+ * Island hydration for error.nx:
+ *   The "reset" button must be an island (client:load) to be interactive.
+ *   The error info is server-rendered (no JS needed to display it).
+ *
+ * Usage in error.nx:
+ *   ---
+ *   const { error } = ctx.errorBoundary;
+ *   ---
+ *   <script>
+ *     const { reset } = $props();
+ *   </script>
+ *   <div class="error-boundary" client:load>
+ *     <h2>Something went wrong</h2>
+ *     <p>{error.message}</p>
+ *     <button onclick={reset}>Try again</button>
+ *   </div>
+ */
+import { access } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+/**
+ * Finds the nearest `error.nx` file to a given route filepath.
+ * Walks up the directory tree until it finds one or reaches the routes root.
+ */
+export async function findErrorBoundary(routeFilepath, routesRoot) {
+    let dir = dirname(routeFilepath);
+    while (dir.startsWith(routesRoot)) {
+        const candidate = join(dir, 'error.nx');
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // No error.nx here — go up one level
+            const parent = dirname(dir);
+            if (parent === dir)
+                break; // Reached filesystem root
+            dir = parent;
+        }
+    }
+    return null; // No error boundary found
+}
+/**
+ * Finds the nearest `not-found.nx` for a given route directory.
+ */
+export async function findNotFoundBoundary(routeFilepath, routesRoot) {
+    let dir = dirname(routeFilepath);
+    while (dir.startsWith(routesRoot)) {
+        const candidate = join(dir, 'not-found.nx');
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    return null;
+}
+/**
+ * Renders an error boundary file to HTML.
+ * Sanitizes error info for production (hides stack, generates digest).
+ */
+export async function renderErrorBoundary(boundaryFile, originalError, ctx, opts) {
+    const error = normalizeError(originalError, opts.dev);
+    // Try to import and render the error.nx boundary
+    try {
+        const mod = await import(/* @vite-ignore */ boundaryFile);
+        if (typeof mod.render === 'function') {
+            const result = await mod.render({ ...ctx, errorBoundary: { error } });
+            return result.html ?? buildDefaultErrorHTML(error, opts.dev);
+        }
+    }
+    catch (renderErr) {
+        console.error('[Nexus] Error boundary itself threw:', renderErr);
+    }
+    return buildDefaultErrorHTML(error, opts.dev);
+}
+/**
+ * Default error page when no error.nx is found.
+ * Shows full details in dev, sanitized message in production.
+ */
+export function buildDefaultErrorHTML(error, dev) {
+    const details = dev
+        ? `<pre style="overflow:auto;background:#1a1a2e;padding:1rem;border-radius:8px;font-size:0.8rem;color:#ff6b6b">${htmlEscape(error.stack ?? '')}</pre>`
+        : error.digest
+            ? `<p style="font-family:monospace;color:#6b6b80;font-size:0.8rem">Error ID: ${error.digest}</p>`
+            : '';
+    return `<div data-nx-error-boundary style="
+    max-width:640px; margin:4rem auto; padding:2rem;
+    font-family:system-ui; background:#0a0a0f; color:#e8e8f0;
+    border:1px solid #ff3e00; border-radius:12px;
+  ">
+    <h2 style="color:#ff3e00;font-size:1.5rem;margin-bottom:0.5rem">
+      ${htmlEscape(error.name)}
+    </h2>
+    <p style="color:#a0a0b8;margin-bottom:1.5rem">${htmlEscape(error.message)}</p>
+    ${details}
+    <button
+      onclick="location.reload()"
+      style="background:#00d4aa;color:#000;border:none;padding:0.5rem 1.5rem;
+             border-radius:6px;cursor:pointer;font-weight:700"
+    >Try again</button>
+  </div>`;
+}
+/**
+ * Wraps a render function with error boundary protection.
+ * If the render throws, catches it and renders the nearest error.nx.
+ */
+export async function withErrorBoundary(fn, opts) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        console.error('[Nexus] Route render error:', err);
+        // Find nearest error boundary
+        const boundaryFile = await findErrorBoundary(opts.routeFilepath, opts.routesRoot);
+        const html = boundaryFile
+            ? await renderErrorBoundary(boundaryFile, err, opts.ctx, { dev: opts.dev })
+            : buildDefaultErrorHTML(normalizeError(err, opts.dev), opts.dev);
+        return { html: wrapInPage(html), status: 500 };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function normalizeError(err, dev) {
+    if (err instanceof Error) {
+        const normalized = {
+            message: err.message,
+            name: err.name,
+            digest: generateDigest(err.message),
+        };
+        if (dev && err.stack !== undefined) {
+            normalized.stack = err.stack;
+        }
+        return normalized;
+    }
+    const msg = String(err);
+    return {
+        message: msg,
+        name: 'Error',
+        digest: generateDigest(msg),
+    };
+}
+function generateDigest(msg) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < msg.length; i++) {
+        h ^= msg.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16).slice(0, 8).toUpperCase();
+}
+function wrapInPage(html) {
+    return `<!DOCTYPE html><html><body style="background:#0a0a0f">${html}</body></html>`;
+}
+function htmlEscape(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/error-boundary.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Nexus Server — Node.js HTTP server adapter.
+ * Handles SSR, static assets, Server Actions and dev HMR.
+ */
+export { createAction, registerAction, ActionError } from './actions.js';
+export { createContext } from './context.js';
+export type { NexusContext, CookieOptions } from './context.js';
+export type { RenderResult, RenderOptions } from './renderer.js';
+export interface RequestLogInfo {
+    method: string;
+    path: string;
+    status: number;
+    /** Request duration in milliseconds */
+    duration: number;
+    /** Cache strategy used by the renderer (e.g. 'swr', 'static-immutable', 'no-store') */
+    cacheStrategy?: string;
+    /** True when the route was served from a Server Action */
+    isAction?: boolean;
+}
+export interface NexusServerOptions {
+    /** Root directory of the Nexus app */
+    root: string;
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** Enable dev mode (HMR, verbose errors, detailed logs) */
+    dev?: boolean;
+    /** Static assets directory */
+    publicDir?: string;
+    /**
+     * Called after each HTTP request completes.
+     * Use this to implement a custom request logger in the CLI or integrations.
+     * The server itself does NOT print request logs — the host controls formatting.
+     */
+    onRequest?: (info: RequestLogInfo) => void;
+}
+export declare function createNexusServer(opts: NexusServerOptions): Promise<{
+    /** Starts listening. Resolves when the server is bound to the port. */
+    listen(): Promise<void>;
+    /** Re-scans src/routes — called on file changes in dev mode. */
+    reload(): Promise<void>;
+    close(): void;
+    readonly port: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C;AAmBD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB;IA6J5D,uEAAuE;cAC7D,OAAO,CAAC,IAAI,CAAC;IAavB,gEAAgE;cAChD,OAAO,CAAC,IAAI,CAAC;aAQpB,IAAI;;GAMhB"}

package/dist/index.js

@@ -0,0 +1,277 @@
+/**
+ * Nexus Server — Node.js HTTP server adapter.
+ * Handles SSR, static assets, Server Actions and dev HMR.
+ */
+import { createServer } from 'node:http';
+import { readFile, stat } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { buildRouteManifest, matchRoute } from '@nexus_js/router';
+import { handleActionRequest } from './actions.js';
+import { handleSSERequestNode, isConnectRequest, topicFromUrl } from '@nexus_js/connect';
+import { buildAggregatedNxStylesheet, bustAggregatedStylesCache, compileIslandClientBundle, isIslandClientRequest, tryServeRuntimeAsset, } from './dev-assets.js';
+import { renderRoute } from './renderer.js';
+import { preloadRegisteredServerActions } from './load-module.js';
+import { createContext, RedirectSignal, NotFoundSignal } from './context.js';
+export { createAction, registerAction, ActionError } from './actions.js';
+export { createContext } from './context.js';
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+    '.woff': 'font/woff',
+    '.avif': 'image/avif',
+    '.webp': 'image/webp',
+};
+export async function createNexusServer(opts) {
+    const port = opts.port ?? 3000;
+    const dev = opts.dev ?? false;
+    const routesDir = join(opts.root, 'src', 'routes');
+    const publicDir = join(opts.root, opts.publicDir ?? 'public');
+    let manifest = await buildRouteManifest(routesDir);
+    const renderOpts = {
+        dev,
+        appRoot: opts.root,
+        assets: {
+            /** ESM entry + chunks served from @nexus_js/runtime/dist via /_nexus/rt/* */
+            runtime: '/_nexus/rt/index.js',
+            styles: ['/_nexus/styles.css'],
+            islands: new Map(),
+        },
+    };
+    const server = createServer(async (req, res) => {
+        const t0 = Date.now();
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+        const method = req.method ?? 'GET';
+        // Capture cache strategy before headers are flushed, then call onRequest hook
+        let _cacheStrategy;
+        let _isAction = false;
+        if (opts.onRequest) {
+            res.on('finish', () => {
+                const info = {
+                    method,
+                    path: url.pathname,
+                    status: res.statusCode,
+                    duration: Date.now() - t0,
+                    isAction: _isAction,
+                };
+                if (_cacheStrategy !== undefined)
+                    info.cacheStrategy = _cacheStrategy;
+                opts.onRequest(info);
+            });
+        }
+        // ── Server Actions ──────────────────────────────────────────────────────
+        if (url.pathname.startsWith('/_nexus/action/')) {
+            _isAction = true;
+            const request = await incomingMessageToWebRequest(req);
+            const response = await handleActionRequest(request);
+            await webToNodeResponse(response, res);
+            return;
+        }
+        // ── Nexus Connect — SSE (/_nexus/connect/:topic) ────────────────────────
+        if (method === 'GET' && isConnectRequest(url)) {
+            handleSSERequestNode(req, res, topicFromUrl(url));
+            return;
+        }
+        // ── @nexus_js/runtime ESM (browser import graph: /_nexus/rt/index.js → ./island.js …)
+        const rt = await tryServeRuntimeAsset(url.pathname, opts.root);
+        if (rt) {
+            res.writeHead(200, { 'content-type': rt.contentType });
+            res.end(rt.body);
+            return;
+        }
+        // ── Client island ESM (dynamic import target for <nexus-island>) ───────
+        if (isIslandClientRequest(url.pathname) && method === 'GET') {
+            const out = await compileIslandClientBundle(opts.root, url);
+            res.writeHead(out.status, {
+                'content-type': 'application/javascript; charset=utf-8',
+                'cache-control': dev ? 'no-store' : 'public, max-age=120',
+            });
+            res.end(out.body);
+            return;
+        }
+        // ── Image optimizer (AVIF/WebP/resize) — same contract as Vite dev middleware
+        if (url.pathname === '/_nexus/image' && (method === 'GET' || method === 'HEAD')) {
+            const request = nodeToWebRequest(req);
+            const { handleImageRequest } = await import('@nexus_js/assets');
+            const response = await handleImageRequest(request, { publicDir });
+            if (method === 'HEAD') {
+                const headers = {};
+                response.headers.forEach((value, key) => { headers[key] = value; });
+                res.writeHead(response.status, headers);
+                res.end();
+                return;
+            }
+            await webToNodeResponse(response, res);
+            return;
+        }
+        // ── Aggregated scoped CSS from all .nx files under src/
+        if (url.pathname === '/_nexus/styles.css' && method === 'GET') {
+            try {
+                const css = await buildAggregatedNxStylesheet(opts.root);
+                res.writeHead(200, {
+                    'content-type': 'text/css; charset=utf-8',
+                    'cache-control': dev ? 'no-store' : 'public, max-age=300',
+                });
+                res.end(css);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                res.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' });
+                res.end(`[Nexus] Failed to build styles: ${msg}`);
+            }
+            return;
+        }
+        // ── Static files ────────────────────────────────────────────────────────
+        const staticResult = await serveStatic(url.pathname, publicDir);
+        if (staticResult) {
+            res.writeHead(200, { 'content-type': staticResult.mime });
+            res.end(staticResult.content);
+            return;
+        }
+        // ── SSR routing ─────────────────────────────────────────────────────────
+        const matched = matchRoute(url.pathname, manifest);
+        if (!matched) {
+            res.writeHead(404, { 'content-type': 'text/html' });
+            res.end(notFoundPage(url.pathname, dev));
+            return;
+        }
+        const request = nodeToWebRequest(req);
+        const ctx = createContext(request, matched.params);
+        try {
+            const result = await renderRoute(matched, ctx, renderOpts);
+            _cacheStrategy = result.headers['x-nexus-cache-strategy'];
+            res.writeHead(result.status, result.headers);
+            res.end(result.html);
+        }
+        catch (err) {
+            if (err instanceof RedirectSignal) {
+                res.writeHead(err.status, { location: err.location });
+                res.end();
+                return;
+            }
+            if (err instanceof NotFoundSignal) {
+                res.writeHead(404, { 'content-type': 'text/html' });
+                res.end(notFoundPage(url.pathname, dev));
+                return;
+            }
+            if (dev) {
+                const message = err instanceof Error ? err.message : String(err);
+                const stack = err instanceof Error ? (err.stack ?? '') : '';
+                console.error(`\x1b[31m[Nexus Error]\x1b[0m ${method} ${url.pathname}\n  ${message}`);
+                if (stack)
+                    stack.split('\n').slice(1, 6).forEach(l => console.error(`  \x1b[2m${l.trim()}\x1b[0m`));
+            }
+            else {
+                console.error('[Nexus] Unhandled error:', err);
+            }
+            res.writeHead(500, { 'content-type': 'text/html' });
+            res.end(serverErrorPage(err, dev));
+        }
+    });
+    return {
+        /** Starts listening. Resolves when the server is bound to the port. */
+        listen() {
+            return new Promise((resolve, reject) => {
+                void (async () => {
+                    try {
+                        await preloadRegisteredServerActions(opts.root, dev);
+                    }
+                    catch (err) {
+                        console.error('[Nexus] Server action preload failed:', err);
+                    }
+                    server.listen(port, () => resolve());
+                })().catch(reject);
+            });
+        },
+        /** Re-scans src/routes — called on file changes in dev mode. */
+        async reload() {
+            bustAggregatedStylesCache();
+            manifest = await buildRouteManifest(routesDir);
+            if (dev) {
+                await preloadRegisteredServerActions(opts.root, true);
+            }
+        },
+        close() {
+            server.close();
+        },
+        get port() { return port; },
+    };
+}
+// ── Adapters ────────────────────────────────────────────────────────────────
+function nodeToWebRequest(req) {
+    const url = `http://${req.headers.host ?? 'localhost'}${req.url ?? '/'}`;
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value)
+            headers.set(key, Array.isArray(value) ? value.join(', ') : value);
+    }
+    return new Request(url, { method: req.method ?? 'GET', headers });
+}
+/** Full body (for POST server actions — `nodeToWebRequest` omits the stream). */
+async function incomingMessageToWebRequest(req) {
+    const url = `http://${req.headers.host ?? 'localhost'}${req.url ?? '/'}`;
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value)
+            headers.set(key, Array.isArray(value) ? value.join(', ') : value);
+    }
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(Buffer.from(chunk));
+    }
+    const raw = Buffer.concat(chunks);
+    const method = req.method ?? 'GET';
+    const init = { method, headers };
+    if (raw.length > 0 && (method === 'POST' || method === 'PUT' || method === 'PATCH')) {
+        init.body = new Uint8Array(raw);
+    }
+    return new Request(url, init);
+}
+async function webToNodeResponse(response, res) {
+    const headers = {};
+    response.headers.forEach((value, key) => { headers[key] = value; });
+    res.writeHead(response.status, headers);
+    const body = Buffer.from(await response.arrayBuffer());
+    res.end(body);
+}
+async function serveStatic(pathname, publicDir) {
+    const safePath = join(publicDir, pathname.replace(/^\/+/, ''));
+    try {
+        const info = await stat(safePath);
+        if (!info.isFile())
+            return null;
+        const content = await readFile(safePath);
+        const mime = MIME_TYPES[extname(safePath)] ?? 'application/octet-stream';
+        return { content, mime };
+    }
+    catch {
+        return null;
+    }
+}
+function serverErrorPage(err, dev) {
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = dev && err instanceof Error ? (err.stack ?? '') : '';
+    return `<!DOCTYPE html><html lang="en"><body style="font-family:monospace;padding:2rem;background:#0a0a0f;color:#e8e8f0">
+    <h1 style="color:#ff3e00">◆ Nexus — 500 Server Error</h1>
+    <pre style="color:#ff6b6b;background:#0d0d1a;padding:1rem;border-radius:6px;overflow:auto">${message}</pre>
+    ${dev && stack ? `<details open><summary style="cursor:pointer;color:#6b6b80">Stack trace</summary>
+      <pre style="font-size:0.75rem;color:#4b5563">${stack.replace(/</g, '&lt;')}</pre>
+    </details>` : ''}
+  </body></html>`;
+}
+function notFoundPage(pathname, dev) {
+    return `<!DOCTYPE html><html><body style="font-family:monospace;padding:2rem;background:#0a0a0f;color:#e8e8f0">
+    <h1 style="color:#00d4aa">◆ Nexus — 404</h1>
+    <p>No route found for <code style="color:#ff3e00">${pathname}</code></p>
+    ${dev ? `<p style="color:#6b6b80">Add a file at <code>src/routes${pathname}/+page.nx</code> to create this page.</p>` : ''}
+  </body></html>`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/load-module.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Load route modules in dev (compile .nx → .mjs) and prod (pre-built .js under .nexus/output).
+ */
+export interface LoadRouteModuleOptions {
+    dev: boolean;
+    /** App root (where package.json and node_modules live) */
+    appRoot: string;
+    /** Route pattern from manifest, e.g. `/`, `/editor`, `/blog/:slug` */
+    pattern: string;
+}
+/**
+ * Re-import every `*.actions.mjs` under `.nexus/dev-server` so `registerAction` picks up
+ * code changes (including edits to files imported from the sidecar, e.g. `$lib/chat-room.js`).
+ * Called from `server.reload()` when the CLI file watcher fires.
+ */
+/**
+ * Loads every route module once so generated `*.actions.*` sidecars run `registerAction`
+ * before any HTTP request. Dev: compiles each `.nx` route; prod: imports `*.actions.js` from `.nexus/output`.
+ */
+export declare function preloadRegisteredServerActions(appRoot: string, dev: boolean): Promise<void>;
+export declare function reimportDevActionSidecars(appRoot: string): Promise<void>;
+/**
+ * Dynamic import for `.ts`/`.js` routes, compiled `.nx` in dev, or built `.js` in production.
+ */
+export declare function loadRouteModule(filepath: string, options: LoadRouteModuleOptions): Promise<Record<string, unknown>>;
+//# sourceMappingURL=load-module.d.ts.map

package/dist/load-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-module.d.ts","sourceRoot":"","sources":["../src/load-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,OAAO,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AAuID;;;;GAIG;AACH;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCjG;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9E;AAmBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0ElC"}