@uniweb/build 1.10.5 → 1.10.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "1.10.5",
+  "version": "1.10.7",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -57,14 +57,14 @@
     "sharp": "^0.35.5",
     "yaml": "^2.5.0",
     "@uniweb/content-reader": "~1.5.7",
-    "@uniweb/schemas": "~1.6.5",
     "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/projections": "~1.2.1",
+    "@uniweb/schemas": "~1.6.5",
+    "@uniweb/theming": "~1.2.1",
     "@uniweb/content-writer": "~1.3.1",
-    "@uniweb/theming": "~1.2.1"
+    "@uniweb/projections": "~1.2.3"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "~1.2.3"
+    "@uniweb/runtime": "~1.2.5"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -73,8 +73,8 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/runtime": "~1.2.3",
-    "@uniweb/core": "~1.4.7"
+    "@uniweb/core": "~1.4.9",
+    "@uniweb/runtime": "~1.2.5"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/deploy-config-writer.js

@@ -308,11 +308,14 @@ export async function forgetDeployYml(siteDir) {
  *
  * A target's record moves to `deploys:` when that target has none there; when it has, the
  * one in `deploys:` is newer, and the old is dropped. `autoSave: off` becomes
- * `saveDeploys: false`; any other value is the default, and goes.
+ * `saveDeploys: false`; any other value is the default, and goes. And `saveDeploys:` holding
+ * one of `autoSave:`'s values — the key renamed by hand, its value kept — is read the same way:
+ * `off` is `false`, `lastDeploy` the default.
  *
  * @param {string} siteDir
- * @returns {Promise<{ moved: string[], dropped: string[], saveDeploys: boolean|null } | null>}
- *   null when the file has neither key, or there is no file
+ * @returns {Promise<{ moved: string[], dropped: string[], saveDeploys: boolean|null, renamed: string|null } | null>}
+ *   `renamed` is the old value found under `saveDeploys:`; null when the file has none of
+ *   these, or there is no file
  */
 export async function retireDeployYmlKeys(siteDir) {
   const path = join(siteDir, 'deploy.yml')
@@ -321,7 +324,9 @@ export async function retireDeployYmlKeys(siteDir) {
   if (doc.errors.length) throw new Error(`${path}: ${doc.errors[0].message}`)
   const old = doc.get('lastDeploy')
   const autoSave = doc.get('autoSave')
-  if (old === undefined && autoSave === undefined) return null
+  const renamed = doc.get('saveDeploys')
+  const kept = renamed === 'off' || renamed === 'lastDeploy' ? renamed : undefined
+  if (old === undefined && autoSave === undefined && kept === undefined) return null
   const moved = []
   const dropped = []
   if (isMap(old)) {
@@ -338,6 +343,14 @@ export async function retireDeployYmlKeys(siteDir) {
   }
   doc.delete('lastDeploy')
   let saveDeploys = null
+  if (kept !== undefined) {
+    if (kept === 'off') {
+      doc.set('saveDeploys', false)
+      saveDeploys = false
+    } else {
+      doc.delete('saveDeploys')
+    }
+  }
   if (autoSave !== undefined) {
     if (String(autoSave) === 'off' && !doc.has('saveDeploys')) {
       doc.set('saveDeploys', false)
@@ -346,5 +359,5 @@ export async function retireDeployYmlKeys(siteDir) {
     doc.delete('autoSave')
   }
   await writeFile(path, String(doc))
-  return { moved, dropped, saveDeploys }
+  return { moved, dropped, saveDeploys, renamed: kept ?? null }
 }

package/src/site/deploy-config.js

@@ -186,7 +186,15 @@ function validate(doc, path) {
   // now: two targets naming DIFFERENT backends are two sites, and two naming the SAME
   // backend are one site shipped twice. The reason is gone, so the rejection is too.
   if (doc.saveDeploys !== undefined && typeof doc.saveDeploys !== 'boolean') {
-    throw new Error(`${path}: \`saveDeploys\` must be true or false.`)
+    // `lastDeploy` and `off` were the values of `autoSave:`, which `saveDeploys:` replaced: the
+    // key renamed by hand, its value kept (measured 2026-10-26 on a copied project).
+    const retired = doc.saveDeploys === 'lastDeploy' || doc.saveDeploys === 'off'
+    throw new Error(
+      `${path}: \`saveDeploys\` must be true or false` +
+        (retired
+          ? ` — \`${doc.saveDeploys}\` is a value of the retired \`autoSave:\`. \`uniweb doctor --fix deploy-yml-retired-key\` writes what it meant.`
+          : '.')
+    )
   }
   if (doc.default !== undefined && typeof doc.default !== 'string') {
     throw new Error(`${path}: \`default\` must be a string.`)

package/src/uwx/backfill.js

@@ -225,11 +225,16 @@ export function backfillBibFile(filePath, uuidBySlug) {
 
 // Unwrap a localized wire value `{ <locale>: v }` back to the authored bare value
 // (the source locale, else the first present). Non-localized values pass through.
+// ⛔ One with no locale at all, `{}`, is no value: undefined, and the field is not written.
+// Until 2026-10-26 it passed through as the empty map, so a record's emptied caption was
+// written `caption: {}` — an object where its schema says string, which `uniweb validate`
+// refuses, and a publish stopped on fifteen of them.
 export function unwrapLocalized(value, sourceLocale) {
   if (value && typeof value === 'object' && !Array.isArray(value)) {
     if (Object.prototype.hasOwnProperty.call(value, sourceLocale)) return value[sourceLocale]
     const keys = Object.keys(value)
     if (keys.length) return value[keys[0]]
+    return undefined
   }
   return value
 }
@@ -238,7 +243,8 @@ export function unwrapLocalized(value, sourceLocale) {
 // field element-wise. An array unwraps each element; a bare localized map unwraps to
 // one value. The container shape is preserved (mirrors how the producer built it).
 export function unwrapLocalizedList(value, sourceLocale) {
-  if (Array.isArray(value)) return value.map((v) => unwrapLocalized(v, sourceLocale))
+  // An element with no locale at all is no element (`unwrapLocalized`).
+  if (Array.isArray(value)) return value.map((v) => unwrapLocalized(v, sourceLocale)).filter((v) => v !== undefined)
   return unwrapLocalized(value, sourceLocale)
 }
 
@@ -347,7 +353,8 @@ function decodeRecord(fields, value, dec, sectionName) {
     const isBody = Boolean(dec.bodyAt) && sectionName === dec.bodyAt.section && key === dec.bodyAt.key
     const decoded = decodeLeaf(raw, field, dec, isBody)
     if (isBody) dec.body = typeof decoded === 'string' ? decoded : String(decoded ?? '')
-    else out[key] = decoded
+    // A translatable value with no text in any language is no value: the field is not written.
+    else if (decoded !== undefined) out[key] = decoded
   }
   return out
 }