@mauroandre/velojs 0.0.43 → 0.0.45

package/agent/skills/velojs-loaders/SKILL.md

@@ -127,8 +127,10 @@ Understanding the data flow helps you debug issues:
 
 **Client-side navigation (SPA):**
 1. User clicks a link
-2. VeloJS compares each module's route pattern against the new URL and marks stale the ones whose **declared params** changed
+2. VeloJS marks stale the modules whose **declared params** changed — or that **were not part of the previous location** (they unmounted and are remounting now)
 3. One `?_data=1` request serves all of them
 4. Only the stale modules are written — a module the client owns locally (a filtered list, an optimistic edit) is left alone
 
-That last point is why a layout at `/admin/empresas` keeps a filtered list while you navigate among its children: its route declares no param, so nothing invalidates it.
+The second rule is why returning to a page always shows fresh data: leaving `/` for `/leads` unmounts the Dashboard, so navigating back re-runs its loader. The first rule is why `/leads/1` → `/leads/2` refetches.
+
+That last point is why a layout at `/admin/empresas` keeps a filtered list while you navigate among its children: it stays matched the whole time — no param changed and it never unmounted, so nothing invalidates it. (Leaving the subtree entirely and coming back *does* revalidate it — the layout remounted.)

package/dist/cli.js

@@ -1,43 +1,43 @@
-import { spawnSync as c } from "node:child_process";
+import { spawnSync as a } from "node:child_process";
 import { join as n, resolve as u } from "node:path";
 import p from "node:fs";
-const o = process.argv.slice(2), a = o[0], v = (e, s = []) => {
-  const t = c(e, s, {
+const t = process.argv.slice(2), c = t[0], v = (s, e = []) => {
+  const o = a(s, e, {
     stdio: "inherit",
     cwd: process.cwd()
   });
-  process.exit(t.status ?? 0);
+  process.exit(o.status ?? 0);
 }, m = () => {
-  v("npx", ["vite", ...o.slice(1)]);
-}, j = (e) => {
-  const s = Date.now().toString(36), t = {
+  v("npx", ["vite", ...t.slice(1)]);
+}, f = (s) => {
+  const e = Date.now().toString(36), o = {
     ...process.env,
-    VELO_BUILD_HASH: s,
-    ...e ? { VELO_STATIC: "1" } : {}
+    VELO_BUILD_HASH: e,
+    ...s ? { VELO_STATIC: "1" } : {}
   };
   console.log("Building client...");
-  const r = c("npx", ["vite", "build"], {
+  const r = a("npx", ["vite", "build"], {
     stdio: "inherit",
     cwd: process.cwd(),
-    env: t
+    env: o
   });
   r.status !== 0 && (console.error("Client build failed. Aborting."), process.exit(r.status ?? 1)), console.log("Building server...");
-  const i = c("npx", ["vite", "build", "--mode", "server"], {
+  const i = a("npx", ["vite", "build", "--mode", "server"], {
     stdio: "inherit",
     cwd: process.cwd(),
-    env: t
+    env: o
   });
-  i.status !== 0 && (console.error("Server build failed. Aborting."), process.exit(i.status ?? 1)), console.log("Build complete!"), e && b();
-}, b = async () => {
+  i.status !== 0 && (console.error("Server build failed. Aborting."), process.exit(i.status ?? 1)), console.log("Build complete!"), s && j();
+}, j = async () => {
   process.env.NODE_ENV = "production", process.env.VELO_STATIC = "1";
-  const s = await import(u(process.cwd(), "dist/server.js")), t = s.default, r = s.routes;
-  (!t || !r) && (console.error("Failed to load app or routes from dist/server.js"), process.exit(1));
+  const e = await import(u(process.cwd(), "dist/server.js")), o = e.default, r = e.routes;
+  (!o || !r) && (console.error("Failed to load app or routes from dist/server.js"), process.exit(1));
   const { generateStatic: i } = await import("./static.js");
-  await i(t, r);
-}, f = () => {
+  await i(o, r);
+}, b = () => {
   process.env.NODE_ENV = "production";
-  const e = u(process.cwd(), "dist/server.js");
-  v("node", [e]);
+  const s = u(process.cwd(), "dist/server.js");
+  v("node", [s]);
 }, d = () => {
   console.log(`
 VeloJS CLI
@@ -46,7 +46,7 @@ Usage:
   velojs <command>
 
 Commands:
-  init             Create a new VeloJS project
+  init             Create a new VeloJS project (fails only on file conflicts; --force overwrites)
   dev              Start development server
   build            Build for production (client + server)
   build --static   Build as static site (HTML + JSON)
@@ -65,30 +65,35 @@ Examples:
   velojs graph --view
 `);
 };
-switch (a) {
+switch (c) {
   case "init": {
-    const { runInit: e } = await import("./init.js");
-    await e(o[1]);
+    const { runInit: s } = await import("./init.js");
+    try {
+      const e = t[1] && !t[1].startsWith("-") ? t[1] : void 0;
+      await s(e, { force: t.includes("--force") });
+    } catch (e) {
+      console.error(e.message), process.exit(1);
+    }
     break;
   }
   case "dev":
     m();
     break;
   case "build": {
-    const e = o.includes("--static");
-    j(e);
+    const s = t.includes("--static");
+    f(s);
     break;
   }
   case "start":
-    f();
+    b();
     break;
   case "graph": {
-    const { buildGraph: e } = await import("./graph.js"), s = process.cwd(), t = o[1] && !o[1].startsWith("-") ? o[1] : null, r = n(s, t ?? "app"), i = e(r), l = n(s, ".velojs");
+    const { buildGraph: s } = await import("./graph.js"), e = process.cwd(), o = t[1] && !t[1].startsWith("-") ? t[1] : null, r = n(e, o ?? "app"), i = s(r), l = n(e, ".velojs");
     p.mkdirSync(l, { recursive: !0 });
-    const w = n(l, "graph.json");
-    if (p.writeFileSync(w, JSON.stringify(i)), console.log("Graph written to .velojs/graph.json"), o.includes("--view")) {
-      const { serveGraphViewer: g } = await import("./graph-viewer.js"), h = await g(s);
-      console.log(`Graph viewer running at ${h} (Ctrl+C to stop)`);
+    const g = n(l, "graph.json");
+    if (p.writeFileSync(g, JSON.stringify(i)), console.log("Graph written to .velojs/graph.json"), t.includes("--view")) {
+      const { serveGraphViewer: h } = await import("./graph-viewer.js"), w = await h(e);
+      console.log(`Graph viewer running at ${w} (Ctrl+C to stop)`);
     }
     break;
   }
@@ -98,5 +103,5 @@ switch (a) {
     d();
     break;
   default:
-    a && console.error(`Unknown command: ${a}`), d(), process.exit(1);
+    c && console.error(`Unknown command: ${c}`), d(), process.exit(1);
 }

package/dist/init.d.ts

@@ -1 +1,3 @@
-export declare function runInit(dirName?: string): Promise<void>;
+export declare function runInit(dirName?: string, opts?: {
+    force?: boolean;
+}): Promise<void>;

package/dist/init.js

@@ -1,12 +1,12 @@
-import t from "node:fs";
-import s from "node:path";
-import { fileURLToPath as d } from "node:url";
-const i = "@mauroandre/velojs";
-function m() {
-  const o = s.dirname(d(import.meta.url)), e = s.resolve(o, "../package.json");
-  return JSON.parse(t.readFileSync(e, "utf-8")).version;
+import e from "node:fs";
+import o from "node:path";
+import { fileURLToPath as x } from "node:url";
+const r = "@mauroandre/velojs";
+function v() {
+  const n = o.dirname(x(import.meta.url)), p = o.resolve(n, "../package.json");
+  return JSON.parse(e.readFileSync(p, "utf-8")).version;
 }
-const u = {
+const g = {
   ".gitignore": `# Dependencies
 node_modules/
 
@@ -26,7 +26,7 @@ dist/
         "start": "velojs start"
     },
     "dependencies": {
-        "${i}": "^${m()}"
+        "${r}": "^${v()}"
     },
     "devDependencies": {
         "@types/node": "latest",
@@ -34,7 +34,7 @@ dist/
     }
 }
 `,
-  "vite.config.ts": `import { veloPlugin } from "${i}/vite";
+  "vite.config.ts": `import { veloPlugin } from "${r}/vite";
 
 export default { plugins: [veloPlugin()] };
 `,
@@ -59,7 +59,7 @@ export default { plugins: [veloPlugin()] };
     "exclude": ["node_modules", "dist"]
 }
 `,
-  "app/routes.tsx": `import type { AppRoutes } from "${i}";
+  "app/routes.tsx": `import type { AppRoutes } from "${r}";
 
 import * as Root from "./client-root.js";
 import * as Home from "./pages/Home.js";
@@ -79,11 +79,11 @@ export default [
 `,
   "app/server.tsx": `// Server initialization
 // Use this file to set up server-side logic:
-//   import { addRoutes, onServer } from "${i}/server";
+//   import { addRoutes, onServer } from "${r}/server";
 `,
   "app/client.tsx": `import "./styles/global.css";
 `,
-  "app/client-root.tsx": `import { Scripts } from "${i}";
+  "app/client-root.tsx": `import { Scripts } from "${r}";
 
 interface RootProps {
     children: preact.ComponentChildren;
@@ -147,25 +147,39 @@ a:hover {
 };
 `
 };
-async function x(o) {
-  const e = o ? s.resolve(process.cwd(), o) : process.cwd(), n = s.basename(e);
-  t.existsSync(e) ? t.readdirSync(e).filter(
-    (r) => !r.startsWith(".") && r !== "node_modules"
-  ).length > 0 && (console.error(
-    `Error: Directory "${n}" is not empty. Use an empty directory.`
-  ), process.exit(1)) : t.mkdirSync(e, { recursive: !0 });
-  for (const [a, r] of Object.entries(u)) {
-    const p = s.join(e, a), l = s.dirname(p);
-    t.existsSync(l) || t.mkdirSync(l, { recursive: !0 });
-    const c = a === "package.json" ? r.replace("my-velojs-app", n) : r;
-    t.writeFileSync(p, c);
+async function b(n, p) {
+  const s = n ? o.resolve(process.cwd(), n) : process.cwd(), a = o.basename(s);
+  e.existsSync(s) || e.mkdirSync(s, { recursive: !0 });
+  const d = Object.keys(g).filter(
+    (t) => t !== ".gitignore" && e.existsSync(o.join(s, t))
+  );
+  if (d.length > 0 && !p?.force)
+    throw new Error(
+      `Cannot init in "${a}": these files already exist and would be overwritten:
+` + d.map((t) => `  ${t}`).join(`
+`) + "\nMove them away, or run `velojs init --force` to overwrite."
+    );
+  for (const [t, l] of Object.entries(g)) {
+    const i = o.join(s, t), m = o.dirname(i);
+    if (e.existsSync(m) || e.mkdirSync(m, { recursive: !0 }), t === ".gitignore" && e.existsSync(i)) {
+      const h = e.readFileSync(i, "utf-8"), u = l.split(`
+`).filter((c) => c && !c.startsWith("#") && !h.includes(c));
+      u.length > 0 && e.appendFileSync(i, `
+# VeloJS
+${u.join(`
+`)}
+`);
+      continue;
+    }
+    const f = t === "package.json" ? l.replace("my-velojs-app", a) : l;
+    e.writeFileSync(i, f);
   }
   console.log(`
-Project created in ${o ? n : "current directory"}!
+Project created in ${n ? a : "current directory"}!
 `), console.log(`Next steps:
-`), o && console.log(`  cd ${n}`), console.log("  npm install"), console.log(`  npx velojs dev
+`), n && console.log(`  cd ${a}`), console.log("  npm install"), console.log(`  npx velojs dev
 `);
 }
 export {
-  x as runInit
+  b as runInit
 };

package/dist/loader-store.d.ts

@@ -7,9 +7,12 @@
  * no module-scope mirror to keep in sync.
  *
  * Invalidation follows the route tree: an entry is stale when the params its own
- * route declares have changed. That is what the server already does — a loader
- * re-runs when a request arrives with different params — so the client stops
- * making the author restate it in `useLoader([params.id])`.
+ * route declares have changed — or when the module was not part of the previous
+ * location's matched chain (it unmounted and is now remounting). The first rule
+ * mirrors the server (a loader re-runs when a request arrives with different
+ * params); the second mirrors user expectation (returning to a page shows fresh
+ * data). A layout keeps its data while navigating among its children because it
+ * stays matched the whole time — its client-owned state survives.
  *
  * Deliberately NOT invalidated by:
  *  - a query-string change: `routes.tsx` declares path params, never `?x=`, so
@@ -32,14 +35,16 @@ export declare function registerRoutePatterns(routes: AppRoutes): void;
 /**
  * Extract the params a pattern declares from a pathname. Layout patterns are
  * prefixes of the URL (`/x/:id` covers `/x/1/tab`), mirroring how the client
- * router matches them, so the match is prefix-tolerant.
+ * router matches them, so the match is prefix-tolerant. Leaf patterns (routes
+ * without children) match exactly, mirroring wouter's exact `<Route>` for them.
  *
  * Returns null when the pattern does not cover the pathname at all.
  */
-export declare function extractParams(pattern: string, pathname: string): Record<string, string> | null;
+export declare function extractParams(pattern: string, pathname: string, exact?: boolean): Record<string, string> | null;
 /**
  * Called on every client navigation. Refetches exactly the entries whose
- * declared params changed, in one coalesced request.
+ * declared params changed OR that were not matched at the previous location
+ * (they unmounted and are remounting now), in one coalesced request.
  */
 export declare function syncLocation(pathname: string): void;
 /** Explicit refresh. Never coalesced: a caller asking after a mutation must not

package/dist/loader-store.js

@@ -1,103 +1,119 @@
-import { signal as f } from "@preact/signals";
-const p = f(!1), c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new WeakSet();
-let u = !1;
-function S(t) {
-  y();
+import { signal as d } from "@preact/signals";
+const S = d(!1), c = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Set(), p = /* @__PURE__ */ new Map();
+let u = /* @__PURE__ */ new Set();
+const l = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new WeakSet();
+let w = !1;
+function E(t) {
+  v();
   let e = c.get(t);
-  return e || (e = f(null), c.set(t, e)), e;
+  return e || (e = d(null), c.set(t, e)), e;
 }
-function w(t) {
-  let e = l.get(t);
-  return e || (e = f(!1), l.set(t, e)), e;
+function g(t) {
+  let e = _.get(t);
+  return e || (e = d(!1), _.set(t, e)), e;
 }
-function y() {
-  if (u || typeof window > "u") return;
-  u = !0;
+function v() {
+  if (w || typeof window > "u") return;
+  w = !0;
   const t = window.__PAGE_DATA__;
   if (t)
     for (const e of Object.keys(t)) {
       if (e.startsWith("__")) continue;
       let n = c.get(e);
-      n || (n = f(null), c.set(e, n)), n.value = t[e];
+      n || (n = d(null), c.set(e, n)), n.value = t[e];
     }
 }
-function O(t) {
-  if (h.has(t)) return;
-  h.add(t);
+function x(t) {
+  if (y.has(t)) return;
+  y.add(t);
   const e = (n) => {
     for (const o of n) {
       const i = o.module?.metadata;
-      i?.moduleId && i.fullPath !== void 0 && d.set(i.moduleId, i.fullPath), o.children && e(o.children);
+      i?.moduleId && i.fullPath !== void 0 && (f.set(i.moduleId, i.fullPath), (!o.children || o.children.length === 0) && h.add(i.moduleId)), o.children && e(o.children);
     }
   };
   if (e(t), typeof window < "u") {
-    y();
-    for (const n of c.keys()) v(n, window.location.pathname);
+    v();
+    for (const n of c.keys()) M(n, window.location.pathname);
+    u = L(window.location.pathname);
   }
 }
-const k = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-function E(t, e) {
-  const n = [], o = t.split("/").map((r) => r.startsWith(":") ? (n.push(r.slice(1)), "([^/]+)") : k(r)).join("/"), i = e.match(new RegExp(`^${o}(?:/.*)?$`));
-  if (!i) return null;
-  const a = {};
-  return n.forEach((r, L) => {
-    a[r] = i[L + 1];
-  }), a;
+const P = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function m(t, e, n = !1) {
+  const o = [], i = t.split("/").map((s) => s.startsWith(":") ? (o.push(s.slice(1)), "([^/]+)") : P(s)).join("/"), a = e.match(
+    new RegExp(n ? `^${i}/?$` : `^${i}(?:/.*)?$`)
+  );
+  if (!a) return null;
+  const r = {};
+  return o.forEach((s, A) => {
+    r[s] = a[A + 1];
+  }), r;
 }
-function g(t, e) {
-  const n = d.get(t);
+function O(t, e) {
+  const n = f.get(t);
+  return n === void 0 ? !1 : m(n, e, h.has(t)) !== null;
+}
+function L(t) {
+  const e = /* @__PURE__ */ new Set();
+  for (const n of f.keys())
+    O(n, t) && e.add(n);
+  return e;
+}
+function k(t, e) {
+  const n = f.get(t);
   if (n === void 0) return null;
-  const o = E(n, e);
+  const o = m(n, e, h.has(t));
   return o === null ? null : JSON.stringify(o);
 }
-function v(t, e) {
-  const n = g(t, e);
-  n !== null && _.set(t, n);
+function M(t, e) {
+  const n = k(t, e);
+  n !== null && p.set(t, n);
 }
-function P(t) {
+function H(t) {
   if (typeof __VELO_STATIC__ < "u" && __VELO_STATIC__) return `${t === "/" ? "" : t}/index.json`;
   const n = new URLSearchParams(window.location.search);
   return n.set("_data", "1"), `${t}?${n.toString()}`;
 }
-async function m(t, e, n) {
+async function $(t, e, n) {
   if (typeof window > "u" || t.length === 0) return;
-  const o = P(e);
-  for (const a of t) w(a).value = !0;
-  let i = n ? s.get(o) : void 0;
-  i || (i = fetch(o, { cache: "no-cache" }).then((a) => a.json()), n && (s.set(o, i), i.catch(() => {
-  }).then(() => s.delete(o))));
+  const o = H(e);
+  for (const a of t) g(a).value = !0;
+  let i = n ? l.get(o) : void 0;
+  i || (i = fetch(o, { cache: "no-cache" }).then((a) => a.json()), n && (l.set(o, i), i.catch(() => {
+  }).then(() => l.delete(o))));
   try {
     const a = await i;
-    typeof __VELO_BUILD_HASH__ < "u" && a.__buildHash && a.__buildHash !== __VELO_BUILD_HASH__ && (p.value = !0);
+    typeof __VELO_BUILD_HASH__ < "u" && a.__buildHash && a.__buildHash !== __VELO_BUILD_HASH__ && (S.value = !0);
     for (const r of t)
-      r in a && (S(r).value = a[r], v(r, e));
+      r in a && (E(r).value = a[r], M(r, e));
   } catch {
   } finally {
-    for (const a of t) w(a).value = !1;
+    for (const a of t) g(a).value = !1;
   }
 }
-function $(t) {
+function T(t) {
   if (typeof window > "u") return;
-  const e = [];
-  for (const n of c.keys()) {
-    const o = g(n, t);
-    o !== null && _.get(n) !== o && e.push(n);
+  const e = [], n = L(t);
+  for (const o of c.keys()) {
+    if (!n.has(o)) continue;
+    const i = k(o, t);
+    p.get(o) === i && u.has(o) || e.push(o);
   }
-  m(e, t, !0);
+  u = n, $(e, t, !0);
 }
-function H(t) {
-  typeof window > "u" || m([t], window.location.pathname, !1);
+function U(t) {
+  typeof window > "u" || $([t], window.location.pathname, !1);
 }
-function M() {
-  c.clear(), l.clear(), d.clear(), _.clear(), s.clear(), u = !1, p.value = !1;
+function D() {
+  c.clear(), _.clear(), f.clear(), h.clear(), p.clear(), u = /* @__PURE__ */ new Set(), l.clear(), w = !1, S.value = !1;
 }
 export {
-  M as __resetLoaderStore,
-  p as __veloUpdatePending,
-  E as extractParams,
-  S as loaderEntry,
-  w as loaderLoading,
-  H as refetchModule,
-  O as registerRoutePatterns,
-  $ as syncLocation
+  D as __resetLoaderStore,
+  S as __veloUpdatePending,
+  m as extractParams,
+  E as loaderEntry,
+  g as loaderLoading,
+  U as refetchModule,
+  x as registerRoutePatterns,
+  T as syncLocation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mauroandre/velojs",
-    "version": "0.0.43",
+    "version": "0.0.45",
     "type": "module",
     "description": "Fullstack web framework built on Hono + Preact with Vite-powered AST transforms",
     "keywords": [