@nera-static/nera 1.13.0 → 1.14.1

package/README.md

@@ -36,12 +36,16 @@ package is named after the folder (`My Bakery` → `my-bakery`).
 | `nera check` | Check the built `public/` for accessibility, privacy and legal-notice problems (see below). Build first. `--json` for machine-readable output. |
 
 A scaffolded site is a thin project — no vendored engine, no clone. It lists one
-dependency and its scripts call the CLI:
+dependency, a caret range starting at the version of the CLI that created it,
+and its scripts call the CLI:
 
 ```jsonc
 {
-  "scripts": { "dev": "nera dev", "build": "nera build", "serve": "nera serve" },
-  "dependencies": { "@nera-static/nera": "^1.0.0" }
+  "scripts": {
+    "dev": "nera dev", "build": "nera build", "serve": "nera serve",
+    "validate": "nera validate", "check": "nera build --check"
+  },
+  "dependencies": { "@nera-static/nera": "^1.14.1" }
 }
 ```
 
@@ -130,7 +134,7 @@ depends on still updates through npm).
 `--starter` takes:
 
 - a starter name: `blank` → `@nera-static/starter-blank`, `blog` →
-  `@nera-static/starter-blog`;
+  `@nera-static/starter-blog`, `business` → `@nera-static/starter-business`;
 - a package name: `@acme/starter-shop`, or unscoped `nera-starter-shop`;
 - a GitHub URL: `https://github.com/owner/repo` (optionally `.git`, `#ref`),
   or `github:owner/repo#ref`;
@@ -162,8 +166,11 @@ default. Every question has a flag (`--starter`, `--name`, `--lang`); with
 `nera new` scaffolds the base template.
 
 The official starters: `blank` (`@nera-static/starter-blank`, one accessible
-layout, no theme) and `blog` (`@nera-static/starter-blog`, a blog on
-`@nera-static/theme-blog` with tags, an archive, an Atom feed and a sitemap).
+layout, no theme), `blog` (`@nera-static/starter-blog`, a blog on
+`@nera-static/theme-blog` with tags, an archive, an Atom feed and a sitemap)
+and `business` (`@nera-static/starter-business`, a small-business site on
+`@nera-static/theme-business` with services, opening hours and a contact
+form).
 
 ## Checking the built site
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nera-static/nera",
-    "version": "1.13.0",
+    "version": "1.14.1",
     "description": "The Nera CLI — scaffold, build, preview and update a Nera static site with one command over the @nera-static/core engine",
     "type": "module",
     "bin": {

package/src/commands/update.js

@@ -3,7 +3,7 @@ import fs from 'fs/promises'
 import fssync from 'fs'
 import path from 'path'
 import { syncAgentFiles, SITE_NOTES_MARKER } from '../agent-files.js'
-import { templateDir as packageTemplateDir } from '../scaffold.js'
+import { ownRange, templateDir as packageTemplateDir } from '../scaffold.js'
 import { installedSkillDir, skillSourceDir, syncSkill } from '../skill.js'
 
 const defaultRunNpm = (npmArgs, cwd) =>
@@ -107,7 +107,7 @@ async function migrateLegacy(cwd, pkg, runNpm, templateDir, skillDir) {
 
     pkg.dependencies = {
         ...pkg.dependencies,
-        '@nera-static/nera': '^1.0.0',
+        '@nera-static/nera': ownRange(),
     }
 
     pkg.scripts = {

package/src/scaffold.js

@@ -138,6 +138,14 @@ const isStarterTemplate = async (file) =>
 export const templateDir = () =>
     path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'template')
 
+// The range a new or migrated site depends on: this CLI's own version, so the
+// site never claims to work with an older one that lacks what set it up
+// (starters, `nera check`, the `validate`/`check` scripts).
+export const ownRange = () => {
+    const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json')
+    return `^${JSON.parse(fssync.readFileSync(pkgPath, 'utf-8')).version}`
+}
+
 async function copyDir(src, dest, { skipStarters = false } = {}) {
     await fs.mkdir(dest, { recursive: true })
     for (const entry of await fs.readdir(src, { withFileTypes: true })) {
@@ -165,6 +173,7 @@ async function personalize(targetDir, projectName) {
     const pkgPath = path.join(targetDir, 'package.json')
     const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8'))
     pkg.name = projectName
+    pkg.dependencies = { ...pkg.dependencies, '@nera-static/nera': ownRange() }
     await fs.writeFile(pkgPath, `${JSON.stringify(pkg, null, 4)}\n`)
     console.log(`  ✓ Configured project as "${projectName}"`)
 }

package/src/starters.js

@@ -15,4 +15,10 @@ export const BUNDLED_STARTERS = [
         label: 'Blog',
         description: 'A ready-to-edit Nera blog on @nera-static/theme-blog: three sample posts, tags, an archive by year, prev/next, an Atom feed, a sitemap, code blocks, navigation, responsive images, social links and imprint and privacy placeholders. No JavaScript.',
     },
+    {
+        name: 'business',
+        package: '@nera-static/starter-business',
+        label: 'Business',
+        description: 'A ready-to-edit Nera site for a small business on @nera-static/theme-business: home, about, services, opening hours, a contact form, navigation, responsive images, social links, a sitemap and imprint and privacy placeholders. One small script for the contact form.',
+    },
 ]