@stati/core 1.6.1 → 1.6.2

package/README.md

@@ -13,20 +13,28 @@ npm install @stati/core
 ### Basic Setup
 
 ```typescript
-import { build, createDevServer, defineConfig } from '@stati/core';
+import { build, createDevServer, defineConfig, loadConfig } from '@stati/core';
 
 // Define configuration
 const config = defineConfig({
-  site: './site',
-  output: './dist',
-  public: './public',
+  srcDir: './site',
+  outDir: './dist',
+  staticDir: './public',
+  site: {
+    title: 'My Site',
+    baseUrl: 'https://example.com',
+  },
 });
 
-// Build site
-await build(config);
+// Load configuration and build site
+await build({
+  clean: false,
+  force: false,
+  includeDrafts: false,
+});
 
 // Or start development server
-const server = await createDevServer(config, {
+const server = await createDevServer({
   port: 3000,
   open: true,
 });
@@ -35,41 +43,67 @@ const server = await createDevServer(config, {
 ### Configuration
 
 ```typescript
-import { defineConfig } from '@stati/core/config';
+import { defineConfig } from '@stati/core';
 
 export default defineConfig({
-  // Site source directory
-  site: './site',
+  // Source directory for content files
+  srcDir: './site',
 
   // Output directory for built site
-  output: './dist',
+  outDir: './dist',
 
   // Static assets directory
-  public: './public',
+  staticDir: './public',
 
   // Site metadata
-  meta: {
+  site: {
     title: 'My Site',
-    description: 'A great static site',
-    url: 'https://example.com',
+    baseUrl: 'https://example.com',
   },
 
   // Markdown configuration
   markdown: {
-    plugins: ['markdown-it-anchor'],
-    options: {
-      html: true,
-      linkify: true,
-      typographer: true,
+    plugins: ['anchor'],
+    configure: (md) => {
+      md.set({
+        html: true,
+        linkify: true,
+        typographer: true,
+      });
     },
   },
 
-  // Template configuration
-  templates: {
-    engine: 'eta',
-    options: {
-      views: './site',
-      cache: true,
+  // Eta template configuration
+  eta: {
+    filters: {
+      // Custom template filters
+    },
+  },
+
+  // Incremental Static Generation
+  isg: {
+    enabled: true,
+    ttlSeconds: 3600,
+    maxAgeCapDays: 30,
+  },
+
+  // Development server options
+  dev: {
+    port: 3000,
+    host: 'localhost',
+    open: false,
+  },
+
+  // Build lifecycle hooks
+  hooks: {
+    beforeAll: async (ctx) => {
+      console.log(`Building ${ctx.pages.length} pages`);
+    },
+    beforeRender: async (ctx) => {
+      // Custom pre-render logic
+    },
+    afterRender: async (ctx) => {
+      // Custom post-render logic
     },
   },
 });
@@ -79,7 +113,7 @@ export default defineConfig({
 
 ### Core Functions
 
-#### `build(options: BuildOptions): Promise<void>`
+#### `build(options: BuildOptions): Promise<BuildStats>`
 
 Build a static site.
 
@@ -87,23 +121,25 @@ Build a static site.
 import { build } from '@stati/core';
 
 await build({
-  config: './stati.config.js',
-  force: false,
-  clean: false,
-  includeDrafts: false,
+  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
 });
 ```
 
-#### `createDevServer(config: StatiConfig, options: DevServerOptions): Promise<DevServer>`
+#### `createDevServer(options: DevServerOptions): Promise<DevServer>`
 
 Create a development server with live reload.
 
 ```typescript
 import { createDevServer } from '@stati/core';
 
-const server = await createDevServer(config, {
+const server = await createDevServer({
   port: 3000,
+  host: 'localhost',
   open: true,
+  configPath: './stati.config.js',
 });
 ```
 
@@ -140,13 +176,24 @@ await invalidate();
 Define a type-safe configuration with full TypeScript support.
 
 ```typescript
-import { defineConfig } from '@stati/core/config';
+import { defineConfig } from '@stati/core';
 
 export default defineConfig({
   // Your configuration here
 });
 ```
 
+#### `loadConfig(cwd?: string): Promise<StatiConfig>`
+
+Load and validate Stati configuration from the project directory.
+
+```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
+```
+
 ## Types
 
 The package exports comprehensive TypeScript types:
@@ -156,11 +203,16 @@ import type {
   StatiConfig,
   BuildOptions,
   DevServerOptions,
-  InvalidateOptions,
-  Page,
-  Navigation,
-  MarkdownOptions,
-  TemplateOptions,
+  InvalidationResult,
+  PageModel,
+  FrontMatter,
+  BuildContext,
+  PageContext,
+  BuildHooks,
+  NavNode,
+  ISGConfig,
+  AgingRule,
+  BuildStats,
 } from '@stati/core/types';
 ```
 

package/dist/constants.d.ts

@@ -22,6 +22,8 @@ export declare const CONFIG_FILE_BASE = "stati.config";
 export declare const CONFIG_FILE_PATTERNS: string[];
 /** Default development server port */
 export declare const DEFAULT_DEV_PORT = 3000;
+/** Default preview server port */
+export declare const DEFAULT_PREVIEW_PORT = 4000;
 /** Default development server host */
 export declare const DEFAULT_DEV_HOST = "localhost";
 /** Default development server base URL */

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iDAAiD;AACjD,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,iCAAiC;AACjC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,4DAA4D;AAC5D,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAIjD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AAEtE,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,UAEhC,CAAC;AAIF,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,0BAAmD,CAAC;AAIrF,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAI9C,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AAExD,yBAAyB;AACzB,eAAO,MAAM,eAAe,QAAwB,CAAC;AAErD,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAI3D,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAA0B,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD,uCAAuC;AACvC,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,SAAS,QAAkB,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAI3C,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,eAAgC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,8CAA8C;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iDAAiD;AACjD,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,iCAAiC;AACjC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,4DAA4D;AAC5D,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAIjD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AAEtE,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,UAEhC,CAAC;AAIF,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,0BAAmD,CAAC;AAIrF,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAI9C,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AAExD,yBAAyB;AACzB,eAAO,MAAM,eAAe,QAAwB,CAAC;AAErD,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAI3D,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAA0B,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD,uCAAuC;AACvC,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,SAAS,QAAkB,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAI3C,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,eAAgC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,8CAA8C;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/dist/constants.js

@@ -25,6 +25,8 @@ export const CONFIG_FILE_PATTERNS = CONFIG_FILE_EXTENSIONS.map((ext) => `${CONFI
 // === Development Server Constants ===
 /** Default development server port */
 export const DEFAULT_DEV_PORT = 3000;
+/** Default preview server port */
+export const DEFAULT_PREVIEW_PORT = 4000;
 /** Default development server host */
 export const DEFAULT_DEV_HOST = 'localhost';
 /** Default development server base URL */

package/dist/core/preview.d.ts

@@ -1,9 +1,14 @@
 import type { Logger } from '../types/index.js';
 export interface PreviewServerOptions {
+    /** Port for preview server (default: 4000) */
     port?: number;
+    /** Host for preview server (default: 'localhost') */
     host?: string;
+    /** Whether to open browser automatically (default: false) */
     open?: boolean;
+    /** Path to config file */
     configPath?: string;
+    /** Logger instance */
     logger?: Logger;
 }
 export interface PreviewServer {

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA2JxB"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA2JxB"}

package/dist/core/preview.js

@@ -4,7 +4,7 @@ import { readFile } from 'fs/promises';
 import { loadConfig } from '../config/loader.js';
 import { resolveDevPaths } from './utils/paths.js';
 import { resolvePrettyUrl } from './utils/server.js';
-import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST } from '../constants.js';
+import { DEFAULT_PREVIEW_PORT, DEFAULT_DEV_HOST } from '../constants.js';
 /**
  * Loads and validates configuration for the preview server.
  */
@@ -27,7 +27,7 @@ async function loadPreviewConfig(configPath, logger) {
  * without live reload functionality, perfect for previewing the production build.
  */
 export async function createPreviewServer(options = {}) {
-    const { port = DEFAULT_DEV_PORT, host = DEFAULT_DEV_HOST, open = false, configPath, logger = {
+    const { port = DEFAULT_PREVIEW_PORT, host = DEFAULT_DEV_HOST, open = false, configPath, logger = {
         info: () => { },
         success: () => { },
         error: (msg) => console.error(msg),

package/package.json

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