@softure-ai/blog 0.0.0-stage → 0.1.5

package/dist/server/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/server/health.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,6DAA6D;AAC7D,OAAO,EAAE,EAAE,EAAoB,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAgB,KAAK,EAAE,OAAO,EAAE,EAAE;IAC/D,iFAAiF;IACjF,MAAM,EAAE,GAAG,OAAO,CAAC,EAAe,CAAC;IACnC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,qCAAqC,CAAC,CAAC;IAC3D,OAAO,EAAE,EAAE,CAAC;AACd,CAAC,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,10 @@
+export { computeContentHash, parseArticleFile, type ArticleFileResult, type ParseArticleFileOptions } from "../content/article-file.js";
+export { findArticleBySlug, findSlugRedirect, getPublishedArticle, listArticles, publishArticle, type BlogContext, type ListArticlesFilter, } from "../db/articles.js";
+export { runBlogPublish, type ArticleFile, type BlogPublishRun, type PublishedChange, type PublishGate, type PublishProblem, type RunBlogPublishOptions, } from "../db/publish-run.js";
+export { checkArticlesTable } from "./health.js";
+export { getBlogMessages, getBlogOptions, getBlogRefreshPath, getBlogReservedSlugs, getBlogRoutes, getQualitySettings } from "./options.js";
+export * from "../discovery/index.js";
+export * from "../pages/index.js";
+export * from "../quality/index.js";
+export * from "../render/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACxI,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5I,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,13 @@
+// Server-only API of @softure-ai/blog. Store functions receive the module context
+// (`{ db, clock, config }`) and never read request scope; the renderer is pure. `next/*` imports are
+// not allowed here.
+export { computeContentHash, parseArticleFile } from "../content/article-file.js";
+export { findArticleBySlug, findSlugRedirect, getPublishedArticle, listArticles, publishArticle, } from "../db/articles.js";
+export { runBlogPublish, } from "../db/publish-run.js";
+export { checkArticlesTable } from "./health.js";
+export { getBlogMessages, getBlogOptions, getBlogRefreshPath, getBlogReservedSlugs, getBlogRoutes, getQualitySettings } from "./options.js";
+export * from "../discovery/index.js";
+export * from "../pages/index.js";
+export * from "../quality/index.js";
+export * from "../render/index.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,qGAAqG;AACrG,oBAAoB;AACpB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAwD,MAAM,4BAA4B,CAAC;AACxI,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,GAOf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5I,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/server/og-fonts.d.ts

@@ -0,0 +1,24 @@
+import type { OgFontSource, OgFontWeight } from "../options.js";
+/** A font for the card, as `ImageResponse` takes it. */
+export interface OgFont {
+    readonly name: string;
+    readonly data: ArrayBuffer;
+    readonly weight?: OgFontWeight;
+    readonly style?: "normal" | "italic";
+}
+export type OgFontsResult = {
+    readonly ok: true;
+    readonly fonts: readonly OgFont[];
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+export interface OgFontLoaderOptions {
+    /** Where a relative path starts: the app's root. */
+    readonly root: string;
+    readonly readFile?: (path: string) => Promise<Uint8Array>;
+    readonly fetchImpl?: typeof fetch;
+}
+/** A loader with its own cache, keyed by the resolved path or URL. */
+export declare function createOgFontLoader(options: OgFontLoaderOptions): (fonts: readonly OgFontSource[]) => Promise<OgFontsResult>;
+//# sourceMappingURL=og-fonts.d.ts.map

package/dist/server/og-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-fonts.d.ts","sourceRoot":"","sources":["../../src/server/og-fonts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhE,wDAAwD;AACxD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAItI,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAwBD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAmD3H"}

package/dist/server/og-fonts.js

@@ -0,0 +1,85 @@
+// The loader of the brand's fonts for the article OG card (`blog({ brand: { fonts } })`): each source
+// is read once, checked to be a font Satori draws (.ttf, .otf, .woff; not .woff2), and kept for the
+// life of the loader. A failed read is not kept, so a fixed file is picked up by the next call. It
+// imports no Next code: the card's route (`@softure-ai/blog/next`) and `softure-blog check` share it.
+import { readFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+/** The first four bytes of each font format Satori parses. */
+const FONT_SIGNATURES = ["wOFF", "OTTO", "\u0000\u0001\u0000\u0000", "true"];
+const WOFF2_SIGNATURE = "wOF2";
+function toArrayBuffer(bytes) {
+    const copy = new Uint8Array(bytes.byteLength);
+    copy.set(bytes);
+    return copy.buffer;
+}
+function checkFontBytes(bytes) {
+    const signature = String.fromCharCode(...bytes.subarray(0, 4));
+    if (signature === WOFF2_SIGNATURE)
+        return { ok: false, reason: "a .woff2 font, which the card cannot read; use the .woff or .ttf file" };
+    if (!FONT_SIGNATURES.includes(signature))
+        return { ok: false, reason: "not a .ttf, .otf or .woff font" };
+    return { ok: true, data: toArrayBuffer(bytes) };
+}
+function getErrorCode(error) {
+    if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string")
+        return error.code;
+    return error instanceof Error ? error.message : String(error);
+}
+/** A loader with its own cache, keyed by the resolved path or URL. */
+export function createOgFontLoader(options) {
+    const read = options.readFile ?? readFile;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const cache = new Map();
+    async function readSource(location, isUrl) {
+        if (!isUrl) {
+            try {
+                return checkFontBytes(await read(location));
+            }
+            catch (error) {
+                return { ok: false, reason: `the file cannot be read (${getErrorCode(error)})` };
+            }
+        }
+        let response;
+        try {
+            response = await fetchImpl(location);
+        }
+        catch (error) {
+            return { ok: false, reason: `the request failed (${getErrorCode(error)})` };
+        }
+        if (!response.ok)
+            return { ok: false, reason: `the server answered ${response.status}` };
+        try {
+            return checkFontBytes(new Uint8Array(await response.arrayBuffer()));
+        }
+        catch (error) {
+            return { ok: false, reason: `the answer could not be read (${getErrorCode(error)})` };
+        }
+    }
+    function getBytes(location, isUrl) {
+        const cached = cache.get(location);
+        if (cached !== undefined)
+            return cached;
+        const pending = readSource(location, isUrl).then((result) => {
+            if (!result.ok)
+                cache.delete(location);
+            return result;
+        });
+        cache.set(location, pending);
+        return pending;
+    }
+    return async (fonts) => {
+        const located = fonts.map((font) => {
+            const isUrl = font.src.startsWith("https://");
+            return { font, isUrl, location: isUrl || isAbsolute(font.src) ? font.src : resolve(options.root, font.src) };
+        });
+        const results = await Promise.all(located.map(async (entry) => ({ ...entry, result: await getBytes(entry.location, entry.isUrl) })));
+        const loaded = [];
+        for (const [index, { font, location, result }] of results.entries()) {
+            if (!result.ok)
+                return { ok: false, error: `Blog OG card: brand.fonts[${index}] "${font.src}": ${result.reason} (${location}).` };
+            loaded.push({ name: font.name, data: result.data, weight: font.weight, style: font.style });
+        }
+        return { ok: true, fonts: loaded };
+    };
+}
+//# sourceMappingURL=og-fonts.js.map

package/dist/server/og-fonts.js.map

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

package/dist/server/options.d.ts

@@ -0,0 +1,17 @@
+import { type SoftureConfig } from "@softure-ai/core";
+import type { BlogMessages } from "../messages/index.js";
+import type { BlogOptions } from "../options.js";
+import { type BlogRoutes } from "../pages/paths.js";
+import { type QualitySettings } from "../quality/settings.js";
+export declare function getBlogOptions(config: SoftureConfig): BlogOptions;
+/** The module's copy in the app's locale, with the app's overrides applied. */
+export declare function getBlogMessages(config: SoftureConfig): BlogMessages;
+/** The module's routes with the app's overrides applied, without trailing slashes. */
+export declare function getBlogRoutes(config: SoftureConfig): BlogRoutes;
+/** The path of the cache refresh route (`refreshBlogCache`), outside the pages' routes. */
+export declare function getBlogRefreshPath(config: SoftureConfig): string;
+/** The slugs no article may take: the app's `reservedSlugs` and the static pages under the listing. */
+export declare function getBlogReservedSlugs(config: SoftureConfig): string[];
+/** The quality gate's settings, or `null` when the app turned the gate off (`quality: false`). */
+export declare function getQualitySettings(config: SoftureConfig): QualitySettings | null;
+//# sourceMappingURL=options.d.ts.map

package/dist/server/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAatF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAGjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAGnE;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAS/D;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAGpE;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAKhF"}

package/dist/server/options.js

@@ -0,0 +1,56 @@
+// The blog options, routes and copy of the running app, read from the configuration.
+import { getModule, getSiteUrls } from "@softure-ai/core";
+import { getReservedSlugs, normalizeRoute } from "../pages/paths.js";
+import { resolveQualitySettings } from "../quality/settings.js";
+const MODULE_ID = "blog";
+/** The enabled module. Throws when the app did not enable it: calling its functions then is a bug. */
+function getBlogModule(config) {
+    const module = getModule(config, MODULE_ID);
+    if (module === undefined) {
+        throw new Error("@softure-ai/blog: the module is not enabled; add blog() to modules in softure.config.ts");
+    }
+    return module;
+}
+export function getBlogOptions(config) {
+    // The module factory parsed these options with blogOptionsSchema.
+    return getBlogModule(config).options;
+}
+/** The module's copy in the app's locale, with the app's overrides applied. */
+export function getBlogMessages(config) {
+    // The module factory merged the dictionaries; their shape is the module's own.
+    return getBlogModule(config).messages[config.locale];
+}
+/** The module's routes with the app's overrides applied, without trailing slashes. */
+export function getBlogRoutes(config) {
+    const routes = getBlogModule(config).routes;
+    const read = (name) => {
+        const path = routes[name];
+        // The manifest declares every route, so a missing one means a broken module definition.
+        if (path === undefined)
+            throw new Error(`@softure-ai/blog: route "${name}" is missing from the module manifest`);
+        return normalizeRoute(path);
+    };
+    return { index: read("index"), glossary: read("glossary"), method: read("method"), rss: read("rss") };
+}
+/** The path of the cache refresh route (`refreshBlogCache`), outside the pages' routes. */
+export function getBlogRefreshPath(config) {
+    const path = getBlogModule(config).routes.refresh;
+    // The manifest declares the route, so a missing one means a broken module definition.
+    if (path === undefined)
+        throw new Error('@softure-ai/blog: route "refresh" is missing from the module manifest');
+    return normalizeRoute(path);
+}
+/** The slugs no article may take: the app's `reservedSlugs` and the static pages under the listing. */
+export function getBlogReservedSlugs(config) {
+    const options = getBlogOptions(config);
+    return getReservedSlugs(getBlogRoutes(config), options);
+}
+/** The quality gate's settings, or `null` when the app turned the gate off (`quality: false`). */
+export function getQualitySettings(config) {
+    const { quality, images } = getBlogOptions(config);
+    if (quality === false)
+        return null;
+    const site = { appOrigin: config.appOrigin, siteOrigin: getSiteUrls(config).origin, timezone: config.timezone };
+    return resolveQualitySettings(quality, site, images ?? null);
+}
+//# sourceMappingURL=options.js.map

package/dist/server/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,SAAS,EAAE,WAAW,EAA6C,MAAM,kBAAkB,CAAC;AAGrG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAwB,MAAM,wBAAwB,CAAC;AAEtF,MAAM,SAAS,GAAG,MAAM,CAAC;AAEzB,sGAAsG;AACtG,SAAS,aAAa,CAAC,MAAqB;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,kEAAkE;IAClE,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,OAAsB,CAAC;AACtD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,+EAA+E;IAC/E,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAiB,CAAC;AACvE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,IAAsB,EAAU,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,wFAAwF;QACxF,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,uCAAuC,CAAC,CAAC;QACjH,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACxG,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAClD,sFAAsF;IACtF,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACjH,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,gBAAgB,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChH,OAAO,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/sitemap.d.ts

@@ -0,0 +1,11 @@
+import { type SoftureConfig } from "@softure-ai/core";
+import { type BlogSitemapEntry } from "./discovery/sitemap.js";
+/** The listing, the articles, the glossary, its terms and the method page, each dated by its last content change. */
+export declare function readBlogSitemap(config: SoftureConfig): Promise<BlogSitemapEntry[]>;
+/**
+ * `seo({ sitemap: { contributors: [blogSitemap()] } })`. The config is read when the sitemap is
+ * requested (it is still being defined when this is called); pass one to read another. A failed read
+ * throws; seo logs it and serves the rest. Mount `app/sitemap.ts` with `dynamic = "force-dynamic"`.
+ */
+export declare function blogSitemap(config?: SoftureConfig): () => Promise<BlogSitemapEntry[]>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAInE,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,qHAAqH;AACrH,wBAAsB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAcxF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAErF"}

package/dist/sitemap.js

@@ -0,0 +1,35 @@
+// The sitemap contributor for `@softure-ai/seo`, in the root entry because `softure.config.ts` imports
+// it. That file also loads in plain Node and in bundles made outside Next (`softure migrate`, the blog
+// command, a container's migrate script), so nothing here may reach `next/*`: the entries come from
+// one query on the shared database, not from the pages' Next cache. Crawlers read a sitemap rarely.
+import { systemClock } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { getSharedDatabase } from "@softure-ai/db";
+import { listArticles } from "./db/articles.js";
+import { getBlogSitemapEntries } from "./discovery/sitemap.js";
+import { getBlogOptions, getBlogRoutes } from "./server/options.js";
+/** The listing, the articles, the glossary, its terms and the method page, each dated by its last content change. */
+export async function readBlogSitemap(config) {
+    if (config.database === null) {
+        // Unreachable for a validated config: the module has a database schema.
+        throw new Error("@softure-ai/blog: softure.config.ts has no database; the blog sitemap needs one");
+    }
+    const { db } = await getSharedDatabase(config.database.url);
+    const texts = await listArticles({ db, clock: systemClock, config });
+    const routes = getBlogRoutes(config);
+    return getBlogSitemapEntries({
+        articles: texts.filter((text) => text.kind === "article"),
+        terms: texts.filter((text) => text.kind === "term"),
+        routes,
+        methodPath: getBlogOptions(config).methodPage ? routes.method : null,
+    });
+}
+/**
+ * `seo({ sitemap: { contributors: [blogSitemap()] } })`. The config is read when the sitemap is
+ * requested (it is still being defined when this is called); pass one to read another. A failed read
+ * throws; seo logs it and serves the rest. Mount `app/sitemap.ts` with `dynamic = "force-dynamic"`.
+ */
+export function blogSitemap(config) {
+    return () => readBlogSitemap(config ?? getSoftureConfig());
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,uGAAuG;AACvG,oGAAoG;AACpG,oGAAoG;AACpG,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAyB,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpE,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAqB;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,wEAAwE;QACxE,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,qBAAqB,CAAC;QAC3B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;QACzD,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;QACnD,MAAM;QACN,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;KACrE,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/ui/blog-article.d.ts

@@ -0,0 +1,49 @@
+import type { ReactNode } from "react";
+import type { BlogArticle, BlogSource } from "../contract.js";
+import { type ArticleDates } from "../pages/dates.js";
+import type { Crumb } from "../pages/listing.js";
+import type { ArticleHeading, ArticleSegment } from "../render/render-article.js";
+import type { BlogPageContext } from "./page-context.js";
+export interface RenderedBody {
+    readonly segments: readonly ArticleSegment<ReactNode>[];
+    readonly headings: readonly ArticleHeading[];
+    readonly readingMinutes: number;
+}
+export interface BlogArticleViewProps {
+    readonly context: BlogPageContext;
+    readonly article: BlogArticle;
+    readonly dates: ArticleDates;
+    readonly body: RenderedBody;
+    readonly crumbs: readonly Crumb[];
+    /** From `serializeJsonLd(getArticleJsonLd(…))`. */
+    readonly jsonLd: string;
+    /** The app's call to action, right after the text. */
+    readonly cta?: ReactNode;
+    /** The app's block under the article, e.g. `<Waitlist placement="blog" />`. */
+    readonly afterArticle?: ReactNode;
+    /** "Read next" (`getRelatedArticles`); none or empty: no section. */
+    readonly related?: readonly Pick<BlogArticle, "id" | "slug" | "title" | "description">[];
+}
+/** The body in order: HTML segments from the renderer, node segments (the app's block plugins) as they are. */
+export declare function ArticleBody({ segments }: {
+    readonly segments: readonly ArticleSegment<ReactNode>[];
+}): import("react").JSX.Element;
+export declare function ArticleDatesList({ dates, readingMinutes, context }: {
+    readonly dates: ArticleDates;
+    readonly readingMinutes?: number;
+    readonly context: BlogPageContext;
+}): import("react").JSX.Element;
+export declare function SourceList({ sources, heading }: {
+    readonly sources: readonly BlogSource[];
+    readonly heading: string;
+}): import("react").JSX.Element | null;
+/**
+ * "Read next": texts of the same cluster, then of others, chosen without manual lists. After the app's
+ * call to action: the text has just made its point, so the app's next step comes first, this second.
+ */
+export declare function RelatedList({ articles, context }: {
+    readonly articles: readonly Pick<BlogArticle, "id" | "slug" | "title" | "description">[];
+    readonly context: BlogPageContext;
+}): import("react").JSX.Element | null;
+export declare function BlogArticleView({ context, article, dates, body, crumbs, jsonLd, cta, afterArticle, related }: BlogArticleViewProps): import("react").JSX.Element;
+//# sourceMappingURL=blog-article.d.ts.map

package/dist/ui/blog-article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-article.d.ts","sourceRoot":"","sources":["../../src/ui/blog-article.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC;CAC1F;AAED,+GAA+G;AAC/G,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,CAAC,SAAS,CAAC,EAAE,CAAA;CAAE,+BAepG;AAaD,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,+BAezK;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,sCAgBrH;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,sCAiBjL;AAqBD,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,OAAY,EAAE,EAAE,oBAAoB,+BA2CvI"}

package/dist/ui/blog-article.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The article page, answer first: crumbs, title, description and dates; then the "in short" box, the
+// contents (from two level-2 headings up), the body, questions and answers, sources, the signature
+// and the disclaimer; then the app's slots. Everything is server HTML: a crawler without JavaScript
+// gets the whole text.
+import { formatMessage } from "@softure-ai/core";
+import { formatDay } from "../pages/dates.js";
+import { getArticlePath } from "../pages/paths.js";
+import { BlogFooterNote, BlogLayout, JsonLdScript } from "./blog-layout.js";
+/** The body in order: HTML segments from the renderer, node segments (the app's block plugins) as they are. */
+export function ArticleBody({ segments }) {
+    return (_jsx("div", { className: "blog-body", children: segments.map((segment, index) => segment.kind === "html" ? (_jsx("div", { className: "blog-segment", dangerouslySetInnerHTML: { __html: segment.html } }, index)) : (_jsx("div", { className: "blog-segment", "data-block": segment.type, children: segment.node }, index))) }));
+}
+function DateItem({ label, day, context }) {
+    return (_jsxs("div", { children: [_jsx("dt", { children: label }), _jsx("dd", { children: _jsx("time", { dateTime: day, children: formatDay(day, context.locale) }) })] }));
+}
+export function ArticleDatesList({ dates, readingMinutes, context }) {
+    const copy = context.messages.pages;
+    return (_jsxs("dl", { className: "blog-dates", children: [_jsx(DateItem, { label: copy.published, day: dates.published, context: context }), dates.updated === null ? null : _jsx(DateItem, { label: copy.updated, day: dates.updated, context: context }), _jsx(DateItem, { label: copy.currentAsOf, day: dates.currentAsOf, context: context }), readingMinutes === undefined ? null : (_jsxs("div", { children: [_jsx("dt", { className: "blog-visually-hidden", children: copy.readingTimeLabel }), _jsx("dd", { children: formatMessage(copy.readingTime, { minutes: readingMinutes }) })] }))] }));
+}
+export function SourceList({ sources, heading }) {
+    if (sources.length === 0)
+        return null;
+    return (_jsxs("section", { "aria-labelledby": "blog-sources", className: "blog-section blog-sources", children: [_jsx("h2", { id: "blog-sources", children: heading }), _jsx("ul", { children: sources.map((source) => (_jsx("li", { children: _jsx("a", { href: source.url, rel: "noopener noreferrer", target: "_blank", children: source.name }) }, source.url))) })] }));
+}
+/**
+ * "Read next": texts of the same cluster, then of others, chosen without manual lists. After the app's
+ * call to action: the text has just made its point, so the app's next step comes first, this second.
+ */
+export function RelatedList({ articles, context }) {
+    if (articles.length === 0)
+        return null;
+    return (_jsxs("section", { "aria-labelledby": "blog-related", className: "blog-section blog-related", children: [_jsx("h2", { id: "blog-related", children: context.messages.pages.readNext }), _jsx("ul", { children: articles.map((article) => (_jsxs("li", { children: [_jsx("h3", { children: _jsx("a", { href: getArticlePath(context.routes, article.slug), children: article.title }) }), _jsx("p", { children: article.description })] }, article.id))) })] }));
+}
+function Contents({ headings, label }) {
+    const sections = headings.filter((heading) => heading.level === 2);
+    if (sections.length < 2)
+        return null;
+    return (_jsxs("nav", { "aria-labelledby": "blog-contents", className: "blog-contents", children: [_jsx("p", { id: "blog-contents", className: "blog-contents-title", children: label }), _jsx("ol", { children: sections.map((heading) => (_jsx("li", { children: _jsx("a", { href: `#${heading.id}`, children: heading.text }) }, heading.id))) })] }));
+}
+export function BlogArticleView({ context, article, dates, body, crumbs, jsonLd, cta, afterArticle, related = [] }) {
+    const copy = context.messages.pages;
+    return (_jsxs(BlogLayout, { context: context, title: article.title, lead: article.description, crumbs: crumbs, meta: _jsx(ArticleDatesList, { dates: dates, readingMinutes: body.readingMinutes, context: context }), children: [_jsx(JsonLdScript, { json: jsonLd }), _jsxs("div", { className: "blog-article-layout", children: [_jsx(Contents, { headings: body.headings, label: copy.contents }), _jsxs("article", { className: "blog-article", children: [article.summary === null ? null : (_jsxs("aside", { "aria-labelledby": "blog-summary", className: "blog-summary", children: [_jsx("h2", { id: "blog-summary", children: copy.summary }), _jsx("p", { children: article.summary })] })), _jsx(ArticleBody, { segments: body.segments }), article.faq.length === 0 ? null : (_jsxs("section", { "aria-labelledby": "blog-faq", className: "blog-section blog-faq", children: [_jsx("h2", { id: "blog-faq", children: copy.faq }), _jsx("dl", { children: article.faq.map((entry) => (_jsxs("div", { children: [_jsx("dt", { children: entry.question }), _jsx("dd", { children: entry.answer })] }, entry.question))) })] })), _jsx(SourceList, { sources: article.sources, heading: copy.sources }), _jsx(BlogFooterNote, { context: context })] })] }), cta === undefined ? null : _jsx("div", { className: "blog-slot", children: cta }), _jsx(RelatedList, { articles: related, context: context }), afterArticle === undefined ? null : _jsx("div", { className: "blog-slot", children: afterArticle })] }));
+}
+//# sourceMappingURL=blog-article.js.map

package/dist/ui/blog-article.js.map

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

package/dist/ui/blog-glossary.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+import type { BlogArticle } from "../contract.js";
+import { type ArticleDates } from "../pages/dates.js";
+import type { Crumb } from "../pages/listing.js";
+import { type RenderedBody } from "./blog-article.js";
+import type { BlogPageContext } from "./page-context.js";
+export interface GlossaryIndexViewProps {
+    readonly context: BlogPageContext;
+    /** Already sorted (`sortTerms`). */
+    readonly terms: readonly BlogArticle[];
+    /** `null` with no terms: an empty set says nothing. */
+    readonly jsonLd: string | null;
+}
+export declare function GlossaryIndexView({ context, terms, jsonLd }: GlossaryIndexViewProps): import("react").JSX.Element;
+export interface GlossaryTermViewProps {
+    readonly context: BlogPageContext;
+    readonly term: BlogArticle;
+    readonly dates: ArticleDates;
+    readonly body: RenderedBody;
+    readonly crumbs: readonly Crumb[];
+    readonly jsonLd: string;
+    /** Published articles whose text links this term. */
+    readonly articles: readonly BlogArticle[];
+    readonly cta?: ReactNode;
+}
+export declare function GlossaryTermView({ context, term, dates, body, crumbs, jsonLd, articles, cta }: GlossaryTermViewProps): import("react").JSX.Element;
+//# sourceMappingURL=blog-glossary.d.ts.map

package/dist/ui/blog-glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-glossary.d.ts","sourceRoot":"","sources":["../../src/ui/blog-glossary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,sBAAsB,+BA0BnF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,qBAAqB,+BA4CpH"}

package/dist/ui/blog-glossary.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatDay } from "../pages/dates.js";
+import { getArticlePath, getTermPath } from "../pages/paths.js";
+import { ArticleBody, SourceList } from "./blog-article.js";
+import { BlogFooterNote, BlogLayout, JsonLdScript } from "./blog-layout.js";
+export function GlossaryIndexView({ context, terms, jsonLd }) {
+    const copy = context.messages.glossary;
+    const crumbs = [
+        { name: context.messages.pages.blogTitle, path: context.routes.index },
+        { name: copy.title, path: context.routes.glossary },
+    ];
+    return (_jsxs(BlogLayout, { context: context, title: copy.title, lead: copy.description, crumbs: crumbs, children: [jsonLd === null ? null : _jsx(JsonLdScript, { json: jsonLd }), terms.length === 0 ? (_jsx("p", { className: "blog-empty", children: copy.empty })) : (_jsx("dl", { className: "blog-terms", children: terms.map((term) => (_jsxs("div", { children: [_jsx("dt", { children: _jsx("a", { href: getTermPath(context.routes, term.slug), children: term.title }) }), _jsx("dd", { children: term.description })] }, term.id))) })), _jsx(BlogFooterNote, { context: context })] }));
+}
+export function GlossaryTermView({ context, term, dates, body, crumbs, jsonLd, articles, cta }) {
+    const pages = context.messages.pages;
+    const copy = context.messages.glossary;
+    const meta = (_jsxs("dl", { className: "blog-dates", children: [_jsxs("div", { children: [_jsx("dt", { children: pages.currentAsOf }), _jsx("dd", { children: _jsx("time", { dateTime: dates.currentAsOf, children: formatDay(dates.currentAsOf, context.locale) }) })] }), dates.updated === null ? null : (_jsxs("div", { children: [_jsx("dt", { children: pages.updated }), _jsx("dd", { children: _jsx("time", { dateTime: dates.updated, children: formatDay(dates.updated, context.locale) }) })] }))] }));
+    return (_jsxs(BlogLayout, { context: context, title: term.title, lead: term.description, crumbs: crumbs, meta: meta, children: [_jsx(JsonLdScript, { json: jsonLd }), _jsxs("article", { className: "blog-article", children: [_jsx(ArticleBody, { segments: body.segments }), _jsx(SourceList, { sources: term.sources, heading: pages.sources }), articles.length === 0 ? null : (_jsxs("section", { "aria-labelledby": "blog-explained-in", className: "blog-section blog-explained-in", children: [_jsx("h2", { id: "blog-explained-in", children: copy.explainedIn }), _jsx("ul", { children: articles.map((article) => (_jsx("li", { children: _jsx("a", { href: getArticlePath(context.routes, article.slug), children: article.title }) }, article.id))) })] })), _jsx(BlogFooterNote, { context: context, extraLink: { href: context.routes.glossary, label: copy.allTerms } })] }), cta === undefined ? null : _jsx("div", { className: "blog-slot", children: cta })] }));
+}
+//# sourceMappingURL=blog-glossary.js.map

package/dist/ui/blog-glossary.js.map

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

package/dist/ui/blog-layout.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+import type { Crumb } from "../pages/listing.js";
+import type { BlogPageContext } from "./page-context.js";
+export interface BlogLayoutProps {
+    readonly context: BlogPageContext;
+    readonly title: string;
+    readonly lead?: string;
+    /** Crumbs up to the page itself; the last one is announced, not shown. */
+    readonly crumbs?: readonly Crumb[];
+    /** Under the title: dates, reading time. */
+    readonly meta?: ReactNode;
+    readonly children: ReactNode;
+}
+export declare function Breadcrumbs({ crumbs, label }: {
+    readonly crumbs: readonly Crumb[];
+    readonly label: string;
+}): import("react").JSX.Element;
+export declare function BlogLayout({ context, title, lead, crumbs, meta, children }: BlogLayoutProps): import("react").JSX.Element;
+/** The signature and the method link under a text, then the disclaimer. */
+export declare function BlogFooterNote({ context, extraLink }: {
+    readonly context: BlogPageContext;
+    readonly extraLink?: {
+        readonly href: string;
+        readonly label: string;
+    };
+}): import("react").JSX.Element;
+/** Structured data for search engines and assistants; `json` comes from `serializeJsonLd`. */
+export declare function JsonLdScript({ json }: {
+    readonly json: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=blog-layout.d.ts.map

package/dist/ui/blog-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-layout.d.ts","sourceRoot":"","sources":["../../src/ui/blog-layout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,+BAqB3G;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,eAAe,+BAY3F;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,+BA2BnK;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,+BAE/D"}

package/dist/ui/blog-layout.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The frame of every blog page: crumbs, the title with its lead, an optional line under it (dates),
+// then the content. Links are plain anchors: the pages render on the server and need no client router.
+import { formatMessage } from "@softure-ai/core";
+export function Breadcrumbs({ crumbs, label }) {
+    return (_jsx("nav", { "aria-label": label, className: "blog-crumbs", children: _jsx("ol", { children: crumbs.map((crumb, index) => index === crumbs.length - 1 ? (_jsx("li", { className: "blog-visually-hidden", "aria-current": "page", children: crumb.name }, crumb.path)) : (_jsxs("li", { children: [_jsx("a", { href: crumb.path, children: crumb.name }), _jsx("span", { "aria-hidden": "true", className: "blog-crumbs-separator", children: "›" })] }, crumb.path))) }) }));
+}
+export function BlogLayout({ context, title, lead, crumbs, meta, children }) {
+    return (_jsxs("main", { className: "blog-page", children: [_jsxs("header", { className: "blog-header", children: [crumbs !== undefined && crumbs.length > 1 ? _jsx(Breadcrumbs, { crumbs: crumbs, label: context.messages.pages.breadcrumbs }) : null, _jsx("h1", { className: "blog-title", children: title }), lead === undefined ? null : _jsx("p", { className: "blog-lead", children: lead }), meta] }), children] }));
+}
+/** The signature and the method link under a text, then the disclaimer. */
+export function BlogFooterNote({ context, extraLink }) {
+    const copy = context.messages.pages;
+    const links = [
+        ...(extraLink === undefined ? [] : [extraLink]),
+        ...(context.methodPath === null ? [] : [{ href: context.methodPath, label: copy.methodLink }]),
+    ];
+    const hasSignature = context.brand !== null;
+    return (_jsxs("footer", { className: "blog-footer-note", children: [hasSignature || links.length > 0 ? (_jsxs("p", { className: "blog-signature", children: [context.brand === null ? null : _jsx("strong", { children: formatMessage(copy.signature, { brand: context.brand }) }), links.map((link, index) => (_jsxs("span", { children: [hasSignature || index > 0 ? _jsx("span", { "aria-hidden": "true", children: " · " }) : null, _jsx("a", { href: link.href, children: link.label })] }, link.href)))] })) : null, context.disclaimer === null ? null : (_jsx("aside", { "aria-label": copy.disclaimerLabel, className: "blog-disclaimer", children: _jsx("p", { children: context.disclaimer }) }))] }));
+}
+/** Structured data for search engines and assistants; `json` comes from `serializeJsonLd`. */
+export function JsonLdScript({ json }) {
+    return _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: json } });
+}
+//# sourceMappingURL=blog-layout.js.map

package/dist/ui/blog-layout.js.map

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

package/dist/ui/blog-listing.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+import type { BlogArticle } from "../contract.js";
+import { type ClusterGroup } from "../pages/listing.js";
+import type { BlogPageContext } from "./page-context.js";
+export interface BlogListingViewProps {
+    readonly context: BlogPageContext;
+    readonly groups: readonly ClusterGroup<BlogArticle>[];
+    /** Published glossary terms; the glossary link shows when there is at least one. */
+    readonly termCount: number;
+    readonly timezone: string;
+    /** The app's call to action under the cards. */
+    readonly cta?: ReactNode;
+}
+export declare function BlogListingView({ context, groups, termCount, timezone, cta }: BlogListingViewProps): import("react").JSX.Element;
+//# sourceMappingURL=blog-listing.d.ts.map

package/dist/ui/blog-listing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-listing.d.ts","sourceRoot":"","sources":["../../src/ui/blog-listing.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAI1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;IACtD,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAC1B;AA+BD,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,oBAAoB,+BA0ClG"}