@softure-ai/blog 0.1.8 → 0.1.10

package/src/server/options.ts

@@ -1,7 +1,7 @@
 // The blog options, routes and copy of the running app, read from the configuration.
 import { getModule, getSiteUrls, type AnySoftureModule, type SoftureConfig } from "@softure-ai/core";
 import type { BlogMessages } from "../messages/index.js";
-import type { BlogOptions } from "../options.js";
+import { DEFAULT_OPEN_GRAPH_LOCALES, type BlogOptions } from "../options.js";
 import { getReservedSlugs, normalizeRoute, type BlogRoutes } from "../pages/paths.js";
 import { resolveQualitySettings, type QualitySettings } from "../quality/settings.js";
 
@@ -39,6 +39,19 @@ export function getBlogRoutes(config: SoftureConfig): BlogRoutes {
   return { index: read("index"), glossary: read("glossary"), method: read("method"), rss: read("rss") };
 }
 
+export interface BlogLocaleTags {
+  /** BCP-47: JSON-LD `inLanguage` and the feed's `<language>`. */
+  readonly bcp47: string;
+  /** `og:locale`, `language_TERRITORY`. */
+  readonly openGraph: string;
+}
+
+/** The app locale's language tags: the app's `locales` entry, else the bare code and `en_US` / `pl_PL`. */
+export function getBlogLocaleTags(config: SoftureConfig): BlogLocaleTags {
+  const tags = getBlogOptions(config).locales[config.locale];
+  return { bcp47: tags?.bcp47 ?? config.locale, openGraph: tags?.openGraph ?? DEFAULT_OPEN_GRAPH_LOCALES[config.locale] };
+}
+
 /** The path of the cache refresh route (`refreshBlogCache`), outside the pages' routes. */
 export function getBlogRefreshPath(config: SoftureConfig): string {
   const path = getBlogModule(config).routes.refresh;

package/src/ui/blog-listing.tsx

@@ -59,8 +59,8 @@ export function BlogListingView({ context, groups, termCount, timezone, cta }: B
       ) : (
         <div className="blog-groups">
           {groups.map((group) => {
-            const id = group.cluster === null ? undefined : getClusterAnchor(group.cluster);
-            const headingId = `${id ?? "cluster-other"}-heading`;
+            const id = group.cluster === null ? undefined : getClusterAnchor(group.cluster, context.clusterAnchorPrefix);
+            const headingId = `${id ?? getClusterAnchor("other", context.clusterAnchorPrefix)}-heading`;
             return (
               <section key={group.cluster ?? ""} id={id} aria-labelledby={headingId} className="blog-group">
                 <h2 id={headingId} className="blog-group-title">

package/src/ui/page-context.ts

@@ -14,4 +14,6 @@ export interface BlogPageContext {
   readonly brand: string | null;
   /** The note under every text in the locale; `null` without one. */
   readonly disclaimer: string | null;
+  /** The listing's cluster anchor prefix (`<prefix>-<cluster>`); `cluster` when left out. */
+  readonly clusterAnchorPrefix?: string;
 }