@voltro/cli 0.52.0 → 0.54.0

package/dist/codegen-CctkDO-1.js

@@ -1,2 +0,0 @@
-import { t as e } from "./codegen-VF479Cnb.js";
-export { e as checkRpcGroupFreshness };

package/dist/codegenCommand-DCdG2JN-.js

@@ -1,137 +0,0 @@
-import { Cn as e, Sn as t, V as n, l as r, u as i } from "./dev-CRHoCEiy.js";
-import { Ct as a } from "./webDev-BgWL9gKV.js";
-import { n as o } from "./frameworkTableAssembly-w-XnLa3q.js";
-import { i as s, r as c } from "./codegen-VF479Cnb.js";
-import { basename as l, join as u, relative as d, resolve as f } from "node:path";
-import { promises as p } from "node:fs";
-import { pathToFileURL as m } from "node:url";
-//#region src/mobileCodegen.ts
-var h = "voltro.mobile.ts", g = u(".framework", "mobileApis.generated.ts"), _ = (e) => e.replace(/[^a-zA-Z0-9]/g, "_"), v = async (e) => {
-	let t = u(e, h);
-	try {
-		await p.stat(t);
-	} catch {
-		return { present: !1 };
-	}
-	try {
-		let e = (await import(`${m(t).href}?t=${Date.now()}`)).default;
-		return e === void 0 || typeof e != "object" || e.apis === void 0 ? {
-			present: !0,
-			error: /* @__PURE__ */ Error(`${h} has no default export with an \`apis\` map`)
-		} : {
-			present: !0,
-			binding: e
-		};
-	} catch (e) {
-		return {
-			present: !0,
-			error: e instanceof Error ? e : Error(String(e))
-		};
-	}
-}, y = (e, t) => {
-	let n = t.filter(([, e]) => e.package !== void 0).map(([e, t]) => {
-		let n = `${_(e)}Group`, r = `${_(e)}Descriptors`;
-		return `import { ${n === "appGroup" ? "appGroup" : `appGroup as ${n}`}, ${r === "appDescriptors" ? "appDescriptors" : `appDescriptors as ${r}`} } from '${t.package}/rpcGroup'`;
-	}), r = t.map(([e, t]) => t.package === void 0 ? `  // ${JSON.stringify(e)}: declared with \`url\` only — no local rpc surface to import.\n  //   Add \`package: '<the api package>'\` to ${h} to get typed hooks for it.` : `  { ${[
-		`name: ${JSON.stringify(e)}`,
-		`group: ${_(e)}Group`,
-		`descriptors: ${_(e)}Descriptors`,
-		`wsUrl: wsUrl(${JSON.stringify(e)})`
-	].join(", ")} },`), i = t.filter(([, e]) => e.url !== void 0).map(([e, t]) => `  ${JSON.stringify(e)}: ${JSON.stringify(t.url)},`);
-	return [
-		"// GENERATED BY `voltro codegen` — do not edit; regenerate with `voltro codegen`.",
-		"//",
-		`// The api bindings declared in ${h}. Only the BINDING is`,
-		"// generated: the procedure types ride the imports below, so a schema change",
-		"// in an api needs no regeneration here.",
-		"",
-		...n,
-		"import type { MobileApiBinding } from '@voltro/react-native'",
-		"",
-		"/** Every api this app talks to, bound to a runtime-resolved ws URL.",
-		" *",
-		" * The URL is a parameter because it differs per environment and `localhost`",
-		" * on a device is the DEVICE — see `resolveDevWsUrl` in @voltro/react-native. */",
-		"export const mobileApis = (",
-		"  wsUrl: (apiName: string) => string,",
-		"): ReadonlyArray<MobileApiBinding> => [",
-		...r,
-		"]",
-		"",
-		"/** Api names in declaration order — the keys the hooks bind to. */",
-		`export const MOBILE_API_NAMES = [${t.map(([e]) => JSON.stringify(e)).join(", ")}] as const`,
-		...i.length > 0 ? [
-			"",
-			`/** URLs declared in ${h} for apis this app does not build. */`,
-			"export const MOBILE_API_URLS: Readonly<Record<string, string>> = {",
-			...i,
-			"}"
-		] : [],
-		""
-	].join("\n");
-}, b = async (e) => {
-	let t = f(e), n = await v(t);
-	if (!n.present) return { kind: "not-a-mobile-app" };
-	if ("error" in n) return {
-		kind: "refused",
-		reason: `${h} could not be loaded — ${n.error.message}`
-	};
-	let r = Object.entries(n.binding.apis);
-	if (r.length === 0) return {
-		kind: "refused",
-		reason: `${h} declares no apis`
-	};
-	for (let [e, t] of r) if (t.package === void 0 && t.url === void 0) return {
-		kind: "refused",
-		reason: `api ${JSON.stringify(e)} declares neither \`package\` nor \`url\``
-	};
-	for (let [e, n] of r) if (n.package !== void 0 && await a(t, n.package) === null) return {
-		kind: "refused",
-		reason: `api ${JSON.stringify(e)}: ${n.package} is not a workspace dependency of this app. Add it to the app's package.json (\`"${n.package}": "workspace:*"\`) and install.`
-	};
-	let i = u(t, g), o = y(t, r);
-	await p.mkdir(u(t, ".framework"), { recursive: !0 });
-	let s = null;
-	try {
-		s = await p.readFile(i, "utf8");
-	} catch {}
-	return s !== o && await p.writeFile(i, o, "utf8"), {
-		kind: "wrote",
-		file: i,
-		apis: r.map(([e]) => e)
-	};
-}, x = (e, t) => t.kind === "wrote" ? `voltro codegen: wrote ${d(e, t.file)} (apis ${t.apis.join(", ")})` : t.kind === "refused" ? `voltro codegen: ${t.reason} — refusing to write.` : `voltro codegen: no ${h} here — not a mobile app.`, S = async (t) => {
-	let { config: i, present: a, error: o } = await r(t);
-	if (a && i === null) return {
-		kind: "refused",
-		reason: "app.config.ts exists but could not be loaded" + (o === void 0 ? "" : ` — ${o instanceof Error ? o.message : String(o)}`)
-	};
-	let s = i?.plugins ?? [], { pluginContributions: u, pluginErrorImports: d, pluginRpcImports: f } = await n(s, i?.name ?? l(t), t), p = await c({
-		root: t,
-		...u.length > 0 ? { pluginContributions: u } : {},
-		...d.length > 0 ? { pluginErrorImports: d } : {},
-		...f.length > 0 ? { pluginRpcImports: f } : {},
-		...i?.name === void 0 ? {} : { apiName: i.name }
-	});
-	if (!p) return { kind: "nothing-to-write" };
-	let m = await C(t, i), h = await e(p, m);
-	return {
-		kind: "wrote",
-		file: p,
-		plugins: s.length,
-		errorSchemas: d.length,
-		routes: f.length,
-		tables: m.size,
-		dts: h
-	};
-}, C = async (e, n) => {
-	let r = await s(e), { tables: a } = await i(r), c = await o({ root: e });
-	return t(a, c, n?.analytics?.tables ?? []);
-}, w = async (e) => {
-	let t = f(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await b(t);
-	if (n.kind !== "not-a-mobile-app") return console.log(x(t, n)), n.kind === "wrote" ? 0 : 1;
-	let r = await S(t);
-	return r.kind === "refused" ? (console.error(`voltro codegen: ${r.reason} — refusing to write.`), console.error("  The generated file would omit every plugin's error union and client routes, and would typecheck, so the omission would only surface as a missing error tag at runtime."), 1) : r.kind === "nothing-to-write" ? (console.log("voltro codegen: no rpc primitives found — nothing to write."), 0) : (console.log(`voltro codegen: wrote ${d(t, r.file)} (plugins ${r.plugins}, error schemas ${r.errorSchemas}, plugin routes ${r.routes})`), console.log(r.dts.action === "removed" ? `  removed ${d(t, r.dts.path)} — no tables declared, so \`source:\` is \`string\` again` : r.dts.action === "skipped" ? "  no tables declared — `source:` stays `string`" : `  ${r.dts.action} ${d(t, r.dts.path)} (${r.tables} table name(s) typed for \`source:\`)`), r.plugins > 0 && r.errorSchemas === 0 && console.log("  note: no plugin contributed a cross-cutting error schema, so the wire error union carries only each procedure's own `error:`. Expected if none of your plugins declare `errorSchemas` — but `guards:` needs @voltro/plugin-rbac for its ScopeError to decode typed."), 0);
-};
-//#endregion
-export { S as regenerateRpcGroup, w as runCodegenCommand };

package/dist/dbCommand-DNb6yeOG.js

@@ -1,2 +0,0 @@
-import { s as e } from "./dbCommand-sHedr-NJ.js";
-export { e as runDbCommand };

package/dist/doctorCommand-CqoWA2p5.js

@@ -1,2 +0,0 @@
-import { b as e, y as t } from "./doctorCommand-DtfJ3FA6.js";
-export { t as runDoctorCommand, e as runServePreflight };

package/dist/fileConventions-DOqD3lPS.js

@@ -1,34 +0,0 @@
-//#region src/fileConventions.ts
-var e = /\.(query|mutation|action|stream)\.ts$/, t = /\.(query|mutation|action|stream)\.server\.ts$/, n = /\.event\.ts$/, r = /\.ws\.ts$/, i = /\.workflow\.tsx$/, a = /\.workflow\.server\.tsx$/, o = /\.workflow\.tsx?$/, s = /\.trigger\.tsx?$/, c = /\.cron\.tsx?$/, l = /\.webhook\.tsx?$/, u = /\.outbox\.tsx?$/, d = /\.subscribe\.tsx?$/, f = /\.reaction\.tsx?$/, p = /\.aggregate\.tsx?$/, m = /\.expectation\.ts$/, h = /\.budget\.ts$/, g = /\.experiment\.ts$/, _ = /\.startup\.tsx?$/, v = /\.seed\.ts$/, y = /\.relations\.ts$/, b = /\.entity\.ts$|\.schema\.ts$|^schema\.ts$/, x = (e) => o.test(e) && !i.test(e) && !a.test(e), S = /(?:^|\/)page\.tsx$/, C = /\.island\.tsx?$/, w = /\.component\.tsx$/, T = /\.component\.ui\.tsx$/, E = /\.hook\.tsx?$/, D = /\.internal\.tsx?$/, O = /\.types\.tsx?$/, k = /\.fixture\.tsx?$/, A = /\.tracking\.tsx?$/, j = /\.store\.tsx?$/, M = /\.client\.tsx?$/, N = /\.(test|spec)\.tsx?$/, P = [
-	e,
-	t,
-	o,
-	a,
-	s,
-	c,
-	l,
-	u,
-	d,
-	f,
-	p,
-	_,
-	m,
-	h,
-	g,
-	v,
-	y,
-	b,
-	/\.route\.tsx?$/,
-	n,
-	r,
-	j,
-	M,
-	/\.(agent|tool|email|connection|serverless|server|config|generated)\.tsx?$/
-], F = (e) => P.some((t) => t.test(e)), I = /* @__PURE__ */ new Set([
-	"layout.tsx",
-	"error.tsx",
-	"loading.tsx",
-	"not-found.tsx"
-]);
-//#endregion
-export { i as A, j as C, s as D, A as E, x as F, a as M, r as N, O, F as P, _ as S, N as T, t as _, c as a, b, g as c, D as d, C as f, e as g, I as h, T as i, o as j, l as k, k as l, S as m, h as n, n as o, u as p, w as r, m as s, p as t, E as u, f as v, d as w, v as x, y };

package/dist/frameworkTableAssembly-C6ETawPR.js

@@ -1,2 +0,0 @@
-import { c as e, n as t } from "./frameworkTableAssembly-w-XnLa3q.js";
-export { t as assembleFrameworkTables, e as loadAppSchemaInputs };

package/dist/inspect-CuGDYES0.js

@@ -1,2 +0,0 @@
-import { r as e } from "./inspect-CtL_xTbu.js";
-export { e as buildCapabilityManifest };

package/dist/manifestBuild-CPjhvM62.js

@@ -1,2 +0,0 @@
-import { t as e } from "./manifestBuild-CuU1VrSm.js";
-export { e as buildRpcEntry };

package/dist/renderModeScan-CcH2X1_D.js

@@ -1,120 +0,0 @@
-import { join as e } from "node:path";
-import { readFile as t } from "node:fs/promises";
-//#region src/isrCache.ts
-var n = () => {
-	let e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Map(), n = (e) => {
-		t.set(e, (t.get(e) ?? 0) + 1);
-	};
-	return {
-		get(t) {
-			return e.get(t);
-		},
-		set(n, r, i) {
-			return i?.ifGeneration !== void 0 && (t.get(n) ?? 0) !== i.ifGeneration ? !1 : (e.set(n, r), !0);
-		},
-		generation(e) {
-			return t.get(e) ?? 0;
-		},
-		invalidate(t) {
-			e.delete(t), n(t);
-		},
-		invalidateBy(t) {
-			let r = 0;
-			for (let i of e.keys()) t(i) && (e.delete(i), n(i), r++);
-			return r;
-		},
-		clear() {
-			for (let t of e.keys()) n(t);
-			e.clear();
-		},
-		size() {
-			return e.size;
-		},
-		snapshot() {
-			return Array.from(e.entries());
-		}
-	};
-}, r = (e) => {
-	if (typeof e == "number" && Number.isFinite(e) && e > 0) return e * 1e3;
-	if (typeof e != "string") return null;
-	let t = /^\s*(\d+)\s*(s|seconds?|m|minutes?|h|hours?|d|days?)\s*$/i.exec(e);
-	if (!t) return null;
-	let n = parseInt(t[1], 10);
-	if (!Number.isFinite(n) || n <= 0) return null;
-	let r = t[2].toLowerCase();
-	return r === "s" || r.startsWith("second") ? n * 1e3 : r === "m" || r.startsWith("minute") ? n * 6e4 : r === "h" || r.startsWith("hour") ? n * 36e5 : r === "d" || r.startsWith("day") ? n * 864e5 : null;
-}, i = (e, t = {}) => {
-	let n = [e];
-	return t.tenant !== void 0 && t.tenant !== "" && n.push(`tenant=${t.tenant}`), t.locale !== void 0 && t.locale !== "" && n.push(`lang=${t.locale}`), n.join("|");
-}, a = (e, t) => e.expiresAt > t, o = (e, t) => e.expiresAt <= t && e.servableUntil > t, s = [
-	"static",
-	"spa",
-	"ssr",
-	"isr"
-], c = (e) => typeof e == "string" && s.includes(e), l = s.map((e) => `'${e}'`).join(" | "), u = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${l}.${t === "client" || t === "csr" || t === "browser" ? "\n  A page that renders only in the browser is 'spa': it is skipped by the prerender and mounts on the client. If its route has a layout, that layout still renders server-side as an SSR shell." : t === "server" || t === "dynamic" ? "\n  A page rendered per request is 'ssr'." : t === "ssg" || t === "prerender" ? "\n  A page rendered once at build time is 'static' (the default)." : ""}`, d = class extends Error {
-	page;
-	value;
-	name = "InvalidRenderModeError";
-	constructor(e, t) {
-		super(u(e, t)), this.page = e, this.value = t;
-	}
-}, f = (e, t = "<page>") => {
-	if (e.renderMode !== void 0 && e.renderMode !== null) {
-		if (!c(e.renderMode)) throw new d(t, String(e.renderMode));
-		return e.renderMode;
-	}
-	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
-}, p = (e, t = "<page>") => ({
-	renderMode: f(e, t),
-	tenantAware: e.tenantAware === !0,
-	revalidateMs: r(e.revalidate),
-	staleWhileRevalidateMs: r(e.staleWhileRevalidate) ?? 0,
-	cacheInvalidatesOn: Array.isArray(e.cacheInvalidatesOn) ? e.cacheInvalidatesOn : [],
-	interactive: e.interactive ?? "full",
-	hasLoader: typeof e.loader == "function",
-	hasMeta: e.meta != null,
-	hasGetStaticPaths: typeof e.getStaticPaths == "function"
-}), m = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, h = (e) => m.exec(e)?.[1] ?? null, g = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, _ = (e) => {
-	g.lastIndex = 0;
-	let t;
-	for (; (t = g.exec(e)) !== null;) {
-		let e = t[2];
-		if (e.startsWith(".")) for (let n of t[1].split(",")) {
-			let t = n.lastIndexOf(" as ");
-			if ((t === -1 ? n : n.slice(t + 4)).trim() === "renderMode") return e;
-		}
-	}
-	return null;
-}, v = /export\s*\{([^}]*)\}/g, y = (e) => {
-	if (/export\s+default\b/.test(e)) return !0;
-	v.lastIndex = 0;
-	let t;
-	for (; (t = v.exec(e)) !== null;) for (let e of t[1].split(",")) {
-		let t = e.lastIndexOf(" as ");
-		if ((t === -1 ? e : e.slice(t + 4)).trim() === "default") return !0;
-	}
-	return !1;
-}, b = (e) => {
-	if (/^export const searchParams\b/m.test(e)) return !0;
-	v.lastIndex = 0;
-	let t;
-	for (; (t = v.exec(e)) !== null;) for (let e of t[1].split(",")) {
-		let t = e.lastIndexOf(" as ");
-		if ((t === -1 ? e : e.slice(t + 4)).trim() === "searchParams") return !0;
-	}
-	return !1;
-}, x = async (n, r) => {
-	let i = (await Promise.all(r.map(async (r) => {
-		let i;
-		try {
-			i = await t(e(n, r.file), "utf8");
-		} catch {
-			return null;
-		}
-		let a = h(i);
-		return a !== null && !c(a) ? u(e("src", "pages", r.file), a) : a === "isr" && b(i) ? `${e("src", "pages", r.file)} declares BOTH renderMode 'isr' and a \`searchParams\` schema.\n\n  The isr cache is keyed by path (plus tenant+locale) — the query string is not part of\n  the key, so the first request's variant would be cached and served for every other\n  query. A page whose render varies by search params cannot be isr-cached safely.\n\n  Fix: use \`renderMode: 'ssr'\` (per-request render, params fully honoured), or remove\n  the \`searchParams\` export and read the query client-side only.` : y(i) ? null : `${e("src", "pages", r.file)} is a route (a \`page.tsx\` under src/pages/) but exports no default.\n\n  A page's default export IS its component — the router has nothing to render without it,\n  and the failure would otherwise surface only in \`voltro build\`'s prerender as\n  "SSR received a descriptor with no Component", long after the file was written.\n\n  Fix: \`export default function Page() { … }\`, or re-export another page's component\n  (\`export { default } from '../page'\`). If this file is NOT a route, rename it —\n  only the reserved names route, and anything else under src/pages/ is ordinary code\n  that may live beside the page that uses it.`;
-	}))).filter((e) => e !== null);
-	if (i.length !== 0) throw Error(i.join("\n\n"));
-};
-//#endregion
-export { p as a, f as c, o as d, n as f, s as i, i as l, h as n, c as o, r as p, _ as r, u as s, x as t, a as u };

package/dist/serveCommand-DLc-BznW.js

@@ -1,2 +0,0 @@
-import { n as e } from "./serveCommand-DkP3OT0W.js";
-export { e as runServeDispatch };

package/dist/start-DfL3fOiN.js

@@ -1,3 +0,0 @@
-import "./renderModeScan-CcH2X1_D.js";
-import { t as e } from "./start-jw89Xbqy.js";
-export { e as runStartCommand };

package/dist/updateCommand-5gFVfK5q.js

@@ -1,2 +0,0 @@
-import { f as e, p as t } from "./updateCommand-BMk2e4ky.js";
-export { e as runApplyCodemods, t as runUpdateCommand };

package/dist/webDev-CZbTsDcH.js

@@ -1,2 +0,0 @@
-import { b as e, v as t } from "./webDev-BgWL9gKV.js";
-export { t as tryRunWebServe, e as walkPagesTree };

package/templates/apps/changelog/scripts/generate-rss.mjs

@@ -1,38 +0,0 @@
-// Generate public/rss.xml from content/releases/*.mdx using the SAME
-// @voltro/changelog primitives the pages use (`loadReleases` +
-// `renderReleaseRss`). Runs BEFORE `voltro build` so Vite copies the file
-// into the build output (publicDir = <app>/public) and `voltro start`
-// serves it as application/xml.
-//
-// Why a separate Node script and not a page route: the web SSG renders
-// HTML pages only — a feed is a non-HTML artifact, so it's emitted as a
-// static file rather than an `rss.xml.tsx` route. Run via `tsx` so the
-// import resolves whether @voltro/changelog points at its TS source
-// (in-workspace dev) or its built dist (a normal install).
-import { readdirSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { loadReleases, renderReleaseRss } from '@voltro/changelog'
-
-const appRoot = join(dirname(fileURLToPath(import.meta.url)), '..')
-const releasesDir = join(appRoot, 'content', 'releases')
-
-// Read each .mdx file into the { path: contents } map loadReleases expects.
-const sources = {}
-for (const file of readdirSync(releasesDir)) {
-  if (file.endsWith('.mdx')) sources[file] = readFileSync(join(releasesDir, file), 'utf8')
-}
-
-const releases = loadReleases(sources)
-// The base URL each release links under (<siteUrl>/<slug>). Set SITE_URL in
-// your deploy env; localhost is the dev default.
-const siteUrl = process.env.SITE_URL ?? 'http://localhost:{{port}}'
-const xml = renderReleaseRss(releases, siteUrl, {
-  title: '{{capProjectName}} Changelog',
-  description: 'Product updates and release notes.',
-})
-
-const publicDir = join(appRoot, 'public')
-mkdirSync(publicDir, { recursive: true })
-writeFileSync(join(publicDir, 'rss.xml'), xml)
-console.log(`rss.xml — ${releases.length} release(s) → public/rss.xml`)

package/templates/apps/changelog/src/lib/releases.ts

@@ -1,21 +0,0 @@
-// The single source of releases for every page. The MDX files under
-// content/releases/ are read at build time via Vite's raw glob (works in
-// dev, SSR, and the static build). `import: 'default'` yields each file's
-// contents as a string — exactly the shape `loadReleases()` expects. The
-// loader parses the frontmatter, renders the markdown body, sorts newest-
-// first, and skips any file missing `version` / `releasedAt`.
-import { loadReleases, type Release } from '@voltro/changelog'
-
-const sources = import.meta.glob('../../content/releases/*.mdx', {
-  query: '?raw',
-  import: 'default',
-  eager: true,
-}) as Record<string, string>
-
-/** All releases, newest first. */
-export const releases: ReadonlyArray<Release> = loadReleases(sources)
-
-export const releaseBySlug = (slug: string): Release | undefined =>
-  releases.find((r) => r.slug === slug)
-
-export type { Release }

package/templates/apps/frontend-static-blog/src/content/posts.ts

@@ -1,64 +0,0 @@
-// The content source for the blog.
-//
-// This is a plain in-repo array — the simplest stand-in for a CMS. In a
-// real app, swap the body of `getStaticPaths` + the page loader to read
-// from your CMS / database / filesystem instead. NOTHING else changes:
-// the build still pre-renders one HTML file per entry.
-//
-// Because this module is imported by both the index page (the list) and
-// the [slug] page (the detail) AND by `getStaticPaths`, it is the single
-// source of truth for "which posts exist".
-
-export interface Post {
-  /** URL segment — `/blog/<slug>`. Must be unique + DNS-safe. */
-  readonly slug: string
-  readonly title: string
-  /** ISO date, shown + used for ordering. */
-  readonly date: string
-  /** One-line summary — feeds the list + the `<meta name="description">`. */
-  readonly excerpt: string
-  readonly readingMinutes: number
-  /** Body paragraphs, separated by a blank line. */
-  readonly body: string
-}
-
-export const posts: ReadonlyArray<Post> = [
-  {
-    slug: 'hello-static',
-    title: 'Why this blog ships zero JavaScript',
-    date: '2025-01-15',
-    excerpt: 'Every page is pre-rendered at build time, so the browser downloads HTML and nothing else.',
-    readingMinutes: 3,
-    body: `This page was rendered ONCE, when you ran \`voltro build\`. The result is a flat \`dist/blog/hello-static/index.html\` that any CDN can serve in single-digit milliseconds.
-
-There is no server rendering per request, no React hydration on the list page, no rpc client on the wire. The list page even declares \`interactive = 'none'\`, which strips every \`<script>\` the framework would otherwise emit.
-
-When you DO need a sprinkle of interactivity — a reading-progress bar, a copy button, a comment box — you reach for an island instead of hydrating the whole tree. Read the next post for how that works.`,
-  },
-  {
-    slug: 'islands-not-hydration',
-    title: 'Islands: hydrate the 5% that moves',
-    date: '2025-01-22',
-    excerpt: 'A static page with one interactive widget should ship one widget of JavaScript — not the whole page.',
-    readingMinutes: 4,
-    body: `Look at the top of this page: a thin progress bar tracks how far you have scrolled. That bar is an ISLAND — a single component the framework hydrates inside otherwise-static HTML.
-
-This page declares \`interactive = 'islands'\`, so the framework renders the article once and only attaches React to the \`island()\`-wrapped component. The surrounding HTML has zero React lifecycle running.
-
-Each island picks WHEN it wakes up via a hydrate strategy: \`load\` (immediately), \`idle\`, \`visible\` (on scroll-into-view), or \`interaction\` (on first click). The progress bar uses \`load\` because it must track scrolling from the very first frame.
-
-The lesson: don't default to \`islands\` because it sounds fast. Use it when most of the page is static and only a few widgets move. A dashboard where everything is interactive wants \`full\` hydration instead.`,
-  },
-  {
-    slug: 'cms-to-ssg',
-    title: 'From CMS to static pages with getStaticPaths',
-    date: '2025-02-03',
-    excerpt: 'Enumerate your content once; the build emits one pre-rendered page per entry.',
-    readingMinutes: 3,
-    body: `A dynamic route like \`src/pages/blog/[slug].tsx\` matches infinitely many URLs. To pre-render it statically, the build needs to know WHICH slugs exist — that is what \`getStaticPaths\` answers.
-
-In this template, \`getStaticPaths\` maps over the \`posts\` array in \`src/content/posts.ts\`. Point it at a CMS API, a database query, or a folder of markdown files instead, and the build will pre-render exactly those pages — the Next.js "static generation from a content source" pattern, with no extra config.
-
-URLs you do not enumerate simply are not built. If a page ALSO sets \`renderMode = 'ssr' | 'isr'\`, \`voltro start\` renders the un-enumerated ones on demand; a pure \`'static'\` page 404s for unknown slugs, which is exactly what you want for a fixed content set.`,
-  },
-]