bun-plugin-stx 0.2.308 → 0.2.309

package/dist/serve.d.ts

@@ -191,6 +191,14 @@ export declare function bundleBrowserAsset(entrypoint: string): Promise<Response
  * @param options Server options with patterns and port
  */
 export declare function serve(options: ServeOptions): Promise<void>;
+/**
+ * Whether any `.stx` template under `root` uses `<StxImage>` or `@image`.
+ *
+ * Stops at the first hit. Skips dependencies, build output and hidden
+ * directories (the stx state directory among them), so it reads the project's
+ * own templates, including a framework's templates vendored into it.
+ */
+export declare function projectUsesImageBuiltins(root: string): Promise<boolean>;
 /**
  * The cookie name a double-submit CSRF check reads.
  *
@@ -258,7 +266,7 @@ export declare interface ServeOptions {
   cssCacheLimit?: number
   prewarmRenderCache?: boolean | number
   imageWarmupGraceMs?: number
-  imageWarmup?: boolean
+  imageWarmup?: boolean | 'auto'
   publicDir?: string
   quiet?: boolean
   autoIncrementPort?: boolean | number

package/dist/serve.js

@@ -9216,7 +9216,7 @@ async function serve(options) {
     markPlaceholdersReady = resolve13;
   });
   let placeholdersAreReady = false;
-  const imageWarmupEnabled = (options.imageWarmup ?? stxConfig.imageWarmup ?? true) !== false;
+  const imageWarmupSetting = options.imageWarmup ?? stxConfig.imageWarmup ?? "auto";
   const imageWarmupGraceMs = Math.max(0, options.imageWarmupGraceMs ?? 1000);
   function awaitImageWarmup() {
     if (placeholdersAreReady || imageWarmupGraceMs === 0)
@@ -9231,7 +9231,9 @@ async function serve(options) {
     });
   }
   const stxModule = options.stxModule ? Promise.resolve(options.stxModule) : defaultStxModule;
-  const imageDeliveryOutputDir = stateDir(process19.cwd(), "image-delivery");
+  const imageCacheDir = process19.env.STX_IMAGE_CACHE_DIR?.trim();
+  const imageDeliveryOutputDir = imageCacheDir ? nodePath.resolve(imageCacheDir, "image-delivery") : stateDir(process19.cwd(), "image-delivery");
+  const imagePlaceholderCachePath = imageCacheDir ? nodePath.resolve(imageCacheDir, "image-placeholders.json") : stateDir(process19.cwd(), "image-placeholders.json");
   const imageDeliveryRoot = nodePath.join(imageDeliveryOutputDir, "_stx", "images");
   let resolvedStxModule = null;
   Promise.resolve(stxModule).then((m) => {
@@ -10292,6 +10294,7 @@ ${block}`;
     });
   }
   async function runImageWarmup() {
+    const imageWarmupEnabled = imageWarmupSetting === "auto" ? await projectUsesImageBuiltins(process19.cwd()) : imageWarmupSetting !== false;
     if (!imageWarmupEnabled) {
       placeholdersAreReady = true;
       markPlaceholdersReady();
@@ -10302,7 +10305,7 @@ ${block}`;
       const publicRoot = nodePath.resolve(process19.cwd(), publicDir);
       const [placeholderResult, deliveryResult] = await Promise.allSettled([
         stx.warmImagePlaceholders(publicRoot, {
-          cachePath: stateDir(process19.cwd(), "image-placeholders.json")
+          cachePath: imagePlaceholderCachePath
         }),
         stx.prepareImageDelivery(publicRoot, imageDeliveryOutputDir)
       ]);
@@ -11109,6 +11112,38 @@ async function main() {
 if (import.meta.main) {
   main().catch(console.error);
 }
+var IMAGE_BUILTIN_PATTERN = /<(?:StxImage|Image|stx-image|stx-img)[\s/>]|@image\s*\(/;
+var TEMPLATE_SCAN_SKIP = new Set(["node_modules", "dist", "build", "coverage", "vendor"]);
+async function projectUsesImageBuiltins(root) {
+  const { readdir: readdir4, readFile } = await import("fs/promises");
+  const pending = [root];
+  while (pending.length > 0) {
+    const dir = pending.pop();
+    let entries;
+    try {
+      entries = await readdir4(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith("."))
+        continue;
+      const full = nodePath.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!TEMPLATE_SCAN_SKIP.has(entry.name))
+          pending.push(full);
+        continue;
+      }
+      if (!entry.isFile() || !entry.name.endsWith(".stx"))
+        continue;
+      try {
+        if (IMAGE_BUILTIN_PATTERN.test(await readFile(full, "utf8")))
+          return true;
+      } catch {}
+    }
+  }
+  return false;
+}
 export {
   usableErrorPage,
   staticCacheControl,
@@ -11119,6 +11154,7 @@ export {
   resolveServeOpenUrl,
   render404Page,
   publicFileExists,
+  projectUsesImageBuiltins,
   isStaticAssetPath,
   isRenderableCacheCandidate,
   isRenderFailure,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bun-plugin-stx",
   "type": "module",
-  "version": "0.2.308",
+  "version": "0.2.309",
   "description": "A Bun plugin that allows for using Laravel Blade-like syntax.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",