[INFRA] Replace npm-requirements hack with package.json (#2226)

* chore: Replace npm-requirements hack with package.json

* chore: Update CONTRIBUTING guide to use npm run

* chore(ci): Use npm install/run

* chore(ci): Update dependabot config

* chore: Add prettier to package.json

* chore: Add cffconvert to Python dependencies

* chore: Update makefile to install and use dependencies

* [DATALAD RUNCMD] uv lock --upgrade

=== Do not change lines below ===
{
 "chain": [],
 "cmd": "uv lock --upgrade",
 "exit": 0,
 "extra_inputs": [],
 "inputs": [
  "pyproject.toml"
 ],
 "outputs": [
  "uv.lock"
 ],
 "pwd": "."
}
^^^ Do not change lines above ^^^

Author: effigies

.github/dependabot.yml

@@ -19,3 +19,15 @@ updates:
       interval: "monthly"
     labels:
       - "exclude-from-changelog"
+    groups:
+      build-dependencies:
+        patterns: ["*"]
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    labels:
+      - "exclude-from-changelog"
+    groups:
+      node-utilities:
+        patterns: ["*"]

.github/workflows/validation.yml

@@ -28,9 +28,9 @@ jobs:
         with:
           node-version: 22
       - name: Install dependencies
-        run: npm install `cat npm-requirements.txt`
+        run: npm install
       - name: Run style checks
-        run: npx remark src/**/*.md --frail --rc-path .remarkrc
+        run: npm run remark
 
   # YAML
   yamllint:

.gitignore

@@ -14,8 +14,6 @@ pdf_build_src/src_copy
 pdf_build_src/tests/data/output
 
 # JS/NPM
-package-lock.json
-package.json
 node_modules/
 
 # Python gitignore

CONTRIBUTING.md

@@ -293,48 +293,41 @@ NodeJS.
 Remark-CLI can be installed via [npm](https://www.npmjs.com/), which is part of
 the NodeJS distribution.
 
-To install the packages we use for our style guide, the following command will
-work on most command lines:
+To install the packages we use for our style guide, use the following command:
 
 ```shell
-npm install `cat npm-requirements.txt`
-```
-
-The equivalent command on PowerShell is:
-
-```shell
-npm install @(cat npm-requirements.txt)
+npm install
 ```
 
 ### 3. Find documents that are failing the check
 
 Run the following from the root directory of `bids-specification`:
 
 ```shell
-npx remark ./src/*.md ./src/*/*.md
+npm run remark
 ```
 
 ### 4. Fix the flagged document
 
 Please go to the directory where the flagged file is and run remark like this:
 
 ```shell
-npx remark flagged_file.md -o flagged_file_fixed.md
+npx remark path/to/flagged_file.md -o path/to/flagged_file_fixed.md
 ```
 
-Please confirm this has fixed the file. To do this, please run this:
+To confirm this has fixed the file, run:
 
 ```shell
-npx remark flagged_file_fixed.md --frail
+npx remark path/to/flagged_file_fixed.md --frail
 ```
 
 This command will indicate whether this file now conforms to the style guide.
 If it passes, replace `flagged_file.md` with the contents of
 `flagged_file_fixed.md`, add and commit the change:
 
 ```shell
-mv flagged_file_fixed.md flagged_file.md
-git add flagged_file.md
+mv path/to/flagged_file_fixed.md path/to/flagged_file.md
+git add path/to/flagged_file.md
 git commit -m 'STY: Fixed Markdown style'
 ```
 

Makefile

@@ -1,15 +1,24 @@
 .PHONY:  tools/contributors.tsv
+all:
+
+install: .venv node_modules
+
+node_modules: package.json package-lock.json
+	npm install
 
-validate_citation_cff: CITATION.cff
-	cffconvert --validate
+.venv: pyproject.toml uv.lock
+	uv sync --frozen --group doc --group tools
 
-update_contributors:
+validate_citation_cff: CITATION.cff .venv
+	uv run cffconvert --validate
+
+update_contributors: .venv
 	uv run tools/add_contributors.py
 	uv run tools/print_contributors.py
 	npx all-contributors-cli generate
 
 runprettier:
-	prettier --write "src/schema/**/*.yaml"
+	npx prettier --write "src/schema/**/*.yaml"
 	python3 -m yamllint -f standard src/schema/ -c .yamllint.yml
 
 SCHEMA_CHANGES := $(shell git diff --name-only | grep src/schema/*.yaml)
@@ -23,6 +32,4 @@ commitschema:
 
 formatschema: runprettier commitschema
 
-all:
-
 .PHONY: runprettier commitschema