@apex-stack/core 0.1.14 → 0.1.16

package/dist/{build-QRHQUUZC.js → build-UDFLTWY5.js}

@@ -5,7 +5,8 @@ import {
   renderIslandsPage,
   renderPage,
   scanPages
-} from "./chunk-PAMD24NK.js";
+} from "./chunk-YO4UXWIY.js";
+import "./chunk-MZVLRU3R.js";
 
 // src/commands/build.ts
 import { cpSync, existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, rmSync, writeFileSync } from "fs";

package/dist/chunk-HRJTOSYH.js

@@ -0,0 +1,8 @@
+// src/api/resource.ts
+function isApexResource(x) {
+  return typeof x === "object" && x !== null && x.__apexResource === true;
+}
+
+export {
+  isApexResource
+};

package/dist/{chunk-DSUIB3JH.js → chunk-JWYNLP4L.js}

@@ -1,7 +1,6 @@
-// src/api/resource.ts
-function isApexResource(x) {
-  return typeof x === "object" && x !== null && x.__apexResource === true;
-}
+import {
+  isApexResource
+} from "./chunk-HRJTOSYH.js";
 
 // src/api/routes.ts
 import { existsSync, readdirSync } from "fs";
@@ -135,7 +134,6 @@ function createMcpHandler(entries) {
 }
 
 export {
-  isApexResource,
   expandApiModule,
   loadApiRoutes,
   createApiHandler,

package/dist/chunk-MZVLRU3R.js

@@ -0,0 +1,15 @@
+// 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;
+}
+
+export {
+  defineStore,
+  isApexStore
+};

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

@@ -36,7 +36,7 @@ var LOGO = [
 var FROM = [99, 102, 241];
 var TO = [34, 211, 238];
 function banner(subtitle = "The full-stack, AI-native meta-framework for Alpine.js") {
-  const width = LOGO[0].length;
+  const width = LOGO[0]?.length ?? 0;
   const rows = LOGO.map((line) => {
     if (!TTY) return `  ${line}`;
     let out = "  ";
@@ -45,7 +45,7 @@ function banner(subtitle = "The full-stack, AI-native meta-framework for Alpine.
       const r = Math.round(FROM[0] + (TO[0] - FROM[0]) * t);
       const g = Math.round(FROM[1] + (TO[1] - FROM[1]) * t);
       const b = Math.round(FROM[2] + (TO[2] - FROM[2]) * t);
-      out += `\x1B[38;2;${r};${g};${b}m${line[i]}`;
+      out += `\x1B[38;2;${r};${g};${b}m${line[i] ?? ""}`;
     }
     return out + RESET;
   });
@@ -70,7 +70,7 @@ function spinner(text) {
   let i = 0;
   process.stdout.write("\x1B[?25l");
   const id = setInterval(() => {
-    process.stdout.write(`\r\x1B[2K  ${color.cyan(FRAMES[i++ % FRAMES.length])} ${text}`);
+    process.stdout.write(`\r\x1B[2K  ${color.cyan(FRAMES[i++ % FRAMES.length] ?? "")} ${text}`);
   }, 80);
   const end = (symbol, t) => {
     clearInterval(id);

package/dist/{chunk-PAMD24NK.js → chunk-YO4UXWIY.js}

@@ -1,3 +1,7 @@
+import {
+  isApexStore
+} from "./chunk-MZVLRU3R.js";
+
 // src/islands/render.ts
 import { renderIslands } from "@apex-stack/kit";
 var ISLAND_LOADER = (
@@ -118,34 +122,74 @@ function matchRoute(routes, url) {
   return null;
 }
 
+// src/stores/loader.ts
+import { existsSync as existsSync2, readdirSync as readdirSync2 } from "fs";
+import { join as join2 } from "path";
+async function loadStores(root, loadModule) {
+  const dir = join2(root, "stores");
+  if (!existsSync2(dir)) return [];
+  const out = [];
+  for (const file of readdirSync2(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".js"))) {
+    const id = `/stores/${file}`;
+    const mod = await loadModule(id);
+    const def = mod.default;
+    if (isApexStore(def)) {
+      const store = def;
+      out.push({ id, name: store.name, factory: store.factory });
+    }
+  }
+  return out;
+}
+function storesInitialState(stores) {
+  const state = {};
+  for (const s of stores) {
+    try {
+      state[s.name] = s.factory();
+    } catch {
+      state[s.name] = {};
+    }
+  }
+  return state;
+}
+
 // src/dev/renderPage.ts
 import { renderComponent, stateIsland } from "@apex-stack/kit";
 async function renderPage(opts) {
   const mod = await opts.loadModule(opts.pageId);
   const loaderData = await mod.loader({ params: opts.params ?? {}, url: opts.url }) ?? {};
+  const stores = opts.stores ?? [];
   const { html } = renderComponent({
     template: mod.template,
     rootXData: mod.rootXData,
     componentId: mod.componentId,
     scopeId: mod.scopeId,
     loaderData,
-    registry: opts.registry
+    registry: opts.registry,
+    stores: storesInitialState(stores),
+    authoredDefaults: mod.rootData ? mod.rootData() : void 0
   });
   const doc = shell({
     body: html,
     island: stateIsland(mod.componentId, loaderData),
     css: mod.css + (opts.componentCss ?? ""),
     pageId: opts.pageId,
-    clientHref: opts.clientHref
+    clientHref: opts.clientHref,
+    storeIds: stores.map((s) => s.id),
+    appCss: opts.appCss
   });
   return opts.transformHtml ? opts.transformHtml(opts.url, doc) : doc;
 }
-function shell({ body, island, css, pageId, clientHref }) {
+function shell({ body, island, css, pageId, clientHref, storeIds = [], appCss }) {
+  const storeImports = storeIds.map((id, i) => `  import __s${i} from ${JSON.stringify(id)}`).join("\n");
+  const storeRegs = storeIds.map((_, i) => `  Alpine.store(__s${i}.name, __s${i}.factory())`).join("\n");
   const clientScript = clientHref ? `<script type="module" src="${clientHref}"></script>` : `<script type="module">
-  import Alpine from 'alpinejs'
-  import ${JSON.stringify(pageId)}
+${appCss ? `  import ${JSON.stringify(appCss)}
+` : ""}  import Alpine from 'alpinejs'
+${storeImports ? `${storeImports}
+` : ""}  import ${JSON.stringify(pageId)}
   window.Alpine = Alpine
-  Alpine.start()
+${storeRegs ? `${storeRegs}
+` : ""}  Alpine.start()
 </script>`;
   return `<!DOCTYPE html>
 <html lang="en">
@@ -167,5 +211,6 @@ export {
   renderIslandsPage,
   scanPages,
   matchRoute,
+  loadStores,
   renderPage
 };

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   banner,
   color,
   spinner
-} from "./chunk-7E5ZQ6UH.js";
+} from "./chunk-QIXJSQLW.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand2, runMain } from "citty";
@@ -109,10 +109,10 @@ var main = defineCommand2({
   },
   subCommands: {
     new: newCommand,
-    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-5B5JSCQF.js").then((m) => m.makeCommand),
+    dev: () => import("./dev-PQRMJ7Z4.js").then((m) => m.devCommand),
+    build: () => import("./build-UDFLTWY5.js").then((m) => m.buildCommand),
+    start: () => import("./start-EYEWMZXS.js").then((m) => m.startCommand),
+    make: () => import("./make-62PPHZQY.js").then((m) => m.makeCommand),
     migrate: () => import("./migrate-NOGFOFV2.js").then((m) => m.migrateCommand),
     mcp: () => import("./mcp-DL4J6JFJ.js").then((m) => m.mcpCommand)
   },

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

@@ -2,7 +2,7 @@ import {
   banner,
   ready,
   spinner
-} from "./chunk-7E5ZQ6UH.js";
+} from "./chunk-QIXJSQLW.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-ODH3M2IG.js");
+      const { startDevServer } = await import("./server-GFQQABB4.js");
       const { port: actual } = await startDevServer({ root, port, islands: Boolean(args.islands) });
       sp.succeed("Dev server ready");
       ready([

package/dist/index.d.ts

@@ -1,7 +1,4 @@
 import { ZodRawShape, z } from 'zod';
-import { Server } from 'node:http';
-import { ViteDevServer } from 'vite';
-import { ComponentRegistry } from '@apex-stack/kit';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 /** Inferred, validated input object for a route's handler. */
@@ -73,64 +70,29 @@ interface ApexResource {
 }
 declare function isApexResource(x: unknown): x is ApexResource;
 
-interface DevServerOptions {
-    root: string;
-    port?: number;
-    /** Page module rendered for every route in the spike (single-route). */
-    pageId?: string;
-    /** Render in islands mode (static-first, per-island hydration) instead of one page component. */
-    islands?: boolean;
-}
-interface DevServer {
-    vite: ViteDevServer;
-    server: Server;
-    port: number;
-    close: () => Promise<void>;
+type StoreState = Record<string, unknown>;
+interface ApexStore {
+    readonly __apexStore: true;
+    readonly name: string;
+    readonly factory: () => StoreState;
 }
 /**
- * Start the Apex dev server: Vite in middleware mode (build/HMR/asset serving)
- * fronted by an h3 app whose catch-all handler SSRs the page. Written as h3
- * event handlers so the render path can migrate to Nitro unchanged.
- */
-declare function startDevServer(options: DevServerOptions): Promise<DevServer>;
-
-/** The shape a compiled `.alpine` SSR module exports (see @apex-stack/vite). */
-interface PageModule {
-    loader: (ctx: {
-        params: Record<string, string>;
-        url: string;
-    }) => unknown | Promise<unknown>;
-    template: string;
-    rootXData: string | null;
-    componentId: string;
-    scopeId: string;
-    css: string;
-}
-interface RenderPageOptions {
-    /** Load a page's SSR module (dev: vite.ssrLoadModule; prod: static import). */
-    loadModule: (id: string) => Promise<PageModule>;
-    /** The page module id to render, e.g. `/pages/index.alpine`. */
-    pageId: string;
-    /** The incoming request path. */
-    url: string;
-    /** Route params captured from a dynamic segment (e.g. { slug: '...' }). */
-    params?: Record<string, string>;
-    /** Registry of embeddable components. */
-    registry?: ComponentRegistry;
-    /** Aggregated component CSS to include in the shell. */
-    componentCss?: string;
-    /** Post-process the shell HTML (dev: vite.transformIndexHtml). */
-    transformHtml?: (url: string, html: string) => string | Promise<string>;
-    /** In a production build, the href of the built client bundle for this page.
-     * When set, the shell references it instead of the inline dev module. */
-    clientHref?: string;
-}
-/**
- * The framework's render seam — deliberately dev-server-agnostic so it can move
- * verbatim into a Nitro route handler post-spike. Loads the page module, runs
- * its loader, renders the component to hydration-safe HTML, and assembles the
- * document shell (SSR body + state island + client entry).
+ * Define a global, SSR-safe store shared across every page, component, and island.
+ *
+ * ```ts
+ * // stores/cart.ts
+ * import { defineStore } from '@apex-stack/core'
+ * export default defineStore('cart', () => ({
+ *   items: [] as string[],
+ *   get count() { return this.items.length },
+ *   add(x: string) { this.items.push(x) },
+ * }))
+ * ```
+ *
+ * Access it anywhere as `$store.cart` — `$store.cart.count` renders on the server
+ * and stays reactive after hydration.
  */
-declare function renderPage(opts: RenderPageOptions): Promise<string>;
+declare function defineStore(name: string, factory: () => StoreState): ApexStore;
+declare function isApexStore(x: unknown): x is ApexStore;
 
-export { type ApexResource, type ApexRoute, type ApexRouteConfig, type ApexRouteHandlerContext, type DevServer, type DevServerOptions, type HttpMethod, type PageModule, type RenderPageOptions, type ResourceRoute, defineApexRoute, isApexResource, renderPage, startDevServer };
+export { type ApexResource, type ApexRoute, type ApexRouteConfig, type ApexRouteHandlerContext, type ApexStore, type HttpMethod, type ResourceRoute, type StoreState, defineApexRoute, defineStore, isApexResource, isApexStore };

package/dist/index.js

@@ -1,13 +1,10 @@
-import {
-  startDevServer
-} from "./chunk-SH3XEJGV.js";
-import "./chunk-4VG3CZ6H.js";
 import {
   isApexResource
-} from "./chunk-DSUIB3JH.js";
+} from "./chunk-HRJTOSYH.js";
 import {
-  renderPage
-} from "./chunk-PAMD24NK.js";
+  defineStore,
+  isApexStore
+} from "./chunk-MZVLRU3R.js";
 
 // src/api/defineRoute.ts
 function defineApexRoute(config) {
@@ -22,7 +19,7 @@ function defineApexRoute(config) {
 }
 export {
   defineApexRoute,
+  defineStore,
   isApexResource,
-  renderPage,
-  startDevServer
+  isApexStore
 };

package/dist/{make-5B5JSCQF.js → make-62PPHZQY.js}

@@ -33,6 +33,18 @@ function componentTemplate() {
 </style>
 `;
 }
+function storeTemplate(name) {
+  return `import { defineStore } from '@apex-stack/core'
+
+// Access anywhere as $store.${name} \u2014 SSR-rendered and reactive after hydration.
+export default defineStore('${name}', () => ({
+  count: 0,
+  increment() {
+    this.count++
+  },
+}))
+`;
+}
 function apiTemplate(name) {
   return `import { defineApexRoute } from '@apex-stack/core'
 import { z } from 'zod'
@@ -55,20 +67,22 @@ function plan(kind, name, root) {
       return { path: join(root, "components", `${pascalCase(name)}.alpine`), contents: componentTemplate() };
     case "api":
       return { path: join(root, "server", "api", `${name}.ts`), contents: apiTemplate(name) };
+    case "store":
+      return { path: join(root, "stores", `${name}.ts`), contents: storeTemplate(name) };
   }
 }
 var makeCommand = defineCommand({
-  meta: { name: "make", description: "Generate a page, component, or API route" },
+  meta: { name: "make", description: "Generate a page, component, API route, or store" },
   args: {
-    kind: { type: "positional", required: true, description: "page | component | api" },
+    kind: { type: "positional", required: true, description: "page | component | api | store" },
     name: { type: "positional", required: true, description: "Name (about, Counter, todos, \u2026)" },
     root: { type: "string", description: "Project root", default: "." }
   },
   run({ args }) {
     const kind = args.kind;
-    if (kind !== "page" && kind !== "component" && kind !== "api") {
+    if (kind !== "page" && kind !== "component" && kind !== "api" && kind !== "store") {
       console.error(`
-  Unknown type "${args.kind}". Use: page | component | api
+  Unknown type "${args.kind}". Use: page | component | api | store
 `);
       process.exit(1);
     }

package/dist/{chunk-SH3XEJGV.js → server-GFQQABB4.js}

@@ -5,19 +5,23 @@ import {
   createApiHandler,
   createMcpHandler,
   loadApiRoutes
-} from "./chunk-DSUIB3JH.js";
+} from "./chunk-JWYNLP4L.js";
+import "./chunk-HRJTOSYH.js";
 import {
+  loadStores,
   matchRoute,
   renderIslandsPage,
   renderPage,
   scanPages
-} from "./chunk-PAMD24NK.js";
+} from "./chunk-YO4UXWIY.js";
+import "./chunk-MZVLRU3R.js";
 
 // src/dev/server.ts
+import { existsSync as existsSync2 } from "fs";
 import { createServer as createHttpServer } from "http";
 import { createRequire } from "module";
 import { join } from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath, pathToFileURL } from "url";
 import { apex } from "@apex-stack/vite";
 import {
   createApp,
@@ -39,11 +43,12 @@ function firstFileFrame(stack, root) {
   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" ? "\\" : "/");
+    const raw = m[1];
+    if (!raw) continue;
+    if (/^[A-Za-z]:[\\/]/.test(raw) === false && !raw.startsWith("/")) continue;
+    const file = raw.replace(/\//g, process.platform === "win32" ? "\\" : "/");
     if (existsSync(file) && !file.includes("node_modules")) {
-      frames.push({ file, line: Number(m[2]), col: Number(m[3]) });
+      frames.push({ file, line: Number(m[2] ?? 0), col: Number(m[3] ?? 0) });
     }
   }
   return frames.find((f) => f.file.startsWith(root)) ?? frames[0];
@@ -154,9 +159,23 @@ async function startDevServer(options) {
   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 };
+  const coreSelf = fileURLToPath(new URL("./index.js", import.meta.url));
+  const alias = {
+    "@apex-stack/core/client": coreClient,
+    "@apex-stack/core": coreSelf
+  };
   if (alpine) alias.alpinejs = alpine;
   if (kit) alias["@apex-stack/kit"] = kit;
+  const plugins = [apex({ clientRuntime: "@apex-stack/core/client" })];
+  try {
+    const reqProj = createRequire(join(options.root, "package.json"));
+    const twMod = await import(pathToFileURL(reqProj.resolve("@tailwindcss/vite")).href);
+    const tw = twMod.default ?? twMod;
+    plugins.unshift(tw());
+  } catch {
+  }
+  const appCssRel = ["app.css", "styles/app.css", "src/app.css"].find((p) => existsSync2(join(options.root, p)));
+  const appCss = appCssRel ? `/${appCssRel}` : void 0;
   const vite = await createViteServer({
     root: options.root,
     appType: "custom",
@@ -166,7 +185,7 @@ async function startDevServer(options) {
     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" })],
+    plugins,
     optimizeDeps: { include: ["alpinejs"] }
   });
   const ssrLoad = (id) => {
@@ -193,6 +212,7 @@ async function startDevServer(options) {
           options.root,
           (id) => ssrLoad(id)
         );
+        const stores = await loadStores(options.root, (id) => ssrLoad(id));
         const render = options.islands ? renderIslandsPage : renderPage;
         const html = await render({
           loadModule: (id) => ssrLoad(id),
@@ -201,6 +221,8 @@ async function startDevServer(options) {
           url,
           registry,
           componentCss,
+          stores,
+          appCss,
           transformHtml: (u, doc) => vite.transformIndexHtml(u, doc)
         });
         setResponseHeader(event, "Content-Type", "text/html");
@@ -233,7 +255,6 @@ async function startDevServer(options) {
     }
   };
 }
-
 export {
   startDevServer
 };

package/dist/{start-VJJXI4W3.js → start-EYEWMZXS.js}

@@ -3,12 +3,14 @@ import {
   createMcpHandler,
   expandApiModule,
   hasMcpRoutes
-} from "./chunk-DSUIB3JH.js";
+} from "./chunk-JWYNLP4L.js";
+import "./chunk-HRJTOSYH.js";
 import {
   matchRoute,
   renderIslandsPage,
   renderPage
-} from "./chunk-PAMD24NK.js";
+} from "./chunk-YO4UXWIY.js";
+import "./chunk-MZVLRU3R.js";
 
 // src/commands/start.ts
 import { existsSync as existsSync2 } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apex-stack/core",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "The full-stack meta-framework for Alpine.js — CLI and runtime",
   "type": "module",
   "license": "MIT",
@@ -45,8 +45,8 @@
     "h3": "^1.13.0",
     "vite": "^6.0.7",
     "zod": "^4.4.3",
-    "@apex-stack/kit": "0.1.3",
-    "@apex-stack/vite": "0.1.3"
+    "@apex-stack/kit": "0.1.4",
+    "@apex-stack/vite": "0.1.4"
   },
   "peerDependencies": {
     "alpinejs": "^3.14.0"
@@ -54,6 +54,7 @@
   "engines": {
     "node": ">=20.19"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "node scripts/copy-templates.mjs && tsup",
     "dev": "tsup --watch",

package/dist/server-ODH3M2IG.js

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