tw-framework 1.0.5 → 1.0.6

package/dist/testing.cjs

@@ -39,10 +39,20 @@ function getActivePipeline() {
 function revalidatePath(pathname, opts) {
   return activePipeline ? activePipeline.revalidatePath(pathname, opts) : 0;
 }
-var activePipeline;
+function registerTwmTagInvalidator(fn) {
+  twmTagInvalidator = fn;
+}
+function revalidateTag(tag) {
+  let dropped = 0;
+  if (activePipeline) dropped += activePipeline.revalidateTag(tag);
+  if (twmTagInvalidator) dropped += twmTagInvalidator(tag);
+  return dropped;
+}
+var activePipeline, twmTagInvalidator;
 var init_revalidate = __esm({
   "../../packages/server/tw/routing/revalidate.ts"() {
     activePipeline = null;
+    twmTagInvalidator = null;
   }
 });
 
@@ -627,905 +637,486 @@ var init_twm_rules = __esm({
   }
 });
 
-// ../../packages/shared/tw/node-import.ts
-var node_import_exports = {};
-__export(node_import_exports, {
-  twImportTs: () => twImportTs
-});
-async function twImportTs(tsPath) {
-  if (!globalThis.__TW_NODE) {
-    return import(tsPath);
+// ../../packages/shared/tw/hashing/md5.ts
+var init_md5 = __esm({
+  "../../packages/shared/tw/hashing/md5.ts"() {
   }
-  const esbuildMain = globalThis.__TW_ESBUILD_MODULE;
-  const esbuild = await (esbuildMain ? import(esbuildMain) : import("esbuild"));
-  const safe = tsPath.replace(/[^a-zA-Z0-9]/g, "_").slice(-120);
-  const cachePath = (0, import_node_path.join)((0, import_node_os.tmpdir)(), "tw-" + safe + ".mjs");
-  await esbuild.build({
-    entryPoints: [tsPath],
-    bundle: true,
-    format: "esm",
-    platform: "node",
-    target: "node18",
-    outfile: cachePath,
-    logLevel: "silent"
-  });
-  return import((0, import_node_url.pathToFileURL)(cachePath).href);
-}
-var import_node_path, import_node_os, import_node_url;
-var init_node_import = __esm({
-  "../../packages/shared/tw/node-import.ts"() {
-    import_node_path = require("node:path");
-    import_node_os = require("node:os");
-    import_node_url = require("node:url");
+});
+
+// ../../packages/shared/tw/hashing/crc32.ts
+var crc32Table;
+var init_crc32 = __esm({
+  "../../packages/shared/tw/hashing/crc32.ts"() {
+    crc32Table = (() => {
+      const table = new Uint32Array(256);
+      for (let i = 0; i < 256; i++) {
+        let crc = i;
+        for (let j = 0; j < 8; j++) {
+          crc = crc & 1 ? 3988292384 ^ crc >>> 1 : crc >>> 1;
+        }
+        table[i] = crc >>> 0;
+      }
+      return table;
+    })();
   }
 });
 
-// ../../packages/image/tw/index.ts
-function optimizedImageUrl(src, opts = {}) {
-  const p = new URLSearchParams();
-  if (opts.width) p.set("w", String(opts.width));
-  if (opts.height) p.set("h", String(opts.height));
-  if (opts.quality) p.set("q", String(opts.quality));
-  p.set("f", opts.format ?? "auto");
-  const qs = p.toString();
-  return `/_tw/img${src.startsWith("/") ? src : "/" + src}?${qs}`;
+// ../../packages/shared/tw/hashing/sha.ts
+function syncHashFallback(algorithm, data) {
+  const input = typeof data === "string" ? data : new TextDecoder().decode(data);
+  let hash2 = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash2 ^= input.charCodeAt(i);
+    hash2 = Math.imul(hash2, 16777619);
+  }
+  return (hash2 >>> 0).toString(16).padStart(8, "0").repeat(8);
 }
-function imageAttributesFor(opts, config = DEFAULT_IMAGE_CONFIG) {
-  const width = opts.width ?? 0;
-  const quality = opts.quality ?? config.quality;
-  const format = config.formats[0] ?? "webp";
-  const isRemote = /^https?:\/\//i.test(opts.src);
-  const src = isRemote ? `/_tw/img/_remote?src=${encodeURIComponent(opts.src)}&w=${opts.width ?? ""}&h=${opts.height ?? ""}&q=${quality}&f=auto` : optimizedImageUrl(opts.src, { width: opts.width, height: opts.height, quality });
-  const widths = config.breakpoints.filter((bp) => width === 0 || bp <= width * 2);
-  const srcset = widths.map(
-    (bp) => isRemote ? `/_tw/img/_remote?src=${encodeURIComponent(opts.src)}&w=${bp}&q=${quality}&f=auto ${bp}w` : `${optimizedImageUrl(opts.src, { width: bp, quality })} ${bp}w`
-  ).join(", ");
-  const sizes = width > 0 ? `(max-width: ${width}px) 100vw, ${width}px` : "100vw";
-  const loading = opts.priority ? "eager" : "lazy";
-  return { src, srcset, sizes, width, height: opts.height ?? 0, loading, decoding: "async", format };
+function sha256(data) {
+  try {
+    const hasher = new BunHashSync("sha256");
+    return hasher.update(data).digest("hex");
+  } catch {
+    return syncHashFallback("sha256", data);
+  }
 }
-function createImageHandler(options) {
-  const rootDir = (0, import_node_path2.resolve)(options.rootDir);
-  const sourceDir = (0, import_node_path2.resolve)(options.sourceDir ?? (0, import_node_path2.join)(rootDir, "public"));
-  const cacheDir = (0, import_node_path2.resolve)(options.cacheDir ?? (0, import_node_path2.join)(rootDir, ".tw", "img", "cache"));
-  const config = { ...DEFAULT_IMAGE_CONFIG, ...options.config };
-  let sharpPromise = null;
-  let warnedNoSharp = false;
-  async function loadSharp() {
-    if (!sharpPromise) {
-      sharpPromise = (async () => {
-        let req;
-        try {
-          const { createRequire } = await import("node:module");
-          req = createRequire((0, import_node_path2.join)(rootDir, "package.json"));
-        } catch {
-        }
-        const candidates = [
-          (0, import_node_path2.join)(rootDir, "node_modules", "sharp"),
-          "sharp"
-        ];
-        for (const candidate of candidates) {
-          if (typeof req === "function") {
-            try {
-              const m = req(candidate);
-              const mod = m?.default ?? m;
-              if (mod && typeof mod === "function") return mod;
-            } catch {
-            }
-          }
-          try {
-            const href = candidate.startsWith("/") ? (0, import_node_url2.pathToFileURL)(candidate).href : candidate;
-            const m = await import(href);
-            const mod = m?.default ?? m;
-            if (mod && typeof mod === "function") return mod;
-          } catch {
-          }
+var BunHashSync;
+var init_sha = __esm({
+  "../../packages/shared/tw/hashing/sha.ts"() {
+    init_md5();
+    init_crc32();
+    BunHashSync = class {
+      hasher;
+      constructor(algorithm) {
+        const nodeCrypto = globalThis.require?.("node:crypto") || globalThis.crypto;
+        if (nodeCrypto?.createHash) {
+          this.hasher = nodeCrypto.createHash(algorithm);
+        } else {
+          throw new Error("No sync hash available");
         }
-        return null;
-      })();
-    }
-    return sharpPromise;
+      }
+      update(data) {
+        const input = typeof data === "string" ? data : Buffer.from(data);
+        this.hasher.update(input);
+        return this;
+      }
+      digest(encoding) {
+        return this.hasher.digest(encoding);
+      }
+    };
   }
-  function contentTypeFor(path) {
-    return IMAGE_EXTENSIONS[(0, import_node_path2.extname)(path).toLowerCase()] ?? "application/octet-stream";
+});
+
+// ../../packages/shared/tw/utils.ts
+var init_utils = __esm({
+  "../../packages/shared/tw/utils.ts"() {
   }
-  function negotiateFormat(requested, accept) {
-    if (requested && requested !== "auto") {
-      return SHARP_FORMATS[requested.toLowerCase()] ?? null;
+});
+
+// ../../packages/shared/tw/fs/runtime-compat.ts
+var init_runtime_compat = __esm({
+  "../../packages/shared/tw/fs/runtime-compat.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/constants/misc.ts
+var MIME_TYPES, VLQ_BASE_SHIFT, VLQ_BASE, VLQ_BASE_MASK;
+var init_misc = __esm({
+  "../../packages/shared/tw/constants/misc.ts"() {
+    MIME_TYPES = {
+      ".html": "text/html",
+      ".htm": "text/html",
+      ".css": "text/css",
+      ".js": "text/javascript",
+      ".mjs": "text/javascript",
+      ".json": "application/json",
+      ".xml": "application/xml",
+      ".txt": "text/plain",
+      ".md": "text/markdown",
+      ".csv": "text/csv",
+      ".svg": "image/svg+xml",
+      ".png": "image/png",
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".avif": "image/avif",
+      ".ico": "image/x-icon",
+      ".bmp": "image/bmp",
+      ".woff": "font/woff",
+      ".woff2": "font/woff2",
+      ".ttf": "font/ttf",
+      ".otf": "font/otf",
+      ".pdf": "application/pdf",
+      ".zip": "application/zip",
+      ".gz": "application/gzip",
+      ".tar": "application/x-tar",
+      ".mp4": "video/mp4",
+      ".webm": "video/webm",
+      ".mp3": "audio/mpeg",
+      ".ogg": "audio/ogg",
+      ".wav": "audio/wav",
+      ".wasm": "application/wasm",
+      ".tw": "text/tw",
+      ".tss": "text/tss",
+      ".toml": "application/toml",
+      ".yaml": "application/yaml",
+      ".yml": "application/yaml",
+      ".webmanifest": "application/manifest+json"
+    };
+    VLQ_BASE_SHIFT = 5;
+    VLQ_BASE = 1 << VLQ_BASE_SHIFT;
+    VLQ_BASE_MASK = VLQ_BASE - 1;
+  }
+});
+
+// ../../packages/shared/tw/fs/async.ts
+var init_async = __esm({
+  "../../packages/shared/tw/fs/async.ts"() {
+    init_runtime_compat();
+    init_runtime_compat();
+    init_misc();
+  }
+});
+
+// ../../packages/runtime/tw/utils/path-utils.ts
+var init_path_utils = __esm({
+  "../../packages/runtime/tw/utils/path-utils.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/fs/glob.ts
+var init_glob = __esm({
+  "../../packages/shared/tw/fs/glob.ts"() {
+    init_runtime_compat();
+    init_path_utils();
+  }
+});
+
+// ../../packages/shared/tw/fs/sync.ts
+var init_sync = __esm({
+  "../../packages/shared/tw/fs/sync.ts"() {
+    init_runtime_compat();
+    init_runtime_compat();
+    init_async();
+  }
+});
+
+// ../../packages/shared/tw/fs/watch.ts
+var init_watch = __esm({
+  "../../packages/shared/tw/fs/watch.ts"() {
+    init_sync();
+    init_runtime_compat();
+  }
+});
+
+// ../../packages/shared/tw/fs/index.ts
+var init_fs = __esm({
+  "../../packages/shared/tw/fs/index.ts"() {
+    init_async();
+    init_glob();
+    init_sync();
+    init_watch();
+  }
+});
+
+// ../../packages/shared/tw/config/defaults.ts
+var init_defaults = __esm({
+  "../../packages/shared/tw/config/defaults.ts"() {
+    init_fs();
+  }
+});
+
+// ../../packages/shared/tw/logger/levels.ts
+var init_levels = __esm({
+  "../../packages/shared/tw/logger/levels.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/logger/colors.ts
+var ANSI, LEVEL_COLORS, LEVEL_ICONS;
+var init_colors = __esm({
+  "../../packages/shared/tw/logger/colors.ts"() {
+    init_levels();
+    ANSI = {
+      reset: "\x1B[0m",
+      bold: "\x1B[1m",
+      dim: "\x1B[2m",
+      italic: "\x1B[3m",
+      underline: "\x1B[4m",
+      blink: "\x1B[5m",
+      inverse: "\x1B[7m",
+      hidden: "\x1B[8m",
+      strikethrough: "\x1B[9m",
+      black: "\x1B[30m",
+      red: "\x1B[31m",
+      green: "\x1B[32m",
+      yellow: "\x1B[33m",
+      blue: "\x1B[34m",
+      magenta: "\x1B[35m",
+      cyan: "\x1B[36m",
+      white: "\x1B[37m",
+      bgBlack: "\x1B[40m",
+      bgRed: "\x1B[41m",
+      bgGreen: "\x1B[42m",
+      bgYellow: "\x1B[44m",
+      bgBlue: "\x1B[44m",
+      bgMagenta: "\x1B[45m",
+      bgCyan: "\x1B[46m",
+      bgWhite: "\x1B[47m",
+      brightBlack: "\x1B[90m",
+      brightRed: "\x1B[91m",
+      brightGreen: "\x1B[92m",
+      brightYellow: "\x1B[93m",
+      brightBlue: "\x1B[94m",
+      brightMagenta: "\x1B[95m",
+      brightCyan: "\x1B[96m",
+      brightWhite: "\x1B[97m"
+    };
+    LEVEL_COLORS = {
+      [0 /* SILENT */]: ANSI.dim,
+      [1 /* ERROR */]: ANSI.red,
+      [2 /* WARN */]: ANSI.yellow,
+      [3 /* INFO */]: ANSI.blue,
+      [4 /* DEBUG */]: ANSI.magenta,
+      [5 /* TRACE */]: ANSI.dim
+    };
+    LEVEL_ICONS = {
+      [0 /* SILENT */]: "",
+      [1 /* ERROR */]: "?",
+      [2 /* WARN */]: "?",
+      [3 /* INFO */]: "?",
+      [4 /* DEBUG */]: "o",
+      [5 /* TRACE */]: "o"
+    };
+  }
+});
+
+// ../../packages/shared/tw/logger/transports.ts
+var init_transports = __esm({
+  "../../packages/shared/tw/logger/transports.ts"() {
+    init_colors();
+  }
+});
+
+// ../../packages/shared/tw/logger/logger.ts
+var init_logger = __esm({
+  "../../packages/shared/tw/logger/logger.ts"() {
+    init_levels();
+    init_transports();
+  }
+});
+
+// ../../packages/shared/tw/logger/progress.ts
+var init_progress = __esm({
+  "../../packages/shared/tw/logger/progress.ts"() {
+    init_logger();
+    init_colors();
+  }
+});
+
+// ../../packages/shared/tw/logger/index.ts
+var init_logger2 = __esm({
+  "../../packages/shared/tw/logger/index.ts"() {
+    init_colors();
+    init_levels();
+    init_logger();
+    init_progress();
+    init_transports();
+  }
+});
+
+// ../../packages/shared/tw/config/validate.ts
+var init_validate = __esm({
+  "../../packages/shared/tw/config/validate.ts"() {
+    init_logger2();
+  }
+});
+
+// ../../packages/shared/tw/config/loader.ts
+var init_loader = __esm({
+  "../../packages/shared/tw/config/loader.ts"() {
+    init_defaults();
+    init_fs();
+    init_logger2();
+    init_validate();
+  }
+});
+
+// ../../packages/shared/tw/config/index.ts
+var init_config = __esm({
+  "../../packages/shared/tw/config/index.ts"() {
+    init_defaults();
+    init_loader();
+    init_validate();
+  }
+});
+
+// ../../packages/shared/tw/cache.ts
+function parseCacheBody(body) {
+  const meta = {};
+  const pairRegex = /\b(life|tag|revalidate|stale|expire)\s*=?\s*(?:"([^"]*)"|'([^']*)'|(\d+))/g;
+  let m;
+  while ((m = pairRegex.exec(body)) !== null) {
+    const key = m[1];
+    const strVal = m[2] ?? m[3] ?? null;
+    const numVal = m[4] != null ? Number(m[4]) : null;
+    if (key === "revalidate" || key === "stale" || key === "expire") {
+      if (numVal != null && Number.isFinite(numVal) && numVal >= 0) {
+        meta[key] = numVal;
+      }
+    } else if (key === "life" || key === "tag") {
+      if (strVal != null && strVal.length > 0) {
+        meta[key] = strVal;
+      }
     }
-    const acceptLc = (accept ?? "").toLowerCase();
-    for (const f of config.formats) {
-      if (acceptLc.includes(`image/${f}`)) return f === "jpeg" ? "jpeg" : f;
+  }
+  return meta;
+}
+function extractCacheDirective(source) {
+  const m = /page\s*\{[^}]*?\bcache\s*\{([^}]*)\}/.exec(source);
+  if (!m) return null;
+  return parseCacheBody(m[1]);
+}
+function cacheMetaIsUsable(meta) {
+  if (!meta) return false;
+  return meta.revalidate != null || meta.stale != null || meta.expire != null || !!meta.life;
+}
+function resolveCache(meta, profiles, opts) {
+  if (!cacheMetaIsUsable(meta)) return null;
+  let revalidate = meta.revalidate;
+  let stale = meta.stale ?? 0;
+  let expire = meta.expire;
+  if (meta.life) {
+    const profile = (profiles && profiles[meta.life]) ?? BUILTIN_CACHE_PROFILES[meta.life];
+    if (!profile) {
+      throw new Error(
+        'TW092: Unknown cache profile "' + meta.life + '". Add it to tw.config.ts cache.profiles or use one of: ' + Object.keys(BUILTIN_CACHE_PROFILES).join(", ") + "."
+      );
     }
-    return null;
+    if (revalidate == null && profile.revalidate != null) revalidate = profile.revalidate;
+    if (meta.stale == null && profile.stale != null) stale = profile.stale;
+    if (expire == null && profile.expire != null) expire = profile.expire;
   }
-  function isRemoteSource(src) {
-    return /^https?:\/\//i.test(src);
+  if (revalidate == null || !Number.isFinite(revalidate) || revalidate <= 0) return null;
+  if (expire == null || !Number.isFinite(expire)) {
+    expire = opts?.legacy ? Infinity : revalidate;
   }
-  function remoteAllowed(url) {
-    if (!config.remoteAllowHosts.includes(url.hostname)) return false;
-    if (url.username || url.password) return false;
-    return url.protocol === "https:" || url.protocol === "http:";
+  if (expire < revalidate) expire = revalidate;
+  return { revalidate, stale, expire, tag: meta.tag };
+}
+function canonicalizeQuery(search) {
+  if (!search) return "";
+  const q = search.startsWith("?") ? search.slice(1) : search;
+  if (!q) return "";
+  const pairs = [];
+  for (const part of q.split("&")) {
+    if (!part) continue;
+    const i = part.indexOf("=");
+    let k, v;
+    if (i < 0) {
+      k = part;
+      v = "";
+    } else {
+      k = part.slice(0, i);
+      v = part.slice(i + 1);
+    }
+    if (v === "") continue;
+    try {
+      k = decodeURIComponent(k);
+    } catch {
+    }
+    try {
+      v = decodeURIComponent(v);
+    } catch {
+    }
+    pairs.push([k, v]);
   }
-  function isPrivateAddress(host) {
-    const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
-    if (m) {
-      const a = Number(m[1]), b = Number(m[2]);
-      if (a === 0 || a === 10 || a === 127) return true;
-      if (a === 169 && b === 254) return true;
-      if (a === 172 && b >= 16 && b <= 31) return true;
-      if (a === 192 && b === 168) return true;
-      if (a >= 224) return true;
-      return false;
+  pairs.sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
+  return pairs.map(([k, v]) => encodeURIComponent(k) + "=" + encodeURIComponent(v)).join("&");
+}
+function balancedEnd(source, i) {
+  let depth = 0;
+  let inStr = null;
+  for (let k = i; k < source.length; k++) {
+    const ch = source[k];
+    if (inStr) {
+      if (ch === "\\") k++;
+      else if (ch === inStr) inStr = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      inStr = ch;
+      continue;
+    }
+    if (ch === "{") depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0) return k;
     }
-    const h = host.toLowerCase();
-    if (h === "::" || h === "::1") return true;
-    if (h.startsWith("fe80:")) return true;
-    if (h.startsWith("fc") || h.startsWith("fd")) return true;
-    if (h.startsWith("::ffff:")) return isPrivateAddress(h.slice(7));
-    return false;
   }
-  async function safeFetchRemote(src) {
-    let url;
+  return -1;
+}
+function readCacheProfilesSync(rootDir) {
+  try {
+    let read;
     try {
-      url = new URL(src);
+      read = globalThis.require("node:fs").readFileSync;
     } catch {
-      return null;
+      const fsmod = globalThis.process ? globalThis.process.getBuiltinModule?.("node:fs") : null;
+      if (!fsmod) return {};
+      read = fsmod.readFileSync;
     }
-    for (let hop = 0; hop < 3; hop++) {
-      if (!remoteAllowed(url)) return null;
-      try {
-        const dns = await import("node:dns");
-        const addrs = await dns.promises.lookup(url.hostname, { all: true });
-        if (!addrs.length) return null;
-        for (const a of addrs) {
-          if (isPrivateAddress(a.address)) return null;
-        }
-      } catch {
-        return null;
-      }
-      let res;
+    let src = "";
+    for (const name of ["tw.config.ts", "tw.config.js", "tw.config.mjs"]) {
       try {
-        res = await fetch(url, { redirect: "manual" });
+        src = read(rootDir.endsWith("/") ? rootDir + name : rootDir + "/" + name, "utf-8");
+        if (src) break;
       } catch {
-        return null;
-      }
-      if (res.status >= 300 && res.status < 400) {
-        const loc = res.headers.get("location");
-        if (!loc) return null;
-        try {
-          url = new URL(loc, url);
-        } catch {
-          return null;
-        }
-        continue;
       }
-      if (!res.ok) return null;
-      return Buffer.from(await res.arrayBuffer());
     }
-    return null;
+    if (!src) return {};
+    return parseCacheProfilesSource(src);
+  } catch {
+    return {};
   }
-  async function readSource(src) {
-    if (isRemoteSource(src)) {
-      const data = await safeFetchRemote(src);
-      return data ? { data, mtime: 0 } : null;
-    }
-    let decoded;
-    try {
-      decoded = decodeURIComponent(src);
-    } catch {
-      return null;
-    }
-    const clean = (0, import_node_path2.normalize)(decoded).replace(/\\/g, "/");
-    if (clean.includes("\0") || clean.includes("..")) return null;
-    const file = (0, import_node_path2.resolve)(sourceDir, "." + (clean.startsWith("/") ? clean : "/" + clean));
-    if (!file.startsWith(sourceDir + "/") && file !== sourceDir) return null;
-    const dot = clean.split("/").pop() ?? "";
-    if (dot.startsWith(".")) return null;
-    if (!(0, import_node_fs.existsSync)(file)) return null;
-    const st = (0, import_node_fs.statSync)(file);
-    if (!st.isFile()) return null;
-    return { data: (0, import_node_fs.readFileSync)(file), mtime: st.mtimeMs };
-  }
-  function cacheKey(src, w, h, q, f, mtime) {
-    return (0, import_node_crypto2.createHash)("sha256").update(`${src}|${mtime}|${w}|${h}|${q}|${f}`).digest("hex").slice(0, 32);
-  }
-  async function processBuffer(data, w, h, q, format) {
-    const sharp = await loadSharp();
-    if (sharp && format) {
-      try {
-        let img = sharp(data);
-        if (w || h) {
-          img = img.resize(w || void 0, h || void 0, {
-            fit: "inside",
-            withoutEnlargement: true
-          });
-        }
-        if (format !== "jpeg" && format !== "png") {
-          img = img.toFormat(format, { quality: q });
-        } else if (format === "jpeg") {
-          img = img.jpeg({ quality: q });
-        }
-        const out = await img.toBuffer();
-        return { data: out, contentType: `image/${format}`, viaSharp: true };
-      } catch (err2) {
-        console.warn(`  [tw/image] processing failed (${format}, ${w}x${h}), serving original: ${err2?.message ?? err2}`);
-        return { data, contentType: "", viaSharp: false };
-      }
-    }
-    if (!warnedNoSharp) {
-      warnedNoSharp = true;
-      console.warn("  [tw/image] sharp not installed \u2014 serving original images (bun add sharp to enable resizing/WebP/AVIF)");
-    }
-    return { data, contentType: "", viaSharp: false };
-  }
-  async function handle(request) {
-    const url = new URL(request.url);
-    const pathname = url.pathname;
-    if (!pathname.startsWith("/_tw/img/") && pathname !== "/_tw/img") return null;
-    if (request.method !== "GET" && request.method !== "HEAD") {
-      return new Response("Method Not Allowed", { status: 405 });
-    }
-    const q = url.searchParams;
-    let src;
-    if (pathname === "/_tw/img/_remote") {
-      src = q.get("src") ?? "";
-      if (!src) return new Response("Not Found", { status: 404 });
-    } else {
-      src = pathname.slice("/_tw/img".length) || "/";
-      if (src === "/" || src === "") return new Response("Not Found", { status: 404 });
-    }
-    const w = Math.max(0, Math.min(1e4, parseInt(q.get("w") ?? "0", 10) || 0));
-    const h = Math.max(0, Math.min(1e4, parseInt(q.get("h") ?? "0", 10) || 0));
-    const quality = Math.max(1, Math.min(100, parseInt(q.get("q") ?? String(config.quality), 10) || config.quality));
-    const format = negotiateFormat(q.get("f"), request.headers.get("accept") ?? "");
-    const source = await readSource(src);
-    if (!source) return new Response("Not Found", { status: 404 });
-    if ((0, import_node_path2.extname)(src).toLowerCase() === ".svg") {
-      return new Response(new Uint8Array(source.data), {
-        status: 200,
-        headers: {
-          "Content-Type": "image/svg+xml",
-          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
-          "X-TW-Image": "svg-passthrough"
-        }
-      });
-    }
-    if (!w && !h && !format) {
-      return new Response(new Uint8Array(source.data), {
-        status: 200,
-        headers: {
-          "Content-Type": contentTypeFor(src),
-          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
-          "X-TW-Image": "original"
-        }
-      });
-    }
-    const key = cacheKey(src, w, h, quality, format ?? "orig", source.mtime);
-    const cacheFile = (0, import_node_path2.join)(cacheDir, `${key}${format ? "." + format : ""}`);
-    const etag = `"${key}"`;
-    if (request.headers.get("if-none-match") === etag) {
-      return new Response(null, { status: 304, headers: { ETag: etag } });
-    }
-    if ((0, import_node_fs.existsSync)(cacheFile)) {
-      const cached = (0, import_node_fs.readFileSync)(cacheFile);
-      return new Response(new Uint8Array(cached), {
-        status: 200,
-        headers: {
-          "Content-Type": contentTypeFor(cacheFile),
-          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
-          ETag: etag,
-          "X-TW-Image": "cache"
-        }
-      });
-    }
-    const result = await processBuffer(source.data, w, h, quality, format);
-    if (result.viaSharp) {
-      try {
-        (0, import_node_fs.mkdirSync)(cacheDir, { recursive: true });
-        (0, import_node_fs.writeFileSync)(cacheFile, result.data);
-      } catch {
-      }
-    }
-    return new Response(new Uint8Array(result.data), {
-      status: 200,
-      headers: {
-        "Content-Type": result.contentType || contentTypeFor(src),
-        "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
-        ETag: etag,
-        "X-TW-Image": result.viaSharp ? "optimized" : "passthrough"
-      }
-    });
-  }
-  return { handle, sourceDir, cacheDir, config };
-}
-var import_node_crypto2, import_node_fs, import_node_path2, import_node_url2, DEFAULT_IMAGE_CONFIG, IMAGE_EXTENSIONS, SHARP_FORMATS;
-var init_tw = __esm({
-  "../../packages/image/tw/index.ts"() {
-    import_node_crypto2 = require("node:crypto");
-    import_node_fs = require("node:fs");
-    import_node_path2 = require("node:path");
-    import_node_url2 = require("node:url");
-    DEFAULT_IMAGE_CONFIG = {
-      quality: 75,
-      formats: ["avif", "webp"],
-      breakpoints: [320, 640, 768, 1024, 1280, 1920],
-      remoteAllowHosts: [],
-      cacheMaxAge: 86400
-    };
-    IMAGE_EXTENSIONS = {
-      ".jpg": "image/jpeg",
-      ".jpeg": "image/jpeg",
-      ".png": "image/png",
-      ".webp": "image/webp",
-      ".avif": "image/avif",
-      ".gif": "image/gif",
-      ".svg": "image/svg+xml",
-      ".ico": "image/x-icon"
-    };
-    SHARP_FORMATS = {
-      avif: "avif",
-      webp: "webp",
-      jpeg: "jpeg",
-      jpg: "jpeg",
-      png: "png"
-    };
-  }
-});
-
-// ../../packages/server/tw/websocket-manager.ts
-var DEFAULT_MAX_ROOMS, DEFAULT_MAX_ROOM_SIZE, WebSocketManager;
-var init_websocket_manager = __esm({
-  "../../packages/server/tw/websocket-manager.ts"() {
-    DEFAULT_MAX_ROOMS = 1e3;
-    DEFAULT_MAX_ROOM_SIZE = 1e4;
-    WebSocketManager = class {
-      connections = /* @__PURE__ */ new Map();
-      meta = /* @__PURE__ */ new Map();
-      rooms = /* @__PURE__ */ new Map();
-      nextId = 1;
-      maxRooms;
-      maxRoomSize;
-      constructor(options = {}) {
-        this.maxRooms = options.maxRooms ?? DEFAULT_MAX_ROOMS;
-        this.maxRoomSize = options.maxRoomSize ?? DEFAULT_MAX_ROOM_SIZE;
-      }
-      /** Register a socket on open; returns the assigned connection id. */
-      add(connection, meta = {}) {
-        let id = connection?.data?.id ?? connection?.id;
-        if (!id) {
-          id = "ws-" + process.pid + "-" + this.nextId++;
-        }
-        if (connection && typeof connection === "object") {
-          if (!connection.data) connection.data = { id };
-          else if (!connection.data.id) connection.data.id = id;
-          if (!connection.id) connection.id = id;
-        }
-        this.connections.set(id, connection);
-        this.meta.set(id, meta);
-        return id;
-      }
-      /** Lookup by connection id. */
-      get(id) {
-        return this.connections.get(id);
-      }
-      /** Deregister on close; auto-leaves rooms (last member out kills the room). */
-      remove(id) {
-        for (const room of this.rooms.values()) {
-          room.members.delete(id);
-          if (room.members.size === 0) this.rooms.delete(room.name);
-        }
-        this.meta.delete(id);
-        return this.connections.delete(id);
-      }
-      /** Serialize once and send to every socket regardless of room membership. */
-      broadcast(payload) {
-        const data = typeof payload === "string" ? payload : JSON.stringify(payload);
-        for (const conn of this.connections.values()) {
-          this.safeSend(conn, data);
-        }
-      }
-      /** Send to one connection. */
-      send(id, payload) {
-        const conn = this.connections.get(id);
-        if (!conn) return false;
-        this.safeSend(conn, typeof payload === "string" ? payload : JSON.stringify(payload));
-        return true;
-      }
-      /** All live entries. */
-      getConnections() {
-        return [...this.connections.keys()].map((id) => ({ id, meta: this.meta.get(id) ?? {} }));
-      }
-      /** Explicit pre-creation with metadata (rooms also auto-create on join). */
-      createRoom(name, metadata = {}) {
-        if (this.rooms.has(name)) return;
-        if (this.rooms.size >= this.maxRooms) {
-          throw new Error(`maxRooms reached (${this.maxRooms}): cannot create "${name}"`);
-        }
-        this.rooms.set(name, { name, metadata, members: /* @__PURE__ */ new Set() });
-      }
-      /** Join a room (auto-creates). A full room refuses joins. */
-      joinRoom(connectionId, name) {
-        if (!this.connections.has(connectionId)) return false;
-        let room = this.rooms.get(name);
-        if (!room) {
-          if (this.rooms.size >= this.maxRooms) {
-            throw new Error(`maxRooms reached (${this.maxRooms}): cannot create "${name}"`);
-          }
-          room = { name, metadata: {}, members: /* @__PURE__ */ new Set() };
-          this.rooms.set(name, room);
-        }
-        if (room.members.size >= this.maxRoomSize) return false;
-        room.members.add(connectionId);
-        return true;
-      }
-      /** Leave a room; the room disappears when its last member leaves. */
-      leaveRoom(connectionId, name) {
-        const room = this.rooms.get(name);
-        if (!room) return false;
-        const had = room.members.delete(connectionId);
-        if (room.members.size === 0) this.rooms.delete(name);
-        return had;
-      }
-      /** Iterate only that room's members — Set membership guarantees exactly one copy. */
-      broadcastToRoom(name, payload) {
-        const room = this.rooms.get(name);
-        if (!room) return 0;
-        const data = typeof payload === "string" ? payload : JSON.stringify(payload);
-        let sent = 0;
-        for (const id of room.members) {
-          const conn = this.connections.get(id);
-          if (this.safeSend(conn, data)) sent++;
-        }
-        return sent;
-      }
-      /** Room + members. */
-      getRoom(name) {
-        const room = this.rooms.get(name);
-        if (!room) return void 0;
-        return { name: room.name, metadata: room.metadata, members: [...room.members] };
-      }
-      /** All rooms. */
-      getRooms() {
-        return [...this.rooms.values()].map((r) => ({ name: r.name, members: r.members.size }));
-      }
-      safeSend(conn, data) {
-        try {
-          if (!conn || typeof conn?.send !== "function") return false;
-          if (typeof conn.readyState === "number" && conn.readyState !== 1) return false;
-          conn.send(data);
-          return true;
-        } catch {
-          return false;
-        }
-      }
-    };
-  }
-});
-
-// ../../packages/server/tw/routing/layout-chain.ts
-function resolveLayoutChain(matchResult) {
-  const { node, chain, params } = matchResult;
-  const layouts = [];
-  const templates = [];
-  for (const nodeInChain of chain) {
-    const layoutFile = nodeInChain.files.find((f) => f.type === "layout");
-    if (layoutFile) layouts.push(layoutFile);
-    const templateFile = nodeInChain.files.find((f) => f.type === "template");
-    if (templateFile) templates.push(templateFile);
-  }
-  let loading;
-  let error;
-  let notFound2;
-  let head;
-  for (let i = chain.length - 1; i >= 0; i--) {
-    if (!loading) {
-      loading = chain[i].files.find((f) => f.type === "loading");
-    }
-    if (!error) {
-      error = chain[i].files.find((f) => f.type === "error");
-    }
-    if (!notFound2) {
-      notFound2 = chain[i].files.find((f) => f.type === "not-found");
-    }
-    if (!head) {
-      head = chain[i].files.find((f) => f.type === "head");
-    }
-  }
-  const page = node.files.find((f) => f.type === "page");
-  let renderMode = "ssr";
-  if (page) {
-    renderMode = extractRenderMode(page);
-  }
-  return {
-    node,
-    chain,
-    params,
-    layouts,
-    templates,
-    loading,
-    error,
-    notFound: notFound2,
-    head,
-    page,
-    middleware: [],
-    renderMode
-  };
-}
-function findGlobalError(rootNode) {
-  return rootNode.files.find((f) => f.type === "global-error");
-}
-function findRootError(rootNode) {
-  return (rootNode.files || []).find((f) => f.type === "error");
-}
-function findRootNotFound(rootNode) {
-  return rootNode.files.find((f) => f.type === "not-found");
-}
-function collectParallelDefaults(node) {
-  const defaults = /* @__PURE__ */ new Map();
-  for (const child of node.children) {
-    if (child.kind === "parallel" && child.slotName) {
-      const defaultFile = child.files.find((f) => f.type === "default");
-      if (defaultFile) {
-        defaults.set(child.slotName, defaultFile);
-      }
-    }
-  }
-  return defaults;
 }
-function collectParallelPages(node, pathParts, index) {
-  const pages = /* @__PURE__ */ new Map();
-  for (const child of node.children) {
-    if (child.kind === "parallel" && child.slotName) {
-      const pageFile = child.files.find((f) => f.type === "page");
-      if (pageFile) {
-        pages.set(child.slotName, pageFile);
-      }
-      if (index < pathParts.length) {
-        for (const grandchild of child.children) {
-          if (grandchild.kind === "static" && grandchild.segment === pathParts[index]) {
-            const deepPage = grandchild.files.find((f) => f.type === "page");
-            if (deepPage) {
-              pages.set(child.slotName, deepPage);
-            }
-          }
-        }
-      }
-    }
-  }
-  return pages;
-}
-function extractRenderMode(page) {
-  try {
-    const fs = require("node:fs");
-    const source = fs.readFileSync(page.absolutePath, "utf-8");
-    const m = source.match(/render\s+(static|ssr|island|edge)/);
-    if (m) {
-      return m[1];
-    }
-  } catch {
-  }
-  return "ssr";
-}
-var init_layout_chain = __esm({
-  "../../packages/server/tw/routing/layout-chain.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/hashing/md5.ts
-var init_md5 = __esm({
-  "../../packages/shared/tw/hashing/md5.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/hashing/crc32.ts
-var crc32Table;
-var init_crc32 = __esm({
-  "../../packages/shared/tw/hashing/crc32.ts"() {
-    crc32Table = (() => {
-      const table = new Uint32Array(256);
-      for (let i = 0; i < 256; i++) {
-        let crc = i;
-        for (let j = 0; j < 8; j++) {
-          crc = crc & 1 ? 3988292384 ^ crc >>> 1 : crc >>> 1;
-        }
-        table[i] = crc >>> 0;
-      }
-      return table;
-    })();
-  }
-});
-
-// ../../packages/shared/tw/hashing/sha.ts
-function syncHashFallback(algorithm, data) {
-  const input = typeof data === "string" ? data : new TextDecoder().decode(data);
-  let hash2 = 2166136261;
-  for (let i = 0; i < input.length; i++) {
-    hash2 ^= input.charCodeAt(i);
-    hash2 = Math.imul(hash2, 16777619);
-  }
-  return (hash2 >>> 0).toString(16).padStart(8, "0").repeat(8);
-}
-function sha256(data) {
-  try {
-    const hasher = new BunHashSync("sha256");
-    return hasher.update(data).digest("hex");
-  } catch {
-    return syncHashFallback("sha256", data);
+function parseCacheProfilesSource(src) {
+  const out = {};
+  const cleaned = src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*/gm, "");
+  const cacheKey = /\bcache\s*:\s*\{/.exec(cleaned);
+  if (!cacheKey) return out;
+  const cacheOpen = cleaned.indexOf("{", cacheKey.index);
+  const cacheClose = balancedEnd(cleaned, cacheOpen);
+  if (cacheClose < 0) return out;
+  const cacheBody = cleaned.slice(cacheOpen + 1, cacheClose);
+  const profKey = /\bprofiles\s*:\s*\{/.exec(cacheBody);
+  if (!profKey) return out;
+  const profOpen = cacheBody.indexOf("{", profKey.index);
+  const profClose = balancedEnd(cacheBody, profOpen);
+  if (profClose < 0) return out;
+  const profBody = cacheBody.slice(profOpen + 1, profClose);
+  for (const m of profBody.matchAll(/([A-Za-z0-9_]+)\s*:\s*\{([^}]*)\}/g)) {
+    const profile = {};
+    for (const kv of m[2].matchAll(/(stale|revalidate|expire)\s*:\s*(\d+)/g)) {
+      profile[kv[1]] = Number(kv[2]);
+    }
+    if (Object.keys(profile).length > 0) out[m[1]] = profile;
   }
+  return out;
 }
-var BunHashSync;
-var init_sha = __esm({
-  "../../packages/shared/tw/hashing/sha.ts"() {
-    init_md5();
-    init_crc32();
-    BunHashSync = class {
-      hasher;
-      constructor(algorithm) {
-        const nodeCrypto = globalThis.require?.("node:crypto") || globalThis.crypto;
-        if (nodeCrypto?.createHash) {
-          this.hasher = nodeCrypto.createHash(algorithm);
-        } else {
-          throw new Error("No sync hash available");
-        }
-      }
-      update(data) {
-        const input = typeof data === "string" ? data : Buffer.from(data);
-        this.hasher.update(input);
-        return this;
-      }
-      digest(encoding) {
-        return this.hasher.digest(encoding);
-      }
-    };
-  }
-});
-
-// ../../packages/shared/tw/utils.ts
-var init_utils = __esm({
-  "../../packages/shared/tw/utils.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/fs/runtime-compat.ts
-var init_runtime_compat = __esm({
-  "../../packages/shared/tw/fs/runtime-compat.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/constants/misc.ts
-var MIME_TYPES, VLQ_BASE_SHIFT, VLQ_BASE, VLQ_BASE_MASK;
-var init_misc = __esm({
-  "../../packages/shared/tw/constants/misc.ts"() {
-    MIME_TYPES = {
-      ".html": "text/html",
-      ".htm": "text/html",
-      ".css": "text/css",
-      ".js": "text/javascript",
-      ".mjs": "text/javascript",
-      ".json": "application/json",
-      ".xml": "application/xml",
-      ".txt": "text/plain",
-      ".md": "text/markdown",
-      ".csv": "text/csv",
-      ".svg": "image/svg+xml",
-      ".png": "image/png",
-      ".jpg": "image/jpeg",
-      ".jpeg": "image/jpeg",
-      ".gif": "image/gif",
-      ".webp": "image/webp",
-      ".avif": "image/avif",
-      ".ico": "image/x-icon",
-      ".bmp": "image/bmp",
-      ".woff": "font/woff",
-      ".woff2": "font/woff2",
-      ".ttf": "font/ttf",
-      ".otf": "font/otf",
-      ".pdf": "application/pdf",
-      ".zip": "application/zip",
-      ".gz": "application/gzip",
-      ".tar": "application/x-tar",
-      ".mp4": "video/mp4",
-      ".webm": "video/webm",
-      ".mp3": "audio/mpeg",
-      ".ogg": "audio/ogg",
-      ".wav": "audio/wav",
-      ".wasm": "application/wasm",
-      ".tw": "text/tw",
-      ".tss": "text/tss",
-      ".toml": "application/toml",
-      ".yaml": "application/yaml",
-      ".yml": "application/yaml",
-      ".webmanifest": "application/manifest+json"
-    };
-    VLQ_BASE_SHIFT = 5;
-    VLQ_BASE = 1 << VLQ_BASE_SHIFT;
-    VLQ_BASE_MASK = VLQ_BASE - 1;
-  }
-});
-
-// ../../packages/shared/tw/fs/async.ts
-var init_async = __esm({
-  "../../packages/shared/tw/fs/async.ts"() {
-    init_runtime_compat();
-    init_runtime_compat();
-    init_misc();
-  }
-});
-
-// ../../packages/runtime/tw/utils/path-utils.ts
-var init_path_utils = __esm({
-  "../../packages/runtime/tw/utils/path-utils.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/fs/glob.ts
-var init_glob = __esm({
-  "../../packages/shared/tw/fs/glob.ts"() {
-    init_runtime_compat();
-    init_path_utils();
-  }
-});
-
-// ../../packages/shared/tw/fs/sync.ts
-var init_sync = __esm({
-  "../../packages/shared/tw/fs/sync.ts"() {
-    init_runtime_compat();
-    init_runtime_compat();
-    init_async();
-  }
-});
-
-// ../../packages/shared/tw/fs/watch.ts
-var init_watch = __esm({
-  "../../packages/shared/tw/fs/watch.ts"() {
-    init_sync();
-    init_runtime_compat();
-  }
-});
-
-// ../../packages/shared/tw/fs/index.ts
-var init_fs = __esm({
-  "../../packages/shared/tw/fs/index.ts"() {
-    init_async();
-    init_glob();
-    init_sync();
-    init_watch();
-  }
-});
-
-// ../../packages/shared/tw/config/defaults.ts
-var init_defaults = __esm({
-  "../../packages/shared/tw/config/defaults.ts"() {
-    init_fs();
-  }
-});
-
-// ../../packages/shared/tw/logger/levels.ts
-var init_levels = __esm({
-  "../../packages/shared/tw/logger/levels.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/logger/colors.ts
-var ANSI, LEVEL_COLORS, LEVEL_ICONS;
-var init_colors = __esm({
-  "../../packages/shared/tw/logger/colors.ts"() {
-    init_levels();
-    ANSI = {
-      reset: "\x1B[0m",
-      bold: "\x1B[1m",
-      dim: "\x1B[2m",
-      italic: "\x1B[3m",
-      underline: "\x1B[4m",
-      blink: "\x1B[5m",
-      inverse: "\x1B[7m",
-      hidden: "\x1B[8m",
-      strikethrough: "\x1B[9m",
-      black: "\x1B[30m",
-      red: "\x1B[31m",
-      green: "\x1B[32m",
-      yellow: "\x1B[33m",
-      blue: "\x1B[34m",
-      magenta: "\x1B[35m",
-      cyan: "\x1B[36m",
-      white: "\x1B[37m",
-      bgBlack: "\x1B[40m",
-      bgRed: "\x1B[41m",
-      bgGreen: "\x1B[42m",
-      bgYellow: "\x1B[44m",
-      bgBlue: "\x1B[44m",
-      bgMagenta: "\x1B[45m",
-      bgCyan: "\x1B[46m",
-      bgWhite: "\x1B[47m",
-      brightBlack: "\x1B[90m",
-      brightRed: "\x1B[91m",
-      brightGreen: "\x1B[92m",
-      brightYellow: "\x1B[93m",
-      brightBlue: "\x1B[94m",
-      brightMagenta: "\x1B[95m",
-      brightCyan: "\x1B[96m",
-      brightWhite: "\x1B[97m"
-    };
-    LEVEL_COLORS = {
-      [0 /* SILENT */]: ANSI.dim,
-      [1 /* ERROR */]: ANSI.red,
-      [2 /* WARN */]: ANSI.yellow,
-      [3 /* INFO */]: ANSI.blue,
-      [4 /* DEBUG */]: ANSI.magenta,
-      [5 /* TRACE */]: ANSI.dim
-    };
-    LEVEL_ICONS = {
-      [0 /* SILENT */]: "",
-      [1 /* ERROR */]: "?",
-      [2 /* WARN */]: "?",
-      [3 /* INFO */]: "?",
-      [4 /* DEBUG */]: "o",
-      [5 /* TRACE */]: "o"
+var BUILTIN_CACHE_PROFILES;
+var init_cache = __esm({
+  "../../packages/shared/tw/cache.ts"() {
+    BUILTIN_CACHE_PROFILES = {
+      seconds: { stale: 1, revalidate: 1, expire: 2 },
+      minutes: { stale: 60, revalidate: 300, expire: 3600 },
+      hours: { stale: 3600, revalidate: 14400, expire: 86400 },
+      days: { stale: 86400, revalidate: 604800, expire: 2592e3 },
+      max: { stale: 2592e3, revalidate: 5184e3, expire: 31536e3 }
     };
   }
 });
 
-// ../../packages/shared/tw/logger/transports.ts
-var init_transports = __esm({
-  "../../packages/shared/tw/logger/transports.ts"() {
-    init_colors();
-  }
-});
-
-// ../../packages/shared/tw/logger/logger.ts
-var init_logger = __esm({
-  "../../packages/shared/tw/logger/logger.ts"() {
-    init_levels();
-    init_transports();
-  }
-});
-
-// ../../packages/shared/tw/logger/progress.ts
-var init_progress = __esm({
-  "../../packages/shared/tw/logger/progress.ts"() {
-    init_logger();
-    init_colors();
-  }
-});
-
-// ../../packages/shared/tw/logger/index.ts
-var init_logger2 = __esm({
-  "../../packages/shared/tw/logger/index.ts"() {
-    init_colors();
-    init_levels();
-    init_logger();
-    init_progress();
-    init_transports();
-  }
-});
-
-// ../../packages/shared/tw/config/validate.ts
-var init_validate = __esm({
-  "../../packages/shared/tw/config/validate.ts"() {
-    init_logger2();
-  }
-});
-
-// ../../packages/shared/tw/config/loader.ts
-var init_loader = __esm({
-  "../../packages/shared/tw/config/loader.ts"() {
-    init_defaults();
-    init_fs();
-    init_logger2();
-    init_validate();
-  }
-});
-
-// ../../packages/shared/tw/config/index.ts
-var init_config = __esm({
-  "../../packages/shared/tw/config/index.ts"() {
-    init_defaults();
-    init_loader();
-    init_validate();
-  }
-});
-
 // ../../packages/shared/tw/constants/aria.ts
 var init_aria = __esm({
   "../../packages/shared/tw/constants/aria.ts"() {
@@ -1877,195 +1468,781 @@ var init_html = __esm({
   }
 });
 
-// ../../packages/shared/tw/constants/http.ts
-var init_http = __esm({
-  "../../packages/shared/tw/constants/http.ts"() {
+// ../../packages/shared/tw/constants/http.ts
+var init_http = __esm({
+  "../../packages/shared/tw/constants/http.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/constants/index.ts
+var init_constants = __esm({
+  "../../packages/shared/tw/constants/index.ts"() {
+    init_aria();
+    init_css();
+    init_events();
+    init_html();
+    init_http();
+    init_misc();
+  }
+});
+
+// ../../packages/shared/tw/crypto/index.ts
+var init_crypto = __esm({
+  "../../packages/shared/tw/crypto/index.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/env/environment.ts
+var init_environment = __esm({
+  "../../packages/shared/tw/env/environment.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/env/index.ts
+var init_env = __esm({
+  "../../packages/shared/tw/env/index.ts"() {
+    init_environment();
+  }
+});
+
+// ../../packages/shared/tw/hashing/etag.ts
+var init_etag = __esm({
+  "../../packages/shared/tw/hashing/etag.ts"() {
+    init_md5();
+    init_sha();
+  }
+});
+
+// ../../packages/shared/tw/hashing/hmac.ts
+var init_hmac = __esm({
+  "../../packages/shared/tw/hashing/hmac.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/hashing/merkle.ts
+var init_merkle = __esm({
+  "../../packages/shared/tw/hashing/merkle.ts"() {
+    init_sha();
+  }
+});
+
+// ../../packages/shared/tw/hashing/uuid.ts
+var init_uuid = __esm({
+  "../../packages/shared/tw/hashing/uuid.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/hashing/index.ts
+var init_hashing = __esm({
+  "../../packages/shared/tw/hashing/index.ts"() {
+    init_crc32();
+    init_etag();
+    init_hmac();
+    init_md5();
+    init_merkle();
+    init_sha();
+    init_uuid();
+  }
+});
+
+// ../../packages/shared/tw/routing/constants.ts
+function getRouteFileType(baseName) {
+  return SPECIAL_FILES[baseName] ?? null;
+}
+function isPrivateFolder(name) {
+  return name.startsWith("_");
+}
+function extractGroupName(name) {
+  const m = name.match(/^\(([^)]+)\)$/);
+  if (!m) return null;
+  if (m[1].startsWith(".")) return null;
+  return m[1];
+}
+function parseInterceptingFolder(name) {
+  const m = name.match(/^\((\.{1,3})([^)]+)\)$/);
+  if (!m) return null;
+  return { levels: m[1].length, target: m[2] };
+}
+function parseSegment(name) {
+  const optCatchAll = name.match(/^\[\[\.\.\.([^\]]+)\]\]$/);
+  if (optCatchAll) return { type: "optional-catch-all", name: optCatchAll[1] };
+  const catchAll = name.match(/^\[\.\.\.([^\]]+)\]$/);
+  if (catchAll) return { type: "catch-all", name: catchAll[1] };
+  const dynamic = name.match(/^\[([^\]]+)\]$/);
+  if (dynamic) return { type: "dynamic", name: dynamic[1] };
+  return { type: "static", name };
+}
+function extractSlotName(name) {
+  if (!name.startsWith("@")) return null;
+  return name.slice(1);
+}
+var TW_EXTENSION, TWM_EXTENSION, ROUTE_EXTENSIONS, SPECIAL_FILES;
+var init_constants2 = __esm({
+  "../../packages/shared/tw/routing/constants.ts"() {
+    TW_EXTENSION = ".tw";
+    TWM_EXTENSION = ".twm";
+    ROUTE_EXTENSIONS = /* @__PURE__ */ new Set([TW_EXTENSION, TWM_EXTENSION]);
+    SPECIAL_FILES = {
+      "page": "page",
+      "index": "page",
+      // Intercepting routes (docs/intercepting-routes.md): a `(.)page.tw`
+      // beside a page renders INSTEAD of it on SPA navigation (X-TW-Navigate).
+      "(.)page": "intercept-page",
+      "layout": "layout",
+      "template": "template",
+      "loading": "loading",
+      "error": "error",
+      "not-found": "not-found",
+      "global-error": "global-error",
+      "default": "default",
+      "head": "head",
+      "route": "route",
+      "middleware": "middleware"
+    };
+  }
+});
+
+// ../../packages/shared/tw/routing/index.ts
+var init_routing = __esm({
+  "../../packages/shared/tw/routing/index.ts"() {
+    init_constants2();
   }
 });
 
-// ../../packages/shared/tw/constants/index.ts
-var init_constants = __esm({
-  "../../packages/shared/tw/constants/index.ts"() {
-    init_aria();
-    init_css();
-    init_events();
-    init_html();
-    init_http();
-    init_misc();
+// ../../packages/shared/tw/types/common.ts
+var init_common = __esm({
+  "../../packages/shared/tw/types/common.ts"() {
   }
 });
 
-// ../../packages/shared/tw/crypto/index.ts
-var init_crypto = __esm({
-  "../../packages/shared/tw/crypto/index.ts"() {
+// ../../packages/shared/tw/types/errors.ts
+var init_errors = __esm({
+  "../../packages/shared/tw/types/errors.ts"() {
   }
 });
 
-// ../../packages/shared/tw/env/environment.ts
-var init_environment = __esm({
-  "../../packages/shared/tw/env/environment.ts"() {
+// ../../packages/shared/tw/types/results.ts
+var init_results = __esm({
+  "../../packages/shared/tw/types/results.ts"() {
   }
 });
 
-// ../../packages/shared/tw/env/index.ts
-var init_env = __esm({
-  "../../packages/shared/tw/env/index.ts"() {
-    init_environment();
+// ../../packages/shared/tw/types/index.ts
+var init_types = __esm({
+  "../../packages/shared/tw/types/index.ts"() {
+    init_common();
+    init_errors();
+    init_results();
   }
 });
 
-// ../../packages/shared/tw/hashing/etag.ts
-var init_etag = __esm({
-  "../../packages/shared/tw/hashing/etag.ts"() {
-    init_md5();
+// ../../packages/shared/tw/utils/string/transform.ts
+var init_transform = __esm({
+  "../../packages/shared/tw/utils/string/transform.ts"() {
+  }
+});
+
+// ../../packages/shared/tw/index.ts
+var init_tw = __esm({
+  "../../packages/shared/tw/index.ts"() {
     init_sha();
+    init_utils();
+    init_config();
+    init_cache();
+    init_constants();
+    init_crypto();
+    init_env();
+    init_fs();
+    init_hashing();
+    init_logger2();
+    init_routing();
+    init_types();
+    init_transform();
   }
 });
 
-// ../../packages/shared/tw/hashing/hmac.ts
-var init_hmac = __esm({
-  "../../packages/shared/tw/hashing/hmac.ts"() {
+// ../../packages/shared/tw/node-import.ts
+var node_import_exports = {};
+__export(node_import_exports, {
+  twImportTs: () => twImportTs
+});
+async function twImportTs(tsPath) {
+  if (!globalThis.__TW_NODE) {
+    return import(tsPath);
+  }
+  const esbuildMain = globalThis.__TW_ESBUILD_MODULE;
+  const esbuild = await (esbuildMain ? import(esbuildMain) : import("esbuild"));
+  const safe = tsPath.replace(/[^a-zA-Z0-9]/g, "_").slice(-120);
+  const cachePath = (0, import_node_path.join)((0, import_node_os.tmpdir)(), "tw-" + safe + ".mjs");
+  await esbuild.build({
+    entryPoints: [tsPath],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    target: "node18",
+    outfile: cachePath,
+    logLevel: "silent"
+  });
+  return import((0, import_node_url.pathToFileURL)(cachePath).href);
+}
+var import_node_path, import_node_os, import_node_url;
+var init_node_import = __esm({
+  "../../packages/shared/tw/node-import.ts"() {
+    import_node_path = require("node:path");
+    import_node_os = require("node:os");
+    import_node_url = require("node:url");
+  }
+});
+
+// ../../packages/image/tw/index.ts
+function optimizedImageUrl(src, opts = {}) {
+  const p = new URLSearchParams();
+  if (opts.width) p.set("w", String(opts.width));
+  if (opts.height) p.set("h", String(opts.height));
+  if (opts.quality) p.set("q", String(opts.quality));
+  p.set("f", opts.format ?? "auto");
+  const qs = p.toString();
+  return `/_tw/img${src.startsWith("/") ? src : "/" + src}?${qs}`;
+}
+function imageAttributesFor(opts, config = DEFAULT_IMAGE_CONFIG) {
+  const width = opts.width ?? 0;
+  const quality = opts.quality ?? config.quality;
+  const format = config.formats[0] ?? "webp";
+  const isRemote = /^https?:\/\//i.test(opts.src);
+  const src = isRemote ? `/_tw/img/_remote?src=${encodeURIComponent(opts.src)}&w=${opts.width ?? ""}&h=${opts.height ?? ""}&q=${quality}&f=auto` : optimizedImageUrl(opts.src, { width: opts.width, height: opts.height, quality });
+  const widths = config.breakpoints.filter((bp) => width === 0 || bp <= width * 2);
+  const srcset = widths.map(
+    (bp) => isRemote ? `/_tw/img/_remote?src=${encodeURIComponent(opts.src)}&w=${bp}&q=${quality}&f=auto ${bp}w` : `${optimizedImageUrl(opts.src, { width: bp, quality })} ${bp}w`
+  ).join(", ");
+  const sizes = width > 0 ? `(max-width: ${width}px) 100vw, ${width}px` : "100vw";
+  const loading = opts.priority ? "eager" : "lazy";
+  return { src, srcset, sizes, width, height: opts.height ?? 0, loading, decoding: "async", format };
+}
+function createImageHandler(options) {
+  const rootDir = (0, import_node_path2.resolve)(options.rootDir);
+  const sourceDir = (0, import_node_path2.resolve)(options.sourceDir ?? (0, import_node_path2.join)(rootDir, "public"));
+  const cacheDir = (0, import_node_path2.resolve)(options.cacheDir ?? (0, import_node_path2.join)(rootDir, ".tw", "img", "cache"));
+  const config = { ...DEFAULT_IMAGE_CONFIG, ...options.config };
+  let sharpPromise = null;
+  let warnedNoSharp = false;
+  async function loadSharp() {
+    if (!sharpPromise) {
+      sharpPromise = (async () => {
+        let req;
+        try {
+          const { createRequire } = await import("node:module");
+          req = createRequire((0, import_node_path2.join)(rootDir, "package.json"));
+        } catch {
+        }
+        const candidates = [
+          (0, import_node_path2.join)(rootDir, "node_modules", "sharp"),
+          "sharp"
+        ];
+        for (const candidate of candidates) {
+          if (typeof req === "function") {
+            try {
+              const m = req(candidate);
+              const mod = m?.default ?? m;
+              if (mod && typeof mod === "function") return mod;
+            } catch {
+            }
+          }
+          try {
+            const href = candidate.startsWith("/") ? (0, import_node_url2.pathToFileURL)(candidate).href : candidate;
+            const m = await import(href);
+            const mod = m?.default ?? m;
+            if (mod && typeof mod === "function") return mod;
+          } catch {
+          }
+        }
+        return null;
+      })();
+    }
+    return sharpPromise;
+  }
+  function contentTypeFor(path) {
+    return IMAGE_EXTENSIONS[(0, import_node_path2.extname)(path).toLowerCase()] ?? "application/octet-stream";
+  }
+  function negotiateFormat(requested, accept) {
+    if (requested && requested !== "auto") {
+      return SHARP_FORMATS[requested.toLowerCase()] ?? null;
+    }
+    const acceptLc = (accept ?? "").toLowerCase();
+    for (const f of config.formats) {
+      if (acceptLc.includes(`image/${f}`)) return f === "jpeg" ? "jpeg" : f;
+    }
+    return null;
+  }
+  function isRemoteSource(src) {
+    return /^https?:\/\//i.test(src);
+  }
+  function remoteAllowed(url) {
+    if (!config.remoteAllowHosts.includes(url.hostname)) return false;
+    if (url.username || url.password) return false;
+    return url.protocol === "https:" || url.protocol === "http:";
+  }
+  function isPrivateAddress(host) {
+    const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    if (m) {
+      const a = Number(m[1]), b = Number(m[2]);
+      if (a === 0 || a === 10 || a === 127) return true;
+      if (a === 169 && b === 254) return true;
+      if (a === 172 && b >= 16 && b <= 31) return true;
+      if (a === 192 && b === 168) return true;
+      if (a >= 224) return true;
+      return false;
+    }
+    const h = host.toLowerCase();
+    if (h === "::" || h === "::1") return true;
+    if (h.startsWith("fe80:")) return true;
+    if (h.startsWith("fc") || h.startsWith("fd")) return true;
+    if (h.startsWith("::ffff:")) return isPrivateAddress(h.slice(7));
+    return false;
+  }
+  async function safeFetchRemote(src) {
+    let url;
+    try {
+      url = new URL(src);
+    } catch {
+      return null;
+    }
+    for (let hop = 0; hop < 3; hop++) {
+      if (!remoteAllowed(url)) return null;
+      try {
+        const dns = await import("node:dns");
+        const addrs = await dns.promises.lookup(url.hostname, { all: true });
+        if (!addrs.length) return null;
+        for (const a of addrs) {
+          if (isPrivateAddress(a.address)) return null;
+        }
+      } catch {
+        return null;
+      }
+      let res;
+      try {
+        res = await fetch(url, { redirect: "manual" });
+      } catch {
+        return null;
+      }
+      if (res.status >= 300 && res.status < 400) {
+        const loc = res.headers.get("location");
+        if (!loc) return null;
+        try {
+          url = new URL(loc, url);
+        } catch {
+          return null;
+        }
+        continue;
+      }
+      if (!res.ok) return null;
+      return Buffer.from(await res.arrayBuffer());
+    }
+    return null;
+  }
+  async function readSource(src) {
+    if (isRemoteSource(src)) {
+      const data = await safeFetchRemote(src);
+      return data ? { data, mtime: 0 } : null;
+    }
+    let decoded;
+    try {
+      decoded = decodeURIComponent(src);
+    } catch {
+      return null;
+    }
+    const clean = (0, import_node_path2.normalize)(decoded).replace(/\\/g, "/");
+    if (clean.includes("\0") || clean.includes("..")) return null;
+    const file = (0, import_node_path2.resolve)(sourceDir, "." + (clean.startsWith("/") ? clean : "/" + clean));
+    if (!file.startsWith(sourceDir + "/") && file !== sourceDir) return null;
+    const dot = clean.split("/").pop() ?? "";
+    if (dot.startsWith(".")) return null;
+    if (!(0, import_node_fs.existsSync)(file)) return null;
+    const st = (0, import_node_fs.statSync)(file);
+    if (!st.isFile()) return null;
+    return { data: (0, import_node_fs.readFileSync)(file), mtime: st.mtimeMs };
+  }
+  function cacheKey(src, w, h, q, f, mtime) {
+    return (0, import_node_crypto2.createHash)("sha256").update(`${src}|${mtime}|${w}|${h}|${q}|${f}`).digest("hex").slice(0, 32);
+  }
+  async function processBuffer(data, w, h, q, format) {
+    const sharp = await loadSharp();
+    if (sharp && format) {
+      try {
+        let img = sharp(data);
+        if (w || h) {
+          img = img.resize(w || void 0, h || void 0, {
+            fit: "inside",
+            withoutEnlargement: true
+          });
+        }
+        if (format !== "jpeg" && format !== "png") {
+          img = img.toFormat(format, { quality: q });
+        } else if (format === "jpeg") {
+          img = img.jpeg({ quality: q });
+        }
+        const out = await img.toBuffer();
+        return { data: out, contentType: `image/${format}`, viaSharp: true };
+      } catch (err2) {
+        console.warn(`  [tw/image] processing failed (${format}, ${w}x${h}), serving original: ${err2?.message ?? err2}`);
+        return { data, contentType: "", viaSharp: false };
+      }
+    }
+    if (!warnedNoSharp) {
+      warnedNoSharp = true;
+      console.warn("  [tw/image] sharp not installed \u2014 serving original images (bun add sharp to enable resizing/WebP/AVIF)");
+    }
+    return { data, contentType: "", viaSharp: false };
+  }
+  async function handle(request) {
+    const url = new URL(request.url);
+    const pathname = url.pathname;
+    if (!pathname.startsWith("/_tw/img/") && pathname !== "/_tw/img") return null;
+    if (request.method !== "GET" && request.method !== "HEAD") {
+      return new Response("Method Not Allowed", { status: 405 });
+    }
+    const q = url.searchParams;
+    let src;
+    if (pathname === "/_tw/img/_remote") {
+      src = q.get("src") ?? "";
+      if (!src) return new Response("Not Found", { status: 404 });
+    } else {
+      src = pathname.slice("/_tw/img".length) || "/";
+      if (src === "/" || src === "") return new Response("Not Found", { status: 404 });
+    }
+    const w = Math.max(0, Math.min(1e4, parseInt(q.get("w") ?? "0", 10) || 0));
+    const h = Math.max(0, Math.min(1e4, parseInt(q.get("h") ?? "0", 10) || 0));
+    const quality = Math.max(1, Math.min(100, parseInt(q.get("q") ?? String(config.quality), 10) || config.quality));
+    const format = negotiateFormat(q.get("f"), request.headers.get("accept") ?? "");
+    const source = await readSource(src);
+    if (!source) return new Response("Not Found", { status: 404 });
+    if ((0, import_node_path2.extname)(src).toLowerCase() === ".svg") {
+      return new Response(new Uint8Array(source.data), {
+        status: 200,
+        headers: {
+          "Content-Type": "image/svg+xml",
+          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
+          "X-TW-Image": "svg-passthrough"
+        }
+      });
+    }
+    if (!w && !h && !format) {
+      return new Response(new Uint8Array(source.data), {
+        status: 200,
+        headers: {
+          "Content-Type": contentTypeFor(src),
+          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
+          "X-TW-Image": "original"
+        }
+      });
+    }
+    const key = cacheKey(src, w, h, quality, format ?? "orig", source.mtime);
+    const cacheFile = (0, import_node_path2.join)(cacheDir, `${key}${format ? "." + format : ""}`);
+    const etag = `"${key}"`;
+    if (request.headers.get("if-none-match") === etag) {
+      return new Response(null, { status: 304, headers: { ETag: etag } });
+    }
+    if ((0, import_node_fs.existsSync)(cacheFile)) {
+      const cached = (0, import_node_fs.readFileSync)(cacheFile);
+      return new Response(new Uint8Array(cached), {
+        status: 200,
+        headers: {
+          "Content-Type": contentTypeFor(cacheFile),
+          "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
+          ETag: etag,
+          "X-TW-Image": "cache"
+        }
+      });
+    }
+    const result = await processBuffer(source.data, w, h, quality, format);
+    if (result.viaSharp) {
+      try {
+        (0, import_node_fs.mkdirSync)(cacheDir, { recursive: true });
+        (0, import_node_fs.writeFileSync)(cacheFile, result.data);
+      } catch {
+      }
+    }
+    return new Response(new Uint8Array(result.data), {
+      status: 200,
+      headers: {
+        "Content-Type": result.contentType || contentTypeFor(src),
+        "Cache-Control": `public, max-age=${config.cacheMaxAge}`,
+        ETag: etag,
+        "X-TW-Image": result.viaSharp ? "optimized" : "passthrough"
+      }
+    });
+  }
+  return { handle, sourceDir, cacheDir, config };
+}
+var import_node_crypto2, import_node_fs, import_node_path2, import_node_url2, DEFAULT_IMAGE_CONFIG, IMAGE_EXTENSIONS, SHARP_FORMATS;
+var init_tw2 = __esm({
+  "../../packages/image/tw/index.ts"() {
+    import_node_crypto2 = require("node:crypto");
+    import_node_fs = require("node:fs");
+    import_node_path2 = require("node:path");
+    import_node_url2 = require("node:url");
+    DEFAULT_IMAGE_CONFIG = {
+      quality: 75,
+      formats: ["avif", "webp"],
+      breakpoints: [320, 640, 768, 1024, 1280, 1920],
+      remoteAllowHosts: [],
+      cacheMaxAge: 86400
+    };
+    IMAGE_EXTENSIONS = {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".webp": "image/webp",
+      ".avif": "image/avif",
+      ".gif": "image/gif",
+      ".svg": "image/svg+xml",
+      ".ico": "image/x-icon"
+    };
+    SHARP_FORMATS = {
+      avif: "avif",
+      webp: "webp",
+      jpeg: "jpeg",
+      jpg: "jpeg",
+      png: "png"
+    };
+  }
+});
+
+// ../../packages/server/tw/websocket-manager.ts
+var DEFAULT_MAX_ROOMS, DEFAULT_MAX_ROOM_SIZE, WebSocketManager;
+var init_websocket_manager = __esm({
+  "../../packages/server/tw/websocket-manager.ts"() {
+    DEFAULT_MAX_ROOMS = 1e3;
+    DEFAULT_MAX_ROOM_SIZE = 1e4;
+    WebSocketManager = class {
+      connections = /* @__PURE__ */ new Map();
+      meta = /* @__PURE__ */ new Map();
+      rooms = /* @__PURE__ */ new Map();
+      nextId = 1;
+      maxRooms;
+      maxRoomSize;
+      constructor(options = {}) {
+        this.maxRooms = options.maxRooms ?? DEFAULT_MAX_ROOMS;
+        this.maxRoomSize = options.maxRoomSize ?? DEFAULT_MAX_ROOM_SIZE;
+      }
+      /** Register a socket on open; returns the assigned connection id. */
+      add(connection, meta = {}) {
+        let id = connection?.data?.id ?? connection?.id;
+        if (!id) {
+          id = "ws-" + process.pid + "-" + this.nextId++;
+        }
+        if (connection && typeof connection === "object") {
+          if (!connection.data) connection.data = { id };
+          else if (!connection.data.id) connection.data.id = id;
+          if (!connection.id) connection.id = id;
+        }
+        this.connections.set(id, connection);
+        this.meta.set(id, meta);
+        return id;
+      }
+      /** Lookup by connection id. */
+      get(id) {
+        return this.connections.get(id);
+      }
+      /** Deregister on close; auto-leaves rooms (last member out kills the room). */
+      remove(id) {
+        for (const room of this.rooms.values()) {
+          room.members.delete(id);
+          if (room.members.size === 0) this.rooms.delete(room.name);
+        }
+        this.meta.delete(id);
+        return this.connections.delete(id);
+      }
+      /** Serialize once and send to every socket regardless of room membership. */
+      broadcast(payload) {
+        const data = typeof payload === "string" ? payload : JSON.stringify(payload);
+        for (const conn of this.connections.values()) {
+          this.safeSend(conn, data);
+        }
+      }
+      /** Send to one connection. */
+      send(id, payload) {
+        const conn = this.connections.get(id);
+        if (!conn) return false;
+        this.safeSend(conn, typeof payload === "string" ? payload : JSON.stringify(payload));
+        return true;
+      }
+      /** All live entries. */
+      getConnections() {
+        return [...this.connections.keys()].map((id) => ({ id, meta: this.meta.get(id) ?? {} }));
+      }
+      /** Explicit pre-creation with metadata (rooms also auto-create on join). */
+      createRoom(name, metadata = {}) {
+        if (this.rooms.has(name)) return;
+        if (this.rooms.size >= this.maxRooms) {
+          throw new Error(`maxRooms reached (${this.maxRooms}): cannot create "${name}"`);
+        }
+        this.rooms.set(name, { name, metadata, members: /* @__PURE__ */ new Set() });
+      }
+      /** Join a room (auto-creates). A full room refuses joins. */
+      joinRoom(connectionId, name) {
+        if (!this.connections.has(connectionId)) return false;
+        let room = this.rooms.get(name);
+        if (!room) {
+          if (this.rooms.size >= this.maxRooms) {
+            throw new Error(`maxRooms reached (${this.maxRooms}): cannot create "${name}"`);
+          }
+          room = { name, metadata: {}, members: /* @__PURE__ */ new Set() };
+          this.rooms.set(name, room);
+        }
+        if (room.members.size >= this.maxRoomSize) return false;
+        room.members.add(connectionId);
+        return true;
+      }
+      /** Leave a room; the room disappears when its last member leaves. */
+      leaveRoom(connectionId, name) {
+        const room = this.rooms.get(name);
+        if (!room) return false;
+        const had = room.members.delete(connectionId);
+        if (room.members.size === 0) this.rooms.delete(name);
+        return had;
+      }
+      /** Iterate only that room's members — Set membership guarantees exactly one copy. */
+      broadcastToRoom(name, payload) {
+        const room = this.rooms.get(name);
+        if (!room) return 0;
+        const data = typeof payload === "string" ? payload : JSON.stringify(payload);
+        let sent = 0;
+        for (const id of room.members) {
+          const conn = this.connections.get(id);
+          if (this.safeSend(conn, data)) sent++;
+        }
+        return sent;
+      }
+      /** Room + members. */
+      getRoom(name) {
+        const room = this.rooms.get(name);
+        if (!room) return void 0;
+        return { name: room.name, metadata: room.metadata, members: [...room.members] };
+      }
+      /** All rooms. */
+      getRooms() {
+        return [...this.rooms.values()].map((r) => ({ name: r.name, members: r.members.size }));
+      }
+      safeSend(conn, data) {
+        try {
+          if (!conn || typeof conn?.send !== "function") return false;
+          if (typeof conn.readyState === "number" && conn.readyState !== 1) return false;
+          conn.send(data);
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    };
   }
 });
 
-// ../../packages/shared/tw/hashing/merkle.ts
-var init_merkle = __esm({
-  "../../packages/shared/tw/hashing/merkle.ts"() {
-    init_sha();
+// ../../packages/server/tw/routing/layout-chain.ts
+function resolveLayoutChain(matchResult) {
+  const { node, chain, params } = matchResult;
+  const layouts = [];
+  const templates = [];
+  for (const nodeInChain of chain) {
+    const layoutFile = nodeInChain.files.find((f) => f.type === "layout");
+    if (layoutFile) layouts.push(layoutFile);
+    const templateFile = nodeInChain.files.find((f) => f.type === "template");
+    if (templateFile) templates.push(templateFile);
   }
-});
-
-// ../../packages/shared/tw/hashing/uuid.ts
-var init_uuid = __esm({
-  "../../packages/shared/tw/hashing/uuid.ts"() {
+  let loading;
+  let error;
+  let notFound2;
+  let head;
+  for (let i = chain.length - 1; i >= 0; i--) {
+    if (!loading) {
+      loading = chain[i].files.find((f) => f.type === "loading");
+    }
+    if (!error) {
+      error = chain[i].files.find((f) => f.type === "error");
+    }
+    if (!notFound2) {
+      notFound2 = chain[i].files.find((f) => f.type === "not-found");
+    }
+    if (!head) {
+      head = chain[i].files.find((f) => f.type === "head");
+    }
   }
-});
-
-// ../../packages/shared/tw/hashing/index.ts
-var init_hashing = __esm({
-  "../../packages/shared/tw/hashing/index.ts"() {
-    init_crc32();
-    init_etag();
-    init_hmac();
-    init_md5();
-    init_merkle();
-    init_sha();
-    init_uuid();
+  const page = node.files.find((f) => f.type === "page");
+  let renderMode = "ssr";
+  if (page) {
+    renderMode = extractRenderMode(page);
   }
-});
-
-// ../../packages/shared/tw/routing/constants.ts
-function getRouteFileType(baseName) {
-  return SPECIAL_FILES[baseName] ?? null;
-}
-function isPrivateFolder(name) {
-  return name.startsWith("_");
-}
-function extractGroupName(name) {
-  const m = name.match(/^\(([^)]+)\)$/);
-  if (!m) return null;
-  if (m[1].startsWith(".")) return null;
-  return m[1];
+  return {
+    node,
+    chain,
+    params,
+    layouts,
+    templates,
+    loading,
+    error,
+    notFound: notFound2,
+    head,
+    page,
+    middleware: [],
+    renderMode
+  };
 }
-function parseInterceptingFolder(name) {
-  const m = name.match(/^\((\.{1,3})([^)]+)\)$/);
-  if (!m) return null;
-  return { levels: m[1].length, target: m[2] };
+function findGlobalError(rootNode) {
+  return rootNode.files.find((f) => f.type === "global-error");
 }
-function parseSegment(name) {
-  const optCatchAll = name.match(/^\[\[\.\.\.([^\]]+)\]\]$/);
-  if (optCatchAll) return { type: "optional-catch-all", name: optCatchAll[1] };
-  const catchAll = name.match(/^\[\.\.\.([^\]]+)\]$/);
-  if (catchAll) return { type: "catch-all", name: catchAll[1] };
-  const dynamic = name.match(/^\[([^\]]+)\]$/);
-  if (dynamic) return { type: "dynamic", name: dynamic[1] };
-  return { type: "static", name };
+function findRootError(rootNode) {
+  return (rootNode.files || []).find((f) => f.type === "error");
 }
-function extractSlotName(name) {
-  if (!name.startsWith("@")) return null;
-  return name.slice(1);
+function findRootNotFound(rootNode) {
+  return rootNode.files.find((f) => f.type === "not-found");
 }
-var TW_EXTENSION, TWM_EXTENSION, ROUTE_EXTENSIONS, SPECIAL_FILES;
-var init_constants2 = __esm({
-  "../../packages/shared/tw/routing/constants.ts"() {
-    TW_EXTENSION = ".tw";
-    TWM_EXTENSION = ".twm";
-    ROUTE_EXTENSIONS = /* @__PURE__ */ new Set([TW_EXTENSION, TWM_EXTENSION]);
-    SPECIAL_FILES = {
-      "page": "page",
-      "index": "page",
-      // Intercepting routes (docs/intercepting-routes.md): a `(.)page.tw`
-      // beside a page renders INSTEAD of it on SPA navigation (X-TW-Navigate).
-      "(.)page": "intercept-page",
-      "layout": "layout",
-      "template": "template",
-      "loading": "loading",
-      "error": "error",
-      "not-found": "not-found",
-      "global-error": "global-error",
-      "default": "default",
-      "head": "head",
-      "route": "route",
-      "middleware": "middleware"
-    };
-  }
-});
-
-// ../../packages/shared/tw/routing/index.ts
-var init_routing = __esm({
-  "../../packages/shared/tw/routing/index.ts"() {
-    init_constants2();
-  }
-});
-
-// ../../packages/shared/tw/types/common.ts
-var init_common = __esm({
-  "../../packages/shared/tw/types/common.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/types/errors.ts
-var init_errors = __esm({
-  "../../packages/shared/tw/types/errors.ts"() {
-  }
-});
-
-// ../../packages/shared/tw/types/results.ts
-var init_results = __esm({
-  "../../packages/shared/tw/types/results.ts"() {
+function collectParallelDefaults(node) {
+  const defaults = /* @__PURE__ */ new Map();
+  for (const child of node.children) {
+    if (child.kind === "parallel" && child.slotName) {
+      const defaultFile = child.files.find((f) => f.type === "default");
+      if (defaultFile) {
+        defaults.set(child.slotName, defaultFile);
+      }
+    }
   }
-});
-
-// ../../packages/shared/tw/types/index.ts
-var init_types = __esm({
-  "../../packages/shared/tw/types/index.ts"() {
-    init_common();
-    init_errors();
-    init_results();
+  return defaults;
+}
+function collectParallelPages(node, pathParts, index) {
+  const pages = /* @__PURE__ */ new Map();
+  for (const child of node.children) {
+    if (child.kind === "parallel" && child.slotName) {
+      const pageFile = child.files.find((f) => f.type === "page");
+      if (pageFile) {
+        pages.set(child.slotName, pageFile);
+      }
+      if (index < pathParts.length) {
+        for (const grandchild of child.children) {
+          if (grandchild.kind === "static" && grandchild.segment === pathParts[index]) {
+            const deepPage = grandchild.files.find((f) => f.type === "page");
+            if (deepPage) {
+              pages.set(child.slotName, deepPage);
+            }
+          }
+        }
+      }
+    }
   }
-});
-
-// ../../packages/shared/tw/utils/string/transform.ts
-var init_transform = __esm({
-  "../../packages/shared/tw/utils/string/transform.ts"() {
+  return pages;
+}
+function extractRenderMode(page) {
+  try {
+    const fs = require("node:fs");
+    const source = fs.readFileSync(page.absolutePath, "utf-8");
+    const m = source.match(/render\s+(static|ssr|island|edge)/);
+    if (m) {
+      return m[1];
+    }
+  } catch {
   }
-});
-
-// ../../packages/shared/tw/index.ts
-var init_tw2 = __esm({
-  "../../packages/shared/tw/index.ts"() {
-    init_sha();
-    init_utils();
-    init_config();
-    init_constants();
-    init_crypto();
-    init_env();
-    init_fs();
-    init_hashing();
-    init_logger2();
-    init_routing();
-    init_types();
-    init_transform();
+  return "ssr";
+}
+var init_layout_chain = __esm({
+  "../../packages/server/tw/routing/layout-chain.ts"() {
   }
 });
 
@@ -2416,7 +2593,7 @@ function readNestedBlocks(source, start, end) {
 }
 var init_blocks = __esm({
   "../../packages/compiler/tw/lexer/blocks.ts"() {
-    init_tw2();
+    init_tw();
   }
 });
 
@@ -7750,6 +7927,12 @@ function parsePageDirective(cursor, token) {
     if (!optToken) break;
     const optName = optToken.value;
     cursor.skipWhitespace();
+    if (optName === "cache" && cursor.peek() && cursor.peek().type === "LBRACE") {
+      cursor.advance();
+      options.cache = parseCacheBlockOptions(cursor, token);
+      cursor.skipWhitespace();
+      continue;
+    }
     const nextToken = cursor.peek();
     if (nextToken && (nextToken.type === "STRING" || nextToken.type === "NUMBER" || nextToken.type === "IDENT" || nextToken.type === "KEYWORD")) {
       cursor.advance();
@@ -7787,6 +7970,42 @@ function parsePageDirective(cursor, token) {
     col: token.pos.col
   };
 }
+function parseCacheBlockOptions(cursor, pageToken) {
+  const out = {};
+  cursor.skipWhitespace();
+  while (cursor.peek() && cursor.peek().type !== "RBRACE" && cursor.peek().type !== "EOF") {
+    const keyToken = cursor.advance();
+    if (!keyToken) break;
+    const key = keyToken.value;
+    cursor.skipWhitespace();
+    cursor.match("EQUALS") || cursor.match("COLON");
+    cursor.skipWhitespace();
+    const valToken = cursor.peek();
+    if (valToken && (valToken.type === "STRING" || valToken.type === "NUMBER")) {
+      cursor.advance();
+      out[key] = valToken.type === "NUMBER" ? parseFloat(valToken.value) : valToken.value;
+    } else if (valToken && (valToken.type === "IDENT" || valToken.type === "KEYWORD")) {
+      cursor.advance();
+      out[key] = valToken.value;
+    }
+    cursor.skipWhitespace();
+    cursor.match("COMMA");
+    cursor.skipWhitespace();
+  }
+  cursor.consumeIf("RBRACE");
+  if (out.revalidate == null && out.life == null) {
+    cursor.errors.add({
+      type: "error",
+      message: 'cache { } requires a `revalidate N` window or a `life "profile"` (docs/cache-tags.md)',
+      line: pageToken.pos.line,
+      col: pageToken.pos.col,
+      code: "TW090",
+      severity: "error",
+      category: "syntax"
+    });
+  }
+  return out;
+}
 function parseHeadDirective(cursor, token, parseBody) {
   let title;
   const meta = [];
@@ -8540,7 +8759,7 @@ function parseBlockBody(cursor, parseBody) {
 var DIRECTIVE_KEYWORDS, SIGNAL_FUNCTIONS;
 var init_directives = __esm({
   "../../packages/compiler/tw/parser/directives/index.ts"() {
-    init_tw2();
+    init_tw();
     DIRECTIVE_KEYWORDS = /* @__PURE__ */ new Set([
       "page",
       "head",
@@ -9861,7 +10080,7 @@ var init_statements = __esm({
     init_nodes();
     init_recovery();
     init_directives();
-    init_tw2();
+    init_tw();
     CLASS_BOUNDARY_BOOLEAN_ATTRS = /* @__PURE__ */ new Set([
       "disabled",
       "required",
@@ -11736,7 +11955,7 @@ var init_parser = __esm({
     init_recovery();
     init_statements();
     init_directives();
-    init_tw2();
+    init_tw();
     init_parser_recovery();
     init_precedence_table();
     init_props();
@@ -17665,7 +17884,7 @@ var init_types4 = __esm({
 var TW_VERSION, TW_GENERATOR_META;
 var init_version = __esm({
   "../../packages/compiler/tw/codegen/version.ts"() {
-    TW_VERSION = "1.0.5";
+    TW_VERSION = "1.0.6";
     TW_GENERATOR_META = `<meta name="generator" content="TW Framework ${TW_VERSION}">`;
   }
 });
@@ -17831,7 +18050,7 @@ function generateBuiltinTag(specifier, props, textContent) {
 var BUILTIN_COMPONENT_SPECIFIERS, imageConfig;
 var init_builtin_components = __esm({
   "../../packages/compiler/tw/codegen/builtin-components.ts"() {
-    init_tw();
+    init_tw2();
     init_tw3();
     BUILTIN_COMPONENT_SPECIFIERS = ["@tw/optImage", "@tw/RouterLink"];
     imageConfig = DEFAULT_IMAGE_CONFIG;
@@ -23871,7 +24090,12 @@ var init_codes = __esm({
       TW086: { message: "Deprecated state declaration syntax", severity: "warning", category: "deprecation" },
       TW087: { message: "Deprecated component lifecycle hook", severity: "warning", category: "deprecation" },
       TW088: { message: "Deprecated import path", severity: "warning", category: "deprecation" },
-      TW089: { message: "Deprecated render mode -- use 'interactive'", severity: "warning", category: "deprecation" }
+      TW089: { message: "Deprecated render mode -- use 'interactive'", severity: "warning", category: "deprecation" },
+      // Cache (docs/cache-tags.md)
+      TW090: { message: "cache { } requires a revalidate window or a life profile", severity: "error", category: "syntax" },
+      TW091: { message: "fn cached handler is impure (request.cookies/headers/body or setSignal)", severity: "error", category: "semantic" },
+      TW092: { message: "Unknown cache profile", severity: "error", category: "semantic" },
+      TW093: { message: "Non-deterministic call in a cached handler (value freezes into the cache entry)", severity: "warning", category: "best-practice" }
     };
   }
 });
@@ -24970,6 +25194,7 @@ var init_rules = __esm({
       "row",
       "rowgroup",
       "rowheader",
+      "table",
       "scrollbar",
       "search",
       "searchbox",
@@ -25001,6 +25226,10 @@ var init_rules = __esm({
       "aria-atomic",
       "aria-autocomplete",
       "aria-busy",
+      "aria-braillelabel",
+      "aria-brailleroledescription",
+      "aria-description",
+      "aria-details",
       "aria-checked",
       "aria-colcount",
       "aria-colindex",
@@ -28559,7 +28788,7 @@ var init_disk = __esm({
   "../../packages/compiler/tw/cache/disk.ts"() {
     import_node_fs3 = require("node:fs");
     import_node_path4 = require("node:path");
-    init_tw2();
+    init_tw();
     DiskCache = class {
       constructor(cacheDir) {
         this.cacheDir = cacheDir;
@@ -28627,7 +28856,7 @@ var init_disk = __esm({
 
 // ../../packages/compiler/tw/cache/cache.ts
 var UnifiedCache;
-var init_cache = __esm({
+var init_cache2 = __esm({
   "../../packages/compiler/tw/cache/cache.ts"() {
     init_memory();
     init_disk();
@@ -28692,14 +28921,14 @@ function makeConfigKey(config) {
 }
 var init_keys = __esm({
   "../../packages/compiler/tw/cache/keys.ts"() {
-    init_tw2();
+    init_tw();
   }
 });
 
 // ../../packages/compiler/tw/cache/index.ts
-var init_cache2 = __esm({
+var init_cache3 = __esm({
   "../../packages/compiler/tw/cache/index.ts"() {
-    init_cache();
+    init_cache2();
     init_disk();
     init_keys();
     init_memory();
@@ -29074,7 +29303,7 @@ function removeFile(graph, file) {
 }
 var init_incremental = __esm({
   "../../packages/compiler/tw/incremental/index.ts"() {
-    init_tw2();
+    init_tw();
   }
 });
 
@@ -34530,7 +34759,7 @@ var init_tw4 = __esm({
     init_server_components();
     init_suspense();
     init_ast();
-    init_cache2();
+    init_cache3();
     init_codegen();
     init_codegen();
     init_diagnostics();
@@ -34900,7 +35129,7 @@ var init_scanner = __esm({
   "../../packages/server/tw/routing/scanner.ts"() {
     import_node_fs5 = require("node:fs");
     import_node_path6 = require("node:path");
-    init_tw2();
+    init_tw();
   }
 });
 
@@ -34962,16 +35191,26 @@ var init_helpers = __esm({
 });
 
 // ../../packages/server/tw/routing/render-pipeline.ts
+function getCacheProfiles(rootDir) {
+  if (__profilesCache && __profilesCache.rootDir === rootDir) return __profilesCache.profiles;
+  let profiles = {};
+  try {
+    profiles = readCacheProfilesSync(rootDir);
+  } catch {
+  }
+  __profilesCache = { rootDir, profiles };
+  return profiles;
+}
 function createRenderPipeline(opts) {
   return new RenderPipeline(opts);
 }
-var import_node_fs6, import_node_path7, RenderPipeline;
+var import_node_fs6, import_node_path7, __profilesCache, RenderPipeline;
 var init_render_pipeline = __esm({
   "../../packages/server/tw/routing/render-pipeline.ts"() {
     import_node_fs6 = require("node:fs");
     import_node_path7 = require("node:path");
     init_tw4();
-    init_tw2();
+    init_tw();
     init_twm_loader();
     init_scanner();
     init_layout_chain();
@@ -34979,6 +35218,7 @@ var init_render_pipeline = __esm({
     init_tw6();
     init_twm_loader();
     init_tw6();
+    __profilesCache = null;
     RenderPipeline = class {
       rootDir;
       homeDir;
@@ -34989,6 +35229,17 @@ var init_render_pipeline = __esm({
       dev;
       routeTree = null;
       compiledCache = /* @__PURE__ */ new Map();
+      /**
+       * Render cache (docs/cache-tags.md). Entry fields:
+       *   expiresAt -- v1.0.5 compat: fresh-until timestamp (same as freshUntil)
+       *   freshUntil -- age < freshUntil -> HIT (zero work)
+       *   expireAt -- freshUntil <= age < expireAt -> STALE + background
+       *               refresh; age >= expireAt -> dropped (blocking MISS)
+       *   cache -- resolved cache config (null for plain TTL entries); its
+       *   `tag` is the single source of truth for revalidateTag() -- the tag
+       *   "index" is derived by scanning entries (<= 100), which is the
+       *   documented lazy rebuild (design 6.3).
+       */
       renderCache = /* @__PURE__ */ new Map();
       constructor(opts) {
         this.rootDir = opts.rootDir;
@@ -35035,15 +35286,18 @@ var init_render_pipeline = __esm({
         const cacheKey = sha256(`${pathname}:${JSON.stringify(stateVars ?? {})}:${this.navRequest ? "nav" : ""}`);
         if (this.enableCache) {
           const cached = this.renderCache.get(cacheKey);
-          if (cached && Date.now() < cached.expiresAt) {
+          const now = Date.now();
+          const freshUntil = cached ? cached.freshUntil ?? cached.expiresAt : 0;
+          const expireAt = cached ? cached.expireAt ?? freshUntil : 0;
+          if (cached && now < freshUntil) {
             return {
               ...cached.result,
               fromCache: true,
               durationMs: 0,
-              headers: { ...cached.result.headers, "x-tw-cache": "HIT" }
+              headers: this.stampCacheHeaders(cached.result.headers, cached, now, "HIT")
             };
           }
-          if (cached && cached.revalidate && !this.pendingRefresh.has(cacheKey)) {
+          if (cached && now < expireAt && cached.swr && !this.pendingRefresh.has(cacheKey)) {
             this.pendingRefresh.add(cacheKey);
             void Promise.resolve().then(() => {
               try {
@@ -35058,9 +35312,10 @@ var init_render_pipeline = __esm({
               fromCache: true,
               stale: true,
               durationMs: 0,
-              headers: { ...cached.result.headers, "x-tw-cache": "STALE" }
+              headers: this.stampCacheHeaders(cached.result.headers, cached, now, "STALE")
             };
           }
+          if (cached && now >= expireAt) this.renderCache.delete(cacheKey);
         }
         const tree = this.getRouteTree();
         if (!tree) {
@@ -35229,20 +35484,26 @@ ${bodyHTML}`;
             durationMs: performance.now() - startTime,
             renderMode: this.extractRenderMode(ctx.page)
           };
-          const pageRevalidate = this.extractRevalidate(ctx.page);
+          const pageCache = this.extractCacheConfig(ctx.page);
           if (this.enableCache) {
             if (this.renderCache.size >= 100) {
               const oldest = this.renderCache.keys().next().value;
               if (oldest) this.renderCache.delete(oldest);
             }
+            const freshMs = pageCache ? pageCache.revalidate * 1e3 : this.cacheTTL;
+            const expireMs = pageCache ? pageCache.expire * 1e3 : this.cacheTTL;
             this.renderCache.set(cacheKey, {
               result,
-              expiresAt: Date.now() + (pageRevalidate ? pageRevalidate * 1e3 : this.cacheTTL),
-              revalidate: pageRevalidate,
+              expiresAt: Date.now() + freshMs,
+              freshUntil: Date.now() + freshMs,
+              expireAt: Date.now() + expireMs,
+              swr: !!pageCache,
+              cache: pageCache,
+              createdAt: Date.now(),
               pathname
             });
           }
-          return { ...result, headers: { ...result.headers, "x-tw-cache": "MISS" } };
+          return { ...result, headers: this.stampCacheHeaders(result.headers, this.renderCache.get(cacheKey), Date.now(), "MISS") };
         } catch (err2) {
           const globalError = findGlobalError(tree);
           if (globalError) {
@@ -35413,6 +35674,45 @@ ${bodyHTML}`;
           return "static";
         }
       }
+      /**
+       * Cache tags (docs/cache-tags.md): expire every render-cache entry
+       * whose `cache { tag "..." }` family matches. The next request for those
+       * routes renders fresh (MISS). Entries are the single source of truth;
+       * scanning them is the derived tag index (rebuilt by construction).
+       * Returns the number of dropped entries.
+       */
+      revalidateTag(tag) {
+        let dropped = 0;
+        for (const [key, entry] of this.renderCache) {
+          const c = entry.cache;
+          if (c && c.tag === tag) {
+            this.renderCache.delete(key);
+            dropped++;
+          }
+        }
+        return dropped;
+      }
+      /**
+       * Cache headers on every cacheable response (docs/cache-tags.md):
+       *   x-tw-cache: HIT | STALE | MISS (existing contract, unchanged)
+       *   x-tw-cache-age: seconds since the entry was rendered (observation)
+       *   Cache-Control: public, max-age=<stale>, stale-while-revalidate=...
+       *     only when `stale > 0` -- the client-side hint. The server
+       *     render-cache never reads `stale`.
+       */
+      stampCacheHeaders(headers, entry, now, verdict) {
+        const out = { ...headers ?? {}, "x-tw-cache": verdict };
+        const c = entry?.cache;
+        if (c) {
+          const ageSec = entry?.createdAt ? Math.max(0, Math.floor((now - entry.createdAt) / 1e3)) : 0;
+          out["x-tw-cache-age"] = String(ageSec);
+          if (c.stale > 0) {
+            const swr = Number.isFinite(c.expire) ? ", stale-while-revalidate=" + Math.max(0, c.expire - c.stale) : "";
+            out["Cache-Control"] = "public, max-age=" + c.stale + swr;
+          }
+        }
+        return out;
+      }
       extractRevalidate(file) {
         try {
           const source = (0, import_node_fs6.readFileSync)(file.absolutePath, "utf-8");
@@ -35426,6 +35726,34 @@ ${bodyHTML}`;
           return null;
         }
       }
+      /**
+       * Cache config (docs/cache-tags.md): resolve a page's `cache { }`
+       * directive against tw.config.ts cache.profiles, falling back to the
+       * legacy `revalidate N` ISR form. The legacy form desugars to
+       * { revalidate: N, stale: 0, expire: Infinity } -- the exact v1.0.5
+       * behavior (fresh for N seconds, then stale-while-revalidate forever).
+       */
+      extractCacheConfig(file) {
+        try {
+          const source = (0, import_node_fs6.readFileSync)(file.absolutePath, "utf-8");
+          const meta = extractCacheDirective(source);
+          if (meta) {
+            try {
+              return resolveCache(meta, getCacheProfiles(this.rootDir));
+            } catch (e) {
+              console.error("[tw] " + e.message + " (" + file.absolutePath + ")");
+              return null;
+            }
+          }
+          const legacy = this.extractRevalidate(file);
+          if (legacy != null) {
+            return { revalidate: legacy, stale: 0, expire: Infinity };
+          }
+          return null;
+        } catch {
+          return null;
+        }
+      }
       /**
        * Metadata API (docs/metadata.md): description / keywords / og_title /
        * og_description / og_image in the page frontmatter become <meta> tags --
@@ -37161,8 +37489,8 @@ var init_static = __esm({
   "../../packages/server/tw/static/index.ts"() {
     import_node_fs8 = require("node:fs");
     import_node_path9 = require("node:path");
-    init_tw2();
-    init_tw2();
+    init_tw();
+    init_tw();
     StaticHandler = class {
       root;
       maxAge;
@@ -46119,7 +46447,7 @@ var import_node_fs9, import_node_crypto5, import_node_path10, import_node_fs10,
 var init_ssr = __esm({
   "../../packages/server/tw/ssr/index.ts"() {
     import_node_fs9 = require("node:fs");
-    init_tw2();
+    init_tw();
     import_node_crypto5 = require("node:crypto");
     import_node_path10 = require("node:path");
     import_node_fs10 = require("node:fs");
@@ -47136,7 +47464,7 @@ function applyRewrites(rewrites, pathname) {
 var import_node_path11, import_node_fs11, TWServer;
 var init_tw6 = __esm({
   "../../packages/server/tw/index.ts"() {
-    init_tw();
+    init_tw2();
     init_websocket_manager();
     init_routing2();
     import_node_path11 = require("node:path");
@@ -47162,7 +47490,9 @@ var init_tw6 = __esm({
       router;
       pipeline;
       staticHandler = null;
-      /** ISR routes (from .tw/routes.json): pathname -> revalidate seconds. */
+      /** ISR routes (from .tw/routes.json): pathname -> revalidate seconds
+       * (bare number, legacy) or { revalidate, stale, expire, tag } object
+       * (docs/cache-tags.md). Presence decides pipeline-vs-static routing. */
       isrRoutes = /* @__PURE__ */ new Map();
       securityHeaders = null;
       /**
@@ -47265,7 +47595,7 @@ var init_tw6 = __esm({
             if ((0, import_node_fs11.existsSync)(manifestPath)) {
               const manifest = JSON.parse((0, import_node_fs11.readFileSync)(manifestPath, "utf-8"));
               for (const [route, secs] of Object.entries(manifest)) {
-                this.isrRoutes.set(route, Number(secs));
+                this.isrRoutes.set(route, secs);
               }
               if (Object.keys(manifest).length > 0) {
                 console.log(`  ISR: ${Object.keys(manifest).length} revalidate route(s)`);
@@ -47881,11 +48211,84 @@ __export(twm_loader_exports, {
   executeRouteHandler: () => executeRouteHandler,
   loadTWMModule: () => loadTWMModule,
   revalidateRoute: () => revalidateRoute,
-  shouldMatchMiddleware: () => shouldMatchMiddleware
+  shouldMatchMiddleware: () => shouldMatchMiddleware,
+  stripCommentsSafe: () => stripCommentsSafe
 });
 function clearTWMCache() {
   moduleCache.clear();
 }
+function stripCommentsSafe(src) {
+  let out = "";
+  let i = 0;
+  let mode = "code";
+  while (i < src.length) {
+    const c = src[i];
+    const n = i + 1 < src.length ? src[i + 1] : "";
+    if (mode === "code") {
+      if (c === "/" && n === "/") {
+        mode = "line";
+        i += 2;
+        continue;
+      }
+      if (c === "/" && n === "*") {
+        mode = "block";
+        i += 2;
+        continue;
+      }
+      if (c === "'") {
+        mode = "sq";
+        out += c;
+        i++;
+        continue;
+      }
+      if (c === '"') {
+        mode = "dq";
+        out += c;
+        i++;
+        continue;
+      }
+      if (c === "`") {
+        mode = "tpl";
+        out += c;
+        i++;
+        continue;
+      }
+      out += c;
+      i++;
+      continue;
+    }
+    if (mode === "line") {
+      if (c === "\n") {
+        mode = "code";
+        out += c;
+      }
+      i++;
+      continue;
+    }
+    if (mode === "block") {
+      if (c === "*" && n === "/") {
+        mode = "code";
+        out += " ";
+        i += 2;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    out += c;
+    if (c === "\\") {
+      if (n) {
+        out += n;
+        i += 2;
+        continue;
+      }
+    } else if (mode === "sq" && c === "'" || mode === "dq" && c === '"' || mode === "tpl" && c === "`") {
+      mode = "code";
+    }
+    i++;
+  }
+  return out;
+}
 async function loadLibModule(rootDir, name) {
   let rel = name.replace(/^@\//, "").replace(/^\.\//, "").replace(/^lib\//, "");
   const cacheKey = rootDir + "/" + rel;
@@ -47904,13 +48307,13 @@ async function loadLibModule(rootDir, name) {
   }
 }
 function compileTwm(source) {
-  const cleaned = source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*/gm, "");
+  const cleaned = stripCommentsSafe(source);
   const importRegex = /import\s+\{([^}]+)\}\s+from\s+["']([^"']+)["'];?/g;
   const codeWithoutImports = cleaned.replace(importRegex, "");
-  return codeWithoutImports.replace(/\bexport\s+(?=(async\s+)?(function|const|let|var|class))/g, "").replace(/\bfn\s+delete\b/g, "async function deleteFn").replace(/\bfn\s+/g, "async function ");
+  return codeWithoutImports.replace(/\bexport\s+(?=(async\s+)?(function|const|let|var|class))/g, "").replace(/^[ \t]*cache\s*\{[^}]*\}[ \t]*;?[ \t]*$/gm, "").replace(/\bfn\s+cached\s+delete\b/g, "async function deleteFn").replace(/\bfn\s+cached\s+/g, "async function ").replace(/\bfn\s+delete\b/g, "async function deleteFn").replace(/\bfn\s+/g, "async function ");
 }
 function extractImports(source) {
-  const cleaned = source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*/gm, "");
+  const cleaned = stripCommentsSafe(source);
   const importRegex = /import\s+\{([^}]+)\}\s+from\s+["']([^"']+)["'];?/g;
   const imports = [];
   let match;
@@ -47957,6 +48360,7 @@ async function loadTWMModule(filePath, rootDir) {
       for (const name of imp.names) {
         if (name === "revalidatePath") injected.revalidatePath = revalidatePath;
         else if (name === "revalidateRoute") injected.revalidateRoute = revalidateRoute;
+        else if (name === "revalidateTag") injected.revalidateTag = revalidateTag;
         else if (name === "setSignal") injected.setSignal = setSignal;
       }
       try {
@@ -48015,6 +48419,41 @@ async function loadTWMModule(filePath, rootDir) {
   const actionNames = /* @__PURE__ */ new Set();
   for (const m of codeWithoutImports.matchAll(/\bfunction\s+(action[A-Za-z0-9_]*)\s*\(/g)) actionNames.add(m[1]);
   for (const m of codeWithoutImports.matchAll(/\b(?:const|let|var)\s+(action[A-Za-z0-9_]*)\s*=/g)) actionNames.add(m[1]);
+  const cachedHandlers = {};
+  const cleanedSource = stripCommentsSafe(source);
+  const fnCachedRegex = /\bfn\s+cached\s+([A-Za-z0-9_]+)\s*\(([^)]*)\)\s*\{/g;
+  for (const cm of cleanedSource.matchAll(fnCachedRegex)) {
+    const fnName = cm[1] === "delete" ? "deleteFn" : cm[1];
+    const after = cleanedSource.slice((cm.index ?? 0) + cm[0].length);
+    const bodyEnd = handlerBodyEnd(after);
+    const body = after.slice(0, bodyEnd);
+    const cacheBlock = /^\s*cache\s*\{([^}]*)\}/.exec(after);
+    const meta = cacheBlock ? parseCacheBody(cacheBlock[1]) : {};
+    if (meta.revalidate == null && !meta.life) {
+      console.error("[tw] TW090: fn cached " + cm[1] + " in " + filePath + ' needs cache { revalidate N } or cache { life "profile" } -- not cached');
+      continue;
+    }
+    let impure = null;
+    for (const [pattern, label] of IMPURE_PATTERNS) {
+      if (pattern.test(body)) {
+        impure = label;
+        break;
+      }
+    }
+    if (impure) {
+      console.error("[tw] TW091: fn cached " + cm[1] + " in " + filePath + " is impure (" + impure + ") -- handler excluded from caching");
+      continue;
+    }
+    if (NONDET_PATTERN.test(body)) {
+      console.warn("[tw] TW093: fn cached " + cm[1] + " in " + filePath + " calls a non-deterministic function -- the value freezes into the cache entry");
+    }
+    try {
+      const resolved = resolveCache(meta, twmCacheProfiles(rd));
+      if (resolved) cachedHandlers[fnName] = resolved;
+    } catch (e) {
+      console.error("[tw] " + e.message + " (" + filePath + ":" + cm[1] + ")");
+    }
+  }
   const moduleCode = codeWithoutImports + "\nreturn { get: typeof get !== 'undefined' ? get : null, post: typeof post !== 'undefined' ? post : null, put: typeof put !== 'undefined' ? put : null, patch: typeof patch !== 'undefined' ? patch : null, deleteFn: typeof deleteFn !== 'undefined' ? deleteFn : null, GET: typeof GET !== 'undefined' ? GET : null, POST: typeof POST !== 'undefined' ? POST : null, PUT: typeof PUT !== 'undefined' ? PUT : null, PATCH: typeof PATCH !== 'undefined' ? PATCH : null, DELETE: typeof DELETE !== 'undefined' ? DELETE : null, middleware: typeof middleware !== 'undefined' ? middleware : null, generate: typeof generate !== 'undefined' ? generate : null, config: typeof config !== 'undefined' ? config : null, action: typeof action !== 'undefined' ? action : null, revalidate: typeof revalidate !== 'undefined' ? revalidate : null, " + [...actionNames].map((n) => `${n}: typeof ${n} !== 'undefined' ? ${n} : null`).join(", ") + " };";
   const injectedKeys = Object.keys(injected);
   let module2 = {};
@@ -48040,6 +48479,7 @@ async function loadTWMModule(filePath, rootDir) {
   } catch (err2) {
     console.error("[twm-loader] Error parsing " + filePath + ":", err2);
   }
+  module2.__twCached = cachedHandlers;
   moduleCache.set(cacheKey, module2);
   return module2;
 }
@@ -48074,6 +48514,39 @@ function sameOriginAllowed(req) {
 }
 function clearRouteCache() {
   routeCache.clear();
+  handlerCache.clear();
+}
+function handlerBodyEnd(after) {
+  let depth = 1;
+  let inStr = null;
+  for (let i = 0; i < after.length; i++) {
+    const ch = after[i];
+    if (inStr) {
+      if (ch === "\\") i++;
+      else if (ch === inStr) inStr = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      inStr = ch;
+      continue;
+    }
+    if (ch === "{") depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0) return i;
+    }
+  }
+  return after.length;
+}
+function twmCacheProfiles(rootDir) {
+  if (__twmProfiles.has(rootDir)) return __twmProfiles.get(rootDir);
+  let profiles = {};
+  try {
+    profiles = readCacheProfilesSync(rootDir);
+  } catch {
+  }
+  __twmProfiles.set(rootDir, profiles);
+  return profiles;
 }
 function revalidateRoute(pathname, opts) {
   const want = pathname.startsWith("/") ? pathname : "/" + pathname;
@@ -48177,12 +48650,17 @@ async function executeRouteHandler(filePath, method, request, rootDir) {
     if (!actionResult || typeof actionResult !== "object") {
       return { status: 500, json: { ok: false, error: "Internal Server Error" } };
     }
+    let revalidatedTag;
+    if (typeof actionResult.revalidateTag === "string" && actionResult.revalidateTag) {
+      revalidatedTag = actionResult.revalidateTag;
+      revalidateTag(revalidatedTag);
+    }
     return {
       status: typeof actionResult.status === "number" ? actionResult.status : 200,
       json: actionResult.json || actionResult.body || {},
       html: typeof actionResult.html === "string" ? actionResult.html : void 0,
       text: typeof actionResult.text === "string" ? actionResult.text : void 0,
-      headers: actionResult.headers
+      headers: revalidatedTag ? { ...actionResult.headers ?? {}, "x-tw-revalidated": revalidatedTag } : actionResult.headers
     };
   }
   const rv = mod.revalidate;
@@ -48203,6 +48681,57 @@ async function executeRouteHandler(filePath, method, request, rootDir) {
       };
     }
   }
+  const upperMethod = method.toUpperCase();
+  let handlerConf = null;
+  let handlerCacheKey = null;
+  if ((upperMethod === "GET" || upperMethod === "HEAD") && mod.__twCached) {
+    const handlerKey = methodLower === "delete" ? "deleteFn" : methodLower === "head" ? "get" : methodLower.toLowerCase();
+    handlerConf = mod.__twCached[handlerKey] ?? null;
+    if (handlerConf) {
+      try {
+        const u = new URL(request.url ?? "http://local");
+        handlerCacheKey = sha256(
+          upperMethod + "\n" + u.pathname + "\n" + canonicalizeQuery(u.search) + "\n" + JSON.stringify(request?.params ?? {})
+        );
+      } catch {
+        handlerCacheKey = null;
+      }
+    }
+    if (handlerCacheKey) {
+      const hEntry = handlerCache.get(handlerCacheKey);
+      const hNow = Date.now();
+      if (hEntry && hNow < hEntry.freshUntil) {
+        return {
+          ...hEntry.result,
+          headers: {
+            ...hEntry.result.headers ?? {},
+            "x-tw-cache": "HIT",
+            "x-tw-cache-age": String(Math.max(0, Math.floor((hNow - hEntry.createdAt) / 1e3)))
+          }
+        };
+      }
+      if (hEntry && hNow < hEntry.expireAt && !pendingHandlerRefresh.has(handlerCacheKey)) {
+        pendingHandlerRefresh.add(handlerCacheKey);
+        void (async () => {
+          try {
+            await executeRouteHandler(filePath, method, request, rootDir);
+          } catch {
+          } finally {
+            pendingHandlerRefresh.delete(handlerCacheKey);
+          }
+        })();
+        return {
+          ...hEntry.result,
+          headers: {
+            ...hEntry.result.headers ?? {},
+            "x-tw-cache": "STALE",
+            "x-tw-cache-age": String(Math.max(0, Math.floor((hNow - hEntry.createdAt) / 1e3)))
+          }
+        };
+      }
+      if (hEntry && hNow >= hEntry.expireAt) handlerCache.delete(handlerCacheKey);
+    }
+  }
   let result;
   try {
     result = await handler(req);
@@ -48230,6 +48759,33 @@ async function executeRouteHandler(filePath, method, request, rootDir) {
     }
     routeCache.set(routeCacheKey, { result: finalResult, expiresAt: Date.now() + rv * 1e3, pathname: cachedPath });
   }
+  if (handlerCacheKey && handlerConf && finalResult.status === 200) {
+    const now = Date.now();
+    let cachedPath = "";
+    try {
+      cachedPath = new URL(request.url ?? "http://local").pathname;
+    } catch {
+      cachedPath = "";
+    }
+    handlerCache.set(handlerCacheKey, {
+      result: finalResult,
+      freshUntil: now + handlerConf.revalidate * 1e3,
+      expireAt: now + handlerConf.expire * 1e3,
+      conf: handlerConf,
+      createdAt: now,
+      pathname: cachedPath
+    });
+    const cc = handlerConf.stale > 0 ? "public, max-age=" + handlerConf.stale + (Number.isFinite(handlerConf.expire) ? ", stale-while-revalidate=" + Math.max(0, handlerConf.expire - handlerConf.stale) : "") : null;
+    return {
+      ...finalResult,
+      headers: {
+        ...finalResult.headers ?? {},
+        "x-tw-cache": "MISS",
+        "x-tw-cache-age": "0",
+        ...cc ? { "Cache-Control": cc } : {}
+      }
+    };
+  }
   return finalResult;
 }
 async function executeMiddleware(filePath, request, rootDir) {
@@ -48268,7 +48824,7 @@ function shouldMatchMiddleware(matchers, pathname) {
   }
   return false;
 }
-var import_node_fs12, import_node_path12, moduleCache, libCache, routeCache;
+var import_node_fs12, import_node_path12, moduleCache, libCache, routeCache, IMPURE_PATTERNS, NONDET_PATTERN, __twmProfiles, handlerCache, pendingHandlerRefresh;
 var init_twm_loader = __esm({
   "../../packages/server/tw/routing/twm-loader.ts"() {
     import_node_fs12 = require("node:fs");
@@ -48276,9 +48832,30 @@ var init_twm_loader = __esm({
     init_signal_stream();
     import_node_path12 = require("node:path");
     init_twm_rules();
+    init_tw();
     moduleCache = /* @__PURE__ */ new Map();
     libCache = /* @__PURE__ */ new Map();
     routeCache = /* @__PURE__ */ new Map();
+    IMPURE_PATTERNS = [
+      [/request\s*\.\s*cookies/, "request.cookies"],
+      [/request\s*\.\s*headers/, "request.headers"],
+      [/request\s*\.\s*body/, "request.body"],
+      [/\bsetSignal\s*\(/, "setSignal(...)"]
+    ];
+    NONDET_PATTERN = /\b(?:Date\s*\.\s*now\s*\(|Math\s*\.\s*random\s*\(|crypto\s*\.\s*randomUUID\s*\()/;
+    __twmProfiles = /* @__PURE__ */ new Map();
+    handlerCache = /* @__PURE__ */ new Map();
+    pendingHandlerRefresh = /* @__PURE__ */ new Set();
+    registerTwmTagInvalidator(function(tag) {
+      let dropped = 0;
+      for (const [key, entry] of handlerCache) {
+        if (entry.conf && entry.conf.tag === tag) {
+          handlerCache.delete(key);
+          dropped++;
+        }
+      }
+      return dropped;
+    });
   }
 });