@uniweb/build 1.10.6 → 1.10.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "1.10.6",
+  "version": "1.10.8",
   "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/content-writer": "~1.3.1",
     "@uniweb/schemas": "~1.6.5",
     "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/theming": "~1.2.1",
-    "@uniweb/projections": "~1.2.2",
-    "@uniweb/content-writer": "~1.3.1"
+    "@uniweb/projections": "~1.2.3",
+    "@uniweb/theming": "~1.2.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "~1.2.4"
+    "@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/core": "~1.4.8",
-    "@uniweb/runtime": "~1.2.4"
+    "@uniweb/core": "~1.4.9",
+    "@uniweb/runtime": "~1.2.5"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/foundation/config.js

@@ -55,6 +55,7 @@ export { nodeEnvDefine }
  * @param {boolean} [options.tailwind] - Include Tailwind CSS v4 plugin (default: true)
  * @param {boolean} [options.sourcemap] - Generate sourcemaps (default: true)
  * @param {Object} [options.build] - Additional build options to merge
+ * @param {Object} [options.experimental] - Vite experimental options to merge
  * @returns {Promise<Object>} Vite configuration
  */
 export async function defineFoundationConfig(options = {}) {
@@ -76,6 +77,7 @@ export async function defineFoundationConfig(options = {}) {
     tailwind = true,
     sourcemap = true,
     build: buildOverrides = {},
+    experimental: experimentalOverrides = {},
     ...restOptions
   } = options
 
@@ -126,6 +128,15 @@ export async function defineFoundationConfig(options = {}) {
   return {
     plugins,
 
+    // ⭐ A FOUNDATION NAMES ITS OWN FILES FROM WHERE ITS CODE IS. A host serves it from an
+    // address of its own, never the page's, so a file its code references — a worker; library
+    // mode inlines every other asset — is found beside the code, not at the page's root.
+    // ⛔ Until 2026-10-27 that URL was `/assets/<file>`, which a published site does not have.
+    experimental: {
+      renderBuiltUrl: (filename, { hostType }) => (hostType === 'js' ? { relative: true } : undefined),
+      ...experimentalOverrides
+    },
+
     build: {
       lib: {
         entry: resolve(foundationRoot, entry),

package/src/i18n/index.js

@@ -454,6 +454,14 @@ export async function buildLocalizedContent(siteRoot, options = {}) {
     await writeFile(siteContentPath, JSON.stringify(siteContent, null, 2))
   }
 
+  // The paths the site's source holds a section at, drafts included — read once, and only
+  // when a translation translates nothing this build publishes (`warnAboutFreeformIssues`).
+  let sourcePaths
+  const inSource = async (path) => {
+    sourcePaths ??= freeformSourceIndex(await collectSourceQuietly(siteRoot)).validPaths
+    return sourcePaths.has(path)
+  }
+
   for (const locale of locales) {
     // ⛔ THE DEFAULT LOCALE IS THE ROOT TREE, NEVER A SUBDIRECTORY. Emitting
     // `dist/<default>/` mints a byte-identical duplicate of every page at a second
@@ -496,7 +504,7 @@ export async function buildLocalizedContent(siteRoot, options = {}) {
       })
 
       // Check for stale/orphaned free-form translations and warn
-      await warnAboutFreeformIssues(locale, freeformDir, siteContent)
+      await warnAboutFreeformIssues(locale, freeformDir, siteContent, inSource)
     } else {
       // Use sync merge (original behavior)
       translated = mergeTranslations(siteContent, translations, {
@@ -534,8 +542,10 @@ export async function buildLocalizedContent(siteRoot, options = {}) {
  * @param {string} locale - Locale code
  * @param {string} freeformDir - Path to locale's freeform directory
  * @param {Object} siteContent - Site content for building source hashes
+ * @param {(path: string) => Promise<boolean>} inSource - whether the site's source holds a
+ *   section at a translation's path
  */
-async function warnAboutFreeformIssues(locale, freeformDir, siteContent) {
+async function warnAboutFreeformIssues(locale, freeformDir, siteContent, inSource) {
   try {
     // Every path the renderer reads a section's translation from, for every section it
     // translates, with the hash of each source — the index the CLI's free-form commands
@@ -550,9 +560,14 @@ async function warnAboutFreeformIssues(locale, freeformDir, siteContent) {
 
     // Check for orphaned translations — only those this content can judge: never a
     // record's (`records/…`), which is read from records the site content does not hold.
+    // ⭐ AND ONLY ONE THE SITE'S SOURCE DOES NOT HOLD EITHER. A published build carries no
+    // drafts, so a translation of a `hidden:` section or page translates nothing here while
+    // its section is still in the site — the source says, as `uniweb i18n status --freeform`
+    // judges. ⛔ Until 2026-10-27 each such translation was reported orphaned at every build.
     const orphaned = await getOrphanedTranslations(freeformDir, validPaths)
     for (const item of orphaned) {
       if (!canJudge(item.path)) continue
+      if (await inSource(item.path)) continue
       console.warn(`[i18n] Free-form translation orphaned: ${locale}/${item.path}`)
     }
 
@@ -574,6 +589,23 @@ async function warnAboutFreeformIssues(locale, freeformDir, siteContent) {
   }
 }
 
+/**
+ * The site's content as its source says it, drafts included — what `uniweb i18n` judges a
+ * free-form translation by. This build collected the site and reported what it found, so
+ * this second reading says nothing.
+ */
+async function collectSourceQuietly(siteRoot) {
+  const { collectSiteContent } = await import('../site/content-collector.js')
+  const { log, warn } = console
+  console.log = console.warn = () => {}
+  try {
+    return await collectSiteContent(siteRoot)
+  } finally {
+    console.log = log
+    console.warn = warn
+  }
+}
+
 /**
  * Format translation status for console output
  * @param {Object} status - Status from getTranslationStatus

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
 }