uniweb 0.69.4 → 0.70.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.69.4",
+  "version": "0.70.0",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,17 +41,17 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/runtime": "^0.27.4",
-    "@uniweb/schemas": "^0.7.0",
     "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/core": "^0.29.8",
-    "@uniweb/kit": "^0.19.4",
+    "@uniweb/core": "^0.30.0",
+    "@uniweb/runtime": "^0.27.5",
+    "@uniweb/kit": "^0.19.5",
+    "@uniweb/schemas": "^0.7.0",
     "@uniweb/semantic-parser": "^1.4.1"
   },
   "peerDependencies": {
+    "@uniweb/build": "^0.64.0",
     "@uniweb/content-reader": "^1.2.5",
-    "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/build": "^0.63.3"
+    "@uniweb/semantic-parser": "^1.4.1"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -2717,6 +2717,8 @@ Running `extract` before a build is the usual first mistake — it reads the com
 { "e5f6g7h8": { "default": "Learn More", "overrides": { "/pricing:cta": "See Pricing" } } }
 ```
 
+An override key is the page's route and the section's id (`cta` for `2-cta.md`); a page's own title, label, description and keywords are `/pricing:_meta`, and in `locales/records/` a record is named by its manifest context (`std/article/launch`).
+
 *Free-form bodies* — when a language needs different structure, different images, or copy rewritten rather than translated. The file replaces one section's content:
 
 ```
@@ -2726,7 +2728,7 @@ locales/freeform/es/records/article/x.md       # records work too
 
 These are **body only — no frontmatter**; params and config still come from the source section. `uniweb i18n init-freeform es pages/about hero` creates one pre-filled and records a source hash, so `uniweb i18n status --freeform` can tell you when the original moved on (`update-hash` to acknowledge). `move`, `rename`, and `prune --freeform` keep them aligned when pages get reorganized.
 
-**Records translate in the same `extract` run**, into their own manifest at `locales/records/manifest.json` — keyed by the RECORD, so a record translated once is found by every query that returns it.
+**Records translate in the same `extract` run**, into their own manifest at `locales/records/manifest.json` — keyed by the RECORD, so a record translated once is found by every query that returns it. A record whose query has a data schema translates exactly the fields the schema says are text — never an enum, a URL, a date, a number, a file, a reference or a `translatable: false` field — which are the fields a push carries in each language; mark a string that is a code or a key `translatable: false` and no translator is asked for it. An excerpt the build derives is re-derived from each language's body.
 
 **Component side.** Nothing to do: `content.title` arrives in the active language. The one thing a foundation builds is a switcher.
 

package/src/backend/site-sync.js

@@ -45,7 +45,8 @@ import {
   removeYamlScalar,
   harvestRecordItems,
   storedRecordItems,
-  reprintRecordItems
+  reprintRecordItems,
+  matchStoredRecords
 } from '@uniweb/build/uwx'
 
 // First entity `$`-document out of a `.uwx` we produced or the backend served.
@@ -878,6 +879,64 @@ export async function recoverRecordItemUuids({ client, siteDir, uuids, note }) {
   }
 }
 
+/**
+ * Recover the records lane's identity this copy lacks for the site it is bound to — which stored
+ * record each of its records is (`records`), each placement's in the folder (`folders`), and the
+ * list items of the records it matches (`recordItems`) — from one read of the backend's folder
+ * lane. What the copy already holds is kept.
+ *
+ * ⛔ Until 2026-09-25 nothing recovered these, and a copy whose `sync.json` had lost them — a
+ * blog site whose push was refused after its content landed, with an older CLI — was refused on
+ * every push after: its folder sent three placements with no `$uuid` while three were stored
+ * ("one section carries no item identity (section contents)"). Unrefused, its records would have
+ * gone up with none, and the backend would have made a second entity of each.
+ *
+ * Reads only when the package names a record the map does not, or the folder map is empty; a
+ * record new to the backend costs that read and finds nothing (`matchStoredRecords`).
+ *
+ * @param {object} params
+ * @param {object[]} params.index - the records the package sends (`pkg.records.index`)
+ * @returns {Promise<number>} how many records and placements were recovered
+ */
+export async function recoverRecordsIdentity({ client, siteDir, index, note }) {
+  const state = readBackendState(siteDir, client.origin)
+  const siteUuid = state.site?.uuid || null
+  const recordMap = state.records || {}
+  const records = (index || []).filter((e) => e?.ownId && e.model && e.slug)
+  const folders = readFolderItemUuids(siteDir, client.origin)
+  const unmapped = records.some((e) => !recordMap[e.ownId])
+  if (!siteUuid || !records.length || (!unmapped && Object.keys(folders).length)) return 0
+  try {
+    const res = await client.pullFolder(siteUuid)
+    if (!res?.ok) return 0
+    const docs = entityDocsFromUwx(Buffer.from(await res.arrayBuffer()))
+    const folderDoc = docs.find((d) => d?.$schema === '@uniweb/folder')
+    if (!folderDoc) return 0
+    const learned = matchStoredRecords({ index: records, recordMap, folderDoc })
+    const matched = Object.keys(learned).length
+    if (matched) {
+      updateBackendMap(siteDir, client.origin, 'records', learned)
+      const stored = new Map(docs.map((d) => [d?.$uuid, d]))
+      const items = {}
+      for (const theirs of Object.values(learned)) {
+        const doc = stored.get(theirs)
+        if (doc) items[theirs] = storedRecordItems(doc)
+      }
+      writeRecordItemUuids(siteDir, client.origin, items)
+    }
+    const placements = collectFolderItemUuids(folderDoc)
+    const missing = Object.fromEntries(Object.entries(placements).filter(([k]) => !folders[k]))
+    writeFolderItemUuids(siteDir, client.origin, missing)
+    const placed = Object.keys(missing).length
+    if (matched || placed) {
+      note?.(`Recovered the identity of ${matched} record(s) and ${placed} folder placement(s) from the backend.`)
+    }
+    return matched + placed
+  } catch {
+    return 0
+  }
+}
+
 /**
  * The workspace this site was created in on `backend` — its owner, as the create
  * answered it — in the header's form: `@handle`, a unit's bare uuid when that unit has
@@ -1263,8 +1322,9 @@ export async function recoverItemUuids({ client, siteDir, note }) {
 
 /**
  * Recover the identity a package just built went out without, when the backend may hold it —
- * a page or section (`itemIdentity.unknown`), or a record's list items
- * (`recordItemIdentity.unbanked`) — and say what to build the package again with.
+ * a page or section (`itemIdentity.unknown`), a record or a folder placement
+ * (`recoverRecordsIdentity`), or a record's list items (`recordItemIdentity.unbanked`) — and say
+ * what to build the package again with.
  *
  * A page added since the last push is also without identity, and costs one read that finds
  * nothing. That is the price of never sending as new an item the backend already holds.
@@ -1277,6 +1337,15 @@ export async function recoverUnbankedIdentity({ client, siteDir, pkg, note }) {
   if (pkg?.itemIdentity?.unknown > 0 && (await recoverItemUuids({ client, siteDir, note }))) {
     again = { ...again, itemUuids: readItemUuids(siteDir, client.origin) }
   }
+  // The records the package sends, and the folder placing them. The emit reads the `records`
+  // map from sync.json itself, so it needs no option — only the build again.
+  if (await recoverRecordsIdentity({ client, siteDir, index: pkg?.records?.index, note })) {
+    again = {
+      ...again,
+      folderItemUuids: readFolderItemUuids(siteDir, client.origin),
+      recordItemUuids: readRecordItemUuids(siteDir, client.origin)
+    }
+  }
   const unbanked = pkg?.recordItemIdentity?.unbanked
   if (unbanked?.length && (await recoverRecordItemUuids({ client, siteDir, uuids: unbanked, note }))) {
     again = { ...again, recordItemUuids: readRecordItemUuids(siteDir, client.origin) }

package/src/commands/build.js

@@ -668,7 +668,10 @@ async function buildSiteLink(projectDir, options = {}) {
             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,
@@ -789,7 +792,10 @@ async function buildSite(projectDir, options = {}) {
             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

package/src/commands/publish.js

@@ -37,9 +37,9 @@
  *   uniweb publish --no-save       Do not record this publish in deploy.yml
  */
 
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
+import { join, dirname } from 'node:path'
 import { execSync } from 'node:child_process'
 import yaml from 'js-yaml'
 
@@ -143,14 +143,27 @@ function readSiteYml(path) {
   }
 }
 
-// Languages from the BUILT site-content.json (config.languages) — the authority
-// after a build. Three accepted shapes: 'en', { value, label }, { code, label }.
-function languagesFromContent(siteContent) {
+// Languages from the BUILT site — the authority after a build: `config.languages` where
+// the site declares them (three accepted shapes: 'en', { value, label }, { code, label }),
+// else its default and each language the build produced (`dist/<locale>/site-content.json`).
+// ⛔ Until 2026-09-26 a site that declares no `languages:` — its languages made by its
+// translation files — went live as `['en']`, though the build had produced the others.
+export function languagesFromContent(siteContent, distDir = null) {
   const langs = siteContent?.config?.languages
-  if (!Array.isArray(langs) || langs.length === 0) return ['en']
-  return langs
-    .map((l) => (typeof l === 'string' ? l : l?.value || l?.code))
-    .filter(Boolean)
+  if (Array.isArray(langs) && langs.length > 0) {
+    return langs
+      .map((l) => (typeof l === 'string' ? l : l?.value || l?.code))
+      .filter(Boolean)
+  }
+  const source = siteContent?.config?.defaultLanguage || 'en'
+  const built =
+    distDir && existsSync(distDir)
+      ? readdirSync(distDir, { withFileTypes: true })
+          .filter((e) => e.isDirectory() && e.name !== source && existsSync(join(distDir, e.name, 'site-content.json')))
+          .map((e) => e.name)
+          .sort()
+      : []
+  return [source, ...built]
 }
 
 // Languages from site.yml — used only for the dry-run summary (no build yet).
@@ -1005,7 +1018,7 @@ export async function publish(args = []) {
 
   // 7. Go live — make the just-pushed composite live (its current backend state).
   const siteContent = JSON.parse(await readFile(contentPath, 'utf8'))
-  const languages = languagesFromContent(siteContent)
+  const languages = languagesFromContent(siteContent, dirname(contentPath))
   say.info(`Publishing to ${c.dim}${client.origin}${c.reset} …`)
   let pubRes
   try {

package/src/commands/pull.js

@@ -684,6 +684,8 @@ export async function pull(args = [], deps = {}) {
     args,
     command: 'Pulling'
   })
+  // One reader of Models for the whole pull, so a Model is read once whichever lane asks first.
+  const readModel = makeModelResolver({ client })
 
   // ⭐ No scope check any more — and none is needed. This project's identity on
   // `client.origin` is read from that origin's own section of sync.json, so a
@@ -942,9 +944,23 @@ export async function pull(args = [], deps = {}) {
         // which is the pre-existing behaviour and right for a fresh clone.
       }
 
+      // ⭐ The Models the site's queries name — what a clone, with no foundation to read them from,
+      // tells a query's derived `deferred:` from its author's by. ⛔ Until 2026-09-26 a clone wrote
+      // the derivation into its queries as though authored. One that cannot be read is judged
+      // without it, which keeps the value: the safe direction.
+      const models = {}
+      for (const model of pulledQueryModels) {
+        try {
+          const declaration = await readModel(model)
+          if (declaration) models[model] = declaration
+        } catch {
+          // unreadable here
+        }
+      }
       const report = siteContentDocumentToProject({
         document: siteDoc,
         siteRoot: siteDir,
+        models,
         // Which backend's asset ids to read back as the author's own paths. Without
         // it a pull leaves every image pointing at a backend route.
         backend: client.origin,
@@ -985,7 +1001,7 @@ export async function pull(args = [], deps = {}) {
     if (folder && !folder.notModified && folder.docs?.length) {
       const { folderDoc, recordDocs } = splitRecordsPull(folder.docs)
       pulledRecordDocs = recordDocs
-      const resolveModel = makeModelResolver({ client })
+      const resolveModel = readModel
       const declByModel = new Map()
       pulledDeclarations = declByModel
       for (const model of [
@@ -1102,7 +1118,6 @@ export async function pull(args = [], deps = {}) {
       // in the project (a clone's) resolves none of them otherwise: every template clone
       // said "could not re-bank" until 2026-09-25, and banked nothing.
       const declarations = pulledDeclarations || new Map()
-      const readModel = makeModelResolver({ client })
       for (const model of pulledQueryModels) {
         if (declarations.has(model)) continue
         try {

package/src/commands/register.js

@@ -835,10 +835,18 @@ async function runRegister(args = []) {
   if (!res.ok) {
     // Resume path: a registered version is immutable, so re-running after a
     // partial code delivery hits the duplicate rejection here — a STRUCTURED
-    // 409 (problem+json, title "Conflict") — and proceeds to phase 2 (the
-    // code-uploads plan authorizes against the REGISTERED version; files it
-    // already stores come back `present` and are skipped).
-    const isDuplicate = !standalone && res.status === 409
+    // 409 (problem+json, title "Conflict", naming the `version` it refused) — and
+    // proceeds to phase 2 (the code-uploads plan authorizes against the REGISTERED
+    // version; files it already stores come back `present` and are skipped).
+    //
+    // ⛔ ONE STATUS, MORE THAN ONE MEANING. A 409 that names no version is another
+    // refusal — a data schema changed where the backend holds records of it
+    // (`reason: "destructive_republish"`) — and until 2026-09-26 it was read as a
+    // resume too: "already registered — resuming code delivery", then a 404 for a
+    // version that was never registered, and the refusal's own sentence never shown.
+    // A body with no shape to read resumes, as it always did.
+    const isDuplicate =
+      !standalone && res.status === 409 && (!parsedBody || typeof parsedBody !== 'object' || parsedBody.version !== undefined)
     if (isDuplicate) {
       alreadyRegistered = true
       info(
@@ -869,8 +877,9 @@ async function runRegister(args = []) {
       // because a 422 the CLI did not know about arrived exactly that way.
       if (parsedBody?.detail) {
         log(`  ${parsedBody.detail}`)
-        if (parsedBody.code) {
-          log(`  ${colors.dim}(${parsedBody.code})${colors.reset}`)
+        const code = parsedBody.code ?? parsedBody.reason
+        if (code) {
+          log(`  ${colors.dim}(${code})${colors.reset}`)
         }
       } else if (rawBody) {
         log(`  ${colors.dim}${rawBody.slice(0, 500)}${colors.reset}`)

package/src/framework-index.json

@@ -1,16 +1,16 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-09-25T16:13:29.075Z",
+  "generatedAt": "2026-09-26T17:05:22.846Z",
   "packages": {
     "@uniweb/api": {
-      "version": "0.6.2",
+      "version": "0.6.3",
       "path": "framework/api",
       "deps": [
         "@uniweb/core"
       ]
     },
     "@uniweb/build": {
-      "version": "0.63.3",
+      "version": "0.64.0",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -35,7 +35,7 @@
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.29.8",
+      "version": "0.30.0",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -48,14 +48,14 @@
       "deps": []
     },
     "@uniweb/icons": {
-      "version": "0.4.20",
+      "version": "0.4.21",
       "path": "framework/icons",
       "deps": [
         "@uniweb/core"
       ]
     },
     "@uniweb/kit": {
-      "version": "0.19.4",
+      "version": "0.19.5",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -75,7 +75,7 @@
       "deps": []
     },
     "@uniweb/projections": {
-      "version": "0.7.3",
+      "version": "0.7.4",
       "path": "framework/projections",
       "deps": [
         "@uniweb/content-writer",
@@ -83,7 +83,7 @@
       ]
     },
     "@uniweb/runtime": {
-      "version": "0.27.4",
+      "version": "0.27.5",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -116,7 +116,7 @@
       "deps": []
     },
     "@uniweb/templates": {
-      "version": "0.17.2",
+      "version": "0.17.3",
       "path": "framework/templates",
       "deps": []
     },
@@ -126,7 +126,7 @@
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.10.6",
+      "version": "0.10.7",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",