✨ Add @arethetypeswrong/cli (attw) as publish:attw

Validates the emitted .d.ts declarations against multiple TypeScript module-resolution scenarios. Same rationale as publint: it validates the publishable artifact, not the source, so it belongs in the publish: prefix, not check:. - Add publish:attw script using --profile esm-only (the package is intentionally ESM-only; CJS resolution is out of scope by design) - Add step to CI publish job, after publish:publint and before npm publish - Document the script and the esm-only rationale in project-specs.md and README.md - Add 'attw' and 'arethetypeswrong' to cspell word list - Remove unused 'stricter' word that was added speculatively before
🚚 Rename publint script to publish:publint and document prefix convention
2026-09-04 18:08:23 +02:00 · 2026-09-04 18:01:01 +02:00 · 2026-09-04 17:47:30 +02:00 · 2026-09-04 17:46:03 +02:00 · 2026-09-04 17:33:43 +02:00
8 changed files with 856 additions and 42 deletions
@@ -38,6 +38,8 @@ jobs:
                  registry-url: "https://registry.npmjs.org/"
            - run: npm ci
            - run: npm run build
+            - run: npm run publish:publint
+            - run: npm run publish:attw
            - run: npm publish --access public
              env:
                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
@@ -17,6 +17,8 @@ Pattern matching for TypeScript/ESM environments (F#-style, not regex).
 - **oxlint** — Rust-based linter.
 - **oxfmt** — Rust-based formatter (Prettier-compatible). Formats JS/TS, JSON/JSONC, YAML, Markdown, MDX, and more; built-in `package.json` key sorting replaces `sort-package-json`.
 - **cspell** — spell checking.
+- **publint** — validates `package.json` for ESM publishing correctness. Runs on publish only (in CI), not as part of `npm run check`.
+- **@arethetypeswrong/cli** (`attw`) — validates `.d.ts` declarations against multiple module-resolution scenarios. Runs on publish only with `--profile esm-only` (the package is intentionally ESM-only).
 - **lefthook** — git pre-commit hooks.

 ### Requirements
@@ -32,7 +34,16 @@ Pattern matching for TypeScript/ESM environments (F#-style, not regex).
 ## Workflows

 - Version updates via `npm version`.
- Publishing via GitHub Actions on tagged commits (see `.github/workflows/ci.yml`).
+- Publishing via GitHub Actions on tagged commits (see `.github/workflows/ci.yml`); the `publish` job runs `publish:publint` and `publish:attw` before `npm publish`.
+
+## Script prefix convention
+
+Script names follow a prefix convention that signals _when_ they run:
+
+- `check:*` — read-only verification. Aggregated by `npm run check`. Used in pre-commit hooks and CI's build job.
+- `fix:*` — mutating counterpart of `check:*`. Run individually (no `npm run fix` aggregator by design — fixes should be intentional, not batched).
+- `test:*` — test scripts. `npm run test` runs the full suite; `test:unit` / `test:ci` are scope-specific variants.
+- `publish:*` — runs only at publish time, in the CI `publish` job (immediately before `npm publish`). There is no local `npm run publish` script — publishing is CI-only by policy.

 ## Contribution guidelines

@@ -15,7 +15,10 @@
        "typescriptteam",
        "gitmoji",
        "dbaeumer",
-        "msvc"
+        "msvc",
+        "publint",
+        "attw",
+        "arethetypeswrong"
    ],
    "ignorePaths": ["dist", "node_modules", "coverage", "*.svg", ".gitignore"]
 }
@@ -9,6 +9,9 @@
            "version": "0.0.0",
            "license": "MIT",
            "devDependencies": {
+                "@arethetypeswrong/cli": "^0.18.5",
+                "@tsconfig/node26": "^26.0.1",
+                "@tsconfig/strictest": "^2.0.8",
                "@types/node": "^26.4.1",
                "c8": "^12.0.0",
                "check-outdated": "^3.0.0",
@@ -17,6 +20,7 @@
                "lefthook": "^2.1.12",
                "oxfmt": "^0.66.0",
                "oxlint": "^1.81.0",
+                "publint": "^0.3.24",
                "tslib": "^2.8.1",
                "type-fest": "^5.9.0",
                "typescript": "^7.0.2"
@@ -41,6 +45,112 @@
                "@oxlint/binding-win32-x64-msvc": "^1.81.0"
            }
        },
+        "node_modules/@andrewbranch/untar.js": {
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/@andrewbranch/untar.js/-/untar.js-1.0.4.tgz",
+            "integrity": "sha512-pVXSwPsLuw8IGLo2Di0EaOfsk+ntVvpkk942J/sHYIkwvtKUakEcPh7HBgZ6tuimgzKSEHgCvO4XgQ05DEbwDw==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@arethetypeswrong/cli": {
+            "version": "0.18.5",
+            "resolved": "https://registry.npmjs.org/@arethetypeswrong/cli/-/cli-0.18.5.tgz",
+            "integrity": "sha512-gM+8vRsQOD/Uc7EnBedUhkG5OCsDWE4uoak5QvomGpMpaky0Eh41p04nIMgrWb8EOmqZUJGc6zz9hsP6E56R7g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@arethetypeswrong/core": "0.18.5",
+                "chalk": "^4.1.2",
+                "cli-table3": "^0.6.3",
+                "commander": "^10.0.1",
+                "marked": "^9.1.2",
+                "marked-terminal": "^7.1.0",
+                "semver": "^7.5.4"
+            },
+            "bin": {
+                "attw": "dist/index.js"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/@arethetypeswrong/cli/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/@arethetypeswrong/cli/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/@arethetypeswrong/cli/node_modules/commander": {
+            "version": "10.0.1",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-10.0.1.tgz",
+            "integrity": "sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=14"
+            }
+        },
+        "node_modules/@arethetypeswrong/core": {
+            "version": "0.18.5",
+            "resolved": "https://registry.npmjs.org/@arethetypeswrong/core/-/core-0.18.5.tgz",
+            "integrity": "sha512-9ytjzGwxjm9Uz7I9avfbt5vlQt6uk9uRRESzJjqrznl6WKvI6dwYTo+vJ3U02Wrq/mR3iql/PzhvHhKdJIAjDQ==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@andrewbranch/untar.js": "^1.0.3",
+                "@loaderkit/resolve": "^1.0.2",
+                "cjs-module-lexer": "^1.2.3",
+                "fflate": "^0.8.3",
+                "lru-cache": "^11.0.1",
+                "semver": "^7.5.4",
+                "typescript": "5.6.1-rc",
+                "validate-npm-package-name": "^5.0.0"
+            },
+            "engines": {
+                "node": ">=20"
+            }
+        },
+        "node_modules/@arethetypeswrong/core/node_modules/typescript": {
+            "version": "5.6.1-rc",
+            "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.6.1-rc.tgz",
+            "integrity": "sha512-E3b2+1zEFu84jB0YQi9BORDjz9+jGbwwy1Zi3G0LUNw7a7cePUrHMRNy8aPh53nXpkFGVHSxIZo5vKTfYaFiBQ==",
+            "dev": true,
+            "license": "Apache-2.0",
+            "bin": {
+                "tsc": "bin/tsc",
+                "tsserver": "bin/tsserver"
+            },
+            "engines": {
+                "node": ">=14.17"
+            }
+        },
        "node_modules/@bcoe/v8-coverage": {
            "version": "1.0.2",
            "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-1.0.2.tgz",
@@ -51,6 +161,24 @@
                "node": ">=18"
            }
        },
+        "node_modules/@braidai/lang": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/@braidai/lang/-/lang-1.1.2.tgz",
+            "integrity": "sha512-qBcknbBufNHlui137Hft8xauQMTZDKdophmLFv05r2eNmdIv/MlPuP4TdUknHG68UdWLgVZwgxVe735HzJNIwA==",
+            "dev": true,
+            "license": "ISC"
+        },
+        "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/@cspell/cspell-bundled-dicts": {
            "version": "10.2.1",
            "resolved": "https://registry.npmjs.org/@cspell/cspell-bundled-dicts/-/cspell-bundled-dicts-10.2.1.tgz",
@@ -718,6 +846,16 @@
                "@jridgewell/sourcemap-codec": "^1.4.14"
            }
        },
+        "node_modules/@loaderkit/resolve": {
+            "version": "1.0.6",
+            "resolved": "https://registry.npmjs.org/@loaderkit/resolve/-/resolve-1.0.6.tgz",
+            "integrity": "sha512-G8FdIoF5CypfwmD9rl8BXod5HDn8JqB0CCNBXDTaRZ+yRYhARrrSToX1zg1zy9jX3zLqigsELwhT4gNtkdQAUg==",
+            "dev": true,
+            "license": "ISC",
+            "dependencies": {
+                "@braidai/lang": "^1.0.0"
+            }
+        },
        "node_modules/@oxfmt/binding-android-arm-eabi": {
            "version": "0.66.0",
            "resolved": "https://registry.npmjs.org/@oxfmt/binding-android-arm-eabi/-/binding-android-arm-eabi-0.66.0.tgz",
@@ -1398,6 +1536,49 @@
                "node": "^20.19.0 || >=22.12.0"
            }
        },
+        "node_modules/@publint/pack": {
+            "version": "0.1.7",
+            "resolved": "https://registry.npmjs.org/@publint/pack/-/pack-0.1.7.tgz",
+            "integrity": "sha512-4EDEmvxWtgsCnnVeBvtFIFZtUhPPt1+bA9JrSwU4Sa//6oKtzCSlGGXYJr44OD9aGISymbieJ4mCKHUygUDU+g==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "tinyexec": "^1.3.0"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "funding": {
+                "url": "https://bjornlu.com/sponsor"
+            }
+        },
+        "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/@tsconfig/node26": {
+            "version": "26.0.1",
+            "resolved": "https://registry.npmjs.org/@tsconfig/node26/-/node26-26.0.1.tgz",
+            "integrity": "sha512-NQT8JUFDKeAIWpR1dakeF534msQAsoSLr1WpKdRDt3sCvk2fsFK3EVKUBG5xKYVamiRO6yTfniiyvCaqOGgn/g==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/@tsconfig/strictest": {
+            "version": "2.0.8",
+            "resolved": "https://registry.npmjs.org/@tsconfig/strictest/-/strictest-2.0.8.tgz",
+            "integrity": "sha512-XnQ7vNz5HRN0r88GYf1J9JJjqtZPiHt2woGJOo2dYqyHGGcd6OLGqSlBB6p1j9mpzja6Oe5BoPqWmeDx6X9rLw==",
+            "dev": true,
+            "license": "MIT"
+        },
        "node_modules/@types/istanbul-lib-coverage": {
            "version": "2.0.6",
            "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz",
@@ -1755,6 +1936,22 @@
                "node": ">=16.20.0"
            }
        },
+        "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.3.0",
            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz",
@@ -1781,6 +1978,13 @@
                "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/array-timsort": {
            "version": "1.0.3",
            "resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz",
@@ -1874,6 +2078,16 @@
                "url": "https://github.com/chalk/chalk-template?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/check-outdated": {
            "version": "3.0.0",
            "resolved": "https://registry.npmjs.org/check-outdated/-/check-outdated-3.0.0.tgz",
@@ -1887,6 +2101,233 @@
                "node": ">=10.0.0"
            }
        },
+        "node_modules/cjs-module-lexer": {
+            "version": "1.4.3",
+            "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.3.tgz",
+            "integrity": "sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "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-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/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/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/cli-highlight/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/cli-highlight/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/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/cli-table3/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/cli-table3/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/cli-table3/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/cli-table3/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/cliui": {
            "version": "9.0.1",
            "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
@@ -1920,6 +2361,26 @@
                "url": "https://github.com/sponsors/sindresorhus"
            }
        },
+        "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/commander": {
            "version": "15.0.0",
            "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz",
@@ -2170,6 +2631,13 @@
            "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-paths": {
            "version": "4.0.0",
            "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-4.0.0.tgz",
@@ -2186,6 +2654,19 @@
                "url": "https://github.com/sponsors/sindresorhus"
            }
        },
+        "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/escalade": {
            "version": "3.2.0",
            "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
@@ -2255,6 +2736,13 @@
                }
            }
        },
+        "node_modules/fflate": {
+            "version": "0.8.3",
+            "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz",
+            "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==",
+            "dev": true,
+            "license": "MIT"
+        },
        "node_modules/find-up": {
            "version": "5.0.0",
            "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
@@ -2373,6 +2861,16 @@
                "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/html-escaper": {
            "version": "2.0.2",
            "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
@@ -2414,6 +2912,16 @@
                "node": "^20.17.0 || >=22.9.0"
            }
        },
+        "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-safe-filename": {
            "version": "0.1.1",
            "resolved": "https://registry.npmjs.org/is-safe-filename/-/is-safe-filename-0.1.1.tgz",
@@ -2678,6 +3186,41 @@
                "url": "https://github.com/sponsors/sindresorhus"
            }
        },
+        "node_modules/marked": {
+            "version": "9.1.6",
+            "resolved": "https://registry.npmjs.org/marked/-/marked-9.1.6.tgz",
+            "integrity": "sha512-jcByLnIFkd5gSXZmjNvS1TlmRhCXZjIzHYlaGkPlLIekG55JDR2Z4va9tZwCiP+/RDERiNhMOFu01xd6O5ct1Q==",
+            "dev": true,
+            "license": "MIT",
+            "bin": {
+                "marked": "bin/marked.js"
+            },
+            "engines": {
+                "node": ">= 16"
+            }
+        },
+        "node_modules/marked-terminal": {
+            "version": "7.3.0",
+            "resolved": "https://registry.npmjs.org/marked-terminal/-/marked-terminal-7.3.0.tgz",
+            "integrity": "sha512-t4rBvPsHc57uE/2nJOLmMbZCQ4tgAccAED3ngXQqW6g+TxA488JzJ+FK3lQkzBQOI1mRV/r/Kq+1ZlJ4D0owQw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "ansi-escapes": "^7.0.0",
+                "ansi-regex": "^6.1.0",
+                "chalk": "^5.4.1",
+                "cli-highlight": "^2.1.11",
+                "cli-table3": "^0.6.5",
+                "node-emoji": "^2.2.0",
+                "supports-hyperlinks": "^3.1.0"
+            },
+            "engines": {
+                "node": ">=16.0.0"
+            },
+            "peerDependencies": {
+                "marked": ">=1 <16"
+            }
+        },
        "node_modules/minimatch": {
            "version": "10.2.6",
            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
@@ -2704,6 +3247,54 @@
                "node": ">=16 || 14 >=14.17"
            }
        },
+        "node_modules/mri": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/mri/-/mri-1.2.0.tgz",
+            "integrity": "sha512-tzzskb3bG8LvYGFF/mDTpq3jpI6Q9wc3LEmBaghu+DdCssd1FakN7Bc0hVNmEyGq1bq3RgfkCb3cmQLpNPOroA==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "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/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/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/oxfmt": {
            "version": "0.66.0",
            "resolved": "https://registry.npmjs.org/oxfmt/-/oxfmt-0.66.0.tgz",
@@ -2837,6 +3428,37 @@
                "url": "https://github.com/sponsors/sindresorhus"
            }
        },
+        "node_modules/package-manager-detector": {
+            "version": "1.8.0",
+            "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.8.0.tgz",
+            "integrity": "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==",
+            "dev": true,
+            "license": "MIT"
+        },
+        "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": "4.0.0",
            "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -2874,6 +3496,13 @@
                "url": "https://github.com/sponsors/isaacs"
            }
        },
+        "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": "4.0.7",
            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
@@ -2887,6 +3516,38 @@
                "url": "https://github.com/sponsors/jonschlinkert"
            }
        },
+        "node_modules/publint": {
+            "version": "0.3.24",
+            "resolved": "https://registry.npmjs.org/publint/-/publint-0.3.24.tgz",
+            "integrity": "sha512-9zS56KrKBoqi5Qt8h92uMP8TTM9AYZSgnmCo4u2priMqkOZvQnTsziZ2p5LJ2ywbYkAjoCDp2jda9u4cgFefIw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "@publint/pack": "^0.1.7",
+                "package-manager-detector": "^1.8.0",
+                "picocolors": "^1.1.1",
+                "sade": "^1.8.1"
+            },
+            "bin": {
+                "publint": "src/cli.js"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "funding": {
+                "url": "https://bjornlu.com/sponsor"
+            }
+        },
+        "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",
@@ -2897,6 +3558,19 @@
                "node": ">=8"
            }
        },
+        "node_modules/sade": {
+            "version": "1.8.1",
+            "resolved": "https://registry.npmjs.org/sade/-/sade-1.8.1.tgz",
+            "integrity": "sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "mri": "^1.1.0"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
        "node_modules/semver": {
            "version": "7.8.5",
            "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
@@ -2946,6 +3620,19 @@
                "url": "https://github.com/sponsors/isaacs"
            }
        },
+        "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/smol-toml": {
            "version": "1.8.0",
            "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz",
@@ -3005,6 +3692,23 @@
                "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",
@@ -3033,6 +3737,39 @@
                "node": "20 || >=22"
            }
        },
+        "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/tinyexec": {
+            "version": "1.3.1",
+            "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.1.tgz",
+            "integrity": "sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            }
+        },
        "node_modules/tinyglobby": {
            "version": "0.2.17",
            "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
@@ -3125,6 +3862,16 @@
            "dev": true,
            "license": "MIT"
        },
+        "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/v8-to-istanbul": {
            "version": "9.3.0",
            "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz",
@@ -3140,6 +3887,16 @@
                "node": ">=10.12.0"
            }
        },
+        "node_modules/validate-npm-package-name": {
+            "version": "5.0.1",
+            "resolved": "https://registry.npmjs.org/validate-npm-package-name/-/validate-npm-package-name-5.0.1.tgz",
+            "integrity": "sha512-OljLrQ9SQdOUqTaQxqL5dEfZWrXExyyWsozYlAWFawPVNuD83igl7uJD2RTkNMbniIYgt8l81eCJGIdQF7avLQ==",
+            "dev": true,
+            "license": "ISC",
+            "engines": {
+                "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+            }
+        },
        "node_modules/vscode-languageserver-textdocument": {
            "version": "1.0.14",
            "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.14.tgz",
@@ -13,7 +13,7 @@
    "license": "MIT",
    "repository": {
        "type": "git",
-        "url": "https://github.com/tmueller/tiny-pattern-ts.git"
+        "url": "git+https://github.com/tmueller/tiny-pattern-ts.git"
    },
    "files": [
        "dist",
@@ -35,7 +35,7 @@
    },
    "scripts": {
        "build": "tsc -p tsconfig.build.json",
-        "check": "npm run check:oxlint && npm run check:oxfmt && npm run check:tsc && npm run check:cspell && npm run check:outdated",
+        "check": "npm run check:tsc && npm run check:oxlint && npm run check:oxfmt && npm run check:cspell && npm run check:outdated",
        "check:cspell": "cspell lint ${LEFTHOOK_FILES:-.}",
        "check:outdated": "check-outdated --ignore-pre-releases --ignore-packages @oxfmt/binding-darwin-arm64,@oxfmt/binding-darwin-x64,@oxfmt/binding-linux-arm64-gnu,@oxfmt/binding-linux-arm64-musl,@oxfmt/binding-linux-x64-gnu,@oxfmt/binding-linux-x64-musl,@oxfmt/binding-win32-x64-msvc,@oxlint/binding-darwin-arm64,@oxlint/binding-darwin-x64,@oxlint/binding-linux-arm64-gnu,@oxlint/binding-linux-arm64-musl,@oxlint/binding-linux-x64-gnu,@oxlint/binding-linux-x64-musl,@oxlint/binding-win32-x64-msvc",
        "check:oxfmt": "oxfmt --check ${LEFTHOOK_FILES:-.}",
@@ -44,12 +44,17 @@
        "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
        "fix:oxfmt": "oxfmt ${LEFTHOOK_FILES:-.}",
        "fix:oxlint": "oxlint --fix src",
-        "test": "npm run check:tsc && node --test --strip-types src/",
-        "test:ci": "c8 --reporter=text --reporter=lcov --reporter=html node --test --strip-types src/",
-        "test:unit": "node --test --strip-types src/",
+        "test": "npm run check:tsc && node --test --strip-types \"src/**/*.test.ts\"",
+        "test:ci": "c8 --reporter=text --reporter=lcov --reporter=html node --test --strip-types \"src/**/*.test.ts\"",
+        "test:unit": "node --test --strip-types \"src/**/*.test.ts\"",
+        "publish:attw": "attw . --pack --profile esm-only",
+        "publish:publint": "publint",
        "use:git-commit-message": "cp commit-message-template .git/COMMIT_EDITMSG || true"
    },
    "devDependencies": {
+        "@arethetypeswrong/cli": "^0.18.5",
+        "@tsconfig/node26": "^26.0.1",
+        "@tsconfig/strictest": "^2.0.8",
        "@types/node": "^26.4.1",
        "c8": "^12.0.0",
        "check-outdated": "^3.0.0",
@@ -58,6 +63,7 @@
        "lefthook": "^2.1.12",
        "oxfmt": "^0.66.0",
        "oxlint": "^1.81.0",
+        "publint": "^0.3.24",
        "tslib": "^2.8.1",
        "type-fest": "^5.9.0",
        "typescript": "^7.0.2"
@@ -80,5 +86,8 @@
    },
    "engines": {
        "node": ">=26"
+    },
+    "allowScripts": {
+        "lefthook@2.1.12": true
    }
 }
@@ -157,14 +157,47 @@ typescript-lib-starter-tiny => https://github.com/tmueller/typescript-lib-starte

 ## 5. Scripts

+### PREFIX CONVENTION
+
+Script names use a prefix that signals _when_ the script is intended
+to run. A `<prefix>:<name>` script is implicitly aggregated by a
+`<prefix>` script (if one exists) and run by the corresponding
+lefthook hook or CI step. Picking the right prefix documents the
+script's intended lifecycle:
+
+- `check:*` — read-only verification. Aggregated by `npm run check`
+  (which runs all `check:*` scripts in order). Called from the
+  lefthook pre-commit hook on staged files, and from the CI build
+  job on the full project. Read-only; never modifies files.
+- `fix:*` — mutating counterpart of a `check:*` script. There is
+  **no** `npm run fix` aggregator by design: fixes should be
+  intentional, not batched. Run individually.
+- `test:*` — test scripts. `npm run test` is the canonical entry
+  point (`check:tsc` + unit tests); `test:unit` skips the typecheck
+  for fast local iteration; `test:ci` adds c8 coverage and is the
+  CI variant.
+- `publish:*` — runs only at publish time, in the CI `publish` job
+  (immediately before `npm publish`). There is **no** local
+  `npm run publish` script — publishing is CI-only by policy (see
+  §7). The `publish:` prefix still documents intent: this script
+  validates the _publishable artifact_ (e.g., `dist/`) rather than
+  the source.
+
+A new script should pick the prefix that matches its lifecycle, not
+invent a new one. If no existing prefix fits, that is a signal the
+script does not belong in the standard pipeline.
+
 ### SETUP

 - `use:git-commit-message`: Set up commit message template (if needed).

 ### TEST

- `test`: Run `tsc --noEmit` then `node --test --strip-types src/`.
- `test:unit`: Run unit tests with `node --test --strip-types src/`
+- `test`: Run `check:tsc` then `node --test --strip-types "src/**/*.test.ts"`.
+  The glob is required because Node 26 does not auto-discover test
+  files in a bare directory argument (`node --test src/` is
+  interpreted as a module path on Node 26+).
+- `test:unit`: Run unit tests with `node --test --strip-types "src/**/*.test.ts"`
  (no preceding typecheck).
 - `test:ci`: Run tests in CI mode with c8 coverage (text + lcov + html
  reporters), uploading `coverage/` as an artifact.
@@ -216,6 +249,24 @@ typescript-lib-starter-tiny => https://github.com/tmueller/typescript-lib-starte
  (There is no `fix` aggregator in the scripts; run the `fix:*` scripts
  individually.)

+### PUBLISH
+
+- `publish:publint`: `publint` — runs the pack-and-lint flow against
+  the current project (uses `npm pack` to validate the actual
+  publishable artifact against `package.json`'s `files`, `exports`,
+  `main`, etc.). Requires a fresh `build` to have populated `dist/`.
+  Called by the CI `publish` job immediately before `npm publish`
+  (see §6). Not part of `npm run check` and not run on commit:
+  it validates publishing correctness, not source correctness.
+- `publish:attw`: `attw . --pack --profile esm-only` — validates the
+  emitted `.d.ts` declarations against multiple TypeScript
+  module-resolution scenarios. Uses `--profile esm-only` because
+  this package is intentionally ESM-only (no CommonJS shim); CJS
+  resolution scenarios are explicitly out of scope by design, not
+  a bug. Called by the CI `publish` job alongside `publish:publint`
+  and `npm publish` (see §6). Not part of `npm run check` and not
+  run on commit: same rationale as `publish:publint`.
+
 ### HOOKS

 - Lefthook runs the relevant `check:*` scripts on staged files in
@@ -235,7 +286,9 @@ typescript-lib-starter-tiny => https://github.com/tmueller/typescript-lib-starte
    - `publish` job: only on `refs/tags/*`, depends on `build`. Steps:
      `actions/checkout@v4`, `actions/setup-node@v4` (with
      `node-version-file: .node-version` and `registry-url`),
-      `npm ci`, `npm run build`, `npm publish --access public`
+      `npm ci`, `npm run build`, `npm run publish:publint` (see
+      §5 for why this is `publish:` and not `check:`),
+      `npm run publish:attw`, and `npm publish --access public`
      with `NODE_AUTH_TOKEN` from secrets.

 ## 7. Versioning & Publishing
@@ -2,8 +2,14 @@
    "extends": "./tsconfig.json",
    "compilerOptions": {
        "noEmit": false,
+        "target": "es2024",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "outDir": "dist",
        "rewriteRelativeImportExtensions": true,
        "rootDir": "src"
    },
+    "include": ["src"],
    "exclude": ["src/**/*.test.ts", "src/**/__tests__/**"]
 }
@@ -1,39 +1,12 @@
 {
+    "extends": [
+        "@tsconfig/node26/tsconfig.json",
+        "@tsconfig/strictest/tsconfig.json"
+    ],
    "compilerOptions": {
        "noEmit": true,
-        "target": "es2024",
-        "module": "nodenext",
-        "moduleResolution": "nodenext",
-        "moduleDetection": "force",
-        "lib": ["es2024"],
-        "skipLibCheck": true,
-        "strict": true,
-        "noImplicitAny": true,
-        "noImplicitThis": true,
-        "alwaysStrict": true,
-        "strictNullChecks": true,
-        "strictFunctionTypes": true,
-        "strictBindCallApply": true,
-        "strictPropertyInitialization": true,
-        "noImplicitReturns": true,
-        "noFallthroughCasesInSwitch": true,
-        "noUncheckedIndexedAccess": true,
-        "noImplicitOverride": true,
-        "forceConsistentCasingInFileNames": true,
-        "noUnusedLocals": true,
-        "noUnusedParameters": true,
-        "isolatedModules": true,
-        "verbatimModuleSyntax": true,
        "allowImportingTsExtensions": true,
-        "declaration": true,
-        "declarationMap": true,
-        "sourceMap": true,
-        "outDir": "dist",
-        "esModuleInterop": true,
-        "allowSyntheticDefaultImports": true,
-        "resolveJsonModule": true,
-        "composite": false,
-        "types": ["node"]
+        "verbatimModuleSyntax": true
    },
    "include": ["src"]
 }
Author	SHA1	Message	Date
tmu	3fa72820df	✨ Add @arethetypeswrong/cli (attw) as publish:attw Validates the emitted .d.ts declarations against multiple TypeScript module-resolution scenarios. Same rationale as publint: it validates the publishable artifact, not the source, so it belongs in the publish: prefix, not check:. - Add publish:attw script using --profile esm-only (the package is intentionally ESM-only; CJS resolution is out of scope by design) - Add step to CI publish job, after publish:publint and before npm publish - Document the script and the esm-only rationale in project-specs.md and README.md - Add 'attw' and 'arethetypeswrong' to cspell word list - Remove unused 'stricter' word that was added speculatively before	2026-09-04 18:08:23 +02:00
tmu	01d1084e1f	🚚 Rename publint script to publish:publint and document prefix convention publint validates the publishable artifact (dist/ vs package.json), not the source. It should run only at publish time, in the CI publish job, not on every commit. - Rename check:publint -> publish:publint - Remove from 'check' chain - Add 'publish:publint' as a step in the CI publish job, right before 'npm publish' - Introduce a 'publish:' script prefix for publish-time-only scripts - Document the prefix convention (check:, fix:, test:, publish:) in project-specs.md (as a top-level subsection under Scripts) and in the README - Add 'publint' and 'stricter' to cspell word list A new script should pick the prefix that matches its lifecycle, not invent a new one. The 'publish:' prefix has no 'npm run publish' aggregator by design (publishing is CI-only).	2026-09-04 18:01:01 +02:00
tmu	24a3880aad	🐛 Fix test scripts: Node 26 doesn't auto-discover tests in directory args node --test src/ on Node 26+ treats src/ as a module path, not as a directory to scan for test files, producing a 'Cannot find module' error. Switch the test scripts to an explicit glob that lists all *.test.ts files under src/. Affects test, test:ci, test:unit.	2026-09-04 17:47:30 +02:00
tmu	7de4604ab4	♻️ Move emit-only options from tsconfig.json to tsconfig.build.json - Build-only options (target, declaration*, sourceMap, outDir) live in the build config where they belong - Drop redundant options (composite: false is the default; allowSyntheticDefaultImports is implied by esModuleInterop; resolveJsonModule is unused) - Drop lib override to inherit es2025+ libs from @tsconfig/node26 - Add explicit include to tsconfig.build.json (include is not inherited via extends, only exclude was carrying the file selection by accident)	2026-09-04 17:46:03 +02:00
tmu	b649013d1c	✨ Extend tsconfig from @tsconfig/node26 and @tsconfig/strictest - Replace hand-rolled strict flags with @tsconfig/strictest - Pick up Node 26 module/lib/target from @tsconfig/node26 - Add exactOptionalPropertyTypes (the main strictness gain) - Pin target to es2024 to remain conservative for the published build	2026-09-04 17:33:43 +02:00