uniweb 0.12.42 → 0.12.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.12.42",
+  "version": "0.12.44",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,13 +41,13 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/core": "0.7.16",
-    "@uniweb/kit": "0.9.20",
-    "@uniweb/runtime": "0.8.22"
+    "@uniweb/core": "0.7.18",
+    "@uniweb/kit": "0.9.22",
+    "@uniweb/runtime": "0.8.24"
   },
   "peerDependencies": {
+    "@uniweb/build": "0.14.26",
     "@uniweb/content-reader": "1.1.12",
-    "@uniweb/build": "0.14.24",
     "@uniweb/semantic-parser": "1.1.17"
   },
   "peerDependenciesMeta": {

package/partials/agents.md

@@ -1005,6 +1005,63 @@ contexts:
 
 > **Contrast warning:** Bright brand colors (orange, yellow, light green) at shade 500 may not meet WCAG contrast (4.5:1) with white foreground text. Test buttons for readability — if contrast is insufficient, keep the default shade 600 mapping.
 
+### Fonts
+
+Font families are a **site** setting, configured in `theme.yml` under `fonts:`. A foundation never installs a font package (no `@fontsource/*`) and never hardcodes a family in its code — if you reach for either, you're off the paved path. The framework provides three roles and wires each onto the standard elements for you:
+
+| Role | Wired onto | Typical use |
+|---|---|---|
+| `body` | `body` (all text by default) | paragraphs, UI |
+| `heading` | `h1, h2, h3` | titles |
+| `mono` | `code, pre, kbd, samp` | code, technical text |
+
+```yaml
+# site/theme.yml
+fonts:
+  body: "Inter, system-ui, sans-serif"
+  heading: "Poppins, system-ui, sans-serif"
+  mono: "'Fira Code', monospace"
+```
+
+Because the site wires the families onto real elements, **the norm is that a foundation doesn't set fonts itself** — render semantic markup (`<H1>`, `<P>`, `<code>` from the kit) and the roles apply. (It stays Tailwind for everything else — layout, spacing, weights, color.) That convention is what authors can count on: `body`/`heading`/`mono` control the fonts the same way in every foundation, and one foundation re-fonts per site with zero code changes.
+
+**Loading the files** — two site-side options, both config-only, neither adds a dependency:
+
+```yaml
+# Hosted (Google Fonts or any provider). The build auto-adds preconnect
+# hints and drops families no role references.
+fonts:
+  heading: "Poppins, sans-serif"
+  import:
+    - url: "https://fonts.googleapis.com/css2?family=Poppins:wght@600;700"
+
+# Self-hosted (no CDN — privacy / offline). Put the files under
+# site/public/fonts/ and declare @font-face faces; the build emits the
+# @font-face rules + preload hints, and skips any face whose family no
+# role uses.
+fonts:
+  heading: "Söhne, sans-serif"
+  faces:
+    - { family: "Söhne", src: /fonts/soehne-bold.woff2, weight: 700 }
+    - { family: "Söhne", src: /fonts/soehne-regular.woff2, weight: 400 }
+```
+
+**In a component, weight is yours; family is the site's.** Weight / size / style utilities (`font-bold`, `font-black`, `italic`, `text-xl`) are ordinary design vocabulary — use them freely. A font-**family** utility is only safe when the family behind it is site-controlled — and by default `font-sans` / `font-serif` are *not* (they resolve to Tailwind's built-in stacks; only `font-mono` tracks the site's `mono` role, by name-collision). So a bare `font-serif` in a component silently hardcodes a typeface.
+
+**When a design needs typefaces the element convention can't express** — an editorial serif on selected prose, a mono for metadata labels that aren't `<code>` — a foundation manages those explicitly instead of deferring. It uses the `font-serif` / `font-mono` (or `font-sans`) utility and declares each family as a **foundation var**, so the family stays site-controlled. The var drives its utility, and the family **loads** (via `fonts.import` / `fonts.faces`) even though it isn't one of the three `body`/`heading`/`mono` role slots:
+
+```js
+// foundation src/main.js — typefaces this foundation manages itself.
+// Defaults are OS stacks, so it renders native until a site opts in.
+export const vars = {
+  'font-sans':  { default: 'ui-sans-serif, system-ui, sans-serif', description: 'Base — headlines, UI, body' },
+  'font-serif': { default: 'ui-serif, Georgia, serif', description: 'Editorial — blurbs, taglines, quotes' },
+  'font-mono':  { default: 'ui-monospace, SFMono-Regular, monospace', description: 'Metadata — labels, dates, code' },
+}
+```
+
+Components keep using `font-sans` / `font-serif` / `font-mono` unchanged; the site sets each family in `theme.yml` under `vars:` and loads it with `fonts.import` / `fonts.faces`. (A custom name like `font-display` has no built-in utility — reference it with `var(--font-display)`.)
+
 ### Foundation variables
 
 Most customization is handled by component params. Both section components and layout components declare their own params in `meta.js` — layouts are full components with params, not just structural wrappers. A header height, for example, is typically a layout param, not a foundation var.

package/src/framework-index.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-14T12:34:40.728Z",
+  "generatedAt": "2026-07-17T23:45:26.497Z",
   "packages": {
     "@uniweb/build": {
-      "version": "0.14.24",
+      "version": "0.14.26",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -25,7 +25,7 @@
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.7.16",
+      "version": "0.7.18",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -43,7 +43,7 @@
       "deps": []
     },
     "@uniweb/kit": {
-      "version": "0.9.20",
+      "version": "0.9.22",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -61,7 +61,7 @@
       "deps": []
     },
     "@uniweb/runtime": {
-      "version": "0.8.22",
+      "version": "0.8.24",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -94,12 +94,12 @@
       "deps": []
     },
     "@uniweb/theming": {
-      "version": "0.1.5",
+      "version": "0.1.6",
       "path": "framework/theming",
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.4.32",
+      "version": "0.4.33",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",