create-packkit 0.3.0 → 0.4.0

package/README.md

@@ -34,9 +34,9 @@ No install needed: **[danmat.github.io/create-packkit](https://danmat.github.io/
 |---|---|
 | **Language** | TypeScript (strict) · JavaScript (ESM) |
 | **Module format** | ESM · CJS · dual (proper `exports` map) |
-| **Target** | Library · CLI tool · both |
+| **Target** | Library · CLI tool · **HTTP service (Hono)** · any combination |
 | **Framework** | None · **React** (component library — JSX, peer deps, jsdom tests) |
-| **Bundler** | tsup · tsdown · unbuild · rollup · none (tsc) |
+| **Bundler** | tsup · tsdown · unbuild · rollup · none (tsc) · optional **minify** |
 | **Tests** | Vitest · Jest · node:test · none (+ coverage) |
 | **Lint/format** | ESLint + Prettier · Biome · oxlint · none |
 | **Git hooks** | simple-git-hooks · husky + lint-staged · lefthook · none |
@@ -48,7 +48,7 @@ No install needed: **[danmat.github.io/create-packkit](https://danmat.github.io/
 
 ## Presets
 
-`ts-lib` · `js-lib` · `ts-cli` / `cli` · `react-lib` · `react-lib-js` · `oss` · `minimal` · `full` — named bundles of the options above. See the [roadmap](ROADMAP.md) for what's next.
+`ts-lib` · `js-lib` · `ts-cli` / `cli` · `react-lib` · `react-lib-js` · `node-service` · `oss` · `minimal` · `full` — named bundles of the options above. See the [roadmap](ROADMAP.md) for what's next.
 
 ## How it works
 

package/package.json

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

package/src/cli/args.js

@@ -11,6 +11,7 @@ const OVERRIDE_FLAGS = {
   lint: 'lint',
   hooks: 'gitHooks',
   release: 'release',
+  deps: 'deps',
   license: 'license',
   pm: 'packageManager',
   node: 'nodeVersion',
@@ -18,6 +19,15 @@ const OVERRIDE_FLAGS = {
   description: 'description',
 };
 
+// Boolean options that default ON — a --no-<flag> turns them off.
+const NEGATABLE = {
+  'no-coverage': 'coverage',
+  'no-community': 'community',
+  'no-agents': 'agents',
+  'no-vscode': 'vscode',
+  'no-editorconfig': 'editorconfig',
+};
+
 export function parseCliArgs(argv) {
   const { values, positionals } = parseArgs({
     args: argv,
@@ -29,10 +39,13 @@ export function parseCliArgs(argv) {
       here: { type: 'boolean' },
       'no-install': { type: 'boolean' },
       'no-git': { type: 'boolean' },
+      minify: { type: 'boolean' },
       target: { type: 'string', multiple: true },
+      workflows: { type: 'string', multiple: true },
       help: { type: 'boolean', short: 'h' },
       version: { type: 'boolean', short: 'v' },
       ...Object.fromEntries(Object.keys(OVERRIDE_FLAGS).map((k) => [k, { type: 'string' }])),
+      ...Object.fromEntries(Object.keys(NEGATABLE).map((k) => [k, { type: 'boolean' }])),
     },
   });
 
@@ -47,6 +60,11 @@ export function parseCliArgs(argv) {
     if (values[flag] != null) overrides[key] = values[flag];
   }
   if (values.target) overrides.target = values.target;
+  if (values.workflows) overrides.workflows = values.workflows;
+  if (values.minify) overrides.minify = true;
+  for (const [flag, key] of Object.entries(NEGATABLE)) {
+    if (values[flag]) overrides[key] = false;
+  }
   if (name) overrides.name = name;
 
   return {

package/src/cli/index.js

@@ -33,9 +33,14 @@ Options:
   --no-install        Skip dependency install
   --no-git            Skip git init
   --pm <manager>      npm | pnpm | yarn | bun
-  --language <ts|js>  --module <esm|cjs|dual>  --bundler <tsup|tsdown|unbuild|rollup|none>
+  --language <ts|js>  --module <esm|cjs|dual>  --framework <none|react>
+  --target <library|cli|service>   (repeatable)
+  --bundler <tsup|tsdown|unbuild|rollup|none>   --minify
   --test <vitest|jest|node|none>  --lint <eslint-prettier|biome|oxlint|none>
-  --license <MIT|Apache-2.0|ISC|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>
+  --no-coverage  --no-community  --no-agents  --no-vscode  --no-editorconfig
   -h, --help          Show this help
   -v, --version       Show version
 

package/src/cli/wizard.js

@@ -32,6 +32,9 @@ export async function runWizard(seed = {}) {
   cfg.moduleFormat = bail(await p.select({ message: 'Module format', options: asOptions('moduleFormat'), initialValue: OPTIONS.moduleFormat.default }));
   cfg.packageManager = bail(await p.select({ message: 'Package manager', options: asOptions('packageManager'), initialValue: OPTIONS.packageManager.default }));
   cfg.bundler = bail(await p.select({ message: 'Build / bundler', options: asOptions('bundler'), initialValue: OPTIONS.bundler.default }));
+  if (cfg.bundler !== 'none') {
+    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 }));
   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 }));

package/src/core/features/bundler.js

@@ -55,6 +55,7 @@ export default {
       pkg.devDependencies = {
         rollup: '^4.0.0',
         ...(cfg.isTs ? { '@rollup/plugin-typescript': '^11.0.0', tslib: '^2.6.0' } : {}),
+        ...(cfg.minify ? { '@rollup/plugin-terser': '^0.4.0' } : {}),
       };
     } else if (cfg.bundler === 'none' && cfg.isTs) {
       // tsc-only build for TypeScript.
@@ -81,6 +82,7 @@ function tsupConfig(cfg, entries, formats, tool) {
     `\tsourcemap: true,`,
     `\tclean: true,`,
     `\ttreeshake: true,`,
+    cfg.minify ? `\tminify: true,` : null,
     `});`,
     ``,
   ].filter((l) => l !== null).join('\n');
@@ -94,7 +96,7 @@ function unbuildConfig(cfg) {
     `\tentries: ['src/index'],`,
     `\tdeclaration: ${cfg.isTs},`,
     `\tclean: true,`,
-    `\trollup: { emitCJS: ${cfg.hasCjs} },`,
+    `\trollup: { emitCJS: ${cfg.hasCjs}${cfg.minify ? ', esbuild: { minify: true }' : ''} },`,
     `});`,
     ``,
   ].join('\n');
@@ -104,14 +106,18 @@ function rollupConfig(cfg, formats) {
   const out = formats
     .map((f) => `\t\t{ file: 'dist/index.${f === 'cjs' ? 'cjs' : 'js'}', format: '${f}', sourcemap: true }`)
     .join(',\n');
-  const tsPlugin = cfg.isTs ? `\n\tplugins: [typescript()],` : '';
-  const tsImport = cfg.isTs ? `import typescript from '@rollup/plugin-typescript';\n` : '';
+  const imports = [
+    cfg.isTs ? `import typescript from '@rollup/plugin-typescript';` : null,
+    cfg.minify ? `import terser from '@rollup/plugin-terser';` : null,
+  ].filter(Boolean);
+  const plugins = [cfg.isTs ? 'typescript()' : null, cfg.minify ? 'terser()' : null].filter(Boolean);
+  const pluginLine = plugins.length ? `\n\tplugins: [${plugins.join(', ')}],` : '';
   return [
-    tsImport + `export default {`,
+    (imports.length ? imports.join('\n') + '\n' : '') + `export default {`,
     `\tinput: 'src/index.${cfg.ext}',`,
     `\toutput: [`,
     out,
-    `\t],${tsPlugin}`,
+    `\t],${pluginLine}`,
     `};`,
     ``,
   ].join('\n');

package/src/core/features/index.js

@@ -5,6 +5,7 @@ import meta from './meta.js';
 import bundler from './bundler.js';
 import typescript from './typescript.js';
 import react from './react.js';
+import service from './service.js';
 import test from './test.js';
 import lint from './lint.js';
 import githooks from './githooks.js';
@@ -21,6 +22,7 @@ export default [
   bundler,
   typescript,
   react,
+  service,
   test,
   lint,
   githooks,

package/src/core/features/service.js

@@ -0,0 +1,79 @@
+// HTTP service target (Hono). Splits the app (testable) from the server entry
+// (which listens), adds start/dev scripts, and a Dockerfile.
+
+export default {
+  id: 'service',
+  active: (cfg) => cfg.hasService,
+  apply(cfg) {
+    const ext = cfg.ext;
+    const files = {
+      [`src/app.${ext}`]: appFile(cfg),
+      [`src/index.${ext}`]: serverFile(cfg),
+      Dockerfile: dockerfile(cfg),
+      '.dockerignore': 'node_modules\ndist\n.git\n.env\n',
+    };
+    return {
+      files,
+      pkg: {
+        private: true,
+        scripts: {
+          start: 'node dist/index.js',
+          dev: cfg.isTs ? 'tsx watch src/index.ts' : 'node --watch src/index.js',
+        },
+        dependencies: { hono: '^4.5.0', '@hono/node-server': '^1.12.0' },
+        ...(cfg.isTs ? { devDependencies: { tsx: '^4.0.0' } } : {}),
+      },
+    };
+  },
+};
+
+function appFile(cfg) {
+  const t = cfg.isTs;
+  return [
+    `import { Hono } from 'hono';`,
+    ``,
+    `export const app = new Hono();`,
+    ``,
+    `app.get('/', (c) => c.json({ ok: true, service: '${cfg.name}' }));`,
+    `app.get('/health', (c) => c.text('ok'));`,
+    ``,
+  ].join('\n');
+}
+
+function serverFile(cfg) {
+  return [
+    `import { serve } from '@hono/node-server';`,
+    `import { app } from './app${cfg.isTs ? '.js' : '.js'}';`,
+    ``,
+    `const port = Number(process.env.PORT) || 3000;`,
+    `serve({ fetch: app.fetch, port }, (info) => {`,
+    `\tconsole.log(\`Listening on http://localhost:\${info.port}\`);`,
+    `});`,
+    ``,
+  ].join('\n');
+}
+
+function dockerfile(cfg) {
+  const node = cfg.nodeVersion;
+  const pm = cfg.packageManager;
+  const install = pm === 'npm' ? 'npm ci' : `${pm} install --frozen-lockfile`;
+  const build = pm === 'npm' ? 'npm run build' : `${pm} run build`;
+  return [
+    `FROM node:${node}-slim AS build`,
+    `WORKDIR /app`,
+    `COPY package*.json ./`,
+    `RUN ${install}`,
+    `COPY . .`,
+    `RUN ${build}`,
+    ``,
+    `FROM node:${node}-slim`,
+    `WORKDIR /app`,
+    `ENV NODE_ENV=production`,
+    `COPY --from=build /app/node_modules ./node_modules`,
+    `COPY --from=build /app/dist ./dist`,
+    `COPY package.json ./`,
+    `EXPOSE 3000`,
+    `CMD ["node", "dist/index.js"]`,
+    ``,
+  ].join('\n');
+}

package/src/core/features/test.js

@@ -65,6 +65,20 @@ function importPath(runner, cfg) {
 
 function exampleTest(runner, cfg) {
   const imp = importPath(runner, cfg);
+  if (cfg.hasService) {
+    const api = runner === 'jest' ? '' : `import { describe, it, expect } from 'vitest';\n`;
+    return [
+      api + `import { app } from './app.js';`,
+      ``,
+      `describe('app', () => {`,
+      `\tit('responds on /', async () => {`,
+      `\t\tconst res = await app.request('/');`,
+      `\t\texpect(res.status).toBe(200);`,
+      `\t});`,
+      `});`,
+      ``,
+    ].join('\n');
+  }
   if (cfg.isReact) {
     const api = runner === 'jest' ? '' : `import { describe, it, expect } from 'vitest';\n`;
     return [

package/src/core/index.js

@@ -6,9 +6,9 @@ import { normalizeConfig, OPTIONS, GROUPS, defaultConfig } from './options.js';
 import { deepMerge, toJson } from './render.js';
 import { finalizePackageJson } from './pkg.js';
 import features from './features/index.js';
-import { PRESETS, PRESET_NAMES } from './presets.js';
+import { PRESETS, PRESET_NAMES, PRESET_INFO } from './presets.js';
 
-export { OPTIONS, GROUPS, defaultConfig, normalizeConfig, PRESETS, PRESET_NAMES };
+export { OPTIONS, GROUPS, defaultConfig, normalizeConfig, PRESETS, PRESET_NAMES, PRESET_INFO };
 
 /** Apply a named preset over the defaults, returning a full config. */
 export function fromPreset(name, overrides = {}) {

package/src/core/options.js

@@ -33,6 +33,7 @@ export const OPTIONS = {
     choices: [
       { value: 'library', label: 'Library (importable package)' },
       { value: 'cli', label: 'CLI tool (ships a bin)' },
+      { value: 'service', label: 'HTTP service (Hono)' },
     ],
   },
   framework: {
@@ -71,6 +72,9 @@ export const OPTIONS = {
       { value: 'none', label: 'None (tsc / no build)' },
     ],
   },
+  minify: {
+    group: 'build', type: 'boolean', label: 'Minify output (best for CLIs / browser bundles)', default: false,
+  },
 
   // ---- testing ----
   test: {
@@ -184,6 +188,8 @@ export function normalizeConfig(input = {}) {
   if (!Array.isArray(cfg.target) || cfg.target.length === 0) cfg.target = ['library'];
   if (!Array.isArray(cfg.workflows)) cfg.workflows = [];
 
+  // Minify needs a bundler.
+  if (cfg.bundler === 'none') cfg.minify = false;
   // Coverage only makes sense with a test runner that supports it.
   if (cfg.test === 'none' || cfg.test === 'node') cfg.coverage = false;
   // Codecov workflow implies coverage.
@@ -200,6 +206,7 @@ export function normalizeConfig(input = {}) {
   cfg.srcExt = cfg.isReact ? (cfg.isTs ? 'tsx' : 'jsx') : cfg.ext;
   cfg.hasLibrary = cfg.target.includes('library');
   cfg.hasCli = cfg.target.includes('cli');
+  cfg.hasService = cfg.target.includes('service');
   cfg.hasEsm = cfg.moduleFormat === 'esm' || cfg.moduleFormat === 'dual';
   cfg.hasCjs = cfg.moduleFormat === 'cjs' || cfg.moduleFormat === 'dual';
   return cfg;

package/src/core/presets.js

@@ -8,6 +8,11 @@ export const PRESETS = {
   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' },
+  'node-service': {
+    language: 'ts', target: ['service'], moduleFormat: 'esm', bundler: 'tsup',
+    test: 'vitest', lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
+    release: 'none', workflows: ['ci'], deps: 'renovate', agents: true, vscode: true,
+  },
   oss: {
     language: 'ts', target: ['library'], moduleFormat: 'dual', bundler: 'tsup',
     test: 'vitest', coverage: true, lint: 'eslint-prettier', gitHooks: 'simple-git-hooks',
@@ -29,3 +34,17 @@ export const PRESETS = {
 };
 
 export const PRESET_NAMES = Object.keys(PRESETS);
+
+// 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.',
+  '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.',
+  'node-service': 'Node HTTP service (Hono) — tsx dev, tsup build, Dockerfile.',
+  oss: 'Full open-source library — coverage, CodeQL, Codecov, Renovate, Changesets.',
+  minimal: 'Bare TS library — tsup only, no tests/lint/CI.',
+  full: 'Everything on — library + CLI, all workflows and extras.',
+};