@next-md-blog/core 1.0.7 → 1.1.0

package/dist/core/llms.d.ts

@@ -0,0 +1,34 @@
+/**
+ * llms.txt / llms-full.txt generators — see https://llmstxt.org
+ *
+ * These return plain markdown strings. App code wraps them in a route handler:
+ *
+ *   // app/llms.txt/route.ts
+ *   import { generateLlmsTxt } from '@next-md-blog/core';
+ *   export const dynamic = 'force-static';
+ *   export const revalidate = 3600;
+ *   export async function GET() {
+ *     const body = await generateLlmsTxt({ config, locales: ['en','fr'] });
+ *     return new Response(body, { headers: { 'content-type': 'text/plain' }});
+ *   }
+ */
+import type { Config } from './types.js';
+export interface LlmsTxtOptions {
+    config?: Config;
+    /** Locales to enumerate. Defaults to `[config.defaultLang ?? 'en']`. */
+    locales?: readonly string[];
+    /** Marks one locale as default (added to the heading). Defaults to `locales[0]`. */
+    defaultLocale?: string;
+    /** Override the site summary (defaults to siteName + siteUrl). */
+    summary?: string;
+}
+/**
+ * Generate the index `llms.txt` markdown: one section per locale listing posts.
+ */
+export declare function generateLlmsTxt(options?: LlmsTxtOptions): Promise<string>;
+/**
+ * Generate `llms-full.txt`: concatenated post bodies (default locale only,
+ * unless `locales` is overridden). Designed for LLM ingestion.
+ */
+export declare function generateLlmsFullTxt(options?: LlmsTxtOptions): Promise<string>;
+//# sourceMappingURL=llms.d.ts.map

package/dist/core/llms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/core/llms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAoB,MAAM,EAAE,MAAM,YAAY,CAAC;AAO3D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA+CjB"}

package/dist/core/llms.js

@@ -0,0 +1,109 @@
+import { getAllBlogPosts, getBlogPost } from './file-utils.js';
+import { resolveFrontmatterField } from './type-guards.js';
+import { getConfig } from './config.js';
+import { DEFAULT_SITE_NAME } from './constants.js';
+import { resolvePostUrlWithConfig } from './seo-utils.js';
+function postLine(post, siteUrl, config, locale) {
+    const title = post.frontmatter.title ?? post.slug;
+    const description = resolveFrontmatterField(['description', 'excerpt'], post.frontmatter) ?? '';
+    const url = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl, config, locale);
+    return `- [${title}](${url})${description ? `: ${description}` : ''}`;
+}
+/**
+ * Generate the index `llms.txt` markdown: one section per locale listing posts.
+ */
+export async function generateLlmsTxt(options = {}) {
+    const config = options.config || getConfig();
+    const siteName = config.siteName ?? DEFAULT_SITE_NAME;
+    const siteUrl = (config.siteUrl ?? '').replace(/\/$/, '');
+    const locales = options.locales ?? [config.defaultLang ?? 'en'];
+    const defaultLocale = options.defaultLocale ?? locales[0];
+    const lines = [];
+    lines.push(`# ${siteName}`);
+    lines.push('');
+    if (options.summary) {
+        lines.push(`> ${options.summary}`);
+    }
+    else if (siteUrl) {
+        lines.push(`> Canonical site: ${siteUrl}`);
+    }
+    lines.push('');
+    for (const locale of locales) {
+        let posts;
+        try {
+            posts = await getAllBlogPosts({ config, locale });
+        }
+        catch {
+            posts = [];
+        }
+        if (!posts.length)
+            continue;
+        const isDefault = locale === defaultLocale;
+        lines.push(`## Blog (${locale})${isDefault ? ' — default locale' : ''}`);
+        lines.push('');
+        for (const p of posts) {
+            lines.push(postLine(p, siteUrl, config, locale));
+        }
+        lines.push('');
+    }
+    if (siteUrl) {
+        lines.push('## Feeds');
+        lines.push('');
+        for (const locale of locales) {
+            lines.push(`- [RSS — ${locale}](${siteUrl}/${locale}/feed.xml)`);
+        }
+        lines.push('');
+        lines.push(`- [Full prose](${siteUrl}/llms-full.txt)`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate `llms-full.txt`: concatenated post bodies (default locale only,
+ * unless `locales` is overridden). Designed for LLM ingestion.
+ */
+export async function generateLlmsFullTxt(options = {}) {
+    const config = options.config || getConfig();
+    const siteName = config.siteName ?? DEFAULT_SITE_NAME;
+    const siteUrl = (config.siteUrl ?? '').replace(/\/$/, '');
+    const locales = options.locales ?? [config.defaultLang ?? 'en'];
+    const out = [];
+    out.push(`# ${siteName}`);
+    out.push('');
+    if (options.summary)
+        out.push(`> ${options.summary}`);
+    if (siteUrl)
+        out.push(`> Source: ${siteUrl}`);
+    out.push('');
+    for (const locale of locales) {
+        let metadata;
+        try {
+            metadata = await getAllBlogPosts({ config, locale });
+        }
+        catch {
+            metadata = [];
+        }
+        for (const m of metadata) {
+            const post = await getBlogPost(m.slug, { config, locale });
+            if (!post)
+                continue;
+            const url = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl, config, locale);
+            const title = post.frontmatter.title ?? post.slug;
+            out.push('---');
+            out.push('');
+            out.push(`# ${title}`);
+            out.push('');
+            if (url)
+                out.push(`Source: ${url}`);
+            const published = resolveFrontmatterField(['date'], post.frontmatter);
+            if (published)
+                out.push(`Published: ${published}`);
+            const updated = resolveFrontmatterField(['updated', 'modifiedDate'], post.frontmatter);
+            if (updated)
+                out.push(`Updated: ${updated}`);
+            out.push('');
+            out.push(post.content.trim());
+            out.push('');
+        }
+    }
+    return out.join('\n');
+}

package/dist/core/organization-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-schema.d.ts","sourceRoot":"","sources":["../../src/core/organization-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIzC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoC1F;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/F;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAM3F;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/F"}
+{"version":3,"file":"organization-schema.d.ts","sourceRoot":"","sources":["../../src/core/organization-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIzC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAmD1F;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/F;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAM3F;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/F"}

package/dist/core/organization-schema.js

@@ -57,8 +57,24 @@ export function buildOrganizationNode(config) {
             url: org.logo,
         };
     }
-    if (org?.sameAs && org.sameAs.length > 0) {
-        node.sameAs = org.sameAs.length === 1 ? org.sameAs[0] : org.sameAs;
+    if (org?.foundingDate)
+        node.foundingDate = org.foundingDate;
+    if (org?.founder) {
+        node.founder = { '@type': 'Person', name: org.founder };
+    }
+    if (org?.address && Object.values(org.address).some(Boolean)) {
+        node.address = { '@type': 'PostalAddress', ...org.address };
+    }
+    if (org?.contactPoint && Object.values(org.contactPoint).some(Boolean)) {
+        node.contactPoint = { '@type': 'ContactPoint', ...org.contactPoint };
+    }
+    // Merge wikidata into sameAs (deduplicated).
+    const sameAsList = [
+        ...(org?.sameAs ?? []),
+        ...(org?.wikidata ? [org.wikidata] : []),
+    ].filter((v, i, arr) => arr.indexOf(v) === i);
+    if (sameAsList.length > 0) {
+        node.sameAs = sameAsList.length === 1 ? sameAsList[0] : sameAsList;
     }
     return node;
 }

package/dist/core/queries.d.ts

@@ -0,0 +1,35 @@
+/**
+ * High-level query helpers built on top of getBlogPost / getAllBlogPosts.
+ *
+ * These cover the patterns app code keeps reinventing:
+ *  - looking up the same slug across every locale (for hreflang)
+ *  - filtering posts by author or series
+ *  - enumerating slugs for `generateStaticParams`
+ */
+import type { BlogPost, BlogPostMetadata, GetBlogPostOptions } from './types.js';
+export declare function slugifyAuthor(name: string): string;
+export declare function slugifySeries(value: string): string;
+/**
+ * Collect every author name referenced in a post's frontmatter (`author` and `authors`).
+ */
+export declare function authorNamesFromFrontmatter(fm: Record<string, unknown>): string[];
+/**
+ * Look up the same slug across every locale. Returned map preserves locale insertion order.
+ * Useful for building `alternates.languages` in `generateMetadata` without writing a loop.
+ */
+export declare function getPostInAllLocales(slug: string, locales: readonly string[], options?: Omit<GetBlogPostOptions, 'locale'>): Promise<Map<string, BlogPost | null>>;
+/**
+ * Returns posts authored (or co-authored) by `authorSlug`. Slugification matches
+ * `slugifyAuthor` so the same convention is used everywhere.
+ */
+export declare function getPostsByAuthor(authorSlug: string, options?: GetBlogPostOptions): Promise<BlogPostMetadata[]>;
+/**
+ * Returns posts that share a `series` frontmatter value. Sorted by `seriesOrder`,
+ * falling back to publish date (ascending).
+ */
+export declare function getPostsBySeries(seriesSlug: string, options?: GetBlogPostOptions): Promise<BlogPostMetadata[]>;
+/** Enumerate every author slug across the provided locales (or the default locale only). */
+export declare function getAllAuthorSlugs(options?: GetBlogPostOptions, locales?: readonly string[]): Promise<string[]>;
+/** Enumerate every series slug across the provided locales. */
+export declare function getAllSeriesSlugs(options?: GetBlogPostOptions, locales?: readonly string[]): Promise<string[]>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/core/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/core/queries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAWD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,MAAM,EAAE,CAoBV;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAC/C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAWvC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB7B;AAED,4FAA4F;AAC5F,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,kBAAuB,EAChC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,kBAAuB,EAChC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB"}

package/dist/core/queries.js

@@ -0,0 +1,138 @@
+import { getAllBlogPosts, getBlogPost } from './file-utils.js';
+import { resolveFrontmatterField } from './type-guards.js';
+export function slugifyAuthor(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/[^\p{Letter}\p{Number}\s-]/gu, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-');
+}
+export function slugifySeries(value) {
+    return slugifyAuthor(value);
+}
+function authorNameFrom(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && 'name' in value) {
+        const name = value.name;
+        if (typeof name === 'string')
+            return name;
+    }
+    return null;
+}
+/**
+ * Collect every author name referenced in a post's frontmatter (`author` and `authors`).
+ */
+export function authorNamesFromFrontmatter(fm) {
+    const out = new Set();
+    const author = fm.author;
+    if (Array.isArray(author)) {
+        for (const a of author) {
+            const n = authorNameFrom(a);
+            if (n)
+                out.add(n);
+        }
+    }
+    else {
+        const n = authorNameFrom(author);
+        if (n)
+            out.add(n);
+    }
+    const authors = fm.authors;
+    if (Array.isArray(authors)) {
+        for (const a of authors) {
+            const n = authorNameFrom(a);
+            if (n)
+                out.add(n);
+        }
+    }
+    return [...out];
+}
+/**
+ * Look up the same slug across every locale. Returned map preserves locale insertion order.
+ * Useful for building `alternates.languages` in `generateMetadata` without writing a loop.
+ */
+export async function getPostInAllLocales(slug, locales, options = {}) {
+    const entries = await Promise.all(locales.map(async (locale) => {
+        try {
+            return [locale, await getBlogPost(slug, { ...options, locale })];
+        }
+        catch {
+            return [locale, null];
+        }
+    }));
+    return new Map(entries);
+}
+/**
+ * Returns posts authored (or co-authored) by `authorSlug`. Slugification matches
+ * `slugifyAuthor` so the same convention is used everywhere.
+ */
+export async function getPostsByAuthor(authorSlug, options = {}) {
+    const posts = await getAllBlogPosts(options);
+    return posts.filter((p) => authorNamesFromFrontmatter(p.frontmatter).some((name) => slugifyAuthor(name) === authorSlug));
+}
+/**
+ * Returns posts that share a `series` frontmatter value. Sorted by `seriesOrder`,
+ * falling back to publish date (ascending).
+ */
+export async function getPostsBySeries(seriesSlug, options = {}) {
+    const posts = await getAllBlogPosts(options);
+    const inSeries = posts.filter((p) => {
+        const raw = resolveFrontmatterField(['series'], p.frontmatter);
+        return raw ? slugifySeries(raw) === seriesSlug : false;
+    });
+    return inSeries.sort((a, b) => {
+        const oa = resolveFrontmatterField(['seriesOrder'], a.frontmatter);
+        const ob = resolveFrontmatterField(['seriesOrder'], b.frontmatter);
+        if (typeof oa === 'number' && typeof ob === 'number')
+            return oa - ob;
+        if (typeof oa === 'number')
+            return -1;
+        if (typeof ob === 'number')
+            return 1;
+        const da = a.frontmatter.date || '';
+        const db = b.frontmatter.date || '';
+        return da.localeCompare(db);
+    });
+}
+/** Enumerate every author slug across the provided locales (or the default locale only). */
+export async function getAllAuthorSlugs(options = {}, locales) {
+    const localeList = locales && locales.length > 0 ? locales : [options.locale ?? undefined];
+    const out = new Set();
+    for (const locale of localeList) {
+        const opts = { ...options };
+        if (locale)
+            opts.locale = locale;
+        const posts = await getAllBlogPosts(opts);
+        for (const p of posts) {
+            for (const name of authorNamesFromFrontmatter(p.frontmatter)) {
+                out.add(slugifyAuthor(name));
+            }
+        }
+    }
+    // Also include authors defined in config but with no posts yet — useful for
+    // dedicated author landing pages.
+    for (const a of options.config?.authors ?? []) {
+        if (a.name)
+            out.add(slugifyAuthor(a.name));
+    }
+    return [...out];
+}
+/** Enumerate every series slug across the provided locales. */
+export async function getAllSeriesSlugs(options = {}, locales) {
+    const localeList = locales && locales.length > 0 ? locales : [options.locale ?? undefined];
+    const out = new Set();
+    for (const locale of localeList) {
+        const opts = { ...options };
+        if (locale)
+            opts.locale = locale;
+        const posts = await getAllBlogPosts(opts);
+        for (const p of posts) {
+            const raw = resolveFrontmatterField(['series'], p.frontmatter);
+            if (raw)
+                out.add(slugifySeries(raw));
+        }
+    }
+    return [...out];
+}

package/dist/core/seo-metadata.d.ts

@@ -1,12 +1,45 @@
 import type { BlogPost, BlogPostMetadata, Config } from './types.js';
 import type { Metadata } from 'next';
+/** Optional behaviour switches for `generateBlogPostMetadata`. */
+export interface GenerateBlogPostMetadataOptions {
+    /**
+     * Locale segment to inject into the canonical URL (`/{locale}/{segment}/{slug}`).
+     * Also sets `openGraph.locale` and is used to scope hreflang fallbacks.
+     */
+    locale?: string;
+    /**
+     * Controls the final `<title>` value.
+     *  - `"site-suffix"` (default): `"{title} | {siteName}"` — same as 1.0.
+     *  - `"absolute"`: returns `{ absolute: "{title} | {siteName}" }` so a parent
+     *    layout's `title.template` does not double up.
+     *  - `"bare"`: just the post title; let a parent layout's template handle the suffix.
+     *  - A function: receives `{ title, siteName }` and returns the final string.
+     */
+    titleTemplate?: 'site-suffix' | 'absolute' | 'bare' | ((args: {
+        title: string;
+        siteName: string;
+    }) => string);
+    /**
+     * Custom URL builder. Overrides the default `/{locale}/{segment}/{slug}` logic.
+     */
+    urlBuilder?: (args: {
+        canonicalUrl: string | undefined;
+        slug: string;
+        siteUrl: string;
+        locale?: string;
+        config: Config;
+    }) => string;
+    /** Locale-aware hreflang map override. Useful when sibling URLs are computed externally. */
+    alternateLanguages?: Record<string, string>;
+}
 /**
- * Generates comprehensive metadata for a blog post
+ * Generates comprehensive metadata for a blog post.
  * @param post - The blog post
  * @param config - SEO configuration
+ * @param options - Locale + URL + title overrides (see {@link GenerateBlogPostMetadataOptions})
  * @returns Metadata object for Next.js
  */
-export declare function generateBlogPostMetadata(post: BlogPost, config?: Config): Metadata;
+export declare function generateBlogPostMetadata(post: BlogPost, config?: Config, options?: GenerateBlogPostMetadataOptions): Metadata;
 /**
  * Generates metadata for the blog listing page
  * @param posts - Array of blog posts

package/dist/core/seo-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo-metadata.d.ts","sourceRoot":"","sources":["../../src/core/seo-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAgBrC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,GACd,QAAQ,CAwMV;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,QAAQ,CAyBV"}
+{"version":3,"file":"seo-metadata.d.ts","sourceRoot":"","sources":["../../src/core/seo-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAgBrC,kEAAkE;AAClE,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,aAAa,CAAC,EACV,aAAa,GACb,UAAU,GACV,MAAM,GACN,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,CAAC;IAC5D;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAClB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,MAAM,CAAC;IACb,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,+BAA+B,GACxC,QAAQ,CAyNV;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,QAAQ,CAyBV"}

package/dist/core/seo-metadata.js

@@ -3,19 +3,35 @@ import { resolveFrontmatterField, isStringArray } from './type-guards.js';
 import { DEFAULT_SITE_NAME, DEFAULT_LANG } from './constants.js';
 import { normalizeKeywords, getAuthorNames, ensureAuthorsResolved, resolveDefaultAuthor, buildRobotsMeta, resolvePostUrlWithConfig, resolveHreflangMap, resolveBlogIndexUrl, resolveCanonicalUrl, } from './seo-utils.js';
 /**
- * Generates comprehensive metadata for a blog post
+ * Generates comprehensive metadata for a blog post.
  * @param post - The blog post
  * @param config - SEO configuration
+ * @param options - Locale + URL + title overrides (see {@link GenerateBlogPostMetadataOptions})
  * @returns Metadata object for Next.js
  */
-export function generateBlogPostMetadata(post, config) {
+export function generateBlogPostMetadata(post, config, options) {
     const blogConfig = config || getConfig();
+    const opts = options ?? {};
     const { siteName = DEFAULT_SITE_NAME, siteUrl = '', defaultAuthor, authors: configAuthors, twitterHandle, defaultOgImage, defaultLang = DEFAULT_LANG, } = blogConfig;
     const fm = post.frontmatter;
     // Title resolution: seoTitle > title > slug
     const baseTitle = resolveFrontmatterField(['title'], fm, post.slug) || post.slug;
     const seoTitle = resolveFrontmatterField(['seoTitle', 'title'], fm, baseTitle) || baseTitle;
-    const pageTitle = `${seoTitle} | ${siteName}`;
+    const titleMode = opts.titleTemplate ?? 'site-suffix';
+    const suffixed = `${seoTitle} | ${siteName}`;
+    let pageTitle;
+    if (typeof titleMode === 'function') {
+        pageTitle = titleMode({ title: seoTitle, siteName });
+    }
+    else if (titleMode === 'absolute') {
+        pageTitle = { absolute: suffixed };
+    }
+    else if (titleMode === 'bare') {
+        pageTitle = seoTitle;
+    }
+    else {
+        pageTitle = suffixed;
+    }
     // Description resolution: seoDescription > description > excerpt > empty
     const description = resolveFrontmatterField(['seoDescription', 'description', 'excerpt'], fm, '') || '';
     // Use normalized authors from post, or fallback to default author (resolved from config if available)
@@ -57,9 +73,18 @@ export function generateBlogPostMetadata(post, config) {
     const twitterDescription = resolveFrontmatterField(['twitterDescription'], fm) || ogDescription;
     // Canonical URL - supports both absolute and relative URLs
     // Relative URLs will be resolved against siteUrl
-    const canonicalUrl = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], fm), post.slug, siteUrl, blogConfig);
-    // Language
-    const lang = resolveFrontmatterField(['lang'], fm) || defaultLang;
+    const fmCanonical = resolveFrontmatterField(['canonicalUrl'], fm);
+    const canonicalUrl = opts.urlBuilder
+        ? opts.urlBuilder({
+            canonicalUrl: fmCanonical,
+            slug: post.slug,
+            siteUrl,
+            ...(opts.locale ? { locale: opts.locale } : {}),
+            config: blogConfig,
+        })
+        : resolvePostUrlWithConfig(fmCanonical, post.slug, siteUrl, blogConfig, opts.locale);
+    // Language: explicit option > frontmatter.lang > config.defaultLang
+    const lang = opts.locale || resolveFrontmatterField(['lang'], fm) || defaultLang;
     // Robots meta
     const robots = buildRobotsMeta(fm);
     const postUrl = canonicalUrl;
@@ -95,11 +120,11 @@ export function generateBlogPostMetadata(post, config) {
             }
         }
     });
-    // Build alternates object
+    // Build alternates object — explicit option > frontmatter > config.
     const alternates = {};
     if (canonicalUrl)
         alternates.canonical = canonicalUrl;
-    const hreflang = resolveHreflangMap(fm, blogConfig);
+    const hreflang = opts.alternateLanguages ?? resolveHreflangMap(fm, blogConfig);
     if (hreflang && Object.keys(hreflang).length > 0) {
         alternates.languages = siteUrl
             ? Object.fromEntries(Object.entries(hreflang).map(([k, v]) => [

package/dist/core/seo-schema.d.ts

@@ -1,13 +1,29 @@
 import type { BlogPost, Config } from './types.js';
-/** Options for `generateBlogPostSchema` */
+/** Options for `generateBlogPostSchema`. */
 export interface BlogPostSchemaOptions {
     /** If true and an organization @id exists, publisher is `{ "@id": "..." }` only */
     publisherReference?: boolean;
+    /** Locale segment, used for URL building and `inLanguage`. */
+    locale?: string;
+    /**
+     * Speakable specification (https://schema.org/speakable). Pass `true` to use a
+     * sensible default (article header + first paragraph), or your own selectors.
+     */
+    speakable?: boolean | {
+        cssSelector?: string[];
+        xpath?: string[];
+    };
+    /**
+     * Free-form mutation of the BlogPosting node before serialization. Use this
+     * for HowTo extensions, custom fields, isPartOf overrides, etc.
+     */
+    extendArticle?: (node: Record<string, unknown>) => Record<string, unknown>;
 }
 /**
- * Generates JSON-LD structured data (Schema.org) for a blog post
+ * Generates JSON-LD structured data (Schema.org) for a blog post.
  * @param post - The blog post
  * @param config - SEO configuration
+ * @param options - Locale, speakable, publisher reference, extension hook
  * @returns JSON-LD schema object
  */
 export declare function generateBlogPostSchema(post: BlogPost, config?: Config, options?: BlogPostSchemaOptions): Record<string, unknown>;
@@ -15,18 +31,29 @@ export declare function generateBlogPostSchema(post: BlogPost, config?: Config,
  * Generates breadcrumbs schema for a blog post
  * @param post - The blog post
  * @param config - SEO configuration
- * @param breadcrumbs - Optional custom breadcrumb items (e.g., [{ name: 'Home', url: '/' }, { name: 'Blog', url: '/blog' }])
+ * @param breadcrumbs - Optional custom breadcrumb items
+ * @param locale - Optional locale segment for URL building
  * @returns Breadcrumbs JSON-LD schema object
  */
 export declare function generateBreadcrumbsSchema(post: BlogPost, config?: Config, breadcrumbs?: Array<{
     name: string;
     url: string;
-}>): Record<string, unknown>;
+}>, locale?: string): Record<string, unknown>;
+/** Options for `generateBlogPostSchemaGraph`. */
+export interface BlogPostSchemaGraphOptions {
+    locale?: string;
+    speakable?: BlogPostSchemaOptions['speakable'];
+    extendArticle?: BlogPostSchemaOptions['extendArticle'];
+}
 /**
  * Single JSON-LD `@graph` for Organization + BlogPosting + BreadcrumbList.
+ *
+ * Backwards-compatible: the 5th `options` parameter is optional. Passing
+ * `{ locale, speakable, extendArticle }` removes the need for app code to
+ * post-mutate the graph for locale-aware URLs and rich SEO fields.
  */
 export declare function generateBlogPostSchemaGraph(post: BlogPost, config?: Config, breadcrumbs?: Array<{
     name: string;
     url: string;
-}>, includeBreadcrumbs?: boolean): Record<string, unknown>;
+}>, includeBreadcrumbs?: boolean, options?: BlogPostSchemaGraphOptions): Record<string, unknown>;
 //# sourceMappingURL=seo-schema.d.ts.map

package/dist/core/seo-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo-schema.d.ts","sourceRoot":"","sources":["../../src/core/seo-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,EAAE,MAAM,YAAY,CAAC;AAiB3D,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmHzB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,kBAAkB,UAAO,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}
+{"version":3,"file":"seo-schema.d.ts","sourceRoot":"","sources":["../../src/core/seo-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,EAAE,MAAM,YAAY,CAAC;AAiB3D,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5E;AAgBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8JzB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCzB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;CACxD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,kBAAkB,UAAO,EACzB,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}

package/dist/core/seo-schema.js

@@ -4,31 +4,44 @@ import { resolveFrontmatterField, isStringArray } from './type-guards.js';
 import { DEFAULT_SITE_NAME } from './constants.js';
 import { ensureAuthorsResolved, resolveDefaultAuthor, resolvePostUrlWithConfig, resolveBlogIndexUrl, } from './seo-utils.js';
 import { buildPublisherEmbedded, buildOrganizationGraphNode, resolveOrganizationId, } from './organization-schema.js';
+const DEFAULT_SPEAKABLE_SELECTORS = [
+    'article > header h1',
+    'article > header p',
+];
+function slugifySeries(value) {
+    return value
+        .toLowerCase()
+        .trim()
+        .replace(/[^\p{Letter}\p{Number}\s-]/gu, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-');
+}
 /**
- * Generates JSON-LD structured data (Schema.org) for a blog post
+ * Generates JSON-LD structured data (Schema.org) for a blog post.
  * @param post - The blog post
  * @param config - SEO configuration
+ * @param options - Locale, speakable, publisher reference, extension hook
  * @returns JSON-LD schema object
  */
 export function generateBlogPostSchema(post, config, options) {
     const blogConfig = config || getConfig();
     const { siteName = DEFAULT_SITE_NAME, siteUrl = '', defaultAuthor, authors: configAuthors, } = blogConfig;
     const publisherReference = options?.publisherReference === true;
+    const locale = options?.locale;
     const fm = post.frontmatter;
     const title = resolveFrontmatterField(['seoTitle', 'title'], fm, post.slug) || post.slug;
     const description = resolveFrontmatterField(['seoDescription', 'description', 'excerpt'], fm, '') || '';
-    // Use normalized authors from post, or fallback to default author (resolved from config if available)
-    // Note: post.authors should already be resolved from config.authors when the post was loaded (in file-utils.ts)
-    // However, we ensure they are resolved here as a safety net in case resolution didn't happen earlier
+    // Use normalized authors from post, or fallback to default author (resolved from config if available).
     const resolvedDefaultAuthor = resolveDefaultAuthor(defaultAuthor, configAuthors);
     const postAuthors = (post.authors && post.authors.length > 0)
         ? post.authors
         : (resolvedDefaultAuthor ? [resolvedDefaultAuthor] : []);
-    // Ensure all authors are resolved from config (safety net)
     const authors = ensureAuthorsResolved(postAuthors, configAuthors);
     const publishedDate = resolveFrontmatterField(['publishedDate', 'date'], fm);
-    const modifiedDate = resolveFrontmatterField(['modifiedDate'], fm) || publishedDate;
-    const postUrl = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], fm), post.slug, siteUrl, blogConfig);
+    // `updated` is a first-class alias for `modifiedDate`.
+    const modifiedDate = resolveFrontmatterField(['modifiedDate', 'updated'], fm) ||
+        publishedDate;
+    const postUrl = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], fm), post.slug, siteUrl, blogConfig, locale);
     const ogImageUrl = resolveFrontmatterField(['ogImage', 'image'], fm);
     // Calculate reading time and word count if not provided
     const readingTime = resolveFrontmatterField(['readingTime'], fm) || calculateReadingTime(post.content);
@@ -49,6 +62,7 @@ export function generateBlogPostSchema(post, config, options) {
             ...(author.avatar && { image: author.avatar }),
         };
     };
+    const lang = locale ?? resolveFrontmatterField(['lang'], fm);
     // Base schema
     const schema = {
         '@context': 'https://schema.org',
@@ -89,33 +103,68 @@ export function generateBlogPostSchema(post, config, options) {
         ...(isStringArray(fm.tags) && fm.tags.length > 0 && {
             keywords: fm.tags.join(', '),
         }),
-        ...(resolveFrontmatterField(['lang'], fm) ? { inLanguage: resolveFrontmatterField(['lang'], fm) } : {}),
+        ...(lang ? { inLanguage: lang } : {}),
         ...(wordCount > 0 && { wordCount }),
         ...(readingTime > 0 && {
             timeRequired: `PT${readingTime}M`,
         }),
     };
-    // Merge with custom schema from frontmatter
-    if (fm.schema && typeof fm.schema === 'object') {
-        return {
-            ...schema,
-            ...fm.schema,
+    // Speakable spec (voice-assistant friendly).
+    if (options?.speakable) {
+        const sp = options.speakable === true
+            ? { cssSelector: DEFAULT_SPEAKABLE_SELECTORS }
+            : options.speakable;
+        schema.speakable = { '@type': 'SpeakableSpecification', ...sp };
+    }
+    // E-E-A-T: reviewer / fact-checker / last reviewed.
+    const reviewedBy = resolveFrontmatterField(['reviewedBy'], fm);
+    if (reviewedBy) {
+        schema.reviewedBy = { '@type': 'Person', name: reviewedBy };
+    }
+    const factCheckedBy = resolveFrontmatterField(['factCheckedBy'], fm);
+    if (factCheckedBy) {
+        schema.factCheckedBy = { '@type': 'Person', name: factCheckedBy };
+    }
+    const lastReviewed = resolveFrontmatterField(['lastReviewed'], fm);
+    if (lastReviewed) {
+        schema.lastReviewed = lastReviewed;
+    }
+    // Series → isPartOf the pillar CollectionPage.
+    const series = resolveFrontmatterField(['series'], fm);
+    if (series && siteUrl) {
+        const localeSeg = locale ? `/${locale}/` : '/';
+        const seriesSlug = slugifySeries(series);
+        const seriesTitle = resolveFrontmatterField(['seriesTitle'], fm) || series;
+        schema.isPartOf = {
+            '@type': 'CollectionPage',
+            '@id': `${siteUrl.replace(/\/$/, '')}${localeSeg}topics/${seriesSlug}`,
+            name: seriesTitle,
         };
     }
-    return schema;
+    // Merge with custom schema from frontmatter (frontmatter wins).
+    let merged = schema;
+    if (fm.schema && typeof fm.schema === 'object') {
+        merged = { ...schema, ...fm.schema };
+    }
+    // Free-form mutation hook (runs last).
+    if (options?.extendArticle) {
+        return options.extendArticle({ ...merged });
+    }
+    return merged;
 }
 /**
  * Generates breadcrumbs schema for a blog post
  * @param post - The blog post
  * @param config - SEO configuration
- * @param breadcrumbs - Optional custom breadcrumb items (e.g., [{ name: 'Home', url: '/' }, { name: 'Blog', url: '/blog' }])
+ * @param breadcrumbs - Optional custom breadcrumb items
+ * @param locale - Optional locale segment for URL building
  * @returns Breadcrumbs JSON-LD schema object
  */
-export function generateBreadcrumbsSchema(post, config, breadcrumbs) {
+export function generateBreadcrumbsSchema(post, config, breadcrumbs, locale) {
     const blogConfig = config || getConfig();
     const { siteUrl = '' } = blogConfig;
     const title = resolveFrontmatterField(['seoTitle', 'title'], post.frontmatter, post.slug) || post.slug;
-    const postUrl = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl, blogConfig);
+    const postUrl = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl, blogConfig, locale);
     const blogIndexUrl = resolveBlogIndexUrl(siteUrl, blogConfig);
     // Default breadcrumbs: Home > Blog > Post
     const defaultBreadcrumbs = [
@@ -137,10 +186,19 @@ export function generateBreadcrumbsSchema(post, config, breadcrumbs) {
 }
 /**
  * Single JSON-LD `@graph` for Organization + BlogPosting + BreadcrumbList.
+ *
+ * Backwards-compatible: the 5th `options` parameter is optional. Passing
+ * `{ locale, speakable, extendArticle }` removes the need for app code to
+ * post-mutate the graph for locale-aware URLs and rich SEO fields.
  */
-export function generateBlogPostSchemaGraph(post, config, breadcrumbs, includeBreadcrumbs = true) {
+export function generateBlogPostSchemaGraph(post, config, breadcrumbs, includeBreadcrumbs = true, options) {
     const orgNode = buildOrganizationGraphNode(config);
-    const article = generateBlogPostSchema(post, config, { publisherReference: true });
+    const article = generateBlogPostSchema(post, config, {
+        publisherReference: true,
+        ...(options?.locale !== undefined && { locale: options.locale }),
+        ...(options?.speakable !== undefined && { speakable: options.speakable }),
+        ...(options?.extendArticle !== undefined && { extendArticle: options.extendArticle }),
+    });
     const articleBody = { ...article };
     delete articleBody['@context'];
     const graph = [];
@@ -148,7 +206,7 @@ export function generateBlogPostSchemaGraph(post, config, breadcrumbs, includeBr
         graph.push(orgNode);
     graph.push(articleBody);
     if (includeBreadcrumbs) {
-        const crumbs = generateBreadcrumbsSchema(post, config, breadcrumbs);
+        const crumbs = generateBreadcrumbsSchema(post, config, breadcrumbs, options?.locale);
         const crumbsBody = { ...crumbs };
         delete crumbsBody['@context'];
         graph.push(crumbsBody);

package/dist/core/seo-utils.d.ts

@@ -55,12 +55,14 @@ export declare function resolveCanonicalUrl(url: string, siteUrl: string): strin
 export declare function getBlogPostPathSegment(config?: Config): string;
 /**
  * Resolves a post URL from canonical URL or generates default `/{segment}/{slug}` under siteUrl.
+ * When `locale` is provided, builds `/{locale}/{segment}/{slug}` (skipped when a canonicalUrl is set).
  */
-export declare function resolvePostUrl(canonicalUrl: string | undefined, slug: string, siteUrl: string, blogPostPathSegment?: string): string;
+export declare function resolvePostUrl(canonicalUrl: string | undefined, slug: string, siteUrl: string, blogPostPathSegment?: string, locale?: string): string;
 /**
  * Resolves post URL using optional blog config for path segment.
+ * Pass `locale` to prefix the URL with the locale segment.
  */
-export declare function resolvePostUrlWithConfig(canonicalUrl: string | undefined, slug: string, siteUrl: string, config?: Config): string;
+export declare function resolvePostUrlWithConfig(canonicalUrl: string | undefined, slug: string, siteUrl: string, config?: Config, locale?: string): string;
 /**
  * Default blog listing URL for breadcrumbs (config.blogIndexPath or `{siteUrl}/blogs`).
  */

package/dist/core/seo-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo-utils.d.ts","sourceRoot":"","sources":["../../src/core/seo-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAOxE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAcrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,GAAG,SAAS,CAqBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,mBAAmB,SAAS,GAC3B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAOR;AAED;;GAEG;AACH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,mBAAmB,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAkBpC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhD"}
+{"version":3,"file":"seo-utils.d.ts","sourceRoot":"","sources":["../../src/core/seo-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAOxE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAcrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,GAAG,SAAS,CAqBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,mBAAmB,SAAS,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED;;GAEG;AACH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,mBAAmB,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAkBpC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhD"}

package/dist/core/seo-utils.js

@@ -120,18 +120,22 @@ export function getBlogPostPathSegment(config) {
 }
 /**
  * Resolves a post URL from canonical URL or generates default `/{segment}/{slug}` under siteUrl.
+ * When `locale` is provided, builds `/{locale}/{segment}/{slug}` (skipped when a canonicalUrl is set).
  */
-export function resolvePostUrl(canonicalUrl, slug, siteUrl, blogPostPathSegment = 'blog') {
+export function resolvePostUrl(canonicalUrl, slug, siteUrl, blogPostPathSegment = 'blog', locale) {
     const seg = blogPostPathSegment.replace(/^\/+|\/+$/g, '') || 'blog';
     const base = siteUrl.replace(/\/$/, '');
-    const urlRaw = canonicalUrl || (base ? `${base}/${seg}/${slug}` : `/${seg}/${slug}`);
+    const localePrefix = locale ? `/${locale.replace(/^\/+|\/+$/g, '')}` : '';
+    const path = `${localePrefix}/${seg}/${slug}`;
+    const urlRaw = canonicalUrl || (base ? `${base}${path}` : path);
     return siteUrl ? resolveCanonicalUrl(urlRaw, siteUrl) : urlRaw;
 }
 /**
  * Resolves post URL using optional blog config for path segment.
+ * Pass `locale` to prefix the URL with the locale segment.
  */
-export function resolvePostUrlWithConfig(canonicalUrl, slug, siteUrl, config) {
-    return resolvePostUrl(canonicalUrl, slug, siteUrl, getBlogPostPathSegment(config));
+export function resolvePostUrlWithConfig(canonicalUrl, slug, siteUrl, config, locale) {
+    return resolvePostUrl(canonicalUrl, slug, siteUrl, getBlogPostPathSegment(config), locale);
 }
 /**
  * Default blog listing URL for breadcrumbs (config.blogIndexPath or `{siteUrl}/blogs`).

package/dist/core/seo.d.ts

@@ -5,8 +5,9 @@
  * RSS feeds, and sitemap entry builders for blog posts.
  */
 export { generateBlogPostMetadata, generateBlogListMetadata, } from './seo-metadata.js';
+export type { GenerateBlogPostMetadataOptions } from './seo-metadata.js';
 export { generateBlogPostSchema, generateBreadcrumbsSchema, generateBlogPostSchemaGraph, } from './seo-schema.js';
-export type { BlogPostSchemaOptions } from './seo-schema.js';
+export type { BlogPostSchemaOptions, BlogPostSchemaGraphOptions, } from './seo-schema.js';
 export { generateRSSFeed } from './seo-feeds.js';
 export { generateOrganizationSchema } from './organization-schema.js';
 export { getBlogSitemapEntries } from './sitemap-data.js';

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

@@ -1 +1 @@
-{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/core/seo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,GACV,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/core/seo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,GACV,MAAM,gBAAgB,CAAC"}

package/dist/core/types.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Postal address (Schema.org PostalAddress).
+ */
+export interface PostalAddress {
+    streetAddress?: string;
+    addressLocality?: string;
+    addressRegion?: string;
+    postalCode?: string;
+    addressCountry?: string;
+}
+/**
+ * Contact point (Schema.org ContactPoint). Used for Organization JSON-LD.
+ */
+export interface ContactPoint {
+    email?: string;
+    telephone?: string;
+    /** e.g. "customer support", "sales", "press". */
+    contactType?: string;
+    /** ISO country codes (e.g. ["US", "FR"]) or region names. */
+    areaServed?: string | string[];
+    /** BCP-47 codes (e.g. ["en", "fr"]). */
+    availableLanguage?: string | string[];
+}
 /**
  * Publisher / Organization fields for JSON-LD (extends siteName + siteUrl).
  */
@@ -10,6 +33,16 @@ export interface SiteOrganization {
     logo?: string;
     /** Official profiles (Schema.org sameAs) */
     sameAs?: string[];
+    /** ISO date string. */
+    foundingDate?: string;
+    /** Founder name (rendered as Person). */
+    founder?: string;
+    /** PostalAddress fields. */
+    address?: PostalAddress;
+    /** ContactPoint fields. */
+    contactPoint?: ContactPoint;
+    /** Wikidata entity URL (e.g. https://www.wikidata.org/wiki/Q1234567). Auto-merged into sameAs. */
+    wikidata?: string;
 }
 /**
  * Blog configuration
@@ -85,6 +118,20 @@ export interface BlogPostFrontmatter {
     readingTime?: number;
     /** Per-post hreflang map (overrides config.alternateLanguages for this post) */
     alternateLanguages?: Record<string, string>;
+    /** Last-updated date. Drives `dateModified` in JSON-LD and `lastmod` in sitemaps. */
+    updated?: string;
+    /** Topic-cluster identifier. Posts sharing the same series belong to the same pillar. */
+    series?: string;
+    /** Display name for the series pillar page (defaults to humanized series slug). */
+    seriesTitle?: string;
+    /** Sort order within a series (lower first). Falls back to date when absent. */
+    seriesOrder?: number;
+    /** E-E-A-T: editor / reviewer who validated the post. */
+    reviewedBy?: string;
+    /** E-E-A-T: fact-checker. */
+    factCheckedBy?: string;
+    /** E-E-A-T: date of last editorial review (yyyy-mm-dd). */
+    lastReviewed?: string;
     [key: string]: unknown;
 }
 /**

package/dist/core/types.d.ts.map

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

package/dist/index.d.ts

@@ -6,11 +6,14 @@ export type { OgImageProps } from './components/OgImage.js';
 export { BlogPostSEO } from './components/BlogPostSEO.js';
 export type { BlogPostSEOProps } from './components/BlogPostSEO.js';
 export { getBlogPost, getAllBlogPosts, getAllBlogPostSlugs } from './core/file-utils.js';
+export { getPostInAllLocales, getPostsByAuthor, getPostsBySeries, getAllAuthorSlugs, getAllSeriesSlugs, slugifyAuthor, slugifySeries, authorNamesFromFrontmatter, } from './core/queries.js';
+export { generateLlmsTxt, generateLlmsFullTxt } from './core/llms.js';
+export type { LlmsTxtOptions } from './core/llms.js';
 export { generateBlogPostMetadata, generateBlogListMetadata, generateBlogPostSchema, generateBreadcrumbsSchema, generateBlogPostSchemaGraph, generateRSSFeed, generateOrganizationSchema, getBlogSitemapEntries, } from './core/seo.js';
-export type { BlogPostSchemaOptions, BlogSitemapEntry } from './core/seo.js';
+export type { BlogPostSchemaOptions, BlogPostSchemaGraphOptions, BlogSitemapEntry, GenerateBlogPostMetadataOptions, } from './core/seo.js';
 export { getBlogSitemap, getBlogRobots, createRssFeedResponse, } from './next.js';
 export { createConfig, loadConfig, getConfig } from './core/config.js';
-export type { BlogPost, BlogPostMetadata, BlogPostFrontmatter, GetBlogPostOptions, Author, Config, SiteOrganization, } from './core/types.js';
+export type { BlogPost, BlogPostMetadata, BlogPostFrontmatter, GetBlogPostOptions, Author, Config, SiteOrganization, PostalAddress, ContactPoint, } from './core/types.js';
 export { MdxBlogError, BlogPostNotFoundError, FileReadError, DirectoryError, } from './core/errors.js';
 export { POSTS_DIR_NAME, getPostsDirectory } from './core/constants.js';
 export { calculateReadingTime, calculateWordCount, normalizeAuthors } from './core/utils.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGvE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,MAAM,EACN,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGvE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -5,6 +5,10 @@ export { OgImage } from './components/OgImage.js';
 export { BlogPostSEO } from './components/BlogPostSEO.js';
 // Utilities
 export { getBlogPost, getAllBlogPosts, getAllBlogPostSlugs } from './core/file-utils.js';
+// Query helpers (locale-aware, series, authors)
+export { getPostInAllLocales, getPostsByAuthor, getPostsBySeries, getAllAuthorSlugs, getAllSeriesSlugs, slugifyAuthor, slugifySeries, authorNamesFromFrontmatter, } from './core/queries.js';
+// llms.txt generators
+export { generateLlmsTxt, generateLlmsFullTxt } from './core/llms.js';
 // SEO
 export { generateBlogPostMetadata, generateBlogListMetadata, generateBlogPostSchema, generateBreadcrumbsSchema, generateBlogPostSchemaGraph, generateRSSFeed, generateOrganizationSchema, getBlogSitemapEntries, } from './core/seo.js';
 export { getBlogSitemap, getBlogRobots, createRssFeedResponse, } from './next.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next-md-blog/core",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "A React library for parsing and displaying markdown blog posts in Next.js",
   "type": "module",
   "main": "dist/index.js",