refactor: move models-transformers into tools

Author: John Doe

packages/models/project.json

@@ -21,7 +21,7 @@
       "dependsOn": [
         "^build",
         "generate-docs",
-        { "projects": "models-transformers", "target": "build" }
+        { "projects": "jsdocs-annotation-transformer", "target": "build" }
       ]
     },
     "lint": {},

packages/models/tsconfig.lib.json

@@ -3,13 +3,7 @@
   "compilerOptions": {
     "outDir": "../../dist/out-tsc",
     "declaration": true,
-    "types": ["node"],
-    "plugins": [
-      {
-        "transform": "./packages/models/transformers/dist",
-        "afterDeclarations": true
-      }
-    ]
+    "types": ["node"]
   },
   "include": ["src/**/*.ts"],
   "exclude": [

tools/jsdoc-annotation-transformer/README.md

@@ -0,0 +1,69 @@
+# @code-pushup/jsdocs-annotation-transformer
+
+TypeScript transformer plugin that automatically enhances type definitions with JSDoc comments and schema metadata.
+
+## Purpose
+
+This package provides a TypeScript compiler transformer that automatically adds JSDoc documentation to type aliases and interfaces during compilation. It's designed to improve developer experience by injecting helpful metadata and documentation links directly into generated type definitions.
+
+## How It Works
+
+The transformer hooks into the TypeScript compilation process using `ts-patch` and automatically adds JSDoc comments above type definitions. Each comment includes:
+
+- The type name
+- A description explaining the type is derived from a Zod schema
+- A link to the models reference documentation
+
+## Example
+
+Given a type definition like:
+
+```typescript
+export type Report = {
+  // ... type properties
+};
+```
+
+The transformer automatically generates:
+
+```typescript
+/**
+ * Type Definition: `Report`
+ *
+ * This type is derived from a Zod schema and represents
+ * the validated structure of `Report` used within the application.
+ *
+ * @see {@link https://github.com/code-pushup/cli/blob/main/packages/models/docs/models-reference.md#report}
+ */
+export type Report = {
+  // ... type properties
+};
+```
+
+## Usage
+
+1. ts-patch install
+
+2. Add the transformer to your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "plugins": [
+      {
+        "transform": "./packages/models/transformers/dist",
+        "afterDeclarations": true
+      }
+    ]
+  }
+}
+```
+
+3. Build your TypeScript project. The transformer will run automatically and add JSDoc comments to your type definitions.
+
+### Options
+
+| Option              | Type      | Required | Description                                                                                                                                                         |
+| ------------------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `transform`         | `string`  | Yes      | Path to the transformer module                                                                                                                                      |
+| `afterDeclarations` | `boolean` | No       | Set to `true` to run the transformer after TypeScript generates declaration files (`.d.ts`). This ensures JSDoc comments are added to the emitted type definitions. |

…es/models/transformers/eslint.config.cjs …annotation-transformer/eslint.config.cjspackages/models/transformers/eslint.config.cjs renamed to tools/jsdoc-annotation-transformer/eslint.config.cjs packages/models/transformers/eslint.config.cjs renamed to tools/jsdoc-annotation-transformer/eslint.config.cjs

@@ -1,4 +1,4 @@
-const baseConfig = require('../../../eslint.config.js').default;
+const baseConfig = require('../../eslint.config.js').default;
 
 module.exports = [
   ...baseConfig,

packages/models/transformers/package.json …sdoc-annotation-transformer/package.jsonpackages/models/transformers/package.json renamed to tools/jsdoc-annotation-transformer/package.json packages/models/transformers/package.json renamed to tools/jsdoc-annotation-transformer/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@code-pushup/models-transformers",
+  "name": "@code-pushup/jsdocs-annotation-transformer",
   "version": "0.0.0",
   "description": "TypeScript transformers enhancing models with JSDoc and schema metadata",
   "type": "commonjs",

packages/models/transformers/project.json …sdoc-annotation-transformer/project.jsonpackages/models/transformers/project.json renamed to tools/jsdoc-annotation-transformer/project.json packages/models/transformers/project.json renamed to tools/jsdoc-annotation-transformer/project.json

@@ -1,17 +1,17 @@
 {
-  "name": "models-transformers",
+  "name": "jsdoc-annotation-transformer",
   "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/models/transformers/src",
+  "sourceRoot": "tools/jsdoc-annotation-transformer/src",
   "projectType": "library",
   "targets": {
     "build": {
       "executor": "@nx/js:tsc",
       "outputs": ["{options.outputPath}"],
       "dependsOn": ["pre-build"],
       "options": {
-        "outputPath": "packages/models/transformers/dist",
-        "main": "packages/models/transformers/src/index.ts",
-        "tsConfig": "packages/models/transformers/tsconfig.lib.json"
+        "outputPath": "tools/jsdoc-annotation-transformer/dist",
+        "main": "tools/jsdoc-annotation-transformer/src/index.ts",
+        "tsConfig": "tools/jsdoc-annotation-transformer/tsconfig.lib.json"
       }
     },
     "pre-build": {

packages/models/transformers/src/index.ts …sdoc-annotation-transformer/src/index.tspackages/models/transformers/src/index.ts renamed to tools/jsdoc-annotation-transformer/src/index.ts packages/models/transformers/src/index.ts renamed to tools/jsdoc-annotation-transformer/src/index.ts

@@ -1,5 +1,5 @@
 {
-  "extends": "../../../tsconfig.base.json",
+  "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "module": "commonjs",
     "verbatimModuleSyntax": false

…els/transformers/src/lib/transformers.ts …tion-transformer/src/lib/transformers.tspackages/models/transformers/src/lib/transformers.ts renamed to tools/jsdoc-annotation-transformer/src/lib/transformers.ts packages/models/transformers/src/lib/transformers.ts renamed to tools/jsdoc-annotation-transformer/src/lib/transformers.ts

@@ -4,7 +4,8 @@
     "outDir": "./dist",
     "rootDir": "./",
     "module": "commonjs",
-    "types": ["node"]
+    "types": ["node"],
+    "esModuleInterop": true
   },
   "include": ["src/**/*.ts"]
 }