@stati/core 1.14.0 → 1.15.1

package/dist/core/utils/typescript.utils.js

@@ -1,21 +1,26 @@
 /**
  * TypeScript compilation utilities using esbuild.
  * Provides functions for compiling TypeScript files and watching for changes.
+ * Supports multiple bundles with per-page targeting.
  * @module core/utils/typescript
  */
 import * as esbuild from 'esbuild';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 import { pathExists } from './fs.utils.js';
-import { DEFAULT_TS_SRC_DIR, DEFAULT_TS_OUT_DIR, DEFAULT_TS_ENTRY_POINT, DEFAULT_TS_BUNDLE_NAME, DEFAULT_OUT_DIR, } from '../../constants.js';
+import { validateUniqueBundleNames } from './bundle-matching.utils.js';
+import { DEFAULT_TS_SRC_DIR, DEFAULT_TS_OUT_DIR, DEFAULT_BUNDLES, DEFAULT_OUT_DIR, } from '../../constants.js';
+/**
+ * Resolves TypeScript config with defaults based on mode.
+ * @internal
+ */
 function resolveConfig(config, mode) {
     const isProduction = mode === 'production';
     return {
         enabled: config.enabled,
         srcDir: config.srcDir ?? DEFAULT_TS_SRC_DIR,
         outDir: config.outDir ?? DEFAULT_TS_OUT_DIR,
-        entryPoint: config.entryPoint ?? DEFAULT_TS_ENTRY_POINT,
-        bundleName: config.bundleName ?? DEFAULT_TS_BUNDLE_NAME,
+        bundles: config.bundles ?? [...DEFAULT_BUNDLES],
         // hash/minify: always false in dev (config ignored), configurable in prod (default true)
         hash: isProduction && (config.hash ?? true),
         minify: isProduction && (config.minify ?? true),
@@ -24,136 +29,196 @@ function resolveConfig(config, mode) {
     };
 }
 /**
- * Compile TypeScript files using esbuild.
- * Returns the generated bundle filename for template injection.
- *
- * @param options - Compilation options
- * @returns The compilation result with bundle filename
- *
- * @example
- * ```typescript
- * const result = await compileTypeScript({
- *   projectRoot: process.cwd(),
- *   config: { enabled: true },
- *   mode: 'production',
- *   logger: console,
- * });
- * console.log(result.bundleFilename); // 'bundle-a1b2c3d4.js'
- * ```
+ * Compile a single bundle using esbuild.
+ * @internal
  */
-export async function compileTypeScript(options) {
-    const { projectRoot, config, mode, logger, outDir: globalOutDir } = options;
-    const resolved = resolveConfig(config, mode);
-    const entryPath = path.join(projectRoot, resolved.srcDir, resolved.entryPoint);
-    // Output to configured build output directory (default: dist)
-    const outDir = path.join(projectRoot, globalOutDir || DEFAULT_OUT_DIR, resolved.outDir);
+async function compileSingleBundle(bundleConfig, resolvedConfig, projectRoot, globalOutDir, logger) {
+    const entryPath = path.join(projectRoot, resolvedConfig.srcDir, bundleConfig.entryPoint);
+    const outDir = path.join(projectRoot, globalOutDir, resolvedConfig.outDir);
     // Validate entry point exists
     if (!(await pathExists(entryPath))) {
-        logger.warning(`TypeScript entry point not found: ${entryPath}`);
-        logger.warning('Skipping TypeScript compilation.');
-        return {};
+        logger.warning(`TypeScript entry point not found: ${entryPath} (bundle: ${bundleConfig.bundleName})`);
+        return null;
     }
-    logger.info(''); // Add empty line before TypeScript compilation
-    logger.info('Compiling TypeScript...');
     try {
         const result = await esbuild.build({
             entryPoints: [entryPath],
             bundle: true,
             outdir: outDir,
-            entryNames: resolved.hash ? `${resolved.bundleName}-[hash]` : resolved.bundleName,
-            minify: resolved.minify,
-            sourcemap: resolved.sourceMaps,
+            entryNames: resolvedConfig.hash
+                ? `${bundleConfig.bundleName}-[hash]`
+                : bundleConfig.bundleName,
+            minify: resolvedConfig.minify,
+            sourcemap: resolvedConfig.sourceMaps,
             target: 'es2022',
             format: 'esm',
             platform: 'browser',
             logLevel: 'silent',
             metafile: true,
         });
-        // Extract the generated filename for template injection
+        // Extract the generated filename for this bundle
         const outputs = Object.keys(result.metafile?.outputs ?? {});
         const bundleFile = outputs.find((f) => f.endsWith('.js'));
-        const bundleFilename = bundleFile ? path.basename(bundleFile) : `${resolved.bundleName}.js`;
-        logger.success(`TypeScript compiled: ${bundleFilename}`);
-        return { bundleFilename };
+        const bundleFilename = bundleFile ? path.basename(bundleFile) : `${bundleConfig.bundleName}.js`;
+        // Construct the path relative to site root
+        const bundlePath = path.posix.join('/', resolvedConfig.outDir, bundleFilename);
+        return {
+            config: bundleConfig,
+            filename: bundleFilename,
+            path: bundlePath,
+        };
     }
     catch (error) {
         if (error instanceof Error) {
-            logger.error(`TypeScript compilation failed: ${error.message}`);
+            logger.error(`Bundle '${bundleConfig.bundleName}' compilation failed: ${error.message}`);
         }
         throw error;
     }
 }
+/**
+ * Compile TypeScript files using esbuild.
+ * Supports multiple bundles with parallel compilation.
+ *
+ * @param options - Compilation options
+ * @returns Array of compilation results for each bundle
+ *
+ * @example
+ * ```typescript
+ * const results = await compileTypeScript({
+ *   projectRoot: process.cwd(),
+ *   config: {
+ *     enabled: true,
+ *     bundles: [
+ *       { entryPoint: 'core.ts', bundleName: 'core' },
+ *       { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }
+ *     ]
+ *   },
+ *   mode: 'production',
+ *   logger: console,
+ * });
+ * console.log(results[0].bundlePath); // '/_assets/core-a1b2c3d4.js'
+ * ```
+ */
+export async function compileTypeScript(options) {
+    const { projectRoot, config, mode, logger, outDir: globalOutDir } = options;
+    const resolved = resolveConfig(config, mode);
+    const outputDir = globalOutDir || DEFAULT_OUT_DIR;
+    // Handle empty bundles array
+    if (resolved.bundles.length === 0) {
+        logger.warning('TypeScript is enabled but no bundles are configured. Add bundles to your stati.config.ts or disable TypeScript.');
+        return [];
+    }
+    // Validate unique bundle names early - fail fast with clear error message
+    validateUniqueBundleNames(resolved.bundles);
+    logger.info('');
+    logger.info(`Compiling TypeScript (${resolved.bundles.length} bundle${resolved.bundles.length > 1 ? 's' : ''})...`);
+    // Compile all bundles in parallel
+    const compilationPromises = resolved.bundles.map((bundleConfig) => compileSingleBundle(bundleConfig, resolved, projectRoot, outputDir, logger));
+    const results = await Promise.all(compilationPromises);
+    // Filter out null results (skipped bundles) and collect successful ones
+    const successfulResults = results.filter((r) => r !== null);
+    if (successfulResults.length > 0) {
+        const bundleNames = successfulResults.map((r) => r.filename).join(', ');
+        logger.success(`TypeScript compiled: ${bundleNames}`);
+    }
+    else if (resolved.bundles.length > 0) {
+        logger.warning('No TypeScript bundles were compiled (all entry points missing).');
+    }
+    return successfulResults;
+}
 /**
  * Create an esbuild watch context for development.
  * Watches for TypeScript file changes and recompiles automatically.
+ * Supports multiple bundles with selective recompilation.
  *
  * @param options - Watch options including rebuild callback
- * @returns The esbuild build context for cleanup
+ * @returns Array of esbuild build contexts for cleanup
  *
  * @example
  * ```typescript
- * const watcher = await createTypeScriptWatcher({
+ * const watchers = await createTypeScriptWatcher({
  *   projectRoot: process.cwd(),
  *   config: { enabled: true },
- *   mode: 'development',
  *   logger: console,
- *   onRebuild: () => console.log('Rebuilt!'),
+ *   onRebuild: (results, compileTimeMs) => console.log(`Rebuilt ${results.length} bundles in ${compileTimeMs}ms`),
  * });
  *
  * // Later, cleanup:
- * await watcher.dispose();
+ * await Promise.all(watchers.map(w => w.dispose()));
  * ```
  */
 export async function createTypeScriptWatcher(options) {
-    const { projectRoot, config, mode, logger, onRebuild, outDir: globalOutDir } = options;
-    const resolved = resolveConfig(config, mode);
-    const entryPath = path.join(projectRoot, resolved.srcDir, resolved.entryPoint);
-    // Output to configured build output directory (default: dist)
-    const outDir = path.join(projectRoot, globalOutDir || DEFAULT_OUT_DIR, resolved.outDir);
-    // Validate entry point exists
-    if (!(await pathExists(entryPath))) {
-        logger.warning(`TypeScript entry point not found: ${entryPath}`);
-        throw new Error(`Entry point not found: ${entryPath}`);
-    }
-    const context = await esbuild.context({
-        entryPoints: [entryPath],
-        bundle: true,
-        outdir: outDir,
-        entryNames: resolved.bundleName, // Stable filename in dev mode (no hash)
-        minify: resolved.minify,
-        sourcemap: resolved.sourceMaps,
-        target: 'es2022',
-        format: 'esm',
-        platform: 'browser',
-        logLevel: 'silent',
-        plugins: [
-            {
-                name: 'stati-rebuild-notify',
-                setup(build) {
-                    let startTime;
-                    build.onStart(() => {
-                        startTime = Date.now();
-                    });
-                    build.onEnd((result) => {
-                        const compileTime = Date.now() - startTime;
-                        if (result.errors.length > 0) {
-                            result.errors.forEach((err) => {
-                                logger.error(`TypeScript error: ${err.text}`);
-                            });
-                        }
-                        else {
-                            const bundlePath = `${globalOutDir || DEFAULT_OUT_DIR}/${resolved.outDir}/${resolved.bundleName}.js`;
-                            onRebuild(bundlePath, compileTime);
-                        }
-                    });
+    const { projectRoot, config, logger, onRebuild, outDir: globalOutDir } = options;
+    const resolved = resolveConfig(config, 'development');
+    const outputDir = globalOutDir || DEFAULT_OUT_DIR;
+    const outDir = path.join(projectRoot, outputDir, resolved.outDir);
+    const contexts = [];
+    const latestResults = new Map();
+    for (const bundleConfig of resolved.bundles) {
+        const entryPath = path.join(projectRoot, resolved.srcDir, bundleConfig.entryPoint);
+        // Validate entry point exists
+        if (!(await pathExists(entryPath))) {
+            logger.warning(`TypeScript entry point not found: ${entryPath} (bundle: ${bundleConfig.bundleName})`);
+            continue;
+        }
+        const context = await esbuild.context({
+            entryPoints: [entryPath],
+            bundle: true,
+            outdir: outDir,
+            entryNames: bundleConfig.bundleName, // Stable filename in dev mode (no hash)
+            minify: false, // Dev mode: never minify for fast rebuilds
+            sourcemap: true, // Dev mode: always enable for debugging
+            target: 'es2022',
+            format: 'esm',
+            platform: 'browser',
+            logLevel: 'silent',
+            metafile: true,
+            plugins: [
+                {
+                    name: 'stati-rebuild-notify',
+                    setup(build) {
+                        let startTime;
+                        build.onStart(() => {
+                            startTime = Date.now();
+                        });
+                        build.onEnd((result) => {
+                            const compileTime = Date.now() - startTime;
+                            if (result.errors.length > 0) {
+                                result.errors.forEach((err) => {
+                                    logger.error(`TypeScript error in '${bundleConfig.bundleName}': ${err.text}`);
+                                });
+                            }
+                            else {
+                                // Extract the generated filename
+                                const outputs = Object.keys(result.metafile?.outputs ?? {});
+                                const bundleFile = outputs.find((f) => f.endsWith('.js'));
+                                const bundleFilename = bundleFile
+                                    ? path.basename(bundleFile)
+                                    : `${bundleConfig.bundleName}.js`;
+                                const bundlePath = path.posix.join('/', resolved.outDir, bundleFilename);
+                                const bundleResult = {
+                                    config: bundleConfig,
+                                    filename: bundleFilename,
+                                    path: bundlePath,
+                                };
+                                latestResults.set(bundleConfig.bundleName, bundleResult);
+                                logger.info(`TypeScript '${bundleConfig.bundleName}' recompiled.`);
+                                // Notify with all current results and compile time
+                                onRebuild(Array.from(latestResults.values()), compileTime);
+                            }
+                        });
+                    },
                 },
-            },
-        ],
-    });
-    // Start watching
-    await context.watch();
-    logger.info(`Watching TypeScript files in ${resolved.srcDir}/`);
-    return context;
+            ],
+        });
+        // Start watching
+        await context.watch();
+        contexts.push(context);
+    }
+    if (contexts.length > 0) {
+        logger.info(`Watching TypeScript files in ${resolved.srcDir}/ (${contexts.length} bundle${contexts.length > 1 ? 's' : ''})`);
+    }
+    return contexts;
 }
 /**
  * Compile stati.config.ts to a temporary JS file for import.
@@ -198,38 +263,86 @@ export async function cleanupCompiledConfig(compiledPath) {
     }
 }
 /**
- * Auto-inject TypeScript bundle script tag into HTML before </body>.
- * Similar to SEO auto-injection, this adds the script tag automatically
+ * Validates a bundle path for safety against XSS attacks.
+ * Only allows safe ASCII characters: alphanumeric, hyphens, underscores, dots, and forward slashes.
+ * Must start with / and end with .js, no encoded characters or unicode allowed.
+ *
+ * @param bundlePath - The bundle path to validate
+ * @returns true if the path is safe, false otherwise
+ *
+ * @internal
+ */
+export function isValidBundlePath(bundlePath) {
+    // Reject non-string or empty paths
+    if (typeof bundlePath !== 'string' || bundlePath.length === 0) {
+        return false;
+    }
+    // Reject paths with null bytes (can bypass security checks)
+    if (bundlePath.includes('\0')) {
+        return false;
+    }
+    // Reject paths with control characters or non-ASCII characters
+    // Check that all characters are in printable ASCII range (32-126)
+    for (let i = 0; i < bundlePath.length; i++) {
+        const charCode = bundlePath.charCodeAt(i);
+        if (charCode < 32 || charCode > 126) {
+            return false;
+        }
+    }
+    // Reject URL-encoded characters (e.g., %20, %3C) and unicode escapes (e.g., \u003C)
+    if (/%[0-9a-fA-F]{2}/.test(bundlePath) || /\\u[0-9a-fA-F]{4}/.test(bundlePath)) {
+        return false;
+    }
+    // Reject HTML entities (e.g., &lt; &#60; &#x3C;)
+    if (/&#?[a-zA-Z0-9]+;/.test(bundlePath)) {
+        return false;
+    }
+    // Reject path traversal attempts
+    if (bundlePath.includes('..') || bundlePath.includes('//')) {
+        return false;
+    }
+    // Validate against strict safe pattern
+    const safePathPattern = /^\/[a-zA-Z0-9_\-./]+\.js$/;
+    return safePathPattern.test(bundlePath);
+}
+/**
+ * Checks if a bundle script tag is already present in the HTML.
+ *
+ * @param html - The HTML content to check
+ * @param bundlePath - The bundle path to look for
+ * @returns true if the bundle is already included, false otherwise
+ *
+ * @internal
+ */
+function isBundleAlreadyIncluded(html, bundlePath) {
+    const escapedPath = bundlePath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const scriptTagPattern = new RegExp(`<script[^>]*\\ssrc=["']${escapedPath}["'][^>]*>`, 'i');
+    return scriptTagPattern.test(html);
+}
+/**
+ * Auto-inject TypeScript bundle script tags into HTML before </body>.
+ * Similar to SEO auto-injection, this adds script tags automatically
  * so users don't need to modify their templates.
+ * Supports multiple bundles - injects all matched bundles in order.
  *
  * @param html - Rendered HTML content
- * @param bundlePath - Path to the compiled bundle (e.g., '/_assets/bundle-a1b2c3d4.js')
- * @returns HTML with injected script tag
+ * @param bundlePaths - Array of paths to compiled bundles (e.g., ['/_assets/core.js', '/_assets/docs.js'])
+ * @returns HTML with injected script tags
  *
  * @example
  * ```typescript
  * const html = '<html><body>Content</body></html>';
- * const enhanced = autoInjectBundle(html, '/_assets/bundle.js');
- * // Returns: '<html><body>Content\n  <script type="module" src="/_assets/bundle.js"></script>\n</body></html>'
+ * const enhanced = autoInjectBundles(html, ['/_assets/core.js', '/_assets/docs.js']);
+ * // Returns HTML with both script tags injected before </body>
  * ```
  */
-export function autoInjectBundle(html, bundlePath) {
-    if (!bundlePath) {
-        return html;
-    }
-    // Sanitize bundlePath to prevent XSS attacks
-    // Only allow safe characters: alphanumeric, hyphens, underscores, dots, and forward slashes
-    // Must start with / and end with .js
-    const safePathPattern = /^\/[\w\-./]+\.js$/;
-    if (!safePathPattern.test(bundlePath)) {
-        // Invalid path format, skip injection to prevent potential XSS
+export function autoInjectBundles(html, bundlePaths) {
+    if (!bundlePaths || bundlePaths.length === 0) {
         return html;
     }
-    // Check if the bundle script tag is already included (avoid duplicate injection)
-    // Must check for actual script tag, not just any occurrence of the path
-    // (e.g., modulepreload links should not prevent script injection)
-    const scriptTagPattern = new RegExp(`<script[^>]*\\ssrc=["']${bundlePath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}["'][^>]*>`, 'i');
-    if (scriptTagPattern.test(html)) {
+    // Filter paths: must be valid and not already included in HTML
+    const validPaths = bundlePaths.filter((bundlePath) => isValidBundlePath(bundlePath) && !isBundleAlreadyIncluded(html, bundlePath));
+    if (validPaths.length === 0) {
         return html;
     }
     // Find </body> tag (case-insensitive)
@@ -240,7 +353,9 @@ export function autoInjectBundle(html, bundlePath) {
     const bodyClosePos = bodyCloseMatch.index;
     const before = html.substring(0, bodyClosePos);
     const after = html.substring(bodyClosePos);
-    // Inject script tag before </body> with proper indentation
-    const scriptTag = `  <script type="module" src="${bundlePath}"></script>\n`;
-    return `${before}${scriptTag}${after}`;
+    // Inject all script tags before </body>
+    const scriptTags = validPaths
+        .map((bundlePath) => `<script type="module" src="${bundlePath}"></script>`)
+        .join('\n');
+    return `${before}${scriptTags}\n${after}`;
 }

package/dist/index.d.ts

@@ -19,7 +19,7 @@
  * await build({ clean: true });
  * ```
  */
-export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, BuildHooks, NavNode, ISGConfig, AgingRule, BuildStats, } from './types/index.js';
+export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, BuildHooks, NavNode, ISGConfig, AgingRule, BuildStats, BundleConfig, } from './types/index.js';
 export type { SEOMetadata, SEOConfig, SEOContext, SEOValidationResult, SEOTagType, RobotsConfig, OpenGraphConfig, OpenGraphImage, OpenGraphArticle, TwitterCardConfig, AuthorConfig, } from './types/index.js';
 export type { SitemapConfig, SitemapEntry, SitemapGenerationResult, ChangeFrequency, } from './types/index.js';
 export type { RSSConfig, RSSFeedConfig, RSSGenerationResult } from './types/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/types/config.d.ts

@@ -111,6 +111,56 @@ export interface SEOConfig {
     /** Enable debug logging for SEO generation (default: false) */
     debug?: boolean;
 }
+/**
+ * Configuration for a single TypeScript bundle.
+ * Defines how a bundle is compiled and which pages should include it.
+ *
+ * @example
+ * ```typescript
+ * // Global bundle (included on all pages)
+ * const coreBundle: BundleConfig = {
+ *   entryPoint: 'core.ts',
+ *   bundleName: 'core'
+ * };
+ *
+ * // Targeted bundle (only on specific pages)
+ * const docsBundle: BundleConfig = {
+ *   entryPoint: 'docs.ts',
+ *   bundleName: 'docs',
+ *   include: ['/docs/**', '/api/**'],
+ *   exclude: ['/docs/legacy/**']
+ * };
+ * ```
+ */
+export interface BundleConfig {
+    /**
+     * Entry point file name relative to srcDir.
+     * @example 'main.ts', 'features/playground.ts'
+     */
+    entryPoint: string;
+    /**
+     * Output bundle file name (without extension).
+     * Final filename includes hash in production: `[bundleName]-[hash].js`
+     */
+    bundleName: string;
+    /**
+     * Glob patterns for pages that should include this bundle.
+     * Matches against page output path (e.g., '/docs/api/hooks.html').
+     * If omitted, bundle is included on ALL pages (global bundle).
+     *
+     * Supports glob syntax: `*`, `**`, `?`, `[abc]`, `{a,b}`
+     *
+     * @example ['/docs/**', '/api/**']
+     */
+    include?: string[];
+    /**
+     * Glob patterns for pages to exclude from this bundle.
+     * Takes precedence over include patterns.
+     *
+     * @example ['/docs/legacy/**']
+     */
+    exclude?: string[];
+}
 /**
  * TypeScript compilation configuration.
  * Controls how Stati compiles TypeScript files using esbuild.
@@ -120,15 +170,23 @@ export interface SEOConfig {
  *
  * @example
  * ```typescript
- * const config: StatiConfig = {
+ * // Simple configuration (defaults to single global bundle)
+ * const simpleConfig: StatiConfig = {
+ *   typescript: {
+ *     enabled: true
+ *     // Defaults to: bundles: [{ entryPoint: 'main.ts', bundleName: 'main' }]
+ *   }
+ * };
+ *
+ * // Multiple bundles with per-page targeting
+ * const multiConfig: StatiConfig = {
  *   typescript: {
  *     enabled: true,
  *     srcDir: 'src',
- *     outDir: '_assets',
- *     entryPoint: 'main.ts',
- *     bundleName: 'bundle',
- *     // hash and minify default to true in production
- *     // set to false only if you need to debug production builds
+ *     bundles: [
+ *       { entryPoint: 'core.ts', bundleName: 'core' },
+ *       { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }
+ *     ]
  *   }
  * };
  * ```
@@ -151,17 +209,6 @@ export interface TypeScriptConfig {
      * @default '_assets'
      */
     outDir?: string;
-    /**
-     * Entry point file name (without path).
-     * @default 'main.ts'
-     */
-    entryPoint?: string;
-    /**
-     * Output bundle file name (without extension).
-     * The final filename will include a content hash: `[bundleName]-[hash].js`
-     * @default 'bundle'
-     */
-    bundleName?: string;
     /**
      * Include content hash in bundle filename for cache busting in production.
      * When true, outputs `bundle-a1b2c3d4.js`. When false, outputs `bundle.js`.
@@ -175,6 +222,25 @@ export interface TypeScriptConfig {
      * @default true
      */
     minify?: boolean;
+    /**
+     * Array of bundle configurations.
+     * Each bundle can target specific pages using include/exclude patterns.
+     * If omitted, defaults to a single global bundle:
+     * `[{ entryPoint: 'main.ts', bundleName: 'main' }]`
+     *
+     * When defined, completely overrides the default.
+     */
+    bundles?: BundleConfig[];
+    /**
+     * Automatically inject bundle script tags before </body>.
+     * When enabled (default), Stati automatically adds script tags for matched bundles.
+     * Disable if you want manual control over script placement in templates.
+     *
+     * When disabled, use `stati.assets.bundlePaths` in templates to access bundle paths.
+     *
+     * @default true
+     */
+    autoInject?: boolean;
 }
 /**
  * Robots.txt generation configuration.

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/content.d.ts

@@ -4,18 +4,24 @@
 /**
  * TypeScript bundle asset information.
  * Available when TypeScript compilation is enabled.
+ * Contains paths to all bundles matched for the current page.
  *
  * @example
  * ```typescript
  * // In Eta templates, access via stati.assets
- * <script type="module" src="<%= stati.assets.bundlePath %>"></script>
+ * // Auto-injection handles most cases, but manual control is available:
+ * <% for (const path of stati.assets.bundlePaths) { %>
+ * <script type="module" src="<%= path %>"></script>
+ * <% } %>
  * ```
  */
 export interface StatiAssets {
-    /** Bundle filename only (e.g., 'bundle-a1b2c3d4.js') */
-    bundleName?: string;
-    /** Full path to bundle (e.g., '/_assets/bundle-a1b2c3d4.js') */
-    bundlePath?: string;
+    /**
+     * Array of all bundle paths matched for this page.
+     * Paths are in config order: ['/_assets/core-abc.js', '/_assets/docs-def.js']
+     * Always an array, empty [] if no TypeScript enabled or no bundles match.
+     */
+    bundlePaths: string[];
 }
 /**
  * Front matter metadata extracted from content files.