From 704214c6c4bac01e8c97cba4e96a1d945a05b5cf Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:41:05 +0100 Subject: [PATCH 01/13] chore: scaffold the module, tooling and release config --- Makefile | 25 + README.md | 65 + cmd/motorino/main.go | 22 + go.mod | 3 + internal/version/version.go | 18 + internal/version/version_test.go | 12 + package-lock.json | 5925 ++++++++++++++++++++++++++++++ package.json | 20 + release.config.mjs | 43 + 9 files changed, 6133 insertions(+) create mode 100644 Makefile create mode 100644 README.md create mode 100644 cmd/motorino/main.go create mode 100644 go.mod create mode 100644 internal/version/version.go create mode 100644 internal/version/version_test.go create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 release.config.mjs diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..7d2fab6 --- /dev/null +++ b/Makefile @@ -0,0 +1,25 @@ +# SPDX-License-Identifier: GPL-3.0-or-later + +GO ?= go +MODULE := git.kmalloc.org/squid/motorino +VERSION ?= dev +LDFLAGS := -s -w -X $(MODULE)/internal/version.value=$(VERSION) + +.PHONY: check build dist + +# check runs the formatter check, the vet, staticcheck and the tests. +check: + @test -z "$$(gofmt -l .)" || { echo "gofmt needed on:"; gofmt -l .; exit 1; } + $(GO) vet ./... + staticcheck ./... + $(GO) test ./... + +# build compiles a local binary into bin/motorino. +build: + $(GO) build -trimpath -ldflags "$(LDFLAGS)" -o bin/motorino ./cmd/motorino + +# dist compiles the release binary for the server and writes its SHA-256. +dist: + mkdir -p dist + CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build -trimpath -ldflags "$(LDFLAGS)" -o dist/motorino-linux-amd64 ./cmd/motorino + cd dist && sha256sum motorino-linux-amd64 > motorino-linux-amd64.sha256 diff --git a/README.md b/README.md new file mode 100644 index 0000000..b329962 --- /dev/null +++ b/README.md @@ -0,0 +1,65 @@ +# motorino + +The static site generator of [kmalloc.org](https://kmalloc.org/). It turns Markdown pages, news, templates and language files into plain HTML with no JavaScript. It is made for that one site and is not a general-purpose generator. + +Licence: GPL-3.0-or-later, see `LICENSE`. + +## Usage + +``` +motorino build -site DIR -out DIR build the site in DIR into the output folder (defaults: . and public) +motorino version print the version +``` + +The binary is a single static Go program. The version comes from semantic-release. + +## What a site looks like + +``` +site.json shared strings (contact, addresses, base_url), the language list, the assets +lang/.json menu, footer and other interface strings of one language +content//**/*.md the pages; index.md is the home of a folder +news/.md the news, one file each +templates/**/*.html the page chrome, the layouts, the news post and category page +static/style.css the stylesheet, inlined in every page +``` + +The first language in `site.json` is the default and lives at the root of the site; the others live under `//`. + +### Header + +Every page and every news file starts with lines of `Key: value`, ended by a line that holds a single `-`. The body is Markdown, and raw HTML is allowed in it. + +News: + +``` +Title: GNU/Linux Day 2026 +Author: Matteo Bini +Date: 2026-09-18T17:00:45+0200 +Categories: Linux Day, FLUG +Description: An optional one-line summary. +- +The text of the news. +``` + +A news file `news/name.md` is published as `/news/YYYY/MM/name.html`, with the year and the month of `Date` as written. Every category gets a page, `/news/category/.html`. + +Pages: `Title`, `ID` (the same in every language, it links the translations), `Description`, and optionally `Layout` (`page`, `bare` or `manifesto`), `Note` and `Switch`. + +### Placeholders + +`{{name}}`, with lowercase letters, digits and underscores, is replaced by a string from `site.json` or the language file. An unknown placeholder stops the build and names the file. `{{news_list}}`, `{{latest_news}}` and `{{categories_list}}` stand alone in a paragraph and expand to generated lists. + +## Development + +``` +make check gofmt, go vet, staticcheck and the tests +make build a local binary in bin/motorino +make dist the release binary and its SHA-256 in dist/ +``` + +Go code has a doc comment on every package and declaration, and is formatted with `gofmt`. Commits follow conventional commits. + +## Release + +semantic-release is run by hand from a clean `main`: `npm run release:dry`, then `npm run release`. It tags `vX.Y.Z`, updates `CHANGELOG.md`, builds the `linux/amd64` binary and publishes it, with its SHA-256, as a release on this repository. The site deploy pins a version and checks the hash before it runs the binary. diff --git a/cmd/motorino/main.go b/cmd/motorino/main.go new file mode 100644 index 0000000..7b4c8d5 --- /dev/null +++ b/cmd/motorino/main.go @@ -0,0 +1,22 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Command motorino builds the kmalloc.org site from Markdown, templates and +// language files. +package main + +import ( + "fmt" + "os" + + "git.kmalloc.org/squid/motorino/internal/version" +) + +// main runs the command line and exits with its status code. +func main() { + if len(os.Args) > 1 && os.Args[1] == "version" { + fmt.Println("motorino", version.String()) + return + } + fmt.Fprintln(os.Stderr, "usage: motorino version") + os.Exit(2) +} diff --git a/go.mod b/go.mod new file mode 100644 index 0000000..58439fe --- /dev/null +++ b/go.mod @@ -0,0 +1,3 @@ +module git.kmalloc.org/squid/motorino + +go 1.27 diff --git a/internal/version/version.go b/internal/version/version.go new file mode 100644 index 0000000..dd6460c --- /dev/null +++ b/internal/version/version.go @@ -0,0 +1,18 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package version holds the version of the motorino binary. +// +// The release build stamps the value with +// +// -ldflags "-X git.kmalloc.org/squid/motorino/internal/version.value=1.2.3" +// +// and an unstamped build reports "dev". +package version + +// value is the version stamped by the linker; it stays "dev" for local builds. +var value = "dev" + +// String returns the version of this build. +func String() string { + return value +} diff --git a/internal/version/version_test.go b/internal/version/version_test.go new file mode 100644 index 0000000..684c033 --- /dev/null +++ b/internal/version/version_test.go @@ -0,0 +1,12 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package version + +import "testing" + +// TestString checks that an unstamped build reports the development version. +func TestString(t *testing.T) { + if got := String(); got != "dev" { + t.Fatalf("String() = %q, want %q", got, "dev") + } +} diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..7046f56 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,5925 @@ +{ + "name": "motorino", + "version": "0.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "motorino", + "version": "0.0.0", + "license": "GPL-3.0-or-later", + "devDependencies": { + "@semantic-release/changelog": "7.0.0", + "@semantic-release/commit-analyzer": "13.0.1", + "@semantic-release/exec": "7.1.0", + "@semantic-release/git": "11.0.1", + "@semantic-release/release-notes-generator": "14.1.1", + "conventional-changelog-conventionalcommits": "9.3.1", + "semantic-release": "25.0.9" + } + }, + "node_modules/@actions/core": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/@actions/core/-/core-3.0.1.tgz", + "integrity": "sha512-a6d/Nwahm9fliVGRhdhofo40HjHQasUPusmc7vBfyky+7Z+P2A1J68zyFVaNcEclc/Se+eO595oAr5nwEIoIUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@actions/exec": "^3.0.0", + "@actions/http-client": "^4.0.0" + } + }, + "node_modules/@actions/exec": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@actions/exec/-/exec-3.0.0.tgz", + "integrity": "sha512-6xH/puSoNBXb72VPlZVm7vQ+svQpFyA96qdDBvhB8eNZOE8LtPf9L4oAsfzK/crCL8YZ+19fKYVnM63Sl+Xzlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@actions/io": "^3.0.2" + } + }, + "node_modules/@actions/http-client": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/@actions/http-client/-/http-client-4.0.1.tgz", + "integrity": "sha512-+Nvd1ImaOZBSoPbsUtEhv+1z99H12xzncCkz0a3RuehINE81FZSe2QTj3uvAPTcJX/SCzUQHQ0D1GrPMbrPitg==", + "dev": true, + "license": "MIT", + "dependencies": { + "tunnel": "^0.0.6", + "undici": "^6.23.0" + } + }, + "node_modules/@actions/http-client/node_modules/undici": { + "version": "6.29.1", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.29.1.tgz", + "integrity": "sha512-EvRlUt/QqAEvXdQeRMYUfwOQsfzpDztykrG2owGEE/rBOBoYv9uF39ZzsNDh4lTFHhTr2XOZjKkYgueD12ZmGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.17" + } + }, + "node_modules/@actions/io": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@actions/io/-/io-3.0.2.tgz", + "integrity": "sha512-nRBchcMM+QK1pdjO7/idu86rbJI5YHUKCvKs0KxnSYbVe3F51UfGxuZX4Qy/fWlp6l7gWFwIkrOzN+oUK03kfw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@babel/code-frame": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz", + "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.29.7", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@colors/colors": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz", + "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==", + "dev": true, + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.1.90" + } + }, + "node_modules/@octokit/auth-token": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/@octokit/auth-token/-/auth-token-6.0.0.tgz", + "integrity": "sha512-P4YJBPdPSpWTQ1NU4XYdvHvXJJDxM6YwpS0FZHRgP7YFkdVxsWcpWGy/NVqlAA7PcPCnMacXlRm1y2PFZRWL/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/core": { + "version": "7.0.8", + "resolved": "https://registry.npmjs.org/@octokit/core/-/core-7.0.8.tgz", + "integrity": "sha512-L7y8eYc+AwxGr2PWI4WFt1VG4TiJ66c26BD16mXpYIlXxG0SMigM1+m4aTSlYyBr5BlQsGAlz8uDCoZN4SEMcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/auth-token": "^6.0.0", + "@octokit/graphql": "^9.0.5", + "@octokit/request": "^10.0.16", + "@octokit/request-error": "^7.1.2", + "@octokit/types": "^18.0.0", + "before-after-hook": "^4.0.0", + "universal-user-agent": "^7.0.0" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/endpoint": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-11.0.5.tgz", + "integrity": "sha512-iXa654H3yFafF/ieHkukfbgWo2rmXD2ceD0ZOtrPhw1bc3FDch1d9N/TNs0FQ1/cIbwb7kspUX8jzIs8nzb9DQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/types": "^18.0.0", + "universal-user-agent": "^7.0.2" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/graphql": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/@octokit/graphql/-/graphql-9.0.5.tgz", + "integrity": "sha512-bt/hm03LeU6Vy7FwTrkkC9p3XGT/lBwClglMqxBSe5/q0E5CdJTXeAqEI0vlw89/LF/G6tryTIH8HirZ3prMVg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/request": "^10.0.16", + "@octokit/types": "^18.0.0", + "universal-user-agent": "^7.0.0" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/openapi-types": { + "version": "29.0.1", + "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-29.0.1.tgz", + "integrity": "sha512-9qWOMFNxxLokERcms42rU0PTLqQmVs7g5E41TI4mCOxmpFayD1rfC7XxOL55cG9MBZLFlC31BrR37myMKardwg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@octokit/plugin-paginate-rest": { + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@octokit/plugin-paginate-rest/-/plugin-paginate-rest-15.0.0.tgz", + "integrity": "sha512-lw9A9YL5s4VPj+VEx8uMxaxQm2YTgrPDkrLEuZuu18R8TK3oPcXF4K6t52nx6xn1RcogZC9i188sAr/4XYJaQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/types": "^17.0.0" + }, + "engines": { + "node": ">= 20" + }, + "peerDependencies": { + "@octokit/core": ">=6" + } + }, + "node_modules/@octokit/plugin-paginate-rest/node_modules/@octokit/openapi-types": { + "version": "28.0.0", + "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-28.0.0.tgz", + "integrity": "sha512-0rFyLuyHvIj6uuZWuDslxkowFYdPXoNIkeAv4b27dzm2Tf4vGWXnPsMcxs7d65kLdMERgP3wc1AEPlqMz8e1cQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@octokit/plugin-paginate-rest/node_modules/@octokit/types": { + "version": "17.0.0", + "resolved": "https://registry.npmjs.org/@octokit/types/-/types-17.0.0.tgz", + "integrity": "sha512-ByP1v7YL5SMveFPP7+sj0/ZuWCOOg/Chs4NafOMpq6WNIM/hdGY0S7C0TCGDBWu1aGmOxmUIhMx3cO+IdwYZ1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/openapi-types": "^28.0.0" + } + }, + "node_modules/@octokit/plugin-retry": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/@octokit/plugin-retry/-/plugin-retry-8.1.1.tgz", + "integrity": "sha512-VCVvZ/R1+u3WuiBWpNavZ0mY4aaJNAsENrpBP9aLSR2QyOpQgd7DhM5j4AW7z4MQpnJYgwBPf0XqPQoNBRdQwg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/request-error": "^7.1.1", + "@octokit/types": "^17.0.0", + "bottleneck": "^2.15.3" + }, + "engines": { + "node": ">= 20" + }, + "peerDependencies": { + "@octokit/core": ">=7" + } + }, + "node_modules/@octokit/plugin-retry/node_modules/@octokit/openapi-types": { + "version": "28.0.0", + "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-28.0.0.tgz", + "integrity": "sha512-0rFyLuyHvIj6uuZWuDslxkowFYdPXoNIkeAv4b27dzm2Tf4vGWXnPsMcxs7d65kLdMERgP3wc1AEPlqMz8e1cQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@octokit/plugin-retry/node_modules/@octokit/types": { + "version": "17.0.0", + "resolved": "https://registry.npmjs.org/@octokit/types/-/types-17.0.0.tgz", + "integrity": "sha512-ByP1v7YL5SMveFPP7+sj0/ZuWCOOg/Chs4NafOMpq6WNIM/hdGY0S7C0TCGDBWu1aGmOxmUIhMx3cO+IdwYZ1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/openapi-types": "^28.0.0" + } + }, + "node_modules/@octokit/plugin-throttling": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/@octokit/plugin-throttling/-/plugin-throttling-11.0.5.tgz", + "integrity": "sha512-LIdrkrUv+DWbKeg/49rGuFJ3SU0d3hUS+B4MhNZLepBoNUFXms8Ic9edJjrlx+zycqJHjrMRudVpVb/bAXM2Lw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/types": "^17.0.0", + "bottleneck": "^2.15.3" + }, + "engines": { + "node": ">= 20" + }, + "peerDependencies": { + "@octokit/core": "^7.0.0" + } + }, + "node_modules/@octokit/plugin-throttling/node_modules/@octokit/openapi-types": { + "version": "28.0.0", + "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-28.0.0.tgz", + "integrity": "sha512-0rFyLuyHvIj6uuZWuDslxkowFYdPXoNIkeAv4b27dzm2Tf4vGWXnPsMcxs7d65kLdMERgP3wc1AEPlqMz8e1cQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@octokit/plugin-throttling/node_modules/@octokit/types": { + "version": "17.0.0", + "resolved": "https://registry.npmjs.org/@octokit/types/-/types-17.0.0.tgz", + "integrity": "sha512-ByP1v7YL5SMveFPP7+sj0/ZuWCOOg/Chs4NafOMpq6WNIM/hdGY0S7C0TCGDBWu1aGmOxmUIhMx3cO+IdwYZ1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/openapi-types": "^28.0.0" + } + }, + "node_modules/@octokit/request": { + "version": "10.0.16", + "resolved": "https://registry.npmjs.org/@octokit/request/-/request-10.0.16.tgz", + "integrity": "sha512-A0zWGjHzISIb+9ccG8s0dq7LKO5zVpJLRICjgUb+sJxEWqn8RUHB1rD3AE51+PECvXHIxqZ1VVvs4fHTSD9nUQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/endpoint": "^11.0.5", + "@octokit/request-error": "^7.1.2", + "@octokit/types": "^18.0.0", + "content-type": "^3.0.0", + "json-with-bigint": "^3.5.12", + "universal-user-agent": "^7.0.2" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/request-error": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/@octokit/request-error/-/request-error-7.1.2.tgz", + "integrity": "sha512-XZRuT3xZ84D3gYErI1DZvhJ33dCWVV6uzBtWkaBB4TvA/L6eOeTZodxLFVB44bBEEo3vEx7y00UfX1tBLrtLRg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/types": "^18.0.0" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/@octokit/types": { + "version": "18.0.0", + "resolved": "https://registry.npmjs.org/@octokit/types/-/types-18.0.0.tgz", + "integrity": "sha512-l6bAF43PNxkJp6g+W4PjoUSSkxHomXw2nOum5CTftJz1NlV3vu93NImgOYtLf6CbBUb5j+fiuzW0PPQ5JTSvZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/openapi-types": "^29.0.1" + } + }, + "node_modules/@pnpm/config.env-replace": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@pnpm/config.env-replace/-/config.env-replace-1.1.0.tgz", + "integrity": "sha512-htyl8TWnKL7K/ESFa1oW2UB5lVDxuF5DpM7tBi6Hu2LNL3mWkIzNLG6N4zoCUP1lCKNxWy/3iu8mS8MvToGd6w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.22.0" + } + }, + "node_modules/@pnpm/network.ca-file": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@pnpm/network.ca-file/-/network.ca-file-1.0.2.tgz", + "integrity": "sha512-YcPQ8a0jwYU9bTdJDpXjMi7Brhkr1mXsXrUJvjqM2mQDgkRiz8jFaQGOdaLxgjtUfQgZhKy/O3cG/YwmgKaxLA==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "4.2.10" + }, + "engines": { + "node": ">=12.22.0" + } + }, + "node_modules/@pnpm/network.ca-file/node_modules/graceful-fs": { + "version": "4.2.10", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.10.tgz", + "integrity": "sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==", + "dev": true, + "license": "ISC" + }, + "node_modules/@pnpm/npm-conf": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@pnpm/npm-conf/-/npm-conf-3.0.3.tgz", + "integrity": "sha512-//0sR/cow/s4ICQaYoAobOl4aU8cjU6x/V24V7XkKotb9+O+3zySIYp146vpaobYHnxa4pZX8NkV54Z5AwbDKA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@pnpm/config.env-replace": "^1.1.0", + "@pnpm/network.ca-file": "^1.0.1", + "config-chain": "^1.1.11" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@sec-ant/readable-stream": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@sec-ant/readable-stream/-/readable-stream-0.4.1.tgz", + "integrity": "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@semantic-release/changelog": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/@semantic-release/changelog/-/changelog-7.0.0.tgz", + "integrity": "sha512-TNPyag5db24o7jWjre7UwKB4EcL8oJxbRhnDQ7hmZRAYqzreAc6PgdxQuU3pppp5xQinYtiumL0iG8SSKvnlzg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@semantic-release/error": "^4.0.0", + "aggregate-error": "^5.0.0", + "lodash-es": "^4.17.21" + }, + "engines": { + "node": "^22.22.2 || >=24.15" + }, + "peerDependencies": { + "semantic-release": ">=20.1.0" + } + }, + "node_modules/@semantic-release/commit-analyzer": { + "version": "13.0.1", + "resolved": "https://registry.npmjs.org/@semantic-release/commit-analyzer/-/commit-analyzer-13.0.1.tgz", + "integrity": "sha512-wdnBPHKkr9HhNhXOhZD5a2LNl91+hs8CC2vsAVYxtZH3y0dV3wKn+uZSN61rdJQZ8EGxzWB3inWocBHV9+u/CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "conventional-changelog-angular": "^8.0.0", + "conventional-changelog-writer": "^8.0.0", + "conventional-commits-filter": "^5.0.0", + "conventional-commits-parser": "^6.0.0", + "debug": "^4.0.0", + "import-from-esm": "^2.0.0", + "lodash-es": "^4.17.21", + "micromatch": "^4.0.2" + }, + "engines": { + "node": ">=20.8.1" + }, + "peerDependencies": { + "semantic-release": ">=20.1.0" + } + }, + "node_modules/@semantic-release/error": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@semantic-release/error/-/error-4.0.0.tgz", + "integrity": "sha512-mgdxrHTLOjOddRVYIYDo0fR3/v61GNN1YGkfbrjuIKg/uMgCd+Qzo3UAXJ+woLQQpos4pl5Esuw5A7AoNlzjUQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/@semantic-release/exec": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/@semantic-release/exec/-/exec-7.1.0.tgz", + "integrity": "sha512-4ycZ2atgEUutspPZ2hxO6z8JoQt4+y/kkHvfZ1cZxgl9WKJId1xPj+UadwInj+gMn2Gsv+fLnbrZ4s+6tK2TFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@semantic-release/error": "^4.0.0", + "aggregate-error": "^3.0.0", + "debug": "^4.0.0", + "execa": "^9.0.0", + "lodash-es": "^4.17.21", + "parse-json": "^8.0.0" + }, + "engines": { + "node": ">=20.8.1" + }, + "peerDependencies": { + "semantic-release": ">=24.1.0" + } + }, + "node_modules/@semantic-release/exec/node_modules/aggregate-error": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-3.1.0.tgz", + "integrity": "sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "clean-stack": "^2.0.0", + "indent-string": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@semantic-release/exec/node_modules/clean-stack": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-2.2.0.tgz", + "integrity": "sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/@semantic-release/exec/node_modules/indent-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz", + "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@semantic-release/git": { + "version": "11.0.1", + "resolved": "https://registry.npmjs.org/@semantic-release/git/-/git-11.0.1.tgz", + "integrity": "sha512-Zr8BUYCTZMc8V6wDKN2dpR7nJgewd9I6THL3ydLTnp3OEdTo1/4RBLNYaeRucYMsjMv+BXoCNfXA0NADj1kwhw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@semantic-release/error": "^4.0.0", + "aggregate-error": "^5.0.0", + "debug": "^4.0.0", + "dir-glob": "^3.0.0", + "execa": "^10.0.0", + "lodash-es": "^4.17.21", + "micromatch": "^4.0.0", + "p-reduce": "^3.0.0" + }, + "engines": { + "node": "^22.22.2 || >=24.15" + }, + "peerDependencies": { + "semantic-release": ">=20.1.0" + } + }, + "node_modules/@semantic-release/git/node_modules/execa": { + "version": "10.2.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-10.2.1.tgz", + "integrity": "sha512-/Bofl3ZBh2Q4/PG0W63qFzP5vDAypi8Zc90UWTBzaDNIYiX7apPOd0N6L8hG8CojUdq4V51adu8BObP+iVsSTw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/merge-streams": "^4.0.0", + "figures": "^6.1.0", + "get-stream": "^9.0.1", + "human-signals": "^8.0.1", + "is-plain-obj": "^4.1.0", + "is-stream": "^4.0.1", + "npm-run-path": "^6.0.0", + "pretty-ms": "^9.3.1", + "signal-exit": "^4.1.0", + "strip-final-newline": "^4.0.0", + "which-command": "^0.1.0", + "yoctocolors": "^2.2.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/@semantic-release/github": { + "version": "12.0.11", + "resolved": "https://registry.npmjs.org/@semantic-release/github/-/github-12.0.11.tgz", + "integrity": "sha512-/8JPlFOV8he+gs+kS8Gx0tNWBboCRBd1q3y7pQhYwtrBL0CzDe9yzguZZAfnjGM2duWYB3rEYn9BdYLu9x00cg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@octokit/core": "^7.0.0", + "@octokit/plugin-paginate-rest": "^15.0.0", + "@octokit/plugin-retry": "^8.0.0", + "@octokit/plugin-throttling": "^11.0.0", + "@semantic-release/error": "^4.0.0", + "aggregate-error": "^5.0.0", + "debug": "^4.3.4", + "dir-glob": "^3.0.1", + "http-proxy-agent": "^9.0.0", + "https-proxy-agent": "^9.0.0", + "issue-parser": "^7.0.0", + "lodash-es": "^4.17.21", + "mime": "^4.0.0", + "p-filter": "^4.0.0", + "tinyglobby": "^0.2.14", + "undici": "^7.0.0", + "url-join": "^5.0.0" + }, + "engines": { + "node": "^22.14.0 || >= 24.10.0" + }, + "peerDependencies": { + "semantic-release": ">=24.1.0" + } + }, + "node_modules/@semantic-release/npm": { + "version": "13.2.0", + "resolved": "https://registry.npmjs.org/@semantic-release/npm/-/npm-13.2.0.tgz", + "integrity": "sha512-Uz4JGafLoEGiheLKEs1orockCWP6liY9D2YnvKHYbqo9hCHAw9fuAHcU53q29SXVCtkvDhs/QVUg7Vvuyfp4Jg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@actions/core": "^3.0.0", + "@semantic-release/error": "^4.0.0", + "aggregate-error": "^5.0.0", + "env-ci": "^11.2.0", + "execa": "^9.0.0", + "fs-extra": "^11.0.0", + "lodash-es": "^4.17.21", + "nerf-dart": "^1.0.0", + "normalize-url": "^9.0.0", + "npm": "^11.6.2", + "rc": "^1.2.8", + "read-pkg": "^10.0.0", + "registry-auth-token": "^5.0.0", + "semver": "^7.1.2", + "tempy": "^3.0.0" + }, + "engines": { + "node": "^22.14.0 || >= 24.10.0" + }, + "peerDependencies": { + "semantic-release": ">=20.1.0" + } + }, + "node_modules/@semantic-release/npm/node_modules/hosted-git-info": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.3.tgz", + "integrity": "sha512-Hc+ghLoSt6QaYZUv0WBiIvmMDZuZZ7oaDvdH8MbfOO4lOsxdXLEvuC6ePoGs9H1X9oCLyq6+NVN0MKqD+ydxyg==", + "dev": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^11.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/@semantic-release/npm/node_modules/lru-cache": { + "version": "11.5.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.3.tgz", + "integrity": "sha512-U4N8FgzmWxc8k1VH8Kr6lQg18U7Fjvby6wXHVRX/ZZ7IwWbRMgrRbP0Wrb5q5NVinryp4SQampHKdvtecItxUg==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/@semantic-release/npm/node_modules/normalize-package-data": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-8.0.0.tgz", + "integrity": "sha512-RWk+PI433eESQ7ounYxIp67CYuVsS1uYSonX3kA6ps/3LWfjVQa/ptEg6Y3T6uAMq1mWpX9PQ+qx+QaHpsc7gQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "hosted-git-info": "^9.0.0", + "semver": "^7.3.5", + "validate-npm-package-license": "^3.0.4" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/@semantic-release/npm/node_modules/read-pkg": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-10.1.0.tgz", + "integrity": "sha512-I8g2lArQiP78ll51UeMZojewtYgIRCKCWqZEgOO8c/uefTI+XDXvCSXu3+YNUaTNvZzobrL5+SqHjBrByRRTdg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/normalize-package-data": "^2.4.4", + "normalize-package-data": "^8.0.0", + "parse-json": "^8.3.0", + "type-fest": "^5.4.4", + "unicorn-magic": "^0.4.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@semantic-release/npm/node_modules/type-fest": { + "version": "5.10.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.10.0.tgz", + "integrity": "sha512-NoSdpq/WEiAg5sjmBkmV/hfxv6HJH4NqPNrqjtSO5CwRmpsDfaf4begxW34KdJykH/l1yHtwBWQkCRdoXO8mPA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "dependencies": { + "tagged-tag": "^1.0.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@semantic-release/npm/node_modules/unicorn-magic": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.1.tgz", + "integrity": "sha512-lzlXPoVB0Uy/FvTaUgX39RbixYiSKoc3JSoSf01+0c2B6FR3qdYIPN7Qjo/AV7n6sqLCk0509cT3LRj1oSZ1+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@semantic-release/release-notes-generator": { + "version": "14.1.1", + "resolved": "https://registry.npmjs.org/@semantic-release/release-notes-generator/-/release-notes-generator-14.1.1.tgz", + "integrity": "sha512-Pbd2e2XRMUD0OxehHpgd5/YghsE76cddkRHSoDvKLK+OCy4Ewxn49rWR631MEUU01lgwF/uyVXvbnVuu6+Z6VA==", + "dev": true, + "license": "MIT", + "dependencies": { + "conventional-changelog-angular": "^8.0.0", + "conventional-changelog-writer": "^8.0.0", + "conventional-commits-filter": "^5.0.0", + "conventional-commits-parser": "^6.0.0", + "debug": "^4.0.0", + "import-from-esm": "^2.0.0", + "lodash-es": "^4.17.21", + "read-package-up": "^11.0.0" + }, + "engines": { + "node": ">=20.8.1" + }, + "peerDependencies": { + "semantic-release": ">=20.1.0" + } + }, + "node_modules/@simple-libs/stream-utils": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@simple-libs/stream-utils/-/stream-utils-1.2.0.tgz", + "integrity": "sha512-KxXvfapcixpz6rVEB6HPjOUZT22yN6v0vI0urQSk1L8MlEWPDFCZkhw2xmkyoTGYeFw7tWTZd7e3lVzRZRN/EA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://ko-fi.com/dangreen" + } + }, + "node_modules/@sindresorhus/is": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz", + "integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/is?sponsor=1" + } + }, + "node_modules/@sindresorhus/merge-streams": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-4.0.0.tgz", + "integrity": "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@types/normalize-package-data": { + "version": "2.4.4", + "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.4.tgz", + "integrity": "sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==", + "dev": true, + "license": "MIT" + }, + "node_modules/agent-base": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-9.0.0.tgz", + "integrity": "sha512-TQf59BsZnytt8GdJKLPfUZ54g/iaUL2OWDSFCCvMOhsHduDQxO8xC4PNeyIkVcA5KwL2phPSv0douC0fgWzmnA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20" + } + }, + "node_modules/aggregate-error": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-5.1.0.tgz", + "integrity": "sha512-1m4/ydbOGBbHTtBYa4/ISQcqfPdZAxQLzj71wM71T8lP4ktez8lcsVolvscrujQW4CJr/LJSzoZ6mcfnqzYQ3A==", + "dev": true, + "license": "MIT", + "dependencies": { + "clean-stack": "^5.2.0", + "indent-string": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-escapes": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz", + "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "environment": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-regex": { + "version": "6.6.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.6.0.tgz", + "integrity": "sha512-XZ5apbzreCbXSKwPjJstu8R0zOi247w3XYwWxtwBXgpZrCyc1Ka7p9/xY0A9/diMewmHbEKz+FIraWaEWjlN5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/any-promise": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz", + "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==", + "dev": true, + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/argv-formatter": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/argv-formatter/-/argv-formatter-1.0.0.tgz", + "integrity": "sha512-F2+Hkm9xFaRg+GkaNnbwXNDV5O6pnCFEmqyhvfC/Ic5LbgOWjJh3L+mN/s91rxVL3znE7DYVpW0GJFT+4YBgWw==", + "dev": true, + "license": "MIT" + }, + "node_modules/array-ify": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/array-ify/-/array-ify-1.0.0.tgz", + "integrity": "sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==", + "dev": true, + "license": "MIT" + }, + "node_modules/before-after-hook": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/before-after-hook/-/before-after-hook-4.0.0.tgz", + "integrity": "sha512-q6tR3RPqIB1pMiTRMFcZwuG5T8vwp+vUvEG0vuI6B+Rikh5BfPp2fQ82c925FOs+b0lcFQ8CFrL+KbilfZFhOQ==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/bottleneck": { + "version": "2.19.5", + "resolved": "https://registry.npmjs.org/bottleneck/-/bottleneck-2.19.5.tgz", + "integrity": "sha512-VHiNCbI1lKdl44tGrhNfU3lup0Tj/ZBMJB5/2ZbNXRCPuRCO7ed2mgcK4r17y+KB2EfuYuRaVlwNbAeaWGSpbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/char-regex": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", + "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/clean-stack": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-5.3.0.tgz", + "integrity": "sha512-9ngPTOhYGQqNVSfeJkYXHmF7AGWp4/nN5D/QqNQs3Dvxd1Kk/WpjHfNujKHYUQ/5CoGyOyFNoWSPk5afzP0QVg==", + "dev": true, + "license": "MIT", + "dependencies": { + "escape-string-regexp": "5.0.0" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-highlight": { + "version": "2.1.11", + "resolved": "https://registry.npmjs.org/cli-highlight/-/cli-highlight-2.1.11.tgz", + "integrity": "sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg==", + "dev": true, + "license": "ISC", + "dependencies": { + "chalk": "^4.0.0", + "highlight.js": "^10.7.1", + "mz": "^2.4.0", + "parse5": "^5.1.1", + "parse5-htmlparser2-tree-adapter": "^6.0.0", + "yargs": "^16.0.0" + }, + "bin": { + "highlight": "bin/highlight" + }, + "engines": { + "node": ">=8.0.0", + "npm": ">=5.0.0" + } + }, + "node_modules/cli-highlight/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/cli-highlight/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/cli-highlight/node_modules/cliui": { + "version": "7.0.4", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", + "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.0", + "wrap-ansi": "^7.0.0" + } + }, + "node_modules/cli-highlight/node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/cli-highlight/node_modules/yargs": { + "version": "16.2.2", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.2.tgz", + "integrity": "sha512-Nt9ZJjXTv5R8MHbqby/wXQ6Gi0Bb3TcYZkR1bzuL4yB2OxWPkXknz513gEF0GoA6tn00UpbPvERW8rzCuWCA6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^7.0.2", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.0", + "y18n": "^5.0.5", + "yargs-parser": "^20.2.2" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/cli-highlight/node_modules/yargs-parser": { + "version": "20.2.9", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", + "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/cli-table3": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz", + "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "string-width": "^4.2.0" + }, + "engines": { + "node": "10.* || >= 12.*" + }, + "optionalDependencies": { + "@colors/colors": "1.5.0" + } + }, + "node_modules/cliui": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz", + "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^7.2.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/cliui/node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "dev": true, + "license": "MIT" + }, + "node_modules/cliui/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cliui/node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/compare-func": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", + "integrity": "sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-ify": "^1.0.0", + "dot-prop": "^5.1.0" + } + }, + "node_modules/config-chain": { + "version": "1.1.13", + "resolved": "https://registry.npmjs.org/config-chain/-/config-chain-1.1.13.tgz", + "integrity": "sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ini": "^1.3.4", + "proto-list": "~1.2.1" + } + }, + "node_modules/content-type": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-3.1.1.tgz", + "integrity": "sha512-GW4qUsfFo59d0HbUibDlWv5wPz+vAAcaTWbKIuKCf0JkC7wWkSyf8f13IpXn5JkeMlB2P8iTSSIjwXljorg2vA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/conventional-changelog-angular": { + "version": "8.3.1", + "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-8.3.1.tgz", + "integrity": "sha512-6gfI3otXK5Ph5DfCOI1dblr+kN3FAm5a97hYoQkqNZxOaYa5WKfXH+AnpsmS+iUH2mgVC2Cg2Qw9m5OKcmNrIg==", + "dev": true, + "license": "ISC", + "dependencies": { + "compare-func": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/conventional-changelog-conventionalcommits": { + "version": "9.3.1", + "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-9.3.1.tgz", + "integrity": "sha512-dTYtpIacRpcZgrvBYvBfArMmK2xvIpv2TaxM0/ZI5CBtNUzvF2x0t15HsbRABWprS6UPmvj+PzHVjSx4qAVKyw==", + "dev": true, + "license": "ISC", + "dependencies": { + "compare-func": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/conventional-changelog-writer": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/conventional-changelog-writer/-/conventional-changelog-writer-8.4.0.tgz", + "integrity": "sha512-HHBFkk1EECxxmCi4CTu091iuDpQv5/OavuCUAuZmrkWpmYfyD816nom1CvtfXJ/uYfAAjavgHvXHX291tSLK8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@simple-libs/stream-utils": "^1.2.0", + "conventional-commits-filter": "^5.0.0", + "handlebars": "^4.7.7", + "meow": "^13.0.0", + "semver": "^7.5.2" + }, + "bin": { + "conventional-changelog-writer": "dist/cli/index.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/conventional-commits-filter": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-5.0.0.tgz", + "integrity": "sha512-tQMagCOC59EVgNZcC5zl7XqO30Wki9i9J3acbUvkaosCT6JX3EeFwJD7Qqp4MCikRnzS18WXV3BLIQ66ytu6+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/conventional-commits-parser": { + "version": "6.4.0", + "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-6.4.0.tgz", + "integrity": "sha512-tvRg7FIBNlyPzjdG8wWRlPHQJJHI7DylhtRGeU9Lq+JuoPh5BKpPRX83ZdLrvXuOSu5Eo/e7SzOQhU4Hd2Miuw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@simple-libs/stream-utils": "^1.2.0", + "meow": "^13.0.0" + }, + "bin": { + "conventional-commits-parser": "dist/cli/index.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/convert-hrtime": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/convert-hrtime/-/convert-hrtime-5.0.0.tgz", + "integrity": "sha512-lOETlkIeYSJWcbbcvjRKGxVMXJR+8+OQb/mTPbA4ObPMytYIsUbuOE0Jzy60hjARYszq1id0j8KgVhC+WGZVTg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/core-util-is": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", + "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/cosmiconfig": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.2.tgz", + "integrity": "sha512-gtTZxTDau1wL7Y7zifc2dd8jHSK/k6BTx/2Xp/BpdlAdnlYWFVt7qhJqgwi7637yRwRQ3qL4ZidbB4I8tA5VOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "env-paths": "^2.2.1", + "import-fresh": "^3.3.0", + "js-yaml": "^4.1.0", + "parse-json": "^5.2.0" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/d-fischer" + }, + "peerDependencies": { + "typescript": ">=4.9.5" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/cosmiconfig/node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/crypto-random-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-4.0.0.tgz", + "integrity": "sha512-x8dy3RnvYdlUcPOjkEHqozhiwzKNSq7GcPuXFbnyMOCHxX8V3OgIg/pYuabl2sbUPfIJaeAQB7PMOK8DFIdoRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "type-fest": "^1.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/crypto-random-string/node_modules/type-fest": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-1.4.0.tgz", + "integrity": "sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-extend": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", + "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/dot-prop": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/dot-prop/-/dot-prop-5.3.0.tgz", + "integrity": "sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-obj": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/duplexer2": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/duplexer2/-/duplexer2-0.1.4.tgz", + "integrity": "sha512-asLFVfWWtJ90ZyOUHMqk7/S2w2guQKxUI2itj3d92ADHhxUSbCMGi1f1cBcJ7xM1To+pE/Khbwo1yuNbMEPKeA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "readable-stream": "^2.0.2" + } + }, + "node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/emojilib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/emojilib/-/emojilib-2.4.0.tgz", + "integrity": "sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw==", + "dev": true, + "license": "MIT" + }, + "node_modules/env-ci": { + "version": "11.2.0", + "resolved": "https://registry.npmjs.org/env-ci/-/env-ci-11.2.0.tgz", + "integrity": "sha512-D5kWfzkmaOQDioPmiviWAVtKmpPT4/iJmMVQxWxMPJTFyTkdc5JQUfc5iXEeWxcOdsYTKSAiA/Age4NUOqKsRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "execa": "^8.0.0", + "java-properties": "^1.0.2" + }, + "engines": { + "node": "^18.17 || >=20.6.1" + } + }, + "node_modules/env-ci/node_modules/execa": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-8.0.1.tgz", + "integrity": "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^8.0.1", + "human-signals": "^5.0.0", + "is-stream": "^3.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^5.1.0", + "onetime": "^6.0.0", + "signal-exit": "^4.1.0", + "strip-final-newline": "^3.0.0" + }, + "engines": { + "node": ">=16.17" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/env-ci/node_modules/get-stream": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-8.0.1.tgz", + "integrity": "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/env-ci/node_modules/human-signals": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-5.0.0.tgz", + "integrity": "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=16.17.0" + } + }, + "node_modules/env-ci/node_modules/is-stream": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz", + "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/env-ci/node_modules/npm-run-path": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.3.0.tgz", + "integrity": "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^4.0.0" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/env-ci/node_modules/path-key": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz", + "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/env-ci/node_modules/strip-final-newline": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz", + "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/env-paths": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz", + "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/error-ex": { + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz", + "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-arrayish": "^0.2.1" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-string-regexp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz", + "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/execa": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-9.6.1.tgz", + "integrity": "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/merge-streams": "^4.0.0", + "cross-spawn": "^7.0.6", + "figures": "^6.1.0", + "get-stream": "^9.0.0", + "human-signals": "^8.0.1", + "is-plain-obj": "^4.1.0", + "is-stream": "^4.0.1", + "npm-run-path": "^6.0.0", + "pretty-ms": "^9.2.0", + "signal-exit": "^4.1.0", + "strip-final-newline": "^4.0.0", + "yoctocolors": "^2.1.1" + }, + "engines": { + "node": "^18.19.0 || >=20.5.0" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/figures": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/figures/-/figures-6.1.0.tgz", + "integrity": "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-unicode-supported": "^2.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/find-up": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz", + "integrity": "sha512-NWzkk0jSJtTt08+FBFMvXoeZnOJD+jTtsRmBYbAIzJdX6l7dLgR7CTubCM5/eDdPUBvLCeVasP1brfVR/9/EZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^2.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/find-up-simple": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/find-up-simple/-/find-up-simple-1.0.1.tgz", + "integrity": "sha512-afd4O7zpqHeRyg4PfDQsXmlDe2PfdHtJt6Akt8jOWaApLOZk5JXs6VMR29lz03pRe9mpykrRCYIYxaJYcfpncQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/find-versions": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/find-versions/-/find-versions-6.0.0.tgz", + "integrity": "sha512-2kCCtc+JvcZ86IGAz3Z2Y0A1baIz9fL31pH/0S1IqZr9Iwnjq8izfPtrCyQKO6TLMPELLsQMre7VDqeIKCsHkA==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver-regex": "^4.0.5", + "super-regex": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/fs-extra": { + "version": "11.4.1", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.4.1.tgz", + "integrity": "sha512-KYAb4c9BJQI6QqGKthV68OHe0badztdXJWKo0WtBA9IuCFPTKvE5ZdUBglP833aMjhaSPNO4A5j/EkzZtGlKjA==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=14.14" + } + }, + "node_modules/function-timeout": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/function-timeout/-/function-timeout-1.0.2.tgz", + "integrity": "sha512-939eZS4gJ3htTHAldmyyuzlrD58P03fHG49v2JfFXbV6OhvZKRC9j2yAtdHw/zrp2zXHuv05zMIy40F0ge7spA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.7.0.tgz", + "integrity": "sha512-XjH1AECxf0giL2V1aU8vKyRR2ppRUb5c0EvT7zuJTokQ74bNo52zOtghqdWIqrhUD79fo3x0WfKZdOqxF6LG1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-stream": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-9.0.1.tgz", + "integrity": "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sec-ant/readable-stream": "^0.4.1", + "is-stream": "^4.0.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/git-log-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/git-log-parser/-/git-log-parser-1.2.1.tgz", + "integrity": "sha512-PI+sPDvHXNPl5WNOErAK05s3j0lgwUzMN6o8cyQrDaKfT3qd7TmNJKeXX+SknI5I0QhG5fVPAEwSY4tRGDtYoQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "argv-formatter": "~1.0.0", + "spawn-error-forwarder": "~1.0.0", + "split2": "~1.0.0", + "stream-combiner2": "~1.1.1", + "through2": "~2.0.0", + "traverse": "0.6.8" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.12", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.12.tgz", + "integrity": "sha512-iuyGF2E4oafQfPsRrG2wtY2ILupMhvtdrhzrxB+0VcjsPpSPttpfYdjnGFGsTi5MaJFjI1jOKHPQ6UTbTj9TAw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, + "node_modules/handlebars": { + "version": "4.7.10", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.10.tgz", + "integrity": "sha512-P5VJMVM7qgBn6vjXMw8WG9uVI+ncf2pi72j4de4yz5ZULLj2RGqLYaKOYGsgyrViQ0tePOVlN1tDCCXXtFqXKg==", + "dev": true, + "license": "MIT", + "dependencies": { + "minimist": "^1.2.8", + "neo-async": "^2.6.2", + "source-map": "^0.6.1", + "wordwrap": "^1.0.0" + }, + "bin": { + "handlebars": "bin/handlebars" + }, + "engines": { + "node": ">=0.4.7" + }, + "optionalDependencies": { + "uglify-js": "^3.1.4" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/highlight.js": { + "version": "10.7.3", + "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.3.tgz", + "integrity": "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": "*" + } + }, + "node_modules/hook-std": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/hook-std/-/hook-std-4.0.0.tgz", + "integrity": "sha512-IHI4bEVOt3vRUDJ+bFA9VUJlo7SzvFARPNLw75pqSmAOP2HmTWfFJtPvLBrDrlgjEYXY9zs7SFdHPQaJShkSCQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/hosted-git-info": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-7.0.2.tgz", + "integrity": "sha512-puUZAUKT5m8Zzvs72XWy3HtvVbTWljRE66cP60bxJzAqf2DgICo7lYTY2IHUmLnNpjYvw5bvmoHvPc0QO2a62w==", + "dev": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^10.0.1" + }, + "engines": { + "node": "^16.14.0 || >=18.0.0" + } + }, + "node_modules/http-proxy-agent": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-9.1.0.tgz", + "integrity": "sha512-2NxoveTT58mjYT4n3RPTEfCZGLMbidoO8XEieXfpSYxu+PQJ1qpx4ypwH6N+uF9twBPIvRRgvkvW5HUTYWENig==", + "dev": true, + "license": "MIT", + "dependencies": { + "agent-base": "9.0.0", + "debug": "^4.3.4", + "proxy-agent-negotiate": "1.1.0" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/https-proxy-agent": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-9.1.0.tgz", + "integrity": "sha512-ag87y7cJJ9/3+GxFr8Oy4O5faDsGRGnBGsJj/YjOSsSx/5eadKLYTMPlzuR6obgoCDDm0abAAZitXXQkMOPSpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "agent-base": "9.0.0", + "debug": "^4.3.4", + "proxy-agent-negotiate": "1.1.0" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/human-signals": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-8.0.1.tgz", + "integrity": "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-fresh/node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/import-from-esm": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/import-from-esm/-/import-from-esm-2.0.0.tgz", + "integrity": "sha512-YVt14UZCgsX1vZQ3gKjkWVdBdHQ6eu3MPU1TBgL1H5orXe2+jWD006WCPPtOuwlQm10NuzOW5WawiF1Q9veW8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.3.4", + "import-meta-resolve": "^4.0.0" + }, + "engines": { + "node": ">=18.20" + } + }, + "node_modules/import-meta-resolve": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz", + "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/indent-string": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz", + "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/index-to-position": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/index-to-position/-/index-to-position-1.2.0.tgz", + "integrity": "sha512-Yg7+ztRkqslMAS2iFaU+Oa4KTSidr63OsFGlOrJoW981kIYO3CGCS3wA95P1mUi/IVSJkn0D479KTJpVpvFNuw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/ini": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", + "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", + "dev": true, + "license": "ISC" + }, + "node_modules/is-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", + "dev": true, + "license": "MIT" + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-obj": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-2.0.0.tgz", + "integrity": "sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-stream": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-4.0.1.tgz", + "integrity": "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-unicode-supported": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz", + "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/issue-parser": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/issue-parser/-/issue-parser-7.0.2.tgz", + "integrity": "sha512-7atWPjhGEIX3JEtMrOYd8TKzboYlq+5sNbdl9POiLYOI14G5HZiQbZP0Xj5EZdrufQVXfJlpTV0hys0CuxwxZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash.capitalize": "^4.2.1", + "lodash.escaperegexp": "^4.1.2", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.uniqby": "^4.7.0" + }, + "engines": { + "node": "^18.17 || >=20.6.1" + } + }, + "node_modules/java-properties": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/java-properties/-/java-properties-1.0.2.tgz", + "integrity": "sha512-qjdpeo2yKlYTH7nFdK0vbZWuTCesk4o63v5iVOlhMQPfuIZQfW/HI35SjfhA+4qpg36rnFSvUK5b1m+ckIblQQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6.0" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.3.2", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz", + "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-parse-better-errors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz", + "integrity": "sha512-mrqyZKfX5EhL7hvqcV6WG1yYjnjeuYDzDhhcAAUrq8Po85NBQBJP+ZDUT75qZQ98IkUoBqdkExkukOU7Ts2wrw==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-with-bigint": { + "version": "3.5.12", + "resolved": "https://registry.npmjs.org/json-with-bigint/-/json-with-bigint-3.5.12.tgz", + "integrity": "sha512-uwbF/wSSuOgC7qqlq27Xp5B6a2MHVug3t0idZdTqu0JnlFvgJuH7ju+KAk/J06C7GfhoYy2gnb9wz2INqcne7w==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsonfile": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz", + "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "dev": true, + "license": "MIT" + }, + "node_modules/load-json-file": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-4.0.0.tgz", + "integrity": "sha512-Kx8hMakjX03tiGTLAIdJ+lL0htKnXjEZN6hk/tozf/WOuYGdZBJrZ+rCJRbVCugsjB3jMLn9746NsQIf5VjBMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.1.2", + "parse-json": "^4.0.0", + "pify": "^3.0.0", + "strip-bom": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/load-json-file/node_modules/parse-json": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-4.0.0.tgz", + "integrity": "sha512-aOIos8bujGN93/8Ox/jPLh7RwVnPEysynVFE+fQZyg6jKELEHwzgKdLRFHUgXJL6kylijVSBC4BvN9OmsB48Rw==", + "dev": true, + "license": "MIT", + "dependencies": { + "error-ex": "^1.3.1", + "json-parse-better-errors": "^1.0.1" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/locate-path": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz", + "integrity": "sha512-NCI2kiDkyR7VeEKm27Kda/iQHyKJe1Bu0FlTbYp3CqJu+9IFe9bLyAjMxf5ZDDbEg+iMPzB5zYyUTSm8wVTKmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^2.0.0", + "path-exists": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/lodash-es": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.18.1.tgz", + "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.capitalize": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/lodash.capitalize/-/lodash.capitalize-4.2.1.tgz", + "integrity": "sha512-kZzYOKspf8XVX5AvmQF94gQW0lejFVgb80G85bU4ZWzoJ6C03PQg3coYAUpSTpQWelrZELd3XWgHzw4Ck5kaIw==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.escaperegexp": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/lodash.escaperegexp/-/lodash.escaperegexp-4.1.2.tgz", + "integrity": "sha512-TM9YBvyC84ZxE3rgfefxUWiQKLilstD6k7PTGt6wfbtXF8ixIJLOL3VYyV/z+ZiPLsVxAsKAFVwWlWeb2Y8Yyw==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.uniqby": { + "version": "4.7.0", + "resolved": "https://registry.npmjs.org/lodash.uniqby/-/lodash.uniqby-4.7.0.tgz", + "integrity": "sha512-e/zcLx6CSbmaEgFHCA7BnoQKyCtKMxnuWrJygbwPs/AIn+IMKl66L8/s+wBUn5LRw2pZx3bUHibiV1b6aTWIww==", + "dev": true, + "license": "MIT" + }, + "node_modules/lru-cache": { + "version": "10.4.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz", + "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/make-asynchronous": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/make-asynchronous/-/make-asynchronous-1.1.0.tgz", + "integrity": "sha512-ayF7iT+44LXdxJLTrTd3TLQpFDDvPCBxXxbv+pMUSuHA5Q8zyAfwkRP6aHHwNVFBUFWtxAHqwNJxF8vMZLAbVg==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-event": "^6.0.0", + "type-fest": "^4.6.0", + "web-worker": "^1.5.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/marked": { + "version": "15.0.12", + "resolved": "https://registry.npmjs.org/marked/-/marked-15.0.12.tgz", + "integrity": "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA==", + "dev": true, + "license": "MIT", + "bin": { + "marked": "bin/marked.js" + }, + "engines": { + "node": ">= 18" + } + }, + "node_modules/marked-terminal": { + "version": "7.3.1", + "resolved": "https://registry.npmjs.org/marked-terminal/-/marked-terminal-7.3.1.tgz", + "integrity": "sha512-B1eKs5mRiacjHHMlex1zn0zkVomz2/KWjD/dyA8WRQTXk2d15OzVjiK/iuPfvDFB27Gvr8p/u6MYgU0NY/O45w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-escapes": "^7.3.0", + "ansi-regex": "^6.4.0", + "chalk": "^5.6.2", + "cli-highlight": "^2.1.11", + "cli-table3": "^0.6.5", + "node-emoji": "^2.2.0", + "supports-hyperlinks": "^3.2.0" + }, + "engines": { + "node": ">=16.0.0" + }, + "peerDependencies": { + "marked": ">=1 <19" + } + }, + "node_modules/meow": { + "version": "13.2.0", + "resolved": "https://registry.npmjs.org/meow/-/meow-13.2.0.tgz", + "integrity": "sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/merge-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", + "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", + "dev": true, + "license": "MIT" + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/mime": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/mime/-/mime-4.1.2.tgz", + "integrity": "sha512-ikRzZ2RwbUVDyL9SsU0f2Phcmav4yq5r8faH5ZZKHtOZrMBLnrQOrj0uvqZ5R1uQnj+RO7Wcklw/lAf81mP9LQ==", + "dev": true, + "funding": [ + "https://github.com/sponsors/broofa" + ], + "license": "MIT", + "bin": { + "mime": "bin/cli.js" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/mimic-fn": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz", + "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/mz": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz", + "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "any-promise": "^1.0.0", + "object-assign": "^4.0.1", + "thenify-all": "^1.0.0" + } + }, + "node_modules/neo-async": { + "version": "2.6.2", + "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", + "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", + "dev": true, + "license": "MIT" + }, + "node_modules/nerf-dart": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/nerf-dart/-/nerf-dart-1.0.0.tgz", + "integrity": "sha512-EZSPZB70jiVsivaBLYDCyntd5eH8NTSMOn3rB+HxwdmKThGELLdYv8qVIMWvZEFy9w8ZZpW9h9OB32l1rGtj7g==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-emoji": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-2.2.0.tgz", + "integrity": "sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/is": "^4.6.0", + "char-regex": "^1.0.2", + "emojilib": "^2.4.0", + "skin-tone": "^2.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/normalize-package-data": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-6.0.2.tgz", + "integrity": "sha512-V6gygoYb/5EmNI+MEGrWkC+e6+Rr7mTmfHrxDbLzxQogBkgzo76rkok0Am6thgSF7Mv2nLOajAJj5vDJZEFn7g==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "hosted-git-info": "^7.0.0", + "semver": "^7.3.5", + "validate-npm-package-license": "^3.0.4" + }, + "engines": { + "node": "^16.14.0 || >=18.0.0" + } + }, + "node_modules/normalize-url": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-9.0.1.tgz", + "integrity": "sha512-ARftfC5HdUNu9jJeL8pHj8debUIHA2b91FizCoMzY4lG6dDX13jdvTK0TBe24IBDRf2HvJSzzwEPvmbkQWHRSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm": { + "version": "11.21.2", + "resolved": "https://registry.npmjs.org/npm/-/npm-11.21.2.tgz", + "integrity": "sha512-7HPApk+AflMUavSseL1Pm6CnYqMIHk53x+KmuhqmTDqPkjPMgxIpTPcTqsE91EKNw4gFBJV9fnXiSdGm1DXq9A==", + "bundleDependencies": [ + "@isaacs/string-locale-compare", + "@npmcli/arborist", + "@npmcli/config", + "@npmcli/fs", + "@npmcli/map-workspaces", + "@npmcli/metavuln-calculator", + "@npmcli/package-json", + "@npmcli/promise-spawn", + "@npmcli/redact", + "@npmcli/run-script", + "@sigstore/tuf", + "abbrev", + "archy", + "cacache", + "chalk", + "ci-info", + "fastest-levenshtein", + "fs-minipass", + "glob", + "graceful-fs", + "hosted-git-info", + "ini", + "init-package-json", + "is-cidr", + "json-parse-even-better-errors", + "libnpmaccess", + "libnpmdiff", + "libnpmexec", + "libnpmfund", + "libnpmorg", + "libnpmpack", + "libnpmpublish", + "libnpmsearch", + "libnpmteam", + "libnpmversion", + "make-fetch-happen", + "minimatch", + "minipass", + "minipass-pipeline", + "ms", + "node-gyp", + "nopt", + "npm-audit-report", + "npm-install-checks", + "npm-package-arg", + "npm-pick-manifest", + "npm-profile", + "npm-registry-fetch", + "npm-user-validate", + "p-map", + "pacote", + "parse-conflict-json", + "proc-log", + "qrcode-terminal", + "read", + "semver", + "spdx-expression-parse", + "ssri", + "supports-color", + "tar", + "text-table", + "tiny-relative-date", + "treeverse", + "validate-npm-package-name", + "which" + ], + "dev": true, + "license": "Artistic-2.0", + "workspaces": [ + "docs", + "smoke-tests", + "mock-globals", + "mock-registry", + "workspaces/*" + ], + "dependencies": { + "@isaacs/string-locale-compare": "^1.1.0", + "@npmcli/arborist": "^9.9.3", + "@npmcli/config": "^10.14.0", + "@npmcli/fs": "^5.0.0", + "@npmcli/map-workspaces": "^5.0.3", + "@npmcli/metavuln-calculator": "^9.0.3", + "@npmcli/package-json": "^7.0.5", + "@npmcli/promise-spawn": "^9.0.2", + "@npmcli/redact": "^4.0.0", + "@npmcli/run-script": "^10.0.4", + "@sigstore/tuf": "^4.0.2", + "abbrev": "^4.0.0", + "archy": "~1.0.0", + "cacache": "^20.0.4", + "chalk": "^5.6.2", + "ci-info": "^4.4.0", + "fastest-levenshtein": "^1.0.16", + "fs-minipass": "^3.0.3", + "glob": "^13.0.6", + "graceful-fs": "^4.2.11", + "hosted-git-info": "^9.0.3", + "ini": "^6.0.0", + "init-package-json": "^8.2.5", + "is-cidr": "^6.0.4", + "json-parse-even-better-errors": "^5.0.0", + "libnpmaccess": "^10.0.3", + "libnpmdiff": "^8.1.14", + "libnpmexec": "^10.3.5", + "libnpmfund": "^7.0.28", + "libnpmorg": "^8.0.1", + "libnpmpack": "^9.1.15", + "libnpmpublish": "^11.2.1", + "libnpmsearch": "^9.0.1", + "libnpmteam": "^8.0.2", + "libnpmversion": "^8.0.4", + "make-fetch-happen": "^15.0.6", + "minimatch": "^10.2.5", + "minipass": "^7.1.3", + "minipass-pipeline": "^1.2.4", + "ms": "^2.1.2", + "node-gyp": "^12.4.0", + "nopt": "^9.0.0", + "npm-audit-report": "^7.0.0", + "npm-install-checks": "^8.0.0", + "npm-package-arg": "^13.0.2", + "npm-pick-manifest": "^11.0.3", + "npm-profile": "^12.0.2", + "npm-registry-fetch": "^19.1.1", + "npm-user-validate": "^4.0.0", + "p-map": "^7.0.4", + "pacote": "^21.5.2", + "parse-conflict-json": "^5.0.1", + "proc-log": "^6.1.0", + "qrcode-terminal": "^0.12.0", + "read": "^5.0.1", + "semver": "^7.8.6", + "spdx-expression-parse": "^4.0.0", + "ssri": "^13.0.1", + "supports-color": "^10.2.2", + "tar": "^7.5.22", + "text-table": "~0.2.0", + "tiny-relative-date": "^2.0.2", + "treeverse": "^3.0.0", + "validate-npm-package-name": "^7.0.2", + "which": "^6.0.1" + }, + "bin": { + "npm": "bin/npm-cli.js", + "npx": "bin/npx-cli.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm-run-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-6.0.0.tgz", + "integrity": "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^4.0.0", + "unicorn-magic": "^0.3.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm-run-path/node_modules/path-key": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz", + "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm/node_modules/@gar/promise-retry": { + "version": "1.0.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@isaacs/fs-minipass": { + "version": "4.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^7.0.4" + }, + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/npm/node_modules/@isaacs/string-locale-compare": { + "version": "1.1.0", + "dev": true, + "inBundle": true, + "license": "ISC" + }, + "node_modules/npm/node_modules/@npmcli/agent": { + "version": "4.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "agent-base": "^7.1.0", + "http-proxy-agent": "^7.0.0", + "https-proxy-agent": "^7.0.1", + "lru-cache": "^11.2.1", + "socks-proxy-agent": "^8.0.3" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/arborist": { + "version": "9.9.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@gar/promise-retry": "^1.0.0", + "@isaacs/string-locale-compare": "^1.1.0", + "@npmcli/fs": "^5.0.0", + "@npmcli/installed-package-contents": "^4.0.0", + "@npmcli/map-workspaces": "^5.0.0", + "@npmcli/metavuln-calculator": "^9.0.2", + "@npmcli/name-from-folder": "^4.0.0", + "@npmcli/node-gyp": "^5.0.0", + "@npmcli/package-json": "^7.0.0", + "@npmcli/query": "^5.0.0", + "@npmcli/redact": "^4.0.0", + "@npmcli/run-script": "^10.0.0", + "bin-links": "^6.0.0", + "cacache": "^20.0.1", + "common-ancestor-path": "^2.0.0", + "hosted-git-info": "^9.0.0", + "json-stringify-nice": "^1.1.4", + "lru-cache": "^11.2.1", + "minimatch": "^10.0.3", + "nopt": "^9.0.0", + "npm-install-checks": "^8.0.0", + "npm-package-arg": "^13.0.0", + "npm-pick-manifest": "^11.0.1", + "npm-registry-fetch": "^19.0.0", + "pacote": "^21.0.2", + "parse-conflict-json": "^5.0.1", + "proc-log": "^6.0.0", + "proggy": "^4.0.0", + "promise-all-reject-late": "^1.0.0", + "promise-call-limit": "^3.0.1", + "semver": "^7.3.7", + "ssri": "^13.0.0", + "treeverse": "^3.0.0", + "walk-up-path": "^4.0.0" + }, + "bin": { + "arborist": "bin/index.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/config": { + "version": "10.14.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/map-workspaces": "^5.0.0", + "@npmcli/package-json": "^7.0.0", + "ci-info": "^4.0.0", + "ini": "^6.0.0", + "nopt": "^9.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.5", + "walk-up-path": "^4.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/fs": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "semver": "^7.3.5" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/git": { + "version": "7.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@gar/promise-retry": "^1.0.0", + "@npmcli/promise-spawn": "^9.0.0", + "ini": "^6.0.0", + "lru-cache": "^11.2.1", + "npm-pick-manifest": "^11.0.1", + "proc-log": "^6.0.0", + "semver": "^7.3.5", + "which": "^6.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/installed-package-contents": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-bundled": "^5.0.0", + "npm-normalize-package-bin": "^5.0.0" + }, + "bin": { + "installed-package-contents": "bin/index.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/map-workspaces": { + "version": "5.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/name-from-folder": "^4.0.0", + "@npmcli/package-json": "^7.0.0", + "glob": "^13.0.0", + "minimatch": "^10.0.3" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/metavuln-calculator": { + "version": "9.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "cacache": "^20.0.0", + "json-parse-even-better-errors": "^5.0.0", + "pacote": "^21.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.5" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/name-from-folder": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/node-gyp": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/package-json": { + "version": "7.0.5", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/git": "^7.0.0", + "glob": "^13.0.0", + "hosted-git-info": "^9.0.0", + "json-parse-even-better-errors": "^5.0.0", + "proc-log": "^6.0.0", + "semver": "^7.5.3", + "spdx-expression-parse": "^4.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/promise-spawn": { + "version": "9.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "which": "^6.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/query": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "postcss-selector-parser": "^7.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/redact": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@npmcli/run-script": { + "version": "10.0.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/node-gyp": "^5.0.0", + "@npmcli/package-json": "^7.0.0", + "@npmcli/promise-spawn": "^9.0.0", + "node-gyp": "^12.1.0", + "proc-log": "^6.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@sigstore/bundle": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "dependencies": { + "@sigstore/protobuf-specs": "^0.5.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@sigstore/core": { + "version": "3.2.1", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@sigstore/protobuf-specs": { + "version": "0.5.1", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.17.0 || >=20.5.0" + } + }, + "node_modules/npm/node_modules/@sigstore/sign": { + "version": "4.1.1", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "dependencies": { + "@gar/promise-retry": "^1.0.2", + "@sigstore/bundle": "^4.0.0", + "@sigstore/core": "^3.2.0", + "@sigstore/protobuf-specs": "^0.5.0", + "make-fetch-happen": "^15.0.4", + "proc-log": "^6.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@sigstore/tuf": { + "version": "4.0.2", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "dependencies": { + "@sigstore/protobuf-specs": "^0.5.0", + "tuf-js": "^4.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@sigstore/verify": { + "version": "3.1.1", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "dependencies": { + "@sigstore/bundle": "^4.0.0", + "@sigstore/core": "^3.2.1", + "@sigstore/protobuf-specs": "^0.5.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/@tufjs/canonical-json": { + "version": "2.0.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": "^16.14.0 || >=18.0.0" + } + }, + "node_modules/npm/node_modules/@tufjs/models": { + "version": "4.1.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "@tufjs/canonical-json": "2.0.0", + "minimatch": "^10.1.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/abbrev": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/agent-base": { + "version": "7.1.4", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, + "node_modules/npm/node_modules/aproba": { + "version": "2.1.0", + "dev": true, + "inBundle": true, + "license": "ISC" + }, + "node_modules/npm/node_modules/archy": { + "version": "1.0.0", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/balanced-match": { + "version": "4.0.4", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/npm/node_modules/bin-links": { + "version": "6.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "cmd-shim": "^8.0.0", + "npm-normalize-package-bin": "^5.0.0", + "proc-log": "^6.0.0", + "read-cmd-shim": "^6.0.0", + "write-file-atomic": "^7.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/binary-extensions": { + "version": "3.1.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=18.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm/node_modules/brace-expansion": { + "version": "5.0.12", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/npm/node_modules/cacache": { + "version": "20.0.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/fs": "^5.0.0", + "fs-minipass": "^3.0.0", + "glob": "^13.0.0", + "lru-cache": "^11.1.0", + "minipass": "^7.0.3", + "minipass-collect": "^2.0.1", + "minipass-flush": "^1.0.5", + "minipass-pipeline": "^1.2.4", + "p-map": "^7.0.2", + "ssri": "^13.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/chalk": { + "version": "5.6.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/npm/node_modules/chownr": { + "version": "3.0.0", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=18" + } + }, + "node_modules/npm/node_modules/ci-info": { + "version": "4.4.0", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/npm/node_modules/cidr-regex": { + "version": "5.0.5", + "dev": true, + "inBundle": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=20" + } + }, + "node_modules/npm/node_modules/cmd-shim": { + "version": "8.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/common-ancestor-path": { + "version": "2.0.0", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">= 18" + } + }, + "node_modules/npm/node_modules/cssesc": { + "version": "3.0.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "bin": { + "cssesc": "bin/cssesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/npm/node_modules/debug": { + "version": "4.4.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/npm/node_modules/diff": { + "version": "8.0.4", + "dev": true, + "inBundle": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/npm/node_modules/env-paths": { + "version": "2.2.1", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/npm/node_modules/exponential-backoff": { + "version": "3.1.3", + "dev": true, + "inBundle": true, + "license": "Apache-2.0" + }, + "node_modules/npm/node_modules/fastest-levenshtein": { + "version": "1.0.16", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">= 4.9.1" + } + }, + "node_modules/npm/node_modules/fs-minipass": { + "version": "3.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^7.0.3" + }, + "engines": { + "node": "^14.17.0 || ^16.13.0 || >=18.0.0" + } + }, + "node_modules/npm/node_modules/glob": { + "version": "13.0.6", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "minimatch": "^10.2.2", + "minipass": "^7.1.3", + "path-scurry": "^2.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/graceful-fs": { + "version": "4.2.11", + "dev": true, + "inBundle": true, + "license": "ISC" + }, + "node_modules/npm/node_modules/hosted-git-info": { + "version": "9.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^11.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/http-cache-semantics": { + "version": "4.3.0", + "dev": true, + "inBundle": true, + "license": "BSD-2-Clause" + }, + "node_modules/npm/node_modules/http-proxy-agent": { + "version": "7.0.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.0", + "debug": "^4.3.4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/npm/node_modules/https-proxy-agent": { + "version": "7.0.6", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/npm/node_modules/iconv-lite": { + "version": "0.7.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/npm/node_modules/ignore-walk": { + "version": "8.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minimatch": "^10.0.3" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/ini": { + "version": "6.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/init-package-json": { + "version": "8.2.5", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/package-json": "^7.0.0", + "npm-package-arg": "^13.0.0", + "promzard": "^3.0.1", + "read": "^5.0.1", + "semver": "^7.7.2", + "validate-npm-package-name": "^7.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/ip-address": { + "version": "10.7.5", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">= 12" + } + }, + "node_modules/npm/node_modules/is-cidr": { + "version": "6.0.4", + "dev": true, + "inBundle": true, + "license": "BSD-2-Clause", + "dependencies": { + "cidr-regex": "^5.0.4" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/npm/node_modules/isexe": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=20" + } + }, + "node_modules/npm/node_modules/json-parse-even-better-errors": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/json-stringify-nice": { + "version": "1.1.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/jsonparse": { + "version": "1.3.1", + "dev": true, + "engines": [ + "node >= 0.2.0" + ], + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/just-diff": { + "version": "6.0.2", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/just-diff-apply": { + "version": "5.5.0", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/libnpmaccess": { + "version": "10.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-package-arg": "^13.0.0", + "npm-registry-fetch": "^19.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmdiff": { + "version": "8.1.14", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/arborist": "^9.9.3", + "@npmcli/installed-package-contents": "^4.0.0", + "binary-extensions": "^3.0.0", + "diff": "^8.0.2", + "minimatch": "^10.0.3", + "npm-package-arg": "^13.0.0", + "pacote": "^21.0.2", + "tar": "^7.5.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmexec": { + "version": "10.3.5", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@gar/promise-retry": "^1.0.0", + "@npmcli/arborist": "^9.9.3", + "@npmcli/package-json": "^7.0.0", + "@npmcli/run-script": "^10.0.0", + "ci-info": "^4.0.0", + "npm-package-arg": "^13.0.0", + "pacote": "^21.0.2", + "proc-log": "^6.0.0", + "read": "^5.0.1", + "semver": "^7.3.7", + "signal-exit": "^4.1.0", + "walk-up-path": "^4.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmfund": { + "version": "7.0.28", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/arborist": "^9.9.3" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmorg": { + "version": "8.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "aproba": "^2.0.0", + "npm-registry-fetch": "^19.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmpack": { + "version": "9.1.15", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/arborist": "^9.9.3", + "@npmcli/run-script": "^10.0.0", + "npm-package-arg": "^13.0.0", + "pacote": "^21.0.2" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmpublish": { + "version": "11.2.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/package-json": "^7.0.0", + "ci-info": "^4.0.0", + "npm-package-arg": "^13.0.0", + "npm-registry-fetch": "^19.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.7", + "sigstore": "^4.0.0", + "ssri": "^13.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmsearch": { + "version": "9.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-registry-fetch": "^19.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmteam": { + "version": "8.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "aproba": "^2.0.0", + "npm-registry-fetch": "^19.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/libnpmversion": { + "version": "8.0.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/git": "^7.0.0", + "@npmcli/run-script": "^10.0.0", + "json-parse-even-better-errors": "^5.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.7" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/lru-cache": { + "version": "11.5.1", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/npm/node_modules/make-fetch-happen": { + "version": "15.0.6", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@gar/promise-retry": "^1.0.0", + "@npmcli/agent": "^4.0.0", + "@npmcli/redact": "^4.0.0", + "cacache": "^20.0.1", + "http-cache-semantics": "^4.1.1", + "minipass": "^7.0.2", + "minipass-fetch": "^5.0.0", + "minipass-flush": "^1.0.5", + "minipass-pipeline": "^1.2.4", + "negotiator": "^1.0.0", + "proc-log": "^6.0.0", + "ssri": "^13.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/minimatch": { + "version": "10.2.5", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/minipass": { + "version": "7.1.3", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/npm/node_modules/minipass-collect": { + "version": "2.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^7.0.3" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/npm/node_modules/minipass-fetch": { + "version": "5.0.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "minipass": "^7.0.3", + "minipass-sized": "^2.0.0", + "minizlib": "^3.0.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + }, + "optionalDependencies": { + "iconv-lite": "^0.7.2" + } + }, + "node_modules/npm/node_modules/minipass-flush": { + "version": "1.0.6", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "minipass": "^7.1.3" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/npm/node_modules/minipass-pipeline": { + "version": "1.2.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/npm/node_modules/minipass-pipeline/node_modules/minipass": { + "version": "3.3.6", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/npm/node_modules/minipass-pipeline/node_modules/yallist": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC" + }, + "node_modules/npm/node_modules/minipass-sized": { + "version": "2.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^7.1.2" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/npm/node_modules/minizlib": { + "version": "3.1.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "minipass": "^7.1.2" + }, + "engines": { + "node": ">= 18" + } + }, + "node_modules/npm/node_modules/ms": { + "version": "2.1.3", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/mute-stream": { + "version": "3.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/negotiator": { + "version": "1.0.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/npm/node_modules/node-gyp": { + "version": "12.4.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "env-paths": "^2.2.0", + "exponential-backoff": "^3.1.1", + "graceful-fs": "^4.2.6", + "nopt": "^9.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.5", + "tar": "^7.5.4", + "tinyglobby": "^0.2.12", + "undici": "^6.25.0", + "which": "^6.0.0" + }, + "bin": { + "node-gyp": "bin/node-gyp.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/nopt": { + "version": "9.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "abbrev": "^4.0.0" + }, + "bin": { + "nopt": "bin/nopt.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-audit-report": { + "version": "7.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-bundled": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-normalize-package-bin": "^5.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-install-checks": { + "version": "8.0.0", + "dev": true, + "inBundle": true, + "license": "BSD-2-Clause", + "dependencies": { + "semver": "^7.1.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-normalize-package-bin": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-package-arg": { + "version": "13.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "hosted-git-info": "^9.0.0", + "proc-log": "^6.0.0", + "semver": "^7.3.5", + "validate-npm-package-name": "^7.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-packlist": { + "version": "10.0.4", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "ignore-walk": "^8.0.0", + "proc-log": "^6.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-pick-manifest": { + "version": "11.0.3", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-install-checks": "^8.0.0", + "npm-normalize-package-bin": "^5.0.0", + "npm-package-arg": "^13.0.0", + "semver": "^7.3.5" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-profile": { + "version": "12.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "npm-registry-fetch": "^19.0.0", + "proc-log": "^6.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-registry-fetch": { + "version": "19.1.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@npmcli/redact": "^4.0.0", + "jsonparse": "^1.3.1", + "make-fetch-happen": "^15.0.0", + "minipass": "^7.0.2", + "minipass-fetch": "^5.0.0", + "minizlib": "^3.0.1", + "npm-package-arg": "^13.0.0", + "proc-log": "^6.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/npm-user-validate": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "BSD-2-Clause", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/p-map": { + "version": "7.0.4", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm/node_modules/pacote": { + "version": "21.5.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "@gar/promise-retry": "^1.0.0", + "@npmcli/git": "^7.0.0", + "@npmcli/installed-package-contents": "^4.0.0", + "@npmcli/package-json": "^7.0.0", + "@npmcli/promise-spawn": "^9.0.0", + "@npmcli/run-script": "^10.0.0", + "cacache": "^20.0.0", + "fs-minipass": "^3.0.0", + "minipass": "^7.0.2", + "npm-package-arg": "^13.0.0", + "npm-packlist": "^10.0.1", + "npm-pick-manifest": "^11.0.1", + "npm-registry-fetch": "^19.0.0", + "proc-log": "^6.0.0", + "sigstore": "^4.0.0", + "ssri": "^13.0.0", + "tar": "^7.4.3" + }, + "bin": { + "pacote": "bin/index.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/parse-conflict-json": { + "version": "5.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "json-parse-even-better-errors": "^5.0.0", + "just-diff": "^6.0.0", + "just-diff-apply": "^5.2.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/path-scurry": { + "version": "2.0.2", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^11.0.0", + "minipass": "^7.1.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/postcss-selector-parser": { + "version": "7.1.6", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "cssesc": "^3.0.0", + "util-deprecate": "^1.0.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/npm/node_modules/proc-log": { + "version": "6.1.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/proggy": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/promise-all-reject-late": { + "version": "1.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/promise-call-limit": { + "version": "3.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/promzard": { + "version": "3.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "read": "^5.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/qrcode-terminal": { + "version": "0.12.0", + "dev": true, + "inBundle": true, + "bin": { + "qrcode-terminal": "bin/qrcode-terminal.js" + } + }, + "node_modules/npm/node_modules/read": { + "version": "5.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "mute-stream": "^3.0.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/read-cmd-shim": { + "version": "6.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/safer-buffer": { + "version": "2.1.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true + }, + "node_modules/npm/node_modules/semver": { + "version": "7.8.6", + "dev": true, + "inBundle": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/npm/node_modules/signal-exit": { + "version": "4.1.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/npm/node_modules/sigstore": { + "version": "4.1.1", + "dev": true, + "inBundle": true, + "license": "Apache-2.0", + "dependencies": { + "@sigstore/bundle": "^4.0.0", + "@sigstore/core": "^3.2.1", + "@sigstore/protobuf-specs": "^0.5.0", + "@sigstore/sign": "^4.1.1", + "@sigstore/tuf": "^4.0.2", + "@sigstore/verify": "^3.1.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/smart-buffer": { + "version": "4.2.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">= 6.0.0", + "npm": ">= 3.0.0" + } + }, + "node_modules/npm/node_modules/socks": { + "version": "2.8.9", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "ip-address": "^10.1.1", + "smart-buffer": "^4.2.0" + }, + "engines": { + "node": ">= 10.0.0", + "npm": ">= 3.0.0" + } + }, + "node_modules/npm/node_modules/socks-proxy-agent": { + "version": "8.0.5", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "^4.3.4", + "socks": "^2.8.3" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/npm/node_modules/spdx-exceptions": { + "version": "2.5.0", + "dev": true, + "inBundle": true, + "license": "CC-BY-3.0" + }, + "node_modules/npm/node_modules/spdx-expression-parse": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "spdx-exceptions": "^2.1.0", + "spdx-license-ids": "^3.0.0" + } + }, + "node_modules/npm/node_modules/spdx-license-ids": { + "version": "3.0.23", + "dev": true, + "inBundle": true, + "license": "CC0-1.0" + }, + "node_modules/npm/node_modules/ssri": { + "version": "13.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "minipass": "^7.0.3" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/supports-color": { + "version": "10.2.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/npm/node_modules/tar": { + "version": "7.5.22", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "@isaacs/fs-minipass": "^4.0.0", + "chownr": "^3.0.0", + "minipass": "^7.1.2", + "minizlib": "^3.1.0", + "yallist": "^5.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/npm/node_modules/text-table": { + "version": "0.2.0", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/tiny-relative-date": { + "version": "2.0.2", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/tinyglobby": { + "version": "0.2.17", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/npm/node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/npm/node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.4", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/npm/node_modules/treeverse": { + "version": "3.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^14.17.0 || ^16.13.0 || >=18.0.0" + } + }, + "node_modules/npm/node_modules/tuf-js": { + "version": "4.1.0", + "dev": true, + "inBundle": true, + "license": "MIT", + "dependencies": { + "@tufjs/models": "4.1.0", + "debug": "^4.4.3", + "make-fetch-happen": "^15.0.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/undici": { + "version": "6.29.1", + "dev": true, + "inBundle": true, + "license": "MIT", + "engines": { + "node": ">=18.17" + } + }, + "node_modules/npm/node_modules/util-deprecate": { + "version": "1.0.2", + "dev": true, + "inBundle": true, + "license": "MIT" + }, + "node_modules/npm/node_modules/validate-npm-package-name": { + "version": "7.0.2", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/walk-up-path": { + "version": "4.0.0", + "dev": true, + "inBundle": true, + "license": "ISC", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/npm/node_modules/which": { + "version": "6.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "isexe": "^4.0.0" + }, + "bin": { + "node-which": "bin/which.js" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/write-file-atomic": { + "version": "7.0.1", + "dev": true, + "inBundle": true, + "license": "ISC", + "dependencies": { + "signal-exit": "^4.0.1" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/npm/node_modules/yallist": { + "version": "5.0.0", + "dev": true, + "inBundle": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=18" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/onetime": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz", + "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-fn": "^4.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-each-series": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-each-series/-/p-each-series-3.0.0.tgz", + "integrity": "sha512-lastgtAdoH9YaLyDa5i5z64q+kzOcQHsQ5SsZJD3q0VEyI8mq872S3geuNbRUQLVAE9siMfgKrpj7MloKFHruw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-event": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/p-event/-/p-event-6.0.1.tgz", + "integrity": "sha512-Q6Bekk5wpzW5qIyUP4gdMEujObYstZl6DMMOSenwBvV0BlE5LkDwkjs5yHbZmdCEq2o4RJx4tE1vwxFVf2FG1w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-timeout": "^6.1.2" + }, + "engines": { + "node": ">=16.17" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-filter": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-filter/-/p-filter-4.1.0.tgz", + "integrity": "sha512-37/tPdZ3oJwHaS3gNJdenCDB3Tz26i9sjhnguBtvN0vYlRIiDNnvTWkuh+0hETV9rLPdJ3rlL3yVOYPIAnM8rw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-map": "^7.0.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-limit": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz", + "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^1.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/p-locate": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz", + "integrity": "sha512-nQja7m7gSKuewoVRen45CtVfODR3crN3goVQ0DDZ9N3yHxgpkuBhZqsaiotSQRrADUrne346peY7kT3TSACykg==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^1.1.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/p-map": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/p-map/-/p-map-7.1.1.tgz", + "integrity": "sha512-6Lh3jQPLthYujSrlw6ccWXBGZTkoTCz27Hd92g79LH/kjAbgoEu0t442cCCNbegPSJsA0lwDX8z0bcKtkpA32g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-reduce": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-reduce/-/p-reduce-3.0.0.tgz", + "integrity": "sha512-xsrIUgI0Kn6iyDYm9StOpOeK29XM1aboGji26+QEortiFST1hGZaUQOLhtEbqHErPpGW/aSz6allwK2qcptp0Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-timeout": { + "version": "6.1.4", + "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-6.1.4.tgz", + "integrity": "sha512-MyIV3ZA/PmyBN/ud8vV9XzwTrNtR4jFrObymZYnZqMmW0zA8Z17vnT0rBgFE/TlohB+YCHqXMgZzb3Csp49vqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-try": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz", + "integrity": "sha512-U1etNYuMJoIz3ZXSrrySFjsXQTWOx2/jdi86L+2pRvph/qMKL6sbcCYdH23fqsbm8TH2Gn0OybpT4eSFlCVHww==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/parse-json": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-8.3.0.tgz", + "integrity": "sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.26.2", + "index-to-position": "^1.1.0", + "type-fest": "^4.39.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parse-ms": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/parse-ms/-/parse-ms-4.0.0.tgz", + "integrity": "sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parse5": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-5.1.1.tgz", + "integrity": "sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==", + "dev": true, + "license": "MIT" + }, + "node_modules/parse5-htmlparser2-tree-adapter": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-6.0.1.tgz", + "integrity": "sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA==", + "dev": true, + "license": "MIT", + "dependencies": { + "parse5": "^6.0.1" + } + }, + "node_modules/parse5-htmlparser2-tree-adapter/node_modules/parse5": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-6.0.1.tgz", + "integrity": "sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==", + "dev": true, + "license": "MIT" + }, + "node_modules/path-exists": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", + "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pify": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", + "integrity": "sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/pkg-conf": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/pkg-conf/-/pkg-conf-2.1.0.tgz", + "integrity": "sha512-C+VUP+8jis7EsQZIhDYmS5qlNtjv2yP4SNtjXK9AP1ZcTRlnSfuumaTnRfYZnYgUUYVIKqL0fRvmUGDV2fmp6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "find-up": "^2.0.0", + "load-json-file": "^4.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/pretty-ms": { + "version": "9.3.1", + "resolved": "https://registry.npmjs.org/pretty-ms/-/pretty-ms-9.3.1.tgz", + "integrity": "sha512-HzMy3Geq23nVALD/M2LliU+F+M+gVNsvkQWWqeBZ8HDiCgzo6YPJ/Omrmtq24EFrIsk0a3EkQGEd7bDOo+IhGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "parse-ms": "^4.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/process-nextick-args": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", + "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", + "dev": true, + "license": "MIT" + }, + "node_modules/proto-list": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/proto-list/-/proto-list-1.2.4.tgz", + "integrity": "sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==", + "dev": true, + "license": "ISC" + }, + "node_modules/proxy-agent-negotiate": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/proxy-agent-negotiate/-/proxy-agent-negotiate-1.1.0.tgz", + "integrity": "sha512-N8IBcM3UgCVzz2L2Lqv8DVntDnnC8/hiV4nEDUPkqq72TPUgYWjQc+bdZlBPZK9LzPAvOY//gAt0S0DApoOXWQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20" + }, + "peerDependencies": { + "kerberos": "^2.0.0" + }, + "peerDependenciesMeta": { + "kerberos": { + "optional": true + } + } + }, + "node_modules/rc": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", + "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", + "dev": true, + "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", + "dependencies": { + "deep-extend": "^0.6.0", + "ini": "~1.3.0", + "minimist": "^1.2.0", + "strip-json-comments": "~2.0.1" + }, + "bin": { + "rc": "cli.js" + } + }, + "node_modules/read-package-up": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/read-package-up/-/read-package-up-11.0.0.tgz", + "integrity": "sha512-MbgfoNPANMdb4oRBNg5eqLbB2t2r+o5Ua1pNt8BqGp4I0FJZhuVSOj3PaBPni4azWuSzEdNn2evevzVmEk1ohQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "find-up-simple": "^1.0.0", + "read-pkg": "^9.0.0", + "type-fest": "^4.6.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/read-pkg": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-9.0.1.tgz", + "integrity": "sha512-9viLL4/n1BJUCT1NXVTdS1jtm80yDEgR5T4yCelII49Mbj0v1rZdKqj7zCiYdbB0CuCgdrvHcNogAKTFPBocFA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/normalize-package-data": "^2.4.3", + "normalize-package-data": "^6.0.0", + "parse-json": "^8.0.0", + "type-fest": "^4.6.0", + "unicorn-magic": "^0.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/read-pkg/node_modules/unicorn-magic": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.1.0.tgz", + "integrity": "sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/readable-stream": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", + "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", + "dev": true, + "license": "MIT", + "dependencies": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" + } + }, + "node_modules/registry-auth-token": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/registry-auth-token/-/registry-auth-token-5.1.1.tgz", + "integrity": "sha512-P7B4+jq8DeD2nMsAcdfaqHbssgHtZ7Z5+++a5ask90fvmJ8p5je4mOa+wzu+DB4vQ5tdJV/xywY+UnVFeQLV5Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@pnpm/npm-conf": "^3.0.2" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "dev": true, + "license": "MIT" + }, + "node_modules/semantic-release": { + "version": "25.0.9", + "resolved": "https://registry.npmjs.org/semantic-release/-/semantic-release-25.0.9.tgz", + "integrity": "sha512-bxve7csK0/Txr++CkfrmV+X1r4jqiSOw2WsSad9E2S68R+ZfLBwDn8IceM8WfiOmKQIHgsQc1cNA8Dzg7U75pg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@semantic-release/commit-analyzer": "^13.0.1", + "@semantic-release/error": "^4.0.0", + "@semantic-release/github": "^12.0.0", + "@semantic-release/npm": "^13.1.1", + "@semantic-release/release-notes-generator": "^14.1.0", + "aggregate-error": "^5.0.0", + "cosmiconfig": "^9.0.0", + "debug": "^4.0.0", + "env-ci": "^11.0.0", + "execa": "^9.0.0", + "figures": "^6.0.0", + "find-versions": "^6.0.0", + "get-stream": "^6.0.0", + "git-log-parser": "^1.2.0", + "hook-std": "^4.0.0", + "hosted-git-info": "^9.0.0", + "import-from-esm": "^2.0.0", + "lodash-es": "^4.17.21", + "marked": "^15.0.0", + "marked-terminal": "^7.3.0", + "micromatch": "^4.0.2", + "p-each-series": "^3.0.0", + "p-reduce": "^3.0.0", + "read-package-up": "^12.0.0", + "resolve-from": "^5.0.0", + "semver": "^7.3.2", + "signale": "^1.2.1", + "yargs": "^18.0.0" + }, + "bin": { + "semantic-release": "bin/semantic-release.js" + }, + "engines": { + "node": "^22.14.0 || >= 24.10.0" + } + }, + "node_modules/semantic-release/node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/semantic-release/node_modules/hosted-git-info": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.3.tgz", + "integrity": "sha512-Hc+ghLoSt6QaYZUv0WBiIvmMDZuZZ7oaDvdH8MbfOO4lOsxdXLEvuC6ePoGs9H1X9oCLyq6+NVN0MKqD+ydxyg==", + "dev": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^11.1.0" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/semantic-release/node_modules/lru-cache": { + "version": "11.5.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.3.tgz", + "integrity": "sha512-U4N8FgzmWxc8k1VH8Kr6lQg18U7Fjvby6wXHVRX/ZZ7IwWbRMgrRbP0Wrb5q5NVinryp4SQampHKdvtecItxUg==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/semantic-release/node_modules/normalize-package-data": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-8.0.0.tgz", + "integrity": "sha512-RWk+PI433eESQ7ounYxIp67CYuVsS1uYSonX3kA6ps/3LWfjVQa/ptEg6Y3T6uAMq1mWpX9PQ+qx+QaHpsc7gQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "hosted-git-info": "^9.0.0", + "semver": "^7.3.5", + "validate-npm-package-license": "^3.0.4" + }, + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/semantic-release/node_modules/read-package-up": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/read-package-up/-/read-package-up-12.0.0.tgz", + "integrity": "sha512-Q5hMVBYur/eQNWDdbF4/Wqqr9Bjvtrw2kjGxxBbKLbx8bVCL8gcArjTy8zDUuLGQicftpMuU0riQNcAsbtOVsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "find-up-simple": "^1.0.1", + "read-pkg": "^10.0.0", + "type-fest": "^5.2.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/semantic-release/node_modules/read-pkg": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-10.1.0.tgz", + "integrity": "sha512-I8g2lArQiP78ll51UeMZojewtYgIRCKCWqZEgOO8c/uefTI+XDXvCSXu3+YNUaTNvZzobrL5+SqHjBrByRRTdg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/normalize-package-data": "^2.4.4", + "normalize-package-data": "^8.0.0", + "parse-json": "^8.3.0", + "type-fest": "^5.4.4", + "unicorn-magic": "^0.4.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/semantic-release/node_modules/type-fest": { + "version": "5.10.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.10.0.tgz", + "integrity": "sha512-NoSdpq/WEiAg5sjmBkmV/hfxv6HJH4NqPNrqjtSO5CwRmpsDfaf4begxW34KdJykH/l1yHtwBWQkCRdoXO8mPA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "dependencies": { + "tagged-tag": "^1.0.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/semantic-release/node_modules/unicorn-magic": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.1.tgz", + "integrity": "sha512-lzlXPoVB0Uy/FvTaUgX39RbixYiSKoc3JSoSf01+0c2B6FR3qdYIPN7Qjo/AV7n6sqLCk0509cT3LRj1oSZ1+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/semver": { + "version": "7.8.6", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.6.tgz", + "integrity": "sha512-9lpSSU4Mly3mrtruwLs1eLK6+gzbzqeBFwRNjIjE+9LuDpWdYctrQlQ3ej1Ilgi7gknpsTRnPoLP8DpCHqHIJw==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/semver-regex": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/semver-regex/-/semver-regex-4.0.5.tgz", + "integrity": "sha512-hunMQrEy1T6Jr2uEVjrAIqjwWcQTgOAcIM52C8MY1EZSD3DDNft04XzvYKPqjED65bNVVko0YI38nYeEHCX3yw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/signale": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/signale/-/signale-1.4.0.tgz", + "integrity": "sha512-iuh+gPf28RkltuJC7W5MRi6XAjTDCAPC/prJUpQoG4vIP3MJZ+GTydVnodXA7pwvTKb2cA0m9OFZW/cdWy/I/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^2.3.2", + "figures": "^2.0.0", + "pkg-conf": "^2.1.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/signale/node_modules/ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^1.9.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/signale/node_modules/chalk": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", + "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/signale/node_modules/color-convert": { + "version": "1.9.3", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", + "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "1.1.3" + } + }, + "node_modules/signale/node_modules/color-name": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", + "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", + "dev": true, + "license": "MIT" + }, + "node_modules/signale/node_modules/escape-string-regexp": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", + "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/signale/node_modules/figures": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/figures/-/figures-2.0.0.tgz", + "integrity": "sha512-Oa2M9atig69ZkfwiApY8F2Yy+tzMbazyvqv21R0NsSC8floSOC09BbT1ITWAdoMGQvJ/aZnR1KMwdx9tvHnTNA==", + "dev": true, + "license": "MIT", + "dependencies": { + "escape-string-regexp": "^1.0.5" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/signale/node_modules/has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/signale/node_modules/supports-color": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", + "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/skin-tone": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/skin-tone/-/skin-tone-2.0.0.tgz", + "integrity": "sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "unicode-emoji-modifier-base": "^1.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/spawn-error-forwarder": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/spawn-error-forwarder/-/spawn-error-forwarder-1.0.0.tgz", + "integrity": "sha512-gRjMgK5uFjbCvdibeGJuy3I5OYz6VLoVdsOJdA6wV0WlfQVLFueoqMxwwYD9RODdgb6oUIvlRlsyFSiQkMKu0g==", + "dev": true, + "license": "MIT" + }, + "node_modules/spdx-correct": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.2.0.tgz", + "integrity": "sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "spdx-expression-parse": "^3.0.0", + "spdx-license-ids": "^3.0.0" + } + }, + "node_modules/spdx-exceptions": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.5.0.tgz", + "integrity": "sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==", + "dev": true, + "license": "CC-BY-3.0" + }, + "node_modules/spdx-expression-parse": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.1.tgz", + "integrity": "sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "spdx-exceptions": "^2.1.0", + "spdx-license-ids": "^3.0.0" + } + }, + "node_modules/spdx-license-ids": { + "version": "3.0.24", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.24.tgz", + "integrity": "sha512-cLS9TtWkIQFyLkJ3/5aFQAOHOSKTlOs/7WDut/XPSdjom1fJhUdkepeJAKXa9Y05+FabHd0sti+Et559vDtkpQ==", + "dev": true, + "license": "CC0-1.0" + }, + "node_modules/split2": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/split2/-/split2-1.0.0.tgz", + "integrity": "sha512-NKywug4u4pX/AZBB1FCPzZ6/7O+Xhz1qMVbzTvvKvikjO99oPN87SkK08mEY9P63/5lWjK+wgOOgApnTg5r6qg==", + "dev": true, + "license": "ISC", + "dependencies": { + "through2": "~2.0.0" + } + }, + "node_modules/stream-combiner2": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/stream-combiner2/-/stream-combiner2-1.1.1.tgz", + "integrity": "sha512-3PnJbYgS56AeWgtKF5jtJRT6uFJe56Z0Hc5Ngg/6sI6rIt8iiMBTa9cvdyFfpMQjaVHr8dusbNeFGIIonxOvKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "duplexer2": "~0.1.0", + "readable-stream": "^2.0.2" + } + }, + "node_modules/string_decoder": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", + "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.1.0" + } + }, + "node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/strip-final-newline": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-4.0.0.tgz", + "integrity": "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strip-json-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", + "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/super-regex": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/super-regex/-/super-regex-1.1.0.tgz", + "integrity": "sha512-WHkws2ZflZe41zj6AolvvmaTrWds/VuyeYr9iPVv/oQeaIoVxMKaushfFWpOGDT+GuBrM/sVqF8KUCYQlSSTdQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "function-timeout": "^1.0.1", + "make-asynchronous": "^1.0.1", + "time-span": "^5.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-hyperlinks": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/supports-hyperlinks/-/supports-hyperlinks-3.2.0.tgz", + "integrity": "sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0", + "supports-color": "^7.0.0" + }, + "engines": { + "node": ">=14.18" + }, + "funding": { + "url": "https://github.com/chalk/supports-hyperlinks?sponsor=1" + } + }, + "node_modules/tagged-tag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz", + "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/temp-dir": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-3.0.0.tgz", + "integrity": "sha512-nHc6S/bwIilKHNRgK/3jlhDoIHcp45YgyiwcAk46Tr0LfEqGBVpmiAyuiuxeVE44m3mXnEeVhaipLOEWmH+Njw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.16" + } + }, + "node_modules/tempy": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/tempy/-/tempy-3.2.0.tgz", + "integrity": "sha512-d79HhZya5Djd7am0q+W4RTsSU+D/aJzM+4Y4AGJGuGlgM2L6sx5ZvOYTmZjqPhrDrV6xJTtRSm1JCLj6V6LHLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-stream": "^3.0.0", + "temp-dir": "^3.0.0", + "type-fest": "^2.12.2", + "unique-string": "^3.0.0" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tempy/node_modules/is-stream": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz", + "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tempy/node_modules/type-fest": { + "version": "2.19.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-2.19.0.tgz", + "integrity": "sha512-RAH822pAdBgcNMAfWnCBU3CFZcfZ/i1eZjwFU/dsLKumyuuP3niueg2UAukXYF0E2AAoc82ZSSf9J0WQBinzHA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=12.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/thenify": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz", + "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==", + "dev": true, + "license": "MIT", + "dependencies": { + "any-promise": "^1.0.0" + } + }, + "node_modules/thenify-all": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz", + "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "thenify": ">= 3.1.0 < 4" + }, + "engines": { + "node": ">=0.8" + } + }, + "node_modules/through2": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.5.tgz", + "integrity": "sha512-/mrRod8xqpA+IHSLyGCQ2s8SPHiCDEeQJSep1jqLYeEUClOFG2Qsh+4FU6G9VeqpZnGW/Su8LQGc4YKni5rYSQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "readable-stream": "~2.3.6", + "xtend": "~4.0.1" + } + }, + "node_modules/time-span": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/time-span/-/time-span-5.1.0.tgz", + "integrity": "sha512-75voc/9G4rDIJleOo4jPvN4/YC4GRZrY8yy1uU4lwrB3XEQbWve8zXoO5No4eFrGcTAMYyoY67p8jRQdtA1HbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "convert-hrtime": "^5.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/traverse": { + "version": "0.6.8", + "resolved": "https://registry.npmjs.org/traverse/-/traverse-0.6.8.tgz", + "integrity": "sha512-aXJDbk6SnumuaZSANd21XAo15ucCDE38H4fkqiGsc3MhCK+wOlZvLP9cB/TvpHT0mOyWgC4Z8EwRlzqYSUzdsA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/tunnel": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/tunnel/-/tunnel-0.0.6.tgz", + "integrity": "sha512-1h/Lnq9yajKY2PEbBadPXj3VxsDDu844OnaAo52UVmIzIvwwtBPIuNvkjuzBlTWpfJyUbG3ez0KSBibQkj4ojg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.6.11 <=0.7.0 || >=0.7.3" + } + }, + "node_modules/type-fest": { + "version": "4.41.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz", + "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/uglify-js": { + "version": "3.19.3", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", + "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", + "dev": true, + "license": "BSD-2-Clause", + "optional": true, + "bin": { + "uglifyjs": "bin/uglifyjs" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/undici": { + "version": "7.30.2", + "resolved": "https://registry.npmjs.org/undici/-/undici-7.30.2.tgz", + "integrity": "sha512-mLyPQnHwUxaM/rideoK/+KL8DaAJLRl4aBCfmX444aCSLnIaomqPLtNRe2jdCYcsk5wZzXrDIQC8ZeYNRAYyIA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.18.1" + } + }, + "node_modules/unicode-emoji-modifier-base": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unicode-emoji-modifier-base/-/unicode-emoji-modifier-base-1.0.0.tgz", + "integrity": "sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unicorn-magic": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.3.0.tgz", + "integrity": "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/unique-string": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-3.0.0.tgz", + "integrity": "sha512-VGXBUVwxKMBUznyffQweQABPRRW1vHZAbadFZud4pLFAqRGvv/96vafgjWFqzourzr8YonlQiPgH0YCJfawoGQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "crypto-random-string": "^4.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/universal-user-agent": { + "version": "7.0.3", + "resolved": "https://registry.npmjs.org/universal-user-agent/-/universal-user-agent-7.0.3.tgz", + "integrity": "sha512-TmnEAEAsBJVZM/AADELsK76llnwcf9vMKuPz8JflO1frO8Lchitr0fNaN9d+Ap0BjKtqWqd/J17qeDnXh8CL2A==", + "dev": true, + "license": "ISC" + }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/url-join": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-5.2.0.tgz", + "integrity": "sha512-/tMVQdp/2eE90fGb6npbd2nLHH8jamzLLeZhLEKTz4Rc38wO5AeEuIhoWroWWfQJS50ZzL4Xod9JER/pJWTTEQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "dev": true, + "license": "MIT" + }, + "node_modules/validate-npm-package-license": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz", + "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "spdx-correct": "^3.0.0", + "spdx-expression-parse": "^3.0.0" + } + }, + "node_modules/web-worker": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/web-worker/-/web-worker-1.5.0.tgz", + "integrity": "sha512-RiMReJrTAiA+mBjGONMnjVDP2u3p9R1vkcGz6gDIrOMT3oGuYwX2WRMYI9ipkphSuE5XKEhydbhNEJh4NY9mlw==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/which-command": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/which-command/-/which-command-0.1.0.tgz", + "integrity": "sha512-XZyoF5/5hZtXitIwzrU4NKK+Wtbb9aB9CezUEw2Q0wlYK8NUYQxC1rRXgNueYLtBAJwXIb+/tFVk4dozciNJMA==", + "dev": true, + "license": "MIT", + "bin": { + "which-command": "cli.js" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sindresorhus/which-command?sponsor=1" + } + }, + "node_modules/wordwrap": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", + "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "dev": true, + "license": "MIT" + }, + "node_modules/wrap-ansi/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/wrap-ansi/node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/xtend": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", + "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.4" + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs": { + "version": "18.2.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.2.0.tgz", + "integrity": "sha512-9OpKOLeaoNFecEp7P6iYbzze/5CqWoH7N3SMs/6y1XF4nMvFMspEGZzJ6uFi9MmQwXhyzqYoSEKO3tvA3Z/o2w==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^9.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "string-width": "^8.2.1", + "y18n": "^5.0.5", + "yargs-parser": "^22.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs-parser": { + "version": "22.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz", + "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs/node_modules/string-width": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.3.0.tgz", + "integrity": "sha512-ZbmZM0JCihQN91dWnxoipT2KOEyHqEyfRXUyjuRhW8b/xnqPDoq4gWEVApTVa9db2wN8mmoikgFBbjh71+cGeQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yargs/node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/yoctocolors": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.2.0.tgz", + "integrity": "sha512-xYqdZFUK/VYazNl/oCDYN+3WloWQwMfZxBoiNt6qNyk+xfOdi598muWE42rNZFp1kNOiqW936q5RhUdnpqElSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..40721c8 --- /dev/null +++ b/package.json @@ -0,0 +1,20 @@ +{ + "name": "motorino", + "version": "0.0.0", + "private": true, + "description": "Release tooling of motorino. The generator itself is Go: see the Makefile.", + "license": "GPL-3.0-or-later", + "scripts": { + "release": "semantic-release --no-ci", + "release:dry": "semantic-release --no-ci --dry-run" + }, + "devDependencies": { + "@semantic-release/changelog": "7.0.0", + "@semantic-release/commit-analyzer": "13.0.1", + "@semantic-release/exec": "7.1.0", + "@semantic-release/git": "11.0.1", + "@semantic-release/release-notes-generator": "14.1.1", + "conventional-changelog-conventionalcommits": "9.3.1", + "semantic-release": "25.0.9" + } +} diff --git a/release.config.mjs b/release.config.mjs new file mode 100644 index 0000000..51ccfd7 --- /dev/null +++ b/release.config.mjs @@ -0,0 +1,43 @@ +/** + * semantic-release: the version comes from the conventional commits on main. + * feat is a minor release, fix and perf are patches, a breaking change is a major one. + * The result is the tag vX.Y.Z, CHANGELOG.md, and a Forgejo release with the linux/amd64 binary + * and its SHA-256 (built by `make dist`, uploaded by scripts/publish-release.sh). + * Run it by hand from a clean main with `npm run release` (`npm run release:dry` first shows what it would do). + */ +export default { + branches: ['main'], + tagFormat: 'v${version}', + plugins: [ + [ + '@semantic-release/commit-analyzer', + { + preset: 'conventionalcommits', + // The breaking rule comes first: a custom rule list replaces the defaults, and `feat!:` would otherwise match `feat`. + releaseRules: [ + { breaking: true, release: 'major' }, + { type: 'feat', release: 'minor' }, + { type: 'fix', release: 'patch' }, + { type: 'perf', release: 'patch' }, + { type: 'revert', release: 'patch' }, + ], + }, + ], + ['@semantic-release/release-notes-generator', { preset: 'conventionalcommits' }], + ['@semantic-release/changelog', { changelogFile: 'CHANGELOG.md' }], + [ + '@semantic-release/git', + { + assets: ['CHANGELOG.md'], + message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}', + }, + ], + [ + '@semantic-release/exec', + { + prepareCmd: 'make dist VERSION=${nextRelease.version}', + publishCmd: 'scripts/publish-release.sh ${nextRelease.version}', + }, + ], + ], +}; From a3b0a8028e401cb8639a3bb69596bbfaf41e74d6 Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:41:54 +0100 Subject: [PATCH 02/13] feat: parse the Key: value header with a "-" terminator --- internal/header/header.go | 103 ++++++++++++++++++++++++ internal/header/header_test.go | 140 +++++++++++++++++++++++++++++++++ 2 files changed, 243 insertions(+) create mode 100644 internal/header/header.go create mode 100644 internal/header/header_test.go diff --git a/internal/header/header.go b/internal/header/header.go new file mode 100644 index 0000000..9b8d6aa --- /dev/null +++ b/internal/header/header.go @@ -0,0 +1,103 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package header reads the header of a page or a news file: lines of +// "Key: value" ended by a line that holds a single "-", then the body. +package header + +import ( + "fmt" + "strings" +) + +// terminator is the line that ends a header. +const terminator = "-" + +// Header is the ordered set of keys and values of one file. +type Header struct { + keys []string + values map[string]string +} + +// Parse splits src into its header and its body. The name is used in error +// messages, which also carry the line number. A leading byte order mark and +// CRLF line endings are accepted; the body is returned with LF endings and +// without the blank lines that follow the terminator. +func Parse(name string, src []byte) (Header, string, error) { + text := strings.TrimPrefix(string(src), "\xef\xbb\xbf") + text = strings.ReplaceAll(text, "\r\n", "\n") + lines := strings.Split(text, "\n") + + h := Header{values: make(map[string]string)} + for i, line := range lines { + number := i + 1 + if strings.TrimRight(line, " \t") == terminator { + body := strings.TrimLeft(strings.Join(lines[i+1:], "\n"), "\n") + return h, body, nil + } + if strings.TrimSpace(line) == "" { + continue + } + key, value, err := splitLine(line) + if err != nil { + return Header{}, "", fmt.Errorf("%s:%d: %w", name, number, err) + } + if _, dup := h.values[key]; dup { + return Header{}, "", fmt.Errorf("%s:%d: duplicate key %q", name, number, key) + } + h.keys = append(h.keys, key) + h.values[key] = value + } + return Header{}, "", fmt.Errorf("%s:%d: the header is not ended by a line with a single %q", name, len(lines), terminator) +} + +// splitLine splits "Key: value" at the first colon followed by a space, or at +// a colon that ends the line (an empty value). +func splitLine(line string) (key, value string, err error) { + if i := strings.Index(line, ": "); i >= 0 { + key, value = line[:i], line[i+2:] + } else if strings.HasSuffix(line, ":") { + key = strings.TrimSuffix(line, ":") + } else { + return "", "", fmt.Errorf("line %q is not of the form \"Key: value\"", line) + } + key = strings.TrimSpace(key) + if key == "" { + return "", "", fmt.Errorf("empty key in line %q", line) + } + return key, strings.TrimSpace(value), nil +} + +// Get returns the value of key, or an empty string when the key is absent. +func (h Header) Get(key string) string { + return h.values[key] +} + +// Has reports whether key is present, even with an empty value. +func (h Header) Has(key string) bool { + _, ok := h.values[key] + return ok +} + +// Require returns an error naming name and the first missing key of keys. +func (h Header) Require(name string, keys ...string) error { + for _, k := range keys { + if !h.Has(k) { + return fmt.Errorf("%s: missing key %q", name, k) + } + } + return nil +} + +// Only returns an error naming name and the first key that is not in allowed. +func (h Header) Only(name string, allowed ...string) error { + ok := make(map[string]bool, len(allowed)) + for _, k := range allowed { + ok[k] = true + } + for _, k := range h.keys { + if !ok[k] { + return fmt.Errorf("%s: unknown key %q (allowed: %s)", name, k, strings.Join(allowed, ", ")) + } + } + return nil +} diff --git a/internal/header/header_test.go b/internal/header/header_test.go new file mode 100644 index 0000000..30758f6 --- /dev/null +++ b/internal/header/header_test.go @@ -0,0 +1,140 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package header + +import ( + "strings" + "testing" +) + +// TestParse checks the accepted shapes of a header and the body that follows it. +func TestParse(t *testing.T) { + tests := []struct { + name string + src string + wantKeys map[string]string + wantBody string + }{ + { + name: "owner sample", + src: "Title: GNU/Linux Day 2026\nAuthor: Matteo Bini\nDate: 2026-09-18T17:00:45+0200\n" + + "Categories: Linux Day, FLUG\n-\nThe text.\n", + wantKeys: map[string]string{ + "Title": "GNU/Linux Day 2026", "Author": "Matteo Bini", + "Date": "2026-09-18T17:00:45+0200", "Categories": "Linux Day, FLUG", + }, + wantBody: "The text.\n", + }, + { + name: "value with a colon and a space", + src: "Title: GNU/Linux Day 2026: programme\n-\nBody\n", + wantKeys: map[string]string{"Title": "GNU/Linux Day 2026: programme"}, + wantBody: "Body\n", + }, + { + name: "byte order mark", + src: "\ufeffTitle: With BOM\n-\nBody\n", + wantKeys: map[string]string{"Title": "With BOM"}, + wantBody: "Body\n", + }, + { + name: "CRLF line endings", + src: "Title: Windows\r\nAuthor: Someone\r\n-\r\nLine one\r\nLine two\r\n", + wantKeys: map[string]string{"Title": "Windows", "Author": "Someone"}, + wantBody: "Line one\nLine two\n", + }, + { + name: "blank lines after the terminator are dropped", + src: "Title: Gap\n-\n\n\nBody\n", + wantKeys: map[string]string{"Title": "Gap"}, + wantBody: "Body\n", + }, + { + name: "only the first dash line ends the header", + src: "Title: Dashes\n-\nBefore\n-\nAfter\n", + wantKeys: map[string]string{"Title": "Dashes"}, + wantBody: "Before\n-\nAfter\n", + }, + { + name: "empty value", + src: "Title: Empty\nCategories:\n-\nBody\n", + wantKeys: map[string]string{"Title": "Empty", "Categories": ""}, + wantBody: "Body\n", + }, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + h, body, err := Parse("file.md", []byte(tt.src)) + if err != nil { + t.Fatalf("Parse() error = %v", err) + } + for k, want := range tt.wantKeys { + if !h.Has(k) { + t.Errorf("Has(%q) = false", k) + } + if got := h.Get(k); got != want { + t.Errorf("Get(%q) = %q, want %q", k, got, want) + } + } + if body != tt.wantBody { + t.Errorf("body = %q, want %q", body, tt.wantBody) + } + }) + } +} + +// TestParseErrors checks that every malformed header names the file and the line. +func TestParseErrors(t *testing.T) { + tests := []struct { + name string + src string + want string + }{ + {"missing terminator", "Title: No end\nAuthor: x\n", "file.md:3"}, + {"line without colon", "Title: Ok\nnonsense\n-\nBody\n", "file.md:2"}, + {"empty key", "Title: Ok\n: value\n-\nBody\n", "file.md:2"}, + {"duplicate key", "Title: One\nTitle: Two\n-\nBody\n", "file.md:2"}, + {"empty file", "", "file.md"}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + _, _, err := Parse("file.md", []byte(tt.src)) + if err == nil { + t.Fatal("Parse() error = nil") + } + if !strings.Contains(err.Error(), tt.want) { + t.Errorf("error %q does not contain %q", err, tt.want) + } + }) + } +} + +// TestRequire checks that a missing required key is reported by name. +func TestRequire(t *testing.T) { + h, _, err := Parse("file.md", []byte("Title: T\n-\n")) + if err != nil { + t.Fatal(err) + } + if err := h.Require("file.md", "Title"); err != nil { + t.Errorf("Require(Title) = %v", err) + } + err = h.Require("file.md", "Title", "Date") + if err == nil || !strings.Contains(err.Error(), "Date") || !strings.Contains(err.Error(), "file.md") { + t.Errorf("Require(Title, Date) = %v, want an error naming file.md and Date", err) + } +} + +// TestOnly checks that a key outside the allowed list is rejected. +func TestOnly(t *testing.T) { + h, _, err := Parse("file.md", []byte("Title: T\nTitolo: T\n-\n")) + if err != nil { + t.Fatal(err) + } + err = h.Only("file.md", "Title", "Date") + if err == nil || !strings.Contains(err.Error(), "Titolo") { + t.Errorf("Only() = %v, want an error naming Titolo", err) + } + if err := h.Only("file.md", "Title", "Titolo"); err != nil { + t.Errorf("Only(all allowed) = %v", err) + } +} From 27dac18c8f64bb703b7fabbd1fdfa10a5faac95b Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:42:13 +0100 Subject: [PATCH 03/13] feat: substitute placeholders and escape text --- internal/render/render.go | 50 +++++++++++++++++++++++ internal/render/render_test.go | 74 ++++++++++++++++++++++++++++++++++ 2 files changed, 124 insertions(+) create mode 100644 internal/render/render.go create mode 100644 internal/render/render_test.go diff --git a/internal/render/render.go b/internal/render/render.go new file mode 100644 index 0000000..4a4d8ff --- /dev/null +++ b/internal/render/render.go @@ -0,0 +1,50 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package render replaces the {{name}} placeholders of templates and page +// sources and escapes text for HTML. +package render + +import ( + "fmt" + "regexp" + "strings" +) + +// placeholder matches {{name}} where name is lowercase letters, digits and +// underscores. Braces that do not match, such as {{.Name}}, are plain text. +var placeholder = regexp.MustCompile(`\{\{([a-z0-9_]+)\}\}`) + +// Substitute replaces every {{name}} in tmpl with ctx[name]. An unknown name +// is an error that names the file and the placeholder. Values are inserted as +// they are and are not scanned again. +func Substitute(name, tmpl string, ctx map[string]string) (string, error) { + var missing string + out := placeholder.ReplaceAllStringFunc(tmpl, func(match string) string { + key := match[2 : len(match)-2] + value, ok := ctx[key] + if !ok && missing == "" { + missing = key + } + return value + }) + if missing != "" { + return "", fmt.Errorf("%s: unknown placeholder {{%s}}", name, missing) + } + return out, nil +} + +// textEscaper escapes the characters that matter in HTML text. +var textEscaper = strings.NewReplacer("&", "&", "<", "<", ">", ">") + +// attrEscaper also escapes both kinds of quote, for attribute values. +var attrEscaper = strings.NewReplacer("&", "&", "<", "<", ">", ">", `"`, """, "'", "'") + +// Escape escapes &, < and > for use in HTML text. Quotes are left alone. +func Escape(s string) string { + return textEscaper.Replace(s) +} + +// EscapeAttr escapes &, <, > and both quotes for use in an HTML attribute. +func EscapeAttr(s string) string { + return attrEscaper.Replace(s) +} diff --git a/internal/render/render_test.go b/internal/render/render_test.go new file mode 100644 index 0000000..5d2100a --- /dev/null +++ b/internal/render/render_test.go @@ -0,0 +1,74 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package render + +import ( + "strings" + "testing" +) + +// TestSubstituteKnown checks that known placeholders are replaced everywhere. +func TestSubstituteKnown(t *testing.T) { + ctx := map[string]string{"name": "kmalloc", "tld_1": "org"} + got, err := Substitute("page.html", "

{{name}}.{{tld_1}} and {{name}}

", ctx) + if err != nil { + t.Fatalf("Substitute() error = %v", err) + } + if want := "

kmalloc.org and kmalloc

"; got != want { + t.Errorf("Substitute() = %q, want %q", got, want) + } +} + +// TestSubstituteUnknownNamesFile checks that an unknown placeholder stops the +// build and names both the file and the placeholder. +func TestSubstituteUnknownNamesFile(t *testing.T) { + _, err := Substitute("news/post.md", "Hello {{nope}}", map[string]string{}) + if err == nil { + t.Fatal("Substitute() error = nil") + } + for _, want := range []string{"news/post.md", "nope"} { + if !strings.Contains(err.Error(), want) { + t.Errorf("error %q does not contain %q", err, want) + } + } +} + +// TestSubstituteLeavesNonPlaceholders checks that braces that do not form a +// placeholder are left as written, so articles can show template code. +func TestSubstituteLeavesNonPlaceholders(t *testing.T) { + for _, in := range []string{"{{.Name}}", "{{ spaced }}", "{{UPPER}}", "{{a-b}}", "{single}", "{{}}"} { + got, err := Substitute("f", in, map[string]string{}) + if err != nil { + t.Errorf("Substitute(%q) error = %v", in, err) + } + if got != in { + t.Errorf("Substitute(%q) = %q, want it unchanged", in, got) + } + } +} + +// TestSubstituteValueIsNotRescanned checks that a replaced value is inserted +// as is and its own braces are not substituted again. +func TestSubstituteValueIsNotRescanned(t *testing.T) { + got, err := Substitute("f", "{{a}}", map[string]string{"a": "{{b}}", "b": "x"}) + if err != nil { + t.Fatal(err) + } + if got != "{{b}}" { + t.Errorf("Substitute() = %q, want %q", got, "{{b}}") + } +} + +// TestEscape checks that text escaping leaves quotes alone. +func TestEscape(t *testing.T) { + if got, want := Escape(`a & b < c > "d" 'e'`), `a & b < c > "d" 'e'`; got != want { + t.Errorf("Escape() = %q, want %q", got, want) + } +} + +// TestEscapeAttr checks that attribute escaping also covers both quotes. +func TestEscapeAttr(t *testing.T) { + if got, want := EscapeAttr(`a & "b" 'c' `), `a & "b" 'c' <d>`; got != want { + t.Errorf("EscapeAttr() = %q, want %q", got, want) + } +} From 2c7bca35be5843d2e3ef86cd44bd4452de6e5cae Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:43:26 +0100 Subject: [PATCH 04/13] feat: render Markdown with stable heading ids and the em dash rule --- go.mod | 2 + go.sum | 2 + internal/mdx/emdash.go | 56 ++++++++++++++++++++++++ internal/mdx/emdash_test.go | 57 +++++++++++++++++++++++++ internal/mdx/mdx.go | 85 +++++++++++++++++++++++++++++++++++++ internal/mdx/mdx_test.go | 76 +++++++++++++++++++++++++++++++++ internal/mdx/slug.go | 45 ++++++++++++++++++++ internal/mdx/slug_test.go | 43 +++++++++++++++++++ 8 files changed, 366 insertions(+) create mode 100644 go.sum create mode 100644 internal/mdx/emdash.go create mode 100644 internal/mdx/emdash_test.go create mode 100644 internal/mdx/mdx.go create mode 100644 internal/mdx/mdx_test.go create mode 100644 internal/mdx/slug.go create mode 100644 internal/mdx/slug_test.go diff --git a/go.mod b/go.mod index 58439fe..0509b92 100644 --- a/go.mod +++ b/go.mod @@ -1,3 +1,5 @@ module git.kmalloc.org/squid/motorino go 1.27 + +require github.com/yuin/goldmark v1.8.7 diff --git a/go.sum b/go.sum new file mode 100644 index 0000000..323ce3d --- /dev/null +++ b/go.sum @@ -0,0 +1,2 @@ +github.com/yuin/goldmark v1.8.7 h1:XT/tNqCIbabh0ln675w4x3dv04kQBKi8NwYqi9IJaxI= +github.com/yuin/goldmark v1.8.7/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg= diff --git a/internal/mdx/emdash.go b/internal/mdx/emdash.go new file mode 100644 index 0000000..e6e74fa --- /dev/null +++ b/internal/mdx/emdash.go @@ -0,0 +1,56 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package mdx + +import ( + "fmt" + "regexp" + "strings" +) + +// emDash is the character the published site never shows. +const emDash = "—" + +// Rewrites of the manifesto headings, compiled once. The manifesto sources use +// em dashes: "NN — Title" becomes "NN. Title", "Word — Title" becomes +// "Word: Title" and an attribution line loses its dash. +var ( + numberedHeading = regexp.MustCompile(`(?m)^(#+ )(\d\d) ` + emDash + ` `) + wordHeading = regexp.MustCompile(`(?m)^(#+ [^\d\n][^` + emDash + `\n]*?) ` + emDash + ` `) + attribution = regexp.MustCompile(`(?m)^> ` + emDash + ` `) +) + +// parentheticals are the sentences in which a pair of dashes becomes commas. +var parentheticals = []struct{ from, to string }{ + {" " + emDash + " where technically feasible " + emDash + " ", ", where technically feasible, "}, + {" " + emDash + " dove tecnicamente possibile " + emDash + " ", ", dove tecnicamente possibile, "}, + {" " + emDash + " and continues", ", and continues"}, + {" " + emDash + " e continua", ", e continua"}, + {"kmalloc.org " + emDash + " ", "kmalloc.org: "}, +} + +// NoEmDash rewrites the em dashes of a manifesto source with the rules above +// and returns an error if any em dash is left, so a new one is noticed. +func NoEmDash(md string) (string, error) { + md = numberedHeading.ReplaceAllString(md, "${1}${2}. ") + md = wordHeading.ReplaceAllString(md, "${1}: ") + md = attribution.ReplaceAllString(md, "> ") + for _, p := range parentheticals { + md = strings.ReplaceAll(md, p.from, p.to) + } + if err := RejectEmDash("manifesto source", md); err != nil { + return "", err + } + return md, nil +} + +// RejectEmDash returns an error naming the file and the line of the first em +// dash in text, or nil when there is none. +func RejectEmDash(name, text string) error { + for i, line := range strings.Split(text, "\n") { + if strings.Contains(line, emDash) { + return fmt.Errorf("%s:%d: no em dashes, please", name, i+1) + } + } + return nil +} diff --git a/internal/mdx/emdash_test.go b/internal/mdx/emdash_test.go new file mode 100644 index 0000000..0682d9f --- /dev/null +++ b/internal/mdx/emdash_test.go @@ -0,0 +1,57 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package mdx + +import ( + "strings" + "testing" +) + +// TestNoEmDash checks every rewrite of the manifesto sources. +func TestNoEmDash(t *testing.T) { + tests := []struct { + name string + in string + want string + }{ + {"numbered heading", "## 01 — Antifascist. No ambiguity.", "## 01. Antifascist. No ambiguity."}, + {"word heading", "## Preamble — We don't ask permission to think", "## Preamble: We don't ask permission to think"}, + {"title heading", "# kmalloc.org — Manifesto", "# kmalloc.org: Manifesto"}, + {"attribution", "> — Funkadelic, Free Your Mind", "> Funkadelic, Free Your Mind"}, + {"parenthetical en", "modify, and — where technically feasible — install", "modify, and, where technically feasible, install"}, + {"parenthetical it", "e — dove tecnicamente possibile — installare", "e, dove tecnicamente possibile, installare"}, + {"and continues", "it — and continues", "it, and continues"}, + {"e continua", "esso — e continua", "esso, e continua"}, + {"no dash", "plain text", "plain text"}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got, err := NoEmDash(tt.in) + if err != nil { + t.Fatalf("NoEmDash() error = %v", err) + } + if got != tt.want { + t.Errorf("NoEmDash() = %q, want %q", got, tt.want) + } + }) + } +} + +// TestNoEmDashLeftover checks that a dash with no rewrite rule is an error. +func TestNoEmDashLeftover(t *testing.T) { + _, err := NoEmDash("some words — and then more") + if err == nil { + t.Fatal("NoEmDash() error = nil, want an error for a leftover em dash") + } +} + +// TestRejectEmDash checks that the error names the file and the line. +func TestRejectEmDash(t *testing.T) { + if err := RejectEmDash("content/en/x.md", "clean\ntext\n"); err != nil { + t.Errorf("RejectEmDash(clean) = %v", err) + } + err := RejectEmDash("content/en/x.md", "clean\nbad — line\n") + if err == nil || !strings.Contains(err.Error(), "content/en/x.md") || !strings.Contains(err.Error(), "2") { + t.Errorf("RejectEmDash() = %v, want an error naming the file and line 2", err) + } +} diff --git a/internal/mdx/mdx.go b/internal/mdx/mdx.go new file mode 100644 index 0000000..41ea41b --- /dev/null +++ b/internal/mdx/mdx.go @@ -0,0 +1,85 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package mdx renders the Markdown of pages and news with goldmark. +package mdx + +import ( + "bytes" + "fmt" + "strconv" + "strings" + + "github.com/yuin/goldmark" + "github.com/yuin/goldmark/ast" + "github.com/yuin/goldmark/renderer/html" + "github.com/yuin/goldmark/text" +) + +// Heading is a heading of a rendered document. +type Heading struct { + // Level is 1 for "#", 2 for "##", and so on. + Level int + // ID is the anchor identifier given to the heading. + ID string + // Text is the heading without markup. + Text string +} + +// engine converts Markdown to HTML. Raw HTML is passed through because the +// pages use it for tables with data-label cells, hidden notes and the hero. +var engine = goldmark.New(goldmark.WithRendererOptions(html.WithUnsafe())) + +// Render converts md to HTML and returns the headings it found. Every heading +// gets an id attribute made by Slug, with -2, -3 and so on for duplicates. +func Render(md string) (string, []Heading, error) { + src := []byte(md) + doc := engine.Parser().Parse(text.NewReader(src)) + + var headings []Heading + used := make(map[string]int) + err := ast.Walk(doc, func(n ast.Node, entering bool) (ast.WalkStatus, error) { + h, ok := n.(*ast.Heading) + if !ok || !entering { + return ast.WalkContinue, nil + } + plain := plainText(h, src) + id := uniqueID(Slug(plain), used) + h.SetAttributeString("id", []byte(id)) + headings = append(headings, Heading{Level: h.Level, ID: id, Text: plain}) + return ast.WalkSkipChildren, nil + }) + if err != nil { + return "", nil, fmt.Errorf("walk markdown: %w", err) + } + + var out bytes.Buffer + if err := engine.Renderer().Render(&out, src, doc); err != nil { + return "", nil, fmt.Errorf("render markdown: %w", err) + } + return out.String(), headings, nil +} + +// uniqueID returns id, or id with a numeric suffix when it was already used. +func uniqueID(id string, used map[string]int) string { + used[id]++ + if used[id] == 1 { + return id + } + return id + "-" + strconv.Itoa(used[id]) +} + +// plainText returns the text of a node and its children without any markup. +func plainText(n ast.Node, src []byte) string { + var b strings.Builder + for c := n.FirstChild(); c != nil; c = c.NextSibling() { + switch t := c.(type) { + case *ast.Text: + b.Write(t.Segment.Value(src)) + case *ast.String: + b.Write(t.Value) + default: + b.WriteString(plainText(c, src)) + } + } + return b.String() +} diff --git a/internal/mdx/mdx_test.go b/internal/mdx/mdx_test.go new file mode 100644 index 0000000..a0a58a3 --- /dev/null +++ b/internal/mdx/mdx_test.go @@ -0,0 +1,76 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package mdx + +import ( + "strings" + "testing" +) + +// TestRenderParagraphAndList checks the basic blocks and inline markup. +func TestRenderParagraphAndList(t *testing.T) { + html, _, err := Render("Hello **world** and [a link](https://kmalloc.org/).\n\n- one\n- two\n") + if err != nil { + t.Fatal(err) + } + for _, want := range []string{ + "

Hello world and a link.

", + "
  • one
  • ", "
  • two
  • ", + } { + if !strings.Contains(html, want) { + t.Errorf("html %q does not contain %q", html, want) + } + } +} + +// TestRenderHeadingIDs checks that ids come from Slug and are unique. +func TestRenderHeadingIDs(t *testing.T) { + src := "## 01. First\n\n## Our commitments\n\n## Same\n\n## Same\n" + html, headings, err := Render(src) + if err != nil { + t.Fatal(err) + } + wantIDs := []string{"01", "commitments", "same", "same-2"} + if len(headings) != len(wantIDs) { + t.Fatalf("got %d headings, want %d: %+v", len(headings), len(wantIDs), headings) + } + for i, id := range wantIDs { + if headings[i].ID != id || headings[i].Level != 2 { + t.Errorf("heading %d = %+v, want level 2 and id %q", i, headings[i], id) + } + if !strings.Contains(html, `id="`+id+`"`) { + t.Errorf("html does not contain id=%q", id) + } + } + if headings[0].Text != "01. First" { + t.Errorf("heading text = %q, want %q", headings[0].Text, "01. First") + } +} + +// TestRenderRawHTMLPasses checks that raw HTML blocks and comments survive, +// because pages use them for tables with data-label cells and hidden notes. +func TestRenderRawHTMLPasses(t *testing.T) { + src := "Intro.\n\n\n\n
    14 days
    \n\n\n\nEnd.\n" + html, _, err := Render(src) + if err != nil { + t.Fatal(err) + } + for _, want := range []string{ + ``, ``, "", + } { + if !strings.Contains(html, want) { + t.Errorf("html %q does not contain %q", html, want) + } + } +} + +// TestRenderHeadingTextIsPlain checks that the heading text drops the markup. +func TestRenderHeadingTextIsPlain(t *testing.T) { + _, headings, err := Render("## Free *your* mind\n") + if err != nil { + t.Fatal(err) + } + if len(headings) != 1 || headings[0].Text != "Free your mind" { + t.Errorf("headings = %+v, want one with plain text %q", headings, "Free your mind") + } +} diff --git a/internal/mdx/slug.go b/internal/mdx/slug.go new file mode 100644 index 0000000..47359bf --- /dev/null +++ b/internal/mdx/slug.go @@ -0,0 +1,45 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package mdx + +import ( + "regexp" + "strings" +) + +// leadingNumber matches a heading that starts with a two digit number. +var leadingNumber = regexp.MustCompile(`^(\d\d)\b`) + +// nonSlug matches a run of characters that cannot be part of a slug. +var nonSlug = regexp.MustCompile(`[^a-z0-9]+`) + +// Slug turns a heading into the identifier used for its anchor. A heading that +// starts with a two digit number gets that number ("01. Title" becomes "01"), +// the preamble, commitments and epilogue headings of the manifesto get the same +// identifier in every language, and any other heading becomes lowercase words +// joined by hyphens. +func Slug(heading string) string { + if m := leadingNumber.FindStringSubmatch(heading); m != nil { + return m[1] + } + lower := strings.ToLower(strings.TrimSpace(heading)) + for _, group := range wellKnown { + for _, prefix := range group.prefixes { + if strings.HasPrefix(lower, prefix) { + return group.slug + } + } + } + return strings.Trim(nonSlug.ReplaceAllString(lower, "-"), "-") +} + +// wellKnown lists the heading prefixes of the manifesto, in all its languages, +// and the identifier each one gets. +var wellKnown = []struct { + slug string + prefixes []string +}{ + {"preamble", []string{"preamble", "preambolo", "preámbulo", "präambel", "préambule"}}, + {"commitments", []string{"our commitments", "i nostri impegni", "nuestros compromisos", "unsere verpflichtungen", "nos engagements"}}, + {"epilogue", []string{"epilogue", "epilogo", "epílogo", "epilog", "épilogue"}}, +} diff --git a/internal/mdx/slug_test.go b/internal/mdx/slug_test.go new file mode 100644 index 0000000..a6a0788 --- /dev/null +++ b/internal/mdx/slug_test.go @@ -0,0 +1,43 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package mdx + +import "testing" + +// TestSlug checks the heading identifiers against the real manifesto headings +// (after the em dash rewrite) and ordinary headings. +func TestSlug(t *testing.T) { + tests := []struct { + heading string + want string + }{ + {"01. Antifascist. No ambiguity.", "01"}, + {"14. Meaning doesn't need a god", "14"}, + {"01. Antifascisti. Senza ambiguità.", "01"}, + {"Preamble: We don't ask permission to think", "preamble"}, + {"Preambolo: Non chiediamo il permesso di pensare", "preamble"}, + {"Preámbulo: No pedimos permiso", "preamble"}, + {"Präambel", "preamble"}, + {"Préambule", "preamble"}, + {"Our commitments", "commitments"}, + {"I nostri impegni", "commitments"}, + {"Nuestros compromisos", "commitments"}, + {"Unsere Verpflichtungen", "commitments"}, + {"Nos engagements", "commitments"}, + {"Epilogue: Free your mind", "epilogue"}, + {"Epilogo: Libera la mente", "epilogue"}, + {"Epílogo: Libera tu mente", "epilogue"}, + {"Epilog", "epilogue"}, + {"Épilogue", "epilogue"}, + {"About this text", "about-this-text"}, + {"Request an account", "request-an-account"}, + {" Spaces & Symbols! ", "spaces-symbols"}, + } + for _, tt := range tests { + t.Run(tt.heading, func(t *testing.T) { + if got := Slug(tt.heading); got != tt.want { + t.Errorf("Slug(%q) = %q, want %q", tt.heading, got, tt.want) + } + }) + } +} From 97af0c422d20d0540457f78aac922543466481af Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:44:01 +0100 Subject: [PATCH 05/13] feat: load site.json and the language files --- internal/site/site.go | 131 +++++++++++++++++++++++++++++++++++ internal/site/site_test.go | 136 +++++++++++++++++++++++++++++++++++++ 2 files changed, 267 insertions(+) create mode 100644 internal/site/site.go create mode 100644 internal/site/site_test.go diff --git a/internal/site/site.go b/internal/site/site.go new file mode 100644 index 0000000..419d9e8 --- /dev/null +++ b/internal/site/site.go @@ -0,0 +1,131 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package site loads the configuration of a site: site.json and the language +// files in lang/. +package site + +import ( + "encoding/json" + "fmt" + "os" + "path/filepath" + "strings" +) + +// Config is the content of site.json. +type Config struct { + // Strings holds every string value of site.json, plus the derived + // contact_shown, security_shown and abuse_shown. + Strings map[string]string + // Languages lists the language codes; the first one is the default and + // lives at the root of the site. + Languages []string + // Assets maps the published name of a file to its source in the site + // directory; the files are copied as they are. + Assets map[string]string +} + +// Lang is the content of lang/.json: the strings of one language. +type Lang struct { + // Code is the language code, such as "en". + Code string + // Strings holds every string value of the file. + Strings map[string]string + // Nav maps a menu entry to its label in this language. + Nav map[string]string +} + +// shownKeys are the address keys that get a harvest-proof "_shown" twin. +var shownKeys = []string{"contact", "security", "abuse"} + +// Load reads site.json and the language file of every language it lists. All +// paths in error messages are relative to dir. +func Load(dir string) (Config, map[string]Lang, error) { + raw, err := readObject(dir, "site.json") + if err != nil { + return Config{}, nil, err + } + cfg := Config{Strings: stringValues(raw), Assets: map[string]string{}} + if err := decodeField(raw, "site.json", "languages", &cfg.Languages); err != nil { + return Config{}, nil, err + } + if len(cfg.Languages) == 0 { + return Config{}, nil, fmt.Errorf("site.json: languages is empty") + } + if err := decodeField(raw, "site.json", "assets", &cfg.Assets); err != nil { + return Config{}, nil, err + } + for _, key := range shownKeys { + if value, ok := cfg.Strings[key]; ok { + cfg.Strings[key+"_shown"] = strings.ReplaceAll(value, "@", " (at) ") + } + } + + langs := make(map[string]Lang, len(cfg.Languages)) + for _, code := range cfg.Languages { + lang, err := loadLang(dir, code) + if err != nil { + return Config{}, nil, err + } + langs[code] = lang + } + return cfg, langs, nil +} + +// loadLang reads lang/.json and checks the keys every language needs. +func loadLang(dir, code string) (Lang, error) { + name := filepath.ToSlash(filepath.Join("lang", code+".json")) + raw, err := readObject(dir, name) + if err != nil { + return Lang{}, err + } + lang := Lang{Code: code, Strings: stringValues(raw), Nav: map[string]string{}} + if lang.Strings["lang_name"] == "" { + return Lang{}, fmt.Errorf("%s: missing lang_name", name) + } + if _, ok := raw["nav"]; !ok { + return Lang{}, fmt.Errorf("%s: missing nav", name) + } + if err := decodeField(raw, name, "nav", &lang.Nav); err != nil { + return Lang{}, err + } + return lang, nil +} + +// readObject reads a JSON file that holds one object and returns its fields +// undecoded. Errors name the file. +func readObject(dir, name string) (map[string]json.RawMessage, error) { + data, err := os.ReadFile(filepath.Join(dir, filepath.FromSlash(name))) + if err != nil { + return nil, fmt.Errorf("read %s: %w", name, err) + } + var raw map[string]json.RawMessage + if err := json.Unmarshal(data, &raw); err != nil { + return nil, fmt.Errorf("%s: %w", name, err) + } + return raw, nil +} + +// stringValues returns the fields of raw whose value is a JSON string. +func stringValues(raw map[string]json.RawMessage) map[string]string { + out := make(map[string]string) + for key, value := range raw { + var s string + if json.Unmarshal(value, &s) == nil { + out[key] = s + } + } + return out +} + +// decodeField decodes raw[key] into target when the field exists. +func decodeField(raw map[string]json.RawMessage, name, key string, target any) error { + value, ok := raw[key] + if !ok { + return nil + } + if err := json.Unmarshal(value, target); err != nil { + return fmt.Errorf("%s: %s: %w", name, key, err) + } + return nil +} diff --git a/internal/site/site_test.go b/internal/site/site_test.go new file mode 100644 index 0000000..215a4e6 --- /dev/null +++ b/internal/site/site_test.go @@ -0,0 +1,136 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package site + +import ( + "os" + "path/filepath" + "strings" + "testing" +) + +// writeSite writes files (path relative to a new directory, then content) and +// returns the directory. +func writeSite(t *testing.T, files map[string]string) string { + t.Helper() + dir := t.TempDir() + for name, content := range files { + path := filepath.Join(dir, name) + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + t.Fatal(err) + } + if err := os.WriteFile(path, []byte(content), 0o644); err != nil { + t.Fatal(err) + } + } + return dir +} + +// validFiles is a small complete site configuration. +func validFiles() map[string]string { + return map[string]string{ + "site.json": `{ + "base_url": "https://kmalloc.org", + "languages": ["en", "it"], + "contact": "squid@kmalloc.org", + "security": "security@kmalloc.org", + "abuse": "abuse@kmalloc.org", + "assets": {"favicon.svg": "logo/svg/favicon-auto.svg", "squid.asc": "static/squid.asc"}, + "services": [{"id": "ignored"}] +}`, + "lang/en.json": `{"lang_name": "English", "nojs": "No JavaScript.", "nav": {"news": "News"}}`, + "lang/it.json": `{"lang_name": "Italiano", "nojs": "Niente JavaScript.", "nav": {"news": "Novità"}}`, + } +} + +// TestLoadDerivesShownAddresses checks that addresses get a harvest-proof twin. +func TestLoadDerivesShownAddresses(t *testing.T) { + cfg, langs, err := Load(writeSite(t, validFiles())) + if err != nil { + t.Fatalf("Load() error = %v", err) + } + want := map[string]string{ + "contact_shown": "squid (at) kmalloc.org", + "security_shown": "security (at) kmalloc.org", + "abuse_shown": "abuse (at) kmalloc.org", + "base_url": "https://kmalloc.org", + } + for k, v := range want { + if got := cfg.Strings[k]; got != v { + t.Errorf("Strings[%q] = %q, want %q", k, got, v) + } + } + if len(cfg.Languages) != 2 || cfg.Languages[0] != "en" || cfg.Languages[1] != "it" { + t.Errorf("Languages = %v, want [en it]", cfg.Languages) + } + if got := langs["it"].Nav["news"]; got != "Novità" { + t.Errorf("it nav news = %q, want %q", got, "Novità") + } + if got := langs["en"].Strings["nojs"]; got != "No JavaScript." { + t.Errorf("en nojs = %q", got) + } + if got := langs["en"].Code; got != "en" { + t.Errorf("en Code = %q", got) + } +} + +// TestLoadAssets checks the published-name to source map. +func TestLoadAssets(t *testing.T) { + cfg, _, err := Load(writeSite(t, validFiles())) + if err != nil { + t.Fatal(err) + } + if got := cfg.Assets["squid.asc"]; got != "static/squid.asc" { + t.Errorf("Assets[squid.asc] = %q", got) + } + if len(cfg.Assets) != 2 { + t.Errorf("len(Assets) = %d, want 2", len(cfg.Assets)) + } +} + +// TestLoadUnknownLanguageFile checks that a listed language needs its file. +func TestLoadUnknownLanguageFile(t *testing.T) { + files := validFiles() + delete(files, "lang/it.json") + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), "lang/it.json") { + t.Errorf("Load() error = %v, want it to name lang/it.json", err) + } +} + +// TestLoadBadJSON checks that a JSON error names the file. +func TestLoadBadJSON(t *testing.T) { + files := validFiles() + files["lang/en.json"] = `{"lang_name": ` + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), "lang/en.json") { + t.Errorf("Load() error = %v, want it to name lang/en.json", err) + } +} + +// TestLoadLanguageNeedsNameAndNav checks the keys every language must have. +func TestLoadLanguageNeedsNameAndNav(t *testing.T) { + for _, tt := range []struct{ name, body, want string }{ + {"no name", `{"nav": {}}`, "lang_name"}, + {"no nav", `{"lang_name": "English"}`, "nav"}, + } { + t.Run(tt.name, func(t *testing.T) { + files := validFiles() + files["lang/en.json"] = tt.body + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), tt.want) || !strings.Contains(err.Error(), "lang/en.json") { + t.Errorf("Load() error = %v, want it to name lang/en.json and %s", err, tt.want) + } + }) + } +} + +// TestLoadNeedsLanguages checks that an empty language list is an error. +func TestLoadNeedsLanguages(t *testing.T) { + files := validFiles() + files["site.json"] = `{"base_url": "https://kmalloc.org", "languages": []}` + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), "languages") { + t.Errorf("Load() error = %v, want it to mention languages", err) + } +} From 51071e6fb2dc3d3bb367e6cdbb2554fa330a11a0 Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:45:50 +0100 Subject: [PATCH 06/13] feat: load pages and news with dated paths and categories --- internal/content/category.go | 49 ++++++++ internal/content/category_test.go | 35 ++++++ internal/content/helpers_test.go | 26 ++++ internal/content/pages.go | 178 ++++++++++++++++++++++++++ internal/content/pages_test.go | 136 ++++++++++++++++++++ internal/content/posts.go | 203 ++++++++++++++++++++++++++++++ internal/content/posts_test.go | 180 ++++++++++++++++++++++++++ 7 files changed, 807 insertions(+) create mode 100644 internal/content/category.go create mode 100644 internal/content/category_test.go create mode 100644 internal/content/helpers_test.go create mode 100644 internal/content/pages.go create mode 100644 internal/content/pages_test.go create mode 100644 internal/content/posts.go create mode 100644 internal/content/posts_test.go diff --git a/internal/content/category.go b/internal/content/category.go new file mode 100644 index 0000000..fceea37 --- /dev/null +++ b/internal/content/category.go @@ -0,0 +1,49 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package content loads the pages and the news of a site from Markdown files +// and works out their addresses. +package content + +import ( + "fmt" + "regexp" + "strings" +) + +// Category is a news category: the name as written and the name used in its +// address. +type Category struct { + // Name is the category as written in the header of a news file. + Name string + // Slug is the name in the address, such as "linux-day". + Slug string +} + +// accents maps the accented letters of the Latin alphabets to ASCII, so a +// category address stays readable without an extra dependency. +var accents = strings.NewReplacer( + "à", "a", "á", "a", "â", "a", "ã", "a", "ä", "a", "å", "a", "ā", "a", "ă", "a", "ą", "a", + "æ", "ae", "ç", "c", "ć", "c", "č", "c", "ď", "d", "đ", "d", + "è", "e", "é", "e", "ê", "e", "ë", "e", "ē", "e", "ė", "e", "ę", "e", "ě", "e", + "ğ", "g", "ì", "i", "í", "i", "î", "i", "ï", "i", "ī", "i", "į", "i", "ı", "i", + "ł", "l", "ñ", "n", "ń", "n", "ň", "n", + "ò", "o", "ó", "o", "ô", "o", "õ", "o", "ö", "o", "ø", "o", "ō", "o", "ő", "o", "œ", "oe", + "ř", "r", "ś", "s", "š", "s", "ş", "s", "ß", "ss", "ť", "t", "ț", "t", + "ù", "u", "ú", "u", "û", "u", "ü", "u", "ū", "u", "ů", "u", "ű", "u", + "ý", "y", "ÿ", "y", "ź", "z", "ž", "z", "ż", "z", +) + +// nonSlug matches a run of characters that cannot be part of an address. +var nonSlug = regexp.MustCompile(`[^a-z0-9]+`) + +// CategorySlug turns a category name into the name used in its address: +// lowercase, without accents, with hyphens between words ("Linux Day" becomes +// "linux-day"). A name without any letter or digit is an error. +func CategorySlug(name string) (string, error) { + slug := nonSlug.ReplaceAllString(accents.Replace(strings.ToLower(name)), "-") + slug = strings.Trim(slug, "-") + if slug == "" { + return "", fmt.Errorf("category %q has no letters or digits", name) + } + return slug, nil +} diff --git a/internal/content/category_test.go b/internal/content/category_test.go new file mode 100644 index 0000000..0c95e44 --- /dev/null +++ b/internal/content/category_test.go @@ -0,0 +1,35 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import "testing" + +// TestCategorySlug checks the name that goes into a category address. +func TestCategorySlug(t *testing.T) { + tests := []struct { + name string + want string + wantErr bool + }{ + {"Linux Day", "linux-day", false}, + {"FLUG", "flug", false}, + {"Università", "universita", false}, + {"Crème brûlée", "creme-brulee", false}, + {"C++", "c", false}, + {" Spaced out ", "spaced-out", false}, + {"Straße", "strasse", false}, + {"", "", true}, + {"+++", "", true}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got, err := CategorySlug(tt.name) + if (err != nil) != tt.wantErr { + t.Fatalf("CategorySlug(%q) error = %v, wantErr %v", tt.name, err, tt.wantErr) + } + if got != tt.want { + t.Errorf("CategorySlug(%q) = %q, want %q", tt.name, got, tt.want) + } + }) + } +} diff --git a/internal/content/helpers_test.go b/internal/content/helpers_test.go new file mode 100644 index 0000000..7bb9d20 --- /dev/null +++ b/internal/content/helpers_test.go @@ -0,0 +1,26 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import ( + "os" + "path/filepath" + "testing" +) + +// writeFiles writes the files (path relative to a new directory, then content) +// and returns the directory. +func writeFiles(t *testing.T, files map[string]string) string { + t.Helper() + dir := t.TempDir() + for name, content := range files { + path := filepath.Join(dir, filepath.FromSlash(name)) + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + t.Fatal(err) + } + if err := os.WriteFile(path, []byte(content), 0o644); err != nil { + t.Fatal(err) + } + } + return dir +} diff --git a/internal/content/pages.go b/internal/content/pages.go new file mode 100644 index 0000000..35cfba1 --- /dev/null +++ b/internal/content/pages.go @@ -0,0 +1,178 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import ( + "fmt" + "io/fs" + "os" + "path" + "path/filepath" + "strings" + + "git.kmalloc.org/squid/motorino/internal/header" + "git.kmalloc.org/squid/motorino/internal/mdx" +) + +// Page is a page of the site in one language. +type Page struct { + // Lang is the language code, such as "en". + Lang string + // ID names the page; the translations of a page share it. + ID string + // Path is the address of the page, such as "/services.html". + Path string + // Title, Description and Note come from the header. + Title, Description, Note string + // Layout is "page", "bare" or "manifesto". + Layout string + // Switch overrides the address of the language links, by language code. + Switch map[string]string + // Source is the file the page was read from, relative to the site. + Source string + // Body is the Markdown after the header. + Body string +} + +// pageKeys are the keys a page header may have. +var pageKeys = []string{"Title", "ID", "Description", "Layout", "Note", "Switch"} + +// layouts are the values of the Layout key; the first is the default. +var layouts = []string{"page", "bare", "manifesto"} + +// PagePath returns the address of the page file rel, given with slashes and +// relative to the folder of its language. An index.md is the address of its +// folder; the default language lives at the root and the others under +// //. +func PagePath(defaultLang, lang, rel string) string { + rel = strings.TrimSuffix(rel, ".md") + var p string + switch { + case rel == "index": + p = "/" + case strings.HasSuffix(rel, "/index"): + p = "/" + strings.TrimSuffix(rel, "index") + default: + p = "/" + rel + ".html" + } + if lang != defaultLang { + p = "/" + lang + p + } + return p +} + +// LoadPages reads every Markdown file under content// for each language. +// The first language is the default. The em dash rule applies to every page +// except those with the manifesto layout, which is rewritten when it is built. +func LoadPages(dir string, languages []string) ([]Page, error) { + if len(languages) == 0 { + return nil, fmt.Errorf("no languages") + } + var pages []Page + for _, lang := range languages { + folder := path.Join("content", lang) + if info, err := os.Stat(filepath.Join(dir, filepath.FromSlash(folder))); err != nil || !info.IsDir() { + return nil, fmt.Errorf("%s: the folder of language %q is missing", folder, lang) + } + found, err := loadLanguagePages(dir, languages[0], lang, folder) + if err != nil { + return nil, err + } + pages = append(pages, found...) + } + return pages, nil +} + +// loadLanguagePages reads the pages of one language and rejects duplicate IDs. +func loadLanguagePages(dir, defaultLang, lang, folder string) ([]Page, error) { + var pages []Page + seen := map[string]string{} + root := filepath.Join(dir, filepath.FromSlash(folder)) + err := filepath.WalkDir(root, func(file string, d fs.DirEntry, err error) error { + if err != nil || d.IsDir() || !strings.HasSuffix(file, ".md") { + return err + } + rel, err := filepath.Rel(root, file) + if err != nil { + return err + } + rel = filepath.ToSlash(rel) + page, err := loadPage(file, path.Join(folder, rel), defaultLang, lang, rel) + if err != nil { + return err + } + if other, dup := seen[page.ID]; dup { + return fmt.Errorf("%s: the ID %q is also used by %s", page.Source, page.ID, other) + } + seen[page.ID] = page.Source + pages = append(pages, page) + return nil + }) + return pages, err +} + +// loadPage reads and checks one page file. +func loadPage(file, source, defaultLang, lang, rel string) (Page, error) { + data, err := os.ReadFile(file) + if err != nil { + return Page{}, fmt.Errorf("read %s: %w", source, err) + } + h, body, err := header.Parse(source, data) + if err != nil { + return Page{}, err + } + if err := h.Only(source, pageKeys...); err != nil { + return Page{}, err + } + if err := h.Require(source, "Title", "ID", "Description"); err != nil { + return Page{}, err + } + layout := h.Get("Layout") + if layout == "" { + layout = layouts[0] + } + if !contains(layouts, layout) { + return Page{}, fmt.Errorf("%s: unknown Layout %q (use %s)", source, layout, strings.Join(layouts, ", ")) + } + if layout != "manifesto" { + if err := mdx.RejectEmDash(source, string(data)); err != nil { + return Page{}, err + } + } + switches, err := parseSwitch(source, h.Get("Switch")) + if err != nil { + return Page{}, err + } + return Page{ + Lang: lang, ID: h.Get("ID"), Path: PagePath(defaultLang, lang, rel), + Title: h.Get("Title"), Description: h.Get("Description"), Note: h.Get("Note"), + Layout: layout, Switch: switches, Source: source, Body: body, + }, nil +} + +// parseSwitch reads "en=/path, de=/path" into a map; an empty value is an +// empty map. +func parseSwitch(source, value string) (map[string]string, error) { + out := map[string]string{} + if strings.TrimSpace(value) == "" { + return out, nil + } + for _, entry := range strings.Split(value, ",") { + lang, target, ok := strings.Cut(strings.TrimSpace(entry), "=") + if !ok || lang == "" || target == "" { + return nil, fmt.Errorf("%s: Switch entry %q is not of the form lang=/path", source, strings.TrimSpace(entry)) + } + out[strings.TrimSpace(lang)] = strings.TrimSpace(target) + } + return out, nil +} + +// contains reports whether list has s. +func contains(list []string, s string) bool { + for _, item := range list { + if item == s { + return true + } + } + return false +} diff --git a/internal/content/pages_test.go b/internal/content/pages_test.go new file mode 100644 index 0000000..3c9a4ec --- /dev/null +++ b/internal/content/pages_test.go @@ -0,0 +1,136 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import ( + "strings" + "testing" +) + +// TestPagePath checks how a page file becomes an address. +func TestPagePath(t *testing.T) { + tests := []struct { + lang, rel, want string + }{ + {"en", "index.md", "/"}, + {"en", "services.md", "/services.html"}, + {"en", "news/index.md", "/news/"}, + {"it", "index.md", "/it/"}, + {"it", "servizi.md", "/it/servizi.html"}, + {"it", "news/index.md", "/it/news/"}, + {"es", "manifesto.md", "/es/manifesto.html"}, + } + for _, tt := range tests { + t.Run(tt.lang+"/"+tt.rel, func(t *testing.T) { + if got := PagePath("en", tt.lang, tt.rel); got != tt.want { + t.Errorf("PagePath(en, %s, %s) = %q, want %q", tt.lang, tt.rel, got, tt.want) + } + }) + } +} + +// pageFile is a valid page with the given extra header lines and body. +func pageFile(extra, body string) string { + return "Title: Services\nID: services\nDescription: What we run.\n" + extra + "-\n" + body +} + +// TestLoadPages checks the fields of a loaded page. +func TestLoadPages(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "content/en/services.md": pageFile("Switch: it=/it/servizi.html, de=/de/\n", "Body.\n"), + "content/en/news/index.md": "Title: News\nID: news\nDescription: The news.\n-\nIntro.\n", + "content/it/servizi.md": "Title: Servizi\nID: services\nDescription: Cosa offriamo.\nLayout: bare\n-\nCorpo.\n", + "content/en/notes/ignored.txt": "not markdown", + }) + pages, err := LoadPages(dir, []string{"en", "it"}) + if err != nil { + t.Fatalf("LoadPages() error = %v", err) + } + if len(pages) != 3 { + t.Fatalf("got %d pages, want 3: %+v", len(pages), pages) + } + byPath := map[string]Page{} + for _, p := range pages { + byPath[p.Lang+" "+p.Path] = p + } + s := byPath["en /services.html"] + if s.ID != "services" || s.Title != "Services" || s.Description != "What we run." || + s.Layout != "page" || s.Body != "Body.\n" || s.Source != "content/en/services.md" { + t.Errorf("en services = %+v", s) + } + if s.Switch["it"] != "/it/servizi.html" || s.Switch["de"] != "/de/" { + t.Errorf("Switch = %v", s.Switch) + } + if it := byPath["it /it/servizi.html"]; it.Layout != "bare" || it.Lang != "it" { + t.Errorf("it services = %+v", it) + } + if n := byPath["en /news/"]; n.ID != "news" { + t.Errorf("news page = %+v", n) + } +} + +// TestLoadPagesRejectsEmDash checks that an em dash in a page is an error. +func TestLoadPagesRejectsEmDash(t *testing.T) { + dir := writeFiles(t, map[string]string{"content/en/x.md": pageFile("", "Words — more words.\n")}) + _, err := LoadPages(dir, []string{"en"}) + if err == nil || !strings.Contains(err.Error(), "content/en/x.md") { + t.Errorf("LoadPages() error = %v, want it to name content/en/x.md", err) + } +} + +// TestLoadPagesManifestoKeepsEmDash checks that the manifesto layout is exempt: +// its text is the owner's and is rewritten when the page is built. +func TestLoadPagesManifestoKeepsEmDash(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "content/en/manifesto.md": "Title: Manifesto\nID: manifesto\nDescription: What we stand for.\nLayout: manifesto\n-\n## 01 — Antifascist\n", + }) + pages, err := LoadPages(dir, []string{"en"}) + if err != nil { + t.Fatalf("LoadPages() error = %v", err) + } + if len(pages) != 1 || !strings.Contains(pages[0].Body, "—") { + t.Errorf("pages = %+v, want one page that keeps its em dash", pages) + } +} + +// TestLoadPagesDuplicateID checks that two pages cannot share an ID in a language. +func TestLoadPagesDuplicateID(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "content/en/a.md": pageFile("", "A.\n"), + "content/en/b.md": pageFile("", "B.\n"), + }) + _, err := LoadPages(dir, []string{"en"}) + if err == nil || !strings.Contains(err.Error(), "services") { + t.Errorf("LoadPages() error = %v, want it to name the duplicate ID", err) + } +} + +// TestLoadPagesHeaderErrors checks the header rules of pages. +func TestLoadPagesHeaderErrors(t *testing.T) { + tests := []struct { + name, file, want string + }{ + {"unknown key", "Title: T\nID: x\nDescription: d\nTitolo: T\n-\nB\n", "Titolo"}, + {"missing id", "Title: T\nDescription: d\n-\nB\n", "ID"}, + {"bad layout", "Title: T\nID: x\nDescription: d\nLayout: fancy\n-\nB\n", "fancy"}, + {"bad switch", "Title: T\nID: x\nDescription: d\nSwitch: nonsense\n-\nB\n", "Switch"}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + dir := writeFiles(t, map[string]string{"content/en/x.md": tt.file}) + _, err := LoadPages(dir, []string{"en"}) + if err == nil || !strings.Contains(err.Error(), tt.want) || !strings.Contains(err.Error(), "content/en/x.md") { + t.Errorf("LoadPages() error = %v, want it to name content/en/x.md and %s", err, tt.want) + } + }) + } +} + +// TestLoadPagesMissingLanguageFolder checks that a listed language needs its folder. +func TestLoadPagesMissingLanguageFolder(t *testing.T) { + dir := writeFiles(t, map[string]string{"content/en/x.md": pageFile("", "B.\n")}) + _, err := LoadPages(dir, []string{"en", "it"}) + if err == nil || !strings.Contains(err.Error(), "content/it") { + t.Errorf("LoadPages() error = %v, want it to name content/it", err) + } +} diff --git a/internal/content/posts.go b/internal/content/posts.go new file mode 100644 index 0000000..a51c408 --- /dev/null +++ b/internal/content/posts.go @@ -0,0 +1,203 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import ( + "fmt" + "os" + "path/filepath" + "regexp" + "sort" + "strings" + "time" + + "git.kmalloc.org/squid/motorino/internal/header" + "git.kmalloc.org/squid/motorino/internal/mdx" +) + +// Post is a news item. +type Post struct { + // Slug is the name of the file without its extension. + Slug string + // Path is the address, /news/YYYY/MM/.html. + Path string + // Title, Author and Description come from the header; the description + // falls back to the first sentence of the body. + Title, Author, Description string + // Date is the date as written, with its own offset. + Date time.Time + // Categories are the categories of the post, in the order written. + Categories []Category + // Source is the file the post was read from, relative to the site. + Source string + // Body is the Markdown after the header. + Body string +} + +// postKeys are the keys a news header may have. +var postKeys = []string{"Title", "Author", "Date", "Categories", "Description"} + +// dateLayouts are the accepted spellings of Date, ISO 8601 with an offset. +var dateLayouts = []string{"2006-01-02T15:04:05-0700", "2006-01-02T15:04:05Z07:00"} + +// slugName matches a file name made of lowercase words joined by hyphens. +var slugName = regexp.MustCompile(`^[a-z0-9]+(?:-[a-z0-9]+)*$`) + +// PostPath returns the address of a news item: the year and the month are +// those of date as written, not converted to another time zone. +func PostPath(date time.Time, slug string) string { + return "/news/" + date.Format("2006/01") + "/" + slug + ".html" +} + +// LoadPosts reads news/*.md, newest first. A site without a news folder has +// no posts. Two posts with the same address, or two category names with the +// same address, are errors. +func LoadPosts(dir string) ([]Post, error) { + files, err := filepath.Glob(filepath.Join(dir, "news", "*.md")) + if err != nil { + return nil, fmt.Errorf("list news: %w", err) + } + var posts []Post + for _, file := range files { + post, err := loadPost(file) + if err != nil { + return nil, err + } + posts = append(posts, post) + } + sort.SliceStable(posts, func(i, j int) bool { + if !posts[i].Date.Equal(posts[j].Date) { + return posts[i].Date.After(posts[j].Date) + } + return posts[i].Slug < posts[j].Slug + }) + if err := checkPaths(posts); err != nil { + return nil, err + } + if err := checkCategories(posts); err != nil { + return nil, err + } + return posts, nil +} + +// loadPost reads and checks one news file. +func loadPost(file string) (Post, error) { + base := filepath.Base(file) + source := "news/" + base + slug := strings.TrimSuffix(base, ".md") + if !slugName.MatchString(slug) { + return Post{}, fmt.Errorf("%s: the name must be lowercase words joined by hyphens", source) + } + data, err := os.ReadFile(file) + if err != nil { + return Post{}, fmt.Errorf("read %s: %w", source, err) + } + h, body, err := header.Parse(source, data) + if err != nil { + return Post{}, err + } + if err := h.Only(source, postKeys...); err != nil { + return Post{}, err + } + if err := h.Require(source, "Title", "Date"); err != nil { + return Post{}, err + } + if err := mdx.RejectEmDash(source, string(data)); err != nil { + return Post{}, err + } + date, err := parseDate(source, h.Get("Date")) + if err != nil { + return Post{}, err + } + categories, err := parseCategories(source, h.Get("Categories")) + if err != nil { + return Post{}, err + } + description := h.Get("Description") + if description == "" { + description = firstSentence(body) + } + return Post{ + Slug: slug, Path: PostPath(date, slug), Title: h.Get("Title"), Author: h.Get("Author"), + Description: description, Date: date, Categories: categories, Source: source, Body: body, + }, nil +} + +// parseDate reads Date in any of the accepted layouts. +func parseDate(source, value string) (time.Time, error) { + for _, layout := range dateLayouts { + if date, err := time.Parse(layout, value); err == nil { + return date, nil + } + } + return time.Time{}, fmt.Errorf("%s: Date %q is not ISO 8601 with an offset, such as 2026-09-18T17:00:45+0200", source, value) +} + +// parseCategories splits a comma separated list into categories. +func parseCategories(source, value string) ([]Category, error) { + var out []Category + for _, name := range strings.Split(value, ",") { + name = strings.TrimSpace(name) + if name == "" { + continue + } + slug, err := CategorySlug(name) + if err != nil { + return nil, fmt.Errorf("%s: %w", source, err) + } + out = append(out, Category{Name: name, Slug: slug}) + } + return out, nil +} + +// checkPaths returns an error when two posts have the same address. +func checkPaths(posts []Post) error { + seen := map[string]string{} + for _, p := range posts { + if other, dup := seen[p.Path]; dup { + return fmt.Errorf("%s and %s have the same address %s", other, p.Source, p.Path) + } + seen[p.Path] = p.Source + } + return nil +} + +// checkCategories returns an error when two different category names give the +// same address. +func checkCategories(posts []Post) error { + names := map[string]string{} + for _, p := range posts { + for _, c := range p.Categories { + if other, ok := names[c.Slug]; ok && other != c.Name { + return fmt.Errorf("%s: the categories %q and %q give the same address /news/category/%s.html", p.Source, other, c.Name, c.Slug) + } + names[c.Slug] = c.Name + } + } + return nil +} + +// markup matches the Markdown that is dropped from a fallback description. +var ( + markdownLink = regexp.MustCompile(`\[([^\]]*)\]\([^)]*\)`) + markdownMark = regexp.MustCompile("[*_`]") + sentenceEnd = regexp.MustCompile(`^(.+?[.!?])(?:\s|$)`) +) + +// firstSentence returns the first sentence of the first paragraph of body that +// is not a heading or raw HTML, without Markdown markup. +func firstSentence(body string) string { + for _, block := range strings.Split(body, "\n\n") { + block = strings.TrimSpace(block) + if block == "" || strings.HasPrefix(block, "#") || strings.HasPrefix(block, "<") { + continue + } + text := markdownLink.ReplaceAllString(strings.Join(strings.Fields(block), " "), "$1") + text = markdownMark.ReplaceAllString(text, "") + if m := sentenceEnd.FindStringSubmatch(text); m != nil { + return m[1] + } + return text + } + return "" +} diff --git a/internal/content/posts_test.go b/internal/content/posts_test.go new file mode 100644 index 0000000..3905178 --- /dev/null +++ b/internal/content/posts_test.go @@ -0,0 +1,180 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package content + +import ( + "strings" + "testing" + "time" +) + +// TestPostPath checks that the month comes from the date as written. +func TestPostPath(t *testing.T) { + tests := []struct { + date, slug, want string + }{ + {"2026-11-14T12:00:00+0100", "shop", "/news/2026/11/shop.html"}, + {"2026-10-31T23:30:00-0500", "x", "/news/2026/10/x.html"}, + {"2026-09-18T17:00:45+0200", "gnu-linux-day-2026", "/news/2026/09/gnu-linux-day-2026.html"}, + } + for _, tt := range tests { + t.Run(tt.date, func(t *testing.T) { + date, err := time.Parse("2006-01-02T15:04:05-0700", tt.date) + if err != nil { + t.Fatal(err) + } + if got := PostPath(date, tt.slug); got != tt.want { + t.Errorf("PostPath() = %q, want %q", got, tt.want) + } + }) + } +} + +// ownerSample is the example header the owner gave for the news. +const ownerSample = "Title: GNU/Linux Day 2026\nAuthor: Matteo Bini\nDate: 2026-09-18T17:00:45+0200\n" + + "Categories: Linux Day, FLUG\n-\nThe programme is out. See you there.\n" + +// TestLoadPostsOwnerSample checks every field of the owner's example. +func TestLoadPostsOwnerSample(t *testing.T) { + dir := writeFiles(t, map[string]string{"news/gnu-linux-day-2026.md": ownerSample}) + posts, err := LoadPosts(dir) + if err != nil { + t.Fatalf("LoadPosts() error = %v", err) + } + if len(posts) != 1 { + t.Fatalf("got %d posts, want 1", len(posts)) + } + p := posts[0] + if p.Title != "GNU/Linux Day 2026" || p.Author != "Matteo Bini" || p.Slug != "gnu-linux-day-2026" || + p.Path != "/news/2026/09/gnu-linux-day-2026.html" || p.Source != "news/gnu-linux-day-2026.md" { + t.Errorf("post = %+v", p) + } + if got := p.Date.Format("2006-01-02"); got != "2026-09-18" { + t.Errorf("Date = %s, want 2026-09-18", got) + } + if len(p.Categories) != 2 || p.Categories[0] != (Category{"Linux Day", "linux-day"}) || p.Categories[1] != (Category{"FLUG", "flug"}) { + t.Errorf("Categories = %+v", p.Categories) + } + if p.Description != "The programme is out." { + t.Errorf("Description = %q, want the first sentence of the body", p.Description) + } +} + +// TestLoadPostsDescription checks that an explicit Description wins and that +// the fallback drops the Markdown markup. +func TestLoadPostsDescription(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "news/a.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\nDescription: Chosen.\n-\nIgnored. Text.\n", + "news/b.md": "Title: B\nDate: 2026-01-02T10:00:00+0100\n-\nThis is **bold** and [a link](https://x.org/). More.\n", + }) + posts, err := LoadPosts(dir) + if err != nil { + t.Fatal(err) + } + got := map[string]string{} + for _, p := range posts { + got[p.Slug] = p.Description + } + if got["a"] != "Chosen." { + t.Errorf("a Description = %q", got["a"]) + } + if got["b"] != "This is bold and a link." { + t.Errorf("b Description = %q", got["b"]) + } +} + +// TestLoadPostsSortedNewestFirst checks the order and the tie break. +func TestLoadPostsSortedNewestFirst(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "news/old.md": "Title: Old\nDate: 2026-01-01T10:00:00+0100\n-\nx\n", + "news/new.md": "Title: New\nDate: 2026-03-01T10:00:00+0100\n-\nx\n", + "news/mid1.md": "Title: M1\nDate: 2026-02-01T10:00:00+0100\n-\nx\n", + "news/mid2.md": "Title: M2\nDate: 2026-02-01T10:00:00+0100\n-\nx\n", + }) + posts, err := LoadPosts(dir) + if err != nil { + t.Fatal(err) + } + var order []string + for _, p := range posts { + order = append(order, p.Slug) + } + if got, want := strings.Join(order, ","), "new,mid1,mid2,old"; got != want { + t.Errorf("order = %s, want %s", got, want) + } +} + +// TestLoadPostsDateLayouts checks both accepted spellings of the offset. +func TestLoadPostsDateLayouts(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "news/a.md": "Title: A\nDate: 2026-05-01T10:00:00+02:00\n-\nx\n", + "news/b.md": "Title: B\nDate: 2026-05-02T10:00:00Z\n-\nx\n", + }) + if _, err := LoadPosts(dir); err != nil { + t.Errorf("LoadPosts() error = %v", err) + } +} + +// TestLoadPostsErrors checks the failures that must name the file. +func TestLoadPostsErrors(t *testing.T) { + tests := []struct { + name string + files map[string]string + want []string + }{ + {"em dash", map[string]string{"news/a.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\n-\nWords — more.\n"}, []string{"news/a.md"}}, + {"bad date", map[string]string{"news/a.md": "Title: A\nDate: yesterday\n-\nx\n"}, []string{"news/a.md", "Date"}}, + {"missing date", map[string]string{"news/a.md": "Title: A\n-\nx\n"}, []string{"news/a.md", "Date"}}, + {"unknown key", map[string]string{"news/a.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\nTitolo: A\n-\nx\n"}, []string{"news/a.md", "Titolo"}}, + {"bad file name", map[string]string{"news/Not A Slug.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\n-\nx\n"}, []string{"Not A Slug.md"}}, + {"empty category slug", map[string]string{"news/a.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\nCategories: Ok, +++\n-\nx\n"}, []string{"news/a.md", "+++"}}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + _, err := LoadPosts(writeFiles(t, tt.files)) + if err == nil { + t.Fatal("LoadPosts() error = nil") + } + for _, want := range tt.want { + if !strings.Contains(err.Error(), want) { + t.Errorf("error %q does not contain %q", err, want) + } + } + }) + } +} + +// TestLoadPostsDuplicateSlugSameMonth checks that two posts cannot share an address. +func TestLoadPostsDuplicateSlugSameMonth(t *testing.T) { + // Same slug cannot come from two files, so the clash is built with a slug + // that two different months would not share but a repeated date would: + // the check is on the final path, so an equal path is the failure. + posts := []Post{ + {Slug: "same", Path: "/news/2026/11/same.html", Source: "news/a.md"}, + {Slug: "same", Path: "/news/2026/11/same.html", Source: "news/b.md"}, + } + err := checkPaths(posts) + if err == nil || !strings.Contains(err.Error(), "news/a.md") || !strings.Contains(err.Error(), "news/b.md") { + t.Errorf("checkPaths() = %v, want an error naming both files", err) + } +} + +// TestLoadPostsCategoryCollision checks that two names with the same slug fail. +func TestLoadPostsCategoryCollision(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "news/a.md": "Title: A\nDate: 2026-01-01T10:00:00+0100\nCategories: C\n-\nx\n", + "news/b.md": "Title: B\nDate: 2026-01-02T10:00:00+0100\nCategories: C++\n-\nx\n", + }) + _, err := LoadPosts(dir) + if err == nil || !strings.Contains(err.Error(), "C++") || !strings.Contains(err.Error(), "\"C\"") { + t.Errorf("LoadPosts() error = %v, want it to name both C and C++", err) + } +} + +// TestLoadPostsNoNewsFolder checks that a site without news is fine. +func TestLoadPostsNoNewsFolder(t *testing.T) { + posts, err := LoadPosts(t.TempDir()) + if err != nil || len(posts) != 0 { + t.Errorf("LoadPosts() = %v, %v, want no posts and no error", posts, err) + } +} From 2f5cb15f2134c9e8f319127185c953e4e88d34cc Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:46:58 +0100 Subject: [PATCH 07/13] feat: build the news lists, category lists and the feed --- internal/build/feed.go | 49 +++++++++++++++ internal/build/feed_test.go | 61 ++++++++++++++++++ internal/build/news.go | 120 ++++++++++++++++++++++++++++++++++++ internal/build/news_test.go | 107 ++++++++++++++++++++++++++++++++ 4 files changed, 337 insertions(+) create mode 100644 internal/build/feed.go create mode 100644 internal/build/feed_test.go create mode 100644 internal/build/news.go create mode 100644 internal/build/news_test.go diff --git a/internal/build/feed.go b/internal/build/feed.go new file mode 100644 index 0000000..485cc8a --- /dev/null +++ b/internal/build/feed.go @@ -0,0 +1,49 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "strings" + "time" + + "git.kmalloc.org/squid/motorino/internal/render" + "git.kmalloc.org/squid/motorino/internal/site" +) + +// feed returns the RSS 2.0 feed of the latest limit posts, which must be sorted +// newest first. Each item carries the full text with absolute links. The +// channel is described by the language l, and newsURL is the address of the +// news page, such as "/news/". +func feed(base string, l site.Lang, newsURL string, posts []renderedPost, limit int) string { + if limit < len(posts) { + posts = posts[:limit] + } + var items strings.Builder + for _, p := range posts { + link := base + p.Path + text := strings.ReplaceAll(p.HTML, `href="/`, `href="`+base+`/`) + items.WriteString("\n") + items.WriteString("" + render.Escape(p.Title) + "\n") + items.WriteString("" + link + "\n") + items.WriteString(`` + link + "\n") + items.WriteString("" + p.Date.Format(time.RFC1123Z) + "\n") + items.WriteString("" + render.Escape(text) + "\n") + items.WriteString("\n") + } + built := "" + if len(posts) > 0 { + built = "" + posts[0].Date.Format(time.RFC1123Z) + "\n" + } + url := base + newsURL + return ` + + +kmalloc.org: ` + render.Escape(l.Nav["news"]) + ` +` + url + ` +` + render.Escape(l.Strings["news_p"]) + ` +` + l.Code + ` +` + built + ` +` + items.String() + ` + +` +} diff --git a/internal/build/feed_test.go b/internal/build/feed_test.go new file mode 100644 index 0000000..5c508ab --- /dev/null +++ b/internal/build/feed_test.go @@ -0,0 +1,61 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "encoding/xml" + "strings" + "testing" + + "git.kmalloc.org/squid/motorino/internal/site" +) + +// feedLang is the language the feed header is built from. +func feedLang() site.Lang { + return site.Lang{Code: "en", Strings: map[string]string{"news_p": "The news & more."}, Nav: map[string]string{"news": "News"}} +} + +// TestFeedItems checks the channel, the item fields, the limit and the dates. +func TestFeedItems(t *testing.T) { + items := []renderedPost{ + {Post: testPost("new", "2026-11-14", "New ", ""), HTML: `

    See people.

    `}, + {Post: testPost("old", "2026-11-12", "Old", ""), HTML: "

    Old text.

    "}, + {Post: testPost("older", "2026-11-10", "Older", ""), HTML: "

    Older text.

    "}, + } + got := feed("https://kmalloc.org", feedLang(), "/news/", items, 2) + + for _, want := range []string{ + "kmalloc.org: News", + "https://kmalloc.org/news/", + "The news & more.", + "en", + ``, + "New <post>", + "https://kmalloc.org/news/2026/11/new.html", + `https://kmalloc.org/news/2026/11/new.html`, + "Sat, 14 Nov 2026 12:00:00 +0100", + "Sat, 14 Nov 2026 12:00:00 +0100", + `<a href="https://kmalloc.org/people.html">`, + } { + if !strings.Contains(got, want) { + t.Errorf("feed does not contain %q\n%s", want, got) + } + } + if strings.Contains(got, "older.html") { + t.Error("feed has a third item but the limit is 2") + } + if err := xml.Unmarshal([]byte(got), new(any)); err != nil { + t.Errorf("feed is not well-formed XML: %v", err) + } +} + +// TestFeedWithoutPosts checks that an empty feed is still a valid channel. +func TestFeedWithoutPosts(t *testing.T) { + got := feed("https://kmalloc.org", feedLang(), "/news/", nil, 20) + if strings.Contains(got, "lastBuildDate") || strings.Contains(got, "") { + t.Errorf("empty feed has dates or items:\n%s", got) + } + if err := xml.Unmarshal([]byte(got), new(any)); err != nil { + t.Errorf("empty feed is not well-formed XML: %v", err) + } +} diff --git a/internal/build/news.go b/internal/build/news.go new file mode 100644 index 0000000..a9f6e89 --- /dev/null +++ b/internal/build/news.go @@ -0,0 +1,120 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +// Package build assembles a site from its configuration, content, templates +// and assets, and writes it to a folder. +package build + +import ( + "fmt" + "sort" + "strings" + + "git.kmalloc.org/squid/motorino/internal/content" + "git.kmalloc.org/squid/motorino/internal/render" +) + +// dateOnly is the layout of the dates shown in lists. +const dateOnly = "2006-01-02" + +// renderedPost is a post together with its body already converted to HTML. +type renderedPost struct { + content.Post + // HTML is the body of the post as HTML, placeholders already replaced. + HTML string +} + +// newsItem returns the
  • of a post for a list: the date, the title as a +// link and, when withDescription is set and there is one, the description. News +// are written in English, so on any other language the link says so. +func newsItem(p content.Post, lang string, withDescription bool) string { + mark := "" + if lang != "en" { + mark = ` hreflang="en" lang="en"` + } + day := p.Date.Format(dateOnly) + item := fmt.Sprintf(`
  • %s`, + day, day, p.Path, mark, render.Escape(p.Title)) + if withDescription && p.Description != "" { + item += ": " + render.Escape(p.Description) + } + return item + "
  • " +} + +// newsList returns the full list of the news as a
      , or an empty string +// when there are no posts. +func newsList(posts []content.Post, lang string) string { + if len(posts) == 0 { + return "" + } + items := make([]string, len(posts)) + for i, p := range posts { + items[i] = newsItem(p, lang, true) + } + return "
        \n" + strings.Join(items, "\n") + "\n
      " +} + +// latestNews returns the
    • items of the first n posts, without the
        +// and without descriptions, for the home page. +func latestNews(posts []content.Post, lang string, n int) string { + if n > len(posts) { + n = len(posts) + } + items := make([]string, n) + for i := 0; i < n; i++ { + items[i] = newsItem(posts[i], lang, false) + } + return strings.Join(items, "\n") +} + +// categoriesList returns the list of the categories, sorted by name, each with +// the number of posts, and the categories themselves. With no categories both +// are empty. +func categoriesList(posts []content.Post) (string, []content.Category) { + counts := map[string]int{} + byslug := map[string]content.Category{} + for _, p := range posts { + for _, c := range p.Categories { + counts[c.Slug]++ + byslug[c.Slug] = c + } + } + if len(byslug) == 0 { + return "", nil + } + cats := make([]content.Category, 0, len(byslug)) + for _, c := range byslug { + cats = append(cats, c) + } + sort.Slice(cats, func(i, j int) bool { + a, b := strings.ToLower(cats[i].Name), strings.ToLower(cats[j].Name) + if a != b { + return a < b + } + return cats[i].Name < cats[j].Name + }) + items := make([]string, len(cats)) + for i, c := range cats { + items[i] = fmt.Sprintf(`
      • %s (%d)
      • `, categoryPath(c.Slug), render.Escape(c.Name), counts[c.Slug]) + } + return "
          \n" + strings.Join(items, "\n") + "\n
        ", cats +} + +// categoryPath returns the address of the page of a category. +func categoryPath(slug string) string { + return "/news/category/" + slug + ".html" +} + +// postsIn returns the posts that have the category with the given address +// name, in the order they were given. +func postsIn(posts []content.Post, slug string) []content.Post { + var out []content.Post + for _, p := range posts { + for _, c := range p.Categories { + if c.Slug == slug { + out = append(out, p) + break + } + } + } + return out +} diff --git a/internal/build/news_test.go b/internal/build/news_test.go new file mode 100644 index 0000000..39bddfe --- /dev/null +++ b/internal/build/news_test.go @@ -0,0 +1,107 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "strings" + "testing" + "time" + + "git.kmalloc.org/squid/motorino/internal/content" +) + +// testPost returns a post dated on the given day (noon, +0100). +func testPost(slug, day, title, description string, cats ...string) content.Post { + date, err := time.Parse("2006-01-02T15:04:05-0700", day+"T12:00:00+0100") + if err != nil { + panic(err) + } + var categories []content.Category + for _, name := range cats { + slugName, _ := content.CategorySlug(name) + categories = append(categories, content.Category{Name: name, Slug: slugName}) + } + return content.Post{ + Slug: slug, Path: content.PostPath(date, slug), Title: title, Description: description, + Date: date, Categories: categories, Source: "news/" + slug + ".md", + } +} + +// TestNewsListMarksEnglishOnItalian checks the hreflang mark on other languages. +func TestNewsListMarksEnglishOnItalian(t *testing.T) { + posts := []content.Post{testPost("shop", "2026-11-14", "A shop ", "About the shop.")} + en := newsList(posts, "en") + it := newsList(posts, "it") + want := `
      • A shop <new>: About the shop.
      • ` + if !strings.Contains(en, want) { + t.Errorf("en list %q does not contain %q", en, want) + } + if !strings.Contains(it, ``) { + t.Errorf("it list %q lacks the hreflang mark", it) + } + if !strings.HasPrefix(en, "
          \n") || !strings.HasSuffix(en, "\n
        ") { + t.Errorf("list is not wrapped in
          : %q", en) + } +} + +// TestNewsListWithoutDescription checks that an empty description adds no colon. +func TestNewsListWithoutDescription(t *testing.T) { + got := newsList([]content.Post{testPost("a", "2026-01-01", "Title", "")}, "en") + if strings.Contains(got, ": ") { + t.Errorf("list %q has a colon but no description", got) + } +} + +// TestNewsListEmpty checks that no posts give an empty string. +func TestNewsListEmpty(t *testing.T) { + if got := newsList(nil, "en"); got != "" { + t.Errorf("newsList(nil) = %q, want empty", got) + } +} + +// TestLatestNewsLimit checks that only the first n posts are listed. +func TestLatestNewsLimit(t *testing.T) { + posts := []content.Post{ + testPost("a", "2026-03-01", "A", ""), testPost("b", "2026-02-01", "B", ""), testPost("c", "2026-01-01", "C", ""), + } + got := latestNews(posts, "en", 2) + if strings.Count(got, "
        • ") != 2 || strings.Contains(got, ">C<") || strings.Contains(got, "
            ") { + t.Errorf("latestNews() = %q, want two items and no
              ", got) + } +} + +// TestCategoriesListCountsAndSorts checks the category index. +func TestCategoriesListCountsAndSorts(t *testing.T) { + posts := []content.Post{ + testPost("a", "2026-03-01", "A", "", "Linux Day", "FLUG"), + testPost("b", "2026-02-01", "B", "", "FLUG"), + testPost("c", "2026-01-01", "C", "", "News"), + } + html, cats := categoriesList(posts) + if len(cats) != 3 || cats[0].Name != "FLUG" || cats[1].Name != "Linux Day" || cats[2].Name != "News" { + t.Errorf("categories = %+v, want FLUG, Linux Day, News", cats) + } + for _, want := range []string{ + `FLUG (2)`, + `Linux Day (1)`, + } { + if !strings.Contains(html, want) { + t.Errorf("html %q does not contain %q", html, want) + } + } + if emptyHTML, emptyCats := categoriesList(nil); emptyHTML != "" || len(emptyCats) != 0 { + t.Errorf("categoriesList(nil) = %q, %v, want empty", emptyHTML, emptyCats) + } +} + +// TestPostsIn checks that posts are picked by category address. +func TestPostsIn(t *testing.T) { + posts := []content.Post{ + testPost("a", "2026-03-01", "A", "", "FLUG"), + testPost("b", "2026-02-01", "B", "", "News"), + } + got := postsIn(posts, "flug") + if len(got) != 1 || got[0].Slug != "a" { + t.Errorf("postsIn(flug) = %+v, want only post a", got) + } +} From 935bf3958f5efc062b4e34f916f622bef09e6487 Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:48:08 +0100 Subject: [PATCH 08/13] fix: give no id to the level 1 heading --- internal/mdx/mdx.go | 10 +++++++--- internal/mdx/mdx_test.go | 18 ++++++++++++++++++ 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/internal/mdx/mdx.go b/internal/mdx/mdx.go index 41ea41b..d01c6a7 100644 --- a/internal/mdx/mdx.go +++ b/internal/mdx/mdx.go @@ -19,7 +19,8 @@ import ( type Heading struct { // Level is 1 for "#", 2 for "##", and so on. Level int - // ID is the anchor identifier given to the heading. + // ID is the anchor identifier given to the heading; a level 1 heading has + // none, because it is the title of the page. ID string // Text is the heading without markup. Text string @@ -43,8 +44,11 @@ func Render(md string) (string, []Heading, error) { return ast.WalkContinue, nil } plain := plainText(h, src) - id := uniqueID(Slug(plain), used) - h.SetAttributeString("id", []byte(id)) + id := "" + if h.Level >= 2 { + id = uniqueID(Slug(plain), used) + h.SetAttributeString("id", []byte(id)) + } headings = append(headings, Heading{Level: h.Level, ID: id, Text: plain}) return ast.WalkSkipChildren, nil }) diff --git a/internal/mdx/mdx_test.go b/internal/mdx/mdx_test.go index a0a58a3..f60f8b6 100644 --- a/internal/mdx/mdx_test.go +++ b/internal/mdx/mdx_test.go @@ -64,6 +64,24 @@ func TestRenderRawHTMLPasses(t *testing.T) { } } +// TestRenderTitleHasNoID checks that a level 1 heading gets no id, so it cannot +// collide with a level 2 heading that has the same words. +func TestRenderTitleHasNoID(t *testing.T) { + html, headings, err := Render("# Services\n\n## Services\n") + if err != nil { + t.Fatal(err) + } + if strings.Contains(html, `

              `) { + t.Errorf("html %q lost the id of the h2", html) + } + if len(headings) != 2 || headings[0].ID != "" || headings[1].ID != "services" { + t.Errorf("headings = %+v, want the h1 without id and the h2 as services", headings) + } +} + // TestRenderHeadingTextIsPlain checks that the heading text drops the markup. func TestRenderHeadingTextIsPlain(t *testing.T) { _, headings, err := Render("## Free *your* mind\n") From 6bdf2ca05f2fec4242c67b7819a5707cca134d9d Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:50:58 +0100 Subject: [PATCH 09/13] feat: assemble the site from content, templates and assets --- internal/build/build.go | 222 ++++++++++++++++++++++++ internal/build/build_test.go | 306 +++++++++++++++++++++++++++++++++ internal/build/context.go | 210 ++++++++++++++++++++++ internal/build/fixture_test.go | 193 +++++++++++++++++++++ internal/build/pages.go | 226 ++++++++++++++++++++++++ internal/build/robots.go | 27 +++ internal/mdx/mdx.go | 3 +- 7 files changed, 1186 insertions(+), 1 deletion(-) create mode 100644 internal/build/build.go create mode 100644 internal/build/build_test.go create mode 100644 internal/build/context.go create mode 100644 internal/build/fixture_test.go create mode 100644 internal/build/pages.go create mode 100644 internal/build/robots.go diff --git a/internal/build/build.go b/internal/build/build.go new file mode 100644 index 0000000..cdabad4 --- /dev/null +++ b/internal/build/build.go @@ -0,0 +1,222 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "fmt" + "os" + "path/filepath" + "strings" + + "git.kmalloc.org/squid/motorino/internal/content" + "git.kmalloc.org/squid/motorino/internal/site" +) + +// Options tell Build where the site is, where to write it and which version +// of motorino to put in the generator meta. +type Options struct { + // SiteDir is the folder of the site: site.json, lang/, content/, news/, + // templates/ and static/. + SiteDir string + // OutDir is the folder the HTML is written to; it is created when missing. + OutDir string + // Version is the version of motorino, shown in the generator meta. + Version string +} + +// requiredPages are the IDs every site must have in its default language, +// because the menu and the footer link to them. +var requiredPages = []string{"home", "manifesto", "people", "services", "news", "history"} + +// newsOnHome is how many news the home page lists; feedLimit is how many the feed has. +const ( + newsOnHome = 3 + feedLimit = 20 +) + +// pageKey identifies a page by its ID and language. +type pageKey struct{ id, lang string } + +// builder holds everything loaded for one build and the files it produced. +type builder struct { + opts Options + cfg site.Config + langs map[string]site.Lang + defaultLang string + pages []content.Page + posts []content.Post + categories []categoryEntry + templates map[string]string + css string + byKey map[pageKey]content.Page + // files holds the rendered output: relative path to content. + files map[string]string + // indexable holds the addresses listed in robots.txt. + indexable []string + // rendered holds the posts with their HTML, for the feed. + rendered []renderedPost + // langCtx caches the language level placeholders. + langCtx map[string]map[string]string +} + +// categoryEntry is a category with the posts that have it. +type categoryEntry struct { + content.Category + posts []content.Post +} + +// Build reads the site in opts.SiteDir and writes it to opts.OutDir. It renders +// everything in memory first, so a failure leaves the output folder untouched. +func Build(opts Options) error { + b, err := load(opts) + if err != nil { + return err + } + if err := b.renderPages(); err != nil { + return err + } + if err := b.renderPosts(); err != nil { + return err + } + if err := b.renderCategories(); err != nil { + return err + } + b.renderFeed() + b.files["robots.txt"] = robots(b.indexable) + assets, err := b.readAssets() + if err != nil { + return err + } + return b.write(assets) +} + +// load reads the configuration, the content, the templates and the style. +func load(opts Options) (*builder, error) { + cfg, langs, err := site.Load(opts.SiteDir) + if err != nil { + return nil, err + } + b := &builder{ + opts: opts, cfg: cfg, langs: langs, defaultLang: cfg.Languages[0], + byKey: map[pageKey]content.Page{}, files: map[string]string{}, langCtx: map[string]map[string]string{}, + } + if b.pages, err = content.LoadPages(opts.SiteDir, cfg.Languages); err != nil { + return nil, err + } + if b.posts, err = content.LoadPosts(opts.SiteDir); err != nil { + return nil, err + } + for _, p := range b.pages { + b.byKey[pageKey{p.ID, p.Lang}] = p + } + for _, id := range requiredPages { + if _, ok := b.byKey[pageKey{id, b.defaultLang}]; !ok { + return nil, fmt.Errorf("content/%s: there is no page with ID %q", b.defaultLang, id) + } + } + if b.templates, err = readTemplates(opts.SiteDir); err != nil { + return nil, err + } + css, err := os.ReadFile(filepath.Join(opts.SiteDir, "static", "style.css")) + if err != nil { + return nil, fmt.Errorf("read static/style.css: %w", err) + } + b.css = strings.Trim(string(css), "\n") + b.categories = groupCategories(b.posts) + return b, nil +} + +// groupCategories lists the categories of the posts, sorted by name, each with +// its posts. +func groupCategories(posts []content.Post) []categoryEntry { + _, cats := categoriesList(posts) + out := make([]categoryEntry, len(cats)) + for i, c := range cats { + out[i] = categoryEntry{Category: c, posts: postsIn(posts, c.Slug)} + } + return out +} + +// readTemplates reads every templates/**/*.html; the key is the path under +// templates/ without the extension, such as "pages/manifesto". +func readTemplates(dir string) (map[string]string, error) { + root := filepath.Join(dir, "templates") + out := map[string]string{} + err := filepath.Walk(root, func(path string, info os.FileInfo, err error) error { + if err != nil || info.IsDir() || !strings.HasSuffix(path, ".html") { + return err + } + data, err := os.ReadFile(path) + if err != nil { + return err + } + rel, err := filepath.Rel(root, path) + if err != nil { + return err + } + out[strings.TrimSuffix(filepath.ToSlash(rel), ".html")] = string(data) + return nil + }) + if err != nil { + return nil, fmt.Errorf("read templates: %w", err) + } + return out, nil +} + +// template returns a template by key or an error naming its file. +func (b *builder) template(key string) (string, error) { + t, ok := b.templates[key] + if !ok { + return "", fmt.Errorf("templates/%s.html: not found", key) + } + return t, nil +} + +// readAssets reads the files listed in site.json; a missing source is an error. +func (b *builder) readAssets() (map[string][]byte, error) { + out := map[string][]byte{} + for name, source := range b.cfg.Assets { + data, err := os.ReadFile(filepath.Join(b.opts.SiteDir, filepath.FromSlash(source))) + if err != nil { + return nil, fmt.Errorf("asset %q: %w", name, err) + } + out[name] = data + } + return out, nil +} + +// write creates the output folder and writes the pages and the assets. +func (b *builder) write(assets map[string][]byte) error { + for rel, text := range b.files { + if err := writeFile(b.opts.OutDir, rel, []byte(text)); err != nil { + return err + } + } + for rel, data := range assets { + if err := writeFile(b.opts.OutDir, rel, data); err != nil { + return err + } + } + return nil +} + +// writeFile writes data to rel under dir, creating the folders. +func writeFile(dir, rel string, data []byte) error { + path := filepath.Join(dir, filepath.FromSlash(rel)) + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + return fmt.Errorf("create %s: %w", filepath.Dir(path), err) + } + if err := os.WriteFile(path, data, 0o644); err != nil { + return fmt.Errorf("write %s: %w", path, err) + } + return nil +} + +// outputPath returns the file of an address: a folder address gets index.html. +func outputPath(address string) string { + rel := strings.TrimPrefix(address, "/") + if rel == "" || strings.HasSuffix(rel, "/") { + rel += "index.html" + } + return rel +} diff --git a/internal/build/build_test.go b/internal/build/build_test.go new file mode 100644 index 0000000..6766732 --- /dev/null +++ b/internal/build/build_test.go @@ -0,0 +1,306 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "os" + "path/filepath" + "strings" + "testing" +) + +// htmlFiles returns the relative paths of every HTML file of the output. +func htmlFiles(t *testing.T, out string) []string { + t.Helper() + var files []string + err := filepath.WalkDir(out, func(p string, d os.DirEntry, err error) error { + if err == nil && !d.IsDir() && strings.HasSuffix(p, ".html") { + rel, _ := filepath.Rel(out, p) + files = append(files, filepath.ToSlash(rel)) + } + return err + }) + if err != nil { + t.Fatal(err) + } + return files +} + +// TestBuildWritesPagesAndPaths checks that every page lands at its address. +func TestBuildWritesPagesAndPaths(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatalf("Build() error = %v", err) + } + for _, rel := range []string{ + "index.html", "it/index.html", "manifesto.html", "it/manifesto.html", "es/manifesto.html", + "manifesto-history.html", "it/cronologia-manifesto.html", "people.html", "it/persone.html", + "services.html", "it/servizi.html", "news/index.html", + } { + if _, err := os.Stat(filepath.Join(out, rel)); err != nil { + t.Errorf("missing output %s: %v", rel, err) + } + } + mustContain(t, "services.html", readOut(t, out, "services.html"), + "Services", ``, + "squid (at) kmalloc.org", ``) +} + +// TestBuildNewsPathsDated checks the address and the byline of a post. +func TestBuildNewsPathsDated(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + post := readOut(t, out, "news/2026/09/gnu-linux-day-2026.html") + mustContain(t, "post", post, + "

              GNU/Linux Day 2026

              ", ``, + "Matteo Bini", `Linux Day`, `FLUG`, + "kmalloc.org: GNU/Linux Day 2026", `people`) + readOut(t, out, "news/2026/11/shop.html") + readOut(t, out, "news/2026/11/status.html") +} + +// TestBuildCategoryPages checks the page of each category and its posts. +func TestBuildCategoryPages(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + flug := readOut(t, out, "news/category/flug.html") + mustContain(t, "flug", flug, "

              Category: FLUG

              ", "GNU/Linux Day 2026", "A shop") + if strings.Contains(flug, "Status page") { + t.Error("category FLUG lists a post that is not in it") + } + day := readOut(t, out, "news/category/linux-day.html") + mustContain(t, "linux-day", day, "GNU/Linux Day 2026") + if strings.Contains(day, "A shop") { + t.Error("category Linux Day lists a post that is not in it") + } + index := readOut(t, out, "news/index.html") + mustContain(t, "news index", index, + `FLUG (2)`, `Linux Day (1)`) +} + +// TestBuildRobotsAllowsEverything checks robots.txt and that no page asks to be +// left out of the index. +func TestBuildRobotsAllowsEverything(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + robots := readOut(t, out, "robots.txt") + mustContain(t, "robots.txt", robots, + "User-agent: *", "Allow: /$", "Allow: /?lang=en$", "Allow: /it/servizi.html$", "Allow: /news/$", + "Allow: /news/2026/11/shop.html$", "Allow: /news/category/flug.html$", "Allow: /es/manifesto.html$") + if !strings.HasSuffix(robots, "Disallow: /\n") { + t.Errorf("robots.txt does not end with Disallow: /\n%s", robots) + } + for _, rel := range htmlFiles(t, out) { + if strings.Contains(readOut(t, out, rel), `name="robots"`) { + t.Errorf("%s has a robots meta", rel) + } + } +} + +// TestBuildHreflangAndLangLinks checks the links between languages. +func TestBuildHreflangAndLangLinks(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + en := readOut(t, out, "services.html") + mustContain(t, "en services", en, + ``, ``, + `Italiano`) + it := readOut(t, out, "it/servizi.html") + mustContain(t, "it services", it, `English`) + // A page with no translation points to the home of another language. + post := readOut(t, out, "news/2026/11/shop.html") + mustContain(t, "post", post, `Italiano`) + if strings.Contains(post, `rel="alternate" hreflang`) { + t.Error("a page without translation has alternate links") + } + // The Spanish manifesto has the short header and links to its siblings. + es := readOut(t, out, "es/manifesto.html") + mustContain(t, "es manifesto", es, "Traduccion automatica.", "Traduccion de la version 1.0.", + `English`) +} + +// TestBuildMenuMarksTheCurrentPage checks aria-current on the menu. +func TestBuildMenuMarksTheCurrentPage(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + mustContain(t, "manifesto", readOut(t, out, "manifesto.html"), `Manifesto`) + mustContain(t, "post", readOut(t, out, "news/2026/11/shop.html"), `News`) + if strings.Contains(readOut(t, out, "people.html"), `aria-current="page">News`) { + t.Error("the News entry is marked on the People page") + } +} + +// TestBuildBlockPlaceholders checks the generated lists inside pages. +func TestBuildBlockPlaceholders(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + mustContain(t, "news index", readOut(t, out, "news/index.html"), + `
            • A shop: About the shop.
            • `) + home := readOut(t, out, "index.html") + mustContain(t, "home", home, `

              News

              `, `A shop`) + it := readOut(t, out, "it/index.html") + mustContain(t, "it home", it, `A shop`) + if strings.Contains(home, "{{") || strings.Contains(home, "

                ") { + t.Errorf("home has a leftover placeholder or a wrapped list:\n%s", home) + } +} + +// TestBuildNoNews checks the pages when the site has no news. +func TestBuildNoNews(t *testing.T) { + files := baseFiles() + for _, name := range []string{"news/gnu-linux-day-2026.md", "news/shop.md", "news/status.md"} { + delete(files, name) + } + out, err := runBuild(t, files) + if err != nil { + t.Fatal(err) + } + mustContain(t, "news index", readOut(t, out, "news/index.html"), "No news yet.") + if strings.Contains(readOut(t, out, "index.html"), `

                `) { + t.Error("the home shows a news section but there are no news") + } +} + +// TestBuildUnknownPlaceholderFailsAndWritesNothing checks the all-or-nothing rule. +func TestBuildUnknownPlaceholderFailsAndWritesNothing(t *testing.T) { + files := baseFiles() + files["content/en/people.md"] = page("people", "People", "", "Hello {{nope}}.\n") + out, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "content/en/people.md") || !strings.Contains(err.Error(), "nope") { + t.Fatalf("Build() error = %v, want it to name content/en/people.md and nope", err) + } + if _, statErr := os.Stat(out); statErr == nil { + entries, _ := os.ReadDir(out) + if len(entries) != 0 { + t.Errorf("the output has %d entries after a failed build", len(entries)) + } + } +} + +// TestBuildLeavesNonPlaceholders checks that text like {{.Name}} reaches the page. +func TestBuildLeavesNonPlaceholders(t *testing.T) { + files := baseFiles() + files["content/en/people.md"] = page("people", "People", "", "A template looks like `{{.Name}}`.\n") + out, err := runBuild(t, files) + if err != nil { + t.Fatal(err) + } + mustContain(t, "people", readOut(t, out, "people.html"), "{{.Name}}") +} + +// TestBuildBlockPlaceholderMustStandAlone checks the rule for generated lists. +func TestBuildBlockPlaceholderMustStandAlone(t *testing.T) { + files := baseFiles() + files["content/en/people.md"] = page("people", "People", "", "Look {{news_list}} here.\n") + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "content/en/people.md") || !strings.Contains(err.Error(), "news_list") { + t.Errorf("Build() error = %v, want it to name content/en/people.md and news_list", err) + } +} + +// TestBuildNeedsRequiredPages checks that the menu pages must exist in the default language. +func TestBuildNeedsRequiredPages(t *testing.T) { + files := baseFiles() + delete(files, "content/en/news/index.md") + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "news") { + t.Errorf("Build() error = %v, want it to name the missing news page", err) + } +} + +// TestBuildFooterPoweredBy checks the credit line on every page. +func TestBuildFooterPoweredBy(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + files := htmlFiles(t, out) + if len(files) < 12 { + t.Fatalf("only %d html files", len(files)) + } + for _, rel := range files { + mustContain(t, rel, readOut(t, out, rel), `Powered by motorino`) + } +} + +// TestBuildGeneratorMeta checks the generator meta on every page. +func TestBuildGeneratorMeta(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + for _, rel := range htmlFiles(t, out) { + mustContain(t, rel, readOut(t, out, rel), ``) + } +} + +// TestBuildManifestoLayoutRewritesEmDash checks the manifesto rewrite and its table of contents. +func TestBuildManifestoLayoutRewritesEmDash(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + m := readOut(t, out, "manifesto.html") + mustContain(t, "manifesto", m, + "

                Manifesto

                ", "Version 1.2, ", + `

                01. Antifascist

                `, `

                Our commitments

                `, + `
              • 01. Antifascist
              • `, `
              • Our commitments
              • `) + if strings.Contains(m, "—") { + t.Error("the manifesto still has an em dash") + } +} + +// TestBuildAssetsCopied checks the assets listed in site.json. +func TestBuildAssetsCopied(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + if got := readOut(t, out, "logo.svg"); got != "\n" { + t.Errorf("logo.svg = %q", got) + } +} + +// TestBuildMissingAssetFails checks that an asset that is not there stops the build. +func TestBuildMissingAssetFails(t *testing.T) { + files := baseFiles() + delete(files, "static/logo.svg") + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "static/logo.svg") { + t.Errorf("Build() error = %v, want it to name static/logo.svg", err) + } +} + +// TestBuildFeed checks the feed at the address of the news page. +func TestBuildFeed(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + feed := readOut(t, out, "news/feed.xml") + mustContain(t, "feed", feed, + "https://kmalloc.org/news/2026/11/shop.html", + `<a href="https://kmalloc.org/people.html">people</a>`) +} + +// TestBuildErrorsOnMissingTemplate checks that a missing layout template is named. +func TestBuildErrorsOnMissingTemplate(t *testing.T) { + files := baseFiles() + delete(files, "templates/pages/manifesto.html") + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "pages/manifesto") { + t.Errorf("Build() error = %v, want it to name pages/manifesto", err) + } +} diff --git a/internal/build/context.go b/internal/build/context.go new file mode 100644 index 0000000..b133f5c --- /dev/null +++ b/internal/build/context.go @@ -0,0 +1,210 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "fmt" + "strings" + + "git.kmalloc.org/squid/motorino/internal/render" +) + +// menuPages are the IDs of the pages in the menu; the current one is marked. +var menuPages = []string{"home", "manifesto", "people", "services", "news"} + +// linkedPages are the IDs the templates link to with url_. +var linkedPages = []string{"manifesto", "people", "services", "news", "history"} + +// blockNames are the placeholders that expand to generated HTML. Until they +// are expanded they stand for themselves, so a page can hold them. +var blockNames = []string{"news_list", "latest_news", "categories_list"} + +// document describes one output page for the shared page frame. +type document struct { + // lang is the language code of the page. + lang string + // id is the page ID; it is empty for news and category pages, which have + // no translation. + id string + // nav is the menu entry to mark as current; empty for none. + nav string + // lead is the footer lead template: "home", "back" or "news". + lead string + // path is the address of the page. + path string + // title is the title of the page as plain text. + title string + // prefixed puts "kmalloc.org: " before the title in the browser title. + prefixed bool + // description is the plain text of the description meta. + description string + // switches overrides the address of the language links, by language code. + switches map[string]string +} + +// copyContext returns a copy of ctx. +func copyContext(ctx map[string]string) map[string]string { + out := make(map[string]string, len(ctx)) + for k, v := range ctx { + out[k] = v + } + return out +} + +// pageAddress returns the address of the page with this ID in lang, or in the +// default language when lang has no such page. +func (b *builder) pageAddress(lang, id string) string { + if p, ok := b.byKey[pageKey{id, lang}]; ok { + return p.Path + } + return b.byKey[pageKey{id, b.defaultLang}].Path +} + +// languageContext returns the placeholders that depend on the language only: +// the site strings, the language strings (escaped), the menu labels and the +// addresses of the pages the templates link to. +func (b *builder) languageContext(lang string) map[string]string { + if cached, ok := b.langCtx[lang]; ok { + return copyContext(cached) + } + l := b.langs[lang] + ctx := copyContext(b.cfg.Strings) + for k, v := range l.Strings { + ctx[k] = render.Escape(v) + } + ctx["lang"] = lang + for k, label := range l.Nav { + ctx["nav_"+k] = render.Escape(label) + } + for _, id := range linkedPages { + ctx["url_"+id] = b.pageAddress(lang, id) + } + ctx["history_attr"] = "" + if _, ok := b.byKey[pageKey{"history", lang}]; !ok { + ctx["history_attr"] = fmt.Sprintf(` hreflang="%s"`, b.defaultLang) + } + ctx["version_lc"] = render.Escape(strings.ToLower(l.Strings["version"])) + ctx["motorino_version"] = b.opts.Version + for _, name := range blockNames { + ctx[name] = "{{" + name + "}}" + } + b.langCtx[lang] = ctx + return copyContext(ctx) +} + +// documentContext returns the placeholders of one page: the language ones plus +// the style, the address, the titles, the menu marks and the language links. +func (b *builder) documentContext(d document) map[string]string { + ctx := b.languageContext(d.lang) + ctx["css"] = b.css + ctx["path"] = d.path + docURL := b.cfg.Strings["base_url"] + d.path + ctx["doc_url"] = docURL + ctx["doc_q"] = strings.NewReplacer(":", "%3A", "/", "%2F").Replace(docURL) + title := d.title + if d.prefixed { + title = "kmalloc.org: " + title + } + ctx["title_html"] = render.Escape(title) + ctx["page_title"] = render.Escape(d.title) + ctx["description_attr"] = render.EscapeAttr(d.description) + for _, k := range menuPages { + ctx["cur_"+k] = "" + if d.nav == k { + ctx["cur_"+k] = ` aria-current="page"` + } + } + ctx["lang_links"], ctx["alt_links"] = b.languageLinks(d) + return ctx +} + +// languageLinks returns the links to the other languages for the menu and the +// alternate links for the head. A page without translations links to the home +// of the first other language that has one. +func (b *builder) languageLinks(d document) (links, alternates string) { + type target struct{ lang, path string } + var twins []target + if d.id != "" { + for _, l := range b.cfg.Languages { + if p, ok := b.byKey[pageKey{d.id, l}]; ok && l != d.lang { + twins = append(twins, target{l, p.Path}) + } + } + } + if len(twins) == 0 { + for _, l := range b.cfg.Languages { + if p, ok := b.byKey[pageKey{"home", l}]; ok && l != d.lang { + twins = append(twins, target{l, p.Path}) + break + } + } + } + anchors := make([]string, len(twins)) + for i, t := range twins { + href := t.path + if override, ok := d.switches[t.lang]; ok { + href = override + } + anchors[i] = fmt.Sprintf(`%s`, href, t.lang, t.lang, render.Escape(b.langs[t.lang].Strings["lang_name"])) + } + links = strings.Join(anchors, "\n·\n") + + if d.id == "" { + return links, "" + } + var alts []string + for _, l := range b.cfg.Languages { + if p, ok := b.byKey[pageKey{d.id, l}]; ok { + alts = append(alts, fmt.Sprintf(``, l, p.Path)) + } + } + if len(alts) > 1 { + alternates = strings.Join(alts, "\n") + } + return links, alternates +} + +// frame wraps the body of a page in the shared frame: lead, feed icon, badges, +// header, footer and the base template. It also records the page for the +// output and for robots.txt. +func (b *builder) frame(d document, ctx map[string]string, body string) error { + ctx["content"] = body + steps := []struct{ key, template string }{ + {"lead", "lead-" + d.lead}, + {"feed", "feed"}, + {"badges", "badges"}, + {"header", b.headerTemplate(d.lang)}, + {"footer", "footer"}, + } + for _, s := range steps { + tmpl, err := b.template(s.template) + if err != nil { + return err + } + text, err := render.Substitute("templates/"+s.template+".html", tmpl, ctx) + if err != nil { + return err + } + ctx[s.key] = text + } + base, err := b.template("base") + if err != nil { + return err + } + html, err := render.Substitute("templates/base.html", base, ctx) + if err != nil { + return err + } + b.files[outputPath(d.path)] = html + b.indexable = append(b.indexable, d.path) + return nil +} + +// headerTemplate returns the header template of a language: "header" unless +// its file says otherwise with the header key. +func (b *builder) headerTemplate(lang string) string { + if name := b.langs[lang].Strings["header"]; name != "" { + return name + } + return "header" +} diff --git a/internal/build/fixture_test.go b/internal/build/fixture_test.go new file mode 100644 index 0000000..cbbd0e1 --- /dev/null +++ b/internal/build/fixture_test.go @@ -0,0 +1,193 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "os" + "path/filepath" + "strings" + "testing" +) + +// writeFiles writes the files (path relative to a new directory, then content) +// and returns the directory. +func writeFiles(t *testing.T, files map[string]string) string { + t.Helper() + dir := t.TempDir() + for name, content := range files { + path := filepath.Join(dir, filepath.FromSlash(name)) + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + t.Fatal(err) + } + if err := os.WriteFile(path, []byte(content), 0o644); err != nil { + t.Fatal(err) + } + } + return dir +} + +// runBuild builds the site made of files into a fresh output folder and +// returns the folder and the build error. +func runBuild(t *testing.T, files map[string]string) (string, error) { + t.Helper() + out := filepath.Join(t.TempDir(), "public") + err := Build(Options{SiteDir: writeFiles(t, files), OutDir: out, Version: "1.2.3"}) + return out, err +} + +// readOut returns the content of a file of the output, failing the test when it +// is missing. +func readOut(t *testing.T, out, rel string) string { + t.Helper() + data, err := os.ReadFile(filepath.Join(out, filepath.FromSlash(rel))) + if err != nil { + t.Fatalf("output file %s: %v", rel, err) + } + return string(data) +} + +// mustContain fails the test for each want that is not in got. +func mustContain(t *testing.T, name, got string, wants ...string) { + t.Helper() + for _, want := range wants { + if !strings.Contains(got, want) { + t.Errorf("%s does not contain %q\n%s", name, want, got) + } + } +} + +// page returns a page file with the given ID, title, extra header lines and body. +func page(id, title, extra, body string) string { + return "Title: " + title + "\nID: " + id + "\nDescription: About " + title + ".\n" + extra + "-\n" + body +} + +// baseFiles is a small complete site: English and Italian with every page, a +// Spanish manifesto, three news with categories, templates and one asset. +func baseFiles() map[string]string { + return map[string]string{ + "site.json": `{ + "base_url": "https://kmalloc.org", + "languages": ["en", "it", "es"], + "contact": "squid@kmalloc.org", + "mastodon_url": "https://social.kmalloc.org/@squid", + "motorino_url": "https://git.kmalloc.org/squid/motorino", + "manifesto_version": "1.2", + "manifesto_date": "2026-11-14", + "issues_url": "https://git.kmalloc.org/squid/kmalloc.org/issues", + "assets": {"logo.svg": "static/logo.svg"} +}`, + "lang/en.json": `{"lang_name": "English", "sections": "Sections", "home_link": "/", "nojs": "No JavaScript.", + "powered_by": "Powered by", "back": "kmalloc.org", "version": "Version", "toc": "Contents", "history_a": "Manifesto history", + "news_p": "What is new.", "news_all": "All news", "news_empty": "No news yet.", "category_h": "Category", + "nav": {"manifesto": "Manifesto", "people": "People", "services": "Services", "news": "News"}}`, + "lang/it.json": `{"lang_name": "Italiano", "sections": "Sezioni", "home_link": "/it/", "nojs": "Niente JavaScript.", + "powered_by": "Powered by", "back": "kmalloc.org", "version": "Versione", "toc": "Indice", "history_a": "Cronologia", + "news_p": "Le novita.", "news_all": "Tutte le news", "news_empty": "Nessuna news.", "category_h": "Categoria", + "nav": {"manifesto": "Manifesto", "people": "Persone", "services": "Servizi", "news": "News"}}`, + "lang/es.json": `{"lang_name": "Espanol", "header": "header-min", "sections": "Secciones", "home_link": "/?lang=en", + "nojs": "Sin JavaScript.", "powered_by": "Powered by", "back": "kmalloc.org", "version": "Version", "toc": "Indice", + "history_a": "Historial", "translation_note": "Traduccion automatica.", "translation_note_a": "avisar", + "news_p": "x", "news_all": "x", "news_empty": "x", "category_h": "x", + "nav": {"manifesto": "Manifiesto", "news": "News"}}`, + + "content/en/index.md": page("home", "kmalloc.org", "Layout: bare\n", "

                Technology.

                \n\n{{latest_news}}\n"), + "content/en/manifesto.md": page("manifesto", "Manifesto", "Layout: manifesto\n", "## 01 — Antifascist\n\nText one.\n\n## Our commitments\n\nText two.\n"), + "content/en/manifesto-history.md": page("history", "Manifesto history", "", "Versions.\n"), + "content/en/people.md": page("people", "People", "", "## squid\n\nI run it.\n"), + "content/en/services.md": page("services", "Services", "Switch: it=/it/servizi.html\n", "Write to **{{contact_shown}}**.\n"), + "content/en/news/index.md": page("news", "News", "", "{{news_list}}\n\n{{categories_list}}\n"), + "content/it/index.md": page("home", "kmalloc.org", "Layout: bare\n", "{{latest_news}}\n"), + "content/it/manifesto.md": page("manifesto", "Manifesto", "Layout: manifesto\n", "## 01 — Antifascisti\n\nTesto.\n"), + "content/it/cronologia-manifesto.md": page("history", "Cronologia", "", "Versioni.\n"), + "content/it/persone.md": page("people", "Persone", "", "Io.\n"), + "content/it/servizi.md": page("services", "Servizi", "", "Scrivi a {{contact_shown}}.\n"), + "content/es/manifesto.md": page("manifesto", "Manifiesto", "Layout: manifesto\nNote: Traduccion de la version 1.0.\n", "## 01 — Antifascistas\n\nTexto.\n"), + + "news/gnu-linux-day-2026.md": "Title: GNU/Linux Day 2026\nAuthor: Matteo Bini\nDate: 2026-09-18T17:00:45+0200\nCategories: Linux Day, FLUG\n-\nThe programme is out. See [people](/people.html).\n", + "news/shop.md": "Title: A shop\nAuthor: squid\nDate: 2026-11-14T12:00:00+0100\nCategories: FLUG\nDescription: About the shop.\n-\nThere is a shop.\n", + "news/status.md": "Title: Status page\nDate: 2026-11-12T12:00:00+0100\n-\nThe status page.\n", + + "static/style.css": "body { margin: 0 }\n", + "static/logo.svg": "\n", + + "templates/base.html": ` + + + + +{{title_html}} + + +{{alt_links}} + + + +{{header}} + +{{content}} +{{footer}} + + +`, + "templates/header.html": `
                +home +{{nav_manifesto}} +{{nav_news}} +{{lang_links}} +
                +`, + "templates/header-min.html": `
                +{{nav_manifesto}} +{{lang_links}} +

                {{translation_note}} {{translation_note_a}}

                +
                +`, + "templates/footer.html": ` +`, + "templates/lead-home.html": "

                lead home

                \n", + "templates/lead-back.html": "

                {{back}}

                \n", + "templates/lead-news.html": "

                {{news_all}} {{back}}

                \n", + "templates/badges.html": "

                {{feed}} {{doc_q}}

                \n", + "templates/feed.html": "RSS\n", + "templates/latest-news.html": `

                {{nav_news}}

                + +
                  +{{news_items}} +
                +`, + "templates/pages/page.html": "

                {{page_title}}

                \n\n{{body}}\n", + "templates/pages/bare.html": "{{body}}\n", + "templates/pages/manifesto.html": `

                {{page_title}}

                + +

                {{version}} {{manifesto_version}},

                + +{{note_block}}

                {{toc}}

                + +
                  +{{manifesto_toc}} +
                + +{{body}} +`, + "templates/post.html": `

                {{post_title}}

                + +

                +{{post_byline}} +

                + +{{post_body}} +`, + "templates/category.html": `

                {{category_h}}: {{category_name}}

                + +{{category_posts}} +`, + } +} diff --git a/internal/build/pages.go b/internal/build/pages.go new file mode 100644 index 0000000..133da41 --- /dev/null +++ b/internal/build/pages.go @@ -0,0 +1,226 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "fmt" + "strings" + + "git.kmalloc.org/squid/motorino/internal/content" + "git.kmalloc.org/squid/motorino/internal/mdx" + "git.kmalloc.org/squid/motorino/internal/render" +) + +// renderPages renders every page of every language. +func (b *builder) renderPages() error { + for _, p := range b.pages { + if err := b.renderPage(p); err != nil { + return err + } + } + return nil +} + +// renderPage converts the body of a page to HTML, expands the generated lists, +// puts it in its layout and in the shared frame. +func (b *builder) renderPage(p content.Page) error { + d := document{ + lang: p.Lang, id: p.ID, lead: "back", path: p.Path, title: p.Title, + description: p.Description, switches: p.Switch, + } + if contains(menuPages, p.ID) { + d.nav = p.ID + } + if p.ID == "home" { + d.lead = "home" + } + ctx := b.documentContext(d) + + source := p.Body + if p.Layout == "manifesto" { + var err error + if source, err = mdx.NoEmDash(source); err != nil { + return fmt.Errorf("%s: %w", p.Source, err) + } + } + html, headings, err := b.markdown(p.Source, source, p.Lang, ctx) + if err != nil { + return err + } + ctx["body"] = html + ctx["note_block"] = "" + if p.Note != "" { + ctx["note_block"] = "

                \n" + render.Escape(p.Note) + "\n

                \n\n" + } + var toc []string + for _, h := range headings { + if h.Level == 2 { + toc = append(toc, fmt.Sprintf(`
              • %s
              • `, h.ID, render.Escape(h.Text))) + } + } + ctx["manifesto_toc"] = strings.Join(toc, "\n") + + layout, err := b.template("pages/" + p.Layout) + if err != nil { + return err + } + body, err := render.Substitute("templates/pages/"+p.Layout+".html", layout, ctx) + if err != nil { + return err + } + return b.frame(d, ctx, body) +} + +// markdown replaces the placeholders of a source, converts it to HTML and +// expands the generated lists. The name is used in error messages. +func (b *builder) markdown(name, source, lang string, ctx map[string]string) (string, []mdx.Heading, error) { + text, err := render.Substitute(name, source, ctx) + if err != nil { + return "", nil, err + } + html, headings, err := mdx.Render(text) + if err != nil { + return "", nil, fmt.Errorf("%s: %w", name, err) + } + html, err = b.expandBlocks(name, html, lang, ctx) + return html, headings, err +} + +// expandBlocks replaces each paragraph that holds only a block placeholder by +// the generated HTML. A block placeholder inside other text is an error. +func (b *builder) expandBlocks(name, html, lang string, ctx map[string]string) (string, error) { + for _, block := range blockNames { + marker := "

                {{" + block + "}}

                " + if strings.Contains(html, marker) { + generated, err := b.block(block, lang, ctx) + if err != nil { + return "", err + } + html = strings.ReplaceAll(html, marker, generated) + } + if strings.Contains(html, "{{"+block+"}}") { + return "", fmt.Errorf("%s: {{%s}} must stand alone in a paragraph", name, block) + } + } + return html, nil +} + +// block returns the HTML of a generated list. +func (b *builder) block(name, lang string, ctx map[string]string) (string, error) { + switch name { + case "news_list": + if list := newsList(b.posts, lang); list != "" { + return list, nil + } + return "

                \n" + ctx["news_empty"] + "\n

                ", nil + case "latest_news": + if len(b.posts) == 0 { + return "", nil + } + tmpl, err := b.template("latest-news") + if err != nil { + return "", err + } + with := copyContext(ctx) + with["news_items"] = latestNews(b.posts, lang, newsOnHome) + return render.Substitute("templates/latest-news.html", tmpl, with) + default: + list, _ := categoriesList(b.posts) + return list, nil + } +} + +// renderPosts renders every news item and keeps its HTML for the feed. +func (b *builder) renderPosts() error { + tmpl, err := b.template("post") + if err != nil { + return err + } + for _, p := range b.posts { + d := document{ + lang: b.defaultLang, nav: "news", lead: "news", path: p.Path, title: p.Title, + prefixed: true, description: p.Description, + } + ctx := b.documentContext(d) + html, _, err := b.markdown(p.Source, p.Body, b.defaultLang, ctx) + if err != nil { + return err + } + day := p.Date.Format(dateOnly) + ctx["post_title"] = render.Escape(p.Title) + ctx["date"] = day + ctx["post_body"] = html + ctx["post_byline"] = byline(p) + body, err := render.Substitute("templates/post.html", tmpl, ctx) + if err != nil { + return err + } + if err := b.frame(d, ctx, body); err != nil { + return err + } + b.rendered = append(b.rendered, renderedPost{Post: p, HTML: html}) + } + return nil +} + +// byline returns the author and the category links of a post, each after a +// middle dot, or an empty string when the post has neither. +func byline(p content.Post) string { + var out strings.Builder + if p.Author != "" { + out.WriteString(" · " + render.Escape(p.Author)) + } + if len(p.Categories) > 0 { + links := make([]string, len(p.Categories)) + for i, c := range p.Categories { + links[i] = fmt.Sprintf(`%s`, categoryPath(c.Slug), render.Escape(c.Name)) + } + out.WriteString(" · " + strings.Join(links, ", ")) + } + return out.String() +} + +// renderCategories renders the page of every category. +func (b *builder) renderCategories() error { + if len(b.categories) == 0 { + return nil + } + tmpl, err := b.template("category") + if err != nil { + return err + } + for _, c := range b.categories { + d := document{ + lang: b.defaultLang, nav: "news", lead: "news", path: categoryPath(c.Slug), title: c.Name, prefixed: true, + description: b.langs[b.defaultLang].Strings["category_h"] + ": " + c.Name, + } + ctx := b.documentContext(d) + ctx["category_name"] = render.Escape(c.Name) + ctx["category_posts"] = newsList(c.posts, b.defaultLang) + body, err := render.Substitute("templates/category.html", tmpl, ctx) + if err != nil { + return err + } + if err := b.frame(d, ctx, body); err != nil { + return err + } + } + return nil +} + +// renderFeed writes the feed next to the news page. +func (b *builder) renderFeed() { + newsPath := b.byKey[pageKey{"news", b.defaultLang}].Path + text := feed(b.cfg.Strings["base_url"], b.langs[b.defaultLang], newsPath, b.rendered, feedLimit) + b.files[outputPath(newsPath+"feed.xml")] = text +} + +// contains reports whether list has s. +func contains(list []string, s string) bool { + for _, item := range list { + if item == s { + return true + } + } + return false +} diff --git a/internal/build/robots.go b/internal/build/robots.go new file mode 100644 index 0000000..517b36f --- /dev/null +++ b/internal/build/robots.go @@ -0,0 +1,27 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package build + +import ( + "sort" + "strings" +) + +// robots returns robots.txt: it allows each address exactly ("$" anchors the +// end) and blocks everything else, so downloads and assets are left out. +func robots(addresses []string) string { + allow := map[string]bool{} + for _, a := range addresses { + allow["Allow: "+a+"$"] = true + if a == "/" { + // The English home as the other languages link to it. + allow["Allow: /?lang=en$"] = true + } + } + lines := make([]string, 0, len(allow)) + for line := range allow { + lines = append(lines, line) + } + sort.Strings(lines) + return "User-agent: *\n" + strings.Join(lines, "\n") + "\nDisallow: /\n" +} diff --git a/internal/mdx/mdx.go b/internal/mdx/mdx.go index d01c6a7..8d6d0e4 100644 --- a/internal/mdx/mdx.go +++ b/internal/mdx/mdx.go @@ -31,7 +31,8 @@ type Heading struct { var engine = goldmark.New(goldmark.WithRendererOptions(html.WithUnsafe())) // Render converts md to HTML and returns the headings it found. Every heading -// gets an id attribute made by Slug, with -2, -3 and so on for duplicates. +// from level 2 gets an id attribute made by Slug, with -2, -3 and so on for +// duplicates; the level 1 heading is the title of the page and gets none. func Render(md string) (string, []Heading, error) { src := []byte(md) doc := engine.Parser().Parse(text.NewReader(src)) From 2c3975430b370c36182d20b70738eb590834dece Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:51:52 +0100 Subject: [PATCH 10/13] feat: add the build and version commands --- cmd/motorino/main.go | 57 +++++++++++++++-- cmd/motorino/main_test.go | 110 +++++++++++++++++++++++++++++++++ internal/build/build.go | 23 ++++--- internal/build/fixture_test.go | 2 +- 4 files changed, 179 insertions(+), 13 deletions(-) create mode 100644 cmd/motorino/main_test.go diff --git a/cmd/motorino/main.go b/cmd/motorino/main.go index 7b4c8d5..ce40c01 100644 --- a/cmd/motorino/main.go +++ b/cmd/motorino/main.go @@ -2,21 +2,68 @@ // Command motorino builds the kmalloc.org site from Markdown, templates and // language files. +// +// Usage: +// +// motorino build [-site DIR] [-out DIR] +// motorino version package main import ( + "errors" + "flag" "fmt" + "io" "os" + "git.kmalloc.org/squid/motorino/internal/build" "git.kmalloc.org/squid/motorino/internal/version" ) +// usage is the text printed for a missing or unknown command. +const usage = "usage: motorino build [-site DIR] [-out DIR] | motorino version" + // main runs the command line and exits with its status code. func main() { - if len(os.Args) > 1 && os.Args[1] == "version" { - fmt.Println("motorino", version.String()) - return + os.Exit(run(os.Args[1:], os.Stdout, os.Stderr)) +} + +// run executes one command line and returns the exit code: 0 for success, 1 +// for a failed command and 2 for a mistake in the command line. +func run(args []string, stdout, stderr io.Writer) int { + if len(args) == 0 { + fmt.Fprintln(stderr, usage) + return 2 } - fmt.Fprintln(os.Stderr, "usage: motorino version") - os.Exit(2) + switch args[0] { + case "version": + fmt.Fprintln(stdout, "motorino", version.String()) + return 0 + case "build": + return runBuild(args[1:], stdout, stderr) + default: + fmt.Fprintf(stderr, "motorino: unknown command %q\n%s\n", args[0], usage) + return 2 + } +} + +// runBuild parses the flags of the build command and builds the site. +func runBuild(args []string, stdout, stderr io.Writer) int { + flags := flag.NewFlagSet("build", flag.ContinueOnError) + flags.SetOutput(stderr) + site := flags.String("site", ".", "the folder of the site") + out := flags.String("out", "public", "the folder the HTML is written to") + if err := flags.Parse(args); err != nil { + if errors.Is(err, flag.ErrHelp) { + return 0 + } + return 2 + } + result, err := build.Build(build.Options{SiteDir: *site, OutDir: *out, Version: version.String()}) + if err != nil { + fmt.Fprintf(stderr, "motorino: %v\n", err) + return 1 + } + fmt.Fprintf(stdout, "built %d pages into %s\n", result.Pages, *out) + return 0 } diff --git a/cmd/motorino/main_test.go b/cmd/motorino/main_test.go new file mode 100644 index 0000000..8e2ffd6 --- /dev/null +++ b/cmd/motorino/main_test.go @@ -0,0 +1,110 @@ +// SPDX-License-Identifier: GPL-3.0-or-later + +package main + +import ( + "bytes" + "os" + "path/filepath" + "strings" + "testing" +) + +// miniSite writes the smallest site that builds: every required page in one +// language and the templates the frame needs. It returns the folder. +func miniSite(t *testing.T) string { + t.Helper() + files := map[string]string{ + "site.json": `{"base_url": "https://x.org", "languages": ["en"], "mastodon_url": "m", "motorino_url": "u"}`, + "lang/en.json": `{"lang_name": "English", "home_link": "/", "back": "b", "news_all": "a", "news_p": "p", + "news_empty": "e", "nojs": "n", "history_a": "h", "version": "v", "powered_by": "P", "category_h": "c", + "nav": {"news": "News", "manifesto": "M"}}`, + "static/style.css": "body{}\n", + "templates/base.html": "{{header}}{{content}}{{footer}}\n", + "templates/header.html": "
                {{nav_news}}
                \n", + "templates/footer.html": "
                {{lead}}{{badges}}
                \n", + "templates/lead-home.html": "h\n", "templates/lead-back.html": "b\n", "templates/lead-news.html": "n\n", + "templates/badges.html": "{{feed}}\n", "templates/feed.html": "f\n", + "templates/pages/page.html": "

                {{page_title}}

                {{body}}\n", + "templates/post.html": "{{post_body}}\n", "templates/category.html": "{{category_posts}}\n", + } + for _, id := range []string{"home", "manifesto", "people", "services", "news", "history"} { + name := id + if id == "home" { + name = "index" + } + files["content/en/"+name+".md"] = "Title: " + id + "\nID: " + id + "\nDescription: d\n-\nBody of " + id + ".\n" + } + dir := t.TempDir() + for name, content := range files { + path := filepath.Join(dir, filepath.FromSlash(name)) + if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil { + t.Fatal(err) + } + if err := os.WriteFile(path, []byte(content), 0o644); err != nil { + t.Fatal(err) + } + } + return dir +} + +// TestRunVersion checks that the version command prints the name and the version. +func TestRunVersion(t *testing.T) { + var out, errOut bytes.Buffer + if code := run([]string{"version"}, &out, &errOut); code != 0 { + t.Fatalf("run(version) = %d, stderr %q", code, errOut.String()) + } + if got := strings.TrimSpace(out.String()); got != "motorino dev" { + t.Errorf("output = %q, want %q", got, "motorino dev") + } +} + +// TestRunBuildSuccess checks a build: exit 0, a summary line and the pages. +func TestRunBuildSuccess(t *testing.T) { + site := miniSite(t) + outDir := filepath.Join(t.TempDir(), "public") + var out, errOut bytes.Buffer + code := run([]string{"build", "-site", site, "-out", outDir}, &out, &errOut) + if code != 0 { + t.Fatalf("run(build) = %d, stderr %q", code, errOut.String()) + } + if want := "built 6 pages into " + outDir; !strings.Contains(out.String(), want) { + t.Errorf("output %q does not contain %q", out.String(), want) + } + if _, err := os.Stat(filepath.Join(outDir, "index.html")); err != nil { + t.Errorf("no index.html in the output: %v", err) + } +} + +// TestRunBuildErrorExit1 checks that a failed build exits 1 and says why. +func TestRunBuildErrorExit1(t *testing.T) { + var out, errOut bytes.Buffer + code := run([]string{"build", "-site", t.TempDir(), "-out", filepath.Join(t.TempDir(), "public")}, &out, &errOut) + if code != 1 { + t.Fatalf("run(build) = %d, want 1", code) + } + if !strings.HasPrefix(errOut.String(), "motorino: ") || !strings.Contains(errOut.String(), "site.json") { + t.Errorf("stderr = %q, want a line that starts with %q and names site.json", errOut.String(), "motorino: ") + } +} + +// TestRunUnknownCommand checks the usage message and exit 2. +func TestRunUnknownCommand(t *testing.T) { + for _, args := range [][]string{{}, {"frobnicate"}} { + var out, errOut bytes.Buffer + if code := run(args, &out, &errOut); code != 2 { + t.Errorf("run(%v) = %d, want 2", args, code) + } + if !strings.Contains(errOut.String(), "usage:") { + t.Errorf("run(%v) stderr = %q, want a usage line", args, errOut.String()) + } + } +} + +// TestRunBuildBadFlag checks that an unknown flag is a usage error. +func TestRunBuildBadFlag(t *testing.T) { + var out, errOut bytes.Buffer + if code := run([]string{"build", "-nope"}, &out, &errOut); code != 2 { + t.Errorf("run(build -nope) = %d, want 2", code) + } +} diff --git a/internal/build/build.go b/internal/build/build.go index cdabad4..153fabd 100644 --- a/internal/build/build.go +++ b/internal/build/build.go @@ -65,29 +65,38 @@ type categoryEntry struct { posts []content.Post } +// Result summarises a build. +type Result struct { + // Pages is the number of HTML pages written: pages, news and categories. + Pages int +} + // Build reads the site in opts.SiteDir and writes it to opts.OutDir. It renders // everything in memory first, so a failure leaves the output folder untouched. -func Build(opts Options) error { +func Build(opts Options) (Result, error) { b, err := load(opts) if err != nil { - return err + return Result{}, err } if err := b.renderPages(); err != nil { - return err + return Result{}, err } if err := b.renderPosts(); err != nil { - return err + return Result{}, err } if err := b.renderCategories(); err != nil { - return err + return Result{}, err } b.renderFeed() b.files["robots.txt"] = robots(b.indexable) assets, err := b.readAssets() if err != nil { - return err + return Result{}, err } - return b.write(assets) + if err := b.write(assets); err != nil { + return Result{}, err + } + return Result{Pages: len(b.indexable)}, nil } // load reads the configuration, the content, the templates and the style. diff --git a/internal/build/fixture_test.go b/internal/build/fixture_test.go index cbbd0e1..37a0f0c 100644 --- a/internal/build/fixture_test.go +++ b/internal/build/fixture_test.go @@ -31,7 +31,7 @@ func writeFiles(t *testing.T, files map[string]string) string { func runBuild(t *testing.T, files map[string]string) (string, error) { t.Helper() out := filepath.Join(t.TempDir(), "public") - err := Build(Options{SiteDir: writeFiles(t, files), OutDir: out, Version: "1.2.3"}) + _, err := Build(Options{SiteDir: writeFiles(t, files), OutDir: out, Version: "1.2.3"}) return out, err } From a850e9ed41c6be30bad9d0e572a00ddfa1f050fe Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:53:36 +0100 Subject: [PATCH 11/13] feat: let a heading set its own id with {#id} --- internal/mdx/mdx.go | 29 ++++++++++++++++++++++++----- internal/mdx/mdx_test.go | 17 +++++++++++++++++ 2 files changed, 41 insertions(+), 5 deletions(-) diff --git a/internal/mdx/mdx.go b/internal/mdx/mdx.go index 8d6d0e4..f79f644 100644 --- a/internal/mdx/mdx.go +++ b/internal/mdx/mdx.go @@ -11,6 +11,7 @@ import ( "github.com/yuin/goldmark" "github.com/yuin/goldmark/ast" + "github.com/yuin/goldmark/parser" "github.com/yuin/goldmark/renderer/html" "github.com/yuin/goldmark/text" ) @@ -28,11 +29,15 @@ type Heading struct { // engine converts Markdown to HTML. Raw HTML is passed through because the // pages use it for tables with data-label cells, hidden notes and the hero. -var engine = goldmark.New(goldmark.WithRendererOptions(html.WithUnsafe())) +var engine = goldmark.New( + goldmark.WithParserOptions(parser.WithHeadingAttribute()), + goldmark.WithRendererOptions(html.WithUnsafe()), +) -// Render converts md to HTML and returns the headings it found. Every heading -// from level 2 gets an id attribute made by Slug, with -2, -3 and so on for -// duplicates; the level 1 heading is the title of the page and gets none. +// Render converts md to HTML and returns the headings it found. A heading can +// set its own id with "## Title {#id}". Any other heading from level 2 gets an +// id made by Slug, with -2, -3 and so on for duplicates; the level 1 heading +// is the title of the page and gets none. func Render(md string) (string, []Heading, error) { src := []byte(md) doc := engine.Parser().Parse(text.NewReader(src)) @@ -46,7 +51,10 @@ func Render(md string) (string, []Heading, error) { } plain := plainText(h, src) id := "" - if h.Level >= 2 { + if explicit, ok := h.AttributeString("id"); ok { + id = attributeText(explicit) + used[id]++ + } else if h.Level >= 2 { id = uniqueID(Slug(plain), used) h.SetAttributeString("id", []byte(id)) } @@ -64,6 +72,17 @@ func Render(md string) (string, []Heading, error) { return out.String(), headings, nil } +// attributeText returns the text of a goldmark attribute value. +func attributeText(value any) string { + switch v := value.(type) { + case []byte: + return string(v) + case string: + return v + } + return "" +} + // uniqueID returns id, or id with a numeric suffix when it was already used. func uniqueID(id string, used map[string]int) string { used[id]++ diff --git a/internal/mdx/mdx_test.go b/internal/mdx/mdx_test.go index f60f8b6..3173977 100644 --- a/internal/mdx/mdx_test.go +++ b/internal/mdx/mdx_test.go @@ -82,6 +82,23 @@ func TestRenderTitleHasNoID(t *testing.T) { } } +// TestRenderExplicitHeadingID checks that "{#id}" after a heading sets its id +// and is not part of its text, and that other headings still get theirs. +func TestRenderExplicitHeadingID(t *testing.T) { + html, headings, err := Render("## Request an account {#account}\n\n## Other\n\n## Request an account\n") + if err != nil { + t.Fatal(err) + } + for _, want := range []string{`

                Request an account

                `, `

                Other

                `, `

                Request an account

                `} { + if !strings.Contains(html, want) { + t.Errorf("html %q does not contain %q", html, want) + } + } + if len(headings) != 3 || headings[0].ID != "account" || headings[0].Text != "Request an account" { + t.Errorf("headings = %+v", headings) + } +} + // TestRenderHeadingTextIsPlain checks that the heading text drops the markup. func TestRenderHeadingTextIsPlain(t *testing.T) { _, headings, err := Render("## Free *your* mind\n") From 0148306a6470136bb5aff79314dbd613adef497f Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 09:57:09 +0100 Subject: [PATCH 12/13] feat: let a page say which manifesto version it translates --- README.md | 2 +- internal/build/build_test.go | 11 +++++++++++ internal/build/fixture_test.go | 2 +- internal/build/pages.go | 6 ++++++ internal/content/pages.go | 7 ++++++- internal/content/pages_test.go | 14 ++++++++++++++ 6 files changed, 39 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b329962..af5a634 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ The text of the news. A news file `news/name.md` is published as `/news/YYYY/MM/name.html`, with the year and the month of `Date` as written. Every category gets a page, `/news/category/.html`. -Pages: `Title`, `ID` (the same in every language, it links the translations), `Description`, and optionally `Layout` (`page`, `bare` or `manifesto`), `Note` and `Switch`. +Pages: `Title`, `ID` (the same in every language, it links the translations), `Description`, and optionally `Layout` (`page`, `bare` or `manifesto`), `Note`, `Switch` (`lang=/path, lang=/path`, overrides the language links) and `ManifestoVersion` and `ManifestoDate` (a translation of an older manifesto says which version it translates). ### Placeholders diff --git a/internal/build/build_test.go b/internal/build/build_test.go index 6766732..f72bc87 100644 --- a/internal/build/build_test.go +++ b/internal/build/build_test.go @@ -262,6 +262,17 @@ func TestBuildManifestoLayoutRewritesEmDash(t *testing.T) { } } +// TestBuildManifestoVersionOverride checks that a translation can say which +// version of the manifesto it translates, while the other pages use the current one. +func TestBuildManifestoVersionOverride(t *testing.T) { + out, err := runBuild(t, baseFiles()) + if err != nil { + t.Fatal(err) + } + mustContain(t, "es manifesto", readOut(t, out, "es/manifesto.html"), `Version 1.0, `) + mustContain(t, "en manifesto", readOut(t, out, "manifesto.html"), `Version 1.2, `) +} + // TestBuildAssetsCopied checks the assets listed in site.json. func TestBuildAssetsCopied(t *testing.T) { out, err := runBuild(t, baseFiles()) diff --git a/internal/build/fixture_test.go b/internal/build/fixture_test.go index 37a0f0c..be54cee 100644 --- a/internal/build/fixture_test.go +++ b/internal/build/fixture_test.go @@ -101,7 +101,7 @@ func baseFiles() map[string]string { "content/it/cronologia-manifesto.md": page("history", "Cronologia", "", "Versioni.\n"), "content/it/persone.md": page("people", "Persone", "", "Io.\n"), "content/it/servizi.md": page("services", "Servizi", "", "Scrivi a {{contact_shown}}.\n"), - "content/es/manifesto.md": page("manifesto", "Manifiesto", "Layout: manifesto\nNote: Traduccion de la version 1.0.\n", "## 01 — Antifascistas\n\nTexto.\n"), + "content/es/manifesto.md": page("manifesto", "Manifiesto", "Layout: manifesto\nNote: Traduccion de la version 1.0.\nManifestoVersion: 1.0\nManifestoDate: 2026-11-12\n", "## 01 — Antifascistas\n\nTexto.\n"), "news/gnu-linux-day-2026.md": "Title: GNU/Linux Day 2026\nAuthor: Matteo Bini\nDate: 2026-09-18T17:00:45+0200\nCategories: Linux Day, FLUG\n-\nThe programme is out. See [people](/people.html).\n", "news/shop.md": "Title: A shop\nAuthor: squid\nDate: 2026-11-14T12:00:00+0100\nCategories: FLUG\nDescription: About the shop.\n-\nThere is a shop.\n", diff --git a/internal/build/pages.go b/internal/build/pages.go index 133da41..421e578 100644 --- a/internal/build/pages.go +++ b/internal/build/pages.go @@ -35,6 +35,12 @@ func (b *builder) renderPage(p content.Page) error { d.lead = "home" } ctx := b.documentContext(d) + if p.ManifestoVersion != "" { + ctx["manifesto_version"] = render.Escape(p.ManifestoVersion) + } + if p.ManifestoDate != "" { + ctx["manifesto_date"] = render.Escape(p.ManifestoDate) + } source := p.Body if p.Layout == "manifesto" { diff --git a/internal/content/pages.go b/internal/content/pages.go index 35cfba1..bc7ecea 100644 --- a/internal/content/pages.go +++ b/internal/content/pages.go @@ -28,6 +28,10 @@ type Page struct { Layout string // Switch overrides the address of the language links, by language code. Switch map[string]string + // ManifestoVersion and ManifestoDate, when set, replace the current + // manifesto version and date on this page: a translation of an older + // version says which one it translates. + ManifestoVersion, ManifestoDate string // Source is the file the page was read from, relative to the site. Source string // Body is the Markdown after the header. @@ -35,7 +39,7 @@ type Page struct { } // pageKeys are the keys a page header may have. -var pageKeys = []string{"Title", "ID", "Description", "Layout", "Note", "Switch"} +var pageKeys = []string{"Title", "ID", "Description", "Layout", "Note", "Switch", "ManifestoVersion", "ManifestoDate"} // layouts are the values of the Layout key; the first is the default. var layouts = []string{"page", "bare", "manifesto"} @@ -147,6 +151,7 @@ func loadPage(file, source, defaultLang, lang, rel string) (Page, error) { Lang: lang, ID: h.Get("ID"), Path: PagePath(defaultLang, lang, rel), Title: h.Get("Title"), Description: h.Get("Description"), Note: h.Get("Note"), Layout: layout, Switch: switches, Source: source, Body: body, + ManifestoVersion: h.Get("ManifestoVersion"), ManifestoDate: h.Get("ManifestoDate"), }, nil } diff --git a/internal/content/pages_test.go b/internal/content/pages_test.go index 3c9a4ec..8a9554f 100644 --- a/internal/content/pages_test.go +++ b/internal/content/pages_test.go @@ -69,6 +69,20 @@ func TestLoadPages(t *testing.T) { } } +// TestLoadPagesManifestoVersion checks the keys of a translation of an older manifesto. +func TestLoadPagesManifestoVersion(t *testing.T) { + dir := writeFiles(t, map[string]string{ + "content/es/m.md": "Title: M\nID: manifesto\nDescription: d\nLayout: manifesto\nManifestoVersion: 1.0\nManifestoDate: 2026-11-12\n-\nB\n", + }) + pages, err := LoadPages(dir, []string{"es"}) + if err != nil { + t.Fatal(err) + } + if len(pages) != 1 || pages[0].ManifestoVersion != "1.0" || pages[0].ManifestoDate != "2026-11-12" { + t.Errorf("pages = %+v, want ManifestoVersion 1.0 and ManifestoDate 2026-11-12", pages) + } +} + // TestLoadPagesRejectsEmDash checks that an em dash in a page is an error. func TestLoadPagesRejectsEmDash(t *testing.T) { dir := writeFiles(t, map[string]string{"content/en/x.md": pageFile("", "Words — more words.\n")}) From 1298a98f305891dc58ef23a15999c939ffb1727e Mon Sep 17 00:00:00 2001 From: tgiachi Date: Sun, 15 Nov 2026 10:03:58 +0100 Subject: [PATCH 13/13] fix: escape the title attribute, refuse clashing addresses and unsafe paths, check Switch A quote in a title broke the og:title attribute (a regression from build.py). Two sources that give the same output address now stop the build and name both, instead of one replacing the other. Asset names and sources must be paths inside the site, language codes must look like codes, and the Switch key is escaped, must point to a path and may name only listed languages. --- internal/build/build.go | 56 +++++++++++++++++++--- internal/build/build_test.go | 85 ++++++++++++++++++++++++++++++++++ internal/build/context.go | 10 ++-- internal/build/fixture_test.go | 1 + internal/build/pages.go | 9 ++-- internal/content/pages.go | 8 +++- internal/content/pages_test.go | 2 + internal/site/site.go | 42 ++++++++++++++++- internal/site/site_test.go | 27 +++++++++++ 9 files changed, 223 insertions(+), 17 deletions(-) diff --git a/internal/build/build.go b/internal/build/build.go index 153fabd..7975c88 100644 --- a/internal/build/build.go +++ b/internal/build/build.go @@ -5,7 +5,9 @@ package build import ( "fmt" "os" + "path" "path/filepath" + "sort" "strings" "git.kmalloc.org/squid/motorino/internal/content" @@ -51,6 +53,8 @@ type builder struct { byKey map[pageKey]content.Page // files holds the rendered output: relative path to content. files map[string]string + // owners names, for each output file, what produces it. + owners map[string]string // indexable holds the addresses listed in robots.txt. indexable []string // rendered holds the posts with their HTML, for the feed. @@ -87,8 +91,12 @@ func Build(opts Options) (Result, error) { if err := b.renderCategories(); err != nil { return Result{}, err } - b.renderFeed() - b.files["robots.txt"] = robots(b.indexable) + if err := b.renderFeed(); err != nil { + return Result{}, err + } + if err := b.publish("robots.txt", "robots.txt", robots(b.indexable)); err != nil { + return Result{}, err + } assets, err := b.readAssets() if err != nil { return Result{}, err @@ -107,7 +115,8 @@ func load(opts Options) (*builder, error) { } b := &builder{ opts: opts, cfg: cfg, langs: langs, defaultLang: cfg.Languages[0], - byKey: map[pageKey]content.Page{}, files: map[string]string{}, langCtx: map[string]map[string]string{}, + byKey: map[pageKey]content.Page{}, files: map[string]string{}, owners: map[string]string{}, + langCtx: map[string]map[string]string{}, } if b.pages, err = content.LoadPages(opts.SiteDir, cfg.Languages); err != nil { return nil, err @@ -117,6 +126,11 @@ func load(opts Options) (*builder, error) { } for _, p := range b.pages { b.byKey[pageKey{p.ID, p.Lang}] = p + for lang := range p.Switch { + if _, known := langs[lang]; !known { + return nil, fmt.Errorf("%s: Switch names the language %q, which is not in site.json", p.Source, lang) + } + } } for _, id := range requiredPages { if _, ok := b.byKey[pageKey{id, b.defaultLang}]; !ok { @@ -181,15 +195,45 @@ func (b *builder) template(key string) (string, error) { return t, nil } -// readAssets reads the files listed in site.json; a missing source is an error. +// claim records that source produces the output file rel, and returns an error +// naming both sources when another one already does. +func (b *builder) claim(rel, source string) error { + if other, taken := b.owners[rel]; taken { + return fmt.Errorf("%s and %s are both published as %s", other, source, rel) + } + b.owners[rel] = source + return nil +} + +// publish stores a rendered file; source names what produced it. +func (b *builder) publish(rel, source, text string) error { + if err := b.claim(rel, source); err != nil { + return err + } + b.files[rel] = text + return nil +} + +// readAssets reads the files listed in site.json; a missing source is an +// error, and so is an asset that has the address of a page or of another asset. func (b *builder) readAssets() (map[string][]byte, error) { + names := make([]string, 0, len(b.cfg.Assets)) + for name := range b.cfg.Assets { + names = append(names, name) + } + sort.Strings(names) out := map[string][]byte{} - for name, source := range b.cfg.Assets { + for _, name := range names { + source := b.cfg.Assets[name] data, err := os.ReadFile(filepath.Join(b.opts.SiteDir, filepath.FromSlash(source))) if err != nil { return nil, fmt.Errorf("asset %q: %w", name, err) } - out[name] = data + rel := path.Clean(name) + if err := b.claim(rel, fmt.Sprintf("the asset %q (%s)", name, source)); err != nil { + return nil, err + } + out[rel] = data } return out, nil } diff --git a/internal/build/build_test.go b/internal/build/build_test.go index f72bc87..b46db52 100644 --- a/internal/build/build_test.go +++ b/internal/build/build_test.go @@ -273,6 +273,91 @@ func TestBuildManifestoVersionOverride(t *testing.T) { mustContain(t, "en manifesto", readOut(t, out, "manifesto.html"), `Version 1.2, `) } +// TestBuildEscapesQuotesInTitle checks that a title with quotes cannot break +// out of an attribute such as og:title. +func TestBuildEscapesQuotesInTitle(t *testing.T) { + files := baseFiles() + files["news/quoted.md"] = "Title: A \"shop\" with \nDate: 2026-11-15T12:00:00+0100\n-\nText.\n" + out, err := runBuild(t, files) + if err != nil { + t.Fatal(err) + } + post := readOut(t, out, "news/2026/11/quoted.html") + mustContain(t, "post", post, `content="kmalloc.org: A "shop" with <mugs>"`) + if strings.Contains(post, `content="kmalloc.org: A "shop"`) { + t.Error("the title broke out of the attribute") + } +} + +// TestBuildRejectsSameAddress checks that two outputs with one address are an +// error naming both sources, instead of one silently replacing the other. +func TestBuildRejectsSameAddress(t *testing.T) { + tests := []struct { + name string + extra map[string]string + want []string + }{ + {"two pages", map[string]string{"content/en/it/index.md": page("other", "Other", "", "x\n")}, + []string{"content/en/it/index.md", "content/it/index.md"}}, + {"page and category", map[string]string{"content/en/news/category/flug.md": page("flugpage", "Flug", "", "x\n")}, + []string{"content/en/news/category/flug.md", "flug"}}, + {"page and post", map[string]string{"content/en/news/2026/11/shop.md": page("shoppage", "Shop", "", "x\n")}, + []string{"content/en/news/2026/11/shop.md", "news/shop.md"}}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + files := baseFiles() + for k, v := range tt.extra { + files[k] = v + } + _, err := runBuild(t, files) + if err == nil { + t.Fatal("Build() error = nil") + } + for _, want := range tt.want { + if !strings.Contains(err.Error(), want) { + t.Errorf("error %q does not contain %q", err, want) + } + } + }) + } +} + +// TestBuildRejectsAssetOverPage checks that an asset cannot take the address of a page. +func TestBuildRejectsAssetOverPage(t *testing.T) { + files := baseFiles() + files["site.json"] = strings.Replace(files["site.json"], `"logo.svg": "static/logo.svg"`, `"index.html": "static/logo.svg"`, 1) + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "index.html") { + t.Errorf("Build() error = %v, want it to name index.html", err) + } +} + +// TestBuildEscapesSwitchHref checks that a language switch cannot inject an attribute. +func TestBuildEscapesSwitchHref(t *testing.T) { + files := baseFiles() + files["content/en/services.md"] = page("services", "Services", "Switch: it=/x\" onmouseover=\"y\n", "Body.\n") + out, err := runBuild(t, files) + if err != nil { + t.Fatal(err) + } + got := readOut(t, out, "services.html") + mustContain(t, "services", got, `href="/x" onmouseover="y"`) + if strings.Contains(got, `onmouseover="y"`) { + t.Error("the switch value injected an attribute") + } +} + +// TestBuildRejectsSwitchToUnknownLanguage checks that a typo in Switch is not ignored. +func TestBuildRejectsSwitchToUnknownLanguage(t *testing.T) { + files := baseFiles() + files["content/en/services.md"] = page("services", "Services", "Switch: xx=/x\n", "Body.\n") + _, err := runBuild(t, files) + if err == nil || !strings.Contains(err.Error(), "content/en/services.md") || !strings.Contains(err.Error(), "xx") { + t.Errorf("Build() error = %v, want it to name content/en/services.md and xx", err) + } +} + // TestBuildAssetsCopied checks the assets listed in site.json. func TestBuildAssetsCopied(t *testing.T) { out, err := runBuild(t, baseFiles()) diff --git a/internal/build/context.go b/internal/build/context.go index b133f5c..0b4d7df 100644 --- a/internal/build/context.go +++ b/internal/build/context.go @@ -40,6 +40,8 @@ type document struct { description string // switches overrides the address of the language links, by language code. switches map[string]string + // source names what produces the page, for error messages. + source string } // copyContext returns a copy of ctx. @@ -105,7 +107,7 @@ func (b *builder) documentContext(d document) map[string]string { if d.prefixed { title = "kmalloc.org: " + title } - ctx["title_html"] = render.Escape(title) + ctx["title_html"] = render.EscapeAttr(title) ctx["page_title"] = render.Escape(d.title) ctx["description_attr"] = render.EscapeAttr(d.description) for _, k := range menuPages { @@ -145,7 +147,7 @@ func (b *builder) languageLinks(d document) (links, alternates string) { if override, ok := d.switches[t.lang]; ok { href = override } - anchors[i] = fmt.Sprintf(`%s`, href, t.lang, t.lang, render.Escape(b.langs[t.lang].Strings["lang_name"])) + anchors[i] = fmt.Sprintf(`%s`, render.EscapeAttr(href), t.lang, t.lang, render.Escape(b.langs[t.lang].Strings["lang_name"])) } links = strings.Join(anchors, "\n·\n") @@ -195,7 +197,9 @@ func (b *builder) frame(d document, ctx map[string]string, body string) error { if err != nil { return err } - b.files[outputPath(d.path)] = html + if err := b.publish(outputPath(d.path), d.source, html); err != nil { + return err + } b.indexable = append(b.indexable, d.path) return nil } diff --git a/internal/build/fixture_test.go b/internal/build/fixture_test.go index be54cee..815888e 100644 --- a/internal/build/fixture_test.go +++ b/internal/build/fixture_test.go @@ -116,6 +116,7 @@ func baseFiles() map[string]string { {{title_html}} + {{alt_links}} diff --git a/internal/build/pages.go b/internal/build/pages.go index 421e578..6de74b6 100644 --- a/internal/build/pages.go +++ b/internal/build/pages.go @@ -26,7 +26,7 @@ func (b *builder) renderPages() error { func (b *builder) renderPage(p content.Page) error { d := document{ lang: p.Lang, id: p.ID, lead: "back", path: p.Path, title: p.Title, - description: p.Description, switches: p.Switch, + description: p.Description, switches: p.Switch, source: p.Source, } if contains(menuPages, p.ID) { d.nav = p.ID @@ -145,7 +145,7 @@ func (b *builder) renderPosts() error { for _, p := range b.posts { d := document{ lang: b.defaultLang, nav: "news", lead: "news", path: p.Path, title: p.Title, - prefixed: true, description: p.Description, + prefixed: true, description: p.Description, source: p.Source, } ctx := b.documentContext(d) html, _, err := b.markdown(p.Source, p.Body, b.defaultLang, ctx) @@ -199,6 +199,7 @@ func (b *builder) renderCategories() error { d := document{ lang: b.defaultLang, nav: "news", lead: "news", path: categoryPath(c.Slug), title: c.Name, prefixed: true, description: b.langs[b.defaultLang].Strings["category_h"] + ": " + c.Name, + source: fmt.Sprintf("the page of the category %q", c.Name), } ctx := b.documentContext(d) ctx["category_name"] = render.Escape(c.Name) @@ -215,10 +216,10 @@ func (b *builder) renderCategories() error { } // renderFeed writes the feed next to the news page. -func (b *builder) renderFeed() { +func (b *builder) renderFeed() error { newsPath := b.byKey[pageKey{"news", b.defaultLang}].Path text := feed(b.cfg.Strings["base_url"], b.langs[b.defaultLang], newsPath, b.rendered, feedLimit) - b.files[outputPath(newsPath+"feed.xml")] = text + return b.publish(outputPath(newsPath+"feed.xml"), "the feed", text) } // contains reports whether list has s. diff --git a/internal/content/pages.go b/internal/content/pages.go index bc7ecea..3c6911b 100644 --- a/internal/content/pages.go +++ b/internal/content/pages.go @@ -164,10 +164,14 @@ func parseSwitch(source, value string) (map[string]string, error) { } for _, entry := range strings.Split(value, ",") { lang, target, ok := strings.Cut(strings.TrimSpace(entry), "=") - if !ok || lang == "" || target == "" { + lang, target = strings.TrimSpace(lang), strings.TrimSpace(target) + if !ok || lang == "" || !strings.HasPrefix(target, "/") { return nil, fmt.Errorf("%s: Switch entry %q is not of the form lang=/path", source, strings.TrimSpace(entry)) } - out[strings.TrimSpace(lang)] = strings.TrimSpace(target) + if _, dup := out[lang]; dup { + return nil, fmt.Errorf("%s: Switch lists the language %q twice", source, lang) + } + out[lang] = target } return out, nil } diff --git a/internal/content/pages_test.go b/internal/content/pages_test.go index 8a9554f..a42e2f9 100644 --- a/internal/content/pages_test.go +++ b/internal/content/pages_test.go @@ -128,6 +128,8 @@ func TestLoadPagesHeaderErrors(t *testing.T) { {"missing id", "Title: T\nDescription: d\n-\nB\n", "ID"}, {"bad layout", "Title: T\nID: x\nDescription: d\nLayout: fancy\n-\nB\n", "fancy"}, {"bad switch", "Title: T\nID: x\nDescription: d\nSwitch: nonsense\n-\nB\n", "Switch"}, + {"switch target without a slash", "Title: T\nID: x\nDescription: d\nSwitch: en=elsewhere\n-\nB\n", "Switch"}, + {"switch language twice", "Title: T\nID: x\nDescription: d\nSwitch: en=/a, en=/b\n-\nB\n", "Switch"}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { diff --git a/internal/site/site.go b/internal/site/site.go index 419d9e8..f610721 100644 --- a/internal/site/site.go +++ b/internal/site/site.go @@ -9,6 +9,7 @@ import ( "fmt" "os" "path/filepath" + "regexp" "strings" ) @@ -49,12 +50,15 @@ func Load(dir string) (Config, map[string]Lang, error) { if err := decodeField(raw, "site.json", "languages", &cfg.Languages); err != nil { return Config{}, nil, err } - if len(cfg.Languages) == 0 { - return Config{}, nil, fmt.Errorf("site.json: languages is empty") + if err := checkLanguages(cfg.Languages); err != nil { + return Config{}, nil, err } if err := decodeField(raw, "site.json", "assets", &cfg.Assets); err != nil { return Config{}, nil, err } + if err := checkAssets(cfg.Assets); err != nil { + return Config{}, nil, err + } for _, key := range shownKeys { if value, ok := cfg.Strings[key]; ok { cfg.Strings[key+"_shown"] = strings.ReplaceAll(value, "@", " (at) ") @@ -72,6 +76,40 @@ func Load(dir string) (Config, map[string]Lang, error) { return cfg, langs, nil } +// languageCode is the shape of a language code: "en", "pt-BR". +var languageCode = regexp.MustCompile(`^[a-z]{2,3}(-[A-Za-z0-9]+)?$`) + +// checkLanguages returns an error when the list is empty, has a code of an +// unexpected shape (the code becomes part of addresses and folders) or has a +// code twice. +func checkLanguages(codes []string) error { + if len(codes) == 0 { + return fmt.Errorf("site.json: languages is empty") + } + seen := map[string]bool{} + for _, code := range codes { + if !languageCode.MatchString(code) { + return fmt.Errorf("site.json: the language code %q is not like \"en\" or \"pt-BR\"", code) + } + if seen[code] { + return fmt.Errorf("site.json: the language %q is listed twice", code) + } + seen[code] = true + } + return nil +} + +// checkAssets returns an error for an asset whose published name or source is +// not a path inside the output folder and the site folder. +func checkAssets(assets map[string]string) error { + for name, source := range assets { + if !filepath.IsLocal(name) || !filepath.IsLocal(source) { + return fmt.Errorf("site.json: asset %q (%s): the name and the source must be paths inside the site", name, source) + } + } + return nil +} + // loadLang reads lang/.json and checks the keys every language needs. func loadLang(dir, code string) (Lang, error) { name := filepath.ToSlash(filepath.Join("lang", code+".json")) diff --git a/internal/site/site_test.go b/internal/site/site_test.go index 215a4e6..188662a 100644 --- a/internal/site/site_test.go +++ b/internal/site/site_test.go @@ -125,6 +125,33 @@ func TestLoadLanguageNeedsNameAndNav(t *testing.T) { } } +// TestLoadRejectsEscapingAssets checks that assets stay inside the site and the output. +func TestLoadRejectsEscapingAssets(t *testing.T) { + for _, assets := range []string{ + `{"../escaped.txt": "static/a"}`, `{"/abs.txt": "static/a"}`, + `{"a.txt": "../../etc/hostname"}`, `{"a.txt": "/etc/hostname"}`, + } { + files := validFiles() + files["site.json"] = `{"languages": ["en", "it"], "assets": ` + assets + `}` + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), "asset") { + t.Errorf("Load(%s) error = %v, want an error about the asset", assets, err) + } + } +} + +// TestLoadRejectsBadLanguageCodes checks the shape of the language codes. +func TestLoadRejectsBadLanguageCodes(t *testing.T) { + for _, codes := range []string{`["en", "../x"]`, `["EN"]`, `["en", "en"]`, `["en", "it/x"]`} { + files := validFiles() + files["site.json"] = `{"languages": ` + codes + `}` + _, _, err := Load(writeSite(t, files)) + if err == nil || !strings.Contains(err.Error(), "language") { + t.Errorf("Load(%s) error = %v, want an error about the language code", codes, err) + } + } +} + // TestLoadNeedsLanguages checks that an empty language list is an error. func TestLoadNeedsLanguages(t *testing.T) { files := validFiles()

    14 days