@stati/core 1.13.0 → 1.15.0

package/dist/constants.d.ts

@@ -74,8 +74,12 @@ export declare const DEFAULT_LOCALE = "en-US";
 export declare const DEFAULT_TS_SRC_DIR = "src";
 /** Default TypeScript output directory (relative to build output) */
 export declare const DEFAULT_TS_OUT_DIR = "_assets";
-/** Default TypeScript entry point filename */
-export declare const DEFAULT_TS_ENTRY_POINT = "main.ts";
-/** Default TypeScript bundle name */
-export declare const DEFAULT_TS_BUNDLE_NAME = "bundle";
+/**
+ * Default bundle configuration when `bundles` is not specified.
+ * Creates a single global bundle from 'main.ts' entry point.
+ */
+export declare const DEFAULT_BUNDLES: readonly [{
+    readonly entryPoint: "main.ts";
+    readonly bundleName: "main";
+}];
 //# sourceMappingURL=constants.d.ts.map

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,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;AAItC,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,qCAAqC;AACrC,eAAO,MAAM,sBAAsB,WAAW,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;AAItC,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe;;;EAA2D,CAAC"}

package/dist/constants.js

@@ -83,7 +83,8 @@ export const DEFAULT_LOCALE = 'en-US';
 export const DEFAULT_TS_SRC_DIR = 'src';
 /** Default TypeScript output directory (relative to build output) */
 export const DEFAULT_TS_OUT_DIR = '_assets';
-/** Default TypeScript entry point filename */
-export const DEFAULT_TS_ENTRY_POINT = 'main.ts';
-/** Default TypeScript bundle name */
-export const DEFAULT_TS_BUNDLE_NAME = 'bundle';
+/**
+ * Default bundle configuration when `bundles` is not specified.
+ * Creates a single global bundle from 'main.ts' entry point.
+ */
+export const DEFAULT_BUNDLES = [{ entryPoint: 'main.ts', bundleName: 'main' }];

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EAMP,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW3E"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EAMP,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW3E"}

package/dist/core/build.js

@@ -1,4 +1,4 @@
-import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, enableInventoryTracking, disableInventoryTracking, clearInventory, writeTailwindClassInventory, getInventorySize, isTailwindUsed, loadPreviousInventory, compileTypeScript, autoInjectBundle, } from './utils/index.js';
+import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, enableInventoryTracking, disableInventoryTracking, clearInventory, writeTailwindClassInventory, getInventorySize, isTailwindUsed, loadPreviousInventory, compileTypeScript, autoInjectBundles, getBundlePathsForPage, } from './utils/index.js';
 import { join, dirname, relative, posix } from 'node:path';
 import { loadConfig } from '../config/loader.js';
 import { loadContent } from './content.js';
@@ -9,7 +9,7 @@ import { loadCacheManifest, saveCacheManifest, shouldRebuildPage, createCacheEnt
 import { generateSitemap, generateRobotsTxtFromConfig, autoInjectSEO, } from '../seo/index.js';
 import { generateRSSFeeds, validateRSSConfig } from '../rss/index.js';
 import { getEnv } from '../env.js';
-import { DEFAULT_TS_OUT_DIR } from '../constants.js';
+import { DEFAULT_OUT_DIR } from '../constants.js';
 /**
  * Recursively calculates the total size of a directory in bytes.
  * Used for build statistics.
@@ -184,7 +184,7 @@ async function loadContentAndBuildNavigation(config, options, logger) {
 /**
  * Processes pages with ISG caching logic.
  */
-async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, assets) {
+async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles) {
     let cacheHits = 0;
     let cacheMisses = 0;
     // Build context
@@ -244,23 +244,15 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
         // Cache miss - need to rebuild
         cacheMisses++;
         const startTime = Date.now();
-        // Add rendering substeps to tree
-        const markdownId = `${pageId}-markdown`;
-        const templateId = `${pageId}-template`;
-        if (logger.addTreeNode) {
-            logger.addTreeNode(pageId, markdownId, 'Processing Markdown', 'running');
-            logger.addTreeNode(pageId, templateId, 'Applying Template', 'pending');
-        }
         // Run beforeRender hook
         if (config.hooks?.beforeRender) {
             await config.hooks.beforeRender({ page, config });
         }
         // Render markdown to HTML
         const htmlContent = renderMarkdown(page.content, md);
-        if (logger.updateTreeNode) {
-            logger.updateTreeNode(markdownId, 'completed');
-            logger.updateTreeNode(templateId, 'running');
-        }
+        // Compute matched bundle paths for this page
+        const bundlePaths = getBundlePathsForPage(page.url, compiledBundles);
+        const assets = bundlePaths.length > 0 ? { bundlePaths } : undefined;
         // Render with template
         let finalHtml = await renderPage(page, htmlContent, config, eta, navigation, pages, assets);
         // Auto-inject SEO tags if enabled
@@ -276,13 +268,13 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             }
             finalHtml = autoInjectSEO(finalHtml, injectOptions);
         }
-        // Auto-inject TypeScript bundle script tag if available
-        if (assets?.bundlePath) {
-            finalHtml = autoInjectBundle(finalHtml, assets.bundlePath);
+        // Auto-inject TypeScript bundle script tags if available and autoInject is enabled (default: true)
+        const shouldAutoInject = config.typescript?.autoInject !== false;
+        if (shouldAutoInject && assets && assets.bundlePaths.length > 0) {
+            finalHtml = autoInjectBundles(finalHtml, assets.bundlePaths);
         }
         const renderTime = Date.now() - startTime;
         if (logger.updateTreeNode) {
-            logger.updateTreeNode(templateId, 'completed');
             logger.updateTreeNode(pageId, 'completed', {
                 timing: renderTime,
                 url: page.url,
@@ -401,30 +393,22 @@ async function buildInternal(options = {}) {
     // Store navigation hash in manifest for change detection in dev server
     manifest.navigationHash = navigationHash;
     // Compile TypeScript if enabled
-    let tsResult;
-    let assets;
+    let compiledBundles = [];
     if (config.typescript?.enabled) {
-        tsResult = await compileTypeScript({
+        compiledBundles = await compileTypeScript({
             projectRoot: process.cwd(),
             config: config.typescript,
-            outDir: config.outDir || 'dist',
+            outDir: config.outDir || DEFAULT_OUT_DIR,
             mode: getEnv() === 'production' ? 'production' : 'development',
             logger,
         });
-        if (tsResult?.bundleFilename) {
-            const assetsDir = config.typescript.outDir || DEFAULT_TS_OUT_DIR;
-            assets = {
-                bundleName: tsResult.bundleFilename,
-                bundlePath: posix.join('/', assetsDir, tsResult.bundleFilename),
-            };
-        }
     }
     // Process pages with ISG caching logic
     if (logger.step) {
         console.log(); // Add spacing before page processing
     }
     const buildTime = new Date();
-    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, assets);
+    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles);
     cacheHits = pageProcessingResult.cacheHits;
     cacheMisses = pageProcessingResult.cacheMisses;
     // Write Tailwind class inventory after all templates have been rendered (if Tailwind is used)
@@ -432,6 +416,7 @@ async function buildInternal(options = {}) {
         const inventorySize = getInventorySize();
         if (inventorySize > 0) {
             await writeTailwindClassInventory(cacheDir);
+            logger.info('');
             logger.info(`📝 Generated Tailwind class inventory (${inventorySize} classes tracked)`);
         }
         // Disable inventory tracking after build

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsB7D,MAAM,WAAW,gBAAgB;IAC/B,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,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AA4SD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAwaxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA2B7D,MAAM,WAAW,gBAAgB;IAC/B,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,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AA4SD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA+axF"}

package/dist/core/dev.js

@@ -11,7 +11,7 @@ import { loadContent } from './content.js';
 import { buildNavigation } from './navigation.js';
 import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, createErrorOverlay, parseErrorDetails, TemplateError, createFallbackLogger, mergeServerOptions, createTypeScriptWatcher, } from './utils/index.js';
 import { setEnv, getEnv } from '../env.js';
-import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION } from '../constants.js';
+import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION, DEFAULT_OUT_DIR, } from '../constants.js';
 /**
  * Loads and validates configuration for the dev server.
  */
@@ -291,7 +291,7 @@ export async function createDevServer(options = {}) {
         lastBuildError = error;
     };
     let watcher = null;
-    let tsWatcher = null;
+    let tsWatchers = [];
     const isBuildingRef = { value: false };
     let isStopping = false;
     /**
@@ -523,15 +523,14 @@ export async function createDevServer(options = {}) {
             // TypeScript watcher setup (initial compilation is handled by performInitialBuild)
             if (config.typescript?.enabled) {
                 try {
-                    // Start TypeScript watcher for hot reload
-                    tsWatcher = await createTypeScriptWatcher({
+                    // Start TypeScript watchers for hot reload (one per bundle)
+                    tsWatchers = await createTypeScriptWatcher({
                         projectRoot: process.cwd(),
                         config: config.typescript,
-                        outDir: config.outDir || 'dist',
-                        mode: 'development',
+                        outDir: config.outDir || DEFAULT_OUT_DIR,
                         logger,
-                        onRebuild: () => {
-                            logger.info?.('TypeScript recompiled, triggering reload...');
+                        onRebuild: (_results, compileTimeMs) => {
+                            logger.info?.(`⚡ TypeScript recompiled in ${compileTimeMs}ms`);
                             // Broadcast reload to WebSocket clients
                             if (wsServer) {
                                 wsServer.clients.forEach((client) => {
@@ -599,10 +598,17 @@ export async function createDevServer(options = {}) {
                 await watcher.close();
                 watcher = null;
             }
-            // Clean up TypeScript watcher
-            if (tsWatcher) {
-                await tsWatcher.dispose();
-                tsWatcher = null;
+            // Clean up TypeScript watchers
+            if (tsWatchers.length > 0) {
+                await Promise.all(tsWatchers.map(async (w) => {
+                    try {
+                        await w.dispose();
+                    }
+                    catch (error) {
+                        logger.warning(`Failed to dispose TypeScript watcher: ${error}`);
+                    }
+                }));
+                tsWatchers = [];
             }
             if (wsServer) {
                 wsServer.close();

package/dist/core/utils/bundle-matching.utils.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Bundle matching utilities for per-page TypeScript bundle targeting.
+ * Determines which bundles should be included on each page based on glob patterns.
+ * @module core/utils/bundle-matching
+ */
+import type { BundleConfig } from '../../types/config.js';
+/**
+ * Error thrown when bundle configuration contains duplicate bundleNames.
+ */
+export declare class DuplicateBundleNameError extends Error {
+    constructor(duplicates: string[]);
+}
+/**
+ * Validates that all bundles have unique bundleNames.
+ * Throws DuplicateBundleNameError if duplicates are found.
+ *
+ * @param bundles - Array of bundle configurations to validate
+ * @throws {DuplicateBundleNameError} When duplicate bundleNames are detected
+ *
+ * @example
+ * ```typescript
+ * validateUniqueBundleNames([
+ *   { entryPoint: 'core.ts', bundleName: 'core' },
+ *   { entryPoint: 'docs.ts', bundleName: 'docs' }
+ * ]); // OK
+ *
+ * validateUniqueBundleNames([
+ *   { entryPoint: 'a.ts', bundleName: 'main' },
+ *   { entryPoint: 'b.ts', bundleName: 'main' }
+ * ]); // Throws DuplicateBundleNameError
+ * ```
+ */
+export declare function validateUniqueBundleNames(bundles: BundleConfig[]): void;
+/**
+ * Compiled bundle info with resolved paths for matched bundles.
+ * Used to track bundle metadata after compilation.
+ */
+export interface CompiledBundleInfo {
+    /** The original bundle configuration */
+    config: BundleConfig;
+    /** The compiled bundle filename (e.g., 'core-a1b2c3d4.js') */
+    filename: string;
+    /** The full path to the bundle (e.g., '/_assets/core-a1b2c3d4.js') */
+    path: string;
+}
+/**
+ * Determines which bundles should be included on a specific page.
+ * Filters bundles based on their include/exclude glob patterns.
+ *
+ * Matching logic:
+ * 1. If no `include` patterns: bundle is global (matches all pages)
+ * 2. If `include` patterns exist: page must match at least one pattern
+ * 3. If page matches any `exclude` pattern: bundle is excluded (exclude takes precedence)
+ * 4. Bundle order from config is preserved
+ *
+ * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param bundles - Array of bundle configurations to filter
+ * @returns Array of bundles that match this page, in config order
+ *
+ * @example
+ * ```typescript
+ * const bundles: BundleConfig[] = [
+ *   { entryPoint: 'core.ts', bundleName: 'core' }, // global
+ *   { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] },
+ *   { entryPoint: 'playground.ts', bundleName: 'playground', include: ['/examples/**'], exclude: ['/examples/simple/**'] }
+ * ];
+ *
+ * matchBundlesForPage('/docs/api/hooks.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'docs.ts', ... }]
+ *
+ * matchBundlesForPage('/examples/advanced/demo.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'playground.ts', ... }]
+ *
+ * matchBundlesForPage('/examples/simple/basic.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }] - playground excluded
+ * ```
+ */
+export declare function matchBundlesForPage(pageOutputPath: string, bundles: BundleConfig[]): BundleConfig[];
+/**
+ * Gets bundle paths for a page from compiled bundle info.
+ * Filters compiled bundles based on page matching and returns only the paths.
+ *
+ * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param compiledBundles - Array of compiled bundle info
+ * @returns Array of bundle paths matched for this page, in config order
+ *
+ * @example
+ * ```typescript
+ * const compiled: CompiledBundleInfo[] = [
+ *   { config: { entryPoint: 'core.ts', bundleName: 'core' }, filename: 'core-abc.js', path: '/_assets/core-abc.js' },
+ *   { config: { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }, filename: 'docs-def.js', path: '/_assets/docs-def.js' }
+ * ];
+ *
+ * getBundlePathsForPage('/docs/api/hooks.html', compiled);
+ * // Returns: ['/_assets/core-abc.js', '/_assets/docs-def.js']
+ * ```
+ */
+export declare function getBundlePathsForPage(pageOutputPath: string, compiledBundles: CompiledBundleInfo[]): string[];
+//# sourceMappingURL=bundle-matching.utils.d.ts.map

package/dist/core/utils/bundle-matching.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-matching.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/bundle-matching.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,UAAU,EAAE,MAAM,EAAE;CAOjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAqBvE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CAyBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,kBAAkB,EAAE,GACpC,MAAM,EAAE,CAaV"}

package/dist/core/utils/bundle-matching.utils.js

@@ -0,0 +1,138 @@
+/**
+ * Bundle matching utilities for per-page TypeScript bundle targeting.
+ * Determines which bundles should be included on each page based on glob patterns.
+ * @module core/utils/bundle-matching
+ */
+import { matchesGlob } from './glob-patterns.utils.js';
+/**
+ * Error thrown when bundle configuration contains duplicate bundleNames.
+ */
+export class DuplicateBundleNameError extends Error {
+    constructor(duplicates) {
+        super(`Duplicate bundleName(s) found in configuration: ${duplicates.join(', ')}. ` +
+            'Each bundle must have a unique bundleName.');
+        this.name = 'DuplicateBundleNameError';
+    }
+}
+/**
+ * Validates that all bundles have unique bundleNames.
+ * Throws DuplicateBundleNameError if duplicates are found.
+ *
+ * @param bundles - Array of bundle configurations to validate
+ * @throws {DuplicateBundleNameError} When duplicate bundleNames are detected
+ *
+ * @example
+ * ```typescript
+ * validateUniqueBundleNames([
+ *   { entryPoint: 'core.ts', bundleName: 'core' },
+ *   { entryPoint: 'docs.ts', bundleName: 'docs' }
+ * ]); // OK
+ *
+ * validateUniqueBundleNames([
+ *   { entryPoint: 'a.ts', bundleName: 'main' },
+ *   { entryPoint: 'b.ts', bundleName: 'main' }
+ * ]); // Throws DuplicateBundleNameError
+ * ```
+ */
+export function validateUniqueBundleNames(bundles) {
+    if (!bundles || bundles.length === 0) {
+        return;
+    }
+    const seen = new Set();
+    const duplicates = [];
+    for (const bundle of bundles) {
+        if (seen.has(bundle.bundleName)) {
+            if (!duplicates.includes(bundle.bundleName)) {
+                duplicates.push(bundle.bundleName);
+            }
+        }
+        else {
+            seen.add(bundle.bundleName);
+        }
+    }
+    if (duplicates.length > 0) {
+        throw new DuplicateBundleNameError(duplicates);
+    }
+}
+/**
+ * Determines which bundles should be included on a specific page.
+ * Filters bundles based on their include/exclude glob patterns.
+ *
+ * Matching logic:
+ * 1. If no `include` patterns: bundle is global (matches all pages)
+ * 2. If `include` patterns exist: page must match at least one pattern
+ * 3. If page matches any `exclude` pattern: bundle is excluded (exclude takes precedence)
+ * 4. Bundle order from config is preserved
+ *
+ * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param bundles - Array of bundle configurations to filter
+ * @returns Array of bundles that match this page, in config order
+ *
+ * @example
+ * ```typescript
+ * const bundles: BundleConfig[] = [
+ *   { entryPoint: 'core.ts', bundleName: 'core' }, // global
+ *   { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] },
+ *   { entryPoint: 'playground.ts', bundleName: 'playground', include: ['/examples/**'], exclude: ['/examples/simple/**'] }
+ * ];
+ *
+ * matchBundlesForPage('/docs/api/hooks.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'docs.ts', ... }]
+ *
+ * matchBundlesForPage('/examples/advanced/demo.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'playground.ts', ... }]
+ *
+ * matchBundlesForPage('/examples/simple/basic.html', bundles);
+ * // Returns: [{ entryPoint: 'core.ts', ... }] - playground excluded
+ * ```
+ */
+export function matchBundlesForPage(pageOutputPath, bundles) {
+    if (!bundles || bundles.length === 0) {
+        return [];
+    }
+    // Normalize path to use forward slashes
+    const normalizedPath = pageOutputPath.replace(/\\/g, '/');
+    return bundles.filter((bundle) => {
+        // Check exclude patterns first (they take precedence)
+        if (bundle.exclude && bundle.exclude.length > 0) {
+            const matchesExclude = bundle.exclude.some((pattern) => matchesGlob(normalizedPath, pattern));
+            if (matchesExclude) {
+                return false;
+            }
+        }
+        // If no include patterns, bundle is global (matches all pages)
+        if (!bundle.include || bundle.include.length === 0) {
+            return true;
+        }
+        // Check if page matches any include pattern
+        return bundle.include.some((pattern) => matchesGlob(normalizedPath, pattern));
+    });
+}
+/**
+ * Gets bundle paths for a page from compiled bundle info.
+ * Filters compiled bundles based on page matching and returns only the paths.
+ *
+ * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param compiledBundles - Array of compiled bundle info
+ * @returns Array of bundle paths matched for this page, in config order
+ *
+ * @example
+ * ```typescript
+ * const compiled: CompiledBundleInfo[] = [
+ *   { config: { entryPoint: 'core.ts', bundleName: 'core' }, filename: 'core-abc.js', path: '/_assets/core-abc.js' },
+ *   { config: { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }, filename: 'docs-def.js', path: '/_assets/docs-def.js' }
+ * ];
+ *
+ * getBundlePathsForPage('/docs/api/hooks.html', compiled);
+ * // Returns: ['/_assets/core-abc.js', '/_assets/docs-def.js']
+ * ```
+ */
+export function getBundlePathsForPage(pageOutputPath, compiledBundles) {
+    if (!compiledBundles || compiledBundles.length === 0) {
+        return [];
+    }
+    const matchedConfigs = matchBundlesForPage(pageOutputPath, compiledBundles.map((b) => b.config));
+    // Map matched configs back to their paths, preserving order
+    const matchedNames = new Set(matchedConfigs.map((c) => c.bundleName));
+    return compiledBundles.filter((b) => matchedNames.has(b.config.bundleName)).map((b) => b.path);
+}

package/dist/core/utils/index.d.ts

@@ -18,7 +18,9 @@ export { createErrorOverlay, parseErrorDetails } from './error-overlay.utils.js'
 export type { ErrorDetails } from './error-overlay.utils.js';
 export { getStatiVersion } from './version.utils.js';
 export { globToRegex, matchesGlob } from './glob-patterns.utils.js';
+export { matchBundlesForPage, getBundlePathsForPage, validateUniqueBundleNames, DuplicateBundleNameError, } from './bundle-matching.utils.js';
+export type { CompiledBundleInfo } from './bundle-matching.utils.js';
 export { createFallbackLogger } from './logger.utils.js';
-export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundle, } from './typescript.utils.js';
-export type { CompileOptions, CompileResult, WatchOptions } from './typescript.utils.js';
+export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, } from './typescript.utils.js';
+export type { CompileOptions, WatchOptions } from './typescript.utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/utils/index.js

@@ -28,7 +28,9 @@ export { createErrorOverlay, parseErrorDetails } from './error-overlay.utils.js'
 export { getStatiVersion } from './version.utils.js';
 // Glob pattern utilities
 export { globToRegex, matchesGlob } from './glob-patterns.utils.js';
+// Bundle matching utilities
+export { matchBundlesForPage, getBundlePathsForPage, validateUniqueBundleNames, DuplicateBundleNameError, } from './bundle-matching.utils.js';
 // Logger utilities
 export { createFallbackLogger } from './logger.utils.js';
 // TypeScript compilation utilities
-export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundle, } from './typescript.utils.js';
+export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, } from './typescript.utils.js';