uniweb 1.0.1 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -34,22 +34,22 @@
     "url": "https://github.com/uniweb/cli/issues"
   },
   "engines": {
-    "node": ">=20.19"
+    "node": ">=22.12"
   },
   "dependencies": {
     "handlebars": "^4.7.8",
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/schemas": "~1.0.1",
     "@uniweb/semantic-parser": "~1.5.1",
-    "@uniweb/core": "~1.0.1",
-    "@uniweb/content-writer": "~1.0.1"
+    "@uniweb/core": "~1.1.0",
+    "@uniweb/content-writer": "~1.0.1",
+    "@uniweb/schemas": "~1.0.1"
   },
   "peerDependencies": {
+    "@uniweb/content-reader": "~1.2.8",
     "@uniweb/semantic-parser": "~1.5.1",
-    "@uniweb/build": "~1.0.1",
-    "@uniweb/content-reader": "~1.2.8"
+    "@uniweb/build": "~1.1.0"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -2801,7 +2801,7 @@ npx uniweb@latest update             # apply: align @uniweb/* deps AND refresh A
 
 **`npx uniweb@latest update` is the command for bringing a project up to date.** It aligns the project's `@uniweb/*` dependencies *and* this AGENTS.md to the version matrix of the CLI that runs it. Deps and documentation move together — that's the whole point of the verb.
 
-**What the version numbers mean.** A patch brings fixes and features; a minor version is where Uniweb puts breaking changes — `update` lists each package that crosses one, so read those before shipping — and a major is kept for something really big. Dependencies are written as tilde ranges (`~0.20.1`), so `pnpm install` and `pnpm update` never cross a minor on their own.
+**What the version numbers mean.** A patch brings fixes and features; a minor version is where Uniweb puts breaking changes — `update` lists each package that crosses one, so build and check the project before shipping — and a major is kept for something really big. Dependencies are written as tilde ranges (`~1.0.1`), so `pnpm install` and `pnpm update` never cross a minor on their own. The move from 0.x to 1.0.1 asks nothing of a project that was on the latest 0.x versions — 1.0.1 carried every package's 0.x line over — though `update` marks each package `major · BREAKING`.
 
 > ### ⛔ WRITE `@latest`. A BARE `uniweb update` IS USUALLY A NO-OP, AND IT SAYS SO CONVINCINGLY
 >

package/src/commands/add.js

@@ -1589,7 +1589,7 @@ async function addCi(rootDir, opts, pm = 'pnpm') {
   }
 
   // Read node version from root package.json engines.node if pinned;
-  // otherwise default to 20 (matches the workspace template's >=20.19).
+  // otherwise default to 22, the framework's own floor (>=22.12).
   const rootPkg = JSON.parse(
     await readFile(join(rootDir, 'package.json'), 'utf-8').catch(() => '{}')
   )

package/src/commands/update.js

@@ -304,11 +304,13 @@ export function printSurvey(
       const r = breakingRows.find((x) => x.name === name)
       log(`     ${colors.red}${name}${colors.reset}  ${r.current} → ${r.target}  ${colors.dim}(${r.bump})${colors.reset}`)
     }
+    // ⛔ The second line said "Read their changelogs before shipping" until 2026-10-13,
+    // when most packages kept none.
     log(
-      `   ${colors.dim}A minor version is where Uniweb's breaking changes go, so these are releases${colors.reset}`
+      `   ${colors.dim}A minor version is where Uniweb's breaking changes go (a major is rarer still),${colors.reset}`
     )
     log(
-      `   ${colors.dim}you may need to act on. Read their changelogs before shipping.${colors.reset}`
+      `   ${colors.dim}so these are releases you may need to act on: build and check before shipping.${colors.reset}`
     )
   }
   log('')
@@ -374,6 +376,8 @@ export async function update(args = []) {
   const depsOnly = args.includes('--deps-only')
   const skipAgents = args.includes('--no-agents') || depsOnly
   const skipDeps = args.includes('--no-deps') || agentsOnly
+  // The flag that kept the deps step from running — what the AGENTS.md step's hint names.
+  const depsSkippedBy = agentsOnly ? '--agents-only' : skipDeps ? '--no-deps' : null
   const dryRun = args.includes('--dry-run')
   const allowMismatch = args.includes('--allow-mismatch')
   const verbose = args.includes('--verbose')
@@ -636,6 +640,7 @@ export async function update(args = []) {
       hasYes,
       nonInteractive,
       agentsOnly,
+      depsSkippedBy,
       depsEdited,
       installRan,
       installPm
@@ -734,6 +739,7 @@ async function refreshAgents(ctx) {
     hasYes,
     nonInteractive,
     agentsOnly,
+    depsSkippedBy,
     depsEdited,
     installRan,
     installPm
@@ -757,13 +763,21 @@ async function refreshAgents(ctx) {
   // Re-survey: deps may have just been edited+installed, which clears the
   // declared-deps gate.
   const finalSurvey = await surveyWorkspaceDeps(workspaceDir)
-  if (finalSurvey.anyDrift && !allowMismatch) {
+  // ⭐ A dry run moves no deps, so they still lag here whenever the deps step has
+  // something to align — while the run it previews aligns and installs them before
+  // this step. Say what that run would do, rather than that this step would skip.
+  const onceInstalled = finalSurvey.anyDrift && dryRun && !depsSkippedBy
+  if (finalSurvey.anyDrift && !allowMismatch && !onceInstalled) {
     warn('AGENTS.md refresh skipped: workspace deps still lag the CLI.')
     log(
       `${colors.dim}AGENTS.md from v${cliVersion} would document features not in your installed packages.${colors.reset}`
     )
+    // ⛔ This always said "Re-run without --no-deps": wrong under --agents-only, and
+    // when the deps edit was declined or left to a non-interactive run's plan.
     log(
-      `${colors.dim}Re-run without ${colors.reset}${colors.cyan}--no-deps${colors.reset}${colors.dim}, or pass ${colors.reset}${colors.cyan}--allow-mismatch${colors.reset}${colors.dim} to override.${colors.reset}`
+      depsSkippedBy
+        ? `${colors.dim}Re-run without ${colors.reset}${colors.cyan}${depsSkippedBy}${colors.reset}${colors.dim}, or pass ${colors.reset}${colors.cyan}--allow-mismatch${colors.reset}${colors.dim} to override.${colors.reset}`
+        : `${colors.dim}Align the deps first — accept the edit, or re-run with ${colors.reset}${colors.cyan}--yes${colors.reset}${colors.dim} — or pass ${colors.reset}${colors.cyan}--allow-mismatch${colors.reset}${colors.dim} to override.${colors.reset}`
     )
     log('')
     if (agentsOnly) process.exit(1)
@@ -797,7 +811,7 @@ async function refreshAgents(ctx) {
 
   if (dryRun) {
     info(
-      `Dry-run: would ${currentAgentsVersion ? `update AGENTS.md (v${currentAgentsVersion} → v${cliVersion})` : `create AGENTS.md (v${cliVersion})`}${keeping}.`
+      `Dry-run: would ${currentAgentsVersion ? `update AGENTS.md (v${currentAgentsVersion} → v${cliVersion})` : `create AGENTS.md (v${cliVersion})`}${keeping}${onceInstalled ? ', once the deps above are installed' : ''}.`
     )
     return 'skipped'
   }

package/src/framework-index.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-13T13:52:13.916Z",
+  "generatedAt": "2026-10-13T18:18:01.170Z",
   "packages": {
     "@uniweb/api": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/build": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/content-reader": {
       "version": "1.2.8"
@@ -15,28 +15,28 @@
       "version": "1.0.1"
     },
     "@uniweb/core": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/frame-bridge": {
-      "version": "1.0.1"
+      "version": "1.0.2"
     },
     "@uniweb/icons": {
-      "version": "1.0.1"
+      "version": "1.0.2"
     },
     "@uniweb/kit": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/loom": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/press": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/projections": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/runtime": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/scene": {
       "version": "1.0.1"
@@ -45,22 +45,22 @@
       "version": "1.0.1"
     },
     "@uniweb/scholar": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/semantic-parser": {
       "version": "1.5.1"
     },
     "@uniweb/snapshot": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/templates": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/theming": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     },
     "@uniweb/unipress": {
-      "version": "1.0.1"
+      "version": "1.1.0"
     }
   },
   "templates": {

package/src/versions.js

@@ -98,7 +98,7 @@ export const PNPM_VERSION = '11'
  * before Node 22 — pairing it with Node 20 fails at `pnpm install` with
  * `ERR_UNKNOWN_BUILTIN_MODULE` before the build is attempted. That was the
  * default until 2026-07-21, because the CI node major came from the
- * project's `engines.node` and the workspace template declares `>=20.19`.
+ * project's `engines.node` and the workspace template declared `>=20.19`.
  *
  * Verify with `npm view pnpm@<major> engines` when adding an entry.
  */
@@ -153,14 +153,16 @@ export function resolveCiPnpmVersion(rootPkg, installedMajor = null) {
  * @param {string|null|undefined} enginesNode — the project's `engines.node`.
  * @param {'pnpm'|'npm'|'yarn'} packageManager
  * @param {string} [pnpmVersion] — the resolved pnpm major, when pnpm.
- * @param {string} [fallback='20'] — used when engines.node is absent/unparseable.
+ * @param {string} [fallback='22'] — used when engines.node is absent/unparseable:
+ *   the framework's own floor (`>=22.12`), which a scaffolded project inherits
+ *   through its `@uniweb/*` dependencies without declaring one.
  * @returns {string} Node major, as a string for YAML interpolation.
  */
 export function resolveCiNodeVersion(
   enginesNode,
   packageManager,
   pnpmVersion = PNPM_VERSION,
-  fallback = '20'
+  fallback = '22'
 ) {
   const match = enginesNode ? String(enginesNode).match(/(\d+)/) : null
   const declared = match ? Number(match[1]) : Number(fallback)