npm - @apex-stack/core - Versions diffs - 0.1.13 → 0.1.15 - Mend

@apex-stack/core 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/{build-QRHQUUZC.js → build-MFLFMGGZ.js} +2 -1
package/dist/{chunk-PAMD24NK.js → chunk-D3VZDJ3R.js} +47 -5
package/dist/chunk-HRJTOSYH.js +8 -0
package/dist/{chunk-DSUIB3JH.js → chunk-JWYNLP4L.js} +3 -5
package/dist/chunk-MZVLRU3R.js +15 -0
package/dist/{chunk-7E5ZQ6UH.js → chunk-QIXJSQLW.js} +3 -3
package/dist/cli.js +5 -5
package/dist/{dev-BIPK7O5N.js → dev-FS4VVUX2.js} +2 -2
package/dist/index.d.ts +22 -60
package/dist/index.js +6 -9
package/dist/{make-4LINTKZH.js → make-62PPHZQY.js} +22 -5
package/dist/{chunk-SH3XEJGV.js → server-OXKBXSET.js} +17 -8
package/dist/{start-VJJXI4W3.js → start-BZJZSQHW.js} +4 -2
package/package.json +2 -1
package/dist/server-ODH3M2IG.js +0 -9

package/dist/{build-QRHQUUZC.js → build-MFLFMGGZ.js} RENAMED Viewed

@@ -5,7 +5,8 @@ import {
   renderIslandsPage,
   renderPage,
   scanPages
-} from "./chunk-PAMD24NK.js";
+} from "./chunk-D3VZDJ3R.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-PAMD24NK.js → chunk-D3VZDJ3R.js} RENAMED Viewed

@@ -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,71 @@ 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)
   });
   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)
   });
   return opts.transformHtml ? opts.transformHtml(opts.url, doc) : doc;
 }
-function shell({ body, island, css, pageId, clientHref }) {
+function shell({ body, island, css, pageId, clientHref, storeIds = [] }) {
+  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)}
+${storeImports ? `${storeImports}
+` : ""}  import ${JSON.stringify(pageId)}
   window.Alpine = Alpine
-  Alpine.start()
+${storeRegs ? `${storeRegs}
+` : ""}  Alpine.start()
 </script>`;
   return `<!DOCTYPE html>
 <html lang="en">
@@ -167,5 +208,6 @@ export {
   renderIslandsPage,
   scanPages,
   matchRoute,
+  loadStores,
   renderPage
 };

package/dist/chunk-HRJTOSYH.js ADDED Viewed

@@ -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} RENAMED Viewed

@@ -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 ADDED Viewed

@@ -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} RENAMED Viewed

@@ -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/cli.js CHANGED Viewed

@@ -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-4LINTKZH.js").then((m) => m.makeCommand),
+    dev: () => import("./dev-FS4VVUX2.js").then((m) => m.devCommand),
+    build: () => import("./build-MFLFMGGZ.js").then((m) => m.buildCommand),
+    start: () => import("./start-BZJZSQHW.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-FS4VVUX2.js} RENAMED Viewed

@@ -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-OXKBXSET.js");
       const { port: actual } = await startDevServer({ root, port, islands: Boolean(args.islands) });
       sp.succeed("Dev server ready");
       ready([

package/dist/index.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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-4LINTKZH.js → make-62PPHZQY.js} RENAMED Viewed

@@ -2,6 +2,9 @@
 import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { dirname, join, resolve } from "path";
 import { defineCommand } from "citty";
+function pascalCase(s) {
+  return s.replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : "").replace(/^(.)/, (c) => c.toUpperCase());
+}
 function pageTemplate(name) {
   return `<script server lang="ts">
   export function loader() {
@@ -30,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'
@@ -49,23 +64,25 @@ function plan(kind, name, root) {
     case "page":
       return { path: join(root, "pages", `${name}.alpine`), contents: pageTemplate(name) };
     case "component":
-      return { path: join(root, "components", `${name}.alpine`), contents: componentTemplate() };
+      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-OXKBXSET.js} RENAMED Viewed

@@ -5,13 +5,16 @@ 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-D3VZDJ3R.js";
+import "./chunk-MZVLRU3R.js";
 // src/dev/server.ts
 import { createServer as createHttpServer } from "http";
@@ -39,11 +42,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,7 +158,11 @@ 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 vite = await createViteServer({
@@ -193,6 +201,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 +210,7 @@ async function startDevServer(options) {
           url,
           registry,
           componentCss,
+          stores,
           transformHtml: (u, doc) => vite.transformIndexHtml(u, doc)
         });
         setResponseHeader(event, "Content-Type", "text/html");
@@ -233,7 +243,6 @@ async function startDevServer(options) {
     }
   };
 }
 export {
   startDevServer
 };

package/dist/{start-VJJXI4W3.js → start-BZJZSQHW.js} RENAMED Viewed

@@ -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-D3VZDJ3R.js";
+import "./chunk-MZVLRU3R.js";
 // src/commands/start.ts
 import { existsSync as existsSync2 } from "fs";

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@apex-stack/core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "The full-stack meta-framework for Alpine.js — CLI and runtime",
   "type": "module",
   "license": "MIT",
@@ -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 DELETED Viewed

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