@apex-stack/core 0.1.11 → 0.1.13

package/dist/{chunk-2L2T47AH.js → chunk-7E5ZQ6UH.js}

@@ -1,6 +1,15 @@
 // src/ui.ts
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
 var TTY = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.TERM !== "dumb";
 var RESET = "\x1B[0m";
+var VERSION = (() => {
+  try {
+    return JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8")).version || "";
+  } catch {
+    return "";
+  }
+})();
 function truecolor(r, g, b, s) {
   return TTY ? `\x1B[38;2;${r};${g};${b}m${s}${RESET}` : s;
 }
@@ -40,9 +49,10 @@ function banner(subtitle = "The full-stack, AI-native meta-framework for Alpine.
     }
     return out + RESET;
   });
+  const ver = VERSION ? `${color.cyan(`v${VERSION}`)}  ${color.gray("\xB7")}  ` : "";
   return `
 ${rows.join("\n")}
-  ${color.gray(subtitle)}
+  ${ver}${color.gray(subtitle)}
 `;
 }
 var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -86,6 +96,7 @@ function ready(rows) {
 }
 
 export {
+  VERSION,
   color,
   banner,
   spinner,

package/dist/chunk-SH3XEJGV.js

@@ -0,0 +1,239 @@
+import {
+  loadComponents
+} from "./chunk-4VG3CZ6H.js";
+import {
+  createApiHandler,
+  createMcpHandler,
+  loadApiRoutes
+} from "./chunk-DSUIB3JH.js";
+import {
+  matchRoute,
+  renderIslandsPage,
+  renderPage,
+  scanPages
+} from "./chunk-PAMD24NK.js";
+
+// src/dev/server.ts
+import { createServer as createHttpServer } from "http";
+import { createRequire } from "module";
+import { join } from "path";
+import { fileURLToPath } from "url";
+import { apex } from "@apex-stack/vite";
+import {
+  createApp,
+  defineEventHandler,
+  fromNodeMiddleware,
+  setResponseHeader,
+  setResponseStatus,
+  toNodeListener
+} from "h3";
+import { createServer as createViteServer } from "vite";
+
+// src/dev/errorPage.ts
+import { existsSync, readFileSync } from "fs";
+function esc(s) {
+  return s.replace(/[&<>"]/g, (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : c === ">" ? "&gt;" : "&quot;");
+}
+function firstFileFrame(stack, root) {
+  const re = /(?:file:\/\/\/?)?((?:[A-Za-z]:[\\/]|\/)[^\s():]+):(\d+):(\d+)/g;
+  let m;
+  const frames = [];
+  while (m = re.exec(stack)) {
+    let file = m[1];
+    if (/^[A-Za-z]:[\\/]/.test(file) === false && !file.startsWith("/")) continue;
+    file = file.replace(/\//g, process.platform === "win32" ? "\\" : "/");
+    if (existsSync(file) && !file.includes("node_modules")) {
+      frames.push({ file, line: Number(m[2]), col: Number(m[3]) });
+    }
+  }
+  return frames.find((f) => f.file.startsWith(root)) ?? frames[0];
+}
+function codeFrame(frame) {
+  let lines;
+  try {
+    lines = readFileSync(frame.file, "utf8").split("\n");
+  } catch {
+    return "";
+  }
+  const start = Math.max(0, frame.line - 4);
+  const end = Math.min(lines.length, frame.line + 3);
+  const rows = [];
+  for (let i = start; i < end; i++) {
+    const n = i + 1;
+    const active = n === frame.line;
+    const num = String(n).padStart(4, " ");
+    rows.push(
+      `<div class="cf-row${active ? " active" : ""}"><span class="cf-num">${num}</span><span class="cf-code">${esc(lines[i] || "")}</span></div>`
+    );
+  }
+  return `<div class="frame"><div class="frame-file">${esc(frame.file)}<span class="frame-pos">:${frame.line}:${frame.col}</span></div><pre class="cf">${rows.join("")}</pre></div>`;
+}
+var SHELL_CSS = `
+:root{color-scheme:dark light}
+*{box-sizing:border-box}
+body{margin:0;min-height:100vh;background:#0a0e1a;color:#f4f7ff;
+  font:15px/1.6 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;
+  display:flex;align-items:flex-start;justify-content:center;padding:clamp(1.5rem,6vh,5rem) 1.25rem}
+@media(prefers-color-scheme:light){body{background:#f4f7ff;color:#0a0e1a}}
+.wrap{width:100%;max-width:860px}
+.brand{display:flex;align-items:center;gap:.55rem;font-weight:600;letter-spacing:-.01em;margin-bottom:1.6rem}
+.mark{width:20px;height:20px}
+.pill{font-size:.8rem;font-weight:600;padding:.15rem .6rem;border-radius:999px;margin-left:.4rem}
+.pill.err{color:#fb7185;background:rgba(244,63,94,.12);border:1px solid rgba(244,63,94,.35)}
+.pill.nf{color:#818cf8;background:rgba(129,140,248,.12);border:1px solid rgba(129,140,248,.35)}
+.kind{font:600 .95rem/1 ui-monospace,SFMono-Regular,Menlo,monospace;color:#fb7185;margin:0 0 .5rem}
+.kind.nf{color:#818cf8}
+h1{font-size:clamp(1.4rem,3.2vw,2rem);line-height:1.2;letter-spacing:-.02em;margin:0 0 .7rem;word-break:break-word}
+.sub{color:#9aa6c4;margin:0 0 1.8rem}
+.sub code{background:rgba(130,140,200,.14);border-radius:.35rem;padding:.05rem .35rem;font-size:.9em}
+.frame{border:1px solid rgba(130,140,200,.18);border-radius:12px;overflow:hidden;margin:0 0 1.4rem;background:#11172b}
+@media(prefers-color-scheme:light){.frame{background:#fff}}
+.frame-file{font:.8rem/1 ui-monospace,SFMono-Regular,Menlo,monospace;color:#9aa6c4;padding:.7rem .9rem;border-bottom:1px solid rgba(130,140,200,.18);overflow-x:auto;white-space:nowrap}
+.frame-pos{color:#fb7185}
+.cf{margin:0;padding:.6rem 0;overflow-x:auto;font:.82rem/1.7 ui-monospace,SFMono-Regular,Menlo,monospace}
+.cf-row{display:flex;padding:0 .9rem;white-space:pre}
+.cf-row.active{background:rgba(244,63,94,.12);box-shadow:inset 3px 0 0 #f43f5e}
+.cf-num{color:#5b6890;-webkit-user-select:none;user-select:none;padding-right:1.1rem;text-align:right}
+.cf-row.active .cf-num{color:#fb7185}
+.cf-code{color:#f4f7ff}
+@media(prefers-color-scheme:light){.cf-code{color:#0a0e1a}}
+details{border:1px solid rgba(130,140,200,.18);border-radius:12px;background:#11172b;overflow:hidden}
+@media(prefers-color-scheme:light){details{background:#fff}}
+summary{cursor:pointer;padding:.7rem .9rem;font-size:.85rem;color:#9aa6c4;user-select:none}
+summary:hover{color:#f4f7ff}
+@media(prefers-color-scheme:light){summary:hover{color:#0a0e1a}}
+.stack{margin:0;padding:0 .9rem 1rem;font:.78rem/1.7 ui-monospace,SFMono-Regular,Menlo,monospace;color:#9aa6c4;overflow-x:auto;white-space:pre-wrap;word-break:break-word}
+.routes{list-style:none;padding:0;margin:0 0 1.4rem;display:flex;flex-wrap:wrap;gap:.5rem}
+.routes li{font:.85rem/1 ui-monospace,SFMono-Regular,Menlo,monospace;color:#818cf8;background:rgba(129,140,248,.1);border:1px solid rgba(129,140,248,.25);border-radius:.45rem;padding:.35rem .6rem}
+.foot{margin-top:1.8rem;color:#5b6890;font-size:.82rem}
+`;
+var MARK = `<svg class="mark" viewBox="0 0 64 64" aria-hidden="true"><defs><linearGradient id="g" x1="0" y1="1" x2="1" y2="0"><stop offset="0" stop-color="#22d3ee"/><stop offset="1" stop-color="#6366f1"/></linearGradient></defs><path d="M32 7 L32 35 L20 56 L4 56 Z" fill="url(#g)"/><path d="M32 7 L60 56 L44 56 L32 35 Z" fill="#6366f1"/></svg>`;
+function page(title, bodyInner) {
+  return `<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>${esc(title)}</title><style>${SHELL_CSS}</style></head><body><div class="wrap">${bodyInner}</div></body></html>`;
+}
+function renderErrorPage(error, opts) {
+  const kind = error.name || "Error";
+  const message = error.message || String(error);
+  const stack = error.stack || "";
+  const frame = stack ? firstFileFrame(stack, opts.root) : void 0;
+  const frameHtml = frame ? codeFrame(frame) : "";
+  const body = `
+    <div class="brand">${MARK} Apex JS <span class="pill err">Dev error</span></div>
+    <p class="kind">${esc(kind)}</p>
+    <h1>${esc(message)}</h1>
+    <p class="sub">While rendering <code>${esc(opts.url)}</code></p>
+    ${frameHtml}
+    <details${frameHtml ? "" : " open"}><summary>Stack trace</summary><pre class="stack">${esc(stack)}</pre></details>
+    <p class="foot">Fix the error and save \u2014 this page reloads automatically.</p>`;
+  return page(`${kind} \u2014 Apex JS`, body);
+}
+function renderNotFoundPage(url, routes) {
+  const list = routes.length ? routes.map((r) => `<li>${esc(r.pattern)}</li>`).join("") : "<li>no pages yet \u2014 add pages/index.alpine</li>";
+  const body = `
+    <div class="brand">${MARK} Apex JS <span class="pill nf">404</span></div>
+    <p class="kind nf">404 \u2014 Not found</p>
+    <h1>No route matches <code>${esc(url)}</code></h1>
+    <p class="sub">These routes are available:</p>
+    <ul class="routes">${list}</ul>
+    <p class="foot">Add a file under <code>pages/</code> to create a new route.</p>`;
+  return page("404 \u2014 Apex JS", body);
+}
+
+// src/dev/server.ts
+async function startDevServer(options) {
+  const port = options.port ?? 3e3;
+  const pageId = options.pageId ?? "/pages/index.alpine";
+  const req = createRequire(import.meta.url);
+  const tryResolve = (spec) => {
+    try {
+      return req.resolve(spec);
+    } catch {
+      return void 0;
+    }
+  };
+  const alpine = tryResolve("alpinejs");
+  const kit = tryResolve("@apex-stack/kit");
+  const coreClient = fileURLToPath(new URL("./client.js", import.meta.url));
+  const alias = { "@apex-stack/core/client": coreClient };
+  if (alpine) alias.alpinejs = alpine;
+  if (kit) alias["@apex-stack/kit"] = kit;
+  const vite = await createViteServer({
+    root: options.root,
+    appType: "custom",
+    // Derive the HMR port from the dev port so multiple `apex dev` instances
+    // don't all fight over Vite's default 24678.
+    server: { middlewareMode: true, fs: { strict: false }, hmr: { port: port + 1 } },
+    resolve: { alias },
+    // User apps depend on `@apex-stack/core`, so the client module imports the runtime
+    // from `@apex-stack/core/client` (a re-export) rather than the internal kit package.
+    plugins: [apex({ clientRuntime: "@apex-stack/core/client" })],
+    optimizeDeps: { include: ["alpinejs"] }
+  });
+  const ssrLoad = (id) => {
+    const resolved = id[0] === "/" && !id.startsWith(options.root) ? join(options.root, id).replace(/\\/g, "/") : id;
+    return vite.ssrLoadModule(resolved);
+  };
+  const app = createApp();
+  app.use(fromNodeMiddleware(vite.middlewares));
+  const loadEntries = () => loadApiRoutes(options.root, (id) => ssrLoad(id));
+  app.use("/api", defineEventHandler((event) => loadEntries().then((e) => createApiHandler(e)(event))));
+  app.use("/mcp", defineEventHandler((event) => loadEntries().then((e) => createMcpHandler(e)(event))));
+  app.use(
+    defineEventHandler(async (event) => {
+      const url = event.path || "/";
+      try {
+        const routes = scanPages(options.root);
+        const matched = routes.length ? matchRoute(routes, url) : { pageId, params: {} };
+        if (!matched) {
+          setResponseStatus(event, 404);
+          setResponseHeader(event, "Content-Type", "text/html");
+          return await vite.transformIndexHtml(url, renderNotFoundPage(url, routes));
+        }
+        const { registry, css: componentCss } = await loadComponents(
+          options.root,
+          (id) => ssrLoad(id)
+        );
+        const render = options.islands ? renderIslandsPage : renderPage;
+        const html = await render({
+          loadModule: (id) => ssrLoad(id),
+          pageId: matched.pageId,
+          params: matched.params,
+          url,
+          registry,
+          componentCss,
+          transformHtml: (u, doc) => vite.transformIndexHtml(u, doc)
+        });
+        setResponseHeader(event, "Content-Type", "text/html");
+        return html;
+      } catch (err) {
+        const error = err;
+        vite.ssrFixStacktrace(error);
+        setResponseStatus(event, 500);
+        setResponseHeader(event, "Content-Type", "text/html");
+        const html = renderErrorPage(error, { url, root: options.root });
+        try {
+          return await vite.transformIndexHtml(url, html);
+        } catch {
+          return html;
+        }
+      }
+    })
+  );
+  const server = createHttpServer(toNodeListener(app));
+  await new Promise((resolve) => server.listen(port, resolve));
+  return {
+    vite,
+    server,
+    port,
+    close: async () => {
+      await vite.close();
+      await new Promise(
+        (resolve, reject) => server.close((e) => e ? reject(e) : resolve())
+      );
+    }
+  };
+}
+
+export {
+  startDevServer
+};

package/dist/cli.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import {
+  VERSION,
   banner,
   color,
   spinner
-} from "./chunk-2L2T47AH.js";
+} from "./chunk-7E5ZQ6UH.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand2, runMain } from "citty";
@@ -103,11 +104,12 @@ var COMMANDS = [
 var main = defineCommand2({
   meta: {
     name: "apex",
+    version: VERSION,
     description: "The full-stack meta-framework for Alpine.js"
   },
   subCommands: {
     new: newCommand,
-    dev: () => import("./dev-HDRJEPPN.js").then((m) => m.devCommand),
+    dev: () => import("./dev-BIPK7O5N.js").then((m) => m.devCommand),
     build: () => import("./build-QRHQUUZC.js").then((m) => m.buildCommand),
     start: () => import("./start-VJJXI4W3.js").then((m) => m.startCommand),
     make: () => import("./make-4LINTKZH.js").then((m) => m.makeCommand),

package/dist/{dev-HDRJEPPN.js → dev-BIPK7O5N.js}

@@ -2,7 +2,7 @@ import {
   banner,
   ready,
   spinner
-} from "./chunk-2L2T47AH.js";
+} from "./chunk-7E5ZQ6UH.js";
 
 // src/commands/dev.ts
 import { resolve } from "path";
@@ -20,7 +20,7 @@ var devCommand = defineCommand({
     process.stdout.write(banner());
     const sp = spinner(`Starting dev server${args.islands ? " (islands mode)" : ""}\u2026`);
     try {
-      const { startDevServer } = await import("./server-VOIXBL4I.js");
+      const { startDevServer } = await import("./server-ODH3M2IG.js");
       const { port: actual } = await startDevServer({ root, port, islands: Boolean(args.islands) });
       sp.succeed("Dev server ready");
       ready([

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   startDevServer
-} from "./chunk-QZTDKUXK.js";
+} from "./chunk-SH3XEJGV.js";
 import "./chunk-4VG3CZ6H.js";
 import {
   isApexResource

package/dist/{server-VOIXBL4I.js → server-ODH3M2IG.js}

@@ -1,6 +1,6 @@
 import {
   startDevServer
-} from "./chunk-QZTDKUXK.js";
+} from "./chunk-SH3XEJGV.js";
 import "./chunk-4VG3CZ6H.js";
 import "./chunk-DSUIB3JH.js";
 import "./chunk-PAMD24NK.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apex-stack/core",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "The full-stack meta-framework for Alpine.js — CLI and runtime",
   "type": "module",
   "license": "MIT",

package/dist/chunk-QZTDKUXK.js

@@ -1,127 +0,0 @@
-import {
-  loadComponents
-} from "./chunk-4VG3CZ6H.js";
-import {
-  createApiHandler,
-  createMcpHandler,
-  loadApiRoutes
-} from "./chunk-DSUIB3JH.js";
-import {
-  matchRoute,
-  renderIslandsPage,
-  renderPage,
-  scanPages
-} from "./chunk-PAMD24NK.js";
-
-// src/dev/server.ts
-import { createServer as createHttpServer } from "http";
-import { createRequire } from "module";
-import { fileURLToPath } from "url";
-import { apex } from "@apex-stack/vite";
-import {
-  createApp,
-  defineEventHandler,
-  fromNodeMiddleware,
-  setResponseHeader,
-  setResponseStatus,
-  toNodeListener
-} from "h3";
-import { createServer as createViteServer } from "vite";
-async function startDevServer(options) {
-  const port = options.port ?? 3e3;
-  const pageId = options.pageId ?? "/pages/index.alpine";
-  const req = createRequire(import.meta.url);
-  const tryResolve = (spec) => {
-    try {
-      return req.resolve(spec);
-    } catch {
-      return void 0;
-    }
-  };
-  const alpine = tryResolve("alpinejs");
-  const kit = tryResolve("@apex-stack/kit");
-  const coreClient = fileURLToPath(new URL("./client.js", import.meta.url));
-  const alias = { "@apex-stack/core/client": coreClient };
-  if (alpine) alias.alpinejs = alpine;
-  if (kit) alias["@apex-stack/kit"] = kit;
-  const vite = await createViteServer({
-    root: options.root,
-    appType: "custom",
-    server: { middlewareMode: true, fs: { strict: false } },
-    resolve: { alias },
-    // User apps depend on `@apex-stack/core`, so the client module imports the runtime
-    // from `@apex-stack/core/client` (a re-export) rather than the internal kit package.
-    plugins: [apex({ clientRuntime: "@apex-stack/core/client" })],
-    optimizeDeps: { include: ["alpinejs"] }
-  });
-  const app = createApp();
-  app.use(fromNodeMiddleware(vite.middlewares));
-  const loadEntries = () => loadApiRoutes(options.root, (id) => vite.ssrLoadModule(id));
-  app.use("/api", defineEventHandler((event) => loadEntries().then((e) => createApiHandler(e)(event))));
-  app.use("/mcp", defineEventHandler((event) => loadEntries().then((e) => createMcpHandler(e)(event))));
-  app.use(
-    defineEventHandler(async (event) => {
-      const url = event.path || "/";
-      try {
-        const routes = scanPages(options.root);
-        const matched = routes.length ? matchRoute(routes, url) : { pageId, params: {} };
-        if (!matched) {
-          setResponseStatus(event, 404);
-          setResponseHeader(event, "Content-Type", "text/html");
-          return notFoundPage(url, routes);
-        }
-        const { registry, css: componentCss } = await loadComponents(
-          options.root,
-          (id) => vite.ssrLoadModule(id)
-        );
-        const render = options.islands ? renderIslandsPage : renderPage;
-        const html = await render({
-          loadModule: (id) => vite.ssrLoadModule(id),
-          pageId: matched.pageId,
-          params: matched.params,
-          url,
-          registry,
-          componentCss,
-          transformHtml: (u, doc) => vite.transformIndexHtml(u, doc)
-        });
-        setResponseHeader(event, "Content-Type", "text/html");
-        return html;
-      } catch (err) {
-        const error = err;
-        vite.ssrFixStacktrace(error);
-        setResponseStatus(event, 500);
-        setResponseHeader(event, "Content-Type", "text/html");
-        return `<pre>${escapeHtml(error.stack ?? error.message)}</pre>`;
-      }
-    })
-  );
-  const server = createHttpServer(toNodeListener(app));
-  await new Promise((resolve) => server.listen(port, resolve));
-  return {
-    vite,
-    server,
-    port,
-    close: async () => {
-      await vite.close();
-      await new Promise(
-        (resolve, reject) => server.close((e) => e ? reject(e) : resolve())
-      );
-    }
-  };
-}
-function escapeHtml(s) {
-  return s.replace(/[&<>]/g, (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : "&gt;");
-}
-function notFoundPage(url, routes) {
-  const list = routes.map((r) => `<li><code>${escapeHtml(r.pattern)}</code></li>`).join("");
-  return `<!DOCTYPE html><html><head><title>404 \u2014 Apex JS</title></head>
-<body style="font-family: system-ui, sans-serif; max-width: 40rem; margin: 3rem auto;">
-  <h1>404 \u2014 no route for <code>${escapeHtml(url)}</code></h1>
-  <p>Available routes:</p>
-  <ul>${list || "<li>(no pages found \u2014 add <code>pages/index.alpine</code>)</li>"}</ul>
-</body></html>`;
-}
-
-export {
-  startDevServer
-};