@voltro/cli 0.52.0 → 0.54.0

package/templates/apps/frontend-static-blog/src/pages/page.test.tsx

@@ -12,10 +12,16 @@
 import { afterEach, describe, expect, test, vi } from 'vitest'
 import { act, createElement, type ReactNode } from 'react'
 import { createRoot, type Root } from 'react-dom/client'
-import { posts } from '../content/posts'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { setContentRoot } from '@voltro/content'
 import en from '../locales/en'
 import de from '../locales/de'
 
+// The list now comes from the posts CONTENT COLLECTION — point the server
+// half at this app's root and load the REAL content/posts/*.md files.
+setContentRoot(join(dirname(fileURLToPath(import.meta.url)), '..', '..'))
+
 const catalogs: Record<string, Record<string, string>> = { en, de }
 let currentLocale = 'en'
 
@@ -23,6 +29,10 @@ let currentLocale = 'en'
 const fill = (msg: string, values?: Record<string, unknown>): string =>
   values ? msg.replace(/\{(\w+)\}/g, (_, k: string) => String(values[k] ?? `{${k}}`)) : msg
 
+vi.mock('@voltro/web', () => ({
+  useLoaderData: () => entries,
+}))
+
 vi.mock('@voltro/i18n', () => ({
   // The locale catalogs call these at module top-level; identity mirrors the
   // real (compile-time-only) implementations so importing them doesn't throw.
@@ -38,7 +48,9 @@ vi.mock('@voltro/i18n', () => ({
     fill(catalogs[currentLocale]?.[id] ?? id, values),
 }))
 
-const { default: Index, meta, renderMode, interactive } = await import('./page')
+const { default: Index, meta, renderMode, interactive, loader } = await import('./page')
+// The real markdown entries, loaded through the real collection pipeline.
+const entries = await loader()
 
 ;(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true
 
@@ -83,11 +95,12 @@ describe('index — localized render', () => {
     currentLocale = 'en'
     render(createElement(Index))
     const links = Array.from(container.querySelectorAll('.post-list a'))
-    expect(links).toHaveLength(posts.length)
+    expect(links).toHaveLength(entries.length)
+    expect(entries.length).toBeGreaterThan(0)
     // Newest-first: the 2025-02-03 post precedes the 2025-01-15 one.
     expect(links[0]!.getAttribute('href')).toBe('/blog/cms-to-ssg')
     expect(links[links.length - 1]!.getAttribute('href')).toBe('/blog/hello-static')
-    expect(container.textContent).toContain(`${posts.length} posts`)
+    expect(container.textContent).toContain(`${entries.length} posts`)
   })
 
   test('prefixes post links with /de and renders German chrome (de)', () => {
@@ -95,6 +108,6 @@ describe('index — localized render', () => {
     render(createElement(Index))
     const links = Array.from(container.querySelectorAll('.post-list a'))
     expect(links[0]!.getAttribute('href')).toBe('/de/blog/cms-to-ssg')
-    expect(container.textContent).toContain(`${posts.length} Beiträge`)
+    expect(container.textContent).toContain(`${entries.length} Beiträge`)
   })
 })

package/templates/apps/frontend-static-blog/src/pages/page.tsx

@@ -1,18 +1,22 @@
 // Blog index, mounted at `/` (default locale) and mirrored at `/de` by
-// src/pages/[locale]/index.tsx. The post LIST is pure content — no
+// src/pages/[locale]/page.tsx. The post LIST is pure content — no
 // interactivity — so it ships zero JavaScript: `interactive = 'none'` strips
-// every framework <script> from the rendered HTML. The list is read from the
-// same content source the [slug] pages + getStaticPaths use.
+// every framework <script> from the rendered HTML.
+//
+// The list comes from the `posts` CONTENT COLLECTION (content/posts/*.md):
+// the loader runs at build time and reads the filesystem — markdown with
+// schema-checked frontmatter, no markdown dependency in this app.
 //
 // `meta` is a FUNCTION of `{ locale }` — that's what localises each variant's
 // <title> / <description> in the pre-rendered HTML. Post titles/excerpts are
-// CONTENT (src/content/posts.ts) and are NOT translated; only the chrome
-// (heading, count line, reading-time label) comes from the catalogs.
+// CONTENT and are NOT translated; only the chrome (heading, count line,
+// reading-time label) comes from the catalogs.
 
 import type { ReactNode } from 'react'
-import type { PageMeta } from '@voltro/web'
+import { useLoaderData, type PageMeta } from '@voltro/web'
+import { getCollection, type ContentEntry } from '@voltro/content'
 import { T, useLocale } from '@voltro/i18n'
-import { posts } from '../content/posts'
+import { posts, type Post } from '../collections/posts.collection'
 import { getCatalog, withLocalePrefix } from '../lib/locale'
 
 export const renderMode = 'static' as const
@@ -26,10 +30,13 @@ export const meta = ({ locale }: { locale: string }): PageMeta => {
   }
 }
 
-// Newest first — sort a copy so the source array stays stable.
-const byDateDesc = [...posts].sort((a, b) => b.date.localeCompare(a.date))
+// Newest first. Runs once at build time (this page is static).
+export const loader = async (): Promise<ReadonlyArray<ContentEntry<Post>>> =>
+  [...await getCollection<Post>(posts.name)]
+    .sort((a, b) => b.data.date.localeCompare(a.data.date))
 
 export default function Index(): ReactNode {
+  const entries = useLoaderData<ReadonlyArray<ContentEntry<Post>>>()
   const locale = useLocale()
   return (
     <main>
@@ -37,18 +44,18 @@ export default function Index(): ReactNode {
         <T id="home.heading" />
       </h1>
       <p className="muted">
-        <T id="home.postCount" values={{ count: posts.length }} />
+        <T id="home.postCount" values={{ count: entries.length }} />
       </p>
       <ul className="post-list">
-        {byDateDesc.map((post) => (
+        {entries.map((post) => (
           <li key={post.slug}>
-            <a href={withLocalePrefix(`/blog/${post.slug}`, locale)}>{post.title}</a>
+            <a href={withLocalePrefix(`/blog/${post.slug}`, locale)}>{post.data.title}</a>
             <p>
               <span className="muted">
-                {post.date} · <T id="post.readingTime" values={{ minutes: post.readingMinutes }} />
+                {post.data.date} · <T id="post.readingTime" values={{ minutes: post.data.readingMinutes }} />
               </span>
               {' — '}
-              {post.excerpt}
+              {post.data.excerpt}
             </p>
           </li>
         ))}

package/templates/apps/frontend-status/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.52.0",
-    "@voltro/cli": "0.52.0",
-    "@voltro/client": "0.52.0",
-    "@voltro/env": "0.52.0",
-    "@voltro/i18n": "0.52.0",
-    "@voltro/ui-shadcn": "0.52.0",
-    "@voltro/web": "0.52.0",
+    "@{{projectName}}/api": "0.54.0",
+    "@voltro/cli": "0.54.0",
+    "@voltro/client": "0.54.0",
+    "@voltro/env": "0.54.0",
+    "@voltro/i18n": "0.54.0",
+    "@voltro/ui-shadcn": "0.54.0",
+    "@voltro/web": "0.54.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.52.0",
+    "@voltro/devtools": "0.54.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "jsdom": "^30.0.0",

package/templates/apps/mobile-app/package.json

@@ -4,20 +4,21 @@
   "private": true,
   "main": "expo-router/entry",
   "scripts": {
-    "start": "voltro codegen . && expo start",
-    "ios": "voltro codegen . && expo run:ios",
-    "android": "voltro codegen . && expo run:android",
-    "web": "voltro codegen . && expo start --web",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "codegen": "voltro codegen ."
+    "start": "voltro mobile codegen . && expo start",
+    "ios": "voltro mobile codegen . && expo run:ios",
+    "android": "voltro mobile codegen . && expo run:android",
+    "web": "voltro mobile codegen . && expo start --web",
+    "test": "voltro mobile codegen . && vitest run",
+    "typecheck": "voltro mobile codegen . && tsc --noEmit",
+    "codegen": "voltro mobile codegen .",
+    "links": "voltro mobile links ."
   },
   "dependencies": {
     "@react-native-async-storage/async-storage": "1.23.1",
     "@react-native-community/netinfo": "11.4.1",
-    "@voltro/client": "0.52.0",
-    "@voltro/react-native": "0.52.0",
-    "@{{projectName}}/api": "0.52.0",
+    "@voltro/client": "0.54.0",
+    "@voltro/react-native": "0.54.0",
+    "@{{projectName}}/api": "0.54.0",
     "expo": "^52.0.0",
     "expo-constants": "~17.0.0",
     "expo-linking": "~7.0.0",
@@ -32,7 +33,7 @@
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@vitest/coverage-v8": "^4.1.10",
-    "@voltro/cli": "0.52.0",
+    "@voltro/cli": "0.54.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/mobile-app/src/lib/deeplinks.ts

@@ -1,27 +1,39 @@
-// The app's deep-link table + a pure resolver.
+// The app's deep-link table — GENERATED, not hand-written.
 //
 // A deep link maps an inbound URL — a universal link (`https://…/orders/42`), a
 // custom-scheme URL (`{{appName}}://orders/42`), or a push payload's
-// `data.deepLink` — to an in-app navigation. `defineDeepLink` + the pure matcher
-// come from `@voltro/react-native`; this module is browser/RN-safe (no Metro, no
-// screens), which is exactly why it is unit-testable without a simulator.
+// `data.deepLink` — to an in-app navigation. Notice what is NOT in this file: a
+// list of links. `voltro mobile codegen` derives one link per Expo Router screen
+// under `src/app/`, because a screen's route path and a deep-link pattern are
+// the same path in two syntaxes (`app/orders/[id].tsx` ↔ `/orders/:id`). Add a
+// screen and its link exists.
 //
-// Declaration order wins in `dispatchDeepLink`, so list more-specific patterns
-// FIRST. The `navigate` callback is injected (the screen layer passes
-// expo-router's `router.push`), keeping this table pure + testable.
-import {
-  defineDeepLink,
-  dispatchDeepLink,
-  type DeepLinkDescriptor,
-} from '@voltro/react-native'
+// **When you need a link file.** Write a `*.deepLink.ts` (default-exporting
+// `defineDeepLink`) when a link needs something the derived one cannot do —
+// param coercion, an auth check, or a side effect before navigation:
+//
+//     // src/lib/invoice.deepLink.ts  — NOT under src/app/: Expo Router routes
+//     // every .ts/.tsx there, so a link file placed inside it ships a screen.
+//     import { router } from 'expo-router'
+//     import { defineDeepLink } from '@voltro/react-native'
+//
+//     export default defineDeepLink({
+//       pattern: '/invoices/:number',
+//       handler: ({ number }) => router.push(`/invoices/${number.padStart(6, '0')}`),
+//     })
+//
+// Declared links are matched BEFORE derived ones, so one for `/orders/:id`
+// replaces the screen-derived link for that pattern rather than racing it.
+//
+// This module stays a thin adapter on purpose: it is browser/RN-safe (no Metro,
+// no screens), which is what makes the routing unit-testable without a simulator.
+import { dispatchDeepLink, type DeepLinkDescriptor } from '@voltro/react-native'
+import { deepLinks } from '../../.framework/deepLinks.generated'
 
-/** Build the app's deep links against a navigate function (expo-router's `push`). */
+/** The app's deep links, bound to a navigate function (expo-router's `push`). */
 export const makeDeepLinks = (
   navigate: (href: string) => void,
-): ReadonlyArray<DeepLinkDescriptor> => [
-  defineDeepLink({ pattern: '/orders/:id', handler: ({ id }) => navigate(`/orders/${id}`) }),
-  defineDeepLink({ pattern: '/settings', handler: () => navigate('/settings') }),
-]
+): ReadonlyArray<DeepLinkDescriptor> => deepLinks(navigate)
 
 /**
  * Route an inbound URL through the link table. Returns `true` when a link

package/templates/apps/mobile-app/tests/deeplinks.test.ts

@@ -1,11 +1,27 @@
+// Deep-link routing, against the GENERATED table.
+//
+// Nothing here names a hand-written link, because there are none: every
+// assertion below is about a link `voltro mobile codegen` derived from a screen
+// under `src/app/`. That is the property worth pinning — add
+// `src/app/invoices/[id].tsx` and `/invoices/42` starts working with no other
+// edit. These tests therefore need the table generated first, which is why the
+// `test` script runs codegen (the same way `start` / `ios` do).
 import { describe, expect, it, vi } from 'vitest'
 import { handleDeepLink, makeDeepLinks } from '../src/lib/deeplinks'
+import { DERIVED_DEEP_LINK_PATTERNS } from '../.framework/deepLinks.generated'
 
 describe('deep links', () => {
+  it('derives one link per screen — nobody wrote this table', () => {
+    // src/app/index.tsx, settings.tsx, orders/[id].tsx. `_layout.tsx` is a
+    // layout, not a screen, and must not be in here.
+    expect([...DERIVED_DEEP_LINK_PATTERNS].sort()).toEqual(['/', '/orders/:id', '/settings'])
+  })
+
   it('routes an order URL to the order screen with the captured id', () => {
     const navigate = vi.fn()
     const links = makeDeepLinks(navigate)
     expect(handleDeepLink(links, '/orders/42')).toBe(true)
+    // A derived link navigates to the screen it came from, params put back.
     expect(navigate).toHaveBeenCalledWith('/orders/42')
   })
 

package/dist/agentsMd-SDDSkyl4.js

@@ -1,2 +0,0 @@
-import { a as e } from "./agentsMd-0l980yhL.js";
-export { e as runAgentsMd };

package/dist/apiBuild-BYBpL7Pz.js

@@ -1,2 +0,0 @@
-import { c as e, l as t } from "./apiBuild-CSFI8QGq.js";
-export { e as runApiBuild, t as runServeBundleBuild };