@aotter/mantle-web 0.1.0-alpha.10

package/dist/service/PublicPathResolver.js

@@ -0,0 +1,36 @@
+import { toUrlLocale } from "@aotter/mantle-spec";
+export function entrySlug(entry) {
+    const fromData = entry.data["slug"];
+    if (typeof fromData === "string" && /^[a-z0-9][a-z0-9-]*$/.test(fromData)) {
+        return fromData;
+    }
+    return entry.id;
+}
+export function entryPublicPath(entry) {
+    const slug = entrySlug(entry);
+    if (entry.locale)
+        return `/${toUrlLocale(entry.locale)}/${entry.collection}/${slug}`;
+    return `/${entry.collection}/${slug}`;
+}
+export function createPublicPathResolver(config) {
+    const routes = config.collectionRoutes;
+    return {
+        forEntry(entry) {
+            const route = routes[entry.collection];
+            if (!route || route.segment === null)
+                return null;
+            const slug = entrySlug({ id: entry.id, data: entry.data });
+            const locale = entry.locale ? toUrlLocale(entry.locale) : "";
+            const localePrefix = locale ? `/${locale}` : "";
+            if (route.homeSlug && slug === route.homeSlug) {
+                return localePrefix || "/";
+            }
+            const segment = route.segment;
+            return segment ? `${localePrefix}/${segment}/${slug}` : `${localePrefix}/${slug}`;
+        },
+        routeFor(collection) {
+            return routes[collection];
+        },
+    };
+}
+//# sourceMappingURL=PublicPathResolver.js.map

package/dist/service/PublicPathResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicPathResolver.js","sourceRoot":"","sources":["../../src/service/PublicPathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AAE9D,MAAM,UAAU,SAAS,CAAC,KAAoD;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;IACrF,OAAO,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC;AA2CD,MAAM,UAAU,wBAAwB,CACtC,MAAgC;IAEhC,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACvC,OAAO;QACL,QAAQ,CAAC,KAAY;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAClD,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC9C,OAAO,YAAY,IAAI,GAAG,CAAC;YAC7B,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,IAAI,EAAE,CAAC;QACpF,CAAC;QACD,QAAQ,CAAC,UAAkB;YACzB,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/service/SeoMetaComposer.d.ts

@@ -0,0 +1,61 @@
+import { type Entry } from "@aotter/mantle-spec";
+import type { SeoMeta } from "../model/SeoMeta.js";
+import type { WebSiteConfig } from "../model/WebSiteConfig.js";
+/**
+ * Pure composer for SEO + AEO meta blocks emitted on every public
+ * entry page. Carries the conventions a consumer otherwise re-invents
+ * — canonical, hreflang siblings, the `.md` mirror alternate that
+ * lets LLM crawlers grab clean markdown, og: + twitter card, JSON-LD
+ * structured data.
+ *
+ * The composer is pure — no I/O, no DB. The caller resolves the
+ * sibling translations (for hreflang) and passes them in. See
+ * `ComposeEntrySeoMetaUseCase` for the wired version that does the
+ * sibling-read.
+ *
+ * The shape of the result lives in `domain/model/SeoMeta` so
+ * `TemplateRegistry`'s `EntryContext.seo` can reference it without
+ * pulling service code into model.
+ */
+export type { SeoMeta } from "../model/SeoMeta.js";
+export interface SiblingTranslation {
+    readonly locale: string;
+    readonly publicPath: string;
+}
+export interface ComposeEntrySeoMetaArgs {
+    readonly entry: Entry;
+    readonly site: WebSiteConfig;
+    /** The current entry's public path (already includes locale prefix).
+     *  Composer prepends `site.origin` to absolutize. */
+    readonly publicPath: string;
+    /** Optional sibling translations for hreflang. The current entry's
+     *  locale entry is added by the composer if not already present. */
+    readonly siblings?: ReadonlyArray<SiblingTranslation>;
+    /** og:type. Defaults to `article` when the entry has a `publishedAt`
+     *  (or `updatedAt`) field, `website` otherwise. */
+    readonly type?: "article" | "website";
+    /** Public-route locale for non-localized entries mounted under a locale URL. */
+    readonly locale?: string;
+}
+export declare function composeEntrySeoMeta(args: ComposeEntrySeoMetaArgs): SeoMeta;
+export interface ComposePageSeoMetaArgs {
+    readonly site: WebSiteConfig;
+    readonly locale: string;
+    readonly publicPath: string;
+    readonly title?: string;
+    readonly description?: string | null;
+    readonly markdown: boolean;
+    readonly pathForLocale: (locale: string) => string;
+}
+/** SEO for public home/list pages that are not represented by one Entry. */
+export declare function composePageSeoMeta(args: ComposePageSeoMetaArgs): SeoMeta;
+/**
+ * Render the SEO meta block as an HTML fragment. Templates embed this
+ * verbatim inside `<head>` via `raw(renderSeoTagsHtml(seo))`.
+ *
+ * Order matters slightly for crawlers — canonical first, alternates
+ * (markdown then hreflang) before og:/twitter so the discoverability
+ * bones land before the rich-preview block.
+ */
+export declare function renderSeoTagsHtml(meta: SeoMeta): string;
+//# sourceMappingURL=SeoMetaComposer.d.ts.map

package/dist/service/SeoMetaComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoMetaComposer.d.ts","sourceRoot":"","sources":["../../src/service/SeoMetaComposer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK/D;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B;yDACqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;wEACoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACtD;uDACmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAkD1E;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAiDxE;AAmFD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgDvD"}

package/dist/service/SeoMetaComposer.js

@@ -0,0 +1,213 @@
+import { toUrlLocale } from "@aotter/mantle-spec";
+import { absoluteUrl, appendMarkdownExt } from "./AbsoluteUrl.js";
+import { escapeHtml as escapeAttr } from "./HtmlEscaping.js";
+import { getEntryDescription, hasMarkdownBody } from "./MarkdownSerializer.js";
+export function composeEntrySeoMeta(args) {
+    const { entry, site, publicPath, siblings = [], type } = args;
+    const data = entry.data;
+    const canonical = absoluteUrl(site.origin, publicPath);
+    const alternateMarkdown = hasMarkdownBody(entry) ? appendMarkdownExt(canonical) : null;
+    const title = stringField(data, "title") ?? site.title;
+    const description = getEntryDescription(entry) ?? site.description ?? null;
+    const image = stringField(data, "coverUrl") ?? stringField(data, "ogImage") ?? null;
+    const ogType = type ?? (hasArticleSignal(entry) ? "article" : "website");
+    const entryLocale = args.locale ?? entry.locale ?? site.canonicalLocale ?? "en";
+    const hreflangs = buildHreflangs({
+        site,
+        currentLocale: entryLocale,
+        currentPublicPath: publicPath,
+        siblings,
+    });
+    return {
+        canonical,
+        alternateMarkdown,
+        hreflangs,
+        description: description ?? null,
+        og: {
+            type: ogType,
+            url: canonical,
+            title,
+            siteName: site.title || site.brand,
+            description: description ?? null,
+            image,
+            locale: entryLocale,
+        },
+        twitter: {
+            card: image ? "summary_large_image" : "summary",
+            title,
+            description: description ?? null,
+            image,
+        },
+        jsonLd: buildJsonLd({
+            ogType,
+            title,
+            description,
+            canonical,
+            image,
+            data,
+            site,
+            locale: entryLocale,
+        }),
+    };
+}
+/** SEO for public home/list pages that are not represented by one Entry. */
+export function composePageSeoMeta(args) {
+    const { site, locale, publicPath, pathForLocale } = args;
+    const canonical = absoluteUrl(site.origin, publicPath);
+    const title = args.title ?? site.title;
+    const description = args.description ?? site.description ?? null;
+    const hreflangs = [
+        ...site.locales.map((candidate) => ({
+            locale: candidate,
+            href: absoluteUrl(site.origin, pathForLocale(candidate)),
+        })),
+        {
+            locale: "x-default",
+            href: absoluteUrl(site.origin, pathForLocale(site.canonicalLocale ?? site.locales[0] ?? locale)),
+        },
+    ];
+    return {
+        canonical,
+        alternateMarkdown: args.markdown ? appendMarkdownExt(canonical) : null,
+        hreflangs,
+        description,
+        og: {
+            type: "website",
+            url: canonical,
+            title,
+            siteName: site.title || site.brand,
+            description,
+            image: null,
+            locale,
+        },
+        twitter: {
+            card: "summary",
+            title,
+            description,
+            image: null,
+        },
+        jsonLd: buildJsonLd({
+            ogType: "website",
+            title,
+            description,
+            canonical,
+            image: null,
+            data: {},
+            site,
+            locale,
+        }),
+    };
+}
+function buildHreflangs(args) {
+    const { site, currentLocale, currentPublicPath, siblings } = args;
+    const out = [];
+    const seen = new Set();
+    const push = (locale, path) => {
+        const key = locale.toLowerCase();
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push({ locale, href: absoluteUrl(site.origin, path) });
+    };
+    push(currentLocale, currentPublicPath);
+    for (const s of siblings)
+        push(s.locale, s.publicPath);
+    // x-default points at the canonical-locale variant when known,
+    // falling back to the current entry's URL otherwise. Search engines
+    // expect this row alongside the per-locale ones.
+    const canonicalSibling = siblings.find((s) => site.canonicalLocale && s.locale.toLowerCase() === site.canonicalLocale.toLowerCase());
+    out.push({
+        locale: "x-default",
+        href: absoluteUrl(site.origin, canonicalSibling?.publicPath ?? currentPublicPath),
+    });
+    return out;
+}
+function buildJsonLd(args) {
+    const { ogType, title, description, canonical, image, data, site, locale } = args;
+    const publishedAtMs = numericField(data, "publishedAt");
+    const updatedAtMs = numericField(data, "updatedAt");
+    const base = {
+        "@context": "https://schema.org",
+        "@type": ogType === "article" ? "Article" : "WebPage",
+        headline: title,
+        name: title,
+        url: canonical,
+        description: description ?? undefined,
+        image: image ?? undefined,
+        inLanguage: locale,
+        publisher: site.title || site.brand
+            ? {
+                "@type": "Organization",
+                name: site.title || site.brand,
+            }
+            : undefined,
+        datePublished: publishedAtMs ? new Date(publishedAtMs).toISOString() : undefined,
+        dateModified: updatedAtMs ? new Date(updatedAtMs).toISOString() : undefined,
+    };
+    // Drop undefined keys so JSON.stringify produces a clean object.
+    return Object.fromEntries(Object.entries(base).filter(([, v]) => v !== undefined));
+}
+function stringField(data, key) {
+    const v = data[key];
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+function numericField(data, key) {
+    const v = data[key];
+    return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+function hasArticleSignal(entry) {
+    return typeof entry.data["publishedAt"] === "number" || hasMarkdownBody(entry);
+}
+/**
+ * Render the SEO meta block as an HTML fragment. Templates embed this
+ * verbatim inside `<head>` via `raw(renderSeoTagsHtml(seo))`.
+ *
+ * Order matters slightly for crawlers — canonical first, alternates
+ * (markdown then hreflang) before og:/twitter so the discoverability
+ * bones land before the rich-preview block.
+ */
+export function renderSeoTagsHtml(meta) {
+    const parts = [];
+    parts.push(`<link rel="canonical" href="${escapeAttr(meta.canonical)}">`);
+    if (meta.alternateMarkdown) {
+        parts.push(`<link rel="alternate" type="text/markdown" href="${escapeAttr(meta.alternateMarkdown)}">`);
+    }
+    for (const h of meta.hreflangs) {
+        parts.push(`<link rel="alternate" hreflang="${escapeAttr(h.locale)}" href="${escapeAttr(h.href)}">`);
+    }
+    if (meta.description) {
+        parts.push(`<meta name="description" content="${escapeAttr(meta.description)}">`);
+    }
+    parts.push(`<meta name="generator" content="mantle">`);
+    parts.push(`<meta property="og:type" content="${escapeAttr(meta.og.type)}">`);
+    parts.push(`<meta property="og:url" content="${escapeAttr(meta.og.url)}">`);
+    parts.push(`<meta property="og:title" content="${escapeAttr(meta.og.title)}">`);
+    if (meta.og.siteName) {
+        parts.push(`<meta property="og:site_name" content="${escapeAttr(meta.og.siteName)}">`);
+    }
+    if (meta.og.description) {
+        parts.push(`<meta property="og:description" content="${escapeAttr(meta.og.description)}">`);
+    }
+    if (meta.og.image) {
+        parts.push(`<meta property="og:image" content="${escapeAttr(meta.og.image)}">`);
+    }
+    parts.push(`<meta property="og:locale" content="${escapeAttr(toUrlLocale(meta.og.locale))}">`);
+    parts.push(`<meta name="twitter:card" content="${escapeAttr(meta.twitter.card)}">`);
+    parts.push(`<meta name="twitter:title" content="${escapeAttr(meta.twitter.title)}">`);
+    if (meta.twitter.description) {
+        parts.push(`<meta name="twitter:description" content="${escapeAttr(meta.twitter.description)}">`);
+    }
+    if (meta.twitter.image) {
+        parts.push(`<meta name="twitter:image" content="${escapeAttr(meta.twitter.image)}">`);
+    }
+    if (meta.jsonLd) {
+        parts.push(`<script type="application/ld+json">${escapeJsonLd(meta.jsonLd)}</script>`);
+    }
+    return parts.join("\n");
+}
+function escapeJsonLd(obj) {
+    // `</script>` inside JSON-LD is the only nested-script pitfall;
+    // escaping the closing `</` keeps the embedded JSON strict-parseable.
+    return JSON.stringify(obj).replace(/<\//g, "<\\/");
+}
+//# sourceMappingURL=SeoMetaComposer.js.map

package/dist/service/SeoMetaComposer.js.map

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

package/dist/service/SitemapSerializer.d.ts

@@ -0,0 +1,20 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { WebSiteConfig } from "../model/WebSiteConfig.js";
+/**
+ * Hreflang alternates are deferred to v0.1.x (need cross-locale entry
+ * pairing first); only minimal `loc + lastmod` shipped.
+ *
+ * Entries arrive pre-mapped from storage row to public path — the
+ * caller (`ComposeSitemapUseCase`) decides how a (collection, slug,
+ * locale) row surfaces under the consumer's routing.
+ */
+export interface SitemapEntry {
+    readonly entry?: Entry;
+    readonly path: string;
+}
+export interface SitemapInput {
+    readonly site: WebSiteConfig;
+    readonly entries: readonly SitemapEntry[];
+}
+export declare function serializeSitemap(input: SitemapInput): string;
+//# sourceMappingURL=SitemapSerializer.d.ts.map

package/dist/service/SitemapSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SitemapSerializer.d.ts","sourceRoot":"","sources":["../../src/service/SitemapSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAgB5D"}

package/dist/service/SitemapSerializer.js

@@ -0,0 +1,27 @@
+import { absoluteUrl } from "./AbsoluteUrl.js";
+export function serializeSitemap(input) {
+    const { site, entries } = input;
+    const out = [];
+    out.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    out.push(`<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">`);
+    for (const { entry, path } of entries) {
+        const loc = absoluteUrl(site.origin ?? "", path);
+        out.push("  <url>");
+        out.push(`    <loc>${escapeXml(loc)}</loc>`);
+        if (entry?.updatedAt) {
+            out.push(`    <lastmod>${new Date(entry.updatedAt).toISOString()}</lastmod>`);
+        }
+        out.push("  </url>");
+    }
+    out.push("</urlset>");
+    return out.join("\n") + "\n";
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=SitemapSerializer.js.map

package/dist/service/SitemapSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SitemapSerializer.js","sourceRoot":"","sources":["../../src/service/SitemapSerializer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAoB/C,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACnD,GAAG,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IACzE,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAChF,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/service/io/MediaAssetReferences.d.ts

@@ -0,0 +1,15 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { MediaAsset } from "@aotter/mantle-runtime";
+export interface MediaAssetResolver {
+    resolveMany(ids: readonly string[]): Promise<ReadonlyMap<string, MediaAsset>>;
+}
+/**
+ * Extract media asset references from entry data by convention.
+ * Starters use `coverAssetId`, `imageAssetId`, nested `{ assetId }`, etc.
+ * The schema-level source of truth remains `x-mantle-ref: media_assets`;
+ * this convention keeps the render path schema-agnostic until the
+ * manifest compiler exposes field metadata at runtime.
+ */
+export declare function collectMediaAssetIds(value: unknown): readonly string[];
+export declare function resolveMediaAssetsForEntries(resolver: MediaAssetResolver | null, entries: readonly Entry[]): Promise<ReadonlyMap<string, MediaAsset> | undefined>;
+//# sourceMappingURL=MediaAssetReferences.d.ts.map

package/dist/service/io/MediaAssetReferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaAssetReferences.d.ts","sourceRoot":"","sources":["../../../src/service/io/MediaAssetReferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CAC/E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAItE;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,SAAS,KAAK,EAAE,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC,CAKtD"}

package/dist/service/io/MediaAssetReferences.js

@@ -0,0 +1,48 @@
+/**
+ * Extract media asset references from entry data by convention.
+ * Starters use `coverAssetId`, `imageAssetId`, nested `{ assetId }`, etc.
+ * The schema-level source of truth remains `x-mantle-ref: media_assets`;
+ * this convention keeps the render path schema-agnostic until the
+ * manifest compiler exposes field metadata at runtime.
+ */
+export function collectMediaAssetIds(value) {
+    const out = [];
+    collect(value, out);
+    return [...new Set(out)];
+}
+export async function resolveMediaAssetsForEntries(resolver, entries) {
+    if (!resolver)
+        return undefined;
+    const ids = collectMediaAssetIds(entries.map((entry) => entry.data));
+    if (ids.length === 0)
+        return undefined;
+    return resolver.resolveMany(ids);
+}
+function collect(value, out) {
+    if (value == null)
+        return;
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collect(item, out);
+        return;
+    }
+    if (typeof value !== "object")
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        if (typeof child === "string" &&
+            (key === "assetId" || key.endsWith("AssetId")) &&
+            child.length > 0) {
+            out.push(child);
+            continue;
+        }
+        if (Array.isArray(child) && key.endsWith("AssetIds")) {
+            for (const item of child) {
+                if (typeof item === "string" && item.length > 0)
+                    out.push(item);
+            }
+            continue;
+        }
+        collect(child, out);
+    }
+}
+//# sourceMappingURL=MediaAssetReferences.js.map

package/dist/service/io/MediaAssetReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaAssetReferences.js","sourceRoot":"","sources":["../../../src/service/io/MediaAssetReferences.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,QAAmC,EACnC,OAAyB;IAEzB,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,GAAa;IAC5C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO;IAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC9C,KAAK,CAAC,MAAM,GAAG,CAAC,EAChB,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,CAAC;YACD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/usecase/ComposeEntrySeoMetaUseCase.d.ts

@@ -0,0 +1,29 @@
+import type { Entry } from "@aotter/mantle-spec";
+import type { EntryReader } from "@aotter/mantle-runtime";
+import type { WebSiteConfig } from "../model/WebSiteConfig.js";
+import { type SeoMeta } from "../service/SeoMetaComposer.js";
+import type { PublicPathResolver } from "../service/PublicPathResolver.js";
+import type { ComposeEntrySeoMetaRequest } from "../dto/ComposeEntrySeoMetaRequest.js";
+/**
+ * Compose the SEO/AEO meta block for an entry. Reads sibling
+ * translations from the DB (same collection, same slug, other
+ * locales) so hreflang links are accurate; calls the pure composer
+ * for the rest.
+ *
+ * "Same collection" is a deliberate simplification — works correctly
+ * for `post-translations`-style design where each locale has its own
+ * row in the same collection. Sites that split locales across
+ * collections (`posts-en`, `posts-zh`) need a custom resolver — out
+ * of scope for v0.1.
+ *
+ * Sibling lookup is one indexed `readEntryBySlug` per non-current
+ * locale — O(locales), not O(collection). Runs in parallel via
+ * `Promise.all`.
+ */
+export declare class ComposeEntrySeoMetaUseCase {
+    private readonly reader;
+    constructor(reader: EntryReader);
+    execute(request: ComposeEntrySeoMetaRequest): Promise<SeoMeta>;
+}
+export declare function composeSeoIfPathed(composer: Pick<ComposeEntrySeoMetaUseCase, "execute">, paths: PublicPathResolver | null, entry: Entry, site: WebSiteConfig, overrides?: Pick<ComposeEntrySeoMetaRequest, "publicPath" | "publicLocale" | "siblings">): Promise<SeoMeta | undefined>;
+//# sourceMappingURL=ComposeEntrySeoMetaUseCase.d.ts.map

package/dist/usecase/ComposeEntrySeoMetaUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeEntrySeoMetaUseCase.d.ts","sourceRoot":"","sources":["../../src/usecase/ComposeEntrySeoMetaUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAEL,KAAK,OAAO,EAEb,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;CAarE;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,SAAS,CAAC,EACrD,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAChC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,aAAa,EACnB,SAAS,GAAE,IAAI,CACb,0BAA0B,EAC1B,YAAY,GAAG,cAAc,GAAG,UAAU,CACtC,GACL,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAG9B"}

package/dist/usecase/ComposeEntrySeoMetaUseCase.js

@@ -0,0 +1,66 @@
+import { composeEntrySeoMeta, } from "../service/SeoMetaComposer.js";
+/**
+ * Compose the SEO/AEO meta block for an entry. Reads sibling
+ * translations from the DB (same collection, same slug, other
+ * locales) so hreflang links are accurate; calls the pure composer
+ * for the rest.
+ *
+ * "Same collection" is a deliberate simplification — works correctly
+ * for `post-translations`-style design where each locale has its own
+ * row in the same collection. Sites that split locales across
+ * collections (`posts-en`, `posts-zh`) need a custom resolver — out
+ * of scope for v0.1.
+ *
+ * Sibling lookup is one indexed `readEntryBySlug` per non-current
+ * locale — O(locales), not O(collection). Runs in parallel via
+ * `Promise.all`.
+ */
+export class ComposeEntrySeoMetaUseCase {
+    reader;
+    constructor(reader) {
+        this.reader = reader;
+    }
+    async execute(request) {
+        const { entry, site, paths, type } = request;
+        const publicPath = request.publicPath ?? paths.forEntry(entry) ?? "";
+        const siblings = request.siblings ?? await readSiblings(this.reader, entry, site, paths);
+        return composeEntrySeoMeta({
+            entry,
+            site,
+            publicPath,
+            siblings,
+            type,
+            locale: request.publicLocale,
+        });
+    }
+}
+export async function composeSeoIfPathed(composer, paths, entry, site, overrides = {}) {
+    if (!paths || !(overrides.publicPath ?? paths.forEntry(entry)))
+        return undefined;
+    return composer.execute({ entry, site, paths, ...overrides });
+}
+async function readSiblings(reader, current, site, paths) {
+    const slug = current.data["slug"];
+    if (typeof slug !== "string" || slug.length === 0)
+        return [];
+    if (site.locales.length <= 1)
+        return [];
+    const currentKey = current.locale?.toLowerCase();
+    const targetLocales = site.locales.filter((l) => l.toLowerCase() !== currentKey);
+    const lookups = await Promise.all(targetLocales.map((locale) => reader.readBySlug({
+        collection: current.collection,
+        slug,
+        locale,
+        status: "published",
+    }).then((e) => ({ locale, entry: e }))));
+    const out = [];
+    for (const { locale, entry } of lookups) {
+        if (!entry)
+            continue;
+        const path = paths.forEntry(entry);
+        if (path)
+            out.push({ locale, publicPath: path });
+    }
+    return out;
+}
+//# sourceMappingURL=ComposeEntrySeoMetaUseCase.js.map

package/dist/usecase/ComposeEntrySeoMetaUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeEntrySeoMetaUseCase.js","sourceRoot":"","sources":["../../src/usecase/ComposeEntrySeoMetaUseCase.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,GAGpB,MAAM,+BAA+B,CAAC;AAIvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,OAAO,CAAC,OAAmC;QAC/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACzF,OAAO,mBAAmB,CAAC;YACzB,KAAK;YACL,IAAI;YACJ,UAAU;YACV,QAAQ;YACR,IAAI;YACJ,MAAM,EAAE,OAAO,CAAC,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAqD,EACrD,KAAgC,EAChC,KAAY,EACZ,IAAmB,EACnB,YAGI,EAAE;IAEN,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAmB,EACnB,OAAc,EACd,IAAmB,EACnB,KAAyB;IAEzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IACjD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3B,MAAM,CAAC,UAAU,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CACvC,CACF,CAAC;IACF,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/usecase/ComposeLlmsTxtUseCase.d.ts

@@ -0,0 +1,18 @@
+import type { EntryReader } from "@aotter/mantle-runtime";
+import type { PublicPathResolver } from "../service/PublicPathResolver.js";
+import type { ComposeLlmsTxtRequest } from "../dto/ComposeLlmsTxtRequest.js";
+/**
+ * Compose a `/llms.txt` body from currently-published entries.
+ *
+ *   - locale: string  → entries with `data.locale === locale`
+ *   - locale: null    → non-localized entries only. Consumers that want
+ *                       a cross-locale aggregate at the root URL should
+ *                       iterate site.locales themselves and concat.
+ */
+export declare class ComposeLlmsTxtUseCase {
+    private readonly reader;
+    private readonly paths;
+    constructor(reader: EntryReader, paths: PublicPathResolver | null);
+    execute(request: ComposeLlmsTxtRequest): Promise<string | null>;
+}
+//# sourceMappingURL=ComposeLlmsTxtUseCase.d.ts.map

package/dist/usecase/ComposeLlmsTxtUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeLlmsTxtUseCase.d.ts","sourceRoot":"","sources":["../../src/usecase/ComposeLlmsTxtUseCase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAG7C,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAiBtE"}

package/dist/usecase/ComposeLlmsTxtUseCase.js

@@ -0,0 +1,47 @@
+import { serializeLlmsTxt } from "../service/MarkdownSerializer.js";
+/**
+ * Compose a `/llms.txt` body from currently-published entries.
+ *
+ *   - locale: string  → entries with `data.locale === locale`
+ *   - locale: null    → non-localized entries only. Consumers that want
+ *                       a cross-locale aggregate at the root URL should
+ *                       iterate site.locales themselves and concat.
+ */
+export class ComposeLlmsTxtUseCase {
+    reader;
+    paths;
+    constructor(reader, paths) {
+        this.reader = reader;
+        this.paths = paths;
+    }
+    async execute(request) {
+        if (!this.paths)
+            return null;
+        const query = (locale) => this.reader.readPublished({
+            locale,
+            collection: request.collection,
+        });
+        const entries = request.locale !== null && request.includeUnlocalized
+            ? (await Promise.all([query(request.locale), query(null)])).flat()
+            : await query(request.locale);
+        const grouped = groupByCollection(entries);
+        return serializeLlmsTxt({
+            site: request.site,
+            locale: request.locale ?? "",
+            entriesByCollection: grouped,
+            pathFor: request.pathFor ?? ((entry) => this.paths.forEntry(entry)),
+        });
+    }
+}
+function groupByCollection(entries) {
+    const out = new Map();
+    for (const e of entries) {
+        const arr = out.get(e.collection);
+        if (arr)
+            arr.push(e);
+        else
+            out.set(e.collection, [e]);
+    }
+    return out;
+}
+//# sourceMappingURL=ComposeLlmsTxtUseCase.js.map