@plumix/core 0.1.0

package/dist/seo/robots.js

@@ -0,0 +1,18 @@
+import { loadSiteSettings } from "./site-settings.js";
+/**
+ * The `robots.txt` body. Default-public allows all crawling; a private site
+ * (the `site.public` setting off) disallows everything.
+ */
+export function buildRobotsTxt(options) {
+    const rule = options.isPublic ? "Disallow:" : "Disallow: /";
+    return `User-agent: *\n${rule}\n`;
+}
+export async function handleRobotsTxt(ctx) {
+    const site = await loadSiteSettings(ctx);
+    const isPublic = site.public !== false;
+    const body = await ctx.hooks.applyFilter("seo:robots-txt", buildRobotsTxt({ isPublic }));
+    return new Response(body, {
+        headers: { "content-type": "text/plain; charset=utf-8" },
+    });
+}
+//# sourceMappingURL=robots.js.map

package/dist/seo/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/seo/robots.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAatD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAE9B;IACC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IAC5D,OAAO,kBAAkB,IAAI,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAe;IACnD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CACtC,gBAAgB,EAChB,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,CAC7B,CAAC;IACF,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/seo/site-settings.d.ts

@@ -0,0 +1,6 @@
+import type { AppContext } from "../context/app.js";
+/** The `site` settings group as a flat `key → value` bag (empty when unset). */
+export declare function loadSiteSettings(ctx: AppContext): Promise<Record<string, unknown>>;
+/** A settings value coerced to a non-empty string, or null. */
+export declare function nonEmpty(value: unknown): string | null;
+//# sourceMappingURL=site-settings.d.ts.map

package/dist/seo/site-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-settings.d.ts","sourceRoot":"","sources":["../../src/seo/site-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGlC;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEtD"}

package/dist/seo/site-settings.js

@@ -0,0 +1,11 @@
+import { settingsLoader } from "../template-deps-core.js";
+/** The `site` settings group as a flat `key → value` bag (empty when unset). */
+export async function loadSiteSettings(ctx) {
+    const groups = await settingsLoader(["site"], ctx);
+    return groups.site ?? {};
+}
+/** A settings value coerced to a non-empty string, or null. */
+export function nonEmpty(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=site-settings.js.map

package/dist/seo/site-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-settings.js","sourceRoot":"","sources":["../../src/seo/site-settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAe;IAEf,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/seo/sitemap-cache.d.ts

@@ -0,0 +1,20 @@
+import type { AppContext } from "../context/app.js";
+/**
+ * Read the current sitemap version straight from D1. The source of truth;
+ * `currentSitemapVersion` layers a Cache-API pointer over this to keep the
+ * read off D1 on the hot path.
+ */
+export declare function readSitemapVersion(ctx: AppContext): Promise<number>;
+/**
+ * Increment the version so every cached sub-sitemap key goes stale. Fired by
+ * the lifecycle-action subscriber on entry/term mutations. The increment is a
+ * single SQL statement, so concurrent bumps can't lose an increment.
+ */
+export declare function bumpSitemapVersion(ctx: AppContext): Promise<void>;
+/**
+ * Serve a sub-sitemap from the Cache API, keyed by `scope+page+version`, only
+ * regenerating on a miss. Falls back to per-request generation when no Cache
+ * API is present (tests, non-Workers runtimes).
+ */
+export declare function cachedSubSitemap(ctx: AppContext, scope: string, page: number, generate: () => Promise<Response>): Promise<Response>;
+//# sourceMappingURL=sitemap-cache.d.ts.map

package/dist/seo/sitemap-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-cache.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsCpD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE;AA6BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAChC,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/seo/sitemap-cache.js

@@ -0,0 +1,96 @@
+import { sql } from "drizzle-orm";
+import { and, eq } from "../db/index.js";
+import { settings } from "../db/schema/settings.js";
+// The version token lives in a `settings` row — D1 is strongly consistent
+// and already on every `ctx`, so a bump is visible to every isolate on its
+// next read. The token is embedded in the Cache API key, so bumping it makes
+// every prior sub-sitemap unreachable without a per-key purge (which the
+// Cache API doesn't offer).
+const VERSION_GROUP = "seo";
+const VERSION_KEY = "sitemap_version";
+// Synthetic, never-routed cache keys. The version pointer carries a short TTL
+// so each colo re-reads D1 at most once per window (a bump also deletes it for
+// immediate convergence in the writing colo); sub-sitemap bodies are keyed by
+// version, so a bump retires them logically (an old-version body lingers,
+// unreachable, until the platform evicts it).
+const CACHE_ORIGIN = "https://sitemap.plumix.internal";
+const VERSION_POINTER = `${CACHE_ORIGIN}/version`;
+const VERSION_POINTER_TTL_SECONDS = 60;
+function cacheStore() {
+    const store = globalThis.caches;
+    return store?.default ?? null;
+}
+function subSitemapKey(scope, page, version) {
+    return `${CACHE_ORIGIN}/sitemap-${scope}-${String(page)}.xml?v=${String(version)}`;
+}
+/**
+ * Read the current sitemap version straight from D1. The source of truth;
+ * `currentSitemapVersion` layers a Cache-API pointer over this to keep the
+ * read off D1 on the hot path.
+ */
+export async function readSitemapVersion(ctx) {
+    const [row] = await ctx.db
+        .select({ value: settings.value })
+        .from(settings)
+        .where(and(eq(settings.group, VERSION_GROUP), eq(settings.key, VERSION_KEY)));
+    return typeof row?.value === "number" ? row.value : 0;
+}
+/**
+ * Increment the version so every cached sub-sitemap key goes stale. Fired by
+ * the lifecycle-action subscriber on entry/term mutations. The increment is a
+ * single SQL statement, so concurrent bumps can't lose an increment.
+ */
+export async function bumpSitemapVersion(ctx) {
+    await ctx.db
+        .insert(settings)
+        .values({ group: VERSION_GROUP, key: VERSION_KEY, value: 1 })
+        .onConflictDoUpdate({
+        target: [settings.group, settings.key],
+        set: { value: sql `${settings.value} + 1` },
+    });
+    // Drop this colo's pointer so it re-reads the bumped version immediately;
+    // other colos converge when their pointer TTL lapses.
+    await cacheStore()?.delete(VERSION_POINTER);
+}
+/**
+ * The version to key cache entries by. Reads a Cache-API pointer first so the
+ * hot path stays off D1; falls back to D1 (and re-seeds the pointer) on a
+ * pointer miss, or straight to D1 when no Cache API is available.
+ */
+async function currentSitemapVersion(ctx) {
+    const store = cacheStore();
+    if (!store)
+        return readSitemapVersion(ctx);
+    const pointer = await store.match(VERSION_POINTER);
+    if (pointer) {
+        const parsed = Number(await pointer.text());
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    const version = await readSitemapVersion(ctx);
+    await store.put(VERSION_POINTER, new Response(String(version), {
+        headers: {
+            "cache-control": `max-age=${String(VERSION_POINTER_TTL_SECONDS)}`,
+        },
+    }));
+    return version;
+}
+/**
+ * Serve a sub-sitemap from the Cache API, keyed by `scope+page+version`, only
+ * regenerating on a miss. Falls back to per-request generation when no Cache
+ * API is present (tests, non-Workers runtimes).
+ */
+export async function cachedSubSitemap(ctx, scope, page, generate) {
+    const store = cacheStore();
+    if (!store)
+        return generate();
+    const version = await currentSitemapVersion(ctx);
+    const key = subSitemapKey(scope, page, version);
+    const hit = await store.match(key);
+    if (hit)
+        return hit;
+    const fresh = await generate();
+    await store.put(key, fresh.clone());
+    return fresh;
+}
+//# sourceMappingURL=sitemap-cache.js.map

package/dist/seo/sitemap-cache.js.map

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

package/dist/seo/sitemap.d.ts

@@ -0,0 +1,26 @@
+import type { AppContext } from "../context/app.js";
+export declare const SITEMAP_PAGE_SIZE = 1000;
+export interface SitemapUrl {
+    readonly loc: string;
+    readonly lastmod?: string;
+}
+declare module "../hooks/types.js" {
+    interface FilterRegistry {
+        /**
+         * Adjust a sub-sitemap's URL set before it's serialized — add, drop, or
+         * re-`lastmod` entries. Receives the scope (entry-type or taxonomy name).
+         */
+        "seo:sitemap:urls": (urls: readonly SitemapUrl[], scope: string) => readonly SitemapUrl[] | Promise<readonly SitemapUrl[]>;
+    }
+}
+export declare function renderSitemapIndex(locs: readonly string[]): string;
+export declare function renderSubSitemap(urls: readonly SitemapUrl[]): string;
+/**
+ * The published, public-type URLs for one sub-sitemap scope + page, passed
+ * through the `seo:sitemap:urls` filter. Returns null for an unknown / non-public
+ * scope, which the caller renders as an empty `<urlset>`.
+ */
+export declare function collectSitemapUrls(ctx: AppContext, scope: string, page: number): Promise<readonly SitemapUrl[] | null>;
+export declare function handleSitemapIndex(ctx: AppContext): Promise<Response>;
+export declare function handleSubSitemap(ctx: AppContext, scope: string, page: number): Promise<Response>;
+//# sourceMappingURL=sitemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAepD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;WAGG;QACH,kBAAkB,EAAE,CAClB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,KAAK,EAAE,MAAM,KACV,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;KAC7D;CACF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQlE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAWpE;AA6DD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC,CAavC;AAyCD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAI3E;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/seo/sitemap.js

@@ -0,0 +1,151 @@
+import { withBasePath } from "../base-path.js";
+import { and, eq, sql } from "../db/index.js";
+import { entries } from "../db/schema/entries.js";
+import { terms } from "../db/schema/terms.js";
+import { buildEntryPermalink, buildTermArchiveUrl, } from "../route/permalink.js";
+import { loadSiteSettings } from "./site-settings.js";
+import { cachedSubSitemap } from "./sitemap-cache.js";
+import { xmlEscape } from "./xml.js";
+// Well under the sitemaps.org 50k cap, and small enough to build + hold in
+// Worker memory per request.
+export const SITEMAP_PAGE_SIZE = 1000;
+export function renderSitemapIndex(locs) {
+    const body = locs
+        .map((loc) => `<sitemap><loc>${xmlEscape(loc)}</loc></sitemap>`)
+        .join("");
+    return (`<?xml version="1.0" encoding="UTF-8"?>` +
+        `<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${body}</sitemapindex>`);
+}
+export function renderSubSitemap(urls) {
+    const body = urls
+        .map(({ loc, lastmod }) => {
+        const mod = lastmod ? `<lastmod>${xmlEscape(lastmod)}</lastmod>` : "";
+        return `<url><loc>${xmlEscape(loc)}</loc>${mod}</url>`;
+    })
+        .join("");
+    return (`<?xml version="1.0" encoding="UTF-8"?>` +
+        `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${body}</urlset>`);
+}
+function offsetFor(page) {
+    return (page - 1) * SITEMAP_PAGE_SIZE;
+}
+async function entryUrls(ctx, type, page) {
+    const rows = await ctx.db
+        .select({
+        slug: entries.slug,
+        type: entries.type,
+        parentId: entries.parentId,
+        updatedAt: entries.updatedAt,
+    })
+        .from(entries)
+        .where(and(eq(entries.type, type), eq(entries.status, "published")))
+        .orderBy(entries.id)
+        .limit(SITEMAP_PAGE_SIZE)
+        .offset(offsetFor(page));
+    const urls = [];
+    for (const row of rows) {
+        const path = await buildEntryPermalink(ctx, row);
+        if (path === null)
+            continue;
+        urls.push({
+            loc: `${ctx.origin}${path}`,
+            lastmod: row.updatedAt.toISOString(),
+        });
+    }
+    return urls;
+}
+async function termUrls(ctx, taxonomy, page) {
+    const rows = await ctx.db
+        .select({
+        slug: terms.slug,
+        taxonomy: terms.taxonomy,
+        parentId: terms.parentId,
+    })
+        .from(terms)
+        .where(eq(terms.taxonomy, taxonomy))
+        .orderBy(terms.id)
+        .limit(SITEMAP_PAGE_SIZE)
+        .offset(offsetFor(page));
+    const urls = [];
+    for (const row of rows) {
+        const path = await buildTermArchiveUrl(ctx, row);
+        if (path !== null)
+            urls.push({ loc: `${ctx.origin}${path}` });
+    }
+    return urls;
+}
+/**
+ * The published, public-type URLs for one sub-sitemap scope + page, passed
+ * through the `seo:sitemap:urls` filter. Returns null for an unknown / non-public
+ * scope, which the caller renders as an empty `<urlset>`.
+ */
+export async function collectSitemapUrls(ctx, scope, page) {
+    const entryType = ctx.plugins.entryTypes.get(scope);
+    let urls = null;
+    if (entryType && entryType.isPublic !== false) {
+        urls = await entryUrls(ctx, scope, page);
+    }
+    else {
+        const taxonomy = ctx.plugins.termTaxonomies.get(scope);
+        if (taxonomy && taxonomy.isPublic !== false) {
+            urls = await termUrls(ctx, scope, page);
+        }
+    }
+    if (urls === null)
+        return null;
+    return ctx.hooks.applyFilter("seo:sitemap:urls", urls, scope);
+}
+async function sitemapIndexLocs(ctx) {
+    const locs = [];
+    const pushScope = (name, total) => {
+        const pages = Math.max(1, Math.ceil(total / SITEMAP_PAGE_SIZE));
+        for (let page = 1; total > 0 && page <= pages; page++) {
+            const path = `/sitemap-${name}-${String(page)}.xml`;
+            locs.push(`${ctx.origin}${withBasePath(path, ctx.basePath)}`);
+        }
+    };
+    for (const type of ctx.plugins.entryTypes.values()) {
+        if (type.isPublic === false)
+            continue;
+        const [row] = await ctx.db
+            .select({ n: sql `count(*)` })
+            .from(entries)
+            .where(and(eq(entries.type, type.name), eq(entries.status, "published")));
+        pushScope(type.name, Number(row?.n ?? 0));
+    }
+    for (const taxonomy of ctx.plugins.termTaxonomies.values()) {
+        if (taxonomy.isPublic === false)
+            continue;
+        const [row] = await ctx.db
+            .select({ n: sql `count(*)` })
+            .from(terms)
+            .where(eq(terms.taxonomy, taxonomy.name));
+        pushScope(taxonomy.name, Number(row?.n ?? 0));
+    }
+    return locs;
+}
+function xmlResponse(body) {
+    return new Response(body, {
+        headers: { "content-type": "application/xml; charset=utf-8" },
+    });
+}
+async function isPrivate(ctx) {
+    return (await loadSiteSettings(ctx)).public === false;
+}
+export async function handleSitemapIndex(ctx) {
+    // A private site is held out of search: emit an empty index.
+    const locs = (await isPrivate(ctx)) ? [] : await sitemapIndexLocs(ctx);
+    return xmlResponse(renderSitemapIndex(locs));
+}
+export function handleSubSitemap(ctx, scope, page) {
+    // The privacy gate and the URL scan both live inside the generator so a
+    // cache hit touches D1 zero times. A `settings:group_changed` bump retires
+    // the cache when the site flips private, keeping the gate honest.
+    return cachedSubSitemap(ctx, scope, page, async () => {
+        if (await isPrivate(ctx))
+            return xmlResponse(renderSubSitemap([]));
+        const urls = await collectSitemapUrls(ctx, scope, page);
+        return xmlResponse(renderSubSitemap(urls ?? []));
+    });
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/seo/sitemap.js.map

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

package/dist/seo/xml.d.ts

@@ -0,0 +1,3 @@
+/** Escape the five XML metacharacters for safe inclusion in element text. */
+export declare function xmlEscape(value: string): string;
+//# sourceMappingURL=xml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/seo/xml.ts"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/seo/xml.js

@@ -0,0 +1,12 @@
+const XML_ESCAPES = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&apos;",
+};
+/** Escape the five XML metacharacters for safe inclusion in element text. */
+export function xmlEscape(value) {
+    return value.replace(/[&<>"']/g, (char) => XML_ESCAPES[char] ?? char);
+}
+//# sourceMappingURL=xml.js.map

package/dist/seo/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/seo/xml.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;CACd,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/settings-core.d.ts

@@ -0,0 +1,49 @@
+import type { MutablePluginRegistry } from "./plugin/manifest.js";
+export declare const SITE_SETTINGS_DESCRIPTORS: {
+    readonly groupLabel: {
+        readonly id: "core.settings.site.label";
+        readonly message: "Site identity";
+    };
+    readonly groupDescription: {
+        readonly id: "core.settings.site.description";
+        readonly message: "Public-facing name, tagline, and social links.";
+    };
+    readonly title: {
+        readonly id: "core.settings.site.title";
+        readonly message: "Site title";
+    };
+    readonly tagline: {
+        readonly id: "core.settings.site.tagline";
+        readonly message: "Tagline";
+    };
+    readonly twitter: {
+        readonly id: "core.settings.site.twitter";
+        readonly message: "X (Twitter) URL";
+    };
+    readonly github: {
+        readonly id: "core.settings.site.github";
+        readonly message: "GitHub URL";
+    };
+    readonly mastodon: {
+        readonly id: "core.settings.site.mastodon";
+        readonly message: "Mastodon URL";
+    };
+    readonly ogImage: {
+        readonly id: "core.settings.site.default_og_image";
+        readonly message: "Default social image URL";
+    };
+    readonly publicSite: {
+        readonly id: "core.settings.site.public";
+        readonly message: "Allow search engines to index this site";
+    };
+    readonly pageLabel: {
+        readonly id: "core.settings.general.label";
+        readonly message: "General";
+    };
+    readonly pageDescription: {
+        readonly id: "core.settings.general.description";
+        readonly message: "Core site identity and metadata.";
+    };
+};
+export declare function registerCoreSettings(registry: MutablePluginRegistry): void;
+//# sourceMappingURL=settings-core.d.ts.map

package/dist/settings-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-core.d.ts","sourceRoot":"","sources":["../src/settings-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BgB,CAAC;AASvD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CA0E1E"}

package/dist/settings-core.js

@@ -0,0 +1,113 @@
+// Descriptors core renders for the built-in site settings. They resolve
+// inside the admin SPA via the manifest cascade (`i18n._`), so admin's
+// catalogs own the translations — `core-settings-i18n.ts` mirrors these
+// ids for extraction, lockstep-guarded. Exported to back that test.
+export const SITE_SETTINGS_DESCRIPTORS = {
+    groupLabel: {
+        id: "core.settings.site.label",
+        message: "Site identity",
+    },
+    groupDescription: {
+        id: "core.settings.site.description",
+        message: "Public-facing name, tagline, and social links.",
+    },
+    title: { id: "core.settings.site.title", message: "Site title" },
+    tagline: { id: "core.settings.site.tagline", message: "Tagline" },
+    twitter: { id: "core.settings.site.twitter", message: "X (Twitter) URL" },
+    github: { id: "core.settings.site.github", message: "GitHub URL" },
+    mastodon: { id: "core.settings.site.mastodon", message: "Mastodon URL" },
+    ogImage: {
+        id: "core.settings.site.default_og_image",
+        message: "Default social image URL",
+    },
+    publicSite: {
+        id: "core.settings.site.public",
+        message: "Allow search engines to index this site",
+    },
+    pageLabel: { id: "core.settings.general.label", message: "General" },
+    pageDescription: {
+        id: "core.settings.general.description",
+        message: "Core site identity and metadata.",
+    },
+};
+const D = SITE_SETTINGS_DESCRIPTORS;
+// Built-in site-identity settings. Seeded before plugin `setup()` (like
+// the core template deps / lookup adapters) so every install has a
+// canonical home for title / tagline / social links — themes read it via
+// the `settings` template dep (`defineTemplate({ settings: ["site"] })`)
+// and the future SEO plugin layers on top.
+export function registerCoreSettings(registry) {
+    registry.settingsGroups.set("site", {
+        name: "site",
+        registeredBy: null,
+        label: D.groupLabel,
+        description: D.groupDescription,
+        fields: [
+            {
+                key: "title",
+                type: "string",
+                inputType: "text",
+                label: D.title,
+                maxLength: 200,
+            },
+            {
+                key: "tagline",
+                type: "string",
+                inputType: "textarea",
+                label: D.tagline,
+                maxLength: 300,
+            },
+            // Social keys carry a `_url` suffix (unlike bare `title`/`tagline`)
+            // so theme + SEO consumers reading `settings.site.twitter_url` see
+            // the stored value's shape — a link, not a handle.
+            {
+                key: "twitter_url",
+                type: "string",
+                inputType: "url",
+                label: D.twitter,
+                maxLength: 300,
+            },
+            {
+                key: "github_url",
+                type: "string",
+                inputType: "url",
+                label: D.github,
+                maxLength: 300,
+            },
+            {
+                key: "mastodon_url",
+                type: "string",
+                inputType: "url",
+                label: D.mastodon,
+                maxLength: 300,
+            },
+            // Fallback Open Graph image for pages without their own; SEO defaults
+            // read it for `og:image`.
+            {
+                key: "default_og_image",
+                type: "string",
+                inputType: "url",
+                label: D.ogImage,
+                maxLength: 500,
+            },
+            // Site-wide indexing gate. Default-true; when off, SEO emits
+            // `noindex,nofollow` and `robots.txt` disallows all crawling.
+            {
+                key: "public",
+                type: "boolean",
+                inputType: "checkbox",
+                label: D.publicSite,
+                default: true,
+            },
+        ],
+    });
+    registry.settingsPages.set("general", {
+        name: "general",
+        registeredBy: null,
+        label: D.pageLabel,
+        description: D.pageDescription,
+        groups: ["site"],
+        priority: 10,
+    });
+}
+//# sourceMappingURL=settings-core.js.map

package/dist/settings-core.js.map

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

package/dist/slugify.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Transliterate a user-authored title or name into a URL-safe slug.
+ * Covers European (incl. diacritics), Cyrillic, Greek, Arabic, Turkish,
+ * and Vietnamese scripts — `"Новости"` → `"novosti"`, `"café"` →
+ * `"cafe"`. CJK and a few other scripts fall back to empty; the form's
+ * `slugSchema.minLength(1)` surfaces an inline error so the author
+ * types a slug manually instead of hitting a server rejection.
+ *
+ * Pure ASCII output (not preserved-Unicode) is the WordPress/Ghost
+ * default — URLs round-trip cleanly through every client (Slack, email,
+ * CLI, grep) rather than dealing with percent-encoding surprises.
+ */
+export declare function slugify(input: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/slugify.js

@@ -0,0 +1,17 @@
+import slugifyLib from "@sindresorhus/slugify";
+/**
+ * Transliterate a user-authored title or name into a URL-safe slug.
+ * Covers European (incl. diacritics), Cyrillic, Greek, Arabic, Turkish,
+ * and Vietnamese scripts — `"Новости"` → `"novosti"`, `"café"` →
+ * `"cafe"`. CJK and a few other scripts fall back to empty; the form's
+ * `slugSchema.minLength(1)` surfaces an inline error so the author
+ * types a slug manually instead of hitting a server rejection.
+ *
+ * Pure ASCII output (not preserved-Unicode) is the WordPress/Ghost
+ * default — URLs round-trip cleanly through every client (Slack, email,
+ * CLI, grep) rather than dealing with percent-encoding surprises.
+ */
+export function slugify(input) {
+    return slugifyLib(input);
+}
+//# sourceMappingURL=slugify.js.map

package/dist/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/template-deps-core.d.ts

@@ -0,0 +1,19 @@
+import type { AppContext } from "./context/app.js";
+import type { MutablePluginRegistry } from "./plugin/manifest.js";
+declare module "./template.js" {
+    interface TemplateDepRegistry {
+        settings: {
+            slug: string;
+            result: Record<string, unknown>;
+        };
+    }
+}
+/**
+ * Seed the plugin registry with built-in template deps before plugin
+ * `setup()` runs. Mirrors `registerCoreLookupAdapters` — core's slot
+ * lands first so a plugin `ctx.registerTemplateDep("settings", ...)`
+ * trips the boot-time collision guard.
+ */
+export declare function registerCoreTemplateDeps(registry: MutablePluginRegistry): void;
+export declare function settingsLoader(groups: readonly string[], ctx: AppContext): Promise<Record<string, Record<string, unknown>>>;
+//# sourceMappingURL=template-deps-core.d.ts.map

package/dist/template-deps-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-deps-core.d.ts","sourceRoot":"","sources":["../src/template-deps-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlE,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,mBAAmB;QAC3B,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KAC7D;CACF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAMN;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAiBlD"}