@adamhl8/configs 0.28.0 → 0.29.0

package/README.md

@@ -16,6 +16,17 @@ import "node_modules/@adamhl8/configs/dist/configs/justfile.base.just"
 
 It provides `lint`, `build`, `test`, `bump-deps`, `release`, `release-run`, and `prepare`. Run `just` to list them. `build` only runs `tsdown` if the project has a `tsdown.config.ts`, so projects without a build step can use it as-is.
 
+To customize a recipe, redefine it in your `justfile`. Each public recipe is a thin wrapper over a private `_recipe` that holds the actual body, so an override can still run the original instead of copying it:
+
+```just
+# add steps after the original: dependencies run first, then the body
+prepare: _prepare
+    tsdown
+
+# add steps before and after: deps before `&&` run first, deps after run last
+bump-deps: my-setup _bump-deps && my-cleanup
+```
+
 The only script left in `package.json` is `prepare`, which hands off to just:
 
 ```json

package/dist/configs/justfile.base.just

@@ -2,41 +2,48 @@
 set unstable
 set default-list
 set allow-duplicate-recipes
-set lazy
 
 export PATH := justfile_directory() + "/node_modules/.bin:" + env("PATH")
 
 # runs cmd if the [ ] condition holds, echoing cmd only when it runs
 run-when(cmd, condition) := f"if [ {{condition}} ]; then echo {{style("command", cmd)}}; {{cmd}}; fi"
 
-current_repo := `basename -s .git $(git remote get-url origin)`
+# public recipes are thin wrappers over private _recipes so an override can still call the original
+# e.g. `prepare: _prepare` + extra lines
 
-prepare:
+prepare: _prepare
+_prepare:
     lefthook install
-    @{{ run-when("tsdown", f"{{current_repo}} = configs") }}
 
-bump-deps:
+bump-deps: _bump-deps
+_bump-deps:
     nub update -L
     rm -f lock.yaml
     nub i --no-frozen-lockfile
     oxfmt lock.yaml
 
-lint:
+lint: _lint
+_lint:
     markdown-toc -i --bullets '-' --maxdepth 3 ./README.md
     oxlint --fix --fix-suggestions --fix-dangerously
     oxfmt
     knip
     @{{ run-when("just test", "-f vitest.config.ts") }}
 
-build: lint
+build: _build
+_build: lint
     @{{ run-when("tsdown", "-f tsdown.config.ts") }}
 
-test:
+test: _test
+_test:
     vitest run
 
-release:
+release: _release
+_release:
     gh workflow run release.yml
 
 [private]
-release-run:
+release-run: _release-run
+
+_release-run:
     release-it --ci -i "$(adamhl8-cliff --bumped-version)"

package/dist/configs/knip.base.d.ts

@@ -6,7 +6,7 @@ declare const knipConfig: OptionalMergeConfigFn<KnipConfig, {
   readonly project: ["**/*"];
   readonly entry: ["./src/index.ts"];
   readonly ignoreBinaries: ["just"];
-  readonly ignoreDependencies: ["@adamhl8/eslint-plugin-clean-modules", "release-it", "markdown-toc"];
+  readonly ignoreDependencies: ["@adamhl8/eslint-plugin-clean-modules"];
 }>;
 //#endregion
 export { knipConfig };

package/dist/configs/knip.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knip.base.d.ts","names":[],"sources":["../../src/configs/knip.base.ts"],"mappings":";;;;cA0Ba,UAAA,EAAU,qBAAA,CAAA,UAAA;EAAA"}
+{"version":3,"file":"knip.base.d.ts","names":[],"sources":["../../src/configs/knip.base.ts"],"mappings":";;;;cAoBa,UAAA,EAAU,qBAAA,CAAA,UAAA;EAAA"}

package/dist/configs/knip.base.js

@@ -6,11 +6,7 @@ const knipConfig = createMergeConfigFn({
 	project: ["**/*"],
 	entry: ["./src/index.ts"],
 	ignoreBinaries: IGNORE_BINARIES,
-	ignoreDependencies: [
-		"@adamhl8/eslint-plugin-clean-modules",
-		"release-it",
-		"markdown-toc"
-	]
+	ignoreDependencies: ["@adamhl8/eslint-plugin-clean-modules"]
 });
 //#endregion
 export { IGNORE_BINARIES, knipConfig };

package/dist/configs/knip.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"knip.base.js","names":[],"sources":["../../src/configs/knip.base.ts"],"sourcesContent":["import type { KnipConfig } from \"knip\"\n\nimport { createMergeConfigFn } from \"#/utils.ts\"\n\n/** Knip sees `just` in the `prepare` script and the release-it hooks, but it isn't a package.json dependency */\nexport const IGNORE_BINARIES = [\"just\"] as const satisfies string[]\n\n/**\n * - Knip resolves `@adamhl8/eslint-plugin-clean-modules` via the oxlint config, but we don't need to install it directly\n *   in the consuming project, so it shows as unlisted\n * - `release-it` and `markdown-toc` are only referenced from the base justfile, which knip doesn't parse, so they show as\n *   unused\n */\nconst IGNORE_DEPENDENCIES = [\n  \"@adamhl8/eslint-plugin-clean-modules\",\n  \"release-it\",\n  \"markdown-toc\",\n] as const satisfies string[]\n\nconst baseConfig = {\n  project: [\"**/*\"],\n  entry: [\"./src/index.ts\"],\n  ignoreBinaries: IGNORE_BINARIES,\n  ignoreDependencies: IGNORE_DEPENDENCIES,\n} as const satisfies KnipConfig\n\nexport const knipConfig = createMergeConfigFn<KnipConfig, typeof baseConfig>(baseConfig)\n"],"mappings":";;;AAKA,MAAa,kBAAkB,CAAC,MAAM;AAqBtC,MAAa,aAAa,oBAAmD;CAN3E,SAAS,CAAC,MAAM;CAChB,OAAO,CAAC,gBAAgB;CACxB,gBAAgB;CAChB,oBAAoB;EATpB;EACA;EACA;CAOsC;AAGqC,CAAU"}
+{"version":3,"file":"knip.base.js","names":[],"sources":["../../src/configs/knip.base.ts"],"sourcesContent":["import type { KnipConfig } from \"knip\"\n\nimport { createMergeConfigFn } from \"#/utils.ts\"\n\n/** Knip sees `just` in the `prepare` script and the release-it hooks, but it isn't a package.json dependency */\nexport const IGNORE_BINARIES = [\"just\"] as const satisfies string[]\n\n/**\n * - Knip resolves `@adamhl8/eslint-plugin-clean-modules` via the oxlint config, but we don't need to install it directly\n *   in the consuming project, so it shows as unlisted\n */\nconst IGNORE_DEPENDENCIES = [\"@adamhl8/eslint-plugin-clean-modules\"] as const satisfies string[]\n\nconst baseConfig = {\n  project: [\"**/*\"],\n  entry: [\"./src/index.ts\"],\n  ignoreBinaries: IGNORE_BINARIES,\n  ignoreDependencies: IGNORE_DEPENDENCIES,\n} as const satisfies KnipConfig\n\nexport const knipConfig = createMergeConfigFn<KnipConfig, typeof baseConfig>(baseConfig)\n"],"mappings":";;;AAKA,MAAa,kBAAkB,CAAC,MAAM;AAetC,MAAa,aAAa,oBAAmD;CAN3E,SAAS,CAAC,MAAM;CAChB,OAAO,CAAC,gBAAgB;CACxB,gBAAgB;CAChB,oBAAoB,CANO,sCAMW;AAGqC,CAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamhl8/configs",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "homepage": "https://github.com/adamhl8/configs",
   "bugs": {
     "url": "https://github.com/adamhl8/configs/issues"