@gusnips/vite 0.1.0

package/dist/node.js

@@ -0,0 +1,104 @@
+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;
+};
+/**
+ * The whole filesystem surface of this package: read the template, load the SSR bundle, write
+ * files.
+ *
+ * It is one file on purpose. Everything else here is string work that a test can run without a
+ * disk, and keeping the four impure functions together is what lets `head.ts`, `sitemap.ts`,
+ * `render.ts` and `og.ts` stay that way.
+ *
+ * The prerender LOOP is not here. Every donor's loop is different — one walks a registry once,
+ * another walks it per locale, a third writes three separate shells — and all of that is
+ * policy the product owns. What is identical in every one of them is these four functions and
+ * the gate in `assertRendered`, so those ship and the ~40-line loop stays in the app.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { EMPTY_ROOT } from "./head.js";
+import { describeOverflow } from "./og.js";
+/**
+ * The built `index.html`, and a refusal to bake one twice.
+ *
+ * `dist/index.html` is BOTH the template and the front page's destination, so a second run over
+ * a `dist/` the prerender has already touched would read a finished page as its blank shell and
+ * nest one render inside another. `vite build` empties `dist/` and normally makes this
+ * impossible; what does not is a restored build cache, or somebody running the script directly
+ * to debug it. Caught here, by name, rather than as a missing-root error three frames down.
+ */
+export async function loadTemplate(distDir) {
+    const file = join(distDir, "index.html");
+    const template = await readFile(file, "utf8");
+    if (!template.includes(EMPTY_ROOT))
+        throw new Error(`prerender: ${file} does not carry ${EMPTY_ROOT}. Either it is already a rendered page ` +
+            "— run `vite build` to regenerate the shell this reads — or the app's root element " +
+            "carries attributes, which the baker cannot fill.");
+    return template;
+}
+function exportsRenderer(mod) {
+    return (typeof mod === "object" &&
+        mod !== null &&
+        "renderPage" in mod &&
+        typeof mod.renderPage === "function");
+}
+/**
+ * The app compiled for the server, imported out of the BUILT bundle.
+ *
+ * The prerender is a script rather than a Vite plugin for exactly this reason: it needs the SSR
+ * bundle, and a plugin running in `closeBundle` is inside the build that would have to have
+ * produced it. So the entry is a path on disk, written by `vite build --ssr src/entry-server.tsx`,
+ * and nothing in the source tree references it.
+ */
+export async function loadRenderer(entryFile) {
+    const mod = await import(__rewriteRelativeImportExtension(pathToFileURL(entryFile).href));
+    if (!exportsRenderer(mod))
+        throw new Error(`prerender: ${entryFile} does not export renderPage — run \`vite build --ssr\` first`);
+    return mod.renderPage;
+}
+/** Write one file under `dist`, creating the folders a nested route needs. */
+export async function writeDist(distDir, file, contents) {
+    const target = join(distDir, file);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(target, contents, "utf8");
+}
+/**
+ * Walk a page registry and write one share card per page.
+ *
+ * Every card is laid out BEFORE any is written, and a single line that does not fit refuses the
+ * whole run. That order is the point: a card that cannot hold its copy is a product decision,
+ * not something to resolve with an ellipsis — an ellipsis makes every string "fit", so
+ * overgrown copy has no failing case and ships a card missing the end of the one line the card
+ * exists to carry. The reader who finds out is someone else's link unfurl.
+ *
+ * Overflow is collected rather than thrown on the first card, so one run names every bad one:
+ * copy lands per locale in batches, and a build that dies on the first of six sends its
+ * operator round the loop six times.
+ */
+export async function writeOgCards({ pages, outDir, file, card, check = false, }) {
+    const laid = [];
+    const overflows = [];
+    for (const page of pages) {
+        const { png, overflow } = await card(page);
+        if (overflow?.length)
+            overflows.push(...overflow);
+        laid.push({ file: file(page), png });
+    }
+    if (overflows.length > 0)
+        throw new Error(`og: ${String(overflows.length)} card(s) cannot hold their copy —\n\n` +
+            overflows.map((o) => `  · ${describeOverflow(o)}`).join("\n\n") +
+            "\n\n  Shorten the copy, or change the size ladder deliberately. Nothing was written.");
+    if (check)
+        return laid.map((entry) => entry.file);
+    await mkdir(outDir, { recursive: true });
+    for (const entry of laid)
+        await writeFile(join(outDir, entry.file), entry.png);
+    return laid.map((entry) => entry.file);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/og.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Fitting copy into a share card.
+ *
+ * The card's ART — the palette, the lockup, the size ladder — is the product, and it stays in
+ * the product. What ships here is the part two independent generators got wrong the same way:
+ * deciding what happens when a headline does not fit.
+ *
+ * Pure math, no `node:` import. The renderer that turns lines into SVG and SVG into a PNG is
+ * the caller's; `writeOgCards` in `node.ts` is the loop around it.
+ */
+/** The canvas every platform crops from. 1200×630 is the Open Graph size, not a brand choice. */
+export declare const OG_CANVAS: {
+    readonly width: 1200;
+    readonly height: 630;
+};
+/** Copy that did not fit its column. */
+export interface OgOverflow {
+    /** Which line of which card, so an operator can act on the report without grepping. */
+    label: string;
+    /** The string as given. */
+    text: string;
+    maxLines: number;
+    /** Characters per line at this size — the budget the text blew. */
+    maxChars: number;
+    size: number;
+}
+export interface FitOptions {
+    /** Pixel width of the column the text has to live in. */
+    width: number;
+    /** Font size, in pixels. */
+    size: number;
+    /** Hard cap on lines. */
+    maxLines: number;
+    /**
+     * Average glyph advance as a fraction of the font size.
+     *
+     * Character-budget estimation rather than real metrics: an SVG rasterizer gives no measuring
+     * API, and card copy is short enough that the estimate never drifts more than a word. Measure
+     * it off a rendered card and round UP — a budget that is too generous overflows the column,
+     * while one that is too mean only breaks a line early. Donor values: ~0.5 for a display face
+     * at headline sizes, ~0.46 for body copy.
+     */
+    advance: number;
+    /** Names this line in an overflow report. `"pricing headline"`, not `"line 1"`. */
+    label: string;
+}
+export interface FitResult {
+    lines: readonly string[];
+    /** Set when the copy did not fit. See {@link fitText} for why this is reported rather than
+     *  quietly truncated. */
+    overflow?: OgOverflow;
+}
+/**
+ * Greedy word wrap into a column, hard-capped at `maxLines`.
+ *
+ * Overflow is REPORTED, not truncated. The donor used to append `…`, which made wrapping a
+ * total function: every string "fitted", so copy that outgrew the column had no failing case to
+ * observe and shipped a card missing the end of the one line the card exists to carry. The
+ * reader who finds out is someone else's link unfurl. Cutting a headline to win an argument
+ * with a long sentence is a decision nobody reviewed; the size ladder is one somebody did.
+ *
+ * The truncated lines still come back, so a report can show what the card would have said, and
+ * so a `--check` run can lay every card out before refusing. One run names every bad card: copy
+ * lands per locale in batches, and a build that dies on the first of six sends its operator
+ * round the loop six times.
+ */
+export declare function fitText(text: string, options: FitOptions): FitResult;
+/** One overflow, as the line an operator reads in a failed build. */
+export declare function describeOverflow(overflow: OgOverflow): string;
+//# sourceMappingURL=og.d.ts.map

package/dist/og.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og.d.ts","sourceRoot":"","sources":["../src/og.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iGAAiG;AACjG,eAAO,MAAM,SAAS;;;CAAwC,CAAC;AAE/D,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;6BACyB;IACzB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,CAyBpE;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAM7D"}

package/dist/og.js

@@ -0,0 +1,60 @@
+/**
+ * Fitting copy into a share card.
+ *
+ * The card's ART — the palette, the lockup, the size ladder — is the product, and it stays in
+ * the product. What ships here is the part two independent generators got wrong the same way:
+ * deciding what happens when a headline does not fit.
+ *
+ * Pure math, no `node:` import. The renderer that turns lines into SVG and SVG into a PNG is
+ * the caller's; `writeOgCards` in `node.ts` is the loop around it.
+ */
+/** The canvas every platform crops from. 1200×630 is the Open Graph size, not a brand choice. */
+export const OG_CANVAS = { width: 1200, height: 630 };
+/**
+ * Greedy word wrap into a column, hard-capped at `maxLines`.
+ *
+ * Overflow is REPORTED, not truncated. The donor used to append `…`, which made wrapping a
+ * total function: every string "fitted", so copy that outgrew the column had no failing case to
+ * observe and shipped a card missing the end of the one line the card exists to carry. The
+ * reader who finds out is someone else's link unfurl. Cutting a headline to win an argument
+ * with a long sentence is a decision nobody reviewed; the size ladder is one somebody did.
+ *
+ * The truncated lines still come back, so a report can show what the card would have said, and
+ * so a `--check` run can lay every card out before refusing. One run names every bad card: copy
+ * lands per locale in batches, and a build that dies on the first of six sends its operator
+ * round the loop six times.
+ */
+export function fitText(text, options) {
+    const { width, size, maxLines, advance, label } = options;
+    const maxChars = Math.max(8, Math.floor(width / (size * advance)));
+    const flat = text.replace(/\s+/g, " ").trim();
+    const lines = [];
+    let line = "";
+    let overflowed = false;
+    for (const word of flat.split(" ").filter(Boolean)) {
+        const candidate = line ? `${line} ${word}` : word;
+        if (candidate.length <= maxChars || !line)
+            line = candidate;
+        else if (lines.length < maxLines - 1) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            overflowed = true;
+            line = `${candidate.slice(0, maxChars - 1).trimEnd()}…`;
+            break;
+        }
+    }
+    if (line)
+        lines.push(line);
+    return overflowed
+        ? { lines, overflow: { label, text: flat, maxLines, maxChars, size } }
+        : { lines };
+}
+/** One overflow, as the line an operator reads in a failed build. */
+export function describeOverflow(overflow) {
+    return (`${overflow.label} — ${String(overflow.maxLines)} lines of ~${String(overflow.maxChars)} ` +
+        `chars at ${String(overflow.size)}px, ${String(overflow.text.length)} chars given\n` +
+        `    ${JSON.stringify(overflow.text)}`);
+}
+//# sourceMappingURL=og.js.map

package/dist/og.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"og.js","sourceRoot":"","sources":["../src/og.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AA0C/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAmB;IACvD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,IAAI,SAAS,CAAC,MAAM,IAAI,QAAQ,IAAI,CAAC,IAAI;YAAE,IAAI,GAAG,SAAS,CAAC;aACvD,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;YACxD,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3B,OAAO,UAAU;QACf,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QACtE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,QAAoB;IACnD,OAAO,CACL,GAAG,QAAQ,CAAC,KAAK,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;QAC1F,YAAY,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB;QACpF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CACvC,CAAC;AACJ,CAAC"}

package/dist/preset.d.ts

@@ -0,0 +1,37 @@
+import type { Plugin, UserConfig } from "vite";
+/**
+ * Substitute `%NAME%` placeholders in `index.html`.
+ *
+ * `index.html` cannot import TypeScript, so a brand name or tagline written there is a literal
+ * that drifts from the one the app renders. This injects them from the module that owns them.
+ *
+ * Vite already replaces `%VITE_FOO%` from the environment, and that is the right tool when the
+ * value IS environment — an API URL, a build id. It is the wrong one for brand identity, which
+ * belongs in a typed module the app imports, not in a `.env` nobody reviews.
+ */
+export declare function htmlPlaceholders(values: Readonly<Record<string, string>>): Plugin;
+export interface WebPresetOptions {
+    /** The app folder — the one holding `index.html`. In a `vite.config.ts` that is
+     *  `import.meta.dirname`. `@` resolves to `<root>/src`. */
+    root: string;
+    /** Dev server port. Two apps in one repo must not share one, which is why it has no clever
+     *  default beyond Vite's own. */
+    port?: number;
+    /** Preview server port. Defaults to `port - 1000`, the pairing both donors landed on
+     *  (5173/4173, 5174/4174). */
+    previewPort?: number;
+    /** `{ BRAND_NAME: "Acme" }` replaces `%BRAND_NAME%` in `index.html`. */
+    placeholders?: Readonly<Record<string, string>>;
+    /**
+     * The workspace scope to bundle into the SSR build, as in `"@acme"`.
+     *
+     * INSURANCE, not a fix. Measured: Vite already bundles linked workspace dependencies in an
+     * SSR build — one donor runs without this declaration and its SSR output has zero bare
+     * imports. It is here because workspace packages are consumed as TypeScript SOURCE through
+     * subpath exports, and leaving them external would hand the runtime `.ts` files with
+     * Vite-only semantics in them (aliases, `?raw`, `define`) if that behaviour ever changed.
+     */
+    ssrScope?: string;
+}
+export declare function webPreset({ root, port, previewPort, placeholders, ssrScope, }: WebPresetOptions): UserConfig;
+//# sourceMappingURL=preset.d.ts.map

package/dist/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAUjF;AAED,MAAM,WAAW,gBAAgB;IAC/B;+DAC2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb;qCACiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;kCAC8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,EAAE,gBAAgB,GAAG,UAAU,CAa/B"}

package/dist/preset.js

@@ -0,0 +1,43 @@
+/**
+ * The `vite.config.ts` every app in this stack was writing by hand.
+ *
+ * Its own entry point (`@gusnips/vite/preset`) rather than the barrel, because it imports the
+ * React and Tailwind plugins: a prerender script that only wants `bakeHead` would otherwise
+ * load a build toolchain it never uses. Same reason the four packages are split at all.
+ */
+import tailwindcss from "@tailwindcss/vite";
+import react from "@vitejs/plugin-react";
+import path from "node:path";
+/**
+ * Substitute `%NAME%` placeholders in `index.html`.
+ *
+ * `index.html` cannot import TypeScript, so a brand name or tagline written there is a literal
+ * that drifts from the one the app renders. This injects them from the module that owns them.
+ *
+ * Vite already replaces `%VITE_FOO%` from the environment, and that is the right tool when the
+ * value IS environment — an API URL, a build id. It is the wrong one for brand identity, which
+ * belongs in a typed module the app imports, not in a `.env` nobody reviews.
+ */
+export function htmlPlaceholders(values) {
+    return {
+        name: "frontkit:html-placeholders",
+        transformIndexHtml(html) {
+            return Object.entries(values).reduce((out, [name, value]) => out.replaceAll(`%${name}%`, value), html);
+        },
+    };
+}
+export function webPreset({ root, port, previewPort, placeholders, ssrScope, }) {
+    const preview = previewPort ?? (port === undefined ? undefined : port - 1000);
+    return {
+        plugins: [react(), tailwindcss(), ...(placeholders ? [htmlPlaceholders(placeholders)] : [])],
+        resolve: {
+            alias: { "@": path.resolve(root, "src") },
+        },
+        ...(ssrScope && {
+            ssr: { noExternal: [new RegExp(`^${ssrScope.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/`)] },
+        }),
+        ...(port !== undefined && { server: { port } }),
+        ...(preview !== undefined && { preview: { port: preview } }),
+    };
+}
+//# sourceMappingURL=preset.js.map

package/dist/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,sBAAsB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwC;IACvE,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,kBAAkB,CAAC,IAAY;YAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAClC,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,KAAK,CAAC,EAC1D,IAAI,CACL,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AA0BD,MAAM,UAAU,SAAS,CAAC,EACxB,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,QAAQ,GACS;IACjB,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC9E,OAAO;QACL,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;SAC1C;QACD,GAAG,CAAC,QAAQ,IAAI;YACd,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;SAC1F,CAAC;QACF,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,36 @@
+/**
+ * One page, as the markup that goes inside `<div id="root">`.
+ *
+ * This is the build-time half of `main.tsx`, and the app's `entry-server.tsx` is expected to
+ * be four lines around it: the same `<App />` and the same route table the browser runs, with
+ * a `StaticRouter` in place of the history the build does not have. `main.tsx` is deliberately
+ * NOT reused — it reads `window.location`, registers listeners and starts analytics at module
+ * scope, none of which mean anything here.
+ *
+ * No `node:` import: this file is bundled into the SSR build by Vite, and it is React's own
+ * static renderer plus two string rules.
+ */
+import type { ReactNode } from "react";
+/**
+ * Render a tree to markup with `prerender` from `react-dom/static`.
+ *
+ * **Never `renderToString`.** With `lazy()` routes behind a `<Suspense fallback={<Spinner />}>`,
+ * `renderToString` renders the FALLBACK — it would write a loading screen into every file and
+ * pass every gate that only asks whether the root has children. `prerender` waits for the tree
+ * to settle, which is also why this is async and why the whole renderer contract is.
+ *
+ * Two more halves of the same lesson are here too: `onError` is captured and rethrown, so a
+ * render failure fails the build rather than shipping a partial page; and an empty result is
+ * refused, because a router whose basename does not match its location answers `""` with no
+ * error and no warning.
+ */
+export declare function renderTree(tree: ReactNode): Promise<string>;
+/**
+ * What an SSR entry exports, and what {@link loadRenderer} looks for.
+ *
+ * `context` is opaque on purpose. A multi-locale app builds its i18n instance per call — three
+ * languages render in one process and a shared singleton would have them racing for one `lng` —
+ * while a single-locale app ignores the argument and keeps its singleton.
+ */
+export type PageRenderer<Context = unknown> = (route: string, context?: Context) => Promise<string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAuBvC;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBjE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/render.js

@@ -0,0 +1,50 @@
+// `static.browser`, not `static`. Three donor entry-servers converged on it independently, and
+// the reason is resolution rather than behaviour: `react-dom/static` is condition-resolved into
+// four different files (node, edge-light, workerd, browser) and an SSR bundler picks the
+// condition, not us. `.browser` is one implementation everywhere. Measured, `prerender` hands
+// back a Web `ReadableStream` from every one of them — which is what `new Response()` below
+// wants — so this pins a resolution, it does not fix a stream type.
+import { prerender } from "react-dom/static.browser";
+/**
+ * React 19 hoists `<title>`, `<meta>` and `<link>` rendered anywhere in the tree into the
+ * document head — and on the server it does that by emitting them at the FRONT of the stream,
+ * for a caller that is expected to be assembling a whole document. We are not: we are filling
+ * one `<div>`, so an in-tree SEO component's tags would land inside the body, where that markup
+ * is invalid and duplicates the head the prerender bakes.
+ *
+ * They are dropped rather than lifted, because the page registry is the one source of that head
+ * by contract and the baked copy is the half that exists before React runs. `<style>` and
+ * `<script>` are deliberately NOT in this pattern: if one appears here it belongs to the page
+ * and must survive.
+ */
+const HOISTED_HEAD = /^(?:<title>[^<]*<\/title>|<meta\b[^>]*\/?>|<link\b[^>]*\/?>|\s+)+/;
+/**
+ * Render a tree to markup with `prerender` from `react-dom/static`.
+ *
+ * **Never `renderToString`.** With `lazy()` routes behind a `<Suspense fallback={<Spinner />}>`,
+ * `renderToString` renders the FALLBACK — it would write a loading screen into every file and
+ * pass every gate that only asks whether the root has children. `prerender` waits for the tree
+ * to settle, which is also why this is async and why the whole renderer contract is.
+ *
+ * Two more halves of the same lesson are here too: `onError` is captured and rethrown, so a
+ * render failure fails the build rather than shipping a partial page; and an empty result is
+ * refused, because a router whose basename does not match its location answers `""` with no
+ * error and no warning.
+ */
+export async function renderTree(tree) {
+    let failure;
+    const { prelude } = await prerender(tree, {
+        onError(error) {
+            failure ??= error;
+        },
+    });
+    const html = await new Response(prelude).text();
+    if (failure !== undefined)
+        throw failure;
+    const markup = html.replace(HOISTED_HEAD, "");
+    if (markup.trim() === "")
+        throw new Error("renderTree: the tree rendered to nothing — usually a router whose location or basename " +
+            "matches no route, which React reports as an empty string rather than an error");
+    return markup;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAaA,+FAA+F;AAC/F,gGAAgG;AAChG,yFAAyF;AACzF,8FAA8F;AAC9F,4FAA4F;AAC5F,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAG,mEAAmE,CAAC;AAEzF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAe;IAC9C,IAAI,OAAgB,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE;QACxC,OAAO,CAAC,KAAc;YACpB,OAAO,KAAK,KAAK,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QACtB,MAAM,IAAI,KAAK,CACb,yFAAyF;YACvF,+EAA+E,CAClF,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/sitemap.d.ts

@@ -0,0 +1,82 @@
+import type { Alternate } from "./head.ts";
+/**
+ * Where a rendered page lands.
+ *
+ * FLAT (`pricing.html`), not directory-style (`pricing/index.html`). Cloudflare Pages serves
+ * the directory form at `/pricing/` and answers `/pricing` with a 308 to it — so every address
+ * the app advertises in its canonical and its sitemap would be a redirect rather than a page.
+ * A flat file is served at `/pricing` AND `/pricing/`, 200 either way.
+ *
+ * A nested route keeps its folders: `/guides/errors` → `guides/errors.html`.
+ */
+export declare function pageFile(routePath: string): string;
+/**
+ * The origin every canonical, share URL and sitemap entry is built on.
+ *
+ * The trailing slash is dropped because the caller appends a path that starts with one, and
+ * `https://example.com//pricing` is a different address to every crawler that reads it. The
+ * scheme is demanded because the value normally comes from an env var: `VITE_SITE_URL=acme.com`
+ * looks right in a `.env`, and it silently turns every canonical on the site into a relative
+ * URL. That is a bad build, not a bad page, so it fails here.
+ */
+export declare function siteOrigin(url: string): string;
+/**
+ * The three things about a public page that do not translate: where it is, how often it
+ * changes, and how it ranks against its siblings.
+ *
+ * A product's registry extends this with its own copy fields — one donor names an i18n key per
+ * page, another keys its locale catalogs by `pageSlug` and stores no copy here at all. Where
+ * the copy lives is the product's call. These three are what a sitemap needs from every one of
+ * them, and the registry is the single source the prerender, the sitemap and the share cards
+ * all walk, so a page can never be in one and missing from another.
+ */
+export interface PublicPage {
+    path: string;
+    /** Relative crawl priority, 0.0–1.0. */
+    priority: number;
+    changeFrequency: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+}
+/** URL slug for a page path (`/pricing` → `pricing`, `/` → `home`), used to name its share
+ *  card and to key a locale catalog's copy. */
+export declare function pageSlug(path: string): string;
+/** Public path of a page's generated share card (`/pricing` → `/og/pricing.png`). */
+export declare function ogImagePath(path: string): string;
+export interface SitemapEntry {
+    loc: string;
+    changefreq: string;
+    /** Already formatted — an app ranks its own pages, and that rule does not belong here. */
+    priority: string;
+    /** `YYYY-MM-DD`. The one hint in a sitemap Google actually reads. One date for the whole
+     *  build is the honest answer: these pages ship together. */
+    lastmod?: string;
+    /** The same reciprocal set the page's `<head>` carries. Stated twice on purpose: a crawler
+     *  that reaches an address through the sitemap has not read the head yet. */
+    alternates?: readonly Alternate[];
+}
+/** `sitemap.xml`, from whichever registry the caller walks. */
+export declare function sitemapXml(entries: readonly SitemapEntry[]): string;
+/**
+ * `sitemap.xml` for a single-language site, straight from the registry — the common case, and
+ * the reason a registry exists: the sitemap can never drift from the routes the app serves.
+ *
+ * A localized site walks its own locales and calls {@link sitemapXml}, because only it knows
+ * how an address carries a language.
+ */
+export declare function sitemapFor(origin: string, pages: readonly PublicPage[], lastmod?: string): string;
+export interface RobotsOptions {
+    /** The origin this file is served from. Every sitemap path is resolved against it, so the
+     *  file can never advertise a host it is not on — a mistake one donor is still shipping,
+     *  where a static `robots.txt` and the build's fallback name different domains. */
+    origin: string;
+    /** Every sitemap on this ORIGIN, as paths (`/sitemap.xml`, `/docs/sitemap.xml`).
+     *
+     *  A crawler reads only the robots.txt at the origin root. An app served from a
+     *  subdirectory therefore cannot ship its own — the one file at the root has to list its
+     *  sitemap too, or nothing ever finds it. */
+    sitemaps: readonly string[];
+    /** Paths to keep out of every index. A page nobody should be able to find by searching —
+     *  a per-request status page, an unsubscribe link — belongs here AND in `noindex`. */
+    disallow?: readonly string[];
+}
+export declare function robotsTxt({ origin, sitemaps, disallow }: RobotsOptions): string;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC5F;AAED;+CAC+C;AAC/C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;iFAC6E;IAC7E,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACnC;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAyBnE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjG;AAED,MAAM,WAAW,aAAa;IAC5B;;uFAEmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf;;;;iDAI6C;IAC7C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;0FACsF;IACtF,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAa,EAAE,EAAE,aAAa,GAAG,MAAM,CAQpF"}

package/dist/sitemap.js

@@ -0,0 +1,91 @@
+/**
+ * The three build outputs that are addresses rather than pages: where a rendered page lands,
+ * `sitemap.xml`, and `robots.txt`.
+ *
+ * Pure string work, like `head.ts` — no `node:` import, so every rule here is unit-testable.
+ */
+import { escapeAttr } from "./escape.js";
+/**
+ * Where a rendered page lands.
+ *
+ * FLAT (`pricing.html`), not directory-style (`pricing/index.html`). Cloudflare Pages serves
+ * the directory form at `/pricing/` and answers `/pricing` with a 308 to it — so every address
+ * the app advertises in its canonical and its sitemap would be a redirect rather than a page.
+ * A flat file is served at `/pricing` AND `/pricing/`, 200 either way.
+ *
+ * A nested route keeps its folders: `/guides/errors` → `guides/errors.html`.
+ */
+export function pageFile(routePath) {
+    const trimmed = routePath.replace(/^\/+/, "").replace(/\/+$/, "");
+    return trimmed === "" ? "index.html" : `${trimmed}.html`;
+}
+/**
+ * The origin every canonical, share URL and sitemap entry is built on.
+ *
+ * The trailing slash is dropped because the caller appends a path that starts with one, and
+ * `https://example.com//pricing` is a different address to every crawler that reads it. The
+ * scheme is demanded because the value normally comes from an env var: `VITE_SITE_URL=acme.com`
+ * looks right in a `.env`, and it silently turns every canonical on the site into a relative
+ * URL. That is a bad build, not a bad page, so it fails here.
+ */
+export function siteOrigin(url) {
+    if (!/^https?:\/\/[^/]+/.test(url))
+        throw new Error(`prerender: "${url}" is not an absolute origin — it needs a scheme, as in https://example.com`);
+    return url.replace(/\/+$/, "");
+}
+/** URL slug for a page path (`/pricing` → `pricing`, `/` → `home`), used to name its share
+ *  card and to key a locale catalog's copy. */
+export function pageSlug(path) {
+    const trimmed = path.replace(/^\/+|\/+$/g, "");
+    return trimmed === "" ? "home" : trimmed.replaceAll("/", "-");
+}
+/** Public path of a page's generated share card (`/pricing` → `/og/pricing.png`). */
+export function ogImagePath(path) {
+    return `/og/${pageSlug(path)}.png`;
+}
+/** `sitemap.xml`, from whichever registry the caller walks. */
+export function sitemapXml(entries) {
+    const urls = entries
+        .map((entry) => {
+        const links = (entry.alternates ?? []).map((alt) => `    <xhtml:link rel="alternate" hreflang="${escapeAttr(alt.hreflang)}" href="${escapeAttr(alt.href)}" />\n`);
+        return (`  <url>\n` +
+            // Escaped like every other URL here: a query string with an `&` in it is not valid XML,
+            // and an invalid sitemap is rejected whole rather than per entry.
+            `    <loc>${escapeAttr(entry.loc)}</loc>\n` +
+            links.join("") +
+            (entry.lastmod ? `    <lastmod>${entry.lastmod}</lastmod>\n` : "") +
+            `    <changefreq>${entry.changefreq}</changefreq>\n` +
+            `    <priority>${entry.priority}</priority>\n` +
+            `  </url>`);
+    })
+        .join("\n");
+    return (`<?xml version="1.0" encoding="UTF-8"?>\n` +
+        `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"` +
+        ` xmlns:xhtml="http://www.w3.org/1999/xhtml">\n${urls}\n</urlset>\n`);
+}
+/**
+ * `sitemap.xml` for a single-language site, straight from the registry — the common case, and
+ * the reason a registry exists: the sitemap can never drift from the routes the app serves.
+ *
+ * A localized site walks its own locales and calls {@link sitemapXml}, because only it knows
+ * how an address carries a language.
+ */
+export function sitemapFor(origin, pages, lastmod) {
+    const root = siteOrigin(origin);
+    return sitemapXml(pages.map((page) => ({
+        loc: `${root}${page.path}`,
+        changefreq: page.changeFrequency,
+        // One decimal, always. `<priority>` is a number a crawler compares, and floating-point
+        // noise from a computed rank would print as `0.7000000000000001`.
+        priority: page.priority.toFixed(1),
+        ...(lastmod !== undefined && { lastmod }),
+    })));
+}
+export function robotsTxt({ origin, sitemaps, disallow = [] }) {
+    const root = siteOrigin(origin);
+    return (`User-agent: *\nAllow: /\n` +
+        disallow.map((path) => `Disallow: ${path}\n`).join("") +
+        `\n` +
+        sitemaps.map((path) => `Sitemap: ${root}${path}\n`).join(""));
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,eAAe,GAAG,4EAA4E,CAC/F,CAAC;IACJ,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAmBD;+CAC+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;AACrC,CAAC;AAeD,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,MAAM,IAAI,GAAG,OAAO;SACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CACxC,CAAC,GAAG,EAAE,EAAE,CACN,6CAA6C,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAC/G,CAAC;QACF,OAAO,CACL,WAAW;YACX,wFAAwF;YACxF,kEAAkE;YAClE,YAAY,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU;YAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,mBAAmB,KAAK,CAAC,UAAU,iBAAiB;YACpD,iBAAiB,KAAK,CAAC,QAAQ,eAAe;YAC9C,UAAU,CACX,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,CACL,0CAA0C;QAC1C,6DAA6D;QAC7D,iDAAiD,IAAI,eAAe,CACrE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAA4B,EAAE,OAAgB;IACvF,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,UAAU,CACf,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE;QAC1B,UAAU,EAAE,IAAI,CAAC,eAAe;QAChC,uFAAuF;QACvF,kEAAkE;QAClE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAClC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;KAC1C,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE,EAAiB;IAC1E,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CACL,2BAA2B;QAC3B,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,IAAI;QACJ,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAC7D,CAAC;AACJ,CAAC"}