@stacksjs/stx 0.2.321 → 0.2.322

package/dist/builtins/image-delivery.d.ts

@@ -1,6 +1,20 @@
 import type { ImageDeliveryManifest } from 'ts-images/delivery';
 import { webpHeaderHasAlpha } from './image-alpha';
 export { webpHeaderHasAlpha };
+/**
+ * Which encoders this process writes variants with, e.g.
+ * `ts-webp@0.1.6+ts-avif@0.1.4`. Resolved the way ts-images resolves them,
+ * so a vendored or hoisted copy reports the copy that actually runs. An
+ * encoder that cannot be identified reads as `unknown`, which is still a
+ * namespace no older release wrote into.
+ */
+/**
+ * Override {@link imageEncoderIdentity}, or with no argument go back to
+ * resolving it. For tests that need a variant cache written by another
+ * encoder than the one installed.
+ */
+export declare function setImageEncoderIdentity(identity?: string): void;
+export declare function imageEncoderIdentity(): string;
 /** Return build-time delivery metadata for one public image URL. */
 export declare function getImageDelivery(src: string): ImageDeliveryManifest | undefined;
 /**
@@ -12,6 +26,24 @@ export declare function getImageDelivery(src: string): ImageDeliveryManifest | u
 export declare function isTransparentImage(src: string): boolean;
 /** Clear process-global delivery state between builds and tests. */
 export declare function clearImageDeliveryCatalog(): void;
+/** The catalog as plain data, for a worker to post back to the thread that serves. */
+export interface ImageDeliverySnapshot {
+    entries: Array<[string, ImageDeliveryManifest]>;
+    transparent: string[];
+}
+/** What this thread's catalog holds, in a form `postMessage` can carry. */
+export declare function snapshotImageDelivery(): ImageDeliverySnapshot;
+/** Swap in a catalog built elsewhere, whole, as the in-thread pass does. */
+export declare function installImageDelivery(snapshot: ImageDeliverySnapshot): void;
+export interface PrepareImageDeliveryOptions {
+    /**
+     * Decode and encode on a worker thread, and install the finished catalog
+     * here. For a long-lived server, whose event loop has requests to answer
+     * while a cold cache re-encodes every raster. Same files, same names, same
+     * catalog; falls back to running in-thread where no worker can start.
+     */
+    offThread?: boolean;
+}
 /**
  * Optimize every raster in the public directory before templates render.
  *
@@ -19,7 +51,7 @@ export declare function clearImageDeliveryCatalog(): void;
  * catalog. Its content fingerprint is folded into the SSG cache key to ensure
  * changing image bytes can never reuse HTML pointing at an older asset hash.
  */
-export declare function prepareImageDelivery(publicDir: string, outputDir: string): Promise<{
+export declare function prepareImageDelivery(publicDir: string, outputDir: string, options?: PrepareImageDeliveryOptions): Promise<{
     count: number;
     fingerprint: string;
 }>;

package/dist/builtins/image-delivery.js

@@ -4,9 +4,43 @@ import path from "node:path";
 import { decode, generateThumbHash } from "ts-images";
 import { createImageDeliveryCatalog } from "ts-images/delivery";
 import { readAt, sourceAlpha, webpHeaderHasAlpha } from "./image-alpha.js";
+import { runImageTask, WORKER_UNAVAILABLE } from "./image-worker.js";
 
 export { webpHeaderHasAlpha };
-const RASTER_EXTENSIONS = new Set([".avif", ".jpeg", ".jpg", ".png", ".webp"]), DEFAULT_WIDTHS = [320, 640, 960, 1280, 1920], DELIVERY_URL = "/_stx/images", ALPHA_NAMESPACE = `stx:${DELIVERY_URL}:alpha-1`;
+const RASTER_EXTENSIONS = new Set([".avif", ".jpeg", ".jpg", ".png", ".webp"]), DEFAULT_WIDTHS = [320, 640, 960, 1280, 1920], DELIVERY_URL = "/_stx/images", ALPHA_NAMESPACE = `stx:${DELIVERY_URL}:alpha-1`, ENCODER_PACKAGES = ["@stacksjs/ts-webp", "@stacksjs/ts-avif"];
+let encoderIdentity;
+function packageVersion(specifier, fromDir) {
+  let dir = path.dirname(Bun.resolveSync(specifier, fromDir));
+  while (dir !== path.dirname(dir)) {
+    const manifest = path.join(dir, "package.json");
+    if (fs.existsSync(manifest)) {
+      const pkg = JSON.parse(fs.readFileSync(manifest, "utf8"));
+      if (pkg.name === specifier)
+        return pkg.version;
+    }
+    dir = path.dirname(dir);
+  }
+  return;
+}
+export function setImageEncoderIdentity(identity) {
+  encoderIdentity = identity;
+}
+export function imageEncoderIdentity() {
+  if (encoderIdentity !== void 0)
+    return encoderIdentity;
+  let from;
+  try {
+    from = path.dirname(Bun.resolveSync("ts-images", import.meta.dir));
+  } catch {}
+  encoderIdentity = ENCODER_PACKAGES.map((specifier) => {
+    let version;
+    try {
+      version = from ? packageVersion(specifier, from) : void 0;
+    } catch {}
+    return `${specifier.replace("@stacksjs/", "")}@${version ?? "unknown"}`;
+  }).join("+");
+  return encoderIdentity;
+}
 let deliveryCatalog = new Map, transparentSources = new Set;
 const warnedOpaqueWebp = new Set;
 function publicUrl(relativePath) {
@@ -182,11 +216,25 @@ export function clearImageDeliveryCatalog() {
   deliveryCatalog = new Map;
   transparentSources = new Set;
 }
-export async function prepareImageDelivery(publicDir, outputDir) {
+export function snapshotImageDelivery() {
+  return { entries: [...deliveryCatalog], transparent: [...transparentSources] };
+}
+export function installImageDelivery(snapshot) {
+  deliveryCatalog = new Map(snapshot.entries);
+  transparentSources = new Set(snapshot.transparent);
+}
+export async function prepareImageDelivery(publicDir, outputDir, options = {}) {
   if (!publicDir || !fs.existsSync(publicDir)) {
     clearImageDeliveryCatalog();
     return { count: 0, fingerprint: "" };
   }
+  if (options.offThread) {
+    const reply = await runImageTask("delivery", { publicDir, outputDir });
+    if (reply !== WORKER_UNAVAILABLE) {
+      installImageDelivery(reply.state);
+      return reply.result;
+    }
+  }
   const allFiles = await collectRasterImages(publicDir);
   if (allFiles.length === 0) {
     clearImageDeliveryCatalog();
@@ -203,7 +251,7 @@ export async function prepareImageDelivery(publicDir, outputDir) {
     clearImageDeliveryCatalog();
     return { count: 0, fingerprint: "" };
   }
-  const alphaStorage = deliveryStorage(path.join(outputDir, "_stx", "images"), ALPHA_NAMESPACE), catalogOptions = {
+  const alphaStorage = deliveryStorage(path.join(outputDir, "_stx", "images"), `${ALPHA_NAMESPACE}:${imageEncoderIdentity()}`), catalogOptions = {
     outDir: path.join(outputDir, "_stx", "images"),
     storage: deliveryStorage(path.join(outputDir, "_stx", "images")),
     baseUrl: DELIVERY_URL,

package/dist/builtins/image-placeholder.d.ts

@@ -46,6 +46,8 @@ export declare function getImagePlaceholder(src: string): ImagePlaceholder | und
 export declare function placeholdersWarmed(): boolean;
 /** Drop everything, for tests and for a watch-mode rebuild. */
 export declare function clearImagePlaceholders(): void;
+/** Every placeholder this thread holds, in a form `postMessage` can carry. */
+export declare function snapshotImagePlaceholders(): Array<[string, ImagePlaceholder]>;
 /**
  * Register a placeholder directly. Used by the warm below, and by tests that
  * would rather not decode a real JPEG to check the markup.
@@ -69,6 +71,13 @@ export interface WarmOptions {
     maxBytes?: number;
     /** Stop after this many images, so an enormous asset tree cannot stall a build. */
     limit?: number;
+    /**
+     * Decode on a worker thread and merge the results here. For a long-lived
+     * server, whose event loop has requests to answer while a cold cache
+     * decodes every image. Same placeholders, same cache file; falls back to
+     * running in-thread where no worker can start.
+     */
+    offThread?: boolean;
 }
 /**
  * Derive placeholders for every image under `publicDir` and hold them for

package/dist/builtins/image-placeholder.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { sourceAlpha } from "./image-alpha.js";
+import { runImageTask, WORKER_UNAVAILABLE } from "./image-worker.js";
 const IMAGE_EXTENSIONS = new Set([".jpg", ".jpeg", ".png", ".webp", ".avif"]), placeholders = new Map;
 let warmed = !1;
 export function getImagePlaceholder(src) {
@@ -16,6 +17,9 @@ export function clearImagePlaceholders() {
   placeholders.clear();
   warmed = !1;
 }
+export function snapshotImagePlaceholders() {
+  return [...placeholders];
+}
 export function setImagePlaceholder(urlPath, placeholder) {
   placeholders.set(urlPath, placeholder);
   warmed = !0;
@@ -94,11 +98,20 @@ function collectImages(dir, baseUrl, out = []) {
   return out;
 }
 export async function warmImagePlaceholders(publicDir, options = {}) {
-  const { cachePath, maxBytes = 33554432, limit = 2000 } = options;
+  const { cachePath, maxBytes = 33554432, limit = 2000, offThread } = options;
   if (!publicDir || !fs.existsSync(publicDir)) {
     warmed = !0;
     return placeholders.size;
   }
+  if (offThread) {
+    const reply = await runImageTask("placeholders", { publicDir, options: { cachePath, maxBytes, limit } });
+    if (reply !== WORKER_UNAVAILABLE) {
+      for (const [urlPath, placeholder] of reply.placeholders)
+        placeholders.set(urlPath, placeholder);
+      warmed = !0;
+      return placeholders.size;
+    }
+  }
   let tsImages;
   try {
     tsImages = await import("ts-images");

package/dist/builtins/image-warmup-worker.d.ts

@@ -0,0 +1 @@
+

package/dist/builtins/image-warmup-worker.js

@@ -0,0 +1,18 @@
+import { prepareImageDelivery, snapshotImageDelivery } from "./image-delivery.js";
+import { snapshotImagePlaceholders, warmImagePlaceholders } from "./image-placeholder.js";
+self.addEventListener("message", async (event) => {
+  const { task, args } = event.data;
+  try {
+    if (task === "delivery") {
+      const result = await prepareImageDelivery(args.publicDir, args.outputDir);
+      self.postMessage({ type: "result", value: { result, state: snapshotImageDelivery() } });
+    } else {
+      await warmImagePlaceholders(args.publicDir, args.options);
+      self.postMessage({ type: "result", value: { placeholders: snapshotImagePlaceholders() } });
+    }
+  } catch (error) {
+    const err = error instanceof Error ? error : Error(String(error));
+    self.postMessage({ type: "error", error: { name: err.name, message: err.message, stack: err.stack } });
+  }
+});
+self.postMessage({ type: "ready" });

package/dist/builtins/image-worker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Runs the image pass on a worker thread.
+ *
+ * Decoding and encoding (AVIF, WebP, thumbhash) is pure TypeScript and fully
+ * synchronous per image. On the thread that also answers requests, a cold pass
+ * over a photo-heavy `public/` held the event loop for most of its minutes:
+ * every `await` a render made queued behind the next encode, so a first page
+ * took 14-18s and a proxy in front of the server saw empty responses. On a
+ * worker the same code runs to the same results, and the serving thread only
+ * receives the finished catalog.
+ *
+ * The worker is the mechanism, not a requirement. Where one cannot start (no
+ * `Worker` in the runtime, or the entry file missing because stx was bundled
+ * into something else), {@link runImageTask} reports that and the caller runs
+ * the pass in-thread exactly as before.
+ *
+ * @module builtins/image-worker
+ */
+/** Tasks the worker entry knows how to run. */
+export type ImageTask = 'delivery' | 'placeholders';
+/** Returned instead of a result when no worker could be started. */
+export declare const WORKER_UNAVAILABLE: unique symbol;
+/**
+ * How many image workers may run at once.
+ *
+ * Serving needs a core of its own, so on a two-core box the placeholder and
+ * delivery passes take turns in one worker instead of claiming both cores.
+ * Two at most: the passes are the only callers, and a third would have
+ * nothing to do.
+ */
+export declare function imageWorkerSlots(cores?: number): number;
+/**
+ * Run `task` with `args` on a worker thread and resolve with what it posts
+ * back, or with {@link WORKER_UNAVAILABLE} when no worker could be started.
+ *
+ * A failure inside the task rejects, as the in-thread call would have thrown.
+ * Only a worker that never became ready counts as unavailable, so a crash
+ * mid-pass is never silently re-run on the serving thread.
+ */
+export declare function runImageTask<T>(task: ImageTask, args: unknown): Promise<T | typeof WORKER_UNAVAILABLE>;

package/dist/builtins/image-worker.js

@@ -0,0 +1,82 @@
+import fs from "node:fs";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+export const WORKER_UNAVAILABLE = Symbol("stx.image-worker.unavailable");
+export function imageWorkerSlots(cores = typeof os.availableParallelism === "function" ? os.availableParallelism() : os.cpus().length) {
+  return Math.max(1, Math.min(2, cores - 1));
+}
+let active = 0;
+const waiting = [];
+async function acquire() {
+  if (active < imageWorkerSlots()) {
+    active++;
+    return;
+  }
+  await new Promise((resolve) => waiting.push(resolve));
+  active++;
+}
+function release() {
+  active--;
+  waiting.shift()?.();
+}
+function workerEntry() {
+  const extension = import.meta.url.endsWith(".ts") ? "ts" : "js", url = new URL(`./image-warmup-worker.${extension}`, import.meta.url);
+  try {
+    return url.protocol === "file:" && fs.existsSync(fileURLToPath(url)) ? url : void 0;
+  } catch {
+    return;
+  }
+}
+export async function runImageTask(task, args) {
+  if (typeof Worker > "u")
+    return WORKER_UNAVAILABLE;
+  const entry = workerEntry();
+  if (!entry)
+    return WORKER_UNAVAILABLE;
+  await acquire();
+  try {
+    return await new Promise((resolve, reject) => {
+      let worker;
+      try {
+        worker = new Worker(entry);
+      } catch {
+        resolve(WORKER_UNAVAILABLE);
+        return;
+      }
+      let ready = !1, settled = !1;
+      const finish = (settle) => {
+        if (settled)
+          return;
+        settled = !0;
+        settle();
+        worker.terminate();
+      };
+      worker.addEventListener("message", (event) => {
+        const reply = event.data;
+        if (reply.type === "ready") {
+          ready = !0;
+          worker.postMessage({ task, args });
+          return;
+        }
+        if (reply.type === "result") {
+          finish(() => resolve(reply.value));
+          return;
+        }
+        const error = Error(reply.error?.message ?? "image worker failed");
+        if (reply.error?.name)
+          error.name = reply.error.name;
+        if (reply.error?.stack)
+          error.stack = reply.error.stack;
+        finish(() => reject(error));
+      });
+      worker.addEventListener("error", (event) => {
+        finish(() => ready ? reject(event.error instanceof Error ? event.error : Error(event.message || "image worker crashed")) : resolve(WORKER_UNAVAILABLE));
+      });
+      worker.addEventListener("close", () => {
+        finish(() => ready ? reject(Error("image worker exited before it finished")) : resolve(WORKER_UNAVAILABLE));
+      });
+    });
+  } finally {
+    release();
+  }
+}

package/dist/chunk-0050wktp.js

@@ -0,0 +1,2 @@
+// @bun
+import{tk as a,uk as b,vk as c,wk as d}from"./chunk-k3w1ctbb.js";import"./chunk-vy2nvpbw.js";import"./chunk-2astj1fq.js";import"./chunk-9e6pyjwz.js";import"./chunk-z698hwht.js";import"./chunk-70zb3560.js";import"./chunk-zsapb653.js";import"./chunk-kwrj745h.js";import"./chunk-df5wrw50.js";import"./chunk-e10pfrds.js";import"./chunk-ecbqmesm.js";import"./chunk-namj6apv.js";import"./chunk-dgrayagx.js";import"./chunk-2hyxkzpc.js";import"./chunk-r1g0bnpv.js";import"./chunk-2dk3ym1g.js";import"./chunk-8n0mjaf6.js";import"./chunk-5az2jb8y.js";import"./chunk-rcvnh2p7.js";import"./chunk-qrkxyb5p.js";export{b as getAvailableTargets,c as getAvailableFormats,d as default,a as buildNative};

package/dist/{chunk-qz462c22.js → chunk-02hjbe0p.js}

@@ -1,3 +1,3 @@
 // @bun
-import{Nf as T}from"./chunk-ycmsckjw.js";import{jw as I}from"./chunk-cey6rhqw.js";import E from"fs";import X from"path";import U from"crypto";var _=new Set(["webp","avif","jpeg","png"]),F=new Set(["cover","contain","fill","inside","outside"]),A=new Set([".jpg",".jpeg",".png",".webp",".avif",".gif"]),S=4096,y=80,D="cover";async function g(k,G){let J=G.routePath??"/_stx/img",B=new URL(k.url);if(B.pathname!==J)return null;let $=q(B,G);if(!$.ok)return new Response($.error,{status:$.status,headers:{"Content-Type":"text/plain"}});let{srcFsPath:j,srcUrl:K,width:H,height:v,format:Z,quality:Y,fit:z}=$,C;try{C=E.statSync(j)}catch{return new Response(`Source image not found: ${K}`,{status:404,headers:{"Content-Type":"text/plain"}})}if(!C.isFile())return new Response("Not a file",{status:404,headers:{"Content-Type":"text/plain"}});let N=G.cacheDir??".stx/cache/img";await E.promises.mkdir(N,{recursive:!0});let V=`${j}:${C.mtimeMs}:${C.size}`,O=`${H}x${v}:${Z}:${Y}:${z}`,b=U.createHash("sha256").update(`${V}|${O}`).digest("hex").slice(0,16),Q=X.join(N,`${b}.${Z}`),W={"Content-Type":T(Z),"Cache-Control":"public, max-age=31536000, immutable",ETag:`"${b}"`,"X-Stx-Image-Cache":"HIT"};if(k.headers.get("if-none-match")===`"${b}"`)return new Response(null,{status:304,headers:W});let L=Bun.file(Q);if(await L.exists())return new Response(L,{headers:W});try{let R=Buffer.from(await Bun.file(j).arrayBuffer()),{resizeAndConvert:M}=await P(),w=await M(R,{width:H,height:v,format:Z,quality:Y,fit:z});return await Bun.write(Q,w),W["X-Stx-Image-Cache"]="MISS",new Response(new Uint8Array(w),{headers:W})}catch(R){let M=R.message;return new Response(`Image processing failed: ${M}`,{status:500,headers:{"Content-Type":"text/plain"}})}}function l(k){return async(G)=>{return await g(G,k)??new Response("Not Found",{status:404,headers:{"Content-Type":"text/plain"}})}}function q(k,G){let J=k.searchParams.get("src");if(!J)return{ok:!1,error:"Missing required param: src",status:400};if(!J.startsWith("/"))return{ok:!1,error:"src must be an absolute URL path (start with /)",status:400};if(J.startsWith("//"))return{ok:!1,error:"src must be a local path",status:400};let B=X.extname(J).toLowerCase();if(!A.has(B))return{ok:!1,error:`Unsupported source extension: ${B}`,status:400};let $=X.resolve(G.publicDir),j=X.resolve($,J.slice(1));if(!j.startsWith(`${$}${X.sep}`)&&j!==$)return{ok:!1,error:"src is outside publicDir",status:400};let K=G.maxWidth??S,H=G.maxHeight??S,v=k.searchParams.get("w"),Z=k.searchParams.get("h"),Y=v?Number.parseInt(v,10):0,z=Z?Number.parseInt(Z,10):0;if(v&&(!Number.isFinite(Y)||Y<=0))return{ok:!1,error:"Invalid w (must be positive integer)",status:400};if(Z&&(!Number.isFinite(z)||z<=0))return{ok:!1,error:"Invalid h (must be positive integer)",status:400};if(!v&&!Z)return{ok:!1,error:"At least one of w or h is required",status:400};let C=Math.min(Y||K,K),N=Math.min(z||H,H),V=k.searchParams.get("f")||"webp";if(!_.has(V))return{ok:!1,error:`Invalid f (must be one of: ${[..._].join(", ")})`,status:400};let O=V,b=k.searchParams.get("q"),Q=b?Number.parseInt(b,10):G.defaultQuality??y;if(!Number.isFinite(Q)||Q<1||Q>100)return{ok:!1,error:"Invalid q (must be 1-100)",status:400};let x=k.searchParams.get("fit")||G.defaultFit||D;if(!F.has(x))return{ok:!1,error:`Invalid fit (must be one of: ${[...F].join(", ")})`,status:400};return{ok:!0,srcFsPath:j,srcUrl:J,width:C,height:N,format:O,quality:Q,fit:x}}async function P(){return await import("./chunk-rpnjwpw3.js")}
+import{Nf as T}from"./chunk-zgbwr604.js";import{pw as I}from"./chunk-qrkxyb5p.js";import E from"fs";import X from"path";import U from"crypto";var _=new Set(["webp","avif","jpeg","png"]),F=new Set(["cover","contain","fill","inside","outside"]),A=new Set([".jpg",".jpeg",".png",".webp",".avif",".gif"]),S=4096,y=80,D="cover";async function g(k,G){let J=G.routePath??"/_stx/img",B=new URL(k.url);if(B.pathname!==J)return null;let $=q(B,G);if(!$.ok)return new Response($.error,{status:$.status,headers:{"Content-Type":"text/plain"}});let{srcFsPath:j,srcUrl:K,width:H,height:v,format:Z,quality:Y,fit:z}=$,C;try{C=E.statSync(j)}catch{return new Response(`Source image not found: ${K}`,{status:404,headers:{"Content-Type":"text/plain"}})}if(!C.isFile())return new Response("Not a file",{status:404,headers:{"Content-Type":"text/plain"}});let N=G.cacheDir??".stx/cache/img";await E.promises.mkdir(N,{recursive:!0});let V=`${j}:${C.mtimeMs}:${C.size}`,O=`${H}x${v}:${Z}:${Y}:${z}`,b=U.createHash("sha256").update(`${V}|${O}`).digest("hex").slice(0,16),Q=X.join(N,`${b}.${Z}`),W={"Content-Type":T(Z),"Cache-Control":"public, max-age=31536000, immutable",ETag:`"${b}"`,"X-Stx-Image-Cache":"HIT"};if(k.headers.get("if-none-match")===`"${b}"`)return new Response(null,{status:304,headers:W});let L=Bun.file(Q);if(await L.exists())return new Response(L,{headers:W});try{let R=Buffer.from(await Bun.file(j).arrayBuffer()),{resizeAndConvert:M}=await P(),w=await M(R,{width:H,height:v,format:Z,quality:Y,fit:z});return await Bun.write(Q,w),W["X-Stx-Image-Cache"]="MISS",new Response(new Uint8Array(w),{headers:W})}catch(R){let M=R.message;return new Response(`Image processing failed: ${M}`,{status:500,headers:{"Content-Type":"text/plain"}})}}function l(k){return async(G)=>{return await g(G,k)??new Response("Not Found",{status:404,headers:{"Content-Type":"text/plain"}})}}function q(k,G){let J=k.searchParams.get("src");if(!J)return{ok:!1,error:"Missing required param: src",status:400};if(!J.startsWith("/"))return{ok:!1,error:"src must be an absolute URL path (start with /)",status:400};if(J.startsWith("//"))return{ok:!1,error:"src must be a local path",status:400};let B=X.extname(J).toLowerCase();if(!A.has(B))return{ok:!1,error:`Unsupported source extension: ${B}`,status:400};let $=X.resolve(G.publicDir),j=X.resolve($,J.slice(1));if(!j.startsWith(`${$}${X.sep}`)&&j!==$)return{ok:!1,error:"src is outside publicDir",status:400};let K=G.maxWidth??S,H=G.maxHeight??S,v=k.searchParams.get("w"),Z=k.searchParams.get("h"),Y=v?Number.parseInt(v,10):0,z=Z?Number.parseInt(Z,10):0;if(v&&(!Number.isFinite(Y)||Y<=0))return{ok:!1,error:"Invalid w (must be positive integer)",status:400};if(Z&&(!Number.isFinite(z)||z<=0))return{ok:!1,error:"Invalid h (must be positive integer)",status:400};if(!v&&!Z)return{ok:!1,error:"At least one of w or h is required",status:400};let C=Math.min(Y||K,K),N=Math.min(z||H,H),V=k.searchParams.get("f")||"webp";if(!_.has(V))return{ok:!1,error:`Invalid f (must be one of: ${[..._].join(", ")})`,status:400};let O=V,b=k.searchParams.get("q"),Q=b?Number.parseInt(b,10):G.defaultQuality??y;if(!Number.isFinite(Q)||Q<1||Q>100)return{ok:!1,error:"Invalid q (must be 1-100)",status:400};let x=k.searchParams.get("fit")||G.defaultFit||D;if(!F.has(x))return{ok:!1,error:`Invalid fit (must be one of: ${[...F].join(", ")})`,status:400};return{ok:!0,srcFsPath:j,srcUrl:J,width:C,height:N,format:O,quality:Q,fit:x}}async function P(){return await import("./chunk-3yn8ghtz.js")}
 export{g as yf,l as zf};

package/dist/{chunk-g38wktfx.js → chunk-0aqtbma7.js}

@@ -1,5 +1,5 @@
 // @bun
-import{a as N,c as R,e as W,g as j,i as H,k as J}from"./chunk-0y46fbkx.js";import{l as k,m as w,n as B}from"./chunk-q9n5swx7.js";import"./chunk-cey6rhqw.js";import E from"fs";import K from"path";var V=[];function _(U){V=[];for(let A of U.storyFiles)if(V.push({text:A.fileName.toLowerCase(),original:A.fileName,type:"story",storyId:A.id}),V.push({text:A.relativePath.toLowerCase(),original:A.relativePath,type:"story",storyId:A.id}),A.story)for(let z of A.story.variants)V.push({text:z.title.toLowerCase(),original:z.title,type:"story",storyId:A.id,variantId:z.id})}function $(){return JSON.stringify(V)}async function O(U={}){let A=Date.now();N();let z=await k({mode:"build"});if(!z.config.enabled){W("Story feature is disabled in config.");return}let P=await H(z);w(z,P);let Y=J(z.config,P);B(z,Y),R(P.length);let X=U.outDir??z.config.outDir,Q=K.resolve(z.root,X);await E.promises.mkdir(Q,{recursive:!0}),console.log(`  Building to ${X}...`);let M=F(z);await E.promises.writeFile(K.join(Q,"index.html"),M);let v={files:P.map((G)=>({id:G.id,fileName:G.fileName,relativePath:G.relativePath,treePath:G.treePath})),tree:Y};await E.promises.writeFile(K.join(Q,"stories.json"),JSON.stringify(v,null,2));let L={theme:z.config.theme,responsivePresets:z.config.responsivePresets,backgroundPresets:z.config.backgroundPresets};await E.promises.writeFile(K.join(Q,"config.json"),JSON.stringify(L,null,2));let Z=K.join(Q,"stories");await E.promises.mkdir(Z,{recursive:!0});for(let G of P){let g=await E.promises.readFile(G.path,"utf-8");await E.promises.writeFile(K.join(Z,`${G.id}.stx`),g)}_(z);let T=$();await E.promises.writeFile(K.join(Q,"search-index.json"),T);let C=Date.now()-A;j(P.length,X,C)}function F(U){let{theme:A}=U.config,z=A.title||"STX Story";return`<!DOCTYPE html>
+import{a as N,c as R,e as W,g as j,i as H,k as J}from"./chunk-0y46fbkx.js";import{l as k,m as w,n as B}from"./chunk-q9n5swx7.js";import"./chunk-qrkxyb5p.js";import E from"fs";import K from"path";var V=[];function _(U){V=[];for(let A of U.storyFiles)if(V.push({text:A.fileName.toLowerCase(),original:A.fileName,type:"story",storyId:A.id}),V.push({text:A.relativePath.toLowerCase(),original:A.relativePath,type:"story",storyId:A.id}),A.story)for(let z of A.story.variants)V.push({text:z.title.toLowerCase(),original:z.title,type:"story",storyId:A.id,variantId:z.id})}function $(){return JSON.stringify(V)}async function O(U={}){let A=Date.now();N();let z=await k({mode:"build"});if(!z.config.enabled){W("Story feature is disabled in config.");return}let P=await H(z);w(z,P);let Y=J(z.config,P);B(z,Y),R(P.length);let X=U.outDir??z.config.outDir,Q=K.resolve(z.root,X);await E.promises.mkdir(Q,{recursive:!0}),console.log(`  Building to ${X}...`);let M=F(z);await E.promises.writeFile(K.join(Q,"index.html"),M);let v={files:P.map((G)=>({id:G.id,fileName:G.fileName,relativePath:G.relativePath,treePath:G.treePath})),tree:Y};await E.promises.writeFile(K.join(Q,"stories.json"),JSON.stringify(v,null,2));let L={theme:z.config.theme,responsivePresets:z.config.responsivePresets,backgroundPresets:z.config.backgroundPresets};await E.promises.writeFile(K.join(Q,"config.json"),JSON.stringify(L,null,2));let Z=K.join(Q,"stories");await E.promises.mkdir(Z,{recursive:!0});for(let G of P){let g=await E.promises.readFile(G.path,"utf-8");await E.promises.writeFile(K.join(Z,`${G.id}.stx`),g)}_(z);let T=$();await E.promises.writeFile(K.join(Q,"search-index.json"),T);let C=Date.now()-A;j(P.length,X,C)}function F(U){let{theme:A}=U.config,z=A.title||"STX Story";return`<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">

package/dist/{chunk-fs5gwtd9.js → chunk-0fkvezw3.js}

@@ -1,3 +1,3 @@
 // @bun
-import{$s as Q}from"./chunk-2btrq8sz.js";import"./chunk-z698hwht.js";import{tu as R}from"./chunk-1r3ydhkx.js";import"./chunk-cey6rhqw.js";import O from"fs";import U from"path";async function W(j,b={}){let q=Date.now(),z={total:0,passed:0,failed:0,new:0,failures:[],duration:0},K=b.snapshotDir||R(j.root,"story","snapshots");await O.promises.mkdir(K,{recursive:!0});let B=j.storyFiles;if(b.filter&&b.filter.length>0)B=B.filter((J)=>b.filter.some((G)=>J.fileName.toLowerCase().includes(G.toLowerCase())));for(let J of B)await X(J,K,b,z);return z.duration=Date.now()-q,z}async function X(j,b,q,z){let K=j.story;if(!K)return;for(let B of K.variants){z.total++;let J=U.join(b,`${j.id}-${B.id}.snap`),G=Y(B.source||""),L=await _(J);if(q.update||!L){let M={storyId:j.id,variantId:B.id,component:j.fileName,timestamp:Date.now(),hash:G};if(await O.promises.writeFile(J,JSON.stringify(M,null,2)),!L)z.new++;z.passed++}else try{let M=await O.promises.readFile(J,"utf-8"),N=JSON.parse(M);if(N.hash===G)z.passed++;else z.failed++,z.failures.push({storyId:j.id,variantId:B.id,component:j.fileName,message:"Snapshot mismatch",difference:Z(N.hash,G)})}catch(M){z.failed++,z.failures.push({storyId:j.id,variantId:B.id,component:j.fileName,message:`Error reading snapshot: ${M}`})}}}async function A(j,b={}){return(await W(j,{...b,update:!0})).total}function Y(j){let b=0;for(let q=0;q<j.length;q++){let z=j.charCodeAt(q);b=(b<<5)-b+z,b=b&b}return b.toString(16)}function Z(j,b){if(j===b)return 0;let q=Math.abs(Number.parseInt(j,16)-Number.parseInt(b,16));return Math.min(q/1e6,1)}async function _(j){try{return await O.promises.access(j),!0}catch{return!1}}function I(j){let b=[];if(b.push(""),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push("  STX Story Visual Regression Tests"),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push(""),j.failures.length>0){b.push("  \u274C Failures:"),b.push("");for(let q of j.failures){if(b.push(`    \u2022 ${q.component} / ${q.variantId}`),b.push(`      ${q.message}`),q.difference!==void 0)b.push(`      Difference: ${(q.difference*100).toFixed(2)}%`);b.push("")}}if(b.push("  Summary:"),b.push(`    Total:  ${j.total}`),b.push(`    Passed: ${j.passed} \u2713`),b.push(`    Failed: ${j.failed} \u2717`),j.new>0)b.push(`    New:    ${j.new} \u26A1`);return b.push(`    Time:   ${j.duration}ms`),b.push(""),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push(""),b.join(`
+import{$s as Q}from"./chunk-9e6pyjwz.js";import"./chunk-z698hwht.js";import{zu as R}from"./chunk-ecbqmesm.js";import"./chunk-qrkxyb5p.js";import O from"fs";import U from"path";async function W(j,b={}){let q=Date.now(),z={total:0,passed:0,failed:0,new:0,failures:[],duration:0},K=b.snapshotDir||R(j.root,"story","snapshots");await O.promises.mkdir(K,{recursive:!0});let B=j.storyFiles;if(b.filter&&b.filter.length>0)B=B.filter((J)=>b.filter.some((G)=>J.fileName.toLowerCase().includes(G.toLowerCase())));for(let J of B)await X(J,K,b,z);return z.duration=Date.now()-q,z}async function X(j,b,q,z){let K=j.story;if(!K)return;for(let B of K.variants){z.total++;let J=U.join(b,`${j.id}-${B.id}.snap`),G=Y(B.source||""),L=await _(J);if(q.update||!L){let M={storyId:j.id,variantId:B.id,component:j.fileName,timestamp:Date.now(),hash:G};if(await O.promises.writeFile(J,JSON.stringify(M,null,2)),!L)z.new++;z.passed++}else try{let M=await O.promises.readFile(J,"utf-8"),N=JSON.parse(M);if(N.hash===G)z.passed++;else z.failed++,z.failures.push({storyId:j.id,variantId:B.id,component:j.fileName,message:"Snapshot mismatch",difference:Z(N.hash,G)})}catch(M){z.failed++,z.failures.push({storyId:j.id,variantId:B.id,component:j.fileName,message:`Error reading snapshot: ${M}`})}}}async function A(j,b={}){return(await W(j,{...b,update:!0})).total}function Y(j){let b=0;for(let q=0;q<j.length;q++){let z=j.charCodeAt(q);b=(b<<5)-b+z,b=b&b}return b.toString(16)}function Z(j,b){if(j===b)return 0;let q=Math.abs(Number.parseInt(j,16)-Number.parseInt(b,16));return Math.min(q/1e6,1)}async function _(j){try{return await O.promises.access(j),!0}catch{return!1}}function I(j){let b=[];if(b.push(""),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push("  STX Story Visual Regression Tests"),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push(""),j.failures.length>0){b.push("  \u274C Failures:"),b.push("");for(let q of j.failures){if(b.push(`    \u2022 ${q.component} / ${q.variantId}`),b.push(`      ${q.message}`),q.difference!==void 0)b.push(`      Difference: ${(q.difference*100).toFixed(2)}%`);b.push("")}}if(b.push("  Summary:"),b.push(`    Total:  ${j.total}`),b.push(`    Passed: ${j.passed} \u2713`),b.push(`    Failed: ${j.failed} \u2717`),j.new>0)b.push(`    New:    ${j.new} \u26A1`);return b.push(`    Time:   ${j.duration}ms`),b.push(""),b.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"),b.push(""),b.join(`
 `)}async function S(j,b={}){let q=performance.now(),z=[],K=0,B=0;for(let G of j.storyFiles)try{let L=await Bun.file(G.path).text(),M=await Q(L,G.path);if(M.length>0){for(let N of M)z.push({storyId:G.id,variantId:"default",component:G.component,message:`A11y: ${N.message}`,expected:"No accessibility violations",actual:`${N.type}: ${N.message} (impact: ${N.impact})`});B++}else K++}catch(L){z.push({storyId:G.id,variantId:"default",component:G.component,message:`Failed to check a11y: ${L instanceof Error?L.message:String(L)}`,expected:"File readable for a11y check",actual:"File read error"}),B++}let J=performance.now()-q;return{total:j.storyFiles.length,passed:K,failed:B,new:0,failures:z,duration:J}}export{A as updateSnapshots,W as runVisualTests,S as runA11yTests,I as formatTestResults};

package/dist/{chunk-1yv1v7hh.js → chunk-0xw3atfx.js}

@@ -1,2 +1,2 @@
 // @bun
-import{Eu as a,Fu as b,Gu as c,Hu as d,Iu as e,Ju as f,Ku as g,Lu as h,Mu as i,Nu as j,Ou as k,Pu as l,Qu as m,Ru as n,Su as o,Tu as p}from"./chunk-zeqktcby.js";import"./chunk-cey6rhqw.js";export{i as useTitle,f as useSeoMeta,i as usePageTitle,d as useHead,g as seoMetaToHeadConfig,c as resetHead,k as renderHtmlAttrs,j as renderHead,l as renderBodyAttrs,o as processTitleDirective,p as processMetaDirective,n as processHeadDirective,e as mergeHeadConfigs,b as getPageMeta,a as getHead,h as definePageMeta,m as applyHead};
+import{Ku as a,Lu as b,Mu as c,Nu as d,Ou as e,Pu as f,Qu as g,Ru as h,Su as i,Tu as j,Uu as k,Vu as l,Wu as m,Xu as n,Yu as o,Zu as p}from"./chunk-2hyxkzpc.js";import"./chunk-qrkxyb5p.js";export{i as useTitle,f as useSeoMeta,i as usePageTitle,d as useHead,g as seoMetaToHeadConfig,c as resetHead,k as renderHtmlAttrs,j as renderHead,l as renderBodyAttrs,o as processTitleDirective,p as processMetaDirective,n as processHeadDirective,e as mergeHeadConfigs,b as getPageMeta,a as getHead,h as definePageMeta,m as applyHead};

package/dist/chunk-1yxtx5y2.js

@@ -0,0 +1,2 @@
+// @bun
+import{Ue as a}from"./chunk-mz9twa1f.js";import"./chunk-dvvx1wny.js";import"./chunk-2astj1fq.js";import"./chunk-9e6pyjwz.js";import"./chunk-z698hwht.js";import"./chunk-70zb3560.js";import"./chunk-zsapb653.js";import"./chunk-kwrj745h.js";import"./chunk-df5wrw50.js";import"./chunk-e10pfrds.js";import"./chunk-ecbqmesm.js";import"./chunk-namj6apv.js";import"./chunk-dgrayagx.js";import"./chunk-2hyxkzpc.js";import"./chunk-r1g0bnpv.js";import"./chunk-2dk3ym1g.js";import"./chunk-8n0mjaf6.js";import"./chunk-5az2jb8y.js";import"./chunk-rcvnh2p7.js";import"./chunk-qrkxyb5p.js";export{a as buildApp};

package/dist/{chunk-8q3a8g7m.js → chunk-24r2ctta.js}

@@ -1,2 +1,2 @@
 // @bun
-import{Qh as a,Rh as b,Sh as c,Th as d,Uh as e,Vh as f,Wh as g,Xh as h,Yh as i,Zh as j,_h as k}from"./chunk-9368t9jm.js";import"./chunk-cey6rhqw.js";export{i as processStaticDirectives,b as processPartialHydrationDirectives,h as onHydrated,g as isHydrated,d as hydrateIsland,e as hydrateByStrategy,f as hydrateAll,c as generatePartialHydrationCSS,j as generateIslandManifest,k as default,a as createIslandRegistry};
+import{Qh as a,Rh as b,Sh as c,Th as d,Uh as e,Vh as f,Wh as g,Xh as h,Yh as i,Zh as j,_h as k}from"./chunk-9368t9jm.js";import"./chunk-qrkxyb5p.js";export{i as processStaticDirectives,b as processPartialHydrationDirectives,h as onHydrated,g as isHydrated,d as hydrateIsland,e as hydrateByStrategy,f as hydrateAll,c as generatePartialHydrationCSS,j as generateIslandManifest,k as default,a as createIslandRegistry};