create-packkit 2.0.2 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Highly configurable scaffolder for modern npm packages and CLIs — pick your stack (TS/JS, bundler, tests, linter, CI, releases) from a CLI or a web configurator.",
   "type": "module",
   "bin": {
@@ -26,7 +26,8 @@
     "test": "node --test",
     "check:deps": "node scripts/check-template-deps.mjs",
     "integration": "node scripts/integration.mjs",
-    "build:web": "esbuild src/core/index.js --bundle --format=esm --outfile=docs/packkit-core.js"
+    "build:web": "esbuild src/core/index.js --bundle --format=esm --outfile=docs/packkit-core.js",
+    "update:node": "node scripts/update-node-versions.mjs"
   },
   "repository": {
     "type": "git",

package/src/cli/args.js

@@ -48,6 +48,7 @@ export function parseCliArgs(argv) {
       minify: { type: 'boolean' },
       monorepo: { type: 'boolean' },
       storybook: { type: 'boolean' },
+      e2e: { type: 'boolean' },
       'pkg-checks': { type: 'boolean' },
       knip: { type: 'boolean' },
       jsr: { type: 'boolean' },
@@ -74,6 +75,7 @@ export function parseCliArgs(argv) {
   if (values.minify) overrides.minify = true;
   if (values.monorepo) overrides.monorepo = true;
   if (values.storybook) overrides.storybook = true;
+  if (values.e2e) overrides.e2e = true;
   if (values['pkg-checks']) overrides.pkgChecks = true;
   if (values.knip) overrides.knip = true;
   if (values.jsr) overrides.jsr = true;

package/src/cli/index.js

@@ -3,7 +3,7 @@ import { readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import * as p from '@clack/prompts';
 import { generate, fromPreset, normalizeConfig, PRESET_NAMES, OPTIONS, PRESET_INFO, PRESET_ALIASES } from '../core/index.js';
-import { nodeFloor, meetsNodeFloor } from '../core/node.js';
+import { engineFloor, meetsNodeFloor } from '../core/node.js';
 import { parseCliArgs } from './args.js';
 import { runWizard } from './wizard.js';
 import { writeProject, dirIsEmptyOrMissing, gitInit, installDeps } from './write.js';
@@ -40,7 +40,8 @@ Options:
   --language <ts|js>  --module <esm|cjs|dual>  --framework <none|react|vue|svelte>
   --target <library|cli|service|app>   (repeatable)   --storybook
   --bundler <tsup|tsdown|unbuild|rollup|none>   --minify
-  --test <vitest|jest|node|none>  --lint <eslint-prettier|biome|oxlint|none>
+  --test <vitest|jest|node|none>   --e2e (Playwright, for apps)
+  --lint <eslint-prettier|biome|oxlint|none>
   --hooks <simple-git-hooks|husky|lefthook|none>  --release <changesets|release-it|np|none>
   --workflows <ci|npm-publish|pages|codeql|codecov|stale>   (repeatable)
   --deps <renovate|dependabot|none>  --license <MIT|Apache-2.0|ISC|none>
@@ -92,7 +93,7 @@ export async function run(argv = process.argv.slice(2)) {
   // require this floor. npm only *warns* on engines, so catch it here — clearly,
   // once — instead of letting a doomed install spew EBADENGINE and leave a broken
   // project. This is the signal both humans and agents need up front.
-  const floor = nodeFloor(config.nodeVersion);
+  const floor = engineFloor(config.nodeVersion);
   const nodeOk = meetsNodeFloor(process.version, floor);
   if (!nodeOk) {
     const lines = [

package/src/cli/wizard.js

@@ -36,6 +36,9 @@ export async function runWizard(seed = {}) {
     cfg.minify = bail(await p.confirm({ message: 'Minify the build output?', initialValue: false }));
   }
   cfg.test = bail(await p.select({ message: 'Test runner', options: asOptions('test'), initialValue: OPTIONS.test.default }));
+  if (cfg.target.includes('app')) {
+    cfg.e2e = bail(await p.confirm({ message: 'Add Playwright end-to-end tests?', initialValue: false }));
+  }
   cfg.lint = bail(await p.select({ message: 'Lint / format', options: asOptions('lint'), initialValue: OPTIONS.lint.default }));
   cfg.gitHooks = bail(await p.select({ message: 'Git hooks', options: asOptions('gitHooks'), initialValue: OPTIONS.gitHooks.default }));
   cfg.release = bail(await p.select({ message: 'Release / versioning', options: asOptions('release'), initialValue: OPTIONS.release.default }));

package/src/core/features/e2e.js

@@ -0,0 +1,47 @@
+// Playwright end-to-end tests for app targets: a config that boots the Vite
+// dev server, one smoke spec, the scripts and the dev dependency. The CI job
+// lives in workflows.js, which owns all workflow YAML.
+
+const DEV_URL = 'http://localhost:5173'; // Vite's default dev port
+
+const runDev = (cfg) => (cfg.packageManager === 'npm' ? 'npm run dev' : `${cfg.packageManager} dev`);
+
+export default {
+  id: 'e2e',
+  active: (cfg) => cfg.e2e && cfg.hasApp,
+  apply(cfg) {
+    const ext = cfg.ext; // 'ts' | 'js' — config/specs never need JSX
+    const files = {};
+    const pkg = { scripts: {}, devDependencies: { '@playwright/test': '^1.50.0' } };
+
+    files[`playwright.config.${ext}`] = [
+      `import { defineConfig, devices } from '@playwright/test';`,
+      ``,
+      `export default defineConfig({`,
+      `\ttestDir: './e2e',`,
+      `\tuse: { baseURL: '${DEV_URL}', trace: 'on-first-retry' },`,
+      `\t// Playwright starts the app for you and waits for it to be ready.`,
+      `\twebServer: {`,
+      `\t\tcommand: '${runDev(cfg)}',`,
+      `\t\turl: '${DEV_URL}',`,
+      `\t\treuseExistingServer: !process.env.CI,`,
+      `\t},`,
+      `\tprojects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],`,
+      `});`,
+      ``,
+    ].join('\n');
+
+    files[`e2e/app.spec.${ext}`] = [
+      `import { test, expect } from '@playwright/test';`,
+      ``,
+      `test('renders the app', async ({ page }) => {`,
+      `\tawait page.goto('/');`,
+      `\tawait expect(page.getByRole('heading', { name: /Hello from/ })).toBeVisible();`,
+      `});`,
+      ``,
+    ].join('\n');
+
+    pkg.scripts['test:e2e'] = 'playwright test';
+    return { files, pkg };
+  },
+};

package/src/core/features/gitfiles.js

@@ -10,6 +10,11 @@ dist/
 coverage/
 *.tsbuildinfo
 
+# test artifacts (Playwright)
+test-results/
+playwright-report/
+playwright/.cache/
+
 # logs
 *.log
 npm-debug.log*

package/src/core/features/githooks.js

@@ -34,8 +34,8 @@ export default {
 
     if (needsLintStaged) {
       pkg['lint-staged'] = staged;
-      // Held at 16: v17 requires Node >=22.22.1, which would silently drop
-      // Node 20 LTS support for every generated project. See NODE_FLOOR.
+      // Held at 16: v17 requires Node >=22.22.1, above our Node 22 engines
+      // floor (22.13) — it would break the Maintenance-LTS line. See ENGINE_MIN.
       pkg.devDependencies['lint-staged'] = '^16.2.0';
     }
 

package/src/core/features/index.js

@@ -8,6 +8,7 @@ import frameworks from './frameworks.js';
 import vite from './vite.js';
 import service from './service.js';
 import test from './test.js';
+import e2e from './e2e.js';
 import lint from './lint.js';
 import githooks from './githooks.js';
 import release from './release.js';
@@ -29,6 +30,7 @@ export default [
   vite,
   service,
   test,
+  e2e,
   lint,
   githooks,
   release,

package/src/core/features/meta.js

@@ -1,6 +1,6 @@
 // Always-on: base package.json descriptive fields + the source entry + README.
 
-import { nodeFloor } from '../node.js';
+import { engineFloor, nodePin } from '../node.js';
 
 export default {
   id: 'meta',
@@ -12,7 +12,7 @@ export default {
       version: '0.0.0',
       description: cfg.description || '',
       type: cfg.moduleFormat === 'cjs' ? 'commonjs' : 'module',
-      engines: { node: `>=${nodeFloor(cfg.nodeVersion)}` },
+      engines: { node: `>=${engineFloor(cfg.nodeVersion)}` },
       scripts: {},
     };
 
@@ -35,8 +35,9 @@ export default {
     // README
     files['README.md'] = readme(cfg);
 
-    // Node version pin — the honest floor, so `nvm use` can't land below it.
-    files['.nvmrc'] = `${nodeFloor(cfg.nodeVersion)}\n`;
+    // Node version pin — that line's newest patch (from Node's own data), so
+    // `nvm use` lands on a current, real release.
+    files['.nvmrc'] = `${nodePin(cfg.nodeVersion)}\n`;
 
     // A typecheck script for TS projects — framework-aware (plain tsc can't
     // resolve .vue/.svelte modules).
@@ -118,7 +119,7 @@ function readme(cfg) {
   lines.push(
     '## Requirements',
     '',
-    `Node.js >= ${nodeFloor(cfg.nodeVersion)} (\`.nvmrc\` pins it; run \`nvm use\`). Enforced via \`engine-strict\`, so installs fail fast on an unsupported version.`,
+    `Node.js >= ${engineFloor(cfg.nodeVersion)} (\`.nvmrc\` pins ${nodePin(cfg.nodeVersion)}; run \`nvm use\`). Enforced via \`engine-strict\`, so installs fail fast on an unsupported version.`,
     '',
   );
 

package/src/core/features/test.js

@@ -26,6 +26,9 @@ export default {
         `export default defineConfig({`,
         fw ? `\tplugins: [${fw.call}],` : null,
         `\ttest: {`,
+        // Keep Vitest to unit tests under src/ so it never tries to run the
+        // Playwright specs in e2e/ (they share the *.spec.ts glob).
+        cfg.e2e ? `\t\tinclude: ['src/**/*.{test,spec}.{js,jsx,ts,tsx}'],` : null,
         cfg.hasFramework ? `\t\tenvironment: 'jsdom',` : null,
         cfg.hasFramework ? `\t\tglobals: true,` : null,
         cfg.coverage ? `\t\tcoverage: { provider: 'v8', reporter: ['text', 'lcov'] },` : null,

package/src/core/features/workflows.js

@@ -41,6 +41,7 @@ export default {
     if (wf.includes('pages')) files['.github/workflows/pages.yml'] = pagesWorkflow(cfg);
     if (wf.includes('codeql')) files['.github/workflows/codeql.yml'] = codeqlWorkflow();
     if (wf.includes('stale')) files['.github/workflows/stale.yml'] = staleWorkflow();
+    if (cfg.e2e && cfg.hasApp && wf.includes('ci')) files['.github/workflows/e2e.yml'] = e2eWorkflow(cfg);
 
     if (cfg.deps === 'renovate') {
       files['.github/renovate.json'] = toJson({
@@ -199,6 +200,30 @@ function codeqlWorkflow() {
   ].join('\n');
 }
 
+function e2eWorkflow(cfg) {
+  return [
+    'name: E2E',
+    'on:',
+    '  push:',
+    '    branches: [main]',
+    '  pull_request:',
+    'jobs:',
+    '  e2e:',
+    '    runs-on: ubuntu-latest',
+    '    steps:',
+    setupSteps(cfg),
+    '      - run: npx playwright install --with-deps chromium',
+    `      - run: ${pmRun(cfg, 'test:e2e')}`,
+    '      - uses: actions/upload-artifact@v4',
+    '        if: ${{ !cancelled() }}',
+    '        with:',
+    '          name: playwright-report',
+    '          path: playwright-report/',
+    '          retention-days: 7',
+    '',
+  ].join('\n');
+}
+
 function staleWorkflow() {
   return [
     'name: Stale',

package/src/core/node-versions.js

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by scripts/update-node-versions.mjs — do not edit by hand.
+// Source: nodejs.org/dist + nodejs/Release schedule, refreshed 2026-07-14.
+// Offered lines track the Node release schedule; each version is that line's
+// newest published patch. Run `node scripts/update-node-versions.mjs` to refresh.
+
+export const NODE_LINES = {
+  '24': { version: '24.18.0', status: 'active-lts', codename: 'Krypton', label: '24 (Active LTS, "Krypton")' },
+  '22': { version: '22.23.1', status: 'maintenance', codename: 'Jod', label: '22 (Maintenance LTS, "Jod")' },
+  '26': { version: '26.5.0', status: 'current', codename: null, label: '26 (Current)' },
+};
+
+export const DEFAULT_NODE = '24';

package/src/core/node.js

@@ -1,18 +1,30 @@
-// Shared Node-version floor logic. Browser-safe (no node builtins) so both the
-// generator and the CLI preflight agree on exactly one source of truth.
+// Shared Node-version logic. Browser-safe (no node builtins) so the generator
+// and the CLI preflight agree on exactly one source of truth.
+//
+// Two concerns, two sources:
+//   - which majors we offer + the exact patch to pin  -> node-versions.js,
+//     auto-derived from Node's release schedule + dist index (never guessed).
+//   - the minimum patch *within a major* our template deps need -> ENGINE_MIN,
+//     below, driven by our deps (eslint/vite), governed by the template-deps
+//     freshness workflow. These change rarely and independently of Node.
 
-// The real minimum patch for each supported major, driven by our template deps
-// (eslint 10, jsdom 29, vite 8 need ^20.19; vite/others need ^22.12). Writing a
-// bare ">=20" would be a lie — a user on 20.17 hits EBADENGINE and transitive
-// syntax errors. Keep this honest.
-export const NODE_FLOOR = { 18: '18.18.0', 20: '20.19.0', 22: '22.12.0', 24: '24.0.0' };
+import { NODE_LINES, DEFAULT_NODE } from './node-versions.js';
 
-export const nodeFloor = (v) => NODE_FLOOR[v] || `${v}.0.0`;
+export { NODE_LINES, DEFAULT_NODE };
+
+// eslint 10 needs ^20.19/^22.13; vite 8 needs ^20.19/^22.12 — take the max.
+export const ENGINE_MIN = { 18: '18.18.0', 20: '20.19.0', 22: '22.13.0' };
+
+/** The `engines` minimum for a target major (a floor, not a pin). */
+export const engineFloor = (v) => ENGINE_MIN[v] || `${v}.0.0`;
+
+/** The exact version to pin in `.nvmrc` — that line's newest patch, or the floor. */
+export const nodePin = (v) => NODE_LINES[v]?.version || engineFloor(v);
 
 const parts = (s) =>
   String(s).replace(/^v/, '').split('.').map((n) => parseInt(n, 10) || 0);
 
-/** True if `current` (e.g. "v20.17.0" or process.version) is >= `floor` ("20.19.0"). */
+/** True if `current` (e.g. "v22.5.0" or process.version) is >= `floor` ("22.13.0"). */
 export function meetsNodeFloor(current, floor) {
   const [a, b, c] = parts(current);
   const [x, y, z] = parts(floor);

package/src/core/options.js

@@ -2,8 +2,14 @@
 // Both the CLI wizard and the web configurator render from this schema, and
 // `normalizeConfig` turns partial/user input into a complete, valid config.
 
+import { NODE_LINES, DEFAULT_NODE } from './node.js';
+
 /** @typedef {'select'|'multiselect'|'boolean'|'text'} OptionType */
 
+// Node choices are derived from Node's own release schedule (see node-versions.js)
+// so the LTS/Current lines and their patches stay current without hand-editing.
+const NODE_CHOICES = Object.entries(NODE_LINES).map(([value, info]) => ({ value, label: info.label }));
+
 export const OPTIONS = {
   // ---- package metadata ----
   name: { group: 'meta', type: 'text', label: 'Package name', default: 'my-package' },
@@ -59,12 +65,8 @@ export const OPTIONS = {
     ],
   },
   nodeVersion: {
-    group: 'core', type: 'select', label: 'Node version', default: '20',
-    choices: [
-      { value: '20', label: '20 (LTS, ≥20.19)' },
-      { value: '22', label: '22 (LTS, ≥22.12)' },
-      { value: '24', label: '24 (Current)' },
-    ],
+    group: 'core', type: 'select', label: 'Node version', default: DEFAULT_NODE,
+    choices: NODE_CHOICES,
   },
 
   // ---- build ----
@@ -94,6 +96,7 @@ export const OPTIONS = {
   },
   coverage: { group: 'quality', type: 'boolean', label: 'Coverage reporting', default: true },
   storybook: { group: 'quality', type: 'boolean', label: 'Storybook (component libraries)', default: false },
+  e2e: { group: 'quality', type: 'boolean', label: 'Playwright end-to-end tests (apps)', default: false },
   pkgChecks: { group: 'quality', type: 'boolean', label: 'Package checks (publint + are-the-types-wrong)', default: false },
   knip: { group: 'quality', type: 'boolean', label: 'Knip (unused files / deps / exports)', default: false },
 
@@ -243,6 +246,9 @@ export function normalizeConfig(input = {}) {
   // Storybook only applies to component libraries.
   if (!cfg.hasFramework || cfg.hasApp || !cfg.hasLibrary) cfg.storybook = false;
 
+  // Playwright E2E only applies to app targets.
+  if (!cfg.hasApp) cfg.e2e = false;
+
   // A monorepo is its own generation path (see buildMonorepo); it has a build.
   if (cfg.monorepo) cfg.hasBuild = true;