npm - @stati/core - Versions diffs - 1.7.0 → 1.8.0 - Mend

@stati/core 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +615 -100
package/dist/core/build.js +2 -2
package/dist/seo/auto-inject.js +2 -2
package/dist/seo/generator.d.ts.map +1 -1
package/dist/seo/generator.js +4 -4
package/dist/seo/sitemap.d.ts.map +1 -1
package/dist/seo/sitemap.js +10 -2
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,70 +1,248 @@
 # @stati/core
-The core engine for Stati, a lightweight TypeScript static site generator built with modern architecture.
+**The core engine powering Stati — a minimal, TypeScript-first static site generator that's fast to learn and even faster to build with.**
-## Installation
+Built for developers who want modern tooling without the complexity. Write in Markdown, template with Eta, and deploy anywhere.
+---
+## Getting Started
+### The Easy Way (Recommended)
+If you're new to Stati, start with our scaffolding tool:
+```bash
+npx create-stati my-site
+cd my-site
+npm install
+npm run dev
+```
+This creates a complete Stati project with sensible defaults, your choice of CSS framework, and everything configured for you.
+### Using the Core Package Directly
+For advanced users who want programmatic control or to integrate Stati into existing tooling:
 ```bash
 npm install @stati/core
 ```
-## Usage
+---
-### Basic Setup
+## Quick Example
-```typescript
-import { build, createDevServer, defineConfig, loadConfig } from '@stati/core';
+Here's how simple it is to build a static site with Stati:
+**1. Create a configuration file (`stati.config.js`):**
-// Define configuration
-const config = defineConfig({
-  srcDir: './site',
-  outDir: './dist',
-  staticDir: './public',
+```javascript
+import { defineConfig } from '@stati/core';
+export default defineConfig({
   site: {
     title: 'My Site',
     baseUrl: 'https://example.com',
   },
 });
+```
-// Load configuration and build site
-await build({
-  clean: false,
-  force: false,
-  includeDrafts: false,
-});
+**2. Add some content (`site/index.md`):**
+```markdown
+---
+title: Welcome
+---
+# Hello Stati
+This is my first page. It's just Markdown.
+```
-// Or start development server
+**3. Build or develop:**
+```typescript
+import { build, createDevServer } from '@stati/core';
+// Development with live reload
 const server = await createDevServer({
   port: 3000,
   open: true,
 });
+// Or build for production
+const stats = await build({
+  clean: true,
+});
+```
+That's it! Your site is ready.
+---
+## Why Choose @stati/core?
+### For New Users
+- **Zero Configuration Required** — Works out of the box with sensible defaults
+- **Simple File Structure** — Markdown files automatically become pages
+- **Live Reload Built-In** — See changes instantly during development
+- **SEO Ready** — Automatic meta tags and structured data
+### For Advanced Users
+- **Programmatic API** — Full control over the build process
+- **TypeScript-First** — Complete type safety throughout
+- **Extensible Hooks** — Customize every stage of the build
+- **Smart Caching** — Incremental builds with intelligent invalidation
+---
+## Core Concepts
+### How Stati Works
+Stati uses a simple, file-based approach:
+```text
+my-site/
+├── site/           # Your content (Markdown + templates)
+│   ├── index.md    # Homepage → /
+│   └── blog/
+│       └── hello.md # Blog post → /blog/hello/
+├── public/         # Static assets (CSS, images)
+└── stati.config.js # Configuration (optional)
+```
+**The workflow:**
+1. Write content in Markdown with front-matter
+2. Stati processes it through templates
+3. Static HTML is generated with smart caching
+4. Deploy anywhere (Netlify, Vercel, GitHub Pages, etc.)
+### Key Features
+#### Markdown-First Content
+Write naturally with front-matter for metadata:
+```markdown
+---
+title: My Post
+description: A great article
+date: 2024-01-15
+tags: [tutorial, stati]
+---
+# My Post
+Your content here...
 ```
-### Configuration
+#### Flexible Templating
+Customize layouts with [Eta templates](https://eta.js.org):
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= stati.page.title %></title>
+  </head>
+  <body>
+    <%~ stati.page.content %>
+  </body>
+</html>
+```
+#### Incremental Static Generation (ISG)
+Only rebuild what changed:
+- Smart caching based on file modification times
+- TTL-based refresh for dynamic content
+- Tag-based invalidation for related content
 ```typescript
+import { invalidate } from '@stati/core';
+// Invalidate by tag
+await invalidate('tag:blog');
+// Invalidate by path
+await invalidate('path:/posts');
+// Invalidate old content (3+ months)
+await invalidate('age:3months');
+```
+#### Built-In SEO
+SEO optimization works automatically with zero configuration:
+- Meta tags (title, description, keywords)
+- Open Graph for social sharing
+- Twitter Cards
+- Structured data (JSON-LD)
+Enable sitemap and robots.txt with one config option.
+---
+## Complete Configuration Reference
+Stati works with **zero configuration**, but you can customize every aspect when needed.
+### Minimal Setup (Recommended for Beginners)
+```javascript
 import { defineConfig } from '@stati/core';
 export default defineConfig({
-  // Source directory for content files
-  srcDir: './site',
+  site: {
+    title: 'My Stati Site',
+    baseUrl: 'https://example.com',
+  },
+});
+```
-  // Output directory for built site
-  outDir: './dist',
+This is all you need! Stati automatically enables:
-  // Static assets directory
-  staticDir: './public',
+- **ISG caching** with 6-hour TTL
+- **SEO auto-injection** for all pages
+- **Markdown processing** with standard features
+### Extended Configuration (Common Options)
+Below are commonly used configuration options. This is **not a complete list** — see the [full configuration documentation](https://docs.stati.build/configuration/) for all available options.
+```javascript
+import { defineConfig } from '@stati/core';
+export default defineConfig({
+  // Directory configuration
+  srcDir: 'site',           // Content source (default: 'site')
+  outDir: 'dist',           // Build output (default: 'dist')
+  staticDir: 'public',      // Static assets (default: 'public')
   // Site metadata
   site: {
-    title: 'My Site',
+    title: 'My Stati Site',
     baseUrl: 'https://example.com',
+    defaultLocale: 'en-US',
   },
-  // Markdown configuration
+  // Markdown processing
   markdown: {
-    plugins: ['anchor'],
+    plugins: [
+      'anchor',                                      // Anchor links to headings
+      'toc-done-right',                             // Table of contents
+      ['external-links', { externalTarget: '_blank' }], // External links in new tab
+    ],
     configure: (md) => {
+      // Configure MarkdownIt instance directly
       md.set({
         html: true,
         linkify: true,
@@ -73,21 +251,61 @@ export default defineConfig({
     },
   },
-  // Eta template configuration
+  // Eta template engine
   eta: {
     filters: {
-      // Custom template filters
+      formatDate: (date) => new Date(date).toLocaleDateString('en-US'),
+      slugify: (text) => text.toLowerCase().replace(/\s+/g, '-'),
     },
   },
-  // Incremental Static Generation
+  // Incremental Static Generation (enabled by default)
   isg: {
-    enabled: true,
-    ttlSeconds: 3600,
-    maxAgeCapDays: 30,
+    ttlSeconds: 86400,        // Cache TTL: 24 hours (default: 21600 / 6 hours)
+    maxAgeCapDays: 30,        // Max age for aging rules (default: 365)
+    aging: [
+      { untilDays: 7, ttlSeconds: 86400 },   // 1 day cache for week-old content
+      { untilDays: 30, ttlSeconds: 604800 }, // 1 week cache for month-old content
+    ],
+  },
+  // SEO configuration (auto-injection enabled by default)
+  seo: {
+    defaultAuthor: {
+      name: 'John Doe',
+      email: 'john@example.com',
+      url: 'https://johndoe.com',
+    },
+    debug: false,             // Enable SEO debug logging
+  },
+  // Sitemap generation (opt-in)
+  sitemap: {
+    enabled: true,            // Generate sitemap.xml
+    defaultPriority: 0.5,     // Default priority for pages
+    defaultChangeFreq: 'monthly',
+    excludePatterns: ['/draft/**', '/admin/**'], // Exclude patterns
+    priorityRules: [
+      { pattern: '/', priority: 1.0 },           // Homepage highest priority
+      { pattern: '/blog/**', priority: 0.8 },    // Blog posts high priority
+      { pattern: '/docs/**', priority: 0.7 },    // Documentation
+    ],
+  },
+  // Robots.txt generation (opt-in)
+  robots: {
+    enabled: true,            // Generate robots.txt
+    disallow: ['/admin/', '/draft/', '/private/'], // Paths to block
+    crawlDelay: 10,           // Crawl delay in seconds
+    sitemap: true,            // Auto-include sitemap URL
+    customLines: [
+      '# Custom directives',
+      'User-agent: GPTBot',
+      'Disallow: /',
+    ],
   },
-  // Development server options
+  // Development server
   dev: {
     port: 3000,
     host: 'localhost',
@@ -109,161 +327,458 @@ export default defineConfig({
 });
 ```
-## API
+> **For the complete configuration reference** including all options, advanced features, and detailed explanations, see the [Configuration Guide](https://docs.stati.build/configuration/).
+---
-### Core Functions
+## API Reference
-#### `build(options: BuildOptions): Promise<BuildStats>`
+### Build Functions
-Build a static site.
+#### `build(options?: BuildOptions): Promise<BuildStats>`
+Build your static site for production.
+**Options:**
+```typescript
+{
+  force?: boolean;        // Force rebuild of all pages (ignores cache)
+  clean?: boolean;        // Clean output directory before build
+  includeDrafts?: boolean; // Include draft pages in build
+  configPath?: string;    // Custom config file path
+}
+```
+**Example:**
 ```typescript
 import { build } from '@stati/core';
-await build({
-  force: false,        // Force rebuild of all pages
-  clean: false,        // Clean output directory before build
-  includeDrafts: false, // Include draft pages in build
-  configPath: './stati.config.js', // Custom config file path
+const stats = await build({
+  clean: true,
+  force: false,
+  includeDrafts: false,
 });
+console.log(`Built ${stats.totalPages} pages in ${stats.buildTimeMs}ms`);
 ```
-#### `createDevServer(options: DevServerOptions): Promise<DevServer>`
+**Returns:** Build statistics including pages built, duration, and cache hits.
+---
+#### `createDevServer(options?: DevServerOptions): Promise<DevServer>`
-Create a development server with live reload.
+Start a development server with live reload.
+**Options:**
+```typescript
+{
+  port?: number;          // Port number (default: 3000)
+  host?: string;          // Host address (default: 'localhost')
+  open?: boolean;         // Auto-open browser (default: false)
+  configPath?: string;    // Custom config file path
+}
+```
+**Example:**
 ```typescript
 import { createDevServer } from '@stati/core';
 const server = await createDevServer({
   port: 3000,
-  host: 'localhost',
   open: true,
-  configPath: './stati.config.js',
 });
+console.log(`Dev server running at http://localhost:3000`);
+```
+**Returns:** Server instance with methods to stop and restart.
+---
+#### `createPreviewServer(options?: PreviewServerOptions): Promise<PreviewServer>`
+Start a production preview server to test your built site locally.
+**Options:**
+```typescript
+{
+  port?: number;          // Port number (default: 4000)
+  host?: string;          // Host address (default: 'localhost')
+  open?: boolean;         // Auto-open browser (default: false)
+  configPath?: string;    // Custom config file path
+}
+```
+**Example:**
+```typescript
+import { createPreviewServer } from '@stati/core';
+// First build your site
+await build({ clean: true });
+// Then preview it
+const server = await createPreviewServer({
+  port: 4000,
+  open: true,
+});
+console.log(`Preview server running at http://localhost:4000`);
 ```
+**Returns:** Server instance with methods to stop.
+**Note:** Unlike `createDevServer`, the preview server serves the static files from your `dist/` directory without live reload or rebuilding. This is useful for testing your production build locally before deployment.
+---
 #### `invalidate(query?: string): Promise<InvalidationResult>`
 Invalidate cache by tags, paths, patterns, or age.
+**Query Syntax:**
+- `tag:blog` — Invalidate pages with specific tag
+- `path:/posts` — Invalidate pages under path
+- `glob:/blog/**` — Invalidate by glob pattern
+- `age:3months` — Invalidate content younger than 3 months
+- No query — Clear entire cache
+**Examples:**
 ```typescript
 import { invalidate } from '@stati/core';
 // Invalidate by tag
-await invalidate('tag:blog');
+await invalidate('tag:news');
 // Invalidate by path prefix
-await invalidate('path:/posts');
-// Invalidate by glob pattern
-await invalidate('glob:/blog/**');
+await invalidate('path:/blog/2024/');
-// Invalidate content younger than 3 months (exact calendar arithmetic)
-await invalidate('age:3months');
+// Invalidate old content
+await invalidate('age:6months');
 // Multiple criteria (OR logic)
 await invalidate('tag:blog age:1month');
-// Clear entire cache
+// Clear everything
 await invalidate();
 ```
-### Configuration
+**Returns:** Invalidation result with count of pages affected.
+---
 #### `defineConfig(config: StatiConfig): StatiConfig`
 Define a type-safe configuration with full TypeScript support.
+**Example:**
 ```typescript
 import { defineConfig } from '@stati/core';
 export default defineConfig({
-  // Your configuration here
+  site: {
+    title: 'My Site',
+    baseUrl: 'https://example.com',
+  },
+  // TypeScript provides autocomplete and validation
 });
 ```
+---
 #### `loadConfig(cwd?: string): Promise<StatiConfig>`
-Load and validate Stati configuration from the project directory.
+Load and validate Stati configuration from a project directory.
+**Example:**
 ```typescript
 import { loadConfig } from '@stati/core';
-const config = await loadConfig(); // Load from current directory
-const config2 = await loadConfig('/path/to/project'); // Load from specific directory
+// Load from current directory
+const config = await loadConfig();
+// Load from specific directory
+const config2 = await loadConfig('/path/to/project');
 ```
-## Types
+---
-The package exports comprehensive TypeScript types:
+### TypeScript Types
+Full type definitions for TypeScript users:
 ```typescript
 import type {
+  // Configuration
   StatiConfig,
+  ISGConfig,
+  BuildHooks,
+  // Build
   BuildOptions,
-  DevServerOptions,
-  InvalidationResult,
-  PageModel,
-  FrontMatter,
   BuildContext,
+  BuildStats,
+  // Pages
+  PageModel,
   PageContext,
-  BuildHooks,
+  FrontMatter,
+  // Navigation
   NavNode,
-  ISGConfig,
+  // Development
+  DevServerOptions,
+  PreviewServerOptions,
+  // Cache
+  InvalidationResult,
   AgingRule,
-  BuildStats,
 } from '@stati/core/types';
 ```
-## Features
+> **Need more types?** This is a curated list of commonly used types. For the complete type reference including all SEO, sitemap, and configuration types, see the [API Types Documentation](https://docs.stati.build/api/types/).
+---
+## Features Deep Dive
 ### Markdown Processing
-- **Front-matter support** with YAML, TOML, or JSON
-- **Plugin system** using markdown-it ecosystem
-- **Custom rendering** with configurable options
-- **Draft pages** with `draft: true` in front-matter
+Stati supports rich Markdown features out of the box:
+- **Front-matter** — YAML, TOML, or JSON metadata
+- **Plugins** — Full markdown-it ecosystem compatibility
+- **Syntax highlighting** — Code blocks with language support
+- **Custom rendering** — Configure parser behavior
+- **Draft mode** — Mark pages as `draft: true`
+**Example with plugins:**
+```javascript
+export default defineConfig({
+  markdown: {
+    plugins: [
+      'anchor',                    // Add anchor links
+      'table',                     // Enhanced tables
+      'footnote',                  // Footnote support
+      ['abbr', { /* options */ }], // Abbreviations
+    ],
+  },
+});
+```
 ### Template Engine
-- **Eta templates** with layouts and partials
-- **Template inheritance** with `layout` front-matter property
-- **Custom helpers** and filters
-- **Hot reload** during development
+Powered by [Eta](https://eta.js.org) for fast, flexible templates:
+- **Layouts** — Template inheritance via `layout` property
+- **Partials** — Reusable components
+- **Custom filters** — Transform data in templates
+- **Type-safe helpers** — Access page data with autocomplete
+- **Hot reload** — See template changes instantly
+**Template structure:**
+```html
+<!-- site/layout.eta -->
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= stati.page.title %> - <%= stati.site.title %></title>
+  </head>
+  <body>
+    <%~ include('_partials/header') %>
+    <main>
+      <%~ stati.page.content %>
+    </main>
+    <%~ include('_partials/footer') %>
+  </body>
+</html>
+```
 ### Navigation System
-- **Automatic hierarchy** based on filesystem structure
-- **Breadcrumbs** and navigation trees
-- **Custom sorting** with `order` front-matter property
-- **Index pages** with special handling
+Automatic navigation hierarchy based on your file structure:
+- **Auto-generated tree** — Reflects directory structure
+- **Breadcrumbs** — Parent-child relationships
+- **Custom ordering** — Use `order` in front-matter
+- **Index pages** — Special handling for `index.md`
+**Access in templates:**
+```html
+<!-- Show breadcrumbs -->
+<nav>
+  <% stati.page.breadcrumbs.forEach(crumb => { %>
+    <a href="<%= crumb.url %>"><%= crumb.title %></a>
+  <% }) %>
+</nav>
+<!-- Show navigation tree -->
+<ul>
+  <% stati.navigation.forEach(item => { %>
+    <li><a href="<%= item.url %>"><%= item.title %></a></li>
+  <% }) %>
+</ul>
+```
+### Development Experience
-### Development Server
+Built for productivity:
-- **Live reload** with WebSocket integration
-- **Hot rebuilding** on file changes
-- **Static asset serving** from public directory
-- **Error overlay** for development debugging
+- **Live reload** — WebSocket-based instant updates
+- **Fast rebuilds** — Only rebuild changed pages
+- **Error overlay** — See build errors in browser
+- **Static assets** — Served from `public/` directory
+- **Source maps** — Debug with original code
 ### Caching & Performance
-- **Smart caching** based on file modification times
-- **Incremental builds** for faster rebuilds
-- **Tag-based invalidation** for selective cache clearing
-- **Memory optimization** for large sites
+Smart caching for lightning-fast builds:
-## Architecture
+- **Modification tracking** — Rebuild only changed files
+- **Incremental builds** — Skip unchanged pages
+- **Tag invalidation** — Update related content together
+- **TTL-based refresh** — Control cache lifetime
+- **Age-based rules** — Different TTL for old content
-Stati Core is built with a modular architecture:
+**Cache strategies:**
-- **Content processing** - Markdown parsing and front-matter extraction
-- **Template rendering** - Eta engine with layouts and partials
-- **Navigation building** - Automatic hierarchy generation
-- **Asset handling** - Static file copying and optimization
-- **Development server** - Live reload and hot rebuilding
-- **Build system** - Production optimization and output generation
+```javascript
+export default defineConfig({
+  isg: {
+    ttlSeconds: 21600,     // 6 hours default
+    aging: [
+      { untilDays: 7, ttlSeconds: 3600 },    // Recent: 1 hour
+      { untilDays: 30, ttlSeconds: 86400 },  // Month: 1 day
+      // Older content uses default TTL
+    ],
+  },
+});
+```
+---
+## Use Cases
+### Documentation Sites
+Perfect for technical documentation:
+```javascript
+export default defineConfig({
+  site: {
+    title: 'My Project Docs',
+    baseUrl: 'https://docs.example.com',
+  },
+  markdown: {
+    plugins: ['anchor', 'toc-done-right', 'container'],
+  },
+});
+```
+### Blogs
+Great for content-heavy sites:
+```javascript
+export default defineConfig({
+  site: {
+    title: 'My Blog',
+    baseUrl: 'https://blog.example.com',
+  },
+  isg: {
+    aging: [
+      { untilDays: 30, ttlSeconds: 3600 },   // Fresh posts: 1 hour
+      { untilDays: 365, ttlSeconds: 86400 }, // Year-old: 1 day
+    ],
+  },
+});
+```
+### Landing Pages
+Fast, SEO-optimized marketing sites:
+```javascript
+export default defineConfig({
+  site: {
+    title: 'Product Name',
+    baseUrl: 'https://example.com',
+  },
+  seo: {
+    defaultAuthor: {
+      name: 'Company Name',
+      url: 'https://example.com',
+    },
+  },
+});
+```
+---
+## Requirements
+- **Node.js** 22.0.0 or higher
+- **npm** 8.0.0 or higher (or equivalent package manager)
+---
+## Learn More
+- [**Full Documentation**](https://docs.stati.build) — Complete guides and tutorials
+- [**Configuration Guide**](https://docs.stati.build/configuration/) — All options explained
+- [**API Reference**](https://docs.stati.build/api/) — Detailed API docs
+- [**Examples**](https://docs.stati.build/examples/) — Real-world projects
+- [**Contributing**](https://github.com/ianchak/stati/blob/main/CONTRIBUTING.md) — Help improve Stati
+---
+## Philosophy
+Stati Core is built on these principles:
+- **Simplicity First** — Sensible defaults that just work
+- **Performance Matters** — Fast builds, smart caching
+- **Developer Experience** — Great tooling, clear errors
+- **Type Safety** — TypeScript throughout
+- **Extensibility** — Customize when you need to
+---
+## Support & Community
+- [GitHub Issues](https://github.com/ianchak/stati/issues) — Report bugs or request features
+- [Discussions](https://github.com/ianchak/stati/discussions) — Ask questions, share ideas
+- [Documentation](https://docs.stati.build) — Comprehensive guides
+---
 ## License
 MIT © [Imre Csige](https://github.com/ianchak)
+---
+**Ready to build?**
+```bash
+# New project (easiest way)
+npx create-stati my-site
+# Or use core directly
+npm install @stati/core
+```

package/dist/core/build.js CHANGED Viewed

@@ -352,8 +352,6 @@ async function buildInternal(options = {}) {
     logger.building('Building your site...');
     // Load configuration
     const { config, outDir, cacheDir } = await loadAndValidateConfig(options);
-    // Load cache manifest for ISG
-    const { manifest } = await setupCacheAndManifest(cacheDir);
     // Initialize cache stats
     let cacheHits = 0;
     let cacheMisses = 0;
@@ -364,6 +362,8 @@ async function buildInternal(options = {}) {
         await remove(cacheDir);
     }
     await ensureDir(outDir);
+    // Load cache manifest for ISG (after potential clean operation)
+    const { manifest } = await setupCacheAndManifest(cacheDir);
     // Load content and build navigation
     console.log(); // Add spacing before content loading
     const { pages, navigation, md, eta } = await loadContentAndBuildNavigation(config, options, logger);

package/dist/seo/auto-inject.js CHANGED Viewed

@@ -86,8 +86,8 @@ export function autoInjectSEO(html, options) {
     // Inject SEO metadata before </head>
     const before = html.substring(0, headClosePos);
     const after = html.substring(headClosePos);
-    // Add proper indentation (2 spaces) and newline
-    const injected = `${before}  ${seoMetadata}\n${after}`;
+    // Add proper indentation (4 spaces) and newline
+    const injected = `${before}    ${seoMetadata}\n${after}`;
     logDebug(`Injected ${existingTags.size === 0 ? 'all' : 'missing'} SEO tags into ${page.url}`, {
         debug,
         config,

package/dist/seo/generator.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/seo/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;~~AAI7C~~;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAsH3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,CAyE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,CAuDjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE;IACP,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,EACD,IAAI,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,GAChC,MAAM,CA6CR"}
1	+ {"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/seo/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAS7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAsH3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,CAyE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,CAuDjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE;IACP,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,EACD,IAAI,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,GAChC,MAAM,CA6CR"}

package/dist/seo/generator.js CHANGED Viewed

@@ -3,7 +3,7 @@
  * Generates meta tags, Open Graph tags, Twitter Cards, and structured data
  */
 import { SEOTagType } from '../types/seo.js';
-import { escapeHtml, validateSEOMetadata, generateRobotsContent } from './utils/index.js';
+import { escapeHtml, validateSEOMetadata, generateRobotsContent, resolveAbsoluteUrl, } from './utils/index.js';
 import { sanitizeStructuredData } from './utils/escape-and-validation.js';
 /**
  * Generate complete SEO metadata for a page.
@@ -94,7 +94,7 @@ export function generateSEOMetadata(ctx) {
     }
     // Canonical link
     if (shouldGenerate(SEOTagType.Canonical)) {
-        const canonical = seo.canonical || `${siteUrl}${page.url}`;
+        const canonical = seo.canonical || resolveAbsoluteUrl(page.url || '/', siteUrl);
         meta.push(`<link rel="canonical" href="${escapeHtml(canonical)}">`);
     }
     // Robots meta tag
@@ -125,7 +125,7 @@ export function generateSEOMetadata(ctx) {
         const sanitized = sanitizeStructuredData(seo.structuredData, logger);
         meta.push(`<script type="application/ld+json">${JSON.stringify(sanitized)}</script>`);
     }
-    return meta.join('\n  ');
+    return meta.join('\n    ');
 }
 /**
  * Generate Open Graph protocol meta tags.
@@ -148,7 +148,7 @@ export function generateOpenGraphTags(ctx) {
     // Basic OG tags with fallback chain
     const ogTitle = og.title || seo.title || page.frontMatter.title || config.site.title;
     const ogDescription = og.description || seo.description || page.frontMatter.description;
-    const ogUrl = og.url || seo.canonical || `${siteUrl}${page.url}`;
+    const ogUrl = og.url || seo.canonical || resolveAbsoluteUrl(page.url || '/', siteUrl);
     const ogType = og.type || 'website';
     const ogSiteName = og.siteName || config.site.title;
     tags.push(`<meta property="og:title" content="${escapeHtml(ogTitle)}">`);

package/dist/seo/sitemap.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;~~AA6ItD~~;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,aAAa,GAC3B,YAAY,GAAG,IAAI,CA4ErB;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAatF;AAoBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,aAAa,GAC3B,uBAAuB,CA8CzB"}
1	+ {"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqJtD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,aAAa,GAC3B,YAAY,GAAG,IAAI,CA4ErB;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAatF;AAoBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,aAAa,GAC3B,uBAAuB,CA8CzB"}

package/dist/seo/sitemap.js CHANGED Viewed

@@ -122,8 +122,16 @@ function determinePriority(page, rules, defaultPriority = 0.5) {
                 return validatePriority(rule.priority);
             }
         }
-        else if (page.url === pattern || page.url.startsWith(pattern)) {
-            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);
+            }
         }
     }
     return defaultPriority;

package/package.json CHANGED Viewed

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