@apex-stack/core 0.1.20 → 0.2.0

package/dist/{build-PETU3URU.js → build-VHS6KZBK.js}

@@ -2,21 +2,23 @@ import {
   loadComponents
 } from "./chunk-4VG3CZ6H.js";
 import {
+  loadStores,
   renderIslandsPage,
   renderPage,
+  resolveApexConfig,
   scanPages
-} from "./chunk-4FUWZLVW.js";
-import "./chunk-MZVLRU3R.js";
+} from "./chunk-XDKJO6ZC.js";
+import "./chunk-JLIAISWM.js";
 
 // src/commands/build.ts
-import { cpSync, existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, rmSync, writeFileSync } from "fs";
+import { cpSync, existsSync as existsSync3, mkdirSync, readdirSync as readdirSync3, rmSync, writeFileSync } from "fs";
 import { dirname, join as join3, resolve } from "path";
 import { apex as apex3 } from "@apex-stack/vite";
 import { defineCommand } from "citty";
 import { createServer as createViteServer } from "vite";
 
 // src/build/buildClient.ts
-import { readFileSync } from "fs";
+import { existsSync, readFileSync, readdirSync } from "fs";
 import { join } from "path";
 import { apex } from "@apex-stack/vite";
 import { build } from "vite";
@@ -24,9 +26,11 @@ var VIRT = "virtual:apex-client:";
 function entryName(pageId) {
   return pageId.replace(/^\/pages\//, "").replace(/\.alpine$/, "").replace(/[^a-zA-Z0-9]+/g, "_");
 }
-async function buildClient(root, routes, outDir) {
+async function buildClient(root, routes, outDir, base = "/") {
   const input = {};
   for (const r of routes) input[entryName(r.pageId)] = `${VIRT}${r.pageId}`;
+  const storesDir = join(root, "stores");
+  const storeIds = existsSync(storesDir) ? readdirSync(storesDir).filter((f) => f.endsWith(".ts") || f.endsWith(".js")).map((f) => `/stores/${f}`) : [];
   const entryPlugin = {
     name: "apex:client-entries",
     resolveId(id) {
@@ -37,8 +41,10 @@ async function buildClient(root, routes, outDir) {
         const pageId = id.slice(`\0${VIRT}`.length);
         return [
           `import Alpine from 'alpinejs'`,
+          ...storeIds.map((sid, i) => `import __s${i} from ${JSON.stringify(sid)}`),
           `import ${JSON.stringify(pageId)}`,
           "window.Alpine = Alpine",
+          ...storeIds.map((_, i) => `Alpine.store(__s${i}.name, __s${i}.factory())`),
           "Alpine.start()"
         ].join("\n");
       }
@@ -46,6 +52,7 @@ async function buildClient(root, routes, outDir) {
   };
   await build({
     root,
+    base,
     logLevel: "warn",
     plugins: [apex({ clientRuntime: "@apex-stack/core/client" }), entryPlugin],
     build: {
@@ -58,36 +65,43 @@ async function buildClient(root, routes, outDir) {
   const manifest = JSON.parse(
     readFileSync(join(outDir, ".vite", "manifest.json"), "utf8")
   );
+  const prefix = base.endsWith("/") ? base : `${base}/`;
   const hrefs = /* @__PURE__ */ new Map();
   for (const r of routes) {
     const virt = `${VIRT}${r.pageId}`;
     const entry = Object.values(manifest).find(
-      (m) => m.isEntry && (m.src === virt || m.src === `\0${virt}`)
+      (m) => m.isEntry && typeof m.src === "string" && (m.src === virt || m.src.endsWith(virt))
     );
-    if (entry) hrefs.set(r.pageId, `/${entry.file}`);
+    if (entry) hrefs.set(r.pageId, `${prefix}${entry.file}`);
   }
   return hrefs;
 }
 
 // src/build/buildServer.ts
-import { existsSync, readdirSync } from "fs";
+import { existsSync as existsSync2, readdirSync as readdirSync2 } from "fs";
 import { isAbsolute, join as join2 } from "path";
 import { apex as apex2 } from "@apex-stack/vite";
 import { build as build2 } from "vite";
 async function buildServer(root, routes, outDir) {
   const ids = routes.map((r) => r.pageId);
   const compDir = join2(root, "components");
-  if (existsSync(compDir)) {
-    for (const f of readdirSync(compDir).filter((f2) => f2.endsWith(".alpine"))) {
+  if (existsSync2(compDir)) {
+    for (const f of readdirSync2(compDir).filter((f2) => f2.endsWith(".alpine"))) {
       ids.push(`/components/${f}`);
     }
   }
   const apiDir = join2(root, "server", "api");
-  if (existsSync(apiDir)) {
-    for (const f of readdirSync(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
+  if (existsSync2(apiDir)) {
+    for (const f of readdirSync2(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
       ids.push(`/server/api/${f}`);
     }
   }
+  const mwDir = join2(root, "middleware");
+  if (existsSync2(mwDir)) {
+    for (const f of readdirSync2(mwDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
+      ids.push(`/middleware/${f}`);
+    }
+  }
   const input = {};
   for (const id of ids) input[entryName2(id)] = join2(root, id.slice(1));
   const result = await build2({
@@ -147,6 +161,11 @@ var buildCommand = defineCommand({
       type: "boolean",
       description: "Build a Node server (dynamic routes + API/MCP)",
       default: false
+    },
+    base: {
+      type: "string",
+      description: "Public base path for a subpath deploy (e.g. /demo/)",
+      default: "/"
     }
   },
   async run({ args }) {
@@ -159,7 +178,7 @@ var buildCommand = defineCommand({
     if (args.server) {
       return buildServerTarget(root, outDir, args.outDir, routes);
     }
-    const hrefs = args.islands ? /* @__PURE__ */ new Map() : await buildClient(root, staticRoutes, outDir);
+    const hrefs = args.islands ? /* @__PURE__ */ new Map() : await buildClient(root, staticRoutes, outDir, args.base);
     const vite = await createViteServer({
       root,
       appType: "custom",
@@ -171,13 +190,24 @@ var buildCommand = defineCommand({
         root,
         (id) => vite.ssrLoadModule(id)
       );
+      const stores = await loadStores(root, (id) => vite.ssrLoadModule(id));
+      const { runtimeConfig, publicConfig } = await resolveApexConfig(
+        root,
+        (id) => vite.ssrLoadModule(id)
+      );
+      const layoutsDir = join3(root, "layouts");
+      const layouts = existsSync3(layoutsDir) ? readdirSync3(layoutsDir).filter((f) => f.endsWith(".alpine")).map((f) => f.replace(/\.alpine$/, "")) : [];
       for (const route of staticRoutes) {
         const common = {
           loadModule: (id) => vite.ssrLoadModule(id),
           pageId: route.pageId,
           url: route.pattern,
           registry,
-          componentCss
+          componentCss,
+          stores,
+          layouts,
+          runtimeConfig,
+          publicConfig
         };
         const html = args.islands ? await renderIslandsPage(common) : await renderPage({ ...common, clientHref: hrefs.get(route.pageId) });
         const dest = join3(outDir, outFile(route.pattern));
@@ -186,7 +216,7 @@ var buildCommand = defineCommand({
         console.log(`  \u2713 ${route.pattern}  \u2192  ${outFile(route.pattern)}`);
       }
       const pub = join3(root, "public");
-      if (existsSync2(pub)) cpSync(pub, outDir, { recursive: true });
+      if (existsSync3(pub)) cpSync(pub, outDir, { recursive: true });
       console.log(
         `
   Built ${staticRoutes.length} page(s) \u2192 ${args.outDir}/${args.islands ? " (islands / static-first)" : " (prerendered + hydrated)"}`
@@ -205,22 +235,44 @@ var buildCommand = defineCommand({
 async function buildServerTarget(root, outDir, outLabel, routes) {
   const clientHrefs = await buildClient(root, routes, outDir);
   const server = await buildServer(root, routes, outDir);
+  let runtimeConfig = { public: {} };
+  const cfgVite = await createViteServer({
+    root,
+    appType: "custom",
+    server: { middlewareMode: true },
+    plugins: [apex3({ clientRuntime: "@apex-stack/core/client" })]
+  });
+  try {
+    const resolved = await resolveApexConfig(root, (id) => cfgVite.ssrLoadModule(id));
+    runtimeConfig = { public: {}, ...resolved.config.runtimeConfig ?? {} };
+    if (!runtimeConfig.public) runtimeConfig.public = {};
+  } finally {
+    await cfgVite.close();
+  }
   const components = {};
   const compDir = join3(root, "components");
-  if (existsSync2(compDir)) {
-    for (const f of readdirSync2(compDir).filter((f2) => f2.endsWith(".alpine"))) {
+  if (existsSync3(compDir)) {
+    for (const f of readdirSync3(compDir).filter((f2) => f2.endsWith(".alpine"))) {
       const sf = server.modules[`/components/${f}`];
       if (sf) components[f.replace(/\.alpine$/, "")] = sf;
     }
   }
   const api = [];
   const apiDir = join3(root, "server", "api");
-  if (existsSync2(apiDir)) {
-    for (const f of readdirSync2(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
+  if (existsSync3(apiDir)) {
+    for (const f of readdirSync3(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
       const sf = server.modules[`/server/api/${f}`];
       if (sf) api.push({ name: f.replace(/\.(ts|js|mjs)$/, ""), serverFile: sf });
     }
   }
+  const middleware = [];
+  const mwDir = join3(root, "middleware");
+  if (existsSync3(mwDir)) {
+    for (const f of readdirSync3(mwDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2)).sort()) {
+      const sf = server.modules[`/middleware/${f}`];
+      if (sf) middleware.push({ serverFile: sf });
+    }
+  }
   const manifest = {
     islands: false,
     routes: routes.map((r) => ({
@@ -229,11 +281,13 @@ async function buildServerTarget(root, outDir, outLabel, routes) {
       clientHref: clientHrefs.get(r.pageId)
     })),
     components,
-    api
+    api,
+    middleware,
+    runtimeConfig
   };
   writeFileSync(join3(outDir, "apex-manifest.json"), JSON.stringify(manifest, null, 2));
   const pub = join3(root, "public");
-  if (existsSync2(pub)) cpSync(pub, outDir, { recursive: true });
+  if (existsSync3(pub)) cpSync(pub, outDir, { recursive: true });
   console.log(
     `
   Built server target \u2192 ${outLabel}/  (${routes.length} route(s), ${api.length} API module(s))

package/dist/chunk-2C2HRLIY.js

@@ -0,0 +1,18 @@
+// src/api/resource.ts
+function isApexResource(x) {
+  return typeof x === "object" && x !== null && x.__apexResource === true;
+}
+
+// src/middleware/define.ts
+function defineMiddleware(fn) {
+  return fn;
+}
+function isRedirect(value) {
+  return !!value && typeof value === "object" && value.__apexRedirect === true;
+}
+
+export {
+  isApexResource,
+  defineMiddleware,
+  isRedirect
+};

package/dist/chunk-CHBSGOB3.js

@@ -0,0 +1,42 @@
+// src/vscode.ts
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { createInterface } from "readline";
+import { fileURLToPath } from "url";
+var VSIX = fileURLToPath(new URL("../vscode/apex-alpine.vsix", import.meta.url));
+var WIN = process.platform === "win32";
+function extensionBundled() {
+  return existsSync(VSIX);
+}
+function hasCodeCli() {
+  try {
+    return spawnSync("code", ["--version"], { stdio: "ignore", shell: WIN }).status === 0;
+  } catch {
+    return false;
+  }
+}
+function installExtension() {
+  if (!existsSync(VSIX)) return false;
+  return spawnSync("code", ["--install-extension", VSIX, "--force"], { stdio: "inherit", shell: WIN }).status === 0;
+}
+function promptYesNo(question, def = true) {
+  if (!process.stdin.isTTY) return Promise.resolve(def);
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${question} ${def ? "(Y/n) " : "(y/N) "}`, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      resolve(a === "" ? def : a === "y" || a === "yes");
+    });
+  });
+}
+async function offerExtension(choice) {
+  if (!extensionBundled() || !hasCodeCli()) return null;
+  const yes = choice ?? await promptYesNo("Install the Apex .alpine VS Code extension (syntax highlighting)?");
+  if (!yes) return null;
+  return installExtension() ? "VS Code extension installed" : "VS Code extension install failed";
+}
+
+export {
+  offerExtension
+};

package/dist/{chunk-G77MLFUJ.js → chunk-HCNNKT4A.js}

@@ -1,6 +1,7 @@
 import {
-  isApexResource
-} from "./chunk-HRJTOSYH.js";
+  isApexResource,
+  isRedirect
+} from "./chunk-2C2HRLIY.js";
 
 // src/api/routes.ts
 import { existsSync, readdirSync } from "fs";
@@ -66,7 +67,7 @@ function matchApi(entries, path, method) {
   }
   return null;
 }
-function createApiHandler(entries) {
+function createApiHandler(entries, config) {
   return defineEventHandler(async (event) => {
     const url = getRequestURL(event);
     const matched = matchApi(entries, url.pathname, event.method);
@@ -88,7 +89,12 @@ function createApiHandler(entries) {
       }
       input = parsed.data;
     }
-    const result = await entry.route.handler({ input, url: url.toString() });
+    const result = await entry.route.handler({
+      input,
+      url: url.toString(),
+      config: config ?? { public: {} },
+      locals: event.context.apexLocals ?? {}
+    });
     setResponseHeader(event, "Content-Type", "application/json");
     return result;
   });
@@ -101,7 +107,7 @@ import { defineEventHandler as defineEventHandler2, toWebRequest } from "h3";
 function hasMcpRoutes(entries) {
   return entries.some((e) => e.route.mcp);
 }
-function buildServer(entries) {
+function buildServer(entries, config) {
   const server = new McpServer({ name: "apexjs", version: "0.0.0" });
   for (const entry of entries) {
     server.registerTool(
@@ -113,7 +119,8 @@ function buildServer(entries) {
       async (args) => {
         const result = await entry.route.handler({
           input: args ?? {},
-          url: `mcp://${entry.mcpName}`
+          url: `mcp://${entry.mcpName}`,
+          config: config ?? { public: {} }
         });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
@@ -121,10 +128,10 @@ function buildServer(entries) {
   }
   return server;
 }
-function createMcpHandler(entries) {
+function createMcpHandler(entries, config) {
   const mcpEntries = entries.filter((e) => e.route.mcp);
   return defineEventHandler2(async (event) => {
-    const server = buildServer(mcpEntries);
+    const server = buildServer(mcpEntries, config);
     const transport = new WebStandardStreamableHTTPServerTransport({
       sessionIdGenerator: void 0,
       enableJsonResponse: true
@@ -136,10 +143,42 @@ function createMcpHandler(entries) {
   });
 }
 
+// src/middleware/run.ts
+import { existsSync as existsSync2, readdirSync as readdirSync2 } from "fs";
+import { join as join2 } from "path";
+async function loadMiddleware(root, loadModule) {
+  const dir = join2(root, "middleware");
+  if (!existsSync2(dir)) return [];
+  const files = readdirSync2(dir).filter((f) => /\.(ts|js|mjs)$/.test(f)).sort();
+  const out = [];
+  for (const f of files) {
+    const mod = await loadModule(`/middleware/${f}`);
+    if (typeof mod.default === "function") out.push(mod.default);
+  }
+  return out;
+}
+async function runMiddleware(middleware, input) {
+  const locals = {};
+  for (const mw of middleware) {
+    const result = await mw({
+      url: input.url,
+      method: input.method,
+      config: input.config,
+      headers: input.headers,
+      locals,
+      redirect: (to, status = 302) => ({ __apexRedirect: true, to, status })
+    });
+    if (isRedirect(result)) return { redirect: result, locals };
+  }
+  return { locals };
+}
+
 export {
   expandApiModule,
   loadApiRoutes,
   createApiHandler,
   hasMcpRoutes,
-  createMcpHandler
+  createMcpHandler,
+  loadMiddleware,
+  runMiddleware
 };

package/dist/chunk-JLIAISWM.js

@@ -0,0 +1,48 @@
+// src/store.ts
+function defineStore(name, factory) {
+  if (!name || /[^a-zA-Z0-9_$]/.test(name)) {
+    throw new Error(`defineStore: invalid store name "${name}" \u2014 use letters, digits, _ or $.`);
+  }
+  return { __apexStore: true, name, factory };
+}
+function isApexStore(x) {
+  return typeof x === "object" && x !== null && x.__apexStore === true;
+}
+
+// src/config/runtime.ts
+function defineConfig(config) {
+  return config;
+}
+var SERVER_KEY = "__APEX_RUNTIME_CONFIG__";
+var CLIENT_KEY = "__APEX_CONFIG__";
+function setRuntimeConfig(cfg) {
+  ;
+  globalThis[SERVER_KEY] = cfg;
+}
+function clientConfigScript(publicConfig) {
+  return `<script>window.${CLIENT_KEY}=${JSON.stringify({ public: publicConfig }).replace(/</g, "\\u003c")}</script>`;
+}
+function useRuntimeConfig() {
+  if (typeof window !== "undefined") {
+    return window[CLIENT_KEY] ?? {
+      public: {}
+    };
+  }
+  return globalThis[SERVER_KEY] ?? { public: {} };
+}
+function env(key, fallback) {
+  if (typeof process !== "undefined" && process.env && process.env[key] !== void 0) {
+    return process.env[key];
+  }
+  return fallback;
+}
+
+export {
+  defineStore,
+  isApexStore,
+  defineConfig,
+  setRuntimeConfig,
+  clientConfigScript,
+  useRuntimeConfig,
+  env
+};