@fluixi/head 0.1.0-alpha.20

package/dist/jsonld.d.ts

@@ -0,0 +1,175 @@
+type Obj = Record<string, unknown>;
+export declare const custom: (type: string, data?: Obj) => Obj;
+export declare const organization: (d: {
+    name: string;
+    url?: string;
+    logo?: string;
+    sameAs?: string[];
+} & Obj) => Obj;
+export declare const person: (d: {
+    name: string;
+    url?: string;
+    image?: string;
+    jobTitle?: string;
+    sameAs?: string[];
+} & Obj) => Obj;
+export declare const website: (d: {
+    name: string;
+    url: string;
+    description?: string;
+    searchUrl?: string;
+} & Obj) => Obj;
+export declare const webPage: (d: {
+    name: string;
+    url?: string;
+    description?: string;
+} & Obj) => Obj;
+export declare const searchAction: (d: {
+    target: string;
+    queryInput?: string;
+}) => Obj;
+export declare const article: (d: {
+    headline: string;
+    image?: string | string[];
+    author?: string | Obj;
+    datePublished?: string;
+    dateModified?: string;
+    description?: string;
+} & Obj) => Obj;
+export declare const blogPosting: (d: Parameters<typeof article>[0]) => Obj;
+export declare const faq: (items: Array<{
+    question: string;
+    answer: string;
+}>) => Obj;
+export declare const product: (d: {
+    name: string;
+    image?: string | string[];
+    description?: string;
+    sku?: string;
+    brand?: string;
+    offers?: Obj;
+} & Obj) => Obj;
+export declare const breadcrumb: (items: Array<{
+    name: string;
+    url: string;
+}>) => Obj;
+export declare const videoObject: (d: {
+    name: string;
+    description?: string;
+    thumbnailUrl?: string | string[];
+    uploadDate?: string;
+    contentUrl?: string;
+    embedUrl?: string;
+    duration?: string;
+} & Obj) => Obj;
+export declare const event: (d: {
+    name: string;
+    startDate: string;
+    endDate?: string;
+    location?: string | Obj;
+    description?: string;
+} & Obj) => Obj;
+export declare const localBusiness: (d: {
+    name: string;
+    address?: string | Obj;
+    telephone?: string;
+    url?: string;
+    image?: string;
+    priceRange?: string;
+} & Obj) => Obj;
+export declare const softwareApplication: (d: {
+    name: string;
+    operatingSystem?: string;
+    applicationCategory?: string;
+    offers?: Obj;
+    aggregateRating?: Obj;
+} & Obj) => Obj;
+export declare const jsonld: {
+    custom: (type: string, data?: Obj) => Obj;
+    organization: (d: {
+        name: string;
+        url?: string;
+        logo?: string;
+        sameAs?: string[];
+    } & Obj) => Obj;
+    person: (d: {
+        name: string;
+        url?: string;
+        image?: string;
+        jobTitle?: string;
+        sameAs?: string[];
+    } & Obj) => Obj;
+    website: (d: {
+        name: string;
+        url: string;
+        description?: string;
+        searchUrl?: string;
+    } & Obj) => Obj;
+    webPage: (d: {
+        name: string;
+        url?: string;
+        description?: string;
+    } & Obj) => Obj;
+    searchAction: (d: {
+        target: string;
+        queryInput?: string;
+    }) => Obj;
+    article: (d: {
+        headline: string;
+        image?: string | string[];
+        author?: string | Obj;
+        datePublished?: string;
+        dateModified?: string;
+        description?: string;
+    } & Obj) => Obj;
+    blogPosting: (d: Parameters<typeof article>[0]) => Obj;
+    faq: (items: Array<{
+        question: string;
+        answer: string;
+    }>) => Obj;
+    product: (d: {
+        name: string;
+        image?: string | string[];
+        description?: string;
+        sku?: string;
+        brand?: string;
+        offers?: Obj;
+    } & Obj) => Obj;
+    breadcrumb: (items: Array<{
+        name: string;
+        url: string;
+    }>) => Obj;
+    videoObject: (d: {
+        name: string;
+        description?: string;
+        thumbnailUrl?: string | string[];
+        uploadDate?: string;
+        contentUrl?: string;
+        embedUrl?: string;
+        duration?: string;
+    } & Obj) => Obj;
+    event: (d: {
+        name: string;
+        startDate: string;
+        endDate?: string;
+        location?: string | Obj;
+        description?: string;
+    } & Obj) => Obj;
+    localBusiness: (d: {
+        name: string;
+        address?: string | Obj;
+        telephone?: string;
+        url?: string;
+        image?: string;
+        priceRange?: string;
+    } & Obj) => Obj;
+    softwareApplication: (d: {
+        name: string;
+        operatingSystem?: string;
+        applicationCategory?: string;
+        offers?: Obj;
+        aggregateRating?: Obj;
+    } & Obj) => Obj;
+};
+export {};
+//# sourceMappingURL=jsonld.d.ts.map

package/dist/jsonld.d.ts.map

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

package/dist/jsonld.js

@@ -0,0 +1,62 @@
+/**
+ * Typed schema.org JSON-LD builders. Each returns a plain object ready for `seo({ jsonLd })` or
+ * `<JsonLD data={…} />`. Pass-through extra fields are allowed; `custom()` builds an arbitrary type.
+ */
+const CTX = 'https://schema.org';
+const clean = (o) => {
+    const out = {};
+    for (const [k, v] of Object.entries(o))
+        if (v !== undefined)
+            out[k] = v;
+    return out;
+};
+export const custom = (type, data = {}) => clean({ '@context': CTX, '@type': type, ...data });
+export const organization = (d) => custom('Organization', d);
+export const person = (d) => custom('Person', d);
+export const website = (d) => {
+    const { searchUrl, ...rest } = d;
+    return custom('WebSite', {
+        ...rest,
+        ...(searchUrl
+            ? {
+                potentialAction: {
+                    '@type': 'SearchAction',
+                    target: { '@type': 'EntryPoint', urlTemplate: `${searchUrl}{search_term_string}` },
+                    'query-input': 'required name=search_term_string',
+                },
+            }
+            : {}),
+    });
+};
+export const webPage = (d) => custom('WebPage', d);
+export const searchAction = (d) => clean({ '@type': 'SearchAction', target: { '@type': 'EntryPoint', urlTemplate: d.target }, 'query-input': d.queryInput ?? 'required name=search_term_string' });
+export const article = (d) => custom('Article', { ...d, author: typeof d.author === 'string' ? { '@type': 'Person', name: d.author } : d.author });
+export const blogPosting = (d) => ({ ...article(d), '@type': 'BlogPosting' });
+export const faq = (items) => custom('FAQPage', {
+    mainEntity: items.map((i) => ({ '@type': 'Question', name: i.question, acceptedAnswer: { '@type': 'Answer', text: i.answer } })),
+});
+export const product = (d) => custom('Product', { ...d, brand: typeof d.brand === 'string' ? { '@type': 'Brand', name: d.brand } : d.brand });
+export const breadcrumb = (items) => custom('BreadcrumbList', {
+    itemListElement: items.map((it, i) => ({ '@type': 'ListItem', position: i + 1, name: it.name, item: it.url })),
+});
+export const videoObject = (d) => custom('VideoObject', d);
+export const event = (d) => custom('Event', { ...d, location: typeof d.location === 'string' ? { '@type': 'Place', name: d.location } : d.location });
+export const localBusiness = (d) => custom('LocalBusiness', d);
+export const softwareApplication = (d) => custom('SoftwareApplication', d);
+export const jsonld = {
+    custom,
+    organization,
+    person,
+    website,
+    webPage,
+    searchAction,
+    article,
+    blogPosting,
+    faq,
+    product,
+    breadcrumb,
+    videoObject,
+    event,
+    localBusiness,
+    softwareApplication,
+};

package/dist/reconcile.d.ts

@@ -0,0 +1,9 @@
+import { type HeadRegistry } from './core.js';
+/**
+ * Mount reactive head management on the client. Resolves the registry inside an effect so any
+ * signal read while resolving re-runs reconciliation — `document.title`, meta, canonical, JSON-LD
+ * etc. update live with no reload and no hydration mismatch (server tags are reused by key).
+ * Returns a disposer.
+ */
+export declare function mountHead(head: HeadRegistry): () => void;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AA2D3D;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI,CAUxD"}

package/dist/reconcile.js

@@ -0,0 +1,86 @@
+import { createRoot, createEffect, onCleanup } from '@fluixi/reactive/signal';
+import { resolveHead } from './core.js';
+import { MANAGED_ATTR, KEY_ATTR } from './serialize.js';
+function setAttrs(el, attrs) {
+    // Remove attrs no longer present (except our markers).
+    for (const a of Array.from(el.attributes)) {
+        if (a.name === MANAGED_ATTR || a.name === KEY_ATTR)
+            continue;
+        if (!(a.name in attrs))
+            el.removeAttribute(a.name);
+    }
+    for (const [k, v] of Object.entries(attrs))
+        if (el.getAttribute(k) !== v)
+            el.setAttribute(k, v);
+}
+function createEl(t) {
+    const el = document.createElement(t.tag);
+    setAttrs(el, t.attrs);
+    el.setAttribute(MANAGED_ATTR, '');
+    el.setAttribute(KEY_ATTR, t.key);
+    if (t.tag === 'script' && t.children != null)
+        el.textContent = t.children;
+    return el;
+}
+/** Reconcile the resolved tags into <head>, reusing the server-rendered managed nodes by key. */
+function apply(tags, htmlAttrs) {
+    const head = document.head;
+    // Index existing managed nodes by key.
+    const existing = new Map();
+    for (const el of Array.from(head.querySelectorAll(`[${MANAGED_ATTR}]`))) {
+        const key = el.getAttribute(KEY_ATTR);
+        if (el.tagName === 'TITLE')
+            continue; // title handled via document.title
+        if (key)
+            existing.set(key, el);
+    }
+    let title = null;
+    const seen = new Set();
+    for (const t of tags) {
+        if (t.tag === 'title') {
+            title = t.children;
+            continue;
+        }
+        if (t.tag === 'htmlAttr')
+            continue; // applied to <html>, not <head> (and filtered upstream)
+        seen.add(t.key);
+        const cur = existing.get(t.key);
+        if (cur && cur.tagName === t.tag.toUpperCase()) {
+            setAttrs(cur, t.attrs);
+            if (t.tag === 'script' && (cur.textContent ?? '') !== (t.children ?? ''))
+                cur.textContent = t.children ?? '';
+        }
+        else {
+            if (cur)
+                cur.remove();
+            head.appendChild(createEl(t));
+        }
+    }
+    // Remove managed nodes that are no longer wanted.
+    for (const [key, el] of existing)
+        if (!seen.has(key))
+            el.remove();
+    if (title != null && document.title !== title)
+        document.title = title;
+    for (const [k, v] of Object.entries(htmlAttrs)) {
+        if (document.documentElement.getAttribute(k) !== v)
+            document.documentElement.setAttribute(k, v);
+    }
+}
+/**
+ * Mount reactive head management on the client. Resolves the registry inside an effect so any
+ * signal read while resolving re-runs reconciliation — `document.title`, meta, canonical, JSON-LD
+ * etc. update live with no reload and no hydration mismatch (server tags are reused by key).
+ * Returns a disposer.
+ */
+export function mountHead(head) {
+    return createRoot((dispose) => {
+        createEffect(() => {
+            head.version(); // re-run when sources are added/removed (route transitions)
+            const { tags, htmlAttrs } = resolveHead(head);
+            apply(tags, htmlAttrs);
+        });
+        onCleanup(() => { });
+        return dispose;
+    });
+}

package/dist/serialize.d.ts

@@ -0,0 +1,15 @@
+import { type HeadRegistry } from './core.js';
+/** The attribute marking a head tag as managed by @fluixi/head (so the client reconciler owns it). */
+export declare const MANAGED_ATTR = "data-fh";
+export declare const KEY_ATTR = "data-fh-key";
+export interface SerializedHead {
+    /** Markup to inject inside <head>. */
+    headHtml: string;
+    /** Attributes to apply to <html> (e.g. lang). */
+    htmlAttrs: Record<string, string>;
+}
+/** Render the registry's resolved tags to SSR head markup + <html> attributes. */
+export declare function renderHead(head: HeadRegistry): SerializedHead;
+/** Render just the <html> attribute string (e.g. ` lang="en"`) for templating. */
+export declare function renderHtmlAttrs(htmlAttrs: Record<string, string>): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAe3D,sGAAsG;AACtG,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,QAAQ,gBAAgB,CAAC;AA4BtC,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAM7D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIzE"}

package/dist/serialize.js

@@ -0,0 +1,54 @@
+import { resolveHead } from './core.js';
+const VOID = new Set(['meta', 'link', 'base']);
+function escAttr(s) {
+    return s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function escText(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Inline <script> bodies (incl. JSON-LD) must not break out of the element. */
+function escScript(s) {
+    return s.replace(/<\//g, '<\\/').replace(/<!--/g, '<\\!--');
+}
+/** The attribute marking a head tag as managed by @fluixi/head (so the client reconciler owns it). */
+export const MANAGED_ATTR = 'data-fh';
+export const KEY_ATTR = 'data-fh-key';
+function renderAttrs(attrs) {
+    let s = '';
+    for (const [k, v] of Object.entries(attrs))
+        s += ` ${k}="${escAttr(v)}"`;
+    return s;
+}
+function renderTag(t) {
+    switch (t.tag) {
+        case 'title':
+            return `<title ${MANAGED_ATTR}>${escText(t.children)}</title>`;
+        case 'meta':
+        case 'link':
+        case 'base': {
+            const marker = ` ${MANAGED_ATTR} ${KEY_ATTR}="${escAttr(t.key)}"`;
+            return `<${t.tag}${renderAttrs(t.attrs)}${marker}>`;
+        }
+        case 'script': {
+            const marker = ` ${MANAGED_ATTR} ${KEY_ATTR}="${escAttr(t.key)}"`;
+            const body = t.children ? escScript(t.children) : '';
+            return `<script${renderAttrs(t.attrs)}${marker}>${body}</script>`;
+        }
+        default:
+            return '';
+    }
+}
+/** Render the registry's resolved tags to SSR head markup + <html> attributes. */
+export function renderHead(head) {
+    const { tags, htmlAttrs } = resolveHead(head);
+    // Stable, predictable order: title, base, meta, link, script.
+    const order = { title: 0, base: 1, meta: 2, link: 3, script: 4 };
+    const sorted = [...tags].sort((a, b) => (order[a.tag] ?? 9) - (order[b.tag] ?? 9));
+    return { headHtml: sorted.map(renderTag).join(''), htmlAttrs };
+}
+/** Render just the <html> attribute string (e.g. ` lang="en"`) for templating. */
+export function renderHtmlAttrs(htmlAttrs) {
+    return Object.entries(htmlAttrs)
+        .map(([k, v]) => ` ${k}="${escAttr(v)}"`)
+        .join('');
+}

package/dist/sitemap.d.ts

@@ -0,0 +1,50 @@
+/** sitemap.xml + robots.txt generators. Pure functions — the build/server wires routes into them. */
+export interface SitemapImage {
+    loc: string;
+    title?: string;
+    caption?: string;
+}
+export interface SitemapVideo {
+    thumbnailLoc: string;
+    title: string;
+    description: string;
+    contentLoc?: string;
+    playerLoc?: string;
+}
+export interface SitemapEntry {
+    loc: string;
+    lastmod?: string | Date;
+    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    /** hreflang alternates. */
+    alternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
+    images?: SitemapImage[];
+    videos?: SitemapVideo[];
+}
+/** Build a urlset sitemap. Pass absolute `loc`s. */
+export declare function generateSitemap(entries: SitemapEntry[]): string;
+/** Split a large set into ≤`limit` chunks (default 50k, the sitemap spec cap). */
+export declare function chunkSitemap(entries: SitemapEntry[], limit?: number): SitemapEntry[][];
+/** Build a sitemap index referencing child sitemaps. */
+export declare function generateSitemapIndex(sitemaps: Array<{
+    loc: string;
+    lastmod?: string | Date;
+}>): string;
+export interface RobotsRule {
+    userAgent: string | string[];
+    allow?: string | string[];
+    disallow?: string | string[];
+    crawlDelay?: number;
+}
+export interface RobotsOptions {
+    rules?: RobotsRule[];
+    host?: string;
+    sitemaps?: string[];
+    /** When false (e.g. non-production), emit a disallow-all robots so previews aren't indexed. */
+    production?: boolean;
+}
+export declare function generateRobots(opts?: 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":"AAAA,qGAAqG;AAErG,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAiCD,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAO/D;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,SAAQ,GAAG,YAAY,EAAE,EAAE,CAIrF;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,MAAM,CAQtG;AAMD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAgB/D"}

package/dist/sitemap.js

@@ -0,0 +1,87 @@
+/** sitemap.xml + robots.txt generators. Pure functions — the build/server wires routes into them. */
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+function isoDate(d) {
+    return d instanceof Date ? d.toISOString() : d;
+}
+function renderEntry(e) {
+    let s = '  <url>\n';
+    s += `    <loc>${esc(e.loc)}</loc>\n`;
+    if (e.lastmod != null)
+        s += `    <lastmod>${esc(isoDate(e.lastmod))}</lastmod>\n`;
+    if (e.changefreq)
+        s += `    <changefreq>${e.changefreq}</changefreq>\n`;
+    if (e.priority != null)
+        s += `    <priority>${e.priority.toFixed(1)}</priority>\n`;
+    for (const a of e.alternates ?? [])
+        s += `    <xhtml:link rel="alternate" hreflang="${esc(a.hreflang)}" href="${esc(a.href)}"/>\n`;
+    for (const img of e.images ?? []) {
+        s += `    <image:image>\n      <image:loc>${esc(img.loc)}</image:loc>\n`;
+        if (img.title)
+            s += `      <image:title>${esc(img.title)}</image:title>\n`;
+        if (img.caption)
+            s += `      <image:caption>${esc(img.caption)}</image:caption>\n`;
+        s += `    </image:image>\n`;
+    }
+    for (const v of e.videos ?? []) {
+        s += `    <video:video>\n      <video:thumbnail_loc>${esc(v.thumbnailLoc)}</video:thumbnail_loc>\n`;
+        s += `      <video:title>${esc(v.title)}</video:title>\n      <video:description>${esc(v.description)}</video:description>\n`;
+        if (v.contentLoc)
+            s += `      <video:content_loc>${esc(v.contentLoc)}</video:content_loc>\n`;
+        if (v.playerLoc)
+            s += `      <video:player_loc>${esc(v.playerLoc)}</video:player_loc>\n`;
+        s += `    </video:video>\n`;
+    }
+    s += '  </url>\n';
+    return s;
+}
+/** Build a urlset sitemap. Pass absolute `loc`s. */
+export function generateSitemap(entries) {
+    const ns = 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ' +
+        'xmlns:xhtml="http://www.w3.org/1999/xhtml" ' +
+        'xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" ' +
+        'xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"';
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset ${ns}>\n${entries.map(renderEntry).join('')}</urlset>\n`;
+}
+/** Split a large set into ≤`limit` chunks (default 50k, the sitemap spec cap). */
+export function chunkSitemap(entries, limit = 50000) {
+    const out = [];
+    for (let i = 0; i < entries.length; i += limit)
+        out.push(entries.slice(i, i + limit));
+    return out;
+}
+/** Build a sitemap index referencing child sitemaps. */
+export function generateSitemapIndex(sitemaps) {
+    let s = '<?xml version="1.0" encoding="UTF-8"?>\n<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n';
+    for (const sm of sitemaps) {
+        s += `  <sitemap>\n    <loc>${esc(sm.loc)}</loc>\n`;
+        if (sm.lastmod != null)
+            s += `    <lastmod>${esc(isoDate(sm.lastmod))}</lastmod>\n`;
+        s += '  </sitemap>\n';
+    }
+    return s + '</sitemapindex>\n';
+}
+export function generateRobots(opts = {}) {
+    if (opts.production === false) {
+        return 'User-agent: *\nDisallow: /\n';
+    }
+    const lines = [];
+    const rules = opts.rules ?? [{ userAgent: '*', allow: '/' }];
+    for (const r of rules) {
+        for (const ua of [].concat(r.userAgent))
+            lines.push(`User-agent: ${ua}`);
+        for (const a of [].concat(r.allow ?? []))
+            lines.push(`Allow: ${a}`);
+        for (const d of [].concat(r.disallow ?? []))
+            lines.push(`Disallow: ${d}`);
+        if (r.crawlDelay != null)
+            lines.push(`Crawl-delay: ${r.crawlDelay}`);
+        lines.push('');
+    }
+    if (opts.host)
+        lines.push(`Host: ${opts.host}`);
+    for (const sm of opts.sitemaps ?? [])
+        lines.push(`Sitemap: ${sm}`);
+    return lines.join('\n').replace(/\n+$/, '\n');
+}

package/dist/transport.d.ts

@@ -0,0 +1,19 @@
+import type { SerializedHead } from './serialize.js';
+/** Encode the serialized head into a marker to prepend to the rendered body. */
+export declare function encodeHeadMarker(head: SerializedHead): string;
+/**
+ * Client-side safety net: remove any `<!--fh:…-->` transport comment left inside the hydration
+ * container. A correct adapter/prerender/dev server lifts the marker into <head> before it reaches
+ * the browser, but a streaming or custom server can leave it in the body. Since encodeHeadMarker
+ * prepends it, an un-extracted marker is the mount root's first child — where it strands the
+ * hydration cursor (the walk expects the app's first element, finds a comment, and rebuilds the
+ * whole tree next to the server DOM → duplicate). The client rebuilds the head from seo()/useHead
+ * during hydration, so the marker's payload isn't needed here — just drop the node.
+ */
+export declare function stripHeadMarker(container: ParentNode): void;
+/** Pull the head marker out of rendered HTML, returning the head and the cleaned body. */
+export declare function extractHeadMarker(html: string): {
+    head: SerializedHead | null;
+    body: string;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAmBrD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAG7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI,CAO3D;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU7F"}

package/dist/transport.js

@@ -0,0 +1,53 @@
+// The server can't change the render's return type, so the collected head rides back inside the
+// rendered HTML as one inert comment marker; the adapter/prerender extracts it into <head>. If a
+// custom server doesn't extract it, it's just an invisible comment in the body — no breakage.
+const RE = /<!--fh:([A-Za-z0-9+/=]+)-->/;
+function b64encode(s) {
+    const g = globalThis;
+    if (g.Buffer)
+        return g.Buffer.from(s, 'utf-8').toString('base64');
+    return g.btoa(unescape(encodeURIComponent(s)));
+}
+function b64decode(s) {
+    const g = globalThis;
+    if (g.Buffer)
+        return g.Buffer.from(s, 'base64').toString('utf-8');
+    return decodeURIComponent(escape(g.atob(s)));
+}
+/** Encode the serialized head into a marker to prepend to the rendered body. */
+export function encodeHeadMarker(head) {
+    if (!head.headHtml && Object.keys(head.htmlAttrs).length === 0)
+        return '';
+    return `<!--fh:${b64encode(JSON.stringify(head))}-->`;
+}
+/**
+ * Client-side safety net: remove any `<!--fh:…-->` transport comment left inside the hydration
+ * container. A correct adapter/prerender/dev server lifts the marker into <head> before it reaches
+ * the browser, but a streaming or custom server can leave it in the body. Since encodeHeadMarker
+ * prepends it, an un-extracted marker is the mount root's first child — where it strands the
+ * hydration cursor (the walk expects the app's first element, finds a comment, and rebuilds the
+ * whole tree next to the server DOM → duplicate). The client rebuilds the head from seo()/useHead
+ * during hydration, so the marker's payload isn't needed here — just drop the node.
+ */
+export function stripHeadMarker(container) {
+    for (let n = container.firstChild; n; n = n.nextSibling) {
+        if (n.nodeType === 8 && n.data.startsWith('fh:')) {
+            n.parentNode?.removeChild(n);
+            return;
+        }
+    }
+}
+/** Pull the head marker out of rendered HTML, returning the head and the cleaned body. */
+export function extractHeadMarker(html) {
+    const m = html.match(RE);
+    if (!m)
+        return { head: null, body: html };
+    let head = null;
+    try {
+        head = JSON.parse(b64decode(m[1]));
+    }
+    catch {
+        head = null;
+    }
+    return { head, body: html.replace(m[0], '') };
+}