uniweb 0.56.12 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.56.12",
+  "version": "0.57.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/content-writer": "^0.3.4",
-    "@uniweb/core": "^0.29.4",
-    "@uniweb/runtime": "^0.26.4",
     "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/kit": "^0.19.3",
-    "@uniweb/schemas": "^0.3.3"
+    "@uniweb/schemas": "^0.3.3",
+    "@uniweb/core": "^0.29.4",
+    "@uniweb/content-writer": "^0.3.4",
+    "@uniweb/runtime": "^0.26.5",
+    "@uniweb/kit": "^0.19.3"
   },
   "peerDependencies": {
-    "@uniweb/build": "^0.52.7",
     "@uniweb/content-reader": "^1.2.5",
-    "@uniweb/semantic-parser": "^1.4.1"
+    "@uniweb/semantic-parser": "^1.4.1",
+    "@uniweb/build": "^0.53.0"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -1344,6 +1344,16 @@ Components use **semantic CSS tokens** instead of hardcoded colors. The runtime
 
 **Palette shades** are also available — `text-primary-600`, `bg-neutral-100`, `border-accent-300` — 11 shades (50–950) per palette color (primary, secondary, accent, neutral). See `theme-tokens.css` for the complete mapping.
 
+> **Debugging a token that "does nothing": don't probe it in the browser.** Tailwind v4 is JIT — it emits only the classes it finds in *scanned source*. So a class you assign from JavaScript, to a `<div>` you created in the console, **has never been scanned and can never resolve**, whatever the token. A comparison against a deliberately bogus class agrees with you either way, because both are ungenerated, and classes that happen to appear in source elsewhere look like they "pass" — so the probe confirms whichever answer you started with.
+>
+> **Ask the build instead.** The one command that splits the question:
+>
+> ```bash
+> grep -o '\.text-link{[^}]*}' dist/assets/*.css
+> ```
+>
+> A rule prints → the utility exists, and something at runtime is overriding it. Nothing prints → Tailwind never generated it, and there are only two reasons: your `styles.css` doesn't `@import "@uniweb/kit/theme-tokens.css"` (or declares its own `@theme inline` that omits the token), or your `@source` globs don't cover the file the class is written in. Either way, write the class into a real source file first — a token that's only ever composed at runtime is invisible to the scanner by design.
+
 **Authors control context** via `theme: dark` in frontmatter, alternating `light` (default), `medium`, and `dark` across sections for visual rhythm. **The three presets aren't the limit** — the object form overrides any token per section:
 
 ```yaml

package/src/commands/build.js

@@ -414,10 +414,18 @@ async function loadI18nConfig(projectDir, siteConfig = null) {
     }
   }
 
+  // ⛔ The default locale is the root tree, not `dist/<default>/`. An explicit
+  // `languages: [en, fr]` resolves verbatim — default included — so the DECLARED
+  // form (the one the contract tells authors to use) minted a duplicate copy of
+  // every page, while the wildcard form did not. Dropping it here keeps content,
+  // per-locale HTML and translated records agreeing on one set.
+  const defaultLocale = resolveDefaultLocale(config)
+  locales = locales.filter((l) => l !== defaultLocale)
+
   if (locales.length === 0) return null
 
   return {
-    defaultLocale: resolveDefaultLocale(config),
+    defaultLocale,
     locales,
     localesDir
   }

package/src/commands/i18n.js

@@ -372,6 +372,26 @@ async function runExtract(siteRoot, config, args) {
   }
 }
 
+/**
+ * The starter value a translator is handed for one unit.
+ *
+ * ⭐ `unit.markup` when the element carries inline markdown, `unit.source` otherwise.
+ * `source` is the flattened plain text — it is the KEY, and it is what this function
+ * used to seed. That meant a paragraph's links, bold and emphasis were already gone
+ * from the file a translator opened, and a translator cannot restore what they were
+ * never shown: a 100%-covered locale rendered with zero inline links and no check
+ * reported it (coverage counts keys, not fidelity). `merge` has always parsed a
+ * translation value as inline markdown, so the value channel was lossless the whole
+ * time — only the prompt was lossy. Measured 2026-09-18, @uniweb/build 0.44.4.
+ *
+ * ⚠️ This fills MISSING keys only. A locale file already seeded from the flat source
+ * is not repaired by re-running; use `uniweb i18n generate <locale> --force` against
+ * a freshly extracted manifest to get the markup-bearing source back.
+ */
+function starterValue(unit) {
+  return unit.markup || unit.source
+}
+
 /**
  * Generate command - generate starter translation files from manifest
  *
@@ -451,7 +471,7 @@ async function runInit(siteRoot, config, args) {
 
       for (const [hash, unit] of Object.entries(units)) {
         if (!existingKeys.has(hash)) {
-          existing[hash] = useEmpty ? '' : unit.source
+          existing[hash] = useEmpty ? '' : starterValue(unit)
           added++
         }
       }
@@ -470,7 +490,7 @@ async function runInit(siteRoot, config, args) {
       const localeData = {}
 
       for (const [hash, unit] of Object.entries(units)) {
-        localeData[hash] = useEmpty ? '' : unit.source
+        localeData[hash] = useEmpty ? '' : starterValue(unit)
       }
 
       await writeFile(localePath, JSON.stringify(localeData, null, 2) + '\n')
@@ -962,17 +982,23 @@ async function runAudit(siteRoot, config, args) {
       }
     }
 
-    // Report entries that need inline tag updates
-    const needsTagsTotal = results.reduce(
-      (sum, r) => sum + (r.needsTags?.length || 0),
+    // ⭐ Report translations that will render as flat prose.
+    // Coverage cannot see this class — it counts keys, not fidelity — so a site
+    // whose every link has been flattened reports 100%. That is exactly how a
+    // fully translated documentation site shipped with zero internal links.
+    const losesMarkupTotal = results.reduce(
+      (sum, r) => sum + (r.losesMarkup?.length || 0),
       0
     )
-    if (needsTagsTotal > 0) {
+    if (losesMarkupTotal > 0) {
+      log(
+        `\n${colors.yellow}${losesMarkupTotal} translation(s) drop the inline markup their source carries.`
+      )
       log(
-        `\n${colors.yellow}${needsTagsTotal} translation(s) have inline marks in the source but not in the translation.`
+        `Links, bold and emphasis will be missing from these — a translation value is`
       )
       log(
-        `These translations won't preserve accent/span styling.${colors.reset}`
+        `inline markdown, so copy the [text](href) and ** ** across from the source.${colors.reset}`
       )
       if (!verbose) {
         log(

package/src/framework-index.json

@@ -1,16 +1,16 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-09-18T05:17:28.321Z",
+  "generatedAt": "2026-09-18T17:09:07.963Z",
   "packages": {
     "@uniweb/api": {
-      "version": "0.3.7",
+      "version": "0.4.0",
       "path": "framework/api",
       "deps": [
         "@uniweb/core"
       ]
     },
     "@uniweb/build": {
-      "version": "0.52.7",
+      "version": "0.53.0",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -83,7 +83,7 @@
       ]
     },
     "@uniweb/runtime": {
-      "version": "0.26.4",
+      "version": "0.26.5",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -126,7 +126,7 @@
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.9.22",
+      "version": "0.9.23",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",