@adamhl8/configs 0.28.1 → 0.30.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/cliff.base.toml

@@ -3,11 +3,11 @@ body = """
 {% macro print_commit(commit) -%}
   - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
     {% if commit.breaking %}[**breaking**] {% endif %}\
-    {{ commit.message | trim }}\
+    {{ commit.message | trim }} \
+    ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }})\
     {% if commit.remote.username %} by @{{ commit.remote.username }}{%- endif -%}\
     {% if commit.remote.pr_number %} in \
-    [#{{ commit.remote.pr_number }}]({{ self::remote_url() }}/pull/{{ commit.remote.pr_number }}){%- endif %} \
-    ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }}))\
+    [#{{ commit.remote.pr_number }}]({{ self::remote_url() }}/pull/{{ commit.remote.pr_number }}){%- endif %})\
 {% endmacro -%}
 
 {%- macro remote_url() -%}

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/package.json

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