npm - @gusnips/vite - Versions diffs - 0.1.0 - Mend

@gusnips/vite 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (48) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Gustavo Salomé
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,123 @@
+# @gusnips/vite
+Turn a Vite + React SPA's public routes into real HTML files at build time — a real `<head>`, a
+real body, one file per page.
+```bash
+bun add -d @gusnips/vite
+```
+```ts
+import { pageFile } from "@gusnips/vite";
+pageFile("/pricing"); // → "pricing.html"
+```
+## Why bother
+A Vite SPA ships one `index.html` and draws everything else with JavaScript. Nothing that reads a
+link for a living runs that bundle — not a search crawler, not an LLM, not the thing that draws
+the preview card when someone pastes your link in a chat. A shipped `<div id="root"></div>` is a
+page that can be listed and never quoted.
+So the build renders each public route to its own file. This is the part every app doing that
+ends up writing.
+## Baking a page
+```ts
+import { bakeHead } from "@gusnips/vite";
+const html = bakeHead(template, {
+  title: "Pricing — Example",
+  description: "What it costs.",
+  canonical: "https://example.com/pricing",
+  body: { route: "/pricing", html: rendered },
+});
+```
+`bakeHead` rewrites the title, the description, the canonical, the Open Graph and Twitter tags,
+`<html lang>`, the `hreflang` set, and injects the rendered markup into `<div id="root">`.
+Four rules in there are load-bearing:
+- **`canonical: null` strips the tag, and takes `og:image` and `og:url` with it.** For the 404
+  shell, which is served for every address that does not exist. Blanking is not stripping: an
+  empty canonical is a claim about `""`, and an empty `og:url` is a card pointing at your front
+  page. The image is the half people miss — one codebase set it before it branched on the shell,
+  so its `404.html` advertised a card at `/og/__not-found__.png`, a file that has never existed.
+  Every share of a dead link unfurled broken, and nothing in a browser showed it.
+- **`og:locale` is not optional on a non-English page.** Leave it out and the spec does not
+  default it to "unknown" — it defaults to `en_US`. A Portuguese page with a Portuguese
+  `og:title` then tells every share crawler the card is English. `ogLocale("pt-BR")` gives you
+  the underscore spelling it actually wants.
+- **`body` carries the route, not just the markup.** A static host answers every address it does
+  not publish with the nearest `404.html`, and that file has the not-found page rendered _into_
+  it. So "does the root have children" is the wrong question: a route served from the shell finds
+  a full root, hydrates, and React reconciles two different pages. It recovers by throwing the
+  tree away and logging — a page that works, and a bug nobody sees. The marker is what the
+  browser entry compares against before it decides.
+- **`alternates` must be reciprocal.** A crawler ignores the whole set unless every address in it
+  points back at the others, which is why you pass the full list to every page rather than "the
+  other two".
+## Rendering
+```ts
+import { renderTree } from "@gusnips/vite/render";
+```
+Behind its own subpath, because it is the one thing here that loads React. A repo that only wants
+a sitemap installs no renderer.
+It uses `prerender` from `react-dom/static`, never `renderToString`. With `lazy()` routes behind
+a `<Suspense>`, **`renderToString` renders the fallback** — it will write a loading screen into
+every file and pass any gate that only asks whether the root has children. It also answers `""`
+for a basename mismatch with no error and no warning, so `assertRendered` checks every route for
+non-empty output. And React 19 hoists in-tree `<title>` and `<meta>` to the front of the server
+stream, which lands them inside your body when you are filling one `<div>` rather than assembling
+a document — so those get stripped, and a render error is rethrown so a broken page fails the
+build instead of shipping.
+## Flat files
+That `pageFile` at the top writes `pricing.html`, not `pricing/index.html`. Nested routes keep
+their folders — `/guides/errors` → `guides/errors.html`.
+The directory form looks tidier and is a trap. Cloudflare Pages serves it at `/pricing/` and
+answers `/pricing` with a 308, so every address your app advertises in its own canonical and its
+own sitemap would be a redirect rather than a page. A flat file answers both, 200 either way.
+## Sitemap, robots, OG cards
+`sitemapFor(origin, pages)` walks your page registry; `robotsTxt({ origin, sitemaps })` generates
+the file, listing every sitemap in one, because a crawler only reads the one at the origin root —
+a subdirectory app cannot ship its own.
+`sitemapXml` takes `priority` **pre-formatted, as a string**. Ranking pages is a decision that
+belongs to whoever walks the registry: one codebase reads a field off its own registry, another
+gives the front door 1.0 and every guide 0.8 flat, because ranking one guide above another would
+be a guess about a reader.
+`writeOgCards` walks the registry and calls a renderer you supply, and `fitText` does the
+text-fitting maths. When copy does not fit, it **records the overflow and refuses to write**
+rather than appending an ellipsis — an ellipsis makes every string "fit", so copy that outgrew
+its column has no failing case and ships.
+`loadTemplate` refuses a `dist/index.html` that is already a rendered page. `dist/index.html` is
+both the file every page is baked _from_ and the home page's own output, so a second pass over a
+written `dist/` reads a finished page as its blank and nests one render inside another. `vite
+build` empties `dist/` and normally makes that impossible — a restored build cache and a hand-run
+of the script both route around it.
+## The vite preset
+```ts
+import { webPreset } from "@gusnips/vite/preset";
+export default defineConfig(webPreset({/* … */}));
+```
+Its own subpath too, since it pulls in the React and Tailwind plugins.
+MIT · part of [frontkit](https://github.com/gusnips/frontkit)

package/dist/escape.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+/** Escaping shared by the head baker and the sitemap writer. Its own file so neither has to
+ *  import the other, and so both stay free of every dependency this package has. */
+/** `&` first, or the ampersands introduced by the later rules get escaped twice. */
+export declare const escapeAttr: (s: string) => string;
+export declare const escapeRegex: (s: string) => string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/escape.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA;oFACoF;AAEpF,oFAAoF;AACpF,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,MACuD,CAAC;AAE/F,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,KAAG,MAAkD,CAAC"}

package/dist/escape.js ADDED Viewed

@@ -0,0 +1,6 @@
+/** Escaping shared by the head baker and the sitemap writer. Its own file so neither has to
+ *  import the other, and so both stay free of every dependency this package has. */
+/** `&` first, or the ampersands introduced by the later rules get escaped twice. */
+export const escapeAttr = (s) => s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+export const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+//# sourceMappingURL=escape.js.map

package/dist/escape.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"escape.js","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA;oFACoF;AAEpF,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAC9C,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC"}

package/dist/head.d.ts ADDED Viewed

@@ -0,0 +1,110 @@
+/** The empty root a template must carry — `bakeHead` fills it, and refuses a filled one. */
+export declare const EMPTY_ROOT = "<div id=\"root\"></div>";
+/** One `<link rel="alternate" hreflang>` — this page's address in another language. */
+export interface Alternate {
+    /** A BCP-47 tag, or `x-default` for the address a crawler should show when it has no reason
+     *  to prefer one. */
+    hreflang: string;
+    href: string;
+}
+export interface HeadTags {
+    /** `<title>`, and the share title unless overridden. */
+    title: string;
+    /** `name="description"`, and the share description unless overridden. */
+    description: string;
+    /**
+     * The page's own URL, for `<link rel="canonical">` and the share tags.
+     *
+     * `null` means this page has no canonical URL and must not claim one — the 404 shell, which
+     * is served for every address that does not exist and would otherwise tell a crawler that
+     * all of them are the front page.
+     */
+    canonical: string | null;
+    ogTitle?: string;
+    ogDescription?: string;
+    /** Absolute URL of the share card. Omit where the template carries no `og:image` tag at all
+     *  — setting one there is a build error, by design. */
+    image?: string;
+    /** Markup inserted before `</head>` — structured data, and nothing else so far. Emitted here
+     *  because its only reader is a crawler. */
+    headExtra?: string;
+    /** Keep this page out of every index. Pairs with `canonical: null`. */
+    noindex?: boolean;
+    /**
+     * `<html lang>`, when this page is not in the template's language, and the `og:locale` that
+     * goes with it.
+     *
+     * A crawler and a screen reader both read `lang`, and neither runs the bundle that would
+     * otherwise set it — so a Portuguese file whose `<html>` still says `en` is announced in the
+     * wrong voice and indexed as the wrong language.
+     */
+    lang?: string;
+    /**
+     * Every language this page exists in, INCLUDING this one, plus `x-default`.
+     *
+     * Reciprocal by contract: a crawler ignores the whole set unless each address in it points
+     * back at the others, which is why the caller passes the full list to every page rather than
+     * "the other two".
+     */
+    alternates?: readonly Alternate[];
+    /**
+     * The rendered page, injected into `<div id="root">`, and the route it is a render OF.
+     *
+     * The head alone was never enough. A shipped `<div id="root"></div>` is a page whose entire
+     * content is a description tag — it can be listed, and it can never be read, quoted or
+     * answered from.
+     *
+     * The two travel together because markup alone is not enough to hydrate against. A static
+     * host answers every unpublished address with the nearest `404.html`, and that file has a
+     * rendered body in it — so a route served from the shell would find a full root and hydrate
+     * the not-found page into a page that is not it. The marker is what the browser entry
+     * compares its own route against before deciding to hydrate or to mount fresh.
+     */
+    body?: {
+        route: string;
+        html: string;
+    };
+}
+/**
+ * A BCP-47 tag in Open Graph's spelling: underscore, and a TERRITORY it will not infer.
+ *
+ * `og:locale` wants `language_TERRITORY` and quietly ignores anything else, which is the same
+ * outcome as omitting it — the `en_US` default. So a Portuguese page with a Portuguese
+ * `og:title` and no `og:locale` tells every share crawler the card is English. `pt-BR` already
+ * carries its territory; `en` and `es` do not, so one is chosen here rather than left to a
+ * crawler. `es_ES` is not a claim that the copy is peninsular Spanish — it is the most widely
+ * recognised Spanish value, and the tag's job is to be understood, not precise about dialect.
+ */
+export declare function ogLocale(tag: string): string;
+/**
+ * One page's `<head>` and body, written into the built template.
+ *
+ * Every tag is SET rather than appended, and `setMeta` throws on a tag the template does not
+ * carry — so the failure mode of editing `index.html` is a red build, never a page quietly
+ * shipping somebody else's description.
+ */
+export declare function bakeHead(template: string, tags: HeadTags): string;
+export interface RenderedChecks {
+    /** The BCP-47 tag this file must be marked with — the same `lang` passed to `bakeHead`. */
+    lang?: string;
+    /** Bytes the page must have gained over the template before it counts as rendered.
+     *  500 is the floor both donor builds ran with. */
+    minGrowth?: number;
+}
+/**
+ * What every written file must be true of before the build is allowed to pass.
+ *
+ * The regression this exists for is a root that renders to nothing. A router whose location
+ * does not match its routes yields empty markup with no error and no warning — it looks fine
+ * in every browser and is invisible to everything that reads a link. Checking the bytes we
+ * actually wrote is the only thing that catches it, and it needs no browser, so it gates the
+ * BUILD rather than sitting in a test suite.
+ *
+ * The loading-screen check is the half a size floor misses. With `lazy()` routes behind one
+ * `<Suspense fallback={<Spinner />}>`, a render that resolves nothing still produces a
+ * plausible body: one donor shipped a 1,174-byte spinner with a perfect title and an element
+ * inside the root. A file whose body is a spinner is WORSE than an empty one, because every
+ * cheap check passes.
+ */
+export declare function assertRendered(file: string, html: string, template: string, checks?: RenderedChecks): void;
+//# sourceMappingURL=head.d.ts.map

package/dist/head.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAiBA,4FAA4F;AAC5F,eAAO,MAAM,UAAU,4BAA0B,CAAC;AA+BlD,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB;yBACqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;2DACuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;gDAC4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAqFjE;AAED,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAmB,GAC1B,IAAI,CAqCN"}

package/dist/head.js ADDED Viewed

@@ -0,0 +1,183 @@
+/**
+ * The head a crawler sees, baked at build time.
+ *
+ * A Vite SPA ships one `index.html` and draws everything else with JavaScript. Nothing that
+ * reads a link for a living runs that bundle — not Google's first pass, not Bing, not an LLM
+ * crawler, not whatever draws the preview card in Slack. So the build rewrites the template
+ * once per route and writes a real file per page, with a real `<head>` AND a real body.
+ *
+ * Pure string work, on purpose: no `node:` import anywhere in this file, so every branch is
+ * unit-testable without a filesystem. The reading and writing lives in `node.ts`.
+ */
+// The `/contract` subpath, not the barrel: the barrel reaches `react-dom/client` through
+// `hydrate.ts`, and a build script asking for one string should not pull the browser renderer
+// into a Node process. That file imports nothing at all.
+import { PRERENDERED_ROUTE_ATTR } from "@gusnips/react/contract";
+import { escapeAttr, escapeRegex } from "./escape.js";
+/** The empty root a template must carry — `bakeHead` fills it, and refuses a filled one. */
+export const EMPTY_ROOT = '<div id="root"></div>';
+/** `[^>]*` on both sides tolerates the attributes being split across lines, as Vite emits them. */
+const metaRe = (selector) => new RegExp(`(<meta[^>]*${escapeRegex(selector)}[^>]*content=")[^"]*(")`);
+/**
+ * Replace the `content` of one `<meta …>`. Throws when the tag is missing, so an edit to
+ * `index.html` fails the build instead of silently shipping the front door's description to
+ * every crawler.
+ */
+function setMeta(html, selector, value) {
+    const re = metaRe(selector);
+    if (!re.test(html))
+        throw new Error(`prerender: <meta ${selector}> not found in index.html`);
+    return html.replace(re, `$1${escapeAttr(value)}$2`);
+}
+/**
+ * The same, for a tag a template is allowed not to carry.
+ *
+ * Only the `twitter:` pair and `name="title"` get this. X reads the `og:` tags when the
+ * `twitter:` ones are absent, and no crawler reads `name="title"` at all — so a template that
+ * omits them is correct, and demanding them would break an app that never had them. A template
+ * that DOES carry one and gets a stale value is still a bug, which is why they are written
+ * rather than ignored. Everything a crawler actually depends on goes through `setMeta`.
+ */
+function setMetaIfPresent(html, selector, value) {
+    const re = metaRe(selector);
+    return re.test(html) ? html.replace(re, `$1${escapeAttr(value)}$2`) : html;
+}
+/**
+ * A BCP-47 tag in Open Graph's spelling: underscore, and a TERRITORY it will not infer.
+ *
+ * `og:locale` wants `language_TERRITORY` and quietly ignores anything else, which is the same
+ * outcome as omitting it — the `en_US` default. So a Portuguese page with a Portuguese
+ * `og:title` and no `og:locale` tells every share crawler the card is English. `pt-BR` already
+ * carries its territory; `en` and `es` do not, so one is chosen here rather than left to a
+ * crawler. `es_ES` is not a claim that the copy is peninsular Spanish — it is the most widely
+ * recognised Spanish value, and the tag's job is to be understood, not precise about dialect.
+ */
+export function ogLocale(tag) {
+    const TERRITORY = { en: "en_US", es: "es_ES" };
+    return TERRITORY[tag] ?? tag.replace("-", "_");
+}
+/**
+ * One page's `<head>` and body, written into the built template.
+ *
+ * Every tag is SET rather than appended, and `setMeta` throws on a tag the template does not
+ * carry — so the failure mode of editing `index.html` is a red build, never a page quietly
+ * shipping somebody else's description.
+ */
+export function bakeHead(template, tags) {
+    const shareTitle = tags.ogTitle ?? tags.title;
+    const shareDescription = tags.ogDescription ?? tags.description;
+    let html = template.replace(/<title>[^<]*<\/title>/, `<title>${escapeAttr(tags.title)}</title>`);
+    html = setMeta(html, 'name="description"', tags.description);
+    html = setMeta(html, 'property="og:title"', shareTitle);
+    html = setMeta(html, 'property="og:description"', shareDescription);
+    html = setMetaIfPresent(html, 'name="title"', tags.title);
+    html = setMetaIfPresent(html, 'property="twitter:title"', shareTitle);
+    html = setMetaIfPresent(html, 'property="twitter:description"', shareDescription);
+    if (tags.image !== undefined) {
+        html = setMeta(html, 'property="og:image"', tags.image);
+        html = setMetaIfPresent(html, 'property="twitter:image"', tags.image);
+    }
+    if (tags.canonical === null) {
+        // Strip rather than blank: an empty canonical is a claim about "" and an empty og:url is a
+        // share card pointing at the origin root. The image is left alone — it is a picture, not a
+        // claim about this address, and a dead link that still unfurls the brand card is fine.
+        html = html
+            .replace(/\s*<link rel="canonical"[^>]*>/, "")
+            .replace(/\s*<meta property="(?:og|twitter):url"[^>]*>/g, "");
+    }
+    else {
+        html = setMeta(html, 'property="og:url"', tags.canonical);
+        html = setMetaIfPresent(html, 'property="twitter:url"', tags.canonical);
+        html = html.replace(/(<link rel="canonical" href=")[^"]*(")/, `$1${escapeAttr(tags.canonical)}$2`);
+    }
+    if (tags.alternates?.length) {
+        const links = tags.alternates
+            .map((alt) => `    <link rel="alternate" hreflang="${escapeAttr(alt.hreflang)}" href="${escapeAttr(alt.href)}" />`)
+            .join("\n");
+        html = html.replace("</head>", `${links}\n  </head>`);
+    }
+    if (tags.lang !== undefined) {
+        // `og:locale` is not the same claim as `<html lang>` and is read by different machines.
+        // APPENDED rather than set, because a Vite template carries no such tag — but one that
+        // does would end up with two, and a crawler reading the first would get the template's
+        // language on every page. So drop whatever is there before writing this page's own.
+        html = html.replace(/\s*<meta property="og:locale(?::alternate)?"[^>]*>/g, "");
+        const alternates = (tags.alternates ?? [])
+            .filter((alt) => alt.hreflang !== "x-default" && alt.hreflang !== tags.lang)
+            .map((alt) => `    <meta property="og:locale:alternate" content="${escapeAttr(ogLocale(alt.hreflang))}" />`);
+        html = html.replace("</head>", `    <meta property="og:locale" content="${escapeAttr(ogLocale(tags.lang))}" />\n${alternates.length ? `${alternates.join("\n")}\n` : ""}  </head>`);
+    }
+    if (tags.noindex)
+        html = html.replace("</head>", `    <meta name="robots" content="noindex" />\n  </head>`);
+    if (tags.headExtra)
+        html = html.replace("</head>", `    ${tags.headExtra}\n  </head>`);
+    if (tags.lang !== undefined) {
+        const re = /(<html[^>]*\blang=")[^"]*(")/;
+        if (!re.test(html))
+            throw new Error("prerender: <html lang> not found in index.html");
+        html = html.replace(re, `$1${escapeAttr(tags.lang)}$2`);
+    }
+    if (tags.body !== undefined) {
+        // Empty on purpose in the template, and it must STAY empty there: a second bake over an
+        // already-filled root would nest one render inside another.
+        if (!html.includes(EMPTY_ROOT))
+            throw new Error(`prerender: ${EMPTY_ROOT} not found in index.html`);
+        html = html.replace(EMPTY_ROOT, `<div id="root" ${PRERENDERED_ROUTE_ATTR}="${escapeAttr(tags.body.route)}">${tags.body.html}</div>`);
+    }
+    return html;
+}
+/**
+ * What every written file must be true of before the build is allowed to pass.
+ *
+ * The regression this exists for is a root that renders to nothing. A router whose location
+ * does not match its routes yields empty markup with no error and no warning — it looks fine
+ * in every browser and is invisible to everything that reads a link. Checking the bytes we
+ * actually wrote is the only thing that catches it, and it needs no browser, so it gates the
+ * BUILD rather than sitting in a test suite.
+ *
+ * The loading-screen check is the half a size floor misses. With `lazy()` routes behind one
+ * `<Suspense fallback={<Spinner />}>`, a render that resolves nothing still produces a
+ * plausible body: one donor shipped a 1,174-byte spinner with a perfect title and an element
+ * inside the root. A file whose body is a spinner is WORSE than an empty one, because every
+ * cheap check passes.
+ */
+export function assertRendered(file, html, template, checks = {}) {
+    function fail(why) {
+        throw new Error(`prerender: ${file} ${why}`);
+    }
+    // Measured against the template rather than by matching the root's closing tag — the body is
+    // thousands of nested `</div>`s and no regex should be asked to find the right one.
+    // Everything this file has over the shell it was baked from is the page.
+    const floor = checks.minGrowth ?? 500;
+    const grew = html.length - template.length;
+    if (grew < floor)
+        fail(`is only ${String(grew)} bytes bigger than the shell — nothing rendered`);
+    if (/<title>\s*<\/title>/.test(html))
+        fail("has an empty <title>");
+    if (checks.lang !== undefined && !html.includes(`<html lang="${checks.lang}"`))
+        fail(`is not marked as ${checks.lang}`);
+    // A `%NAME%` the HTML transform never filled in. Three inner characters minimum, because two
+    // is the shape of percent-encoding: `/caf%C3%A9` contains `%C3%`, and an accented slug is not
+    // a broken build.
+    const placeholder = /%[A-Z][A-Z0-9_]{2,}%/.exec(html);
+    if (placeholder)
+        fail(`still carries an unsubstituted placeholder, ${placeholder[0]}`);
+    // What the root ACTUALLY opens with. Sliced rather than matched in one pattern, because a
+    // regex that skips React's `<!--$-->` Suspense markers with `(?:<!--.*?-->|\s)*` can backtrack
+    // across the whole document — it will happily skip 40 KB of real page to find a
+    // `role="status"` further down and report a perfectly good file as a spinner. It did exactly
+    // that in the donor before this was rewritten as a slice.
+    const opened = /<div id="root"[^>]*>/.exec(html);
+    if (!opened)
+        fail("has no root element at all");
+    const start = opened.index + opened[0].length;
+    const head = html
+        .slice(start, start + 600)
+        .replace(/<!--.*?-->/g, "")
+        .trimStart();
+    if (!/^<[a-z]/.test(head))
+        fail("has no element inside its root");
+    if (/^<[^>]*role="status"/.test(head))
+        fail("rendered the loading screen, not the page — something suspended and never resolved");
+}
+//# sourceMappingURL=head.js.map

package/dist/head.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,23 @@
+/**
+ * The build-time half of a prerendered Vite + React SPA.
+ *
+ * A Vite SPA ships one `index.html` and draws the rest with JavaScript. Nothing that reads a
+ * link for a living runs that bundle — not a search crawler, not an LLM, not the thing that
+ * draws the preview card in a chat app. So the build renders every public route to a real file
+ * with a real `<head>` and a real body, and this is the part every app doing that shares.
+ *
+ * Four repos wrote it independently and each learned something the others had not. What is
+ * here is the merge; every non-obvious rule carries the reason it exists.
+ *
+ * Two things live behind their own subpath, because each drags a dependency this barrel would
+ * otherwise force on everyone: the vite config preset at `@gusnips/vite/preset` (the React and
+ * Tailwind plugins) and `renderTree` at `@gusnips/vite/render` (React itself). Nothing here
+ * imports React or vite, so a prerender script, an OG generator and a repo that only wants a
+ * sitemap all install exactly what they use.
+ */
+export { assertRendered, bakeHead, EMPTY_ROOT, ogLocale, type Alternate, type HeadTags, type RenderedChecks, } from "./head.ts";
+export { loadRenderer, loadTemplate, writeDist, writeOgCards, type OgCard, type WriteOgCardsOptions, } from "./node.ts";
+export { describeOverflow, fitText, OG_CANVAS, type FitOptions, type FitResult, type OgOverflow, } from "./og.ts";
+export type { PageRenderer } from "./render.ts";
+export { ogImagePath, pageFile, pageSlug, robotsTxt, siteOrigin, sitemapFor, sitemapXml, type PublicPage, type RobotsOptions, type SitemapEntry, } from "./sitemap.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AAKjB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,22 @@
+/**
+ * The build-time half of a prerendered Vite + React SPA.
+ *
+ * A Vite SPA ships one `index.html` and draws the rest with JavaScript. Nothing that reads a
+ * link for a living runs that bundle — not a search crawler, not an LLM, not the thing that
+ * draws the preview card in a chat app. So the build renders every public route to a real file
+ * with a real `<head>` and a real body, and this is the part every app doing that shares.
+ *
+ * Four repos wrote it independently and each learned something the others had not. What is
+ * here is the merge; every non-obvious rule carries the reason it exists.
+ *
+ * Two things live behind their own subpath, because each drags a dependency this barrel would
+ * otherwise force on everyone: the vite config preset at `@gusnips/vite/preset` (the React and
+ * Tailwind plugins) and `renderTree` at `@gusnips/vite/render` (React itself). Nothing here
+ * imports React or vite, so a prerender script, an OG generator and a repo that only wants a
+ * sitemap all install exactly what they use.
+ */
+export { assertRendered, bakeHead, EMPTY_ROOT, ogLocale, } from "./head.js";
+export { loadRenderer, loadTemplate, writeDist, writeOgCards, } from "./node.js";
+export { describeOverflow, fitText, OG_CANVAS, } from "./og.js";
+export { ogImagePath, pageFile, pageSlug, robotsTxt, siteOrigin, sitemapFor, sitemapXml, } from "./sitemap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,QAAQ,GAIT,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,GAIV,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,GAIX,MAAM,cAAc,CAAC"}

package/dist/node.d.ts ADDED Viewed

@@ -0,0 +1,57 @@
+import type { OgOverflow } from "./og.ts";
+import type { PageRenderer } from "./render.ts";
+/**
+ * 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 declare function loadTemplate(distDir: string): Promise<string>;
+/**
+ * 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 declare function loadRenderer<Context = unknown>(entryFile: string): Promise<PageRenderer<Context>>;
+/** Write one file under `dist`, creating the folders a nested route needs. */
+export declare function writeDist(distDir: string, file: string, contents: string): Promise<void>;
+/** One laid-out share card: the bytes, and anything that did not fit. */
+export interface OgCard {
+    png: Uint8Array;
+    /** Copy the layout could not hold. A single one refuses the whole run — see
+     *  {@link writeOgCards}. */
+    overflow?: readonly OgOverflow[];
+}
+export interface WriteOgCardsOptions<Page> {
+    pages: readonly Page[];
+    /** Where the cards land — `public/og` in both donors, so they are committed beside the
+     *  favicons and served as static files. */
+    outDir: string;
+    /** The file name for one page, inside `outDir`. `(page) => \`${pageSlug(page.path)}.png\``. */
+    file: (page: Page) => string;
+    /** Lay one card out and rasterize it. The card's art is the product's; this only drives it. */
+    card: (page: Page) => OgCard | Promise<OgCard>;
+    /** Lay every card out and report, without writing anything. */
+    check?: boolean;
+}
+/**
+ * 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 declare function writeOgCards<Page>({ pages, outDir, file, card, check, }: WriteOgCardsOptions<Page>): Promise<string[]>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUnE;AAWD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAG,OAAO,EAClD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAOhC;AAED,8EAA8E;AAC9E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9F;AAED,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB;gCAC4B;IAC5B,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB,CAAC,IAAI;IACvC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB;+CAC2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,EACvC,KAAK,EACL,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,KAAa,GACd,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB/C"}