@canonical/react-ssr 0.22.0 → 0.24.0

package/dist/esm/bin/serve-express.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * Standalone Express server for serving an SSR application.
+ *
+ * Dynamically imports a renderer module that exports a factory function.
+ * The factory receives a Node `IncomingMessage` and returns a renderer.
+ * Supports both streaming and string rendering modes.
+ *
+ * @example
+ * ```sh
+ * # String rendering (default), one static directory
+ * serve-express dist/server/renderer.js --static assets:dist/client/assets
+ *
+ * # Streaming, multiple static directories
+ * serve-express dist/server/renderer.js --streaming \
+ *   --static assets:dist/client/assets \
+ *   --static public:dist/client/public
+ *
+ * # Custom port
+ * serve-express dist/server/renderer.js -p 3000 --static assets:dist/client/assets
+ * ```
+ */
+import path from "node:path";
+import { parseArgs } from "node:util";
+import express from "express";
+import { serveStream } from "#server";
+/**
+ * Parse a `route:filepath` string into its constituent parts.
+ *
+ * @param pair - A string in the format `"route:filepath"`, e.g. `"assets:dist/client/assets"`.
+ * @returns An object with the route prefix and the absolute filesystem path.
+ */
+function parseStaticPair(pair) {
+    const separatorIndex = pair.indexOf(":");
+    if (separatorIndex === -1) {
+        return { route: `/${pair}`, dir: path.join(process.cwd(), pair) };
+    }
+    const route = pair.slice(0, separatorIndex);
+    const filepath = pair.slice(separatorIndex + 1);
+    return {
+        route: `/${route}`,
+        dir: path.join(process.cwd(), filepath),
+    };
+}
+const { values, positionals } = parseArgs({
+    args: process.argv.slice(2),
+    options: {
+        port: {
+            type: "string",
+            alias: "p",
+            default: "5173",
+        },
+        static: {
+            type: "string",
+            alias: "s",
+            multiple: true,
+            default: ["assets:dist/client/assets"],
+        },
+        streaming: {
+            type: "boolean",
+            default: false,
+        },
+    },
+    strict: true,
+    allowPositionals: true,
+});
+const port = Number(values.port) || 5173;
+const rendererFilePath = path.join(process.cwd(), positionals[0]);
+if (!rendererFilePath) {
+    console.error("Usage: serve-express <renderer-path> [--static route:path ...] [--streaming] [-p port]");
+    process.exit(1);
+}
+const createRenderer = await import(rendererFilePath).then((m) => m.default);
+if (typeof createRenderer !== "function") {
+    throw new Error("Renderer module must default-export a factory function (req) => Renderer.");
+}
+const app = express();
+for (const pair of values.static ?? []) {
+    const { route, dir } = parseStaticPair(pair);
+    app.use(route, express.static(dir));
+}
+app.use(serveStream(createRenderer));
+app.listen(port, () => {
+    console.log(`Server started on http://localhost:${port}/`);
+});
+//# sourceMappingURL=serve-express.js.map

package/dist/esm/bin/serve-express.js.map

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

package/dist/esm/index.js

@@ -1,3 +1,4 @@
-export * as renderer from "./renderer/index.js";
-export * as server from "./server/index.js";
+export * as adapter from "./lib/adapter/index.js";
+export * as renderer from "./lib/renderer/index.js";
+export * as server from "./lib/server/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC"}

package/dist/esm/lib/adapter/index.js

@@ -0,0 +1,2 @@
+export { buildCacheControl, getMimeType, matchPattern } from "./mime.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/lib/adapter/mime.js

@@ -0,0 +1,85 @@
+/**
+ * Minimal MIME type lookup for static asset serving.
+ *
+ * Covers the file types commonly produced by Vite builds (scripts, styles,
+ * images, fonts, source maps). Adapters use this when the platform doesn't
+ * provide native MIME detection (Cloudflare R2, Deno filesystem).
+ *
+ * No external dependencies — the lookup is a plain record.
+ */
+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; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+    ".txt": "text/plain; charset=utf-8",
+    ".xml": "application/xml; charset=utf-8",
+    ".wasm": "application/wasm",
+    ".map": "application/json; charset=utf-8",
+};
+/**
+ * Look up the MIME type for a file path based on its extension.
+ *
+ * Returns `"application/octet-stream"` for unknown extensions.
+ *
+ * @param path - File path or name (e.g. `"main.abc123.js"`, `"/assets/logo.png"`).
+ * @returns The MIME type string.
+ */
+export function getMimeType(path) {
+    const dotIndex = path.lastIndexOf(".");
+    if (dotIndex === -1)
+        return "application/octet-stream";
+    const ext = path.slice(dotIndex).toLowerCase();
+    return MIME_TYPES[ext] ?? "application/octet-stream";
+}
+/**
+ * Build a `Cache-Control` header value from a cache configuration.
+ *
+ * @param cache - Cache configuration with optional directives.
+ * @returns A `Cache-Control` header string.
+ */
+export function buildCacheControl(cache) {
+    const parts = [];
+    if (cache.maxAge != null)
+        parts.push(`max-age=${cache.maxAge}`);
+    if (cache.sMaxAge != null)
+        parts.push(`s-maxage=${cache.sMaxAge}`);
+    if (cache.staleWhileRevalidate != null)
+        parts.push(`stale-while-revalidate=${cache.staleWhileRevalidate}`);
+    return parts.length > 0 ? `public, ${parts.join(", ")}` : "public";
+}
+/**
+ * Match a URL pathname against a simple pattern.
+ *
+ * Supports three forms:
+ * - Exact match: `"/sitemap.xml"` matches only `"/sitemap.xml"`
+ * - Wildcard suffix: `"/api/*"` matches `"/api/"` and anything below
+ * - Catch-all: `"/*"` matches everything
+ *
+ * @param pattern - The route pattern.
+ * @param pathname - The URL pathname to test.
+ * @returns `true` if the pathname matches the pattern.
+ */
+export function matchPattern(pattern, pathname) {
+    if (pattern === "/*")
+        return true;
+    if (pattern.endsWith("/*")) {
+        const prefix = pattern.slice(0, -2);
+        return pathname === prefix || pathname.startsWith(`${prefix}/`);
+    }
+    return pathname === pattern;
+}
+//# sourceMappingURL=mime.js.map

package/dist/esm/lib/adapter/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../../src/lib/adapter/mime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,GAA2B;IACzC,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,uCAAuC;IAC/C,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,2BAA2B;IACnC,MAAM,EAAE,gCAAgC;IACxC,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iCAAiC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,0BAA0B,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAIjC;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,oBAAoB,IAAI,IAAI;QACpC,KAAK,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAgB;IAC5D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,KAAK,OAAO,CAAC;AAC9B,CAAC"}

package/dist/esm/lib/adapter/types.js

@@ -0,0 +1,10 @@
+/**
+ * Shared type contracts for SSR deployment adapters.
+ *
+ * These types define the interface between platform-specific adapters
+ * (Cloudflare Workers, Vercel, Deno Deploy) and the transport-agnostic
+ * renderers in `@canonical/react-ssr`. Adapters consume these types;
+ * renderers satisfy them.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/adapter/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/esm/lib/index.js

@@ -0,0 +1,4 @@
+export * as adapter from "./adapter/index.js";
+export * as renderer from "./renderer/index.js";
+export * as server from "./server/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}

package/dist/esm/lib/renderer/Extractor.js

@@ -0,0 +1,172 @@
+import { toCamelCase } from "@canonical/utils";
+import { Parser } from "htmlparser2";
+import React from "react";
+/**
+ * Maps HTML attribute names to their React prop equivalents.
+ *
+ * React uses camelCase for most DOM attributes, but a handful of common
+ * HTML attributes have specific React names that do not follow the general
+ * camelCase rule. This dictionary covers those exceptions. Any attribute
+ * not listed here falls through to the generic `toCamelCase` converter.
+ */
+const REACT_KEYS_DICTIONARY = {
+    class: "className",
+    for: "htmlFor",
+    crossorigin: "crossOrigin",
+    charset: "charSet",
+};
+/** Tag names that `getOtherHeadElements` collects. */
+const HEAD_OTHER_TAGS = new Set(["title", "style", "meta", "base"]);
+/**
+ * Parse an HTML string and extract all `<head>` elements of interest.
+ *
+ * Uses htmlparser2's SAX `Parser` to stream through the HTML in a single
+ * pass. Each opening tag that matches a head element type is recorded,
+ * and any immediate text content is captured for tags like `<title>` and
+ * `<style>` that carry inline text.
+ *
+ * Elements are returned in document order, grouped into three categories:
+ * links, scripts, and everything else (title, style, meta, base).
+ *
+ * @param html - The full HTML string to parse (typically from a Vite build).
+ * @returns Three arrays of collected elements, in document order.
+ */
+function parseHeadElements(html) {
+    const links = [];
+    const scripts = [];
+    const others = [];
+    let current;
+    const parser = new Parser({
+        onopentag(name, attribs) {
+            if (name === "link" || name === "script" || HEAD_OTHER_TAGS.has(name)) {
+                current = { name, attribs, text: undefined };
+            }
+            else {
+                current = undefined;
+            }
+        },
+        ontext(data) {
+            if (current) {
+                current.text = current.text == null ? data : current.text + data;
+            }
+        },
+        onclosetag(name) {
+            if (!current || current.name !== name)
+                return;
+            // <link> is void — it never has text children
+            if (name === "link") {
+                current.text = undefined;
+            }
+            if (current.name === "link") {
+                links.push(current);
+            }
+            else if (current.name === "script") {
+                scripts.push(current);
+            }
+            else {
+                others.push(current);
+            }
+            current = undefined;
+        },
+    });
+    parser.write(html);
+    parser.end();
+    // Flush any pending <link> that never received an onclosetag.
+    // htmlparser2 fires onclosetag for void elements, so this is a defensive
+    // guard for edge cases in non-standard HTML or alternative parsers.
+    /* v8 ignore next 4 -- defensive: htmlparser2 always fires onclosetag for void elements */
+    if (current?.name === "link") {
+        current.text = undefined;
+        links.push(current);
+    }
+    return { links, scripts, others };
+}
+/**
+ * Extracts `<head>` elements from an HTML string and converts them to React elements.
+ *
+ * The primary use case is server-side rendering with Vite: the build process produces
+ * an HTML shell containing `<script>`, `<link>`, `<meta>`, `<title>`, `<style>`, and
+ * `<base>` tags. This class parses that shell via `parseHeadElements` (a SAX handler —
+ * no DOM tree is constructed) and exposes the extracted tags as React elements that the
+ * server entrypoint component can inject into its rendered output.
+ *
+ * Parsing happens once in the constructor. The three getter methods return the
+ * elements in the order they appeared in the original HTML.
+ */
+export default class Extractor {
+    /** Parsed head elements, grouped by category. */
+    parsed;
+    /**
+     * Create an Extractor for the given HTML string.
+     *
+     * @param html - The full HTML string to parse (typically from a Vite build).
+     */
+    constructor(html) {
+        this.parsed = parseHeadElements(html);
+    }
+    /**
+     * Convert an HTML attribute name to the corresponding React prop name.
+     *
+     * Checks `REACT_KEYS_DICTIONARY` for known exceptions (e.g. `class` becomes
+     * `className`). Falls back to generic camelCase conversion, which correctly
+     * handles `data-*` and `aria-*` attributes.
+     *
+     * @param key - The HTML attribute name, e.g. `"crossorigin"` or `"data-test-id"`.
+     * @returns The React prop name, e.g. `"crossOrigin"` or `"dataTestId"`.
+     */
+    convertKeyToReactKey(key) {
+        return REACT_KEYS_DICTIONARY[key.toLowerCase()] ?? toCamelCase(key);
+    }
+    /**
+     * Convert a collected element into a `React.createElement` call.
+     *
+     * Attributes are mapped to React prop names via `convertKeyToReactKey`.
+     * A stable `key` prop is synthesised from the tag name and the element's
+     * position index so that React can reconcile lists of head elements.
+     *
+     * If the element has text content (e.g. `<title>My App</title>` or
+     * `<style>.body { color: red }</style>`), it is passed as the element's
+     * `children` argument.
+     *
+     * @param element - The collected element data from SAX parsing.
+     * @param index - The position of this element within its sibling group.
+     * @returns A React element matching the original HTML tag.
+     */
+    convertToReactElement(element, index) {
+        const props = {};
+        for (const [key, value] of Object.entries(element.attribs)) {
+            props[this.convertKeyToReactKey(key)] = value;
+        }
+        props.key = `${element.name}_${index}`;
+        return React.createElement(element.name, props, element.text);
+    }
+    /**
+     * Return all `<link>` elements as React elements, in document order.
+     *
+     * Typically used to inject stylesheet and preload links into the
+     * server-rendered `<head>`.
+     */
+    getLinkElements() {
+        return this.parsed.links.map((el, i) => this.convertToReactElement(el, i));
+    }
+    /**
+     * Return all `<script>` elements as React elements, in document order.
+     *
+     * Preserving order is important: Vite dev mode emits module scripts
+     * that depend on being evaluated in sequence.
+     */
+    getScriptElements() {
+        return this.parsed.scripts.map((el, i) => this.convertToReactElement(el, i));
+    }
+    /**
+     * Return all non-script, non-link head elements as React elements, in document order.
+     *
+     * This covers `<title>`, `<style>`, `<meta>`, and `<base>`. Elements are returned
+     * in the order they appeared in the HTML, preserving inter-type ordering (a `<meta>`
+     * between two `<style>` tags stays between them).
+     */
+    getOtherHeadElements() {
+        return this.parsed.others.map((el, i) => this.convertToReactElement(el, i));
+    }
+}
+//# sourceMappingURL=Extractor.js.map

package/dist/esm/lib/renderer/Extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Extractor.js","sourceRoot":"","sources":["../../../../src/lib/renderer/Extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAA2B;IACpD,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,SAAS;IACd,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,sDAAsD;AACtD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAuBpE;;;;;;;;;;;;;GAaG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,OAAqC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,SAAS,CAAC,IAAI,EAAE,OAAO;YACrB,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,OAAO,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACnE,CAAC;QACH,CAAC;QACD,UAAU,CAAC,IAAI;YACb,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO;YAE9C,8CAA8C;YAC9C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;YAC3B,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YAED,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,EAAE,CAAC;IAEb,8DAA8D;IAC9D,yEAAyE;IACzE,oEAAoE;IACpE,0FAA0F;IAC1F,IAAI,OAAO,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,iDAAiD;IAC9B,MAAM,CAAc;IAEvC;;;;OAIG;IACH,YAAY,IAAY;QACtB,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;OASG;IACO,oBAAoB,CAAC,GAAW;QACxC,OAAO,qBAAqB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACO,qBAAqB,CAC7B,OAAyB,EACzB,KAAa;QAEb,MAAM,KAAK,GAA2B,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACI,eAAe;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CACvC,IAAI,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC,CAAC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;CACF"}