create-packkit 2.2.0 → 2.3.0

package/package.json

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

@@ -54,6 +54,7 @@ export function parseCliArgs(argv) {
       canary: { type: 'boolean' },
       'pkg-checks': { type: 'boolean' },
       knip: { type: 'boolean' },
+      'size-limit': { type: 'boolean' },
       jsr: { type: 'boolean' },
       help: { type: 'boolean', short: 'h' },
       version: { type: 'boolean', short: 'v' },
@@ -83,6 +84,7 @@ export function parseCliArgs(argv) {
   if (values.canary) overrides.canary = true;
   if (values['pkg-checks']) overrides.pkgChecks = true;
   if (values.knip) overrides.knip = true;
+  if (values['size-limit']) overrides.sizeLimit = true;
   if (values.jsr) overrides.jsr = true;
   for (const [flag, key] of Object.entries(NEGATABLE)) {
     if (values[flag]) overrides[key] = false;

package/src/cli/index.js

@@ -47,6 +47,7 @@ Options:
   --workflows <ci|npm-publish|pages|codeql|codecov|stale>   (repeatable)
   --deps <renovate|dependabot|none>  --license <MIT|Apache-2.0|ISC|none>
   --pkg-checks (publint + are-the-types-wrong)   --knip   --jsr   --canary
+  --size-limit (bundle-size budget, libraries)
   --no-coverage  --no-community  --no-agents  --no-vscode  --no-editorconfig
   --schema            Print the full option/preset schema as JSON (for tools/agents)
   -h, --help          Show this help

package/src/core/features/index.js

@@ -15,6 +15,7 @@ import githooks from './githooks.js';
 import release from './release.js';
 import cli from './cli.js';
 import checks from './checks.js';
+import sizelimit from './sizelimit.js';
 import jsr from './jsr.js';
 import workflows from './workflows.js';
 import storybook from './storybook.js';
@@ -38,6 +39,7 @@ export default [
   release,
   cli,
   checks,
+  sizelimit,
   jsr,
   workflows,
   storybook,

package/src/core/features/sizelimit.js

@@ -0,0 +1,23 @@
+// size-limit: a bundle-size budget for published libraries. Measures the
+// brotli-compressed size of the built entry and fails when it exceeds the
+// limit — cheap insurance against a dependency silently bloating the package.
+import { toJson } from '../render.js';
+
+export default {
+  id: 'sizelimit',
+  active: (cfg) => cfg.sizeLimit,
+  apply(cfg) {
+    return {
+      files: {
+        '.size-limit.json': toJson([{ name: cfg.name, path: 'dist/index.js', limit: '10 kB' }]),
+      },
+      pkg: {
+        scripts: { size: 'size-limit' },
+        devDependencies: {
+          'size-limit': '^11.0.0',
+          '@size-limit/preset-small-lib': '^11.0.0',
+        },
+      },
+    };
+  },
+};

package/src/core/features/workflows.js

@@ -80,6 +80,7 @@ function ciWorkflow(cfg, codecov) {
   if (cfg.test !== 'none') jobs.push(`      - run: ${pmRun(cfg, codecov ? 'coverage' : 'test')}`);
   if (cfg.knip) jobs.push(`      - run: ${pmRun(cfg, 'knip')}`);
   if (cfg.hasBuild) jobs.push(`      - run: ${pmRun(cfg, 'build')}`);
+  if (cfg.sizeLimit) jobs.push(`      - run: ${pmRun(cfg, 'size')}`); // after build (measures dist)
   if (cfg.pkgChecks) jobs.push(`      - run: ${pmRun(cfg, 'check:pkg')}`); // after build (attw packs dist)
   const cov = codecov
     ? '\n      - uses: codecov/codecov-action@v4\n        with:\n          token: ${{ secrets.CODECOV_TOKEN }}'

package/src/core/options.js

@@ -102,6 +102,7 @@ export const OPTIONS = {
   canary: { group: 'release', type: 'boolean', label: 'Snapshot / canary release workflow (Changesets)', 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 },
+  sizeLimit: { group: 'quality', type: 'boolean', label: 'size-limit (bundle-size budget, libraries)', default: false },
 
   // ---- lint / format ----
   lint: {
@@ -260,6 +261,8 @@ export function normalizeConfig(input = {}) {
   if (!cfg.publishable) cfg.pkgChecks = false;
   // Sourcemaps + shipped source only matter for a published package.
   if (!cfg.publishable) cfg.sourcemaps = false;
+  // A bundle-size budget needs a published package with a built entry.
+  if (!(cfg.publishable && cfg.hasBuild)) cfg.sizeLimit = false;
   // Env validation is for server-side runtimes (services / CLIs), not libs/apps.
   if (!(cfg.hasService || cfg.hasCli)) cfg.env = false;
   // Canary snapshots ride on the Changesets flow.