feat(tsdoc-lint): rename jsdoc-lint, switch to TSDoc-aware rules; refresh root README

BREAKING: hook id renamed jsdoc-lint -> tsdoc-lint. Consumers must update
.pre-commit-config.yaml entries. JSDoc was the wrong canonical for
TypeScript-only projects; TSDoc is the Microsoft-blessed standard
(https://tsdoc.org) consumed by tsc, VS Code, and API Extractor.

The hook now trusts the consumer's eslint config to wire tsdoc/syntax (via
eslint-plugin-tsdoc) and optionally jsdoc/require-jsdoc with TS-aware
contexts.

types_or narrows to [ts, tsx] since the hook is TypeScript-specific.

Also: full rewrite of the root README to document every hook the repo
ships (67 hooks across 14+ languages), with a dedicated section for the 16
doc-quality hooks added in v1.1.0. .gitignore picks up .yardoc/,
node_modules/, .eslintcache so locally-run hooks don't dirty the tree.

Author: Goldziher

.gitignore

@@ -27,3 +27,12 @@ target/
 
 # Test artifacts
 tests/.tmp/
+
+# Ruby YARD doc database (produced by `yard doc` / `yard stats`)
+.yardoc/
+doc/
+
+# Node / pnpm artifacts (from running tsdoc-lint locally)
+node_modules/
+pnpm-debug.log
+.eslintcache

.pre-commit-hooks.yaml

@@ -402,12 +402,12 @@
   pass_filenames: false
   args: []
 
-- id: jsdoc-lint
-  name: jsdoc-lint (JavaScript/TypeScript JSDoc linter)
-  description: Check JavaScript/TypeScript JSDoc completeness via eslint-plugin-jsdoc.
-  entry: hooks/jsdoc-lint/run.sh
+- id: tsdoc-lint
+  name: tsdoc-lint (TypeScript TSDoc linter)
+  description: Check TypeScript TSDoc completeness via eslint with eslint-plugin-tsdoc and eslint-plugin-jsdoc.
+  entry: hooks/tsdoc-lint/run.sh
   language: script
-  types_or: [javascript, jsx, ts, tsx]
+  types_or: [ts, tsx]
   pass_filenames: false
   args: []
 

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.2] - 2026-05-16
+
+### Changed
+
+- `jsdoc-lint` → `tsdoc-lint`. The hook is now TypeScript-focused and trusts
+  the consumer's eslint config to wire `tsdoc/syntax` (via
+  `eslint-plugin-tsdoc`, Microsoft's [TSDoc spec](https://tsdoc.org/)) and
+  optionally `jsdoc/require-jsdoc` (via `eslint-plugin-jsdoc`, for coverage
+  with TS-aware contexts). `types_or` narrows to `[ts, tsx]`. JSDoc was the
+  wrong canonical for TypeScript-only projects; TSDoc is the Microsoft-blessed
+  standard consumed by tsc, VS Code, and API Extractor. Hook is new in
+  v1.1.0 / fixed in v1.1.1; renaming before downstream consumers depend on
+  the old id.
+
+### Added
+
+- Root `README.md` now documents every hook the repo ships (67 hooks across
+  14+ languages), with a dedicated "Doc-quality hooks (v1.1.0+)" section
+  covering the 16 documentation-focused hooks added in v1.1.0.
+
+- `.gitignore` excludes `.yardoc/`, `doc/`, `node_modules/`, `.eslintcache`
+  so locally-run hooks don't dirty the tree.
+
 ## [1.1.1] - 2026-05-16
 
 ### Fixed

README.md

@@ -0,0 +1,69 @@
+# tsdoc-lint
+
+TypeScript TSDoc documentation linter. Invokes the consumer's `eslint` with
+[`eslint-plugin-tsdoc`](https://www.npmjs.com/package/eslint-plugin-tsdoc)
+for syntax validation per the Microsoft
+[TSDoc specification](https://tsdoc.org/), and optionally
+[`eslint-plugin-jsdoc`](https://www.npmjs.com/package/eslint-plugin-jsdoc)
+for coverage (`require-jsdoc` rule with TypeScript-aware contexts).
+
+## Category
+
+Toolchain wrapper. Trusts the consumer's eslint config to declare the relevant
+rules. If `package.json` is absent in the working directory the hook exits
+silently (no-op for non-Node projects).
+
+## Default args
+
+No default args. Runs `eslint` on positional targets, defaulting to `.` if none
+specified.
+
+## Why TSDoc, not JSDoc
+
+JSDoc was designed for vanilla JavaScript. TSDoc is the TypeScript-native
+documentation standard maintained by Microsoft and consumed by the TypeScript
+compiler, VS Code, and downstream tools such as API Extractor. For
+TypeScript-only projects, TSDoc is the canonical choice.
+
+## Consumer setup
+
+```bash
+pnpm add -D eslint eslint-plugin-tsdoc eslint-plugin-jsdoc
+```
+
+Minimal `eslint.config.js`:
+
+```js
+import tsdoc from "eslint-plugin-tsdoc";
+import jsdoc from "eslint-plugin-jsdoc";
+
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    plugins: { tsdoc, jsdoc },
+    rules: {
+      "tsdoc/syntax": "error",
+      "jsdoc/require-jsdoc": [
+        "error",
+        {
+          publicOnly: true,
+          contexts: [
+            "TSInterfaceDeclaration",
+            "TSTypeAliasDeclaration",
+            "TSEnumDeclaration",
+            "ExportNamedDeclaration",
+            "TSMethodSignature",
+            "TSPropertySignature",
+          ],
+        },
+      ],
+    },
+  },
+];
+```
+
+## Troubleshooting
+
+- Install Node.js: <https://nodejs.org/>
+- Verify `pnpm exec eslint --version` resolves in the consumer project
+- Ensure the eslint config matches the files passed by pre-commit

hooks/jsdoc-lint/README.md

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# tsdoc-lint — TypeScript TSDoc documentation linter via eslint with
+# eslint-plugin-tsdoc (syntax) and optionally eslint-plugin-jsdoc (coverage).
+#
+# Trusts the consumer's eslint config to wire `tsdoc/syntax` and any
+# `jsdoc/require-jsdoc` coverage rule. If `package.json` is absent the hook
+# exits silently (no-op for non-Node projects).
+set -euo pipefail
+
+if [[ ! -f package.json ]]; then
+  exit 0
+fi
+
+if command -v pnpm >/dev/null 2>&1; then
+  base_cmd=(pnpm exec eslint)
+elif command -v npm >/dev/null 2>&1; then
+  base_cmd=(npx --no-install eslint)
+elif command -v npx >/dev/null 2>&1; then
+  base_cmd=(npx --no-install eslint)
+else
+  printf 'kreuzberg-pre-commit-hooks: skipping tsdoc-lint — no Node package manager found on PATH.\n' >&2
+  printf '  install Node.js (https://nodejs.org/) to enable this hook.\n' >&2
+  exit 0
+fi
+
+declare -a targets=()
+for arg in "$@"; do
+  case "${arg}" in
+  -*) ;;
+  *) targets+=("${arg}") ;;
+  esac
+done
+
+if ((${#targets[@]} == 0)); then
+  targets=(.)
+fi
+
+exec "${base_cmd[@]}" "${targets[@]}"