@stacksjs/stx 0.2.139 → 0.2.141

package/dist/client-script-bundler.d.ts

@@ -1,10 +1,11 @@
+export declare function shouldLogBundlerDiagnostics(environment?: { STX_DEBUG?: string }): boolean;
 /**
  * Check if a script has user imports that need Bun.build bundling.
  *
  * Returns false for:
  * - `import type { ... }` (type-only — stripped by TS transpiler)
  * - `import { ... } from 'stx'` (auto-imported from window.stx)
- * - `import { ... } from '@stacksjs/browser'` (auto-imported)
+ * - `import '@stacksjs/browser'` (the framework-injected module bootstrap)
  * - `import { ... } from '@stores'` (handled by transformStoreImports)
  * - `import { ... } from '@composables'` (handled by transformStoreImports)
  */

package/dist/client-script-bundler.js

@@ -2,7 +2,15 @@ import path from "node:path";
 import fs from "node:fs";
 import { getPublicEnvDefine } from "./public-env.js";
 import { stateDir } from "./state-dir.js";
-const BUNDLE_CACHE_VERSION = 5, BUNDLE_CACHE_METADATA_VERSION = 1, EXTERNAL_PATTERNS = [
+const BUNDLE_CACHE_VERSION = 5, BUNDLE_CACHE_METADATA_VERSION = 1;
+export function shouldLogBundlerDiagnostics(environment = process.env) {
+  return environment.STX_DEBUG === "true" || environment.STX_DEBUG === "1";
+}
+function logBundlerDiagnostic(...message) {
+  if (shouldLogBundlerDiagnostics())
+    console.log("[stx:bundler]", ...message);
+}
+const EXTERNAL_PATTERNS = [
   /^stx$/,
   /^@stacksjs\/stx$/,
   /^@stores$/,
@@ -15,7 +23,7 @@ export function hasUserImports(code) {
   while ((match = fullImportRegex.exec(code)) !== null) {
     const source = match[1];
     if (!EXTERNAL_PATTERNS.some((p) => p.test(source))) {
-      console.log("[stx:bundler] detected user import:", source);
+      logBundlerDiagnostic("detected user import:", source);
       return !0;
     }
   }
@@ -24,8 +32,10 @@ export function hasUserImports(code) {
     const source = match[1];
     if (/\.css(?:\?.*)?$/.test(source))
       continue;
+    if (source === "@stacksjs/browser")
+      continue;
     if (!EXTERNAL_PATTERNS.some((p) => p.test(source))) {
-      console.log("[stx:bundler] detected side-effect import:", source);
+      logBundlerDiagnostic("detected side-effect import:", source);
       return !0;
     }
   }
@@ -91,7 +101,7 @@ function createBundlePlugin(projectRoot, templateDir, tmpEntry, inputFiles) {
         ];
         for (const candidate of candidates)
           if (fs.existsSync(candidate) && fs.statSync(candidate, { throwIfNoEntry: !1 })?.isFile()) {
-            console.log(`[stx:bundler] resolved ${args.path[0]}/ import:`, args.path, "\u2192", candidate);
+            logBundlerDiagnostic(`resolved ${args.path[0]}/ import:`, args.path, "\u2192", candidate);
             inputFiles.add(candidate);
             return { path: candidate };
           }
@@ -146,10 +156,10 @@ export async function bundleClientScript(code, filePath, options = {}) {
         depsValid = !1;
       }
     if (depsValid) {
-      console.log("[stx:bundler] cache hit:", hash);
+      logBundlerDiagnostic("cache hit:", hash);
       return await cacheFile.text();
     }
-    console.log("[stx:bundler] cache invalidated by dep change:", hash);
+    logBundlerDiagnostic("cache invalidated by dep change:", hash);
   }
   const running = inFlightBundles.get(hash);
   if (running)
@@ -188,7 +198,7 @@ async function buildBundle(code, filePath, options) {
   const exportLine = declNames.length > 0 ? `
 export { ${declNames.join(", ")} }` : "";
   await Bun.write(tmpEntry, code + exportLine);
-  console.log("[stx:bundler] bundling:", hash, "from:", path.basename(filePath));
+  logBundlerDiagnostic("bundling:", hash, "from:", path.basename(filePath));
   const inputFiles = new Set;
   try {
     const result = await Bun.build({
@@ -239,7 +249,7 @@ ${bundled}
 return { ${returnedBindings} };
 })();
 ${publicAssignments}`.trim();
-    console.log("[stx:bundler] bundled:", hash, "output:", bundled.length, "bytes");
+    logBundlerDiagnostic("bundled:", hash, "output:", bundled.length, "bytes");
     if (declNames.length > 0 && exposedBindings.length === 0) {
       console.warn(`[stx:bundler] dropped every binding for ${path.basename(filePath)} (${hash}); serving the unbundled source and not caching this result`);
       return code;

package/dist/client-script.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import fs from "node:fs";
 import { transformStoreImports } from "./store-imports.js";
 import { shouldTranspileTypeScript, transpileTypeScript } from "./utils.js";
+import { importOnce } from "./lazy-module.js";
 const CSS_SIDE_EFFECT_IMPORT_REGEX = /^[ \t]*import\s+['"]([^'"]+?\.css)(\?[^'"]*)?['"]\s*;?\s*$/gm;
 function splitBareSpecifier(spec) {
   if (spec.startsWith(".") || spec.startsWith("/"))
@@ -813,9 +814,8 @@ export async function processClientScript(scriptContent, options = {}) {
   const vendorStyleTags = renderVendorStyleTags(cssExtraction.styles), browserCoreImports = injectBrowserCoreAutoImports(code);
   code = browserCoreImports.code;
   bundledBrowserImports = browserCoreImports.imports;
-  const { hasUserImports, bundleClientScript } = await import("./client-script-bundler.js");
+  const { hasUserImports, bundleClientScript } = await importOnce("stx/client-script-bundler", () => import("./client-script-bundler.js"));
   if (hasUserImports(code)) {
-    console.log("[stx:bundler] user imports detected, bundling...");
     code = await bundleClientScript(code, options.filePath || "", {
       projectRoot: options.projectRoot,
       minify: options.production