refactor: add task derivation for build

Author: John Doe

tools/build-target/README.md

@@ -0,0 +1,46 @@
+# build-target
+
+An Nx plugin that automatically creates `build` targets for projects with a `tsconfig.lib.json` file.
+
+## Overview
+
+This plugin detects `tsconfig.lib.json` files in your workspace and automatically generates a `build` target for those
+projects. The build target uses the `@nx/js:tsc` executor to compile TypeScript libraries.
+
+## Quick Start
+
+### Using the Nx Plugin
+
+The plugin is already registered in your `nx.json`:
+
+```jsonc
+{
+  "plugins": ["./tools/build-target/src/build-target.plugin.ts"],
+}
+```
+
+Added target
+
+```json
+{
+  "projects": {
+    "your-project-name": {
+      "targets": {
+        "build": {
+          "dependsOn": ["^build"],
+          "inputs": ["production", "^production"],
+          "cache": true,
+          "outputs": ["{options.outputPath}"],
+          "executor": "@nx/js:tsc",
+          "options": {
+            "outputPath": "{projectRoot}/dist",
+            "main": "{projectRoot}/src/index.ts",
+            "tsConfig": "{ projectRoot}/tsconfig.lib.json",
+            "assets": ["{projectRoot}/*.md"]
+          }
+        }
+      }
+    }
+  }
+}
+```

tools/build-target/eslint.config.js

@@ -0,0 +1,11 @@
+const baseConfig = require('../../eslint.config.js').default;
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': 'error',
+    },
+  },
+];

tools/build-target/project.json

@@ -0,0 +1,10 @@
+{
+  "name": "build-target",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "tools/build-target/src",
+  "projectType": "library",
+  "targets": {
+    "lint": {},
+    "unit-test": {}
+  }
+}

tools/build-target/src/build-target.plugin.ts

@@ -0,0 +1,53 @@
+import type { CreateNodesV2, NxPlugin, TargetConfiguration } from '@nx/devkit';
+import * as path from 'node:path';
+
+const TSCONFIG_LIB_FILE = 'tsconfig.lib.json';
+const BUILD_TARGET_NAME = 'build';
+
+export function createBuildTargetConfig(): TargetConfiguration {
+  return {
+    dependsOn: ['^build'],
+    inputs: ['production', '^production'],
+    cache: true,
+    executor: '@nx/js:tsc',
+    outputs: ['{options.outputPath}'],
+    options: {
+      outputPath: '{projectRoot}/dist',
+      main: '{projectRoot}/src/index.ts',
+      tsConfig: `{projectRoot}/${TSCONFIG_LIB_FILE}`,
+      assets: ['{projectRoot}/*.md'],
+    },
+  };
+}
+
+const createNodesV2: CreateNodesV2 = [
+  `**/${TSCONFIG_LIB_FILE}`,
+  async configFilePaths => {
+    return Promise.all(
+      configFilePaths.map(async configFilePath => {
+        const projectRoot = path.dirname(configFilePath);
+        const normalizedProjectRoot = projectRoot === '.' ? '' : projectRoot;
+
+        return [
+          configFilePath,
+          {
+            projects: {
+              [normalizedProjectRoot]: {
+                targets: {
+                  [BUILD_TARGET_NAME]: createBuildTargetConfig(),
+                },
+              },
+            },
+          },
+        ] as const;
+      }),
+    );
+  },
+];
+
+const buildTargetPlugin: NxPlugin = {
+  name: 'build-target-nx-plugin',
+  createNodesV2,
+};
+
+export default buildTargetPlugin;

tools/build-target/src/build-target.plugin.unit.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { createBuildTargetConfig } from './build-target.plugin';
+
+describe('createBuildTargetConfig', () => {
+  it('should return the correct target config', () => {
+    expect(createBuildTargetConfig()).toStrictEqual({
+      dependsOn: ['^build'],
+      inputs: ['production', '^production'],
+      cache: true,
+      executor: '@nx/js:tsc',
+      outputs: ['{options.outputPath}'],
+      options: {
+        outputPath: '{projectRoot}/dist',
+        main: '{projectRoot}/src/index.ts',
+        tsConfig: `{projectRoot}/tsconfig.lib.json`,
+        assets: ['{projectRoot}/*.md'],
+      },
+    });
+  });
+});

tools/build-target/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "verbatimModuleSyntax": false
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.test.json"
+    }
+  ]
+}

tools/build-target/tsconfig.test.json

@@ -0,0 +1,29 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest"
+    ]
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "vitest.unit.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ]
+}

tools/build-target/vitest.unit.config.ts

@@ -0,0 +1,3 @@
+import { createUnitTestConfig } from '../../testing/test-setup-config/src/index.js';
+
+export default createUnitTestConfig('build-target');