@next-md-blog/core 1.0.2 → 1.0.3

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 next-md-blog contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,242 +1,71 @@
 # @next-md-blog/core
 
-A powerful React library for parsing and displaying markdown and MDX blog posts in Next.js projects. Write your blog posts in markdown or MDX format and easily display them with dynamic routes, complete SEO optimization, and beautiful Open Graph images.
+**Next.js App Router–first** helpers for **Markdown / MDX** posts on disk: **`MarkdownContent`**, **`generateBlogPostMetadata`**, **JSON-LD** (including richer **Organization** publisher data), **RSS**, and SEO via **[metadata file conventions](https://nextjs.org/docs/app/api-reference/file-conventions/metadata)** — use **`app/sitemap.ts`** / **`app/robots.ts`** / optional **`feed.xml`** with **`@next-md-blog/core/next`** (`getBlogSitemap`, `getBlogRobots`, `createRssFeedResponse`).
 
-## ✨ Features
-
-- 📝 **Markdown & MDX Support** - Full markdown and MDX support with GitHub Flavored Markdown (GFM) support
-- 🎨 **Server Components** - Built for Next.js App Router with server-side rendering
-- 🔍 **SEO Optimized** - Automatic metadata generation with Open Graph and Twitter Cards
-- 🖼️ **OG Images** - Built-in OG image generation component
-- ⚡ **Type Safe** - Full TypeScript support with comprehensive types
-- 🎯 **Flexible** - Works with both App Router and Pages Router
-- 🛡️ **Robust** - Input validation, error handling, and clean code principles
-
-## 📦 Installation
+## Install
 
 ```bash
 npm install @next-md-blog/core
 ```
 
-## 🚀 Quick Start
-
-### 1. Initialize with CLI (Recommended)
-
-The easiest way to get started is using the CLI:
+Peers: `next@^16`, `react@^19`, `react-dom@^19`.
 
-```bash
-npx @next-md-blog/cli
-```
+## Documentation
 
-This will automatically:
-- ✅ Create blog routes and pages
-- ✅ Install required dependencies
-- ✅ Configure Tailwind CSS typography
-- ✅ Set up SEO configuration
+- **Published docs:** [https://www.next-md-blog.com](https://www.next-md-blog.com)
+- **Live demos:** [demo.next-md-blog.com](https://demo.next-md-blog.com) (single locale) · [demo.i18n.next-md-blog.com](https://demo.i18n.next-md-blog.com) (i18n)
+- **Vercel:** single locale [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnext-md-blog%2Ftemplate) · i18n [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnext-md-blog%2Ftemplate-i18n)
+- **Source & issues:** [github.com/next-md-blog/next-md-blog](https://github.com/next-md-blog/next-md-blog)
 
-### 2. Manual Setup
+To build the docs locally, clone the monorepo, run `pnpm install && pnpm dev:docs`, and open [http://localhost:5101](http://localhost:5101).
 
-If you prefer manual setup:
-
-1. **Install the package:**
-```bash
-npm install @next-md-blog/core @tailwindcss/typography
-```
+Entry points in the repo: [Home / overview](https://github.com/next-md-blog/next-md-blog/blob/main/docs/content/index.mdx), [API reference](https://github.com/next-md-blog/next-md-blog/blob/main/docs/content/api-reference.mdx).
 
-2. **Create a config file:**
-```tsx
-// next-md-blog.config.ts
-import { createConfig } from '@next-md-blog/core';
-
-export default createConfig({
-  siteName: 'My Blog',
-  siteUrl: process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com',
-  defaultAuthor: 'Your Name',
-  twitterHandle: '@yourhandle',
-  defaultLang: 'en',
-});
-```
+## Quick usage
 
-3. **Create blog routes:**
 ```tsx
-// app/blog/[slug]/page.tsx
-import { getBlogPost, getAllBlogPosts, generateBlogPostMetadata } from '@next-md-blog/core';
-import { MarkdownContent } from '@next-md-blog/core';
-import { notFound } from 'next/navigation';
-import type { Metadata } from 'next';
+import {
+  getBlogPost,
+  getAllBlogPosts,
+  MarkdownContent,
+  createConfig,
+  generateBlogPostMetadata,
+} from '@next-md-blog/core';
 import blogConfig from '@/next-md-blog.config';
 
-export async function generateStaticParams() {
-  const posts = await getAllBlogPosts({ config: blogConfig });
-  return posts.map((post) => ({
-    slug: post.slug,
-  }));
-}
-
-export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }): Promise<Metadata> {
-  const { slug } = await params;
-  const post = await getBlogPost(slug, { config: blogConfig });
-
-  if (!post) {
-    return { title: 'Post Not Found' };
-  }
-
-  return generateBlogPostMetadata(post, blogConfig);
-}
-
-export default async function BlogPost({ params }: { params: Promise<{ slug: string }> }) {
-  const { slug } = await params;
-  const post = await getBlogPost(slug, { config: blogConfig });
-
-  if (!post) {
-    notFound();
-  }
-
-  return (
-    <div className="prose prose-lg dark:prose-invert max-w-none">
-      <MarkdownContent content={post.content} />
-    </div>
-  );
-}
-```
-
-## 📚 API Reference
-
-### Components
-
-#### `MarkdownContent`
-
-A React Server Component that renders markdown content as HTML.
-
-**Props:**
-- `content` (string, required): The markdown content to render
-- `className` (string, optional): CSS class name for the container
-- `components` (MarkdownComponents, optional): Custom components to override default markdown rendering
-- `remarkPlugins` (any[], optional): Custom remark plugins to extend markdown parsing
-- `rehypePlugins` (any[], optional): Custom rehype plugins to extend HTML processing
-
-**Example:**
-```tsx
-<MarkdownContent content="# Hello World" className="prose prose-lg" />
-```
-
-#### `BlogPostSEO`
-
-A component that generates JSON-LD structured data for SEO.
-
-**Props:**
-- `post` (BlogPost, required): The blog post object
-- `config` (SEOConfig, required): SEO configuration
-
-**Example:**
-```tsx
-<BlogPostSEO post={post} config={blogConfig} />
+const post = await getBlogPost('hello', { config: blogConfig });
 ```
 
-#### `OgImage`
-
-A component for generating Open Graph images (used with `@vercel/og`).
-
-**Props:**
-- `title` (string, required): Title text
-- `description` (string, optional): Description/subtitle text
-- `siteName` (string, optional): Site name
-- `backgroundColor` (string, optional): Background color (default: `#1a1a1a`)
-- `textColor` (string, optional): Text color (default: `#ffffff`)
-
-### Functions
-
-#### `getBlogPost(slug: string, options?: GetBlogPostOptions): Promise<BlogPost | null>`
-
-Retrieves a single blog post by its slug.
-
-**Parameters:**
-- `slug` (string): The slug of the blog post (filename without .md or .mdx extension)
-- `options` (optional): Configuration object
-  - `postsDir` (string, optional): Custom path to posts directory
-  - `config` (Config, optional): Blog configuration
-
-**Returns:**
-- `Promise<BlogPost | null>`: The blog post object or null if not found
-
-#### `getAllBlogPosts(options?: GetBlogPostOptions): Promise<BlogPostMetadata[]>`
-
-Retrieves all blog posts from the posts folder.
-
-**Parameters:**
-- `options` (optional): Configuration object
-  - `postsDir` (string, optional): Custom path to posts directory
-  - `config` (Config, optional): Blog configuration
-
-**Returns:**
-- `Promise<BlogPostMetadata[]>`: Array of blog post metadata, sorted by date (newest first)
-
-#### `generateBlogPostMetadata(post: BlogPost, config?: SEOConfig): Metadata`
-
-Generates comprehensive SEO metadata for a blog post.
+Scaffold routes, **`sitemap.ts`**, **`robots.ts`**, and config with **`npx @next-md-blog/cli`**.
 
-**Parameters:**
-- `post` (BlogPost): The blog post object
-- `config` (SEOConfig, optional): SEO configuration
+### `app/sitemap.ts` / `app/robots.ts`
 
-**Returns:**
-- `Metadata`: Next.js metadata object
-
-#### `generateBlogListMetadata(posts: BlogPostMetadata[], config?: SEOConfig): Metadata`
-
-Generates SEO metadata for the blog listing page.
-
-### Types
-
-#### `BlogPost`
-
-```typescript
-interface BlogPost {
-  slug: string;
-  content: string;
-  frontmatter: BlogPostFrontmatter;
-  authors: Author[];
-  readingTime: number;
-  wordCount: number;
-}
-```
+```ts
+import { getAllBlogPosts } from '@next-md-blog/core';
+import { getBlogSitemap, getBlogRobots } from '@next-md-blog/core/next';
+import blogConfig from '@/next-md-blog.config';
 
-#### `BlogPostFrontmatter`
-
-```typescript
-interface BlogPostFrontmatter {
-  title?: string;
-  date?: string;
-  description?: string;
-  author?: string;
-  tags?: string[];
-  ogImage?: string;
-  image?: string;
-  [key: string]: unknown;
+export default async function sitemap() {
+  const posts = await getAllBlogPosts({ config: blogConfig });
+  return getBlogSitemap(posts, blogConfig);
 }
 ```
 
-## 🎨 Styling
-
-The library is designed to work with Tailwind CSS v4 and the `@tailwindcss/typography` plugin. Use the `prose` classes for beautiful markdown styling:
+```ts
+import { getBlogRobots } from '@next-md-blog/core/next';
+import blogConfig from '@/next-md-blog.config';
 
-```tsx
-<div className="prose prose-lg dark:prose-invert max-w-none">
-  <MarkdownContent content={post.content} />
-</div>
+export default function robots() {
+  return getBlogRobots(blogConfig);
+}
 ```
 
-## 📖 Documentation
+## Links
 
-For complete documentation, examples, and advanced usage, visit the [main repository](https://github.com/florianamette/next-mdx-blog).
+- [npm](https://www.npmjs.com/package/@next-md-blog/core)
+- [Issues](https://github.com/next-md-blog/next-md-blog/issues)
+- Source: [`packages/core`](https://github.com/next-md-blog/next-md-blog/tree/main/packages/core)
 
-## 📝 License
+## License
 
 MIT
-
-## 🔗 Links
-
-- [GitHub Repository](https://github.com/florianamette/next-mdx-blog)
-- [CLI Package](https://www.npmjs.com/package/@next-md-blog/cli)
-- [Issues](https://github.com/florianamette/next-mdx-blog/issues)
-

package/dist/components/BlogPostSEO.d.ts

@@ -14,6 +14,8 @@ export interface BlogPostSEOProps {
     }>;
     /** Whether to include breadcrumbs schema (default: true) */
     includeBreadcrumbs?: boolean;
+    /** Single `@graph` script (Organization + article + breadcrumbs by reference) */
+    asGraph?: boolean;
 }
 /**
  * Component that generates and injects JSON-LD structured data for a blog post
@@ -24,5 +26,5 @@ export interface BlogPostSEOProps {
  * <BlogPostSEO post={post} />
  * ```
  */
-export declare function BlogPostSEO({ post, config, breadcrumbs, includeBreadcrumbs, }: BlogPostSEOProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlogPostSEO({ post, config, breadcrumbs, includeBreadcrumbs, asGraph, }: BlogPostSEOProps): import("react/jsx-runtime.js").JSX.Element;
 //# sourceMappingURL=BlogPostSEO.d.ts.map

package/dist/components/BlogPostSEO.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogPostSEO.d.ts","sourceRoot":"","sources":["../../src/components/BlogPostSEO.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAIzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,WAAW,EACX,kBAAyB,GAC1B,EAAE,gBAAgB,2CA2BlB"}
+{"version":3,"file":"BlogPostSEO.d.ts","sourceRoot":"","sources":["../../src/components/BlogPostSEO.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,WAAW,EACX,kBAAyB,EACzB,OAAe,GAChB,EAAE,gBAAgB,8CAsClB"}

package/dist/components/BlogPostSEO.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { generateBlogPostSchema, generateBreadcrumbsSchema } from '../core/seo.js';
+import { generateBlogPostSchema, generateBreadcrumbsSchema, generateBlogPostSchemaGraph, } from '../core/seo.js';
 import { getConfig } from '../core/config.js';
 /**
  * Component that generates and injects JSON-LD structured data for a blog post
@@ -10,11 +10,13 @@ import { getConfig } from '../core/config.js';
  * <BlogPostSEO post={post} />
  * ```
  */
-export function BlogPostSEO({ post, config, breadcrumbs, includeBreadcrumbs = true, }) {
+export function BlogPostSEO({ post, config, breadcrumbs, includeBreadcrumbs = true, asGraph = false, }) {
     const blogConfig = config || getConfig();
-    // Generate article schema
+    if (asGraph) {
+        const graphSchema = generateBlogPostSchemaGraph(post, blogConfig, breadcrumbs, includeBreadcrumbs);
+        return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(graphSchema) } }));
+    }
     const articleSchema = generateBlogPostSchema(post, blogConfig);
-    // Generate breadcrumbs schema if enabled
     const breadcrumbsSchema = includeBreadcrumbs
         ? generateBreadcrumbsSchema(post, blogConfig, breadcrumbs)
         : null;

package/dist/components/MarkdownContent.d.ts

@@ -1,9 +1,8 @@
-import type { Components } from 'react-markdown';
+import type { Components, Options } from 'react-markdown';
 /**
  * Component types that can be overridden
  */
-export interface MarkdownComponents extends Partial<Components> {
-}
+export type MarkdownComponents = Partial<Components>;
 /**
  * Props for the MarkdownContent component
  */
@@ -15,9 +14,9 @@ export interface MarkdownContentProps {
     /** Optional custom components to override default markdown rendering */
     components?: MarkdownComponents;
     /** Optional remark plugins */
-    remarkPlugins?: any[];
+    remarkPlugins?: Options['remarkPlugins'];
     /** Optional rehype plugins */
-    rehypePlugins?: any[];
+    rehypePlugins?: Options['rehypePlugins'];
 }
 /**
  * React Server Component that renders markdown content as React elements
@@ -44,5 +43,5 @@ export interface MarkdownContentProps {
  * />
  * ```
  */
-export declare function MarkdownContent({ content, className, components, remarkPlugins, rehypePlugins, }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function MarkdownContent({ content, className, components, remarkPlugins, rehypePlugins, }: MarkdownContentProps): import("react/jsx-runtime.js").JSX.Element;
 //# sourceMappingURL=MarkdownContent.d.ts.map

package/dist/components/MarkdownContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownContent.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownContent.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,UAAU,CAAC;CAAG;AAElE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC;IACtB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,SAAc,EACd,UAAU,EACV,aAAkB,EAClB,aAAkB,GACnB,EAAE,oBAAoB,2CA0BtB"}
+{"version":3,"file":"MarkdownContent.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownContent.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAU1D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACzC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,SAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,GACd,EAAE,oBAAoB,8CAyBtB"}

package/dist/components/MarkdownContent.js

@@ -3,6 +3,11 @@ import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
 import remarkEmoji from 'remark-emoji';
 import { defaultMarkdownComponents } from './markdown/defaults.js';
+function toPluggableArray(list) {
+    if (list == null)
+        return [];
+    return Array.isArray(list) ? list : [list];
+}
 /**
  * React Server Component that renders markdown content as React elements
  * Uses react-markdown under the hood with support for custom components.
@@ -28,7 +33,7 @@ import { defaultMarkdownComponents } from './markdown/defaults.js';
  * />
  * ```
  */
-export function MarkdownContent({ content, className = '', components, remarkPlugins = [], rehypePlugins = [], }) {
+export function MarkdownContent({ content, className = '', components, remarkPlugins, rehypePlugins, }) {
     if (!content || typeof content !== 'string') {
         throw new Error('Invalid content: must be a non-empty string');
     }
@@ -38,7 +43,6 @@ export function MarkdownContent({ content, className = '', components, remarkPlu
         ...defaultMarkdownComponents,
         ...components,
     };
-    // Default remark plugins
-    const defaultRemarkPlugins = [remarkGfm, remarkEmoji, ...remarkPlugins];
-    return (_jsx("article", { className: className ? `prose prose-lg max-w-none dark:prose-invert ${className}` : 'prose prose-lg max-w-none dark:prose-invert', children: _jsx(ReactMarkdown, { remarkPlugins: defaultRemarkPlugins, rehypePlugins: rehypePlugins, components: mergedComponents, children: content }) }));
+    const defaultRemarkPlugins = [remarkGfm, remarkEmoji, ...toPluggableArray(remarkPlugins)];
+    return (_jsx("article", { className: className ? `prose prose-lg max-w-none dark:prose-invert ${className}` : 'prose prose-lg max-w-none dark:prose-invert', children: _jsx(ReactMarkdown, { remarkPlugins: defaultRemarkPlugins, rehypePlugins: toPluggableArray(rehypePlugins), components: mergedComponents, children: content }) }));
 }

package/dist/components/markdown/img.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"img.d.ts","sourceRoot":"","sources":["../../../src/components/markdown/img.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAS,SAAQ,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;CAAG;AAE9E,QAAA,MAAM,GAAG,mFAeR,CAAC;AAGF,eAAe,GAAG,CAAC"}
+{"version":3,"file":"img.d.ts","sourceRoot":"","sources":["../../../src/components/markdown/img.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAS,SAAQ,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;CAAG;AAE9E,QAAA,MAAM,GAAG,mFAmBR,CAAC;AAGF,eAAe,GAAG,CAAC"}

package/dist/components/markdown/img.js

@@ -2,7 +2,10 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import React from 'react';
 const Img = React.forwardRef(({ className, alt, src, ...props }, ref) => {
     // Generate a fallback alt text from the image filename if alt is not provided
-    const altText = alt || (src ? `Image: ${src.split('/').pop()?.split('?')[0] || 'image'}` : 'Image');
+    const altText = alt ||
+        (typeof src === 'string' && src
+            ? `Image: ${src.split('/').pop()?.split('?')[0] || 'image'}`
+            : 'Image');
     return (_jsx("img", { ref: ref, alt: altText, src: src, className: className, ...props }));
 });
 Img.displayName = 'Img';

package/dist/core/config.d.ts

@@ -5,7 +5,7 @@ import type { Config } from './types.js';
  *
  * @example
  * ```ts
- * import { createConfig } from '@florianamette/next-md-blog';
+ * import { createConfig } from '@next-md-blog/core';
  *
  * export default createConfig({
  *   siteName: 'My Blog',

package/dist/core/config.js

@@ -14,7 +14,7 @@ const DEFAULT_CONFIG = {
  *
  * @example
  * ```ts
- * import { createConfig } from '@florianamette/next-md-blog';
+ * import { createConfig } from '@next-md-blog/core';
  *
  * export default createConfig({
  *   siteName: 'My Blog',

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

@@ -0,0 +1,22 @@
+import type { Config } from './types.js';
+/**
+ * Normalizes siteUrl to an origin with no trailing slash (empty string if invalid).
+ */
+export declare function normalizeSiteOrigin(siteUrl: string | undefined): string;
+/**
+ * Stable @id for the site Organization node (fragment on origin).
+ */
+export declare function resolveOrganizationId(config?: Config): string | undefined;
+/**
+ * JSON-LD Organization node for publisher / standalone script.
+ */
+export declare function buildOrganizationNode(config?: Config): Record<string, unknown> | undefined;
+/**
+ * Standalone Organization JSON-LD for layout or @graph.
+ */
+export declare function generateOrganizationSchema(config?: Config): Record<string, unknown> | undefined;
+/** Publisher object for BlogPosting (no @context). */
+export declare function buildPublisherEmbedded(config?: Config): Record<string, unknown> | undefined;
+/** Organization node for @graph (no @context). */
+export declare function buildOrganizationGraphNode(config?: Config): Record<string, unknown> | undefined;
+//# sourceMappingURL=organization-schema.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/organization-schema.js

@@ -0,0 +1,83 @@
+import { DEFAULT_SITE_NAME } from './constants.js';
+import { getConfig } from './config.js';
+/**
+ * Normalizes siteUrl to an origin with no trailing slash (empty string if invalid).
+ */
+export function normalizeSiteOrigin(siteUrl) {
+    if (!siteUrl?.trim())
+        return '';
+    try {
+        const u = new URL(siteUrl);
+        return `${u.protocol}//${u.host}`;
+    }
+    catch {
+        return siteUrl.replace(/\/$/, '');
+    }
+}
+/**
+ * Stable @id for the site Organization node (fragment on origin).
+ */
+export function resolveOrganizationId(config) {
+    const blogConfig = config || getConfig();
+    const org = blogConfig.organization;
+    if (org?.id?.trim())
+        return org.id.trim();
+    const origin = normalizeSiteOrigin(blogConfig.siteUrl);
+    if (!origin)
+        return undefined;
+    return `${origin}/#organization`;
+}
+/**
+ * JSON-LD Organization node for publisher / standalone script.
+ */
+export function buildOrganizationNode(config) {
+    const blogConfig = config || getConfig();
+    const { siteName = DEFAULT_SITE_NAME, siteUrl = '', organization: org, } = blogConfig;
+    if (!siteName)
+        return undefined;
+    const origin = normalizeSiteOrigin(siteUrl);
+    const id = resolveOrganizationId(blogConfig);
+    const node = {
+        '@context': 'https://schema.org',
+        '@type': 'Organization',
+        name: siteName,
+    };
+    if (id)
+        node['@id'] = id;
+    if (origin || siteUrl) {
+        node.url = origin || siteUrl.replace(/\/$/, '');
+    }
+    if (org?.legalName)
+        node.legalName = org.legalName;
+    if (org?.description)
+        node.description = org.description;
+    if (org?.logo) {
+        node.logo = {
+            '@type': 'ImageObject',
+            url: org.logo,
+        };
+    }
+    if (org?.sameAs && org.sameAs.length > 0) {
+        node.sameAs = org.sameAs.length === 1 ? org.sameAs[0] : org.sameAs;
+    }
+    return node;
+}
+/**
+ * Standalone Organization JSON-LD for layout or @graph.
+ */
+export function generateOrganizationSchema(config) {
+    return buildOrganizationNode(config);
+}
+/** Publisher object for BlogPosting (no @context). */
+export function buildPublisherEmbedded(config) {
+    const node = buildOrganizationNode(config);
+    if (!node)
+        return undefined;
+    const rest = { ...node };
+    delete rest['@context'];
+    return rest;
+}
+/** Organization node for @graph (no @context). */
+export function buildOrganizationGraphNode(config) {
+    return buildPublisherEmbedded(config);
+}

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

@@ -1,16 +1,6 @@
-import type { BlogPost, BlogPostMetadata, Config } from './types.js';
+import type { BlogPost, Config } from './types.js';
 /**
- * Generates sitemap XML for blog posts
- * @param posts - Array of blog post metadata
- * @param config - SEO configuration
- * @returns Sitemap XML string
- */
-export declare function generateSitemap(posts: BlogPostMetadata[], config?: Config): string;
-/**
- * Generates RSS feed XML for blog posts
- * @param posts - Array of blog posts
- * @param config - SEO configuration
- * @returns RSS XML string
+ * Generates RSS feed XML for blog posts (used by `createRssFeedResponse` in `@next-md-blog/core/next`).
  */
 export declare function generateRSSFeed(posts: BlogPost[], config?: Config): string;
 //# sourceMappingURL=seo-feeds.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"seo-feeds.d.ts","sourceRoot":"","sources":["../../src/core/seo-feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMrE;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAuDR"}
+{"version":3,"file":"seo-feeds.d.ts","sourceRoot":"","sources":["../../src/core/seo-feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAUnD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAuDR"}

package/dist/core/seo-feeds.js

@@ -1,52 +1,22 @@
 import { getConfig } from './config.js';
 import { resolveFrontmatterField } from './type-guards.js';
 import { DEFAULT_SITE_NAME, RSS_POST_LIMIT } from './constants.js';
-import { resolvePostUrl, escapeXml, getAuthorName } from './seo-utils.js';
+import { resolvePostUrlWithConfig, escapeXml, getAuthorName, } from './seo-utils.js';
 /**
- * Generates sitemap XML for blog posts
- * @param posts - Array of blog post metadata
- * @param config - SEO configuration
- * @returns Sitemap XML string
- */
-export function generateSitemap(posts, config) {
-    const blogConfig = config || getConfig();
-    const { siteUrl = '' } = blogConfig;
-    const urls = posts
-        .map((post) => {
-        const lastmod = resolveFrontmatterField(['modifiedDate', 'date'], post.frontmatter) || new Date().toISOString().split('T')[0];
-        const url = `${siteUrl}/blog/${post.slug}`;
-        return `  <url>
-    <loc>${escapeXml(url)}</loc>
-    <lastmod>${lastmod}</lastmod>
-    <changefreq>monthly</changefreq>
-    <priority>0.8</priority>
-  </url>`;
-    })
-        .join('\n');
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${urls}
-</urlset>`;
-}
-/**
- * Generates RSS feed XML for blog posts
- * @param posts - Array of blog posts
- * @param config - SEO configuration
- * @returns RSS XML string
+ * Generates RSS feed XML for blog posts (used by `createRssFeedResponse` in `@next-md-blog/core/next`).
  */
 export function generateRSSFeed(posts, config) {
     const blogConfig = config || getConfig();
     const { siteName = DEFAULT_SITE_NAME, siteUrl = '', defaultAuthor, } = blogConfig;
     const items = posts
-        .slice(0, RSS_POST_LIMIT) // Limit to most recent posts
+        .slice(0, RSS_POST_LIMIT)
         .map((post) => {
         const title = resolveFrontmatterField(['title'], post.frontmatter, post.slug) || post.slug;
         const description = resolveFrontmatterField(['description', 'excerpt'], post.frontmatter, '') || '';
         const authorObj = post.authors[0];
         const author = authorObj ? getAuthorName(authorObj) : (defaultAuthor || '');
         const pubDate = resolveFrontmatterField(['publishedDate', 'date'], post.frontmatter) || new Date().toISOString();
-        const url = resolvePostUrl(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl);
-        // Format date for RSS (RFC 822)
+        const url = resolvePostUrlWithConfig(resolveFrontmatterField(['canonicalUrl'], post.frontmatter), post.slug, siteUrl, blogConfig);
         const rssDate = new Date(pubDate).toUTCString();
         return `    <item>
       <title>${escapeXml(title)}</title>