fix: add @module JSDoc tag for proper TypeDoc generation

shtse8 · shtse8 · commit 9e660b8ac886 · 2025-11-29T00:01:15.000Z
All packages now include @module tag for better documentation generation and IDE support.
diff --git a/packages/synth-c/src/index.ts b/packages/synth-c/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-c
+ * @module @sylphx/synth-c
  *
  * C parser for Synth's universal AST
  *
diff --git a/packages/synth-css/src/index.ts b/packages/synth-css/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-css
+ * @module @sylphx/synth-css
  *
  * CSS3 parser using Synth's universal AST
  * Hand-written, zero dependencies
diff --git a/packages/synth-docs/src/index.ts b/packages/synth-docs/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-docs
+ * @module @sylphx/synth-docs
  *
  * Documentation generator for Synth AST
  *
diff --git a/packages/synth-go/src/index.ts b/packages/synth-go/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-go
+ * @module @sylphx/synth-go
  *
  * Go parser using Synth's universal AST
  * Conversion layer over tree-sitter-go
diff --git a/packages/synth-graphql/src/index.ts b/packages/synth-graphql/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-graphql
+ * @module @sylphx/synth-graphql
  *
  * GraphQL parser using Synth's universal AST
  * Conversion layer over graphql-js
diff --git a/packages/synth-html/src/index.ts b/packages/synth-html/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-html
+ * @module @sylphx/synth-html
  *
  * High-performance HTML5 parser for Synth
  *
diff --git a/packages/synth-ini/src/index.ts b/packages/synth-ini/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-ini
+ * @module @sylphx/synth-ini
  *
  * INI parser using Synth's universal AST
  * Hand-written, zero dependencies
diff --git a/packages/synth-java/src/index.ts b/packages/synth-java/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-java
+ * @module @sylphx/synth-java
  *
  * Java parser for Synth's universal AST
  *
diff --git a/packages/synth-js-format/src/index.ts b/packages/synth-js-format/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-js-format
+ * @module @sylphx/synth-js-format
  *
  * Prettier-style code formatter for JavaScript/TypeScript
  *
diff --git a/packages/synth-js-minify/src/index.ts b/packages/synth-js-minify/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-js-minify
+ * @module @sylphx/synth-js-minify
  *
  * JavaScript minifier using Synth's universal AST
  *
diff --git a/packages/synth-js/src/index.ts b/packages/synth-js/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-js
+ * @module @sylphx/synth-js
  *
  * High-performance JavaScript/TypeScript parser for Synth
  *
diff --git a/packages/synth-json/src/index.ts b/packages/synth-json/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-json
+ * @module @sylphx/synth-json
  *
  * JSON parser using Synth's universal AST
  *
diff --git a/packages/synth-jsx/src/index.ts b/packages/synth-jsx/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-jsx
+ * @module @sylphx/synth-jsx
  *
  * JSX/TSX parser using Synth's universal AST
  * Conversion layer over Acorn + acorn-jsx
diff --git a/packages/synth-lint/src/index.ts b/packages/synth-lint/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-lint
+ * @module @sylphx/synth-lint
  *
  * Universal linter framework for Synth AST
  *
diff --git a/packages/synth-md-gfm/src/index.ts b/packages/synth-md-gfm/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-md-gfm
+ * @module @sylphx/synth-md-gfm
  *
  * GitHub Flavored Markdown (GFM) extensions for Synth
  *
diff --git a/packages/synth-md-katex/src/index.ts b/packages/synth-md-katex/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-md-katex
+ * @module @sylphx/synth-md-katex
  *
  * KaTeX math rendering support for Synth Markdown parser
  *
diff --git a/packages/synth-md-mermaid/src/index.ts b/packages/synth-md-mermaid/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-md-mermaid
+ * @module @sylphx/synth-md-mermaid
  *
  * Mermaid diagram support for Synth Markdown parser
  *
diff --git a/packages/synth-md/src/index.ts b/packages/synth-md/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-md
+ * @module @sylphx/synth-md
  *
  * High-performance Markdown parser - 26-42x faster than remark
  *
diff --git a/packages/synth-metrics/src/index.ts b/packages/synth-metrics/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-metrics
+ * @module @sylphx/synth-metrics
  *
  * Code metrics and complexity analysis for Synth AST
  *
diff --git a/packages/synth-msgpack/src/index.ts b/packages/synth-msgpack/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-msgpack
+ * @module @sylphx/synth-msgpack
  *
  * MessagePack parser using Synth's universal AST
  *
diff --git a/packages/synth-php/src/index.ts b/packages/synth-php/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-php
+ * @module @sylphx/synth-php
  *
  * PHP parser for Synth's universal AST
  *
diff --git a/packages/synth-protobuf/src/index.ts b/packages/synth-protobuf/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-protobuf
+ * @module @sylphx/synth-protobuf
  *
  * Protocol Buffers parser using Synth's universal AST
  *
diff --git a/packages/synth-python/src/index.ts b/packages/synth-python/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-python
+ * @module @sylphx/synth-python
  *
  * Python parser using Synth's universal AST
  * Conversion layer over tree-sitter-python
diff --git a/packages/synth-ruby/src/index.ts b/packages/synth-ruby/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-ruby
+ * @module @sylphx/synth-ruby
  *
  * Ruby parser for Synth's universal AST
  *
diff --git a/packages/synth-rust/src/index.ts b/packages/synth-rust/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-rust
+ * @module @sylphx/synth-rust
  *
  * Rust parser using Synth's universal AST
  * Conversion layer over tree-sitter-rust
diff --git a/packages/synth-sql/src/index.ts b/packages/synth-sql/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-sql
+ * @module @sylphx/synth-sql
  *
  * SQL parser using Synth's universal AST
  * Conversion layer over node-sql-parser
diff --git a/packages/synth-toml/src/index.ts b/packages/synth-toml/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-toml
+ * @module @sylphx/synth-toml
  *
  * TOML parser using Synth's universal AST
  * Hand-written, zero dependencies
diff --git a/packages/synth-typecheck/src/index.ts b/packages/synth-typecheck/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-typecheck
+ * @module @sylphx/synth-typecheck
  *
  * Type checker for Synth AST
  *
diff --git a/packages/synth-vue/src/index.ts b/packages/synth-vue/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-vue
+ * @module @sylphx/synth-vue
  *
  * Vue SFC parser using Synth's universal AST
  * Conversion layer over @vue/compiler-sfc
diff --git a/packages/synth-wasm-js/src/index.ts b/packages/synth-wasm-js/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-wasm-js
+ * @module @sylphx/synth-wasm-js
  *
  * High-performance JavaScript/TypeScript parser compiled to WebAssembly.
  * Supports ES2024 syntax.
diff --git a/packages/synth-wasm-md/src/index.ts b/packages/synth-wasm-md/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-wasm-md
+ * @module @sylphx/synth-wasm-md
  *
  * High-performance Markdown parser compiled to WebAssembly.
  *
diff --git a/packages/synth-xml/src/index.ts b/packages/synth-xml/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-xml
+ * @module @sylphx/synth-xml
  *
  * XML parser using Synth's universal AST
  * Conversion layer over fast-xml-parser
diff --git a/packages/synth-yaml/src/index.ts b/packages/synth-yaml/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth-yaml
+ * @module @sylphx/synth-yaml
  *
  * YAML parser using Synth's universal AST
  *
diff --git a/packages/synth/src/index.ts b/packages/synth/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @sylphx/synth - The world's fastest AST processor
+ * @module @sylphx/synth - The world's fastest AST processor
  *
  * Main entry point for the Synth library.
  * Exports core types, utilities, optimizations, and plugin system.

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-c`
	`2`	`+ * @module @sylphx/synth-c`
`3`	`3`	`*`
`4`	`4`	`* C parser for Synth's universal AST`
`5`	`5`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-css`
	`2`	`+ * @module @sylphx/synth-css`
`3`	`3`	`*`
`4`	`4`	`* CSS3 parser using Synth's universal AST`
`5`	`5`	`* Hand-written, zero dependencies`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-docs`
	`2`	`+ * @module @sylphx/synth-docs`
`3`	`3`	`*`
`4`	`4`	`* Documentation generator for Synth AST`
`5`	`5`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-go`
	`2`	`+ * @module @sylphx/synth-go`
`3`	`3`	`*`
`4`	`4`	`* Go parser using Synth's universal AST`
`5`	`5`	`* Conversion layer over tree-sitter-go`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-graphql`
	`2`	`+ * @module @sylphx/synth-graphql`
`3`	`3`	`*`
`4`	`4`	`* GraphQL parser using Synth's universal AST`
`5`	`5`	`* Conversion layer over graphql-js`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-html`
	`2`	`+ * @module @sylphx/synth-html`
`3`	`3`	`*`
`4`	`4`	`* High-performance HTML5 parser for Synth`
`5`	`5`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-ini`
	`2`	`+ * @module @sylphx/synth-ini`
`3`	`3`	`*`
`4`	`4`	`* INI parser using Synth's universal AST`
`5`	`5`	`* Hand-written, zero dependencies`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-java`
	`2`	`+ * @module @sylphx/synth-java`
`3`	`3`	`*`
`4`	`4`	`* Java parser for Synth's universal AST`
`5`	`5`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-js-format`
	`2`	`+ * @module @sylphx/synth-js-format`
`3`	`3`	`*`
`4`	`4`	`* Prettier-style code formatter for JavaScript/TypeScript`
`5`	`5`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/**`
`2`		`- * @sylphx/synth-js-minify`
	`2`	`+ * @module @sylphx/synth-js-minify`
`3`	`3`	`*`
`4`	`4`	`* JavaScript minifier using Synth's universal AST`
`5`	`5`	`*`