uniweb 1.19.1 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -37,18 +37,18 @@
     "node": ">=22.12"
   },
   "dependencies": {
-    "handlebars": "^4.7.8",
-    "js-yaml": "^4.1.0",
+    "handlebars": "^4.7.10",
+    "js-yaml": "^4.3.2",
     "prompts": "^2.4.2",
-    "tar": "^7.0.0",
-    "@uniweb/content-writer": "~1.3.0",
+    "tar": "^7.5.21",
+    "@uniweb/content-writer": "~1.3.1",
+    "@uniweb/schemas": "~1.6.5",
     "@uniweb/core": "~1.4.6",
-    "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/schemas": "~1.6.5"
+    "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependencies": {
-    "@uniweb/build": "~1.9.0",
-    "@uniweb/content-reader": "~1.5.6",
+    "@uniweb/build": "~1.10.0",
+    "@uniweb/content-reader": "~1.5.7",
     "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependenciesMeta": {

package/partials/agents.md

@@ -801,6 +801,8 @@ The point is the pair. An agent fetches the index, *reads* what each page is abo
 
 **Large sites also get per-branch indexes.** A branch with at least 5 pages gets its own — `/docs/llms.txt` lists just the docs, titled by that folder. The site index still lists everything; a branch index is an extra entry point, not a replacement, so an agent that starts at `/llms.txt` still reaches any page in two hops.
 
+**Each language gets its own.** A site in several languages has `/fr/llms.txt` beside `/llms.txt`, listing the French pages, record pages included, and linking each at its French address (`/fr/a-propos.md`). Its search index is per language the same way (`/fr/search-index.json`).
+
 ```yaml
 # site.yml — all optional; these are the defaults
 agents:
@@ -1962,7 +1964,7 @@ fetch:
 
 **Lean lists.** A list carries each record's brief, so heavy parts belong in a section of their own — `@std/article`'s body is `body` — and never ride a list. A section that shows them declares its key `whole: true`; elsewhere components fetch the whole record on demand with `useWholeRecord(record, { query })`, which returns it as stored — `full.body.content`. Every file-based record gets its own file, `/data/<name>/<name of the record>.json`. An external query's whole record comes from its `record:` request, below. (`deferred:` is removed — the build stops on it.) The hook is safe to call on any query: when the query has no separate source for one record it returns the record you passed in.
 
-**Component-side fetching.** When a component genuinely needs to fetch on its own (a search box, "load more", a lazy popover), use the kit hooks — `useFetched`, `useCacheEntry`, `useWholeRecord`. They share the framework's cache and dispatcher with declarative fetches; same-key requests dedupe automatically.
+**Component-side fetching.** When a component genuinely needs to fetch on its own (a search box, "load more", a lazy popover), use the kit hooks — `useFetched`, `useCacheEntry`, `useWholeRecord`. They share the framework's cache and dispatcher with declarative fetches; same-key requests dedupe automatically. On a pre-rendered page a hook's first render finds only what that page's own data holds — a declared key's answer, or its page's or the site's `fetch:`. Anything else is pre-rendered as the hook's loading state and fetched by the browser after it loads, so declare a key (`data:` in `meta.js`) for whatever a page must show without JavaScript.
 
 **Validate before shipping.** `uniweb validate` checks file-based data against your declared schemas — missing required fields, type/enum/format mismatches, nested fields. A violation fails it (`--lax` only reports); it checks every record file in `records/`, and `push` / `publish` refuse the same findings before sending anything. Distinct from `uniweb doctor` (project structure): `validate` checks your *data* against the schemas you *declared*. External queries (`url:`) are reported as deferred — their data isn't in the project; the value of a `ref`/`options` field is not checked against the entity it names.
 

package/src/commands/build.js

@@ -12,8 +12,9 @@
  *   --bundle (internal; called by `uniweb deploy --host` / `uniweb export`)
  *     Full vite + post-vite pipeline. Produces a static-host JS bundle
  *     (`dist/index.html`, `dist/entry.js`, `_importmap/*`, `_pages/*` for
- *     split mode, sitemap/robots/search-index, prerendered HTML when
- *     configured). The foundation is statically inlined when site.yml names a
+ *     split mode, sitemap/robots, each language's search index, llms.txt and
+ *     page markdown, prerendered HTML when configured). The foundation is
+ *     statically inlined when site.yml names a
  *     workspace-local one (the self-contained case), and loaded by URL when
  *     it names a URL, or under VITE_FOUNDATION_MODE=runtime. A catalog ref
  *     (`@org/name@version`) is refused (`detectFoundationType`).
@@ -461,19 +462,38 @@ async function loadI18nConfig(projectDir, siteConfig = null) {
 }
 
 /**
- * Build localized content for all configured locales
+ * Build every configured language but the default: its records, its content, and — on the bundle
+ * lane — its search index, llms.txt and page markdown, in that order (`buildLocalizedSite`).
+ *
+ * ⛔ Until 2026-10-25 each lane ran content, then records, here in two copies, and a language's
+ * search index was written in the content step, before its records were translated.
  */
-async function buildLocalizedContent(projectDir, i18nConfig) {
-  const { buildLocalizedContent } = await import('@uniweb/build/i18n')
-
-  const outputs = await buildLocalizedContent(projectDir, {
-    localesDir: i18nConfig.localesDir,
+async function buildLocalizedSite(projectDir, i18nConfig, { projections = false } = {}) {
+  const { buildLocalizedSite } = await import('@uniweb/build/i18n')
+  return buildLocalizedSite(projectDir, {
     locales: i18nConfig.locales,
+    localesDir: i18nConfig.localesDir,
     outputDir: join(projectDir, 'dist'),
-    fallbackToSource: true
+    projections
   })
+}
 
-  return outputs
+/** What `buildLocalizedSite` wrote, per language. */
+function reportLocalizedSite(built) {
+  const locales = Object.keys(built.content)
+  success(`Generated ${locales.length} locale(s)`)
+  for (const locale of locales) {
+    log(`  ${colors.dim}dist/${locale}/site-content.json${colors.reset}`)
+    const files = built.projections[locale] || []
+    for (const file of files) {
+      if (file.kind === 'search') log(`  ${colors.dim}dist/${file.fileName} (${file.count} entries)${colors.reset}`)
+      if (file.kind === 'index') log(`  ${colors.dim}dist/${file.fileName}${colors.reset}`)
+    }
+    const markdown = files.filter((file) => file.kind === 'markdown').length
+    if (markdown) log(`  ${colors.dim}dist/${locale}/ — ${markdown} page markdown projections${colors.reset}`)
+  }
+  const translated = Object.values(built.records).filter((outputs) => Object.keys(outputs).length > 0).length
+  if (translated > 0) success(`Translated records for ${translated} locale(s)`)
 }
 
 /**
@@ -586,13 +606,16 @@ function resolveFoundationDir(projectDir, siteConfig) {
  *
  * Does NOT emit HTML, JS, CSS, source maps, _importmap chunks, processed media
  * (dist/assets/), or static-host extras (sitemap, robots, search-index,
- * _pages/*) — `publish` reads none of them. ⛔ *It processed media into
- * dist/assets/ — WebP copies, video posters, PDF thumbnails — until 2026-10-19.*
+ * llms.txt, page markdown, _pages/*), in any language — `publish` reads none
+ * of them. ⛔ *It processed media into dist/assets/ — WebP copies, video
+ * posters, PDF thumbnails — until 2026-10-19, and until 2026-10-25 wrote the
+ * default language's llms.txt and page markdown, and each other language's
+ * search index.*
  *
- * The `buildLocalizedContent` step is the same call bundle mode makes
- * post-vite, so multi-locale sites get identical per-locale outputs in
- * either mode. Record translation (`buildLocalizedRecords`) also runs here,
- * writing each locale's query files to dist/<lang>/data/.
+ * The `buildLocalizedSite` step is the call bundle mode makes post-vite,
+ * without the projections, so multi-locale sites get identical per-locale
+ * outputs in either mode: each language's query files (dist/<lang>/data/),
+ * then its content (dist/<lang>/site-content.json).
  *
  * History: when `deploy` uploaded `dist/site-content.json` to a backend, it
  * read the bundle pipeline's copy, which prerender rewrites into a lightweight
@@ -631,49 +654,16 @@ async function buildSiteLink(projectDir, options = {}) {
   })
   success(`Wrote ${join('dist', 'site-content.json')}`)
 
-  // Per-locale variants — same call bundle mode makes post-vite. Both
-  // modes produce identical `dist/<lang>/site-content.json` outputs, and
-  // `publish` reads which languages were built from them.
+  // Per-locale variants — the call bundle mode makes post-vite, without the
+  // projections: a host derives its own. Both modes produce identical
+  // `dist/<lang>/site-content.json` outputs, and `publish` reads which
+  // languages were built from them.
   const i18nConfig = await loadI18nConfig(projectDir, siteConfig)
   if (i18nConfig && i18nConfig.locales.length > 0) {
     log('')
     info(`Building localized content for: ${i18nConfig.locales.join(', ')}`)
     try {
-      const outputs = await buildLocalizedContent(projectDir, i18nConfig)
-      success(`Generated ${Object.keys(outputs).length} locale(s)`)
-      for (const [locale] of Object.entries(outputs)) {
-        log(`  ${colors.dim}dist/${locale}/site-content.json${colors.reset}`)
-      }
-
-      // Collection translations — optional; don't fail the build if
-      // missing. Bundle mode does the same.
-      try {
-        const { buildLocalizedRecords } = await import('@uniweb/build/i18n')
-        const recordOutputs = await buildLocalizedRecords(projectDir, {
-          locales: i18nConfig.locales,
-          outputDir: distDir,
-          recordLocalesDir: join(
-            projectDir,
-            i18nConfig.localesDir,
-            'records'
-          ),
-          // Free-form record translations live under it — the default was `locales/`
-          // whatever the site said.
-          localesDir: join(projectDir, i18nConfig.localesDir)
-        })
-        const recordCount = Object.values(recordOutputs).reduce(
-          (sum, localeOutputs) => sum + Object.keys(localeOutputs).length,
-          0
-        )
-        if (recordCount > 0) {
-          success(
-            `Translated records for ${Object.keys(recordOutputs).length} locale(s)`
-          )
-        }
-      } catch (err) {
-        if (process.env.UNIWEB_DEBUG)
-          console.error('Record translation:', err.message)
-      }
+      reportLocalizedSite(await buildLocalizedSite(projectDir, i18nConfig))
     } catch (err) {
       error(`i18n build failed: ${err.message}`)
       if (process.env.UNIWEB_DEBUG) console.error(err.stack)
@@ -719,52 +709,14 @@ async function buildSite(projectDir, options = {}) {
     info(`Building localized content for: ${i18nConfig.locales.join(', ')}`)
 
     try {
-      // Generate locale-specific site-content.json
-      const outputs = await buildLocalizedContent(projectDir, i18nConfig)
+      // Each language's records, then its content, then its search index, llms.txt and page
+      // markdown, made from both.
+      const built = await buildLocalizedSite(projectDir, i18nConfig, { projections: true })
 
       // Generate locale-specific index.html files
       await generateLocalizedHtml(projectDir, i18nConfig)
 
-      success(`Generated ${Object.keys(outputs).length} locale(s)`)
-
-      for (const [locale, path] of Object.entries(outputs)) {
-        log(`  ${colors.dim}dist/${locale}/site-content.json${colors.reset}`)
-      }
-
-      // Translate collections if they exist
-      try {
-        const { buildLocalizedRecords } = await import('@uniweb/build/i18n')
-
-        const recordOutputs = await buildLocalizedRecords(projectDir, {
-          locales: i18nConfig.locales,
-          outputDir: join(projectDir, 'dist'),
-          recordLocalesDir: join(
-            projectDir,
-            i18nConfig.localesDir,
-            'records'
-          ),
-          // Free-form record translations live under it — the default was `locales/`
-          // whatever the site said.
-          localesDir: join(projectDir, i18nConfig.localesDir)
-        })
-
-        // Count collections translated
-        const recordCount = Object.values(recordOutputs).reduce(
-          (sum, localeOutputs) => sum + Object.keys(localeOutputs).length,
-          0
-        )
-
-        if (recordCount > 0) {
-          success(
-            `Translated records for ${Object.keys(recordOutputs).length} locale(s)`
-          )
-        }
-      } catch (err) {
-        // Collection translation is optional, don't fail build
-        if (process.env.UNIWEB_DEBUG) {
-          console.error('Record translation:', err.message)
-        }
-      }
+      reportLocalizedSite(built)
     } catch (err) {
       error(`i18n build failed: ${err.message}`)
       if (process.env.UNIWEB_DEBUG) {

package/src/framework-index.json

@@ -1,18 +1,18 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-25T16:50:54.453Z",
+  "generatedAt": "2026-10-25T20:26:22.771Z",
   "packages": {
     "@uniweb/api": {
       "version": "1.6.4"
     },
     "@uniweb/build": {
-      "version": "1.9.0"
+      "version": "1.10.0"
     },
     "@uniweb/content-reader": {
-      "version": "1.5.6"
+      "version": "1.5.7"
     },
     "@uniweb/content-writer": {
-      "version": "1.3.0"
+      "version": "1.3.1"
     },
     "@uniweb/core": {
       "version": "1.4.6"
@@ -36,7 +36,7 @@
       "version": "1.2.0"
     },
     "@uniweb/runtime": {
-      "version": "1.2.1"
+      "version": "1.2.2"
     },
     "@uniweb/scene": {
       "version": "1.0.1"
@@ -51,7 +51,7 @@
       "version": "1.13.0"
     },
     "@uniweb/snapshot": {
-      "version": "1.1.0"
+      "version": "1.1.1"
     },
     "@uniweb/templates": {
       "version": "1.1.5"
@@ -60,7 +60,7 @@
       "version": "1.2.1"
     },
     "@uniweb/unipress": {
-      "version": "1.1.15"
+      "version": "1.1.16"
     }
   },
   "templates": {