@plumix/core 0.1.0

package/dist/seo/canonical.js

@@ -0,0 +1,81 @@
+import { withBasePath } from "../base-path.js";
+/**
+ * Normalize a pathname to its canonical, slash-less shape. `/page/1` is the
+ * same content as the bare listing, so it collapses — `/shop/page/1` → `/shop`,
+ * `/page/1` → `/`. Shared by {@link canonicalUrl} and
+ * {@link canonicalRedirectTarget} so the tag and the 301 can never disagree.
+ */
+function canonicalPath(pathname) {
+    const slashless = pathname === "/" ? "/" : pathname.replace(/\/+$/, "");
+    return slashless.replace(/\/page\/1$/, "") || "/";
+}
+/**
+ * The single source of truth for a request's canonical URL: the configured
+ * site origin + the request path normalized to the fixed slash-less shape
+ * (query and fragment dropped so URL variants consolidate). Drives the
+ * `<link rel="canonical">` tag and the 301 normalizer + sitemap/og:url, so
+ * they can never disagree.
+ */
+export function canonicalUrl(ctx) {
+    // The dispatcher already stripped any base prefix from the request, so the
+    // pathname is root-relative; re-add the prefix on the way out.
+    const canonical = canonicalPath(new URL(ctx.request.url).pathname);
+    return `${ctx.origin}${withBasePath(canonical, ctx.basePath)}`;
+}
+/**
+ * Paths the 301 normalizer must never touch: the root, the plumix surface, the
+ * SEO machine endpoints (robots, feeds), and asset/extension-like paths (a dot
+ * in the last segment — covers `sitemap*.xml`, `favicon.ico`, etc.). Everything
+ * else is a public page route whose shape we normalize.
+ */
+export function isCanonicalExempt(pathname) {
+    if (pathname === "/")
+        return true;
+    if (pathname === "/robots.txt")
+        return true;
+    if (pathname.startsWith("/_plumix/"))
+        return true;
+    // Feed endpoints own their exact routing; `/feedback` only shares a prefix.
+    if (pathname === "/feed" || pathname.startsWith("/feed/"))
+        return true;
+    const trimmed = pathname.replace(/\/+$/, "");
+    const lastSegment = trimmed.slice(trimmed.lastIndexOf("/") + 1);
+    return lastSegment.includes(".");
+}
+/**
+ * The canonical URL to 301-redirect this request to, or null when it's already
+ * canonical or exempt. Shares {@link canonicalUrl} with the `<link rel=canonical>`
+ * tag so the redirect target and the tag can never disagree; the query string
+ * is preserved, and an already-canonical path returns null (loop-safe).
+ */
+export function canonicalRedirectTarget(ctx) {
+    // Request path is already root-relative (base stripped at the dispatcher
+    // edge), so `/` — the base prefix's own front page — is exempt as usual.
+    const url = new URL(ctx.request.url);
+    if (isCanonicalExempt(url.pathname))
+        return null;
+    const target = canonicalPath(url.pathname);
+    if (url.pathname === target)
+        return null;
+    return `${ctx.origin}${withBasePath(target, ctx.basePath)}${url.search}`;
+}
+function hasCanonical(manifest) {
+    return manifest.link?.some((link) => link.rel === "canonical") ?? false;
+}
+/**
+ * Gap-filler: emit `<link rel="canonical">` only when neither the template nor
+ * a `render:document` subscriber already set one — so a higher layer's canonical
+ * always wins and the tag never duplicates.
+ */
+export function applyCanonical(manifest, ctx) {
+    if (hasCanonical(manifest))
+        return manifest;
+    return {
+        ...manifest,
+        link: [
+            ...(manifest.link ?? []),
+            { rel: "canonical", href: canonicalUrl(ctx) },
+        ],
+    };
+}
+//# sourceMappingURL=canonical.js.map

package/dist/seo/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/seo/canonical.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,SAAS,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,2EAA2E;IAC3E,+DAA+D;IAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,QAAQ,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,4EAA4E;IAC5E,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAe;IACrD,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,YAAY,CAAC,QAA0B;IAC9C,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA0B,EAC1B,GAAe;IAEf,IAAI,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE;YACJ,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YACxB,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE;SAC9C;KACF,CAAC;AACJ,CAAC"}

package/dist/seo/feed.d.ts

@@ -0,0 +1,73 @@
+import type { AppContext } from "../context/app.js";
+import type { RegisteredTermTaxonomy } from "../plugin/manifest.js";
+import type { DocumentManifest, TemplateData } from "../theme.js";
+export declare const FEED_LIMIT = 20;
+type FeedFormat = "rss2" | "atom";
+/**
+ * What a feed covers: the whole site, one entry type, or one taxonomy term.
+ * `taxonomy`/`term` are the registered taxonomy name + term slug.
+ */
+type FeedScope = {
+    readonly kind: "site";
+} | {
+    readonly kind: "type";
+    readonly type: string;
+} | {
+    readonly kind: "term";
+    readonly taxonomy: string;
+    readonly term: string;
+};
+declare module "../hooks/types.js" {
+    interface FilterRegistry {
+        /**
+         * Adjust a feed's item list before serialization — add, drop, or re-order.
+         * Receives the {@link FeedScope} the items were collected for.
+         */
+        "seo:feed:items": (items: readonly FeedItem[], scope: FeedScope) => readonly FeedItem[] | Promise<readonly FeedItem[]>;
+    }
+}
+export interface FeedItem {
+    readonly title: string;
+    readonly link: string;
+    /** Stable identifier (Atom `<id>`); typically the permalink. */
+    readonly id: string;
+    /** Last-modified timestamp, ISO-8601. */
+    readonly updated: string;
+    /** First-published timestamp, ISO-8601. Falls back to `updated`. */
+    readonly published?: string;
+    readonly summary?: string;
+    readonly author?: string;
+}
+export interface FeedChannel {
+    readonly title: string;
+    /** The site home URL. */
+    readonly link: string;
+    /** This feed's own URL (`rel="self"`). */
+    readonly feedUrl: string;
+    readonly description: string;
+    /** Feed-level last-modified timestamp, ISO-8601. */
+    readonly updated: string;
+}
+export declare function renderRss2(channel: FeedChannel, items: readonly FeedItem[]): string;
+export declare function renderAtom(channel: FeedChannel, items: readonly FeedItem[]): string;
+/** Whether a scope names a registered, public entry type. */
+export declare function isPublicEntryType(ctx: AppContext, type: string): boolean;
+/** The public taxonomy whose archive base slug matches `slug`, if any. */
+export declare function publicTaxonomyByBaseSlug(ctx: AppContext, slug: string): RegisteredTermTaxonomy | undefined;
+/**
+ * Recent published, public-type entries for a feed scope, newest first, run
+ * through `seo:feed:items`. Returns null for an unknown scope (non-public type,
+ * missing term) so the route can 404.
+ */
+export declare function collectFeedItems(ctx: AppContext, scope: FeedScope): Promise<readonly FeedItem[] | null>;
+export declare function handleFeed(ctx: AppContext, scope: FeedScope, format: FeedFormat): Promise<Response>;
+/**
+ * Gap-filler: append `<link rel="alternate">` feed-discovery tags for the
+ * page's scope, skipping any type already present so a template / plugin value
+ * wins. A private site advertises nothing (it 404s its feeds).
+ */
+export declare function applyFeedDiscovery(manifest: DocumentManifest, data: TemplateData, ctx: AppContext, opts: {
+    readonly siteIsPrivate: boolean;
+}): DocumentManifest;
+export {};
+//# sourceMappingURL=feed.d.ts.map

package/dist/seo/feed.d.ts.map

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

package/dist/seo/feed.js

@@ -0,0 +1,254 @@
+import { withBasePath } from "../base-path.js";
+import { and, desc, eq, inArray } from "../db/index.js";
+import { entries } from "../db/schema/entries.js";
+import { entryTerm } from "../db/schema/entry_term.js";
+import { terms } from "../db/schema/terms.js";
+import { users } from "../db/schema/users.js";
+import { buildEntryPermalink, termTaxonomyBaseSlug, } from "../route/permalink.js";
+import { loadSiteSettings, nonEmpty } from "./site-settings.js";
+import { xmlEscape } from "./xml.js";
+// Recent-items window. Generous enough for a reader's "what's new" without
+// turning the feed into a full archive (that's the sitemap's job).
+export const FEED_LIMIT = 20;
+// RSS2 timestamps are RFC-822; `toUTCString()` produces exactly that shape.
+function rfc822(iso) {
+    return new Date(iso).toUTCString();
+}
+export function renderRss2(channel, items) {
+    const body = items
+        .map((item) => {
+        const summary = item.summary
+            ? `<description>${xmlEscape(item.summary)}</description>`
+            : "";
+        const creator = item.author
+            ? `<dc:creator>${xmlEscape(item.author)}</dc:creator>`
+            : "";
+        return (`<item>` +
+            `<title>${xmlEscape(item.title)}</title>` +
+            `<link>${xmlEscape(item.link)}</link>` +
+            `<guid isPermaLink="true">${xmlEscape(item.link)}</guid>` +
+            `<pubDate>${rfc822(item.published ?? item.updated)}</pubDate>` +
+            summary +
+            creator +
+            `</item>`);
+    })
+        .join("");
+    return (`<?xml version="1.0" encoding="UTF-8"?>` +
+        `<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">` +
+        `<channel>` +
+        `<title>${xmlEscape(channel.title)}</title>` +
+        `<link>${xmlEscape(channel.link)}</link>` +
+        `<description>${xmlEscape(channel.description)}</description>` +
+        `<atom:link href="${xmlEscape(channel.feedUrl)}" rel="self" type="application/rss+xml"></atom:link>` +
+        `<lastBuildDate>${rfc822(channel.updated)}</lastBuildDate>` +
+        body +
+        `</channel></rss>`);
+}
+export function renderAtom(channel, items) {
+    const body = items
+        .map((item) => {
+        const published = item.published
+            ? `<published>${xmlEscape(item.published)}</published>`
+            : "";
+        const summary = item.summary
+            ? `<summary>${xmlEscape(item.summary)}</summary>`
+            : "";
+        const author = item.author
+            ? `<author><name>${xmlEscape(item.author)}</name></author>`
+            : "";
+        return (`<entry>` +
+            `<title>${xmlEscape(item.title)}</title>` +
+            `<link href="${xmlEscape(item.link)}"></link>` +
+            `<id>${xmlEscape(item.id)}</id>` +
+            `<updated>${xmlEscape(item.updated)}</updated>` +
+            published +
+            summary +
+            author +
+            `</entry>`);
+    })
+        .join("");
+    return (`<?xml version="1.0" encoding="UTF-8"?>` +
+        `<feed xmlns="http://www.w3.org/2005/Atom">` +
+        `<title>${xmlEscape(channel.title)}</title>` +
+        `<link href="${xmlEscape(channel.link)}"></link>` +
+        `<link href="${xmlEscape(channel.feedUrl)}" rel="self"></link>` +
+        `<id>${xmlEscape(channel.feedUrl)}</id>` +
+        `<updated>${xmlEscape(channel.updated)}</updated>` +
+        body +
+        `</feed>`);
+}
+/** Whether a scope names a registered, public entry type. */
+export function isPublicEntryType(ctx, type) {
+    const entryType = ctx.plugins.entryTypes.get(type);
+    return entryType !== undefined && entryType.isPublic !== false;
+}
+/** The public taxonomy whose archive base slug matches `slug`, if any. */
+export function publicTaxonomyByBaseSlug(ctx, slug) {
+    for (const taxonomy of ctx.plugins.termTaxonomies.values()) {
+        if (taxonomy.isPublic !== false &&
+            termTaxonomyBaseSlug(taxonomy) === slug) {
+            return taxonomy;
+        }
+    }
+    return undefined;
+}
+function publicEntryTypeNames(ctx) {
+    return [...ctx.plugins.entryTypes.values()]
+        .filter((type) => type.isPublic !== false)
+        .map((type) => type.name);
+}
+// SQL row filter for a scope; `null` means the scope can't yield a feed
+// (unknown type/term, nested term, or no public types) so the caller 404s.
+async function feedFilter(ctx, scope) {
+    const published = eq(entries.status, "published");
+    if (scope.kind === "type") {
+        if (!isPublicEntryType(ctx, scope.type))
+            return null;
+        return and(eq(entries.type, scope.type), published);
+    }
+    const typeNames = publicEntryTypeNames(ctx);
+    const publicTypes = inArray(entries.type, typeNames);
+    if (scope.kind === "site") {
+        return typeNames.length === 0 ? null : and(publicTypes, published);
+    }
+    // term: only entries attached to the term, and still of a public type. Only
+    // top-level terms have the flat `/base/slug/feed` URL the route addresses —
+    // nested terms have no feed route yet, so they 404.
+    const [term] = await ctx.db
+        .select({ id: terms.id, parentId: terms.parentId })
+        .from(terms)
+        .where(and(eq(terms.taxonomy, scope.taxonomy), eq(terms.slug, scope.term)));
+    if (!term)
+        return null;
+    if (term.parentId !== null || typeNames.length === 0)
+        return null;
+    const attached = ctx.db
+        .select({ id: entryTerm.entryId })
+        .from(entryTerm)
+        .where(eq(entryTerm.termId, term.id));
+    return and(publicTypes, published, inArray(entries.id, attached));
+}
+/**
+ * Recent published, public-type entries for a feed scope, newest first, run
+ * through `seo:feed:items`. Returns null for an unknown scope (non-public type,
+ * missing term) so the route can 404.
+ */
+export async function collectFeedItems(ctx, scope) {
+    const where = await feedFilter(ctx, scope);
+    if (where === null)
+        return null;
+    const rows = await ctx.db
+        .select({
+        title: entries.title,
+        slug: entries.slug,
+        type: entries.type,
+        parentId: entries.parentId,
+        excerpt: entries.excerpt,
+        updatedAt: entries.updatedAt,
+        publishedAt: entries.publishedAt,
+        authorName: users.name,
+    })
+        .from(entries)
+        .leftJoin(users, eq(entries.authorId, users.id))
+        .where(where)
+        .orderBy(desc(entries.publishedAt))
+        .limit(FEED_LIMIT);
+    const items = [];
+    for (const row of rows) {
+        const path = await buildEntryPermalink(ctx, row);
+        if (path === null)
+            continue;
+        const link = `${ctx.origin}${path}`;
+        items.push({
+            title: row.title,
+            link,
+            id: link,
+            updated: row.updatedAt.toISOString(),
+            published: (row.publishedAt ?? row.updatedAt).toISOString(),
+            summary: row.excerpt ?? undefined,
+            author: row.authorName ?? undefined,
+        });
+    }
+    return ctx.hooks.applyFilter("seo:feed:items", items, scope);
+}
+const CONTENT_TYPE = {
+    rss2: "application/rss+xml; charset=utf-8",
+    atom: "application/atom+xml; charset=utf-8",
+};
+export async function handleFeed(ctx, scope, format) {
+    const site = await loadSiteSettings(ctx);
+    // A private site is held out of syndication. (The sitemap returns an empty
+    // 200 instead — there's no "valid but empty because private" feed idiom, so
+    // 404 is the honest answer here.)
+    if (site.public === false)
+        return new Response(null, { status: 404 });
+    const items = await collectFeedItems(ctx, scope);
+    if (items === null)
+        return new Response(null, { status: 404 });
+    const channel = {
+        title: nonEmpty(site.title) ?? ctx.origin,
+        link: `${ctx.origin}${withBasePath("/", ctx.basePath)}`,
+        // The feed's self URL is this request's path. The dispatcher already
+        // stripped the base prefix, so re-add it for the externally-visible URL.
+        feedUrl: `${ctx.origin}${withBasePath(new URL(ctx.request.url).pathname, ctx.basePath)}`,
+        description: nonEmpty(site.tagline) ?? "",
+        updated: items[0]?.updated ?? new Date().toISOString(),
+    };
+    const body = format === "atom" ? renderAtom(channel, items) : renderRss2(channel, items);
+    return new Response(body, {
+        headers: { "content-type": CONTENT_TYPE[format] },
+    });
+}
+// The feed base path a page should advertise, or `false` when it has none
+// (search, error, or a non-public type/taxonomy). A single entry advertises the
+// site feed, not its type feed — a reader subscribing from a post wants
+// "everything new", which is the convention (WordPress et al.).
+function discoveryFeedBase(data, ctx) {
+    if ("contentType" in data) {
+        return isPublicEntryType(ctx, data.contentType)
+            ? `/${data.contentType}/feed`
+            : false;
+    }
+    if ("taxonomy" in data) {
+        const taxonomy = ctx.plugins.termTaxonomies.get(data.taxonomy);
+        if (!taxonomy || taxonomy.isPublic === false)
+            return false;
+        // Only top-level terms have the flat URL the feed route can address.
+        if (data.term.parentId !== null)
+            return false;
+        return `/${termTaxonomyBaseSlug(taxonomy)}/${data.term.slug}/feed`;
+    }
+    if ("query" in data)
+        return false;
+    if ("request" in data)
+        return false;
+    return "/feed";
+}
+function hasAlternate(links, type) {
+    return links?.some((l) => l.rel === "alternate" && l.type === type) ?? false;
+}
+/**
+ * Gap-filler: append `<link rel="alternate">` feed-discovery tags for the
+ * page's scope, skipping any type already present so a template / plugin value
+ * wins. A private site advertises nothing (it 404s its feeds).
+ */
+export function applyFeedDiscovery(manifest, data, ctx, opts) {
+    if (opts.siteIsPrivate)
+        return manifest;
+    const base = discoveryFeedBase(data, ctx);
+    if (base === false)
+        return manifest;
+    const existing = manifest.link;
+    const additions = [];
+    const add = (type, href) => {
+        if (!hasAlternate(existing, type)) {
+            additions.push({ rel: "alternate", type, href });
+        }
+    };
+    add("application/rss+xml", `${ctx.origin}${withBasePath(base, ctx.basePath)}`);
+    add("application/atom+xml", `${ctx.origin}${withBasePath(`${base}/atom`, ctx.basePath)}`);
+    if (additions.length === 0)
+        return manifest;
+    return { ...manifest, link: [...(existing ?? []), ...additions] };
+}
+//# sourceMappingURL=feed.js.map

package/dist/seo/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../../src/seo/feed.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,2EAA2E;AAC3E,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAkD7B,4EAA4E;AAC5E,SAAS,MAAM,CAAC,GAAW;IACzB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAoB,EACpB,KAA0B;IAE1B,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;YAC1B,CAAC,CAAC,gBAAgB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB;YACzD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM;YACzB,CAAC,CAAC,eAAe,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CACL,QAAQ;YACR,UAAU,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;YACzC,SAAS,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YACtC,4BAA4B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YACzD,YAAY,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY;YAC9D,OAAO;YACP,OAAO;YACP,SAAS,CACV,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CACL,wCAAwC;QACxC,0GAA0G;QAC1G,WAAW;QACX,UAAU,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU;QAC5C,SAAS,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS;QACzC,gBAAgB,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB;QAC9D,oBAAoB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,sDAAsD;QACpG,kBAAkB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB;QAC3D,IAAI;QACJ,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAoB,EACpB,KAA0B;IAE1B,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;YAC9B,CAAC,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc;YACvD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;YAC1B,CAAC,CAAC,YAAY,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;YACxB,CAAC,CAAC,iBAAiB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB;YAC3D,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CACL,SAAS;YACT,UAAU,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;YACzC,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;YAC9C,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO;YAChC,YAAY,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;YAC/C,SAAS;YACT,OAAO;YACP,MAAM;YACN,UAAU,CACX,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CACL,wCAAwC;QACxC,4CAA4C;QAC5C,UAAU,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU;QAC5C,eAAe,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW;QACjD,eAAe,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB;QAC/D,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO;QACxC,YAAY,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY;QAClD,IAAI;QACJ,SAAS,CACV,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAAE,IAAY;IAC7D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC;AACjE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CACtC,GAAe,EACf,IAAY;IAEZ,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3D,IACE,QAAQ,CAAC,QAAQ,KAAK,KAAK;YAC3B,oBAAoB,CAAC,QAAQ,CAAC,KAAK,IAAI,EACvC,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAe;IAC3C,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC;SACzC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,wEAAwE;AACxE,2EAA2E;AAC3E,KAAK,UAAU,UAAU,CACvB,GAAe,EACf,KAAgB;IAEhB,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,oDAAoD;IACpD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE;SACxB,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SAClD,IAAI,CAAC,KAAK,CAAC;SACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE;SACpB,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;SACjC,IAAI,CAAC,SAAS,CAAC;SACf,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAe,EACf,KAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACtB,MAAM,CAAC;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,KAAK,CAAC,IAAI;KACvB,CAAC;SACD,IAAI,CAAC,OAAO,CAAC;SACb,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;SAC/C,KAAK,CAAC,KAAK,CAAC;SACZ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SAClC,KAAK,CAAC,UAAU,CAAC,CAAC;IAErB,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI;YACJ,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAC3D,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;YACjC,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;SACpC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,YAAY,GAA+B;IAC/C,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,qCAAqC;CAC5C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAe,EACf,KAAgB,EAChB,MAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,2EAA2E;IAC3E,4EAA4E;IAC5E,kCAAkC;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAgB;QAC3B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM;QACzC,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE;QACvD,qEAAqE;QACrE,yEAAyE;QACzE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE;QACxF,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QACzC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,MAAM,IAAI,GACR,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9E,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE;KAClD,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,gFAAgF;AAChF,wEAAwE;AACxE,gEAAgE;AAChE,SAAS,iBAAiB,CACxB,IAAkB,EAClB,GAAe;IAEf,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC;YAC7C,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,OAAO;YAC7B,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;IACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC3D,qEAAqE;QACrE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9C,OAAO,IAAI,oBAAoB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,SAAS,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CACnB,KAA0C,EAC1C,IAAY;IAEZ,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA0B,EAC1B,IAAkB,EAClB,GAAe,EACf,IAAyC;IAEzC,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,QAAQ,CAAC;IACxC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAEpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAQ,EAAE;QAC/C,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC;IACF,GAAG,CACD,qBAAqB,EACrB,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CACnD,CAAC;IACF,GAAG,CACD,sBAAsB,EACtB,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,IAAI,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAC7D,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/seo/head-defaults.d.ts

@@ -0,0 +1,27 @@
+import type { AppContext } from "../context/app.js";
+import type { DocumentManifest, TemplateData } from "../theme.js";
+interface SeoInputs {
+    readonly canonical: string;
+    readonly title: string | undefined;
+    readonly description: string | null;
+    readonly ogType: "article" | "website";
+    readonly ogImage: string | null;
+    readonly siteName: string | null;
+    readonly ogLocale: string;
+    readonly noindex: boolean;
+    readonly siteIsPrivate: boolean;
+}
+/**
+ * Pure gap-filler for the default head meta set: appends a `<meta>` only when
+ * its `name`/`property` key is absent, so a template- or plugin-set value always
+ * wins and nothing duplicates.
+ */
+export declare function seoHeadDefaults(manifest: DocumentManifest, inputs: SeoInputs): DocumentManifest;
+/**
+ * Fill the default head meta for a request. Reads the site settings (title,
+ * tagline, default OG image) for the values it can't derive from the page, then
+ * gap-fills via {@link seoHeadDefaults}.
+ */
+export declare function applyHeadMeta(manifest: DocumentManifest, data: TemplateData, ctx: AppContext, title: string | undefined): Promise<DocumentManifest>;
+export {};
+//# sourceMappingURL=head-defaults.d.ts.map

package/dist/seo/head-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-defaults.d.ts","sourceRoot":"","sources":["../../src/seo/head-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBhF,UAAU,SAAS;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAgBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,SAAS,GAChB,gBAAgB,CA+BlB;AAOD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B"}

package/dist/seo/head-defaults.js

@@ -0,0 +1,82 @@
+import { canonicalUrl } from "./canonical.js";
+import { applyFeedDiscovery } from "./feed.js";
+import { loadSiteSettings, nonEmpty } from "./site-settings.js";
+const ROBOTS_INDEX = "index,follow,max-image-preview:large";
+const ROBOTS_SEARCH = "noindex,follow";
+const ROBOTS_PRIVATE = "noindex,nofollow";
+// A private site is held out entirely; a thin search-results page is kept out
+// of the index but its links are still followed.
+function robotsDirective(input) {
+    if (input.siteIsPrivate)
+        return ROBOTS_PRIVATE;
+    return input.noindex ? ROBOTS_SEARCH : ROBOTS_INDEX;
+}
+function hasName(meta, name) {
+    return meta?.some((entry) => entry.name === name) ?? false;
+}
+function hasProperty(meta, property) {
+    return meta?.some((entry) => entry.property === property) ?? false;
+}
+/**
+ * Pure gap-filler for the default head meta set: appends a `<meta>` only when
+ * its `name`/`property` key is absent, so a template- or plugin-set value always
+ * wins and nothing duplicates.
+ */
+export function seoHeadDefaults(manifest, inputs) {
+    const existing = manifest.meta;
+    const additions = [];
+    const addName = (name, content) => {
+        if (content && !hasName(existing, name))
+            additions.push({ name, content });
+    };
+    const addProperty = (property, content) => {
+        if (content && !hasProperty(existing, property)) {
+            additions.push({ property, content });
+        }
+    };
+    addName("description", inputs.description);
+    addName("robots", robotsDirective({
+        siteIsPrivate: inputs.siteIsPrivate,
+        noindex: inputs.noindex,
+    }));
+    addName("twitter:card", inputs.ogImage ? "summary_large_image" : "summary");
+    addProperty("og:title", inputs.title ?? null);
+    addProperty("og:type", inputs.ogType);
+    addProperty("og:url", inputs.canonical);
+    addProperty("og:site_name", inputs.siteName);
+    addProperty("og:description", inputs.description);
+    addProperty("og:locale", inputs.ogLocale);
+    addProperty("og:image", inputs.ogImage);
+    if (additions.length === 0)
+        return manifest;
+    return { ...manifest, meta: [...(existing ?? []), ...additions] };
+}
+// `og:locale` wants `lang_TERRITORY`; the active locale code is `lang-TERRITORY`.
+function toOgLocale(localeCode) {
+    return localeCode.replace("-", "_");
+}
+/**
+ * Fill the default head meta for a request. Reads the site settings (title,
+ * tagline, default OG image) for the values it can't derive from the page, then
+ * gap-fills via {@link seoHeadDefaults}.
+ */
+export async function applyHeadMeta(manifest, data, ctx, title) {
+    const site = await loadSiteSettings(ctx);
+    const siteIsPrivate = site.public === false;
+    const excerpt = "entry" in data ? nonEmpty(data.entry.excerpt) : null;
+    const description = excerpt ?? nonEmpty(site.tagline);
+    const withMeta = seoHeadDefaults(manifest, {
+        canonical: canonicalUrl(ctx),
+        title,
+        description,
+        ogType: "entry" in data ? "article" : "website",
+        ogImage: nonEmpty(site.default_og_image),
+        siteName: nonEmpty(site.title),
+        ogLocale: toOgLocale(ctx.locale.code),
+        // Search-results pages are thin; keep them out of the index.
+        noindex: "query" in data,
+        siteIsPrivate,
+    });
+    return applyFeedDiscovery(withMeta, data, ctx, { siteIsPrivate });
+}
+//# sourceMappingURL=head-defaults.js.map

package/dist/seo/head-defaults.js.map

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

package/dist/seo/register-sitemap-invalidator.d.ts

@@ -0,0 +1,7 @@
+import type { HookRegistry } from "../hooks/registry.js";
+/**
+ * Register core's sitemap cache-busting subscribers. Called at app boot
+ * alongside the other core hook registrations.
+ */
+export declare function registerCoreSitemapInvalidator(hooks: HookRegistry): void;
+//# sourceMappingURL=register-sitemap-invalidator.d.ts.map

package/dist/seo/register-sitemap-invalidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-sitemap-invalidator.d.ts","sourceRoot":"","sources":["../../src/seo/register-sitemap-invalidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA2BzD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAYxE"}

package/dist/seo/register-sitemap-invalidator.js

@@ -0,0 +1,43 @@
+import { tryGetContext } from "../context/stores.js";
+import { bumpSitemapVersion } from "./sitemap-cache.js";
+// Lifecycle actions whose payloads can change which URLs belong in a sitemap.
+// Firing any of them retires every cached sub-sitemap by bumping the version.
+const ENTITY_ACTIONS = [
+    "entry:published",
+    "entry:updated",
+    "entry:trashed",
+    "entry:restored",
+    "entry:deleted",
+    "term:created",
+    "term:updated",
+    "term:deleted",
+    "term:meta_changed",
+];
+// Subscribers get no context argument, so they resolve the per-request
+// `AppContext` from the request store; a fire outside a request frame is a
+// silent no-op.
+function bump() {
+    const ctx = tryGetContext();
+    if (!ctx)
+        return;
+    return bumpSitemapVersion(ctx);
+}
+/**
+ * Register core's sitemap cache-busting subscribers. Called at app boot
+ * alongside the other core hook registrations.
+ */
+export function registerCoreSitemapInvalidator(hooks) {
+    for (const action of ENTITY_ACTIONS) {
+        hooks.addAction(action, bump);
+    }
+    // A site-privacy toggle changes which URLs (if any) the sitemap may expose;
+    // the gate lives inside the cached generator, so the cache must be retired
+    // when the `site` group changes for it to take effect. Other settings groups
+    // don't affect sitemap output — skip them to avoid needless invalidation.
+    hooks.addAction("settings:group_changed", (changes) => {
+        if (changes.group !== "site")
+            return;
+        return bump();
+    });
+}
+//# sourceMappingURL=register-sitemap-invalidator.js.map

package/dist/seo/register-sitemap-invalidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-sitemap-invalidator.js","sourceRoot":"","sources":["../../src/seo/register-sitemap-invalidator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,cAAc,GAAG;IACrB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;CACX,CAAC;AAEX,uEAAuE;AACvE,2EAA2E;AAC3E,gBAAgB;AAChB,SAAS,IAAI;IACX,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAmB;IAChE,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,KAAK,CAAC,SAAS,CAAC,MAAe,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,0EAA0E;IAC1E,KAAK,CAAC,SAAS,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE;QACpD,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO;QACrC,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/seo/robots.d.ts

@@ -0,0 +1,20 @@
+import type { AppContext } from "../context/app.js";
+declare module "../hooks/types.js" {
+    interface FilterRegistry {
+        /**
+         * Adjust the generated `/robots.txt` body. The value filter for plugins
+         * (e.g. `@plumix/plugin-seo`) to add `Sitemap:` lines, crawl-delay, or
+         * per-agent rules without owning the route.
+         */
+        "seo:robots-txt": (body: string) => string | Promise<string>;
+    }
+}
+/**
+ * The `robots.txt` body. Default-public allows all crawling; a private site
+ * (the `site.public` setting off) disallows everything.
+ */
+export declare function buildRobotsTxt(options: {
+    readonly isPublic: boolean;
+}): string;
+export declare function handleRobotsTxt(ctx: AppContext): Promise<Response>;
+//# sourceMappingURL=robots.d.ts.map

package/dist/seo/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;WAIG;QACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KAC9D;CACF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,GAAG,MAAM,CAGT;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAUxE"}