uniweb 0.12.55 → 0.12.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.12.55",
+  "version": "0.12.57",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,14 +41,14 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/core": "0.7.22",
-    "@uniweb/kit": "0.9.29",
-    "@uniweb/runtime": "0.8.28"
+    "@uniweb/core": "0.7.23",
+    "@uniweb/kit": "0.9.30",
+    "@uniweb/runtime": "0.8.29"
   },
   "peerDependencies": {
-    "@uniweb/content-reader": "1.1.13",
-    "@uniweb/semantic-parser": "1.1.18",
-    "@uniweb/build": "0.14.35"
+    "@uniweb/build": "0.14.37",
+    "@uniweb/content-reader": "1.1.14",
+    "@uniweb/semantic-parser": "1.1.18"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -845,6 +845,8 @@ seo:
 
 **Localized URLs:** On a multilingual site (`languages:` in site.yml), a page's `slug: { <lang>: <segment> }` gives it a native URL segment per language (`/about` → `/fr/a-propos`); the folder name stays the canonical route. Nested folders compose automatically, and localized URLs flow through navigation, the language switcher, and the sitemap.
 
+**Draft languages:** `publishLanguages: [en, fr]` in site.yml lists which declared languages a published build ships — unlisted ones stay dev-previewable drafts. Absent field = publish all declared; the default language must be listed.
+
 **Content-less containers:** Folders with `page.yml` but no markdown are structural groups. They appear in `getPageHierarchy()` with `hasContent: false` and their own title/label. When visited directly, the runtime auto-redirects to the first descendant with content. This supports hierarchical navigation (courses → modules → lessons) at any depth.
 
 ### Lists as Navigation Menus
@@ -1181,7 +1183,7 @@ function Article({ content, block }) {
 
 Components can ignore keys in `content.data` they don't need — the same way unused `params` are ignored.
 
-**Declaring data schemas.** `meta.js` declares the schema for each `content.data` key with a single `data:` field — there is no separate `schemas:` key. Each entry's value is one of: a **named ref** (`'@/article'` resolves to this foundation's `foundation/schemas/article.{js,json,yml}`; `'@std/person'` is a shared standard), an **inline field map** (`{ field: { type, default } }`), or an **inline rich-form** (`{ fields: [...] }`, an editor form). Refs use Uniweb namespacing, resolved on disk at build time, never fetched: `@/name` (this foundation's own `foundation/schemas/`), `@std/name` (the shared standard schemas, shipped in the `@uniweb/schemas` package), and `@org/name` (an org's own schemas, from its `@org/schemas` package — define a schema once and share it across foundations). The schema is a hint: it supplies field defaults and drives the editor, not delivery (which is default-on). For an explicit opt-out (rare), set `data: false`.
+**Declaring data schemas.** `meta.js` declares the schema for each `content.data` key with a single `data:` field — there is no separate `schemas:` key. Each entry's value is one of: a **named ref** (`'@/article'` resolves to this foundation's `foundation/schemas/article.{js,json,yml,yaml}`; `'@std/person'` is a shared standard), an **inline field map** (`{ field: { type, default } }`), or an **inline rich-form** (`{ fields: [...] }`, an editor form). Refs use Uniweb namespacing, resolved on disk at build time, never fetched: `@/name` (this foundation's own `foundation/schemas/`), `@std/name` (the shared standard schemas, shipped in the `@uniweb/schemas` package), and `@org/name` (an org's own schemas, from its `@org/schemas` package — define a schema once and share it across foundations). The schema is a hint: it supplies field defaults and drives the editor, not delivery (which is default-on). For an explicit opt-out (rare), set `data: false`.
 
 ```js
 // meta.js
@@ -1201,7 +1203,7 @@ export default {
 export default { '@acme': '../shared/acme-schemas', '@brand': process.env.BRAND_SCHEMAS }
 ```
 
-Plain JS, so paths can be relative, absolute, or read from an env var. A routed scope wins over the package convention; `@/` and `@uniweb` are never routable; an empty value (e.g. an unset env var) falls back to the package convention.
+Plain JS, so paths can be relative, absolute, or read from an env var. A routed scope wins over the package convention; `@/` and `@uniweb` are never routable; an empty value (e.g. an unset env var) falls back to the package convention. A routed scope has no package fallback for a *missing* schema (it errors rather than silently load a different definition). To override a single schema — keeping the rest of the scope routed to the shared folder — add a per-schema key pointing at a file: `'@acme/person': './schemas/acme-person.yml'` (most-specific wins: file › directory › package).
 
 **Validate your data.** `uniweb validate` checks your file-based data against these declared schemas — missing required fields, type/enum/format mismatches, nested fields — before you ship. Warns by default, `--strict` for a non-zero CI exit. It's distinct from `uniweb doctor` (which checks project structure): `validate` checks your *data* against the schemas you *declared*. Remote (`url:`), `ref`/`options`, and rich `sections`-form inputs are reported deferred — validate those against live data.
 

package/src/commands/build.js

@@ -60,6 +60,7 @@ import {
   classifyPackage,
   isExtensionPackage,
 } from '@uniweb/build'
+import { resolveDefaultLocale, normalizeLanguageList } from '@uniweb/core/locale-config'
 import { readSiteConfig } from '@uniweb/build/site'
 import { readWorkspaceConfig, resolveGlob } from '../utils/config.js'
 
@@ -373,12 +374,26 @@ async function loadI18nConfig(projectDir, siteConfig = null) {
 
   // Resolve locales (undefined/'*' → all available, array → specific)
   const { resolveLocales } = await import('@uniweb/build/i18n')
-  const locales = await resolveLocales(config.languages, localesPath)
+  let locales = await resolveLocales(config.languages, localesPath)
+
+  // Publish filter: build outputs are visitor artifacts. With an explicit
+  // `publishLanguages:`, only listed locales get dist/{locale}/ content,
+  // per-locale HTML, hreflang, and translated collections. Draft locales
+  // stay previewable in dev, which doesn't run this path. Intersecting the
+  // DISK-resolved list here also covers wildcard (`languages: '*'`) sites.
+  if (config.publishLanguages != null) {
+    const publishSet = new Set(normalizeLanguageList(config.publishLanguages))
+    const dropped = locales.filter((l) => !publishSet.has(l))
+    locales = locales.filter((l) => publishSet.has(l))
+    if (dropped.length > 0) {
+      info(`Skipping non-publishable locale(s): ${dropped.join(', ')} (not in publishLanguages)`)
+    }
+  }
 
   if (locales.length === 0) return null
 
   return {
-    defaultLocale: config.defaultLanguage || 'en',
+    defaultLocale: resolveDefaultLocale(config),
     locales,
     localesDir,
   }

package/src/commands/i18n.js

@@ -19,6 +19,7 @@ import { resolve, join, dirname, basename, relative } from 'path'
 import { existsSync } from 'fs'
 import { readFile, writeFile, mkdir, readdir, unlink, rename } from 'fs/promises'
 import yaml from 'js-yaml'
+import { resolveDefaultLocale } from '@uniweb/core/locale-config'
 import {
   isWorkspaceRoot,
   findSites,
@@ -216,7 +217,7 @@ async function loadSiteConfig(siteRoot) {
   const locales = await resolveLocales(config.languages, localesPath)
 
   return {
-    defaultLocale: config.defaultLanguage || 'en',
+    defaultLocale: resolveDefaultLocale(config),
     locales,
     localesDir,
     ...config.i18n,

package/src/commands/publish.js

@@ -48,6 +48,7 @@ import {
   rewriteBallAssets,
 } from '@uniweb/build/site'
 import { emitSyncPackages } from '@uniweb/build/uwx'
+import { resolveDefaultLocale } from '@uniweb/core/locale-config'
 
 import { BackendClient } from '../backend/client.js'
 import { resolveSiteDir, resolveSiteBackend } from './deploy.js'
@@ -117,7 +118,9 @@ function languagesFromContent(siteContent) {
 
 // Languages from site.yml — used only for the dry-run summary (no build yet).
 function languagesFromSiteYml(siteYml) {
-  const def = siteYml.defaultLanguage || siteYml.lang || 'en'
+  // Legacy `lang:` still honored between defaultLanguage and the shared
+  // `defaultLanguage || languages[0] || 'en'` rule.
+  const def = siteYml.defaultLanguage || siteYml.lang || resolveDefaultLocale(siteYml)
   const locales = siteYml.i18n?.locales || siteYml.languages
   if (!Array.isArray(locales) || locales.length === 0) return null
   const norm = locales.map((l) => (typeof l === 'string' ? l : l?.value || l?.code)).filter(Boolean)

package/src/commands/register.js

@@ -454,6 +454,17 @@ async function runRegister(args = []) {
       return { exitCode: 1 }
     }
   }
+  // Registering ≠ delivering the file. A registered schema is a content type
+  // authors use in the app; a FOUNDATION build still resolves '@scope/name' from
+  // disk (a package or a routed folder). This is the moment that belief forms —
+  // you just registered it — so correct it here, not in a doc nobody's reading.
+  if (!jsonMode && defined.length > 0 && scope) {
+    log('')
+    info('Registered schemas are content types authors can use in the Uniweb app.')
+    log(`  ${colors.dim}Delivery is separate: a foundation that binds ${scope}/<name> resolves it from${colors.reset}`)
+    log(`  ${colors.dim}disk — an ${scope}/schemas package, or a folder routed in schemas.config.js.${colors.reset}`)
+  }
+
   if (jsonMode) {
     // Join my authoritative submitted names with the backend's minted ids. Each
     // response entry is `{ registered: { name, version, payload_model_uuid, … },

package/src/framework-index.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-22T10:07:24.554Z",
+  "generatedAt": "2026-07-23T17:37:49.259Z",
   "packages": {
     "@uniweb/build": {
-      "version": "0.14.35",
+      "version": "0.14.37",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -15,17 +15,17 @@
       ]
     },
     "@uniweb/content-reader": {
-      "version": "1.1.13",
+      "version": "1.1.14",
       "path": "framework/content-reader",
       "deps": []
     },
     "@uniweb/content-writer": {
-      "version": "0.2.6",
+      "version": "0.2.7",
       "path": "framework/content-writer",
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.7.22",
+      "version": "0.7.23",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -43,7 +43,7 @@
       "deps": []
     },
     "@uniweb/kit": {
-      "version": "0.9.29",
+      "version": "0.9.30",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -61,7 +61,7 @@
       "deps": []
     },
     "@uniweb/runtime": {
-      "version": "0.8.28",
+      "version": "0.8.29",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -99,7 +99,7 @@
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.4.43",
+      "version": "0.4.44",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",