Skip to content

Commit c9d878d

Browse files
committed
docs: generate the API reference and streamline contributor setup
Consolidates the original contiguous commits f7c4857..e228bdc. Preserves the exact tree at the end of this group.
1 parent 347c38e commit c9d878d

28 files changed

Lines changed: 1861 additions & 255 deletions

‎.config/external-tools.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"$schema": "./external-tools.schema.json",
3+
"tools": {
4+
"node": { "origin": "system", "version": "26" },
5+
"npm": { "origin": "system", "version": "12.0.2" },
6+
"pnpm": { "origin": "system", "version": "12.3.4" }
7+
}
8+
}

‎.config/external-tools.schema.json‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"$schema": "https://json-schema.org/draft/2020-12/schema",
3+
"title": "Contributor tools",
4+
"type": "object",
5+
"additionalProperties": false,
6+
"required": ["tools"],
7+
"properties": {
8+
"$schema": { "type": "string" },
9+
"tools": {
10+
"type": "object",
11+
"additionalProperties": false,
12+
"required": ["node", "npm", "pnpm"],
13+
"properties": {
14+
"node": { "$ref": "#/$defs/tool" },
15+
"npm": { "$ref": "#/$defs/tool" },
16+
"pnpm": { "$ref": "#/$defs/tool" }
17+
}
18+
}
19+
},
20+
"$defs": {
21+
"tool": {
22+
"type": "object",
23+
"additionalProperties": false,
24+
"required": ["origin", "version"],
25+
"properties": {
26+
"origin": { "const": "system" },
27+
"version": { "type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+){0,2}$" }
28+
}
29+
}
30+
}
31+
}

‎.github/workflows/node.js.yml‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,20 @@ jobs:
1111
runs-on: ubuntu-latest
1212
steps:
1313
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 (2026-07-20)
14+
- id: tools
15+
run: node scripts/external-tools.mts --github-output
1416
- uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0 (2026-07-14)
1517
with:
16-
node-version: '26'
18+
node-version: ${{ steps.tools.outputs.node }}
1719
package-manager-cache: false
18-
- run: npm install --global npm@12.0.2
20+
- run: npm install --global npm@${{ steps.tools.outputs.npm }}
1921
working-directory: ${{ runner.temp }}
20-
- run: npm install --global pnpm@12.3.4
22+
- run: npm install --global pnpm@${{ steps.tools.outputs.pnpm }}
2123
working-directory: ${{ runner.temp }}
22-
- run: pnpm install --frozen-lockfile
23-
- run: pnpm run lint
24-
- run: pnpm run format:check
25-
- run: pnpm run type
24+
# Use real Git for upstream setup, not the local runner's checkout shim.
25+
- run: PATH="$(git --exec-path):$PATH" pnpm install --frozen-lockfile
26+
- run: pnpm run check
2627
- run: pnpm run test:package
27-
# Use real Git for upstream repositories, not the local runner's checkout shim.
28-
- run: PATH="$(git --exec-path):$PATH" pnpm run upstream:clone
29-
- run: PATH="$(git --exec-path):$PATH" pnpm run upstream:verify
3028
- run: pnpm exec playwright install --with-deps chromium
3129
- run: pnpm run test:coverage
3230
- run: pnpm run check:coverage

‎.gitmodules‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,5 +7,5 @@
77
branch = master
88
shallow = true
99
sparse-checkout = resources common dom/nodes css/selectors
10-
verify = npm run test:upstream
10+
verify = pnpm run test:upstream
1111
# no-release-tag: web-platform-tests publishes no release tags; pinned by ref on master

0 commit comments

Comments
 (0)