uniweb 0.12.59 → 0.12.61

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.12.59",
+  "version": "0.12.61",
   "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/kit": "0.9.32",
-    "@uniweb/runtime": "0.8.31",
-    "@uniweb/core": "0.7.25"
+    "@uniweb/core": "0.7.26",
+    "@uniweb/kit": "0.9.33",
+    "@uniweb/runtime": "0.8.32"
   },
   "peerDependencies": {
+    "@uniweb/build": "0.14.40",
     "@uniweb/content-reader": "1.1.14",
-    "@uniweb/semantic-parser": "1.1.18",
-    "@uniweb/build": "0.14.39"
+    "@uniweb/semantic-parser": "1.1.18"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -555,7 +555,7 @@ This is [less important]{muted} context.
 
 `accent` and `callout` (both accent-colored + bold) and `muted` (subtle) are built-in defaults that adapt to context automatically. `--accent` is your brand color unless you declare a separate `colors.accent`, and resolves to the shade you authored — not a darkened one, since accent is decorative emphasis rather than body-size link text. Components receive HTML strings with spans applied: `<span accent="true">faster</span>`.
 
-Sites can override these or define additional named styles in `theme.yml`'s `inline:` section.
+Sites can adjust these or define additional named styles in `theme.yml`'s `inline:` section. Overrides merge **property by property**, so declare only what differs (`accent: { font-weight: inherit }` keeps the default color); to drop a default property rather than change it, give it a neutral value (`initial`, `inherit`, `unset`).
 
 ### Fenced Code in Content
 
@@ -2002,6 +2002,10 @@ Foundation styles in `styles.css`:
 
 Semantic tokens come from `theme-tokens.css` (populated from `theme.yml`). Use `@theme` only for values tokens don't cover. **Custom CSS is expected alongside Tailwind** — shadow systems, border hierarchies, gradients, glassmorphism. Tailwind handles layout; tokens handle context; `styles.css` handles everything else.
 
+**Don't set `scroll-behavior: smooth` globally.** It's a common line in a hand-written `html { … }` reset, and porting one into a foundation breaks navigation. The runtime owns scrolling: it already smooth-scrolls anchor targets itself (`scrollIntoView({ behavior: 'smooth' })`), so the CSS adds nothing there — but it resets and restores scroll on route changes with the two-argument `scrollTo(x, y)`, which *inherits* the property. Route changes then animate their scroll-to-top, and back-button restoration (which scrolls, checks the position on the next frame, and retries) keeps interrupting its own animation. Scope it to a specific scrollable element if you need it; never to `html` or `body`.
+
+**Font smoothing is a per-scheme decision, not a reset.** `-webkit-font-smoothing: antialiased` (macOS only) forces grayscale rasterization, which thins strokes. On dark surfaces that usefully counteracts the bloom of light text on near-black; on light surfaces it costs contrast and makes body text spindly. If you want it, scope it — `.scheme-dark { -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }` — rather than putting it on `html` the way most CSS resets do.
+
 ## Troubleshooting
 
 **"Could not load foundation"** — Check `site/package.json` has `"foundation": "file:../foundation"`.

package/src/commands/update.js

@@ -497,8 +497,14 @@ async function refreshAgents(ctx) {
   return 'created'
 }
 
-/** Print a compact recap of what changed, plus a review hint. */
-function printSummary({ editedPaths, depsEdited, installRan, installPm, agentsResult, cliVersion }) {
+/**
+ * Print a compact recap of what changed, plus a review hint.
+ *
+ * Exported for tests: the dev-server restart notice must fire exactly when the
+ * installed packages changed, and stay quiet otherwise (this runs on every
+ * `uniweb update`, including no-op ones).
+ */
+export function printSummary({ editedPaths, depsEdited, installRan, installPm, agentsResult, cliVersion }) {
   log(`${colors.bright}Summary${colors.reset}`)
   if (depsEdited) {
     log(`  ${colors.green}✓${colors.reset} package.json updated in ${editedPaths.length} file${editedPaths.length === 1 ? '' : 's'}`)
@@ -512,5 +518,18 @@ function printSummary({ editedPaths, depsEdited, installRan, installPm, agentsRe
   else if (agentsResult === 'updated') log(`  ${colors.green}✓${colors.reset} AGENTS.md updated (v${cliVersion})`)
   else if (agentsResult === 'skipped' && depsEdited) log(`  ${colors.dim}·${colors.reset} AGENTS.md not refreshed (see above)`)
   log(`${colors.dim}Review changes with${colors.reset} ${colors.cyan}git diff${colors.reset}${colors.dim}, then commit.${colors.reset}`)
+
+  // Only when the installed packages actually changed under a process that may
+  // still be running. This failure is nastier than it sounds: hot reload picks
+  // up your source but not a swapped dependency, so a dev server started before
+  // the update keeps serving the OLD framework against your NEW project code.
+  // The result looks like a bug you just introduced, and the one place nobody
+  // thinks to look is the server that has been running fine all along.
+  if (depsEdited && installRan) {
+    log('')
+    log(`${colors.yellow}↻${colors.reset}  ${colors.bright}Restart any running dev server.${colors.reset}`)
+    log(`${colors.dim}Hot reload picks up your source, not swapped dependencies — a running${colors.reset} ${colors.cyan}uniweb dev${colors.reset} ${colors.dim}keeps using the framework version it started with.${colors.reset}`)
+  }
+
   log('')
 }

package/src/framework-index.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-24T20:43:27.316Z",
+  "generatedAt": "2026-07-24T21:48:57.493Z",
   "packages": {
     "@uniweb/build": {
-      "version": "0.14.39",
+      "version": "0.14.40",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -25,7 +25,7 @@
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.7.25",
+      "version": "0.7.26",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -43,7 +43,7 @@
       "deps": []
     },
     "@uniweb/kit": {
-      "version": "0.9.32",
+      "version": "0.9.33",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -61,7 +61,7 @@
       "deps": []
     },
     "@uniweb/runtime": {
-      "version": "0.8.31",
+      "version": "0.8.32",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -94,12 +94,12 @@
       "deps": []
     },
     "@uniweb/theming": {
-      "version": "0.1.11",
+      "version": "0.1.12",
       "path": "framework/theming",
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.4.46",
+      "version": "0.4.48",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",