@stati/core 1.24.0 → 1.24.1

package/dist/core/build.js

@@ -551,6 +551,19 @@ async function buildInternal(options = {}) {
             outDir: config.outDir || DEFAULT_OUT_DIR,
             mode: 'development',
         });
+        // On initial dev startup, watcher output may not exist yet.
+        // Compile once so pages can auto-inject bundle scripts immediately.
+        if (compiledBundles.length === 0) {
+            const endTsSpan = recorder.startSpan('typescriptCompileMs');
+            compiledBundles = await compileTypeScript({
+                projectRoot: process.cwd(),
+                config: config.typescript,
+                outDir: config.outDir || DEFAULT_OUT_DIR,
+                mode: 'development',
+                logger,
+            });
+            endTsSpan();
+        }
     }
     else if (config.typescript?.enabled) {
         const endTsSpan = recorder.startSpan('typescriptCompileMs');

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;AAsC7D,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;AAscD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA+gBxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsC7D,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;AAscD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAihBxF"}

package/dist/core/dev.js

@@ -607,6 +607,45 @@ export async function createDevServer(options = {}) {
                 logger.error?.(`Failed to start dev server:\n${message}`);
                 throw error;
             }
+            // TypeScript watcher setup
+            // Start this before the initial build so bundle outputs already exist for auto-injection.
+            if (config.typescript?.enabled) {
+                try {
+                    // Start TypeScript watchers for hot reload (one per bundle)
+                    tsWatchers = await createTypeScriptWatcher({
+                        projectRoot: process.cwd(),
+                        config: config.typescript,
+                        outDir: config.outDir || DEFAULT_OUT_DIR,
+                        logger,
+                        awaitInitialBuild: true,
+                        onRebuild: (_results, compileTimeMs) => {
+                            logger.info?.(`▸ TypeScript recompiled in ${compileTimeMs}ms`);
+                            // Broadcast reload to WebSocket clients
+                            if (wsServer && !disableWsReload) {
+                                wsServer.clients.forEach((client) => {
+                                    const ws = client;
+                                    if (ws.readyState === 1) {
+                                        // WebSocket.OPEN
+                                        ws.send(JSON.stringify({ type: 'reload' }));
+                                    }
+                                });
+                            }
+                        },
+                    });
+                }
+                catch (error) {
+                    const tsError = error instanceof Error ? error : new Error(String(error));
+                    // Prominent notification for TypeScript setup failure
+                    console.log();
+                    logger.error?.(`TypeScript setup failed: ${tsError.message}`);
+                    logger.warning?.('──────────────────────────────────────────────────────────────');
+                    logger.warning?.('!  TypeScript hot reload is DISABLED for this session.');
+                    logger.warning?.("    Dev server will continue, but TypeScript changes won't auto-reload.");
+                    logger.warning?.('    Fix your TypeScript configuration and restart the dev server.');
+                    logger.warning?.('──────────────────────────────────────────────────────────────');
+                    console.log();
+                }
+            }
             // Perform initial build
             await performInitialBuild(configPath, logger, setLastBuildError);
             // Create HTTP server
@@ -674,43 +713,6 @@ export async function createDevServer(options = {}) {
                     reject(error);
                 });
             });
-            // TypeScript watcher setup (initial compilation is handled by performInitialBuild)
-            if (config.typescript?.enabled) {
-                try {
-                    // Start TypeScript watchers for hot reload (one per bundle)
-                    tsWatchers = await createTypeScriptWatcher({
-                        projectRoot: process.cwd(),
-                        config: config.typescript,
-                        outDir: config.outDir || DEFAULT_OUT_DIR,
-                        logger,
-                        onRebuild: (_results, compileTimeMs) => {
-                            logger.info?.(`▸ TypeScript recompiled in ${compileTimeMs}ms`);
-                            // Broadcast reload to WebSocket clients
-                            if (wsServer && !disableWsReload) {
-                                wsServer.clients.forEach((client) => {
-                                    const ws = client;
-                                    if (ws.readyState === 1) {
-                                        // WebSocket.OPEN
-                                        ws.send(JSON.stringify({ type: 'reload' }));
-                                    }
-                                });
-                            }
-                        },
-                    });
-                }
-                catch (error) {
-                    const tsError = error instanceof Error ? error : new Error(String(error));
-                    // Prominent notification for TypeScript setup failure
-                    console.log();
-                    logger.error?.(`TypeScript setup failed: ${tsError.message}`);
-                    logger.warning?.('──────────────────────────────────────────────────────────────');
-                    logger.warning?.('!  TypeScript hot reload is DISABLED for this session.');
-                    logger.warning?.("    Dev server will continue, but TypeScript changes won't auto-reload.");
-                    logger.warning?.('    Fix your TypeScript configuration and restart the dev server.');
-                    logger.warning?.('──────────────────────────────────────────────────────────────');
-                    console.log();
-                }
-            }
             // Set up file watching
             const watchPaths = [srcDir, staticDir].filter(Boolean);
             watcher = chokidar.watch(watchPaths, {

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

@@ -42,6 +42,11 @@ export interface WatchOptions {
     logger: Logger;
     /** Callback invoked when files are recompiled, receives results and compile time in ms */
     onRebuild: (results: CompiledBundleInfo[], compileTimeMs: number) => void;
+    /**
+     * Whether to wait for the initial watch build to finish for all bundles.
+     * Useful during dev-server startup to ensure bundle files exist before page rendering.
+     */
+    awaitInitialBuild?: boolean;
 }
 /**
  * Detects existing TypeScript bundles in the output directory.

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

@@ -1 +1 @@
-{"version":3,"file":"typescript.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/typescript.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAQrD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E;AAuCD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GACtC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAuED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkD9F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAkGjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAqC7D;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA8B7E"}
+{"version":3,"file":"typescript.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/typescript.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAQrD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuCD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GACtC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAuED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkD9F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAyHjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAqC7D;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA8B7E"}

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

@@ -217,12 +217,13 @@ export async function compileTypeScript(options) {
  * ```
  */
 export async function createTypeScriptWatcher(options) {
-    const { projectRoot, config, logger, onRebuild, outDir: globalOutDir } = options;
+    const { projectRoot, config, logger, onRebuild, outDir: globalOutDir, awaitInitialBuild = false, } = 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();
+    const initialBuildPromises = [];
     for (const bundleConfig of resolved.bundles) {
         const entryPath = path.join(projectRoot, resolved.srcDir, bundleConfig.entryPoint);
         // Validate entry point exists
@@ -230,10 +231,14 @@ export async function createTypeScriptWatcher(options) {
             logger.warning(`TypeScript entry point not found: ${entryPath} (bundle: ${bundleConfig.bundleName})`);
             continue;
         }
-        // Track whether this is the initial build triggered by context.watch()
-        // We skip notifications for the initial build since files were just compiled
-        // by compileTypeScript() during the initial build phase
+        // Track whether this is the initial build triggered by context.watch().
+        // We skip reload notifications for this build to avoid a reload storm during startup.
         let isInitialBuild = true;
+        let resolveInitialBuild;
+        const initialBuildPromise = new Promise((resolve) => {
+            resolveInitialBuild = resolve;
+        });
+        initialBuildPromises.push(initialBuildPromise);
         const context = await esbuild.context({
             entryPoints: [entryPath],
             bundle: true,
@@ -275,15 +280,21 @@ export async function createTypeScriptWatcher(options) {
                                     path: bundlePath,
                                 };
                                 latestResults.set(bundleConfig.bundleName, bundleResult);
-                                // Skip notifications for the initial build triggered by context.watch()
-                                // since files were already compiled during performInitialBuild()
+                                // Skip notifications for the initial build triggered by context.watch().
+                                // This avoids triggering a reload while startup priming is still in progress.
                                 if (isInitialBuild) {
                                     isInitialBuild = false;
+                                    resolveInitialBuild();
                                     return;
                                 }
                                 logger.info(`TypeScript '${bundleConfig.bundleName}' recompiled.`);
                                 // Notify with all current results and compile time
                                 onRebuild(Array.from(latestResults.values()), compileTime);
+                                return;
+                            }
+                            if (isInitialBuild) {
+                                isInitialBuild = false;
+                                resolveInitialBuild();
                             }
                         });
                     },
@@ -294,6 +305,9 @@ export async function createTypeScriptWatcher(options) {
         await context.watch();
         contexts.push(context);
     }
+    if (awaitInitialBuild && initialBuildPromises.length > 0) {
+        await Promise.all(initialBuildPromises);
+    }
     if (contexts.length > 0) {
         logger.info(`Watching TypeScript files in ${resolved.srcDir}/ (${contexts.length} bundle${contexts.length > 1 ? 's' : ''})`);
     }

package/package.json

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