@absolutejs/absolute 0.19.0-beta.1036 → 0.19.0-beta.1037

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-TIyEAN/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-TIyEAN/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-TIyEAN/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/cli/index.js

@@ -171986,9 +171986,288 @@ var init_mem = __esm(() => {
   HEADERS = ["NAME", "SOURCE", "PORT", "RSS", "% SYS"];
 });
 
+// src/cli/scripts/env.ts
+var exports_env = {};
+__export(exports_env, {
+  scanEnvUsage: () => scanEnvUsage,
+  runEnv: () => runEnv,
+  collectEnvVars: () => collectEnvVars
+});
+import { existsSync as existsSync12, readFileSync as readFileSync14 } from "fs";
+import { join as join13 } from "path";
+var {env: env3, Glob: Glob3 } = globalThis.Bun;
+var EXTENSIONS = "ts,tsx,js,jsx,mjs,cjs,svelte,vue", STATUS_WIDTH, keysInFile = (text) => [...text.matchAll(/getEnv\(\s*['"]([^'"]+)['"]\s*\)/g)].map((match) => match[1]).filter((key) => key !== undefined), scanPatterns = () => existsSync12(join13(process.cwd(), "src")) ? [`src/**/*.{${EXTENSIONS}}`] : [`*.{${EXTENSIONS}}`], scanEnvUsage = async () => {
+  const scans = scanPatterns().map((pattern) => Array.fromAsync(new Glob3(pattern).scan({ cwd: process.cwd() })));
+  const files = (await Promise.all(scans)).flat();
+  const usage = new Map;
+  files.forEach((file) => {
+    keysInFile(readFileSync14(file, "utf-8")).forEach((key) => {
+      usage.set(key, [...usage.get(key) ?? [], file]);
+    });
+  });
+  return usage;
+}, isSet = (key) => typeof env3[key] === "string" && env3[key] !== "", collectEnvVars = async () => {
+  const usage = await scanEnvUsage();
+  return [...usage.keys()].sort().map((key) => ({
+    files: usage.get(key) ?? [],
+    key,
+    set: isSet(key)
+  }));
+}, printTable = (vars) => {
+  const keyWidth = Math.max(...vars.map((entry) => entry.key.length));
+  const lines = vars.map((entry) => {
+    const mark = entry.set ? `${colors.green}\u2713${colors.reset}` : `${colors.red}\u2717${colors.reset}`;
+    const status2 = entry.set ? "set" : `${colors.red}missing${colors.reset}`;
+    const count = `${colors.dim}${entry.files.length} file${entry.files.length === 1 ? "" : "s"}${colors.reset}`;
+    return `  ${mark} ${padLine(entry.key, keyWidth)}${" ".repeat(LIST_TUI_COLUMN_GAP)}${padLine(status2, STATUS_WIDTH)}${" ".repeat(LIST_TUI_COLUMN_GAP)}${count}`;
+  });
+  process.stdout.write(`${lines.join(`
+`)}
+`);
+}, runEnv = async (args) => {
+  const vars = await collectEnvVars();
+  if (vars.length === 0) {
+    process.stdout.write(`${colors.dim}No getEnv() usage found under src/.${colors.reset}
+`);
+    return;
+  }
+  const missing = vars.filter((entry) => !entry.set);
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify({ missing, vars }, null, 2)}
+`);
+    return;
+  }
+  printTable(vars);
+  const summary = missing.length === 0 ? `${colors.green}all ${vars.length} set${colors.reset}` : `${colors.red}${missing.length} missing${colors.reset}`;
+  process.stdout.write(`
+${colors.dim}${vars.length} referenced \xB7 ${colors.reset}${summary}
+`);
+  if (args.includes("--check") && missing.length > 0) {
+    process.exitCode = 1;
+  }
+};
+var init_env = __esm(() => {
+  init_constants();
+  init_tuiPrimitives();
+  STATUS_WIDTH = "missing".length;
+});
+
+// src/cli/scripts/logs.ts
+var exports_logs = {};
+__export(exports_logs, {
+  runLogs: () => runLogs
+});
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync13,
+  openSync as openSync4,
+  readSync as readSync2,
+  statSync as statSync2,
+  watchFile
+} from "fs";
+var DEFAULT_LINES = 40, POLL_MS = 250, LINES_FLAG_SPAN = 2, readFrom = (path, start2, length) => {
+  if (length <= 0)
+    return "";
+  const descriptor = openSync4(path, "r");
+  try {
+    const buffer = Buffer.alloc(length);
+    readSync2(descriptor, buffer, 0, length, start2);
+    return buffer.toString("utf-8");
+  } finally {
+    closeSync2(descriptor);
+  }
+}, tailLines = (path, maxLines) => {
+  const { size } = statSync2(path);
+  const start2 = Math.max(0, size - LIST_LOG_TAIL_MAX_BYTES);
+  const lines = readFrom(path, start2, size - start2).split(`
+`);
+  return lines.slice(Math.max(0, lines.length - maxLines)).join(`
+`);
+}, parseLines = (args) => {
+  const index = args.findIndex((arg) => arg === "-n" || arg === "--lines");
+  if (index === UNFOUND_INDEX)
+    return DEFAULT_LINES;
+  const value = Number(args[index + 1]);
+  return Number.isInteger(value) && value > 0 ? value : DEFAULT_LINES;
+}, targetName = (args) => {
+  const index = args.findIndex((arg) => arg === "-n" || arg === "--lines");
+  const cleaned = index === UNFOUND_INDEX ? args : [...args.slice(0, index), ...args.slice(index + LINES_FLAG_SPAN)];
+  return cleaned.find((arg) => !arg.startsWith("-"));
+}, followFile = (path) => {
+  let offset = statSync2(path).size;
+  watchFile(path, { interval: POLL_MS }, (current) => {
+    if (current.size > offset) {
+      process.stdout.write(readFrom(path, offset, current.size - offset));
+    }
+    offset = current.size;
+  });
+}, printDim2 = (message) => {
+  process.stdout.write(`${colors.dim}${message}${colors.reset}
+`);
+}, printAvailable = (instances) => {
+  const named = instances.filter((instance) => instance.logFile !== null);
+  if (named.length === 0) {
+    printDim2("No running servers have a captured log.");
+    return;
+  }
+  printDim2("Servers with logs:");
+  named.forEach((instance) => printDim2(`  ${instance.name}`));
+}, runLogs = async (args) => {
+  const instances = await enrichInstances(await discoverInstances());
+  const name = targetName(args);
+  if (name === undefined) {
+    printDim2("Usage: absolute logs <name> [-f] [-n <lines>]");
+    printAvailable(instances);
+    return;
+  }
+  const match = instances.find((instance) => instance.name === name);
+  if (!match) {
+    printDim2(`No running server named "${name}".`);
+    printAvailable(instances);
+    return;
+  }
+  if (match.logFile === null || !existsSync13(match.logFile)) {
+    printDim2(`"${name}" has no captured log (untracked, or started outside the CLI).`);
+    return;
+  }
+  process.stdout.write(`${tailLines(match.logFile, parseLines(args))}
+`);
+  if (args.includes("-f") || args.includes("--follow")) {
+    printDim2(`\u2014 following ${match.name} \xB7 ctrl+c to stop \u2014`);
+    followFile(match.logFile);
+  }
+};
+var init_logs = __esm(() => {
+  init_constants();
+  init_discoverInstances();
+  init_instanceStatus();
+  init_tuiPrimitives();
+});
+
+// src/cli/scripts/doctor.ts
+var exports_doctor = {};
+__export(exports_doctor, {
+  runDoctor: () => runDoctor
+});
+import { existsSync as existsSync14 } from "fs";
+import { createRequire } from "module";
+import { arch as arch4, platform as platform5 } from "os";
+import { join as join14 } from "path";
+var FRAMEWORK_FIELDS2, projectRequire, check = (status2, label, detail) => ({
+  detail,
+  label,
+  status: status2
+}), readString = (source, key) => {
+  const value = Reflect.get(source, key);
+  return typeof value === "string" ? value : undefined;
+}, resolveVersion = (specifier) => {
+  try {
+    const pkg = projectRequire(`${specifier}/package.json`);
+    const version2 = pkg && typeof pkg === "object" ? Reflect.get(pkg, "version") : null;
+    return typeof version2 === "string" ? version2 : null;
+  } catch {
+    return null;
+  }
+}, checkBun = () => check("ok", "Bun runtime", `v${Bun.version}`), checkAbsolute = () => {
+  const version2 = resolveVersion("@absolutejs/absolute");
+  return version2 === null ? check("fail", "@absolutejs/absolute", "not resolvable here") : check("ok", "@absolutejs/absolute", `v${version2}`);
+}, checkNative = () => {
+  const target = `@absolutejs/native-${platform5()}-${arch4()}`;
+  const version2 = resolveVersion(target);
+  return version2 === null ? check("warn", "Native binary", `${target} not installed`) : check("ok", "Native binary", `v${version2}`);
+}, loadConfigOrNull = async () => {
+  try {
+    return await loadRawConfig();
+  } catch {
+    return null;
+  }
+}, frameworkChecks = (config) => FRAMEWORK_FIELDS2.flatMap((field) => {
+  const dir = readString(config, field);
+  if (dir === undefined)
+    return [];
+  const label = `${field.replace("Directory", "")} pages`;
+  return [
+    existsSync14(join14(process.cwd(), dir)) ? check("ok", label, dir) : check("fail", label, `${dir} (missing)`)
+  ];
+}), envCheck = async () => {
+  const vars = await collectEnvVars();
+  const missing = vars.filter((entry) => !entry.set);
+  if (vars.length === 0)
+    return check("ok", "Env vars", "no getEnv() usage");
+  if (missing.length === 0) {
+    return check("ok", "Env vars", `all ${vars.length} set`);
+  }
+  return check("fail", "Env vars", `missing ${missing.map((entry) => entry.key).join(", ")}`);
+}, devPort = (config) => {
+  const dev2 = Reflect.get(config, "dev");
+  const port = dev2 && typeof dev2 === "object" ? Reflect.get(dev2, "port") : undefined;
+  return typeof port === "number" ? port : DEFAULT_PORT;
+}, portCheck = async (config) => {
+  const port = devPort(config);
+  const holder = (await scanListeners()).find((listener) => listener.port === port);
+  return holder ? check("warn", "Dev port", `${port} in use by pid ${holder.pid}`) : check("ok", "Dev port", `${port} free`);
+}, STATUS_MARK, renderCheck = (entry, labelWidth) => `  ${STATUS_MARK[entry.status]} ${entry.label.padEnd(labelWidth)}  ${colors.dim}${entry.detail}${colors.reset}`, printReport2 = (checks) => {
+  const labelWidth = Math.max(...checks.map((entry) => entry.label.length));
+  const failed = checks.filter((entry) => entry.status === "fail").length;
+  const warned = checks.filter((entry) => entry.status === "warn").length;
+  const summary = failed > 0 ? `${colors.red}${failed} failed${colors.reset}` : `${colors.green}all good${colors.reset}`;
+  const lines = checks.map((entry) => renderCheck(entry, labelWidth));
+  process.stdout.write(`${lines.join(`
+`)}
+
+${colors.dim}${checks.length} checks \xB7 ${colors.reset}${summary}${colors.dim} \xB7 ${warned} warning${warned === 1 ? "" : "s"}${colors.reset}
+`);
+}, runDoctor = async (args) => {
+  const config = await loadConfigOrNull();
+  const configCheck = config === null ? check("fail", "Config", "absolute.config.ts not found or invalid") : check("ok", "Config", "absolute.config.ts loaded");
+  const [env4, port] = await Promise.all([
+    envCheck(),
+    config === null ? check("warn", "Dev port", "skipped (no config)") : portCheck(config)
+  ]);
+  const checks = [
+    checkBun(),
+    checkAbsolute(),
+    checkNative(),
+    configCheck,
+    ...config === null ? [] : frameworkChecks(config),
+    env4,
+    port
+  ];
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify(checks, null, 2)}
+`);
+  } else {
+    printReport2(checks);
+  }
+  if (checks.some((entry) => entry.status === "fail")) {
+    process.exitCode = 1;
+  }
+};
+var init_doctor = __esm(() => {
+  init_constants();
+  init_loadConfig();
+  init_portScan();
+  init_tuiPrimitives();
+  init_env();
+  FRAMEWORK_FIELDS2 = [
+    "reactDirectory",
+    "vueDirectory",
+    "svelteDirectory",
+    "angularDirectory",
+    "htmlDirectory",
+    "htmxDirectory"
+  ];
+  projectRequire = createRequire(join14(process.cwd(), "package.json"));
+  STATUS_MARK = {
+    fail: `${colors.red}\u2717${colors.reset}`,
+    ok: `${colors.green}\u2713${colors.reset}`,
+    warn: `${colors.yellow}\u26A0${colors.reset}`
+  };
+});
+
 // src/build/externalAssetPlugin.ts
-import { copyFileSync as copyFileSync2, existsSync as existsSync12, mkdirSync as mkdirSync7, statSync as statSync2 } from "fs";
-import { basename as basename6, dirname as dirname4, join as join13, resolve as resolve11 } from "path";
+import { copyFileSync as copyFileSync2, existsSync as existsSync15, mkdirSync as mkdirSync7, statSync as statSync3 } from "fs";
+import { basename as basename6, dirname as dirname4, join as join15, resolve as resolve11 } from "path";
 var createExternalAssetPlugin = (outDir, userSourceRoots = []) => ({
   name: "absolute-external-asset",
   setup(bld) {
@@ -172009,12 +172288,12 @@ var createExternalAssetPlugin = (outDir, userSourceRoots = []) => ({
         if (!relPath)
           continue;
         const assetPath = resolve11(sourceDir, relPath);
-        if (!existsSync12(assetPath))
+        if (!existsSync15(assetPath))
           continue;
-        if (!statSync2(assetPath).isFile())
+        if (!statSync3(assetPath).isFile())
           continue;
-        const targetPath = join13(outDir, basename6(assetPath));
-        if (existsSync12(targetPath))
+        const targetPath = join15(outDir, basename6(assetPath));
+        if (existsSync15(targetPath))
           continue;
         mkdirSync7(dirname4(targetPath), { recursive: true });
         copyFileSync2(assetPath, targetPath);
@@ -172031,19 +172310,19 @@ __export(exports_compile, {
   shouldEmbedCompiledAsset: () => shouldEmbedCompiledAsset,
   compile: () => compile
 });
-var {env: env3 } = globalThis.Bun;
+var {env: env4 } = globalThis.Bun;
 import {
   cpSync,
-  existsSync as existsSync13,
+  existsSync as existsSync16,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   rmSync as rmSync5,
-  statSync as statSync3,
+  statSync as statSync4,
   unlinkSync as unlinkSync4,
   writeFileSync as writeFileSync6
 } from "fs";
-import { basename as basename7, dirname as dirname5, join as join14, relative as relative3, resolve as resolve12 } from "path";
+import { basename as basename7, dirname as dirname5, join as join16, relative as relative3, resolve as resolve12 } from "path";
 var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`, compileBanner = (version2) => {
   const resolvedVersion = version2 || "unknown";
   console.log("");
@@ -172056,7 +172335,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     const entry = pending.pop();
     if (!entry)
       continue;
-    const fullPath = join14(entry.parentPath, entry.name);
+    const fullPath = join16(entry.parentPath, entry.name);
     if (entry.isDirectory())
       pending = pending.concat(readdirSync3(fullPath, { withFileTypes: true }));
     else
@@ -172076,7 +172355,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     const entry = pending.pop();
     if (!entry)
       continue;
-    const fullPath = join14(entry.parentPath, entry.name);
+    const fullPath = join16(entry.parentPath, entry.name);
     if (entry.isDirectory()) {
       if (SERVER_RUNTIME_SCAN_SKIP_DIRS.has(entry.name))
         continue;
@@ -172091,7 +172370,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const normalizedOutdir = resolve12(outdir);
   const copyReference = (filePath, relPath) => {
     const assetSource = resolve12(dirname5(filePath), relPath);
-    if (!existsSync13(assetSource) || !statSync3(assetSource).isFile())
+    if (!existsSync16(assetSource) || !statSync4(assetSource).isFile())
       return;
     const assetTarget = resolve12(normalizedOutdir, relPath.replace(/^\.\//, ""));
     if (assetTarget !== normalizedOutdir && !assetTarget.startsWith(`${normalizedOutdir}/`))
@@ -172103,7 +172382,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     cpSync(assetSource, assetTarget, { force: true });
   };
   for (const filePath of collectProjectSourceFiles(process.cwd())) {
-    const source = readFileSync14(filePath, "utf-8");
+    const source = readFileSync15(filePath, "utf-8");
     SERVER_RUNTIME_ASSET_RE.lastIndex = 0;
     let match;
     while ((match = SERVER_RUNTIME_ASSET_RE.exec(source)) !== null) {
@@ -172132,7 +172411,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   }
 }, readPackageVersion4 = (candidate) => {
   try {
-    const pkg = JSON.parse(readFileSync14(candidate, "utf-8"));
+    const pkg = JSON.parse(readFileSync15(candidate, "utf-8"));
     if (pkg.name !== "@absolutejs/absolute")
       return null;
     const ver = pkg.version;
@@ -172175,7 +172454,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     resolve12(import.meta.dir, "..", "..", "..", "src", "react", "jsxDevRuntimeCompat.ts")
   ];
   for (const candidate of candidates) {
-    if (existsSync13(candidate))
+    if (existsSync16(candidate))
       return candidate;
   }
   return resolve12(import.meta.dir, "..", "..", "react", "jsxDevRuntimeCompat.js");
@@ -172191,7 +172470,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   return true;
 }, tryReadNodePackageJson = (packageDir) => {
   try {
-    return JSON.parse(readFileSync14(join14(packageDir, "package.json"), "utf-8"));
+    return JSON.parse(readFileSync15(join16(packageDir, "package.json"), "utf-8"));
   } catch {
     return null;
   }
@@ -172203,7 +172482,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   if (!pkg)
     return;
   seen.add(specifier);
-  const destDir = join14(outdir, "node_modules", ...specifier.split("/"));
+  const destDir = join16(outdir, "node_modules", ...specifier.split("/"));
   rmSync5(destDir, { force: true, recursive: true });
   cpSync(srcDir, destDir, {
     force: true,
@@ -172226,7 +172505,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   if (!buildConfig.angularDirectory)
     return;
   const angularScopeDir = resolve12(process.cwd(), "node_modules", "@angular");
-  const angularPackages = existsSync13(angularScopeDir) ? readdirSync3(angularScopeDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "compiler-cli").map((entry) => `@angular/${entry.name}`) : [];
+  const angularPackages = existsSync16(angularScopeDir) ? readdirSync3(angularScopeDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "compiler-cli").map((entry) => `@angular/${entry.name}`) : [];
   const roots = new Set([...angularPackages, "rxjs", "tslib", "typescript"]);
   const seen = new Set;
   for (const specifier of roots) {
@@ -172243,15 +172522,15 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   }
   copyAngularRuntimePackages(buildConfig, outdir);
 }, collectRuntimePackageSpecifiers = (distDir) => {
-  const nodeModulesDir = join14(distDir, "node_modules");
-  if (!existsSync13(nodeModulesDir))
+  const nodeModulesDir = join16(distDir, "node_modules");
+  if (!existsSync16(nodeModulesDir))
     return [];
   const specifiers = [];
   for (const entry of readdirSync3(nodeModulesDir, { withFileTypes: true })) {
     if (!entry.isDirectory())
       continue;
     if (entry.name.startsWith("@")) {
-      const scopeDir = join14(nodeModulesDir, entry.name);
+      const scopeDir = join16(nodeModulesDir, entry.name);
       for (const scopedEntry of readdirSync3(scopeDir, {
         withFileTypes: true
       })) {
@@ -172283,21 +172562,21 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const packageSpecifier = packageSpecifiers.find((root) => specifier === root || specifier.startsWith(`${root}/`));
   if (!packageSpecifier)
     return null;
-  const packageDir = join14(distDir, "node_modules", ...packageSpecifier.split("/"));
+  const packageDir = join16(distDir, "node_modules", ...packageSpecifier.split("/"));
   const subpath = specifier.slice(packageSpecifier.length);
-  const subPackageDir = subpath ? join14(packageDir, ...subpath.slice(1).split("/")) : null;
-  const resolvedPackageDir = subPackageDir && existsSync13(join14(subPackageDir, "package.json")) ? subPackageDir : packageDir;
-  const packageJsonPath = join14(resolvedPackageDir, "package.json");
-  if (!existsSync13(packageJsonPath))
+  const subPackageDir = subpath ? join16(packageDir, ...subpath.slice(1).split("/")) : null;
+  const resolvedPackageDir = subPackageDir && existsSync16(join16(subPackageDir, "package.json")) ? subPackageDir : packageDir;
+  const packageJsonPath = join16(resolvedPackageDir, "package.json");
+  if (!existsSync16(packageJsonPath))
     return null;
-  const pkg = JSON.parse(readFileSync14(packageJsonPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync15(packageJsonPath, "utf-8"));
   const exportKey = resolvedPackageDir !== subPackageDir && subpath ? `.${subpath}` : ".";
   const rootExport = pkg.exports?.[exportKey];
   const entry = pickExportEntry(rootExport) ?? (resolvedPackageDir === subPackageDir || !subpath ? pkg.module ?? pkg.main ?? "index.js" : `.${subpath}`);
-  return join14(resolvedPackageDir, entry);
+  return join16(resolvedPackageDir, entry);
 }, RUNTIME_JS_EXTENSIONS, MODULE_SPECIFIER_RE, isRuntimeJsFile = (filePath) => RUNTIME_JS_EXTENSIONS.some((extension) => filePath.endsWith(extension)), isNodeModulesPath = (filePath) => filePath.split(/[\\/]/).includes("node_modules"), isFile = (filePath) => {
   try {
-    return statSync3(filePath).isFile();
+    return statSync4(filePath).isFile();
   } catch {
     return false;
   }
@@ -172307,13 +172586,13 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const candidates = [
     candidate,
     ...RUNTIME_JS_EXTENSIONS.map((extension) => `${candidate}${extension}`),
-    ...RUNTIME_JS_EXTENSIONS.map((extension) => join14(candidate, `index${extension}`))
+    ...RUNTIME_JS_EXTENSIONS.map((extension) => join16(candidate, `index${extension}`))
   ];
   return candidates.find((filePath) => isRuntimeJsFile(filePath) && isFile(filePath)) ?? null;
 }, findContainingRuntimePackageDir = (filePath) => {
   let dir = dirname5(filePath);
   while (dir !== dirname5(dir)) {
-    if (isNodeModulesPath(dir) && existsSync13(join14(dir, "package.json"))) {
+    if (isNodeModulesPath(dir) && existsSync16(join16(dir, "package.json"))) {
       return dir;
     }
     dir = dirname5(dir);
@@ -172329,7 +172608,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const entry = pickExportEntry(pkg?.imports?.[specifier]);
   if (!entry)
     return null;
-  return join14(packageDir, entry);
+  return join16(packageDir, entry);
 }, collectRuntimeRewriteRoots = (distDir) => collectFiles2(distDir).filter((filePath) => isRuntimeJsFile(filePath) && !isNodeModulesPath(filePath)), rewriteRuntimeModuleSpecifiers = (distDir) => {
   const packageSpecifiers = collectRuntimePackageSpecifiers(distDir);
   if (packageSpecifiers.length === 0)
@@ -172348,7 +172627,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     if (!filePath || seen.has(filePath))
       continue;
     seen.add(filePath);
-    const source = readFileSync14(filePath, "utf-8");
+    const source = readFileSync15(filePath, "utf-8");
     const rewritten = source.replace(MODULE_SPECIFIER_RE, (match, prefix, quote, specifier) => {
       if (typeof specifier === "string" && specifier.startsWith(".")) {
         enqueue(resolveRuntimeJsFile(resolve12(dirname5(filePath), specifier)));
@@ -172821,7 +173100,7 @@ console.log(\`
   const resolvedOutdir = resolve12(outdir ?? "dist");
   await withBuildDirectoryLock(resolvedOutdir, () => compileUnlocked(serverEntry, resolvedOutdir, outfile, configPath2));
 }, compileUnlocked = async (serverEntry, resolvedOutdir, outfile, configPath2) => {
-  const prerenderPort = Number(env3.COMPILE_PORT) || Number(env3.PORT) || DEFAULT_PORT + 1;
+  const prerenderPort = Number(env4.COMPILE_PORT) || Number(env4.PORT) || DEFAULT_PORT + 1;
   killStaleProcesses(prerenderPort);
   const entryName = basename7(serverEntry).replace(/\.[^.]+$/, "");
   const resolvedOutfile = resolve12(outfile ?? "compiled-server");
@@ -172886,11 +173165,11 @@ console.log(\`
     process.exit(1);
   }
   const outputPath = resolve12(resolvedOutdir, `${entryName}.js`);
-  if (!existsSync13(outputPath)) {
+  if (!existsSync16(outputPath)) {
     console.error(cliTag4("\x1B[31m", `Expected output not found: ${outputPath}`));
     process.exit(1);
   }
-  if (existsSync13(resolve12(resolvedOutdir, "angular", "vendor", "server"))) {
+  if (existsSync16(resolve12(resolvedOutdir, "angular", "vendor", "server"))) {
     const vendorDir = resolve12(resolvedOutdir, "angular", "vendor", "server");
     const vendorEntries = readdirSync3(vendorDir).filter((f) => f.endsWith(".js"));
     const angularServerVendorPaths = {};
@@ -172912,7 +173191,7 @@ console.log(\`
   copyServerRuntimeAssetReferences(resolvedOutdir);
   const prerenderStart = performance.now();
   process.stdout.write(cliTag4("\x1B[36m", "Pre-rendering pages"));
-  rmSync5(join14(resolvedOutdir, "_prerendered"), {
+  rmSync5(join16(resolvedOutdir, "_prerendered"), {
     force: true,
     recursive: true
   });
@@ -172931,7 +173210,7 @@ console.log(\`
   const compileStart = performance.now();
   process.stdout.write(cliTag4("\x1B[36m", "Compiling standalone executable"));
   const entrypointCode = generateEntrypoint(resolvedOutdir, serverEntry, prerenderMap, absoluteVersion, buildConfig);
-  const entrypointPath = join14(resolvedOutdir, "_compile_entrypoint.ts");
+  const entrypointPath = join16(resolvedOutdir, "_compile_entrypoint.ts");
   await Bun.write(entrypointPath, entrypointCode);
   mkdirSync8(dirname5(resolvedOutfile), { recursive: true });
   const result = await Bun.build({
@@ -173027,11 +173306,11 @@ var exports_typecheck = {};
 __export(exports_typecheck, {
   typecheck: () => typecheck
 });
-import { resolve as resolve13, join as join15 } from "path";
-import { existsSync as existsSync14, readFileSync as readFileSync15 } from "fs";
+import { resolve as resolve13, join as join17 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync16 } from "fs";
 import { mkdir as mkdir2, writeFile } from "fs/promises";
 var isCommandService3 = (service) => service.kind === "command" || Array.isArray(service.command), resolveConfigPath = (configPath2) => resolve13(configPath2 ?? process.env.ABSOLUTE_CONFIG ?? "absolute.config.ts"), getTypecheckTargets = async (configPath2) => {
-  if (!existsSync14(resolveConfigPath(configPath2))) {
+  if (!existsSync17(resolveConfigPath(configPath2))) {
     return [{}];
   }
   const rawConfig = await loadRawConfig(configPath2);
@@ -173052,7 +173331,7 @@ var isCommandService3 = (service) => service.kind === "command" || Array.isArray
   return { exitCode, name, output: (stdout + stderr).trim() };
 }, shellEscape = (value) => `'${value.replaceAll("'", "'\\''")}'`, runShell = async (name, command) => run(name, ["/bin/bash", "-lc", command]), findBin = (name) => {
   const local = resolve13("node_modules", ".bin", name);
-  return existsSync14(local) ? local : null;
+  return existsSync17(local) ? local : null;
 }, ANSI_COLOR_REGEX, ANSI_PURPLE_REGEX, ANSI_CYAN_REGEX, ANSI_TOKEN_END_REGEX, stripAnsi3 = (str) => str.replace(ANSI_COLOR_REGEX, ""), formatSvelteOutput = (output) => {
   const cwd = `${process.cwd()}/`;
   const summaryMatch = stripAnsi3(output).match(/svelte-check found (\d+) error/);
@@ -173104,10 +173383,10 @@ Found ${errorCount} error${suffix}.`;
     resolve13(import.meta.dir, "../../types", fileName),
     resolve13(import.meta.dir, "../../../types", fileName)
   ];
-  return candidates.find((candidate) => existsSync14(candidate)) ?? candidates[0];
+  return candidates.find((candidate) => existsSync17(candidate)) ?? candidates[0];
 }, ABSOLUTE_TYPECHECK_FILES, readProjectTsconfig = () => {
   try {
-    return JSON.parse(readFileSync15(resolve13("tsconfig.json"), "utf-8"));
+    return JSON.parse(readFileSync16(resolve13("tsconfig.json"), "utf-8"));
   } catch {
     return {};
   }
@@ -173135,7 +173414,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m vue-tsc is required for Vue type checking. Install it: bun add -d vue-tsc");
     process.exit(1);
   }
-  const vueTsconfigPath = join15(cacheDir, "tsconfig.vue-check.json");
+  const vueTsconfigPath = join17(cacheDir, "tsconfig.vue-check.json");
   return writeFile(vueTsconfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
@@ -173150,7 +173429,7 @@ Found ${errorCount} error${suffix}.`;
     resolve13(vueTsconfigPath),
     "--incremental",
     "--tsBuildInfoFile",
-    join15(cacheDir, "vue-tsc.tsbuildinfo"),
+    join17(cacheDir, "vue-tsc.tsbuildinfo"),
     "--pretty"
   ]));
 }, buildAngularCheck = async (cacheDir, angularDir) => {
@@ -173159,7 +173438,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m @angular/compiler-cli is required for Angular type checking. Install it: bun add -d @angular/compiler-cli");
     process.exit(1);
   }
-  const angularTsconfigPath = join15(cacheDir, "tsconfig.angular-check.json");
+  const angularTsconfigPath = join17(cacheDir, "tsconfig.angular-check.json");
   await writeFile(angularTsconfigPath, JSON.stringify({
     angularCompilerOptions: {
       strictTemplates: true
@@ -173179,7 +173458,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m typescript is required for type checking. Install it: bun add -d typescript");
     process.exit(1);
   }
-  const tscConfigPath = join15(cacheDir, "tsconfig.typecheck.json");
+  const tscConfigPath = join17(cacheDir, "tsconfig.typecheck.json");
   return writeFile(tscConfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
@@ -173194,7 +173473,7 @@ Found ${errorCount} error${suffix}.`;
     resolve13(tscConfigPath),
     "--incremental",
     "--tsBuildInfoFile",
-    join15(cacheDir, "tsc.tsbuildinfo"),
+    join17(cacheDir, "tsc.tsbuildinfo"),
     "--pretty"
   ]));
 }, buildSvelteCheck = async (cacheDir, svelteDir) => {
@@ -173203,7 +173482,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m svelte-check is required for Svelte type checking. Install it: bun add -d svelte-check");
     process.exit(1);
   }
-  const svelteTsconfigPath = join15(cacheDir, "tsconfig.svelte-check.json");
+  const svelteTsconfigPath = join17(cacheDir, "tsconfig.svelte-check.json");
   await writeFile(svelteTsconfigPath, JSON.stringify({
     extends: resolve13("tsconfig.json"),
     files: ABSOLUTE_TYPECHECK_FILES,
@@ -176910,6 +177189,18 @@ if (command === "dev") {
   sendTelemetryEvent("cli:command", { command: "mem" });
   const { runMem: runMem2 } = await Promise.resolve().then(() => (init_mem(), exports_mem));
   await runMem2(args);
+} else if (command === "env") {
+  sendTelemetryEvent("cli:command", { command: "env" });
+  const { runEnv: runEnv2 } = await Promise.resolve().then(() => (init_env(), exports_env));
+  await runEnv2(args);
+} else if (command === "logs") {
+  sendTelemetryEvent("cli:command", { command: "logs" });
+  const { runLogs: runLogs2 } = await Promise.resolve().then(() => (init_logs(), exports_logs));
+  await runLogs2(args);
+} else if (command === "doctor") {
+  sendTelemetryEvent("cli:command", { command: "doctor" });
+  const { runDoctor: runDoctor2 } = await Promise.resolve().then(() => (init_doctor(), exports_doctor));
+  await runDoctor2(args);
 } else if (command === "info") {
   sendTelemetryEvent("cli:command", { command });
   info();
@@ -176949,8 +177240,11 @@ if (command === "dev") {
   console.error("  start [entry] [--outdir dir] Start production server");
   console.error("  compile [entry] [--outdir dir] [--outfile path] Compile standalone executable");
   console.error("  config [--port n] Open the unified config UI (ESLint, tsconfig, Prettier)");
+  console.error("  doctor [--json] Diagnose the project (bun, config, framework dirs, env, port)");
+  console.error("  env [--check] [--json] Report env vars the app reads (getEnv) and which are missing");
   console.error("  eslint        Run ESLint (cached)");
   console.error("  info          Print system info for bug reports");
+  console.error("  logs <name> [-f] [-n <lines>] Tail a running server's log by name");
   console.error("  ls [--sizes] [--json] List the project's pages by framework (from source)");
   console.error("  mem [--json]  Memory report (RSS) for running servers, plus system usage");
   console.error("  ps [--watch] [--json] [--kill <pid|port>] [--kill-all] List/manage running servers");

package/dist/src/cli/scripts/doctor.d.ts

@@ -0,0 +1 @@
+export declare const runDoctor: (args: string[]) => Promise<void>;

package/dist/src/cli/scripts/env.d.ts

@@ -0,0 +1,7 @@
+export declare const scanEnvUsage: () => Promise<Map<string, string[]>>;
+export declare const collectEnvVars: () => Promise<{
+    files: string[];
+    key: string;
+    set: boolean;
+}[]>;
+export declare const runEnv: (args: string[]) => Promise<void>;

package/dist/src/cli/scripts/logs.d.ts

@@ -0,0 +1 @@
+export declare const runLogs: (args: string[]) => Promise<void>;

package/package.json

@@ -411,7 +411,7 @@
 			]
 		}
 	},
-	"version": "0.19.0-beta.1036",
+	"version": "0.19.0-beta.1037",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"