@stati/core 1.10.2 → 1.11.0

package/dist/seo/sitemap.js

@@ -3,6 +3,7 @@
  * @module seo/sitemap
  */
 import { escapeHtml, resolveAbsoluteUrl } from './utils/index.js';
+import { urlMatchesAnyPattern } from '../rss/utils/index.js';
 /**
  * Maximum entries per sitemap file (per sitemap.org spec)
  */
@@ -42,39 +43,6 @@ function validateChangeFreq(changefreq) {
     }
     return undefined;
 }
-/**
- * Escapes regex special characters in a string, except glob wildcards
- * @param str - String to escape
- * @returns String with regex special characters escaped
- */
-function escapeRegexExceptGlob(str) {
-    // Escape all regex special characters except * and ?
-    return str.replace(/[.+^${}()|[\]\\]/g, '\\$&');
-}
-/**
- * Checks if a page URL matches a list of patterns.
- * @param url - The URL to check.
- * @param patterns - An array of glob-style patterns.
- * @returns `true` if the URL matches any pattern, `false` otherwise.
- */
-function urlMatchesAnyPattern(url, patterns) {
-    for (const pattern of patterns) {
-        // Simple glob patterns
-        if (pattern.includes('*') || pattern.includes('?')) {
-            // Escape regex special characters first, then convert glob wildcards
-            const escapedPattern = escapeRegexExceptGlob(pattern);
-            const regexPattern = escapedPattern.replace(/\*/g, '.*').replace(/\?/g, '.');
-            const regex = new RegExp('^' + regexPattern + '$');
-            if (regex.test(url)) {
-                return true;
-            }
-        }
-        else if (url === pattern || url.startsWith(pattern)) {
-            return true;
-        }
-    }
-    return false;
-}
 /**
  * Checks if a page matches exclude patterns
  * @param page - Page to check
@@ -113,25 +81,8 @@ function determinePriority(page, rules, defaultPriority = 0.5) {
     // Check each rule in order (first match wins)
     for (const rule of rules) {
         const pattern = rule.pattern;
-        if (pattern.includes('*') || pattern.includes('?')) {
-            // Escape regex special characters first, then convert glob wildcards
-            const escapedPattern = escapeRegexExceptGlob(pattern);
-            const regexPattern = escapedPattern.replace(/\*/g, '.*').replace(/\?/g, '.');
-            const regex = new RegExp('^' + regexPattern + '$');
-            if (regex.test(page.url)) {
-                return validatePriority(rule.priority);
-            }
-        }
-        else {
-            // For non-glob patterns, check exact match or path prefix
-            if (page.url === pattern) {
-                return validatePriority(rule.priority);
-            }
-            // For path prefix matching, ensure we match at path boundaries
-            // e.g., "/api" matches "/api/foo" but "/" only matches "/" exactly
-            if (pattern !== '/' && page.url.startsWith(pattern + '/')) {
-                return validatePriority(rule.priority);
-            }
+        if (urlMatchesAnyPattern(page.url, [pattern])) {
+            return validatePriority(rule.priority);
         }
     }
     return defaultPriority;

package/dist/types/config.d.ts

@@ -74,6 +74,8 @@ export interface StatiConfig {
     sitemap?: SitemapConfig;
     /** Robots.txt generation configuration */
     robots?: RobotsTxtConfig;
+    /** RSS feed generation configuration */
+    rss?: import('./rss.js').RSSConfig;
     /** Development server configuration */
     dev?: {
         /** Port for development server (default: 3000) */

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

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

package/dist/types/index.d.ts

@@ -8,6 +8,7 @@ export type { FrontMatter, PageModel, CollectionData, TemplateContext, SEOMetada
 export type { SEOContext, SEOValidationResult } from './seo.js';
 export { SEOTagType } from './seo.js';
 export type { ChangeFrequency, SitemapEntry, SitemapConfig, SitemapGenerationResult, } from './sitemap.js';
+export type { RSSConfig, RSSFeedConfig, RSSGenerationResult } from './rss.js';
 export type { NavNode } from './navigation.js';
 export type { Logger } from './logging.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG9E,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/rss.d.ts

@@ -0,0 +1,247 @@
+/**
+ * RSS feed generation type definitions
+ */
+import type { PageModel } from './content.js';
+import type { StatiConfig } from './config.js';
+/**
+ * Configuration for a single RSS feed.
+ * Defines feed metadata, content selection, and item mapping.
+ */
+export interface RSSFeedConfig {
+    /**
+     * Filename for the RSS feed (e.g., 'feed.xml', 'blog.xml')
+     * Will be written to the output directory.
+     */
+    filename: string;
+    /**
+     * Feed title (required)
+     * @example 'My Blog Posts'
+     */
+    title: string;
+    /**
+     * Feed description (required)
+     * @example 'Latest articles from my blog'
+     */
+    description: string;
+    /**
+     * Feed link - the URL of the website (not the feed itself)
+     * If not provided, uses site.baseUrl from config
+     * @example 'https://example.com'
+     */
+    link?: string;
+    /**
+     * Feed language code (optional)
+     * @example 'en-US'
+     */
+    language?: string;
+    /**
+     * Copyright notice (optional)
+     * @example 'Copyright 2024 My Company'
+     */
+    copyright?: string;
+    /**
+     * Managing editor email (optional)
+     * @example 'editor@example.com (Jane Doe)'
+     */
+    managingEditor?: string;
+    /**
+     * Webmaster email (optional)
+     * @example 'webmaster@example.com (John Smith)'
+     */
+    webMaster?: string;
+    /**
+     * Feed category (optional)
+     * @example 'Technology'
+     */
+    category?: string;
+    /**
+     * TTL (Time To Live) in minutes - how long feed can be cached
+     * @example 60
+     */
+    ttl?: number;
+    /**
+     * Image for the feed (optional)
+     */
+    image?: {
+        /** URL of the image */
+        url: string;
+        /** Alt text for the image */
+        title: string;
+        /** URL the image links to */
+        link: string;
+        /** Width in pixels (max 144) */
+        width?: number;
+        /** Height in pixels (max 400) */
+        height?: number;
+    };
+    /**
+     * Content directory patterns to include in this feed.
+     * Uses glob patterns to match content files.
+     * @example ['blog/**', 'news/**']
+     */
+    contentPatterns?: string[];
+    /**
+     * Glob patterns for pages to exclude from feed
+     * @example ['**\/draft-*', '**\/index.md']
+     */
+    excludePatterns?: string[];
+    /**
+     * Custom filter function for fine-grained control over item inclusion
+     * @param page - The page to potentially include
+     * @returns true to include, false to exclude
+     */
+    filter?: (page: PageModel) => boolean;
+    /**
+     * Maximum number of items to include in the feed
+     * @example 20
+     */
+    maxItems?: number;
+    /**
+     * How to sort items (default: by publishedAt date, newest first)
+     * - 'date-desc': Newest first (default)
+     * - 'date-asc': Oldest first
+     * - 'title-asc': Alphabetically by title
+     * - 'title-desc': Reverse alphabetically by title
+     * - 'custom': Use the sortFn function
+     */
+    sortBy?: 'date-desc' | 'date-asc' | 'title-asc' | 'title-desc' | 'custom';
+    /**
+     * Custom sort function when sortBy is 'custom'
+     * @param a - First page to compare
+     * @param b - Second page to compare
+     * @returns Negative if a < b, positive if a > b, 0 if equal
+     */
+    sortFn?: (a: PageModel, b: PageModel) => number;
+    /**
+     * Field mappings for RSS item elements.
+     * Maps RSS fields to page properties or functions.
+     */
+    itemMapping?: {
+        /**
+         * Title for each item
+         * Can be:
+         * - A string property name from frontMatter (e.g., 'title')
+         * - A function that returns the title
+         * @default 'title'
+         */
+        title?: string | ((page: PageModel) => string);
+        /**
+         * Description for each item
+         * Can be:
+         * - A string property name from frontMatter (e.g., 'description', 'excerpt')
+         * - A function that returns the description
+         * @default 'description'
+         */
+        description?: string | ((page: PageModel) => string);
+        /**
+         * Link for each item (URL to the page)
+         * By default uses the page's URL
+         * Can be customized with a function
+         */
+        link?: (page: PageModel, config: StatiConfig) => string;
+        /**
+         * Publication date for each item
+         * Can be:
+         * - A string property name from frontMatter (e.g., 'publishedAt', 'date')
+         * - A function that returns a Date or string
+         * @default 'publishedAt' or 'date'
+         */
+        pubDate?: string | ((page: PageModel) => Date | string);
+        /**
+         * Author for each item
+         * Can be:
+         * - A string property name from frontMatter (e.g., 'author')
+         * - A function that returns the author string
+         */
+        author?: string | ((page: PageModel) => string | undefined);
+        /**
+         * Category/categories for each item
+         * Can be:
+         * - A string property name from frontMatter (e.g., 'tags', 'category')
+         * - A function that returns string or array of strings
+         */
+        category?: string | ((page: PageModel) => string | string[] | undefined);
+        /**
+         * GUID (globally unique identifier) for each item
+         * By default uses the page URL
+         * Can be customized with a function
+         */
+        guid?: (page: PageModel, config: StatiConfig) => string;
+        /**
+         * Whether to include full HTML content in description
+         * If true, uses the rendered HTML content
+         * If false, uses description field only
+         * @default false
+         */
+        includeContent?: boolean;
+    };
+    /**
+     * Custom enclosures (e.g., podcast episodes, media files)
+     * Function that returns enclosure data for a page, or undefined if none
+     */
+    enclosure?: (page: PageModel) => {
+        url: string;
+        length: number;
+        type: string;
+    } | undefined;
+    /**
+     * Custom namespaces to add to the RSS feed
+     * @example { 'content': 'http://purl.org/rss/1.0/modules/content/' }
+     */
+    namespaces?: Record<string, string>;
+    /**
+     * Custom XML elements to add to each item
+     * Useful for extending RSS with custom tags
+     * @example (page) => ({ 'customTag': page.frontMatter.customValue })
+     */
+    customItemElements?: (page: PageModel) => Record<string, string | number | boolean | undefined>;
+}
+/**
+ * Main RSS configuration.
+ * Can define multiple feeds with different content and settings.
+ */
+export interface RSSConfig {
+    /**
+     * Enable RSS feed generation (default: false)
+     * RSS feeds are only generated in production builds, not in dev mode
+     */
+    enabled?: boolean;
+    /**
+     * Array of feed configurations.
+     * Each feed can target different content with different settings.
+     *
+     * @example
+     * ```typescript
+     * feeds: [
+     *   {
+     *     filename: 'feed.xml',
+     *     title: 'My Blog',
+     *     description: 'Latest posts',
+     *     contentPatterns: ['blog/**']
+     *   },
+     *   {
+     *     filename: 'news.xml',
+     *     title: 'News Feed',
+     *     description: 'Latest news',
+     *     contentPatterns: ['news/**']
+     *   }
+     * ]
+     * ```
+     */
+    feeds: RSSFeedConfig[];
+}
+/**
+ * Result of RSS feed generation.
+ * Contains metadata about the generated feed.
+ */
+export interface RSSGenerationResult {
+    /** Filename of the generated feed */
+    filename: string;
+    /** Number of items in the feed */
+    itemCount: number;
+    /** Size of the feed in bytes */
+    sizeInBytes: number;
+    /** Generated RSS XML content */
+    xml: string;
+}
+//# sourceMappingURL=rss.d.ts.map

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

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

package/dist/types/rss.js

@@ -0,0 +1,4 @@
+/**
+ * RSS feed generation type definitions
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.10.2",
+  "version": "1.11.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",