@nifrajs/web 5.5.1 → 5.7.0

package/dist/internal/dev-websocket.js

@@ -0,0 +1,145 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+export function isWebSocketUpgrade(request) {
+    return request.headers.get("upgrade")?.toLowerCase() === "websocket";
+}
+/** A standard-socket view `attach` wires its listeners to; the dev server feeds it events. */
+function socketView(native) {
+    const listeners = new Map();
+    return {
+        view: {
+            send: (data) => {
+                native.send(data);
+            },
+            close: (code, reason) => native.close(code, reason),
+            get readyState() {
+                return native.readyState;
+            },
+            addEventListener(type, listener) {
+                listeners.set(type, [...(listeners.get(type) ?? []), listener]);
+            },
+        },
+        emit(type, event) {
+            for (const listener of listeners.get(type) ?? [])
+                Reflect.apply(listener, undefined, [event]);
+        },
+    };
+}
+function attachView(view, outcome) {
+    outcome.attach(view, outcome.handler, outcome.data, {
+        openNow: true,
+        pubsub: outcome.pubsub,
+        maxPayloadBytes: outcome.maxPayloadBytes,
+    });
+}
+/** `Bun.serve`'s `websocket` option for a dev server whose upgrades go through {@link upgradeOnBun}. */
+export const bunDevWebSocket = {
+    open(socket) {
+        const { view, emit } = socketView(socket);
+        socket.data.emit = emit;
+        attachView(view, socket.data.outcome);
+    },
+    message(socket, message) {
+        socket.data.emit?.("message", { data: message });
+    },
+    close(socket, code, reason) {
+        socket.data.emit?.("close", { code, reason });
+    },
+};
+/**
+ * Run the handshake through the app. `undefined` when the socket was upgraded; a `Response` for a
+ * refusal; `"pass"` when no WebSocket route takes the path, for the dev server to answer as HTTP.
+ */
+export async function upgradeOnBun(app, request, server) {
+    if (app.resolveWebSocketUpgrade === undefined)
+        return "pass";
+    const outcome = await app.resolveWebSocketUpgrade(request);
+    if (outcome.kind === "pass")
+        return "pass";
+    if (outcome.kind === "reject")
+        return outcome.response;
+    return server.upgrade(request, { data: { outcome } })
+        ? undefined
+        : new Response("upgrade_required", { status: 426 });
+}
+const TEXT = new TextDecoder();
+const textOf = (data) => typeof data === "string" ? data : TEXT.decode(data);
+/** A non-literal specifier: `ws` is an optional peer, typed structurally above. */
+const WS_MODULE = "ws";
+/** A noServer `ws` server from `specifier`; undefined when it cannot be loaded or has none. */
+export async function wsServerFrom(specifier) {
+    try {
+        const mod = await import(__rewriteRelativeImportExtension(specifier));
+        const Server = mod.WebSocketServer ?? mod.default?.WebSocketServer;
+        return Server === undefined ? undefined : new Server({ noServer: true });
+    }
+    catch {
+        return undefined;
+    }
+}
+let wsServer;
+/** One server for every dev upgrade. */
+const loadWsServer = () => {
+    wsServer ??= wsServerFrom(WS_MODULE);
+    return wsServer;
+};
+/**
+ * Answer a Node `upgrade` event through the app. Resolves `false` when no WebSocket route takes the
+ * path, leaving the socket to the other listeners (Vite's HMR among them).
+ */
+export async function upgradeOnNode(app, request, nodeRequest, socket, head, wsServerOf = loadWsServer) {
+    if (app.resolveWebSocketUpgrade === undefined)
+        return false;
+    // A peer can reset the socket while the guard is awaited; with no listener that error ends the process.
+    socket.on("error", () => { });
+    let outcome;
+    try {
+        outcome = await app.resolveWebSocketUpgrade(request);
+    }
+    catch {
+        await writeRefusal(socket, new Response("internal_error", { status: 500 }));
+        return true;
+    }
+    if (outcome.kind === "pass")
+        return false;
+    if (outcome.kind === "reject") {
+        await writeRefusal(socket, outcome.response);
+        return true;
+    }
+    const wss = await wsServerOf();
+    if (wss === undefined) {
+        await writeRefusal(socket, new Response("[nifra] install `ws` to serve app.ws() routes under the Vite dev server\n", {
+            status: 501,
+        }));
+        return true;
+    }
+    const upgrade = outcome;
+    wss.handleUpgrade(nodeRequest, socket, head, (ws) => {
+        const { view, emit } = socketView(ws);
+        ws.on("message", (data, isBinary) => emit("message", { data: isBinary ? data : textOf(data) }));
+        // Bun's `node:http` stops listening when a socket's close listener throws.
+        ws.on("close", (code, reason) => emit("close", { code, reason: textOf(reason) }));
+        ws.on("error", (error) => emit("error", error));
+        attachView(view, upgrade);
+    });
+    return true;
+}
+/** A refusal written to the raw socket, then closed. */
+async function writeRefusal(socket, response) {
+    const body = await response.text();
+    let head = `HTTP/1.1 ${response.status} ${response.statusText || "Refused"}\r\n`;
+    response.headers.forEach((value, key) => {
+        if (key !== "content-length" && key !== "connection")
+            head += `${key}: ${value}\r\n`;
+    });
+    head += `content-length: ${new TextEncoder().encode(body).byteLength}\r\nconnection: close\r\n\r\n`;
+    socket.write(head + body);
+    socket.destroy();
+}
+//# sourceMappingURL=dev-websocket.js.map

package/dist/internal/dev-websocket.js.map

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

package/dist/internal/hole-runtime.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The browser side of a partially prerendered page's holes, shared by every adapter's `Hole`: the
+ * host's first fill from the document, and each refill a data request brings when the page on screen
+ * reloads. An adapter supplies only how an interactive hole's own root hydrates, updates and goes. A
+ * hole that shows a server component mounts the client islands inside it through the component
+ * client the app registered with `holeComponents` (`@nifrajs/web/server-components/client`).
+ */
+import type { ComponentClientAdapter } from "../server-components/client.js";
+import type { ComponentRecord } from "../server-components/types.js";
+/** One hole's fill, as the PPR runtime keeps it. */
+export interface HoleFill {
+    readonly props?: unknown;
+    readonly error: boolean;
+    /** The record of the server component the hole shows, without its HTML. */
+    readonly component?: unknown;
+    /** That component's HTML. */
+    readonly html?: string;
+}
+/** The error slot a failed, timed-out or refused hole shows. Constant: no thrown message reaches it. */
+export declare const HOLE_ERROR_HTML = "<p data-nifra-hole-error=\"\">This section is unavailable.</p>";
+/** How the islands inside a hole that shows a server component mount: the app's component client,
+ * and the protocol check the component's record passes first. */
+export interface HoleComponents {
+    readonly client: ComponentClientAdapter;
+    record(value: unknown): ComponentRecord;
+}
+/** What `holeComponents` registers; `undefined` forgets it. */
+export declare function setHoleComponents(next: HoleComponents | undefined): void;
+/** An interactive hole's own root, as its adapter made it. */
+export interface HoleRoot {
+    /** Render new props into the root, keeping its state; `false` when it has to be made again. */
+    update(props: unknown): boolean;
+    /** `leaving`: the page is unmounting the host, so the adapter may defer the work. A promise means
+     * the host is not free until it settles. */
+    dispose(leaving: boolean): void | Promise<void>;
+    /** The kept page holding the host is hidden (`true`) or shown again: a root whose framework can
+     * pause what it runs keeps its state either way. */
+    hide?(hidden: boolean): void;
+}
+export interface HoleHost {
+    /** Apply a data request's fill once it arrives, unless a newer one is given first. Without the
+     * shell's runtime, only a server component's fill or the error slot can be put. A first fill the
+     * host was rendered with (`initialHtml`) hydrates its islands over that HTML. */
+    refill(fill: unknown): void;
+    dispose(): void;
+    /**
+     * For an adapter whose hidden page cleans its effects up (React's `Activity`): while a kept page
+     * hides the host, keep it, root and all, for the page's return, and dispose it only if the page is
+     * dropped. `false` when nothing hides the host, and disposing is the adapter's.
+     */
+    park(): boolean;
+    /** The parked host is the adapter's again. */
+    unpark(): void;
+}
+/**
+ * What a host renders with: a blocking render's settled fill puts the server's HTML in it, which a
+ * crawler reads with no script; any other state leaves it empty. A host reads it once, so no later
+ * render changes what the runtime put there.
+ */
+export declare const initialHtml: (fill: unknown) => string;
+/**
+ * Drive the host of hole `name`. `hydrate` makes an interactive hole's root over the server HTML in
+ * `host`; a hole without one only ever shows server HTML, or a server component's.
+ */
+export declare function holeHost(name: string, host: Element, hydrate: ((host: Element, props: unknown) => HoleRoot) | undefined): HoleHost;
+//# sourceMappingURL=hole-runtime.d.ts.map

package/dist/internal/hole-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hole-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/hole-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAuB,MAAM,gCAAgC,CAAA;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAGpE,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAWD,wGAAwG;AACxG,eAAO,MAAM,eAAe,mEAAiE,CAAA;AAgB7F;iEACiE;AACjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAA;CACxC;AAID,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAExE;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,+FAA+F;IAC/F,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAC/B;gDAC4C;IAC5C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C;wDACoD;IACpD,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB;;qFAEiF;IACjF,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3B,OAAO,IAAI,IAAI,CAAA;IACf;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAA;IACf,8CAA8C;IAC9C,MAAM,IAAI,IAAI,CAAA;CACf;AAWD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,MACwD,CAAA;AAkEpG;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAC,GAAG,SAAS,GACjE,QAAQ,CA2GV"}

package/dist/internal/hole-runtime.js

@@ -0,0 +1,211 @@
+import { onPageRelease, PAGE_HIDE_EVENT, PAGE_SHOW_EVENT } from "./page-events.js";
+/** The error slot a failed, timed-out or refused hole shows. Constant: no thrown message reaches it. */
+export const HOLE_ERROR_HTML = '<p data-nifra-hole-error="">This section is unavailable.</p>';
+const ERROR_FRAME = { v: 1, error: true, html: HOLE_ERROR_HTML };
+/** The runtime the shell's inline script defines, when this document has one. */
+const pprRuntime = () => {
+    const runtime = Reflect.get(globalThis, "__nifraPpr");
+    return typeof runtime === "function" &&
+        "get" in runtime &&
+        "subscribe" in runtime &&
+        "put" in runtime
+        ? // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: the shell's constant inline runtime defines exactly this shape.
+            runtime
+        : undefined;
+};
+let components;
+/** What `holeComponents` registers; `undefined` forgets it. */
+export function setHoleComponents(next) {
+    components = next;
+}
+const isRecord = (value) => typeof value === "object" && value !== null;
+/** A fill the server deferred: the NDJSON stream settles its promise. */
+const settledFill = (fill) => isRecord(fill) && fill.__nifra_deferred === true && fill.promise instanceof Promise
+    ? fill.promise
+    : Promise.resolve(fill);
+/**
+ * What a host renders with: a blocking render's settled fill puts the server's HTML in it, which a
+ * crawler reads with no script; any other state leaves it empty. A host reads it once, so no later
+ * render changes what the runtime put there.
+ */
+export const initialHtml = (fill) => isRecord(fill) && fill.__nifra_deferred !== true && typeof fill.html === "string" ? fill.html : "";
+/** The record of the server component a fill shows, its HTML put back, not yet checked. */
+const recordOf = (fill) => isRecord(fill.component) && typeof fill.html === "string"
+    ? { ...fill.component, html: fill.html }
+    : undefined;
+/** The error slot, built without HTML parsing, for a document with no runtime to put it. */
+const errorSlot = (host) => {
+    const slot = host.ownerDocument.createElement("p");
+    slot.setAttribute("data-nifra-hole-error", "");
+    slot.textContent = "This section is unavailable.";
+    host.replaceChildren(slot);
+    host.setAttribute("data-nifra-hole-error", "");
+};
+/**
+ * The islands of the server component in `host`: hydrated over the server's HTML, or with `fresh`,
+ * put into the host from the record. `failed` runs when they cannot mount, as when the record fails
+ * the protocol check.
+ */
+function componentRoot(host, unchecked, fresh, failed) {
+    const registered = components;
+    let current = true;
+    const valid = () => current;
+    const mounted = (async () => {
+        if (registered === undefined) {
+            throw new Error("[nifra/web] ppr: a hole shows a server component, but no holeComponents client");
+        }
+        const { client } = registered;
+        const record = registered.record(unchecked);
+        const mount = fresh ? client.create : client.hydrate;
+        if (mount === undefined)
+            throw new Error("[nifra/web] ppr: the component client cannot create");
+        const prepared = await client.prepare(record, valid, host, { records: [record] });
+        if (!current)
+            return undefined;
+        const root = await mount.call(client, host, record, prepared, valid);
+        if (!current) {
+            await root.dispose();
+            return undefined;
+        }
+        host.setAttribute("aria-busy", "false");
+        return root;
+    })().catch((error) => {
+        if (current) {
+            console.error("[nifra/web] ppr: a server component hole's islands did not mount", error);
+            failed();
+        }
+        return undefined;
+    });
+    return {
+        update: () => false,
+        dispose() {
+            current = false;
+            return mounted.then((root) => root?.dispose());
+        },
+    };
+}
+/**
+ * Drive the host of hole `name`. `hydrate` makes an interactive hole's root over the server HTML in
+ * `host`; a hole without one only ever shows server HTML, or a server component's.
+ */
+export function holeHost(name, host, hydrate) {
+    const runtime = pprRuntime();
+    let root;
+    let disposed = false;
+    let latest = 0;
+    // The kept page hiding the host, and what disposes the host if that page is dropped.
+    let hiddenBy;
+    let release;
+    const put = (frame) => {
+        if (runtime !== undefined)
+            runtime.put(name, frame, host);
+        else
+            errorSlot(host);
+        host.setAttribute("aria-busy", "false");
+    };
+    const showError = () => {
+        root = undefined;
+        put(ERROR_FRAME);
+    };
+    const start = (fill) => {
+        if (disposed || root !== undefined || fill.error)
+            return;
+        const record = recordOf({ component: fill.component, html: fill.html });
+        if (record !== undefined)
+            root = componentRoot(host, record, false, showError);
+        else if (hydrate !== undefined)
+            root = hydrate(host, fill.props);
+    };
+    const now = runtime?.get(name);
+    const unsubscribe = now === undefined && (hydrate !== undefined || components !== undefined)
+        ? runtime?.subscribe(name, start)
+        : undefined;
+    if (now !== undefined)
+        start(now);
+    // A `keepAlive` page hidden behind another has been left: the document's holes stop filling and
+    // the ones still loading are cancelled, and a refill already on its way is dropped. The page's
+    // reload when it is shown again refills the host.
+    const hidden = (event) => {
+        if (!(event.target instanceof Element) || !event.target.contains(host))
+            return;
+        hiddenBy = event.target;
+        latest++;
+        runtime?.leave?.();
+        root?.hide?.(true);
+    };
+    const shown = (event) => {
+        if (event.target !== hiddenBy)
+            return;
+        hiddenBy = undefined;
+        root?.hide?.(false);
+    };
+    host.ownerDocument.addEventListener(PAGE_HIDE_EVENT, hidden);
+    host.ownerDocument.addEventListener(PAGE_SHOW_EVENT, shown);
+    const apply = (frame, mine, inPlace) => {
+        if (!isRecord(frame))
+            return;
+        const failed = frame.error === true;
+        const record = failed ? undefined : recordOf(frame);
+        if (!failed && record === undefined && root?.update(frame.props) === true) {
+            host.setAttribute("aria-busy", "false");
+            return;
+        }
+        // An error shows the error slot, never content the action that reloaded it may have changed.
+        const gone = root?.dispose(false);
+        root = undefined;
+        const fill = () => {
+            if (disposed || mine !== latest)
+                return;
+            host.removeAttribute("data-nifra-hole-error");
+            if (record !== undefined) {
+                host.setAttribute("data-nifra-filled", "");
+                root = componentRoot(host, record, !inPlace, showError);
+                return;
+            }
+            put(frame);
+            if (!failed && hydrate !== undefined)
+                root = hydrate(host, frame.props);
+        };
+        if (gone instanceof Promise)
+            gone.then(fill, fill);
+        else
+            fill();
+    };
+    const dispose = () => {
+        disposed = true;
+        release?.();
+        release = undefined;
+        host.ownerDocument.removeEventListener(PAGE_HIDE_EVENT, hidden);
+        host.ownerDocument.removeEventListener(PAGE_SHOW_EVENT, shown);
+        unsubscribe?.();
+        Promise.resolve(root?.dispose(true)).catch(() => { });
+        root = undefined;
+    };
+    return {
+        refill(fill) {
+            // A blocking render's settled fill is the server HTML the host already shows.
+            const inPlace = latest === 0 && root === undefined && initialHtml(fill) !== "";
+            const mine = ++latest;
+            host.setAttribute("aria-busy", "true");
+            settledFill(fill).then((frame) => {
+                if (!disposed && mine === latest)
+                    apply(frame, mine, inPlace);
+            }, () => {
+                if (!disposed && mine === latest)
+                    apply(ERROR_FRAME, mine, false);
+            });
+        },
+        dispose,
+        park() {
+            if (disposed || hiddenBy === undefined)
+                return false;
+            release ??= onPageRelease(hiddenBy, dispose);
+            return true;
+        },
+        unpark() {
+            release?.();
+            release = undefined;
+        },
+    };
+}
+//# sourceMappingURL=hole-runtime.js.map

package/dist/internal/hole-runtime.js.map

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

package/dist/internal/identity-epoch.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The server half of the identity epoch: a response that signs a visitor in or out also rotates the
+ * readable epoch cookie, so every tab drops the pages it kept alive for the previous visitor.
+ *
+ * A header-only hook reads each response's `Set-Cookie`: when an identity cookie's value differs from
+ * the request's, or the cookie is deleted, the response also sets a fresh epoch with the same lifetime,
+ * so the epoch expires with an idle session. A rolling session re-sending the same value with a new
+ * lifetime re-sends the epoch it holds with that lifetime, so the two keep expiring together.
+ */
+import { type CookieOptions } from "@nifrajs/core/server";
+/** `createWebApp`'s `keepAlive` option: which cookies say who is signed in. */
+export interface KeepAliveServerOptions {
+    /**
+     * Cookies whose change means a different visitor, on top of the session cookies of
+     * `@nifrajs/auth` and Auth.js under their default names and Better Auth's under any `cookiePrefix`.
+     * Name a custom session cookie here, or kept pages survive a sign-in or sign-out through it.
+     */
+    readonly identityCookies?: readonly string[];
+    /** `HttpOnly` cookies that say nothing about who is signed in; development stops asking about them. */
+    readonly ignoreCookies?: readonly string[];
+}
+/** The request and response a header hook sees. */
+interface HeaderView {
+    get(name: string): string | null;
+    append(name: string, value: string): void;
+}
+interface RequestView {
+    readonly url: string;
+    header(name: string): string | null | undefined;
+}
+/**
+ * The response hook `createWebApp` installs for an app with a `keepAlive` route. With `development`,
+ * it also says once per cookie when an `HttpOnly` cookie it does not know changes.
+ */
+export declare function identityEpochHook(options: KeepAliveServerOptions, development: boolean): (headers: HeaderView, request: RequestView) => void;
+/** The response-cookie surface {@link rotateIdentityEpoch} needs: nifra's handler context. */
+export interface IdentityEpochContext {
+    readonly request: Request;
+    readonly set: {
+        cookie(name: string, value: string, options?: CookieOptions): void;
+    };
+}
+/**
+ * Rotate the identity epoch from a flow that changes who is signed in without changing a cookie
+ * `createWebApp` watches - say, a session kept server-side under a cookie whose value stays the
+ * same. Every tab then drops the pages it kept alive for the previous visitor.
+ */
+export declare function rotateIdentityEpoch(c: IdentityEpochContext): void;
+export {};
+//# sourceMappingURL=identity-epoch.d.ts.map

package/dist/internal/identity-epoch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-epoch.d.ts","sourceRoot":"","sources":["../../src/internal/identity-epoch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,sBAAsB,CAAA;AAGvE,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,uGAAuG;IACvG,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C;AAED,mDAAmD;AACnD,UAAU,UAAU;IAClB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C;AACD,UAAU,WAAW;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAChD;AA4GD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,OAAO,GACnB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAkErD;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAA;CACrF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAYjE"}