@zoyth/simple-site-framework 1.0.4 → 1.1.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ThemeConfig, HeroContent, LocalizedString, AboutContent, ServicesContent, HeaderConfig, FooterConfig } from './config/index.mjs';
+import { ThemeConfig, LocalizedString, HeroContent, AboutContent, ServicesContent, HeaderConfig, FooterConfig } from './config/index.mjs';
 export { FooterSection, LogoConfig, NavDropdown, NavDropdownItem, NavItem, NavLink, NavigationConfig, ScriptsConfig, ServiceItem, SiteContent, SiteMetadata, WhyChooseUsContent } from './config/index.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 import { ClassValue } from 'clsx';
@@ -128,6 +128,117 @@ declare function getAllPolicies(locale: string, contentDir?: string): Promise<Om
  */
 declare function getPolicyLocales(slug: string, contentDir?: string): string[];
 
+interface BlogPostMetadata {
+    title: string;
+    excerpt: string;
+    author: string;
+    /** ISO date (YYYY-MM-DD) */
+    date: string;
+    /** Reading time in minutes */
+    readTime: number;
+    tags: string[];
+    featured?: boolean;
+    /** Featured image URL */
+    image?: string;
+    imageAlt?: string;
+    [key: string]: unknown;
+}
+interface BlogPost {
+    /** Compiled MDX content */
+    content: JSX.Element;
+    /** Frontmatter metadata */
+    metadata: BlogPostMetadata;
+    /** Blog post slug (filename without locale/extension) */
+    slug: string;
+    /** Locale */
+    locale: string;
+}
+/**
+ * Load a blog post markdown file and compile it to React
+ *
+ * @param slug - Blog post slug (e.g., 'getting-started')
+ * @param locale - Locale code (e.g., 'en', 'fr')
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Compiled blog post with content and metadata
+ */
+declare function loadBlogPost(slug: string, locale: string, contentDir?: string): Promise<BlogPost>;
+/**
+ * Get all unique blog post slugs (without locale suffix)
+ *
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of blog post slugs
+ */
+declare function getBlogPostSlugs(contentDir?: string): string[];
+/**
+ * Get all blog posts for a specific locale with their metadata, sorted by date descending
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of blog posts with metadata (without content)
+ */
+declare function getAllBlogPosts(locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get available locales for a specific blog post
+ *
+ * @param slug - Blog post slug
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of locale codes
+ */
+declare function getBlogPostLocales(slug: string, contentDir?: string): string[];
+/**
+ * Get all blog posts matching a specific tag, sorted by date descending
+ *
+ * @param tag - Tag to filter by
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getBlogPostsByTag(tag: string, locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get featured blog posts, sorted by date descending
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getFeaturedBlogPosts(locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get blog posts related to a given post by shared tags
+ *
+ * Sorted by number of shared tags (descending), then by date (descending).
+ *
+ * @param slug - Source blog post slug
+ * @param locale - Locale code
+ * @param count - Maximum number of related posts to return @default 3
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getRelatedBlogPosts(slug: string, locale: string, count?: number, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+interface TagCount {
+    tag: string;
+    count: number;
+}
+/**
+ * Get all unique tags across all blog posts with their occurrence count
+ *
+ * Sorted by count descending.
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getAllTags(locale: string, contentDir?: string): Promise<TagCount[]>;
+
+interface RssFeedOptions {
+    siteUrl: string;
+    siteName: string;
+    description: LocalizedString | string;
+    locale: string;
+    contentDir?: string;
+}
+/**
+ * Generate an RSS 2.0 feed from blog posts
+ *
+ * @returns XML string suitable for serving as application/rss+xml
+ */
+declare function generateBlogRssFeed(options: RssFeedOptions): Promise<string>;
+
 /**
  * Helper to get localized string from navigation
  */
@@ -2181,4 +2292,4 @@ interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'
     size?: 'sm' | 'md' | 'lg';
 }
 
-export { type A11yAnnouncerProps, type ABTestEvent, AboutContent, type AboutSectionProps, type AggregateRating, type AnalyticsEvent, type AnnouncementPriority, type Answer, type Article, type BreadcrumbItem, type BreadcrumbList, type BreadcrumbProps, type ButtonProps, type CTAClickEvent, type CTAType, type CardProps, type ChangeFrequency, type CheckboxProps, type CodeBlockProps, type ContactFormConfig, type ContactFormData, type ContactPoint, type ContactSectionProps, type ConversionEvent, type ConversionType, type EventCategory, type FAQPage, type Feature, type FeatureAction, type FeatureCategory, type FeatureEvent, FeaturesGrid, FooterConfig, type FooterProps, type FormAction, type FormEvent, type FormFieldProps, HeaderConfig, type HeaderProps, type HeroAnimations, HeroContent, type HeroSectionProps, type I18nConfig, type IconName, type IconProps, type InputProps, LOCALE_COOKIE_NAME, type LanguagePreference, type LanguageSwitcherProps, type LazySectionProps, type ListItem, type Locale, type LocaleCookieConfig, type LocalePrefix, LocalizedString, type Location, type MetadataOptions, type ModalProps, type NavigationEvent, type NavigationLocation, type Offer, type Organization, type PageViewEvent, type Person, type Policy, type PolicyMetadata, type PostalAddress, type PricingAction, type PricingEvent, type Product, type Question, type RadioProps, type Rating, type Review, type ScrollDepth, type ScrollDepthEvent, type SearchAction, type SelectProps, type ServicePageLayoutProps, ServicesContent, type ServicesSectionProps, type SitemapConfig, type SitemapEntry, type SkipLinkProps, type SlugTranslations, type TabsProps, type TestimonialSectionProps, type TextareaProps, ThemeConfig, type Thing, TrackedLink, type ValidLocale, type VideoAction, type VideoEvent, type WebSite, cn, createArticle, createBreadcrumbList, createFAQPage, createI18nMiddleware, createMultiLanguageEntries, createOrganization, createProduct, createSitemapEntry, createWebSite, creditCardSchema, dateString, defaultLocale, defaultSlugTranslations, emailSchema, fileSchema, formErrorMessages, formatCurrency, formatDate, formatDateRange, formatFileSize, formatList, formatLocaleDisplay, formatNumber, formatRelativeTime, generateArticleMetadata, generateDesignTokens, generateMetadata, generateSitemap, generateThemeCSS, getAllPolicies, getAlternateLocales, getDefaultLocale, getErrorMessage, getFontConfig, getFontVariables, getI18nConfig, getLocaleAutonym, getLocaleCookieConfig, getLocaleFromCookie, getLocaleLabel, getLocaleLabels, getLocaleName, getLocaleNames, getLocalePrefix, getLocales, getLocalizedString, getNavigationString, getPolicyLocales, getPolicySlugs, getRelativeTime, getRtlLocales, getTextDirection, imageSchema, isI18nConfigInitialized, isLocaleDetectionEnabled, isRtlLocale, isSupportedLocale, loadPolicy, locales, matchLocale, mustBeTrue, normalizeLocale, numericString, optionalString, passwordSchema, phoneSchema, postalCodeSchema, replaceVariables, requiredString, serializeStructuredData, setI18nConfig, setLocaleCookie, trackABTestEvent, trackCTAClick, trackConversion, trackError, trackEvent, trackFeatureEngagement, trackFormEvent, trackNavigation, trackOutboundLink, trackPageView, trackPricingEvent, trackResourceDownload, trackScrollDepth, trackSearch, trackVideoEvent, translateSlug, urlSchema, validateLocale, validateSitemap, validateSitemapEntry };
+export { type A11yAnnouncerProps, type ABTestEvent, AboutContent, type AboutSectionProps, type AggregateRating, type AnalyticsEvent, type AnnouncementPriority, type Answer, type Article, type BlogPost, type BlogPostMetadata, type BreadcrumbItem, type BreadcrumbList, type BreadcrumbProps, type ButtonProps, type CTAClickEvent, type CTAType, type CardProps, type ChangeFrequency, type CheckboxProps, type CodeBlockProps, type ContactFormConfig, type ContactFormData, type ContactPoint, type ContactSectionProps, type ConversionEvent, type ConversionType, type EventCategory, type FAQPage, type Feature, type FeatureAction, type FeatureCategory, type FeatureEvent, FeaturesGrid, FooterConfig, type FooterProps, type FormAction, type FormEvent, type FormFieldProps, HeaderConfig, type HeaderProps, type HeroAnimations, HeroContent, type HeroSectionProps, type I18nConfig, type IconName, type IconProps, type InputProps, LOCALE_COOKIE_NAME, type LanguagePreference, type LanguageSwitcherProps, type LazySectionProps, type ListItem, type Locale, type LocaleCookieConfig, type LocalePrefix, LocalizedString, type Location, type MetadataOptions, type ModalProps, type NavigationEvent, type NavigationLocation, type Offer, type Organization, type PageViewEvent, type Person, type Policy, type PolicyMetadata, type PostalAddress, type PricingAction, type PricingEvent, type Product, type Question, type RadioProps, type Rating, type Review, type RssFeedOptions, type ScrollDepth, type ScrollDepthEvent, type SearchAction, type SelectProps, type ServicePageLayoutProps, ServicesContent, type ServicesSectionProps, type SitemapConfig, type SitemapEntry, type SkipLinkProps, type SlugTranslations, type TabsProps, type TagCount, type TestimonialSectionProps, type TextareaProps, ThemeConfig, type Thing, TrackedLink, type ValidLocale, type VideoAction, type VideoEvent, type WebSite, cn, createArticle, createBreadcrumbList, createFAQPage, createI18nMiddleware, createMultiLanguageEntries, createOrganization, createProduct, createSitemapEntry, createWebSite, creditCardSchema, dateString, defaultLocale, defaultSlugTranslations, emailSchema, fileSchema, formErrorMessages, formatCurrency, formatDate, formatDateRange, formatFileSize, formatList, formatLocaleDisplay, formatNumber, formatRelativeTime, generateArticleMetadata, generateBlogRssFeed, generateDesignTokens, generateMetadata, generateSitemap, generateThemeCSS, getAllBlogPosts, getAllPolicies, getAllTags, getAlternateLocales, getBlogPostLocales, getBlogPostSlugs, getBlogPostsByTag, getDefaultLocale, getErrorMessage, getFeaturedBlogPosts, getFontConfig, getFontVariables, getI18nConfig, getLocaleAutonym, getLocaleCookieConfig, getLocaleFromCookie, getLocaleLabel, getLocaleLabels, getLocaleName, getLocaleNames, getLocalePrefix, getLocales, getLocalizedString, getNavigationString, getPolicyLocales, getPolicySlugs, getRelatedBlogPosts, getRelativeTime, getRtlLocales, getTextDirection, imageSchema, isI18nConfigInitialized, isLocaleDetectionEnabled, isRtlLocale, isSupportedLocale, loadBlogPost, loadPolicy, locales, matchLocale, mustBeTrue, normalizeLocale, numericString, optionalString, passwordSchema, phoneSchema, postalCodeSchema, replaceVariables, requiredString, serializeStructuredData, setI18nConfig, setLocaleCookie, trackABTestEvent, trackCTAClick, trackConversion, trackError, trackEvent, trackFeatureEngagement, trackFormEvent, trackNavigation, trackOutboundLink, trackPageView, trackPricingEvent, trackResourceDownload, trackScrollDepth, trackSearch, trackVideoEvent, translateSlug, urlSchema, validateLocale, validateSitemap, validateSitemapEntry };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ThemeConfig, HeroContent, LocalizedString, AboutContent, ServicesContent, HeaderConfig, FooterConfig } from './config/index.js';
+import { ThemeConfig, LocalizedString, HeroContent, AboutContent, ServicesContent, HeaderConfig, FooterConfig } from './config/index.js';
 export { FooterSection, LogoConfig, NavDropdown, NavDropdownItem, NavItem, NavLink, NavigationConfig, ScriptsConfig, ServiceItem, SiteContent, SiteMetadata, WhyChooseUsContent } from './config/index.js';
 import { NextRequest, NextResponse } from 'next/server';
 import { ClassValue } from 'clsx';
@@ -128,6 +128,117 @@ declare function getAllPolicies(locale: string, contentDir?: string): Promise<Om
  */
 declare function getPolicyLocales(slug: string, contentDir?: string): string[];
 
+interface BlogPostMetadata {
+    title: string;
+    excerpt: string;
+    author: string;
+    /** ISO date (YYYY-MM-DD) */
+    date: string;
+    /** Reading time in minutes */
+    readTime: number;
+    tags: string[];
+    featured?: boolean;
+    /** Featured image URL */
+    image?: string;
+    imageAlt?: string;
+    [key: string]: unknown;
+}
+interface BlogPost {
+    /** Compiled MDX content */
+    content: JSX.Element;
+    /** Frontmatter metadata */
+    metadata: BlogPostMetadata;
+    /** Blog post slug (filename without locale/extension) */
+    slug: string;
+    /** Locale */
+    locale: string;
+}
+/**
+ * Load a blog post markdown file and compile it to React
+ *
+ * @param slug - Blog post slug (e.g., 'getting-started')
+ * @param locale - Locale code (e.g., 'en', 'fr')
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Compiled blog post with content and metadata
+ */
+declare function loadBlogPost(slug: string, locale: string, contentDir?: string): Promise<BlogPost>;
+/**
+ * Get all unique blog post slugs (without locale suffix)
+ *
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of blog post slugs
+ */
+declare function getBlogPostSlugs(contentDir?: string): string[];
+/**
+ * Get all blog posts for a specific locale with their metadata, sorted by date descending
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of blog posts with metadata (without content)
+ */
+declare function getAllBlogPosts(locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get available locales for a specific blog post
+ *
+ * @param slug - Blog post slug
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ * @returns Array of locale codes
+ */
+declare function getBlogPostLocales(slug: string, contentDir?: string): string[];
+/**
+ * Get all blog posts matching a specific tag, sorted by date descending
+ *
+ * @param tag - Tag to filter by
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getBlogPostsByTag(tag: string, locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get featured blog posts, sorted by date descending
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getFeaturedBlogPosts(locale: string, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+/**
+ * Get blog posts related to a given post by shared tags
+ *
+ * Sorted by number of shared tags (descending), then by date (descending).
+ *
+ * @param slug - Source blog post slug
+ * @param locale - Locale code
+ * @param count - Maximum number of related posts to return @default 3
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getRelatedBlogPosts(slug: string, locale: string, count?: number, contentDir?: string): Promise<Omit<BlogPost, 'content'>[]>;
+interface TagCount {
+    tag: string;
+    count: number;
+}
+/**
+ * Get all unique tags across all blog posts with their occurrence count
+ *
+ * Sorted by count descending.
+ *
+ * @param locale - Locale code
+ * @param contentDir - Directory containing blog files @default 'src/content/blog'
+ */
+declare function getAllTags(locale: string, contentDir?: string): Promise<TagCount[]>;
+
+interface RssFeedOptions {
+    siteUrl: string;
+    siteName: string;
+    description: LocalizedString | string;
+    locale: string;
+    contentDir?: string;
+}
+/**
+ * Generate an RSS 2.0 feed from blog posts
+ *
+ * @returns XML string suitable for serving as application/rss+xml
+ */
+declare function generateBlogRssFeed(options: RssFeedOptions): Promise<string>;
+
 /**
  * Helper to get localized string from navigation
  */
@@ -2181,4 +2292,4 @@ interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'
     size?: 'sm' | 'md' | 'lg';
 }
 
-export { type A11yAnnouncerProps, type ABTestEvent, AboutContent, type AboutSectionProps, type AggregateRating, type AnalyticsEvent, type AnnouncementPriority, type Answer, type Article, type BreadcrumbItem, type BreadcrumbList, type BreadcrumbProps, type ButtonProps, type CTAClickEvent, type CTAType, type CardProps, type ChangeFrequency, type CheckboxProps, type CodeBlockProps, type ContactFormConfig, type ContactFormData, type ContactPoint, type ContactSectionProps, type ConversionEvent, type ConversionType, type EventCategory, type FAQPage, type Feature, type FeatureAction, type FeatureCategory, type FeatureEvent, FeaturesGrid, FooterConfig, type FooterProps, type FormAction, type FormEvent, type FormFieldProps, HeaderConfig, type HeaderProps, type HeroAnimations, HeroContent, type HeroSectionProps, type I18nConfig, type IconName, type IconProps, type InputProps, LOCALE_COOKIE_NAME, type LanguagePreference, type LanguageSwitcherProps, type LazySectionProps, type ListItem, type Locale, type LocaleCookieConfig, type LocalePrefix, LocalizedString, type Location, type MetadataOptions, type ModalProps, type NavigationEvent, type NavigationLocation, type Offer, type Organization, type PageViewEvent, type Person, type Policy, type PolicyMetadata, type PostalAddress, type PricingAction, type PricingEvent, type Product, type Question, type RadioProps, type Rating, type Review, type ScrollDepth, type ScrollDepthEvent, type SearchAction, type SelectProps, type ServicePageLayoutProps, ServicesContent, type ServicesSectionProps, type SitemapConfig, type SitemapEntry, type SkipLinkProps, type SlugTranslations, type TabsProps, type TestimonialSectionProps, type TextareaProps, ThemeConfig, type Thing, TrackedLink, type ValidLocale, type VideoAction, type VideoEvent, type WebSite, cn, createArticle, createBreadcrumbList, createFAQPage, createI18nMiddleware, createMultiLanguageEntries, createOrganization, createProduct, createSitemapEntry, createWebSite, creditCardSchema, dateString, defaultLocale, defaultSlugTranslations, emailSchema, fileSchema, formErrorMessages, formatCurrency, formatDate, formatDateRange, formatFileSize, formatList, formatLocaleDisplay, formatNumber, formatRelativeTime, generateArticleMetadata, generateDesignTokens, generateMetadata, generateSitemap, generateThemeCSS, getAllPolicies, getAlternateLocales, getDefaultLocale, getErrorMessage, getFontConfig, getFontVariables, getI18nConfig, getLocaleAutonym, getLocaleCookieConfig, getLocaleFromCookie, getLocaleLabel, getLocaleLabels, getLocaleName, getLocaleNames, getLocalePrefix, getLocales, getLocalizedString, getNavigationString, getPolicyLocales, getPolicySlugs, getRelativeTime, getRtlLocales, getTextDirection, imageSchema, isI18nConfigInitialized, isLocaleDetectionEnabled, isRtlLocale, isSupportedLocale, loadPolicy, locales, matchLocale, mustBeTrue, normalizeLocale, numericString, optionalString, passwordSchema, phoneSchema, postalCodeSchema, replaceVariables, requiredString, serializeStructuredData, setI18nConfig, setLocaleCookie, trackABTestEvent, trackCTAClick, trackConversion, trackError, trackEvent, trackFeatureEngagement, trackFormEvent, trackNavigation, trackOutboundLink, trackPageView, trackPricingEvent, trackResourceDownload, trackScrollDepth, trackSearch, trackVideoEvent, translateSlug, urlSchema, validateLocale, validateSitemap, validateSitemapEntry };
+export { type A11yAnnouncerProps, type ABTestEvent, AboutContent, type AboutSectionProps, type AggregateRating, type AnalyticsEvent, type AnnouncementPriority, type Answer, type Article, type BlogPost, type BlogPostMetadata, type BreadcrumbItem, type BreadcrumbList, type BreadcrumbProps, type ButtonProps, type CTAClickEvent, type CTAType, type CardProps, type ChangeFrequency, type CheckboxProps, type CodeBlockProps, type ContactFormConfig, type ContactFormData, type ContactPoint, type ContactSectionProps, type ConversionEvent, type ConversionType, type EventCategory, type FAQPage, type Feature, type FeatureAction, type FeatureCategory, type FeatureEvent, FeaturesGrid, FooterConfig, type FooterProps, type FormAction, type FormEvent, type FormFieldProps, HeaderConfig, type HeaderProps, type HeroAnimations, HeroContent, type HeroSectionProps, type I18nConfig, type IconName, type IconProps, type InputProps, LOCALE_COOKIE_NAME, type LanguagePreference, type LanguageSwitcherProps, type LazySectionProps, type ListItem, type Locale, type LocaleCookieConfig, type LocalePrefix, LocalizedString, type Location, type MetadataOptions, type ModalProps, type NavigationEvent, type NavigationLocation, type Offer, type Organization, type PageViewEvent, type Person, type Policy, type PolicyMetadata, type PostalAddress, type PricingAction, type PricingEvent, type Product, type Question, type RadioProps, type Rating, type Review, type RssFeedOptions, type ScrollDepth, type ScrollDepthEvent, type SearchAction, type SelectProps, type ServicePageLayoutProps, ServicesContent, type ServicesSectionProps, type SitemapConfig, type SitemapEntry, type SkipLinkProps, type SlugTranslations, type TabsProps, type TagCount, type TestimonialSectionProps, type TextareaProps, ThemeConfig, type Thing, TrackedLink, type ValidLocale, type VideoAction, type VideoEvent, type WebSite, cn, createArticle, createBreadcrumbList, createFAQPage, createI18nMiddleware, createMultiLanguageEntries, createOrganization, createProduct, createSitemapEntry, createWebSite, creditCardSchema, dateString, defaultLocale, defaultSlugTranslations, emailSchema, fileSchema, formErrorMessages, formatCurrency, formatDate, formatDateRange, formatFileSize, formatList, formatLocaleDisplay, formatNumber, formatRelativeTime, generateArticleMetadata, generateBlogRssFeed, generateDesignTokens, generateMetadata, generateSitemap, generateThemeCSS, getAllBlogPosts, getAllPolicies, getAllTags, getAlternateLocales, getBlogPostLocales, getBlogPostSlugs, getBlogPostsByTag, getDefaultLocale, getErrorMessage, getFeaturedBlogPosts, getFontConfig, getFontVariables, getI18nConfig, getLocaleAutonym, getLocaleCookieConfig, getLocaleFromCookie, getLocaleLabel, getLocaleLabels, getLocaleName, getLocaleNames, getLocalePrefix, getLocales, getLocalizedString, getNavigationString, getPolicyLocales, getPolicySlugs, getRelatedBlogPosts, getRelativeTime, getRtlLocales, getTextDirection, imageSchema, isI18nConfigInitialized, isLocaleDetectionEnabled, isRtlLocale, isSupportedLocale, loadBlogPost, loadPolicy, locales, matchLocale, mustBeTrue, normalizeLocale, numericString, optionalString, passwordSchema, phoneSchema, postalCodeSchema, replaceVariables, requiredString, serializeStructuredData, setI18nConfig, setLocaleCookie, trackABTestEvent, trackCTAClick, trackConversion, trackError, trackEvent, trackFeatureEngagement, trackFormEvent, trackNavigation, trackOutboundLink, trackPageView, trackPricingEvent, trackResourceDownload, trackScrollDepth, trackSearch, trackVideoEvent, translateSlug, urlSchema, validateLocale, validateSitemap, validateSitemapEntry };

package/dist/index.js

@@ -204,14 +204,21 @@ __export(src_exports, {
   formatNumber: () => formatNumber,
   formatRelativeTime: () => formatRelativeTime,
   generateArticleMetadata: () => generateArticleMetadata,
+  generateBlogRssFeed: () => generateBlogRssFeed,
   generateDesignTokens: () => generateDesignTokens,
   generateMetadata: () => generateMetadata,
   generateSitemap: () => generateSitemap,
   generateThemeCSS: () => generateThemeCSS,
+  getAllBlogPosts: () => getAllBlogPosts,
   getAllPolicies: () => getAllPolicies,
+  getAllTags: () => getAllTags,
   getAlternateLocales: () => getAlternateLocales,
+  getBlogPostLocales: () => getBlogPostLocales,
+  getBlogPostSlugs: () => getBlogPostSlugs,
+  getBlogPostsByTag: () => getBlogPostsByTag,
   getDefaultLocale: () => getDefaultLocale,
   getErrorMessage: () => getErrorMessage,
+  getFeaturedBlogPosts: () => getFeaturedBlogPosts,
   getFontConfig: () => getFontConfig,
   getFontVariables: () => getFontVariables,
   getI18nConfig: () => getI18nConfig,
@@ -228,6 +235,7 @@ __export(src_exports, {
   getNavigationString: () => getNavigationString,
   getPolicyLocales: () => getPolicyLocales,
   getPolicySlugs: () => getPolicySlugs,
+  getRelatedBlogPosts: () => getRelatedBlogPosts,
   getRelativeTime: () => getRelativeTime,
   getRtlLocales: () => getRtlLocales,
   getTextDirection: () => getTextDirection,
@@ -236,6 +244,7 @@ __export(src_exports, {
   isLocaleDetectionEnabled: () => isLocaleDetectionEnabled,
   isRtlLocale: () => isRtlLocale,
   isSupportedLocale: () => isSupportedLocale,
+  loadBlogPost: () => loadBlogPost,
   loadPolicy: () => loadPolicy,
   locales: () => locales,
   matchLocale: () => matchLocale,
@@ -458,6 +467,168 @@ function getPolicyLocales(slug, contentDir = "src/content/policies") {
   return locales2;
 }
 
+// src/lib/content/blog.ts
+var import_fs2 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+var import_rsc2 = require("next-mdx-remote/rsc");
+var import_rehype_slug2 = __toESM(require("rehype-slug"));
+function resolveDir(contentDir) {
+  return import_path2.default.isAbsolute(contentDir) ? contentDir : import_path2.default.join(process.cwd(), contentDir);
+}
+var REQUIRED_FIELDS = ["title", "excerpt", "author", "date", "tags"];
+async function loadBlogPost(slug, locale, contentDir = "src/content/blog") {
+  const dir = resolveDir(contentDir);
+  const filePath = import_path2.default.join(dir, `${slug}.${locale}.md`);
+  if (!import_fs2.default.existsSync(filePath)) {
+    throw new Error(
+      `Blog post file not found: ${slug}.${locale}.md in ${contentDir}
+Looking for: ${filePath}`
+    );
+  }
+  const source = import_fs2.default.readFileSync(filePath, "utf8");
+  const { content, frontmatter } = await (0, import_rsc2.compileMDX)({
+    source,
+    options: {
+      parseFrontmatter: true,
+      mdxOptions: {
+        rehypePlugins: [import_rehype_slug2.default]
+      }
+    }
+  });
+  for (const field of REQUIRED_FIELDS) {
+    if (!frontmatter[field]) {
+      throw new Error(
+        `Blog post ${slug}.${locale}.md is missing required frontmatter field: ${field}`
+      );
+    }
+  }
+  return {
+    content,
+    metadata: frontmatter,
+    slug,
+    locale
+  };
+}
+function getBlogPostSlugs(contentDir = "src/content/blog") {
+  const dir = resolveDir(contentDir);
+  if (!import_fs2.default.existsSync(dir)) {
+    console.warn(`Blog directory not found: ${dir}`);
+    return [];
+  }
+  const files = import_fs2.default.readdirSync(dir);
+  const slugs = Array.from(
+    new Set(
+      files.filter((file) => file.endsWith(".md") || file.endsWith(".mdx")).map((file) => file.replace(/\.[a-z]{2}(-[A-Z]{2})?\.mdx?$/, ""))
+    )
+  );
+  return slugs;
+}
+async function getAllBlogPosts(locale, contentDir = "src/content/blog") {
+  const slugs = getBlogPostSlugs(contentDir);
+  const posts = await Promise.all(
+    slugs.map(async (slug) => {
+      try {
+        const post = await loadBlogPost(slug, locale, contentDir);
+        return {
+          slug: post.slug,
+          locale: post.locale,
+          metadata: post.metadata
+        };
+      } catch (error) {
+        console.warn(`Skipping ${slug} for locale ${locale}:`, error);
+        return null;
+      }
+    })
+  );
+  return posts.filter((p) => p !== null).sort((a, b) => new Date(b.metadata.date).getTime() - new Date(a.metadata.date).getTime());
+}
+function getBlogPostLocales(slug, contentDir = "src/content/blog") {
+  const dir = resolveDir(contentDir);
+  if (!import_fs2.default.existsSync(dir)) {
+    return [];
+  }
+  const files = import_fs2.default.readdirSync(dir);
+  const locales2 = files.filter((file) => {
+    const pattern = new RegExp(`^${slug}\\.[a-z]{2}(-[A-Z]{2})?\\.mdx?$`);
+    return pattern.test(file);
+  }).map((file) => {
+    const match = file.match(/\.([a-z]{2}(-[A-Z]{2})?)\.mdx?$/);
+    return match ? match[1] : null;
+  }).filter((locale) => locale !== null);
+  return locales2;
+}
+async function getBlogPostsByTag(tag, locale, contentDir = "src/content/blog") {
+  const posts = await getAllBlogPosts(locale, contentDir);
+  return posts.filter((p) => p.metadata.tags.includes(tag));
+}
+async function getFeaturedBlogPosts(locale, contentDir = "src/content/blog") {
+  const posts = await getAllBlogPosts(locale, contentDir);
+  return posts.filter((p) => p.metadata.featured === true);
+}
+async function getRelatedBlogPosts(slug, locale, count = 3, contentDir = "src/content/blog") {
+  const allPosts = await getAllBlogPosts(locale, contentDir);
+  const sourcePost = allPosts.find((p) => p.slug === slug);
+  if (!sourcePost) return [];
+  const sourceTags = new Set(sourcePost.metadata.tags);
+  const candidates = allPosts.filter((p) => p.slug !== slug);
+  const scored = candidates.map((post) => ({
+    post,
+    sharedTags: post.metadata.tags.filter((t) => sourceTags.has(t)).length
+  }));
+  return scored.filter((s) => s.sharedTags > 0).sort((a, b) => {
+    if (b.sharedTags !== a.sharedTags) return b.sharedTags - a.sharedTags;
+    return new Date(b.post.metadata.date).getTime() - new Date(a.post.metadata.date).getTime();
+  }).slice(0, count).map((s) => s.post);
+}
+async function getAllTags(locale, contentDir = "src/content/blog") {
+  const posts = await getAllBlogPosts(locale, contentDir);
+  const counts = /* @__PURE__ */ new Map();
+  for (const post of posts) {
+    for (const tag of post.metadata.tags) {
+      counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+  }
+  return Array.from(counts.entries()).map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count);
+}
+
+// src/lib/content/rss.ts
+var MAX_ITEMS = 20;
+async function generateBlogRssFeed(options) {
+  const { siteUrl, siteName, locale, contentDir } = options;
+  const description = typeof options.description === "string" ? options.description : getLocalizedString(options.description, locale);
+  const posts = await getAllBlogPosts(locale, contentDir);
+  const items = posts.slice(0, MAX_ITEMS);
+  const itemsXml = items.map((post) => {
+    const link = `${siteUrl}/${locale}/blog/${post.slug}`;
+    const pubDate = (/* @__PURE__ */ new Date(`${post.metadata.date}T12:00:00Z`)).toUTCString();
+    const categories = post.metadata.tags.map((tag) => `      <category>${escapeXml(tag)}</category>`).join("\n");
+    return `    <item>
+      <title>${escapeXml(post.metadata.title)}</title>
+      <description>${escapeXml(post.metadata.excerpt)}</description>
+      <link>${escapeXml(link)}</link>
+      <guid>${escapeXml(link)}</guid>
+      <pubDate>${pubDate}</pubDate>
+      <author>${escapeXml(post.metadata.author)}</author>
+${categories}
+    </item>`;
+  }).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>${escapeXml(siteName)}</title>
+    <description>${escapeXml(description)}</description>
+    <link>${escapeXml(siteUrl)}</link>
+    <language>${escapeXml(locale)}</language>
+    <lastBuildDate>${(/* @__PURE__ */ new Date()).toUTCString()}</lastBuildDate>
+    <atom:link href="${escapeXml(siteUrl)}/${escapeXml(locale)}/blog/feed.xml" rel="self" type="application/rss+xml"/>
+${itemsXml}
+  </channel>
+</rss>`;
+}
+function escapeXml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+
 // src/lib/navigation/utils.ts
 function getNavigationString(localizedString, locale) {
   return localizedString[locale] || localizedString["en"] || "";
@@ -535,7 +706,7 @@ var defaultSlugTranslations = {
     "/anti-spam-policy": "/politique-anti-pourriel"
   }
 };
-function translateSlug(path2, fromLocale, toLocale, customTranslations) {
+function translateSlug(path3, fromLocale, toLocale, customTranslations) {
   let configTranslations = {};
   try {
     const { getI18nConfig: getI18nConfig2 } = (init_config(), __toCommonJS(config_exports));
@@ -550,17 +721,17 @@ function translateSlug(path2, fromLocale, toLocale, customTranslations) {
   );
   const translationMap = translations[fromLocale];
   if (!translationMap) {
-    return path2;
+    return path3;
   }
-  if (translationMap[path2]) {
-    return translationMap[path2];
+  if (translationMap[path3]) {
+    return translationMap[path3];
   }
   for (const [fromSlug, toSlug] of Object.entries(translationMap)) {
-    if (path2.startsWith(fromSlug + "/")) {
-      return path2.replace(fromSlug, toSlug);
+    if (path3.startsWith(fromSlug + "/")) {
+      return path3.replace(fromSlug, toSlug);
     }
   }
-  return path2;
+  return path3;
 }
 function mergeTranslations(...translations) {
   const merged = {};
@@ -1389,7 +1560,7 @@ function generateSitemap(config) {
   const urlEntries = entries.map((entry) => {
     const parts = [];
     parts.push(`${indent}<url>${newline}`);
-    parts.push(`${indent}${indent}<loc>${escapeXml(entry.url)}</loc>${newline}`);
+    parts.push(`${indent}${indent}<loc>${escapeXml2(entry.url)}</loc>${newline}`);
     if (entry.lastModified) {
       const date = entry.lastModified instanceof Date ? entry.lastModified.toISOString() : entry.lastModified;
       parts.push(`${indent}${indent}<lastmod>${date}</lastmod>${newline}`);
@@ -1404,9 +1575,9 @@ function generateSitemap(config) {
     if (entry.alternates && entry.alternates.length > 0) {
       entry.alternates.forEach((alternate) => {
         parts.push(
-          `${indent}${indent}<xhtml:link rel="alternate" hreflang="${escapeXml(
+          `${indent}${indent}<xhtml:link rel="alternate" hreflang="${escapeXml2(
             alternate.hreflang
-          )}" href="${escapeXml(alternate.href)}" />${newline}`
+          )}" href="${escapeXml2(alternate.href)}" />${newline}`
         );
       });
     }
@@ -1423,8 +1594,8 @@ function generateSitemap(config) {
   ].join("");
   return xml;
 }
-function createMultiLanguageEntries(baseUrl, path2, locales2, defaultLocale2, options) {
-  const cleanPath = path2.startsWith("/") ? path2 : `/${path2}`;
+function createMultiLanguageEntries(baseUrl, path3, locales2, defaultLocale2, options) {
+  const cleanPath = path3.startsWith("/") ? path3 : `/${path3}`;
   return locales2.map((locale) => {
     const alternates = locales2.map((altLocale) => ({
       hreflang: altLocale,
@@ -1443,15 +1614,15 @@ function createMultiLanguageEntries(baseUrl, path2, locales2, defaultLocale2, op
     };
   });
 }
-function createSitemapEntry(baseUrl, path2, options) {
-  const cleanPath = path2.startsWith("/") ? path2 : `/${path2}`;
-  const url = path2 === "/" ? baseUrl : `${baseUrl}${cleanPath}`;
+function createSitemapEntry(baseUrl, path3, options) {
+  const cleanPath = path3.startsWith("/") ? path3 : `/${path3}`;
+  const url = path3 === "/" ? baseUrl : `${baseUrl}${cleanPath}`;
   return {
     url,
     ...options
   };
 }
-function escapeXml(unsafe) {
+function escapeXml2(unsafe) {
   return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function validateSitemapEntry(entry) {
@@ -1642,14 +1813,21 @@ function FeaturesGrid({ categories, className = "", locale = "en" }) {
   formatNumber,
   formatRelativeTime,
   generateArticleMetadata,
+  generateBlogRssFeed,
   generateDesignTokens,
   generateMetadata,
   generateSitemap,
   generateThemeCSS,
+  getAllBlogPosts,
   getAllPolicies,
+  getAllTags,
   getAlternateLocales,
+  getBlogPostLocales,
+  getBlogPostSlugs,
+  getBlogPostsByTag,
   getDefaultLocale,
   getErrorMessage,
+  getFeaturedBlogPosts,
   getFontConfig,
   getFontVariables,
   getI18nConfig,
@@ -1666,6 +1844,7 @@ function FeaturesGrid({ categories, className = "", locale = "en" }) {
   getNavigationString,
   getPolicyLocales,
   getPolicySlugs,
+  getRelatedBlogPosts,
   getRelativeTime,
   getRtlLocales,
   getTextDirection,
@@ -1674,6 +1853,7 @@ function FeaturesGrid({ categories, className = "", locale = "en" }) {
   isLocaleDetectionEnabled,
   isRtlLocale,
   isSupportedLocale,
+  loadBlogPost,
   loadPolicy,
   locales,
   matchLocale,