create-packkit 1.5.0 → 2.0.1

package/README.md

@@ -33,7 +33,7 @@ No install needed: **[danmat.github.io/create-packkit](https://danmat.github.io/
 | Area | Options |
 |---|---|
 | **Language** | TypeScript (strict) · JavaScript (ESM) |
-| **Module format** | ESM · CJS · dual (proper `exports` map) |
+| **Module format** | **ESM-only (default)** · dual (ESM + CJS) · CJS — proper `exports` map |
 | **Target** | Library · CLI tool · **HTTP service (Hono)** · **App (Vite SPA)** · any combination |
 | **Framework** | None · **React** · **Vue** · **Svelte** (component libraries or apps) |
 | **Storybook** | optional, for React / Vue / Svelte component libraries |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "1.5.0",
+  "version": "2.0.1",
   "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": {

package/src/core/features/githooks.js

@@ -34,7 +34,9 @@ export default {
 
     if (needsLintStaged) {
       pkg['lint-staged'] = staged;
-      pkg.devDependencies['lint-staged'] = '^17.0.0';
+      // Held at 16: v17 requires Node >=22.22.1, which would silently drop
+      // Node 20 LTS support for every generated project. See NODE_FLOOR.
+      pkg.devDependencies['lint-staged'] = '^16.2.0';
     }
 
     return { files, pkg };

package/src/core/features/meta.js

@@ -1,5 +1,11 @@
 // Always-on: base package.json descriptive fields + the source entry + README.
 
+// The real minimum patch for each major, driven by our template deps (eslint 10,
+// jsdom 29, vite 8 need ^20.19; vite/others need ^22.12). `>=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' };
+const nodeFloor = (v) => NODE_FLOOR[v] || `${v}.0.0`;
+
 export default {
   id: 'meta',
   active: () => true,
@@ -10,7 +16,7 @@ export default {
       version: '0.0.0',
       description: cfg.description || '',
       type: cfg.moduleFormat === 'cjs' ? 'commonjs' : 'module',
-      engines: { node: `>=${cfg.nodeVersion}` },
+      engines: { node: `>=${nodeFloor(cfg.nodeVersion)}` },
       scripts: {},
     };
 
@@ -33,8 +39,8 @@ export default {
     // README
     files['README.md'] = readme(cfg);
 
-    // Node version pin
-    files['.nvmrc'] = `${cfg.nodeVersion}\n`;
+    // Node version pin — the honest floor, so `nvm use` can't land below it.
+    files['.nvmrc'] = `${nodeFloor(cfg.nodeVersion)}\n`;
 
     // A typecheck script for TS projects — framework-aware (plain tsc can't
     // resolve .vue/.svelte modules).

package/src/core/options.js

@@ -21,11 +21,11 @@ export const OPTIONS = {
     ],
   },
   moduleFormat: {
-    group: 'core', type: 'select', label: 'Module format', default: 'dual',
+    group: 'core', type: 'select', label: 'Module format', default: 'esm',
     choices: [
-      { value: 'esm', label: 'ESM only' },
-      { value: 'cjs', label: 'CommonJS only' },
+      { value: 'esm', label: 'ESM only (recommended)' },
       { value: 'dual', label: 'Dual (ESM + CJS)' },
+      { value: 'cjs', label: 'CommonJS only' },
     ],
   },
   target: {
@@ -61,9 +61,9 @@ export const OPTIONS = {
   nodeVersion: {
     group: 'core', type: 'select', label: 'Node version', default: '20',
     choices: [
-      { value: '18', label: '18 (LTS)' },
-      { value: '20', label: '20 (LTS)' },
-      { value: '22', label: '22 (LTS)' },
+      { value: '20', label: '20 (LTS, ≥20.19)' },
+      { value: '22', label: '22 (LTS, ≥22.12)' },
+      { value: '24', label: '24 (Current)' },
     ],
   },
 

package/src/core/presets.js

@@ -2,12 +2,12 @@
 // the wizard: `npx packkit ts-lib my-project`.
 
 export const PRESETS = {
-  'ts-lib': { language: 'ts', target: ['library'], moduleFormat: 'dual' },
-  'js-lib': { language: 'js', target: ['library'], moduleFormat: 'dual', bundler: 'tsup' },
+  'ts-lib': { language: 'ts', target: ['library'], moduleFormat: 'esm' },
+  'js-lib': { language: 'js', target: ['library'], moduleFormat: 'esm', bundler: 'tsup' },
   'ts-cli': { language: 'ts', target: ['cli', 'library'], moduleFormat: 'esm' },
   cli: { language: 'ts', target: ['cli', 'library'], moduleFormat: 'esm' },
-  'react-lib': { language: 'ts', framework: 'react', target: ['library'], moduleFormat: 'dual', test: 'vitest' },
-  'react-lib-js': { language: 'js', framework: 'react', target: ['library'], moduleFormat: 'dual', bundler: 'tsup', test: 'vitest' },
+  'react-lib': { language: 'ts', framework: 'react', target: ['library'], moduleFormat: 'esm', test: 'vitest' },
+  'react-lib-js': { language: 'js', framework: 'react', target: ['library'], moduleFormat: 'esm', bundler: 'tsup', test: 'vitest' },
   'react-app': { language: 'ts', framework: 'react', target: ['app'], test: 'vitest', release: 'none', workflows: ['ci'] },
   'vue-lib': { language: 'ts', framework: 'vue', target: ['library'], test: 'vitest' },
   'vue-app': { language: 'ts', framework: 'vue', target: ['app'], test: 'vitest', release: 'none', workflows: ['ci'] },
@@ -20,19 +20,19 @@ export const PRESETS = {
   },
   monorepo: { monorepo: true, language: 'ts', packageManager: 'pnpm' },
   oss: {
-    language: 'ts', target: ['library'], moduleFormat: 'dual', bundler: 'tsup',
+    language: 'ts', target: ['library'], moduleFormat: 'esm', bundler: 'tsup',
     test: 'vitest', coverage: true, lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
     release: 'changesets', workflows: ['ci', 'npm-publish', 'codeql', 'codecov'],
     deps: 'renovate', community: true, agents: true, vscode: true,
     pkgChecks: true, knip: true,
   },
   minimal: {
-    language: 'ts', target: ['library'], moduleFormat: 'dual', bundler: 'tsup',
+    language: 'ts', target: ['library'], moduleFormat: 'esm', bundler: 'tsup',
     test: 'none', lint: 'none', gitHooks: 'none', release: 'none',
     workflows: ['ci'], deps: 'none', community: false, agents: false, vscode: false,
   },
   full: {
-    language: 'ts', target: ['library', 'cli'], moduleFormat: 'dual', bundler: 'tsup',
+    language: 'ts', target: ['library', 'cli'], moduleFormat: 'esm', bundler: 'tsup',
     test: 'vitest', coverage: true, lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
     release: 'changesets',
     workflows: ['ci', 'npm-publish', 'pages', 'codeql', 'codecov', 'stale'],
@@ -65,14 +65,14 @@ export function resolvePreset(name) {
 
 // Short gists for the CLI help and the web configurator (tooltips + description).
 export const PRESET_INFO = {
-  'ts-lib': 'TypeScript library — dual ESM/CJS, tsup, Vitest, ESLint.',
+  'ts-lib': 'TypeScript library — ESM-only, tsup, Vitest, ESLint.',
   'js-lib': 'JavaScript (ESM) library — tsup, Vitest, ESLint.',
   'ts-cli': 'TypeScript CLI + library — ESM, ships a bin.',
   cli: 'TypeScript CLI tool — ESM, ships a bin.',
   'react-lib': 'React component library (TS) — JSX, peer deps, jsdom tests.',
   'react-lib-js': 'React component library (JS) — JSX, peer deps, jsdom tests.',
   'react-app': 'React SPA — Vite dev server, build, Testing Library.',
-  'vue-lib': 'Vue component library — Vite lib build (SFCs), dual + types.',
+  'vue-lib': 'Vue component library — Vite lib build (SFCs), ESM + types.',
   'vue-app': 'Vue SPA — Vite dev server, build, Testing Library.',
   'svelte-lib': 'Svelte component library — ships source, peer svelte, jsdom tests.',
   'svelte-app': 'Svelte SPA — Vite dev server, build, Testing Library.',