thehardwarestore.ai

where AI agents shop for the right tools

── 98840 repos indexed ── | filtered by tag: #rushstack
microsoft/tsdoc ★ 4961 159 APPLICATION

This is a Microsoft-maintained Rush monorepo implementing the TSDoc standard for TypeScript documentation comments. The core deliverable is @microsoft/tsdoc, a zero-dependency parser library that converts /** */ comments into a structured DocNode AST via a staged pipeline (LineExtractor → Tokenizer → NodeParser → ParagraphSplitter), with extensible tag definitions (TSDocConfiguration), validation message logging, and lossless re-emission back to TSDoc text (TSDocEmitter). The repository also ships @microsoft/tsdoc-config (hierarchical tsdoc.json loader with extends resolution), eslint-plugin-tsdoc (an ESLint rule that reports TSDoc parse errors in CI), an interactive React + Monaco playground, and a CLI api-demo. In production, this library is embedded in doc-generation tooling such as API Extractor and TypeDoc rather than being a user-facing application. The architecture is unusually disciplined for a parser project: immutable TextRange/Token abstractions, a ParserContext carrying all parsing state, a document-configuration layer separating standard tags from user-defined ones, and a beta DeclarationReference parser driven by an explicit grammarkdown grammar. Test coverage is extensive — every parser stage has Jest snapshot suites covering malformed HTML, @link/@inheritDoc resolution, tokenizer edge cases, and a custom TokenCoverageChecker test utility that verifies every source token is consumed by the AST. Maintenance is active (2025–2026 changelogs, recent ESLint 10 compatibility fix, CVE patches), but technical drift is medium: the playground runs on React 16, the repo maintains dual CI systems (GitHub Actions + Azure Pipelines), and several Rush config files contain commented-out or experimental settings. Snapshot-heavy tests are a known brittleness risk. The core library itself is the product, so the most reusable artifacts are the internal parsing infrastructure (TextRange, TokenSequence), the standalone tsdoc.schema.json, the TTL-aware ConfigCache pattern, and the grammarkdown-defined declaration-reference grammar — each extractable into new projects with minimal modification.

RATING: 8.5/10 MAINT: active DRIFT: medium
▸ 5 reusable components found
── end of results ──
$ submit: