chore: modernize CI and expand README install section

.github/workflows/ci.generated.yml

@@ -0,0 +1,106 @@
+# GENERATED BY ./ci.ts -- DO NOT DIRECTLY EDIT
+
+name: CI
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+jobs:
+  build:
+    name: '${{ matrix.config.kind }} ${{ matrix.config.os }}'
+    runs-on: '${{ matrix.config.os }}'
+    strategy:
+      matrix:
+        config:
+          - os: ubuntu-latest
+            kind: test_release
+          - os: ubuntu-latest
+            kind: test_debug
+    env:
+      CARGO_INCREMENTAL: 0
+      RUST_BACKTRACE: full
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: dsherret/rust-toolchain-file@3551321aa44dd44a0393eb3b6bdfbc5d25ecf621 # v1
+      - name: Install wasm32 target
+        if: matrix.config.kind == 'test_release'
+        run: rustup target add wasm32-unknown-unknown
+      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
+        with:
+          save-if: '${{ github.ref == ''refs/heads/main'' }}'
+      - uses: denoland/setup-deno@667a34cdef165d8d2b2e98dde39547c9daac7282 # v2
+        with:
+          deno-version: v2.x
+      - name: Build debug
+        if: matrix.config.kind == 'test_debug'
+        run: cargo build
+      - name: Lint
+        if: matrix.config.kind == 'test_debug'
+        run: cargo clippy
+      - name: Test debug
+        if: matrix.config.kind == 'test_debug'
+        run: cargo test
+      - name: Build release
+        if: matrix.config.kind == 'test_release'
+        run: cargo build --target wasm32-unknown-unknown --features "wasm" --release
+      - name: Test release
+        if: matrix.config.kind == 'test_release'
+        run: cargo test --release
+      - name: Wasm integration test - Setup
+        if: matrix.config.kind == 'test_release'
+        run: 'echo ''{ "plugins": ["./target/wasm32-unknown-unknown/release/dprint_plugin_typescript.wasm"] }'' >> dprint.test.json'
+      - name: Wasm integration test - Run
+        uses: dprint/check@2f1cf31537886c3bfb05591c031f7744e48ba8a1 # v2.2
+        if: matrix.config.kind == 'test_release'
+        with:
+          config-path: dprint.test.json
+      - name: Wasm integration test - Cleanup
+        if: matrix.config.kind == 'test_release'
+        run: rm dprint.test.json
+      - name: Get tag version
+        id: get_tag_version
+        if: 'matrix.config.kind == ''test_release'' && startsWith(github.ref, ''refs/tags/'')'
+        run: 'echo "TAG_VERSION=${GITHUB_REF/refs\/tags\//}" >> "$GITHUB_OUTPUT"'
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        if: matrix.config.kind == 'test_release'
+        with:
+          node-version: 24.x
+          registry-url: 'https://registry.npmjs.org'
+      - name: Setup and test npm deployment
+        if: matrix.config.kind == 'test_release'
+        run: |-
+          cd deployment/npm
+          npm install
+          node setup.js
+          npm run test
+      - name: Pre-release
+        if: 'matrix.config.kind == ''test_release'' && startsWith(github.ref, ''refs/tags/'')'
+        run: |-
+          # update config schema to have version
+          sed -i 's/typescript\/0.0.0/typescript\/${{ steps.get_tag_version.outputs.TAG_VERSION }}/' deployment/schema.json
+          # rename the wasm file
+          (cd target/wasm32-unknown-unknown/release/ && mv dprint_plugin_typescript.wasm plugin.wasm)
+          # create release notes
+          deno run -A ./scripts/generate_release_notes.ts ${{ steps.get_tag_version.outputs.TAG_VERSION }} > ${{ github.workspace }}-CHANGELOG.txt
+      - name: Release
+        uses: softprops/action-gh-release@de2c0eb89ae2a093876385947365aca7b0e5f844
+        if: 'matrix.config.kind == ''test_release'' && startsWith(github.ref, ''refs/tags/'')'
+        env:
+          GITHUB_TOKEN: '${{ secrets.GITHUB_TOKEN }}'
+        with:
+          files: |-
+            target/wasm32-unknown-unknown/release/plugin.wasm
+            deployment/schema.json
+          body_path: '${{ github.workspace }}-CHANGELOG.txt'
+          draft: false
+      - name: Lint workflow generation
+        if: matrix.config.kind == 'test_debug'
+        run: |-
+          ./.github/workflows/ci.ts --lint
+          ./.github/workflows/publish.ts --lint
+          ./.github/workflows/release.ts --lint

.github/workflows/ci.ts

@@ -0,0 +1,161 @@
+#!/usr/bin/env -S deno run -A
+import { conditions, defineMatrix, expr, job, step, workflow } from "jsr:@david/gagen@^0.5.0";
+
+const pluginName = "typescript";
+const cargoWasmName = `dprint_plugin_${pluginName}`;
+
+const matrix = defineMatrix({
+  config: [
+    { os: "ubuntu-latest", kind: "test_release" },
+    { os: "ubuntu-latest", kind: "test_debug" },
+  ],
+});
+
+const kind = expr("matrix.config.kind");
+const os = expr("matrix.config.os");
+
+const isRelease = kind.equals("test_release");
+const isDebug = kind.equals("test_debug");
+const isTag = conditions.isTag();
+const isReleaseAndTag = isRelease.and(isTag);
+
+const getTagVersion = step({
+  id: "get_tag_version",
+  name: "Get tag version",
+  if: isReleaseAndTag,
+  run: `echo "TAG_VERSION=\${GITHUB_REF/refs\\/tags\\//}" >> "$GITHUB_OUTPUT"`,
+  outputs: ["TAG_VERSION"],
+});
+
+const buildJob = job("build", {
+  name: `${kind} ${os}`,
+  runsOn: os,
+  strategy: { matrix },
+  env: {
+    CARGO_INCREMENTAL: 0,
+    RUST_BACKTRACE: "full",
+  },
+  steps: [
+    { uses: "actions/checkout@v6" },
+    { uses: "dsherret/rust-toolchain-file@v1" },
+    {
+      name: "Install wasm32 target",
+      if: isRelease,
+      run: "rustup target add wasm32-unknown-unknown",
+    },
+    {
+      uses: "Swatinem/rust-cache@v2",
+      with: { "save-if": "${{ github.ref == 'refs/heads/main' }}" },
+    },
+    // deno is needed by the "Lint workflow generation" step (test_debug)
+    // and by the "Pre-release" step (test_release on tag). Install it
+    // once at the top of every job to keep the matrix steps simple.
+    {
+      uses: "denoland/setup-deno@v2",
+      with: { "deno-version": "v2.x" },
+    },
+
+    { name: "Build debug", if: isDebug, run: "cargo build" },
+    { name: "Lint", if: isDebug, run: "cargo clippy" },
+    { name: "Test debug", if: isDebug, run: "cargo test" },
+
+    {
+      name: "Build release",
+      if: isRelease,
+      run: `cargo build --target wasm32-unknown-unknown --features "wasm" --release`,
+    },
+    { name: "Test release", if: isRelease, run: "cargo test --release" },
+
+    // wasm integration test (typescript-specific)
+    {
+      name: "Wasm integration test - Setup",
+      if: isRelease,
+      run:
+        `echo '{ "plugins": ["./target/wasm32-unknown-unknown/release/${cargoWasmName}.wasm"] }' >> dprint.test.json`,
+    },
+    {
+      name: "Wasm integration test - Run",
+      if: isRelease,
+      uses: "dprint/check@v2.2",
+      with: { "config-path": "dprint.test.json" },
+    },
+    {
+      name: "Wasm integration test - Cleanup",
+      if: isRelease,
+      run: "rm dprint.test.json",
+    },
+
+    getTagVersion,
+
+    // NPM
+    {
+      uses: "actions/setup-node@v6",
+      if: isRelease,
+      with: {
+        "node-version": "24.x",
+        "registry-url": "https://registry.npmjs.org",
+      },
+    },
+    {
+      name: "Setup and test npm deployment",
+      if: isRelease,
+      run: [
+        "cd deployment/npm",
+        "npm install",
+        "node setup.js",
+        "npm run test",
+      ],
+    },
+
+    // GITHUB RELEASE
+    {
+      name: "Pre-release",
+      if: isReleaseAndTag,
+      run: [
+        "# update config schema to have version",
+        `sed -i 's/${pluginName}\\/0.0.0/${pluginName}\\/${getTagVersion.outputs.TAG_VERSION}/' deployment/schema.json`,
+        "# rename the wasm file",
+        `(cd target/wasm32-unknown-unknown/release/ && mv ${cargoWasmName}.wasm plugin.wasm)`,
+        "# create release notes",
+        `deno run -A ./scripts/generate_release_notes.ts ${getTagVersion.outputs.TAG_VERSION} > \${{ github.workspace }}-CHANGELOG.txt`,
+      ],
+    },
+    {
+      name: "Release",
+      // pinned because softprops/action-gh-release was once compromised
+      uses: "softprops/action-gh-release@de2c0eb89ae2a093876385947365aca7b0e5f844",
+      if: isReleaseAndTag,
+      env: { GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" },
+      with: {
+        files: [
+          "target/wasm32-unknown-unknown/release/plugin.wasm",
+          "deployment/schema.json",
+        ].join("\n"),
+        body_path: "${{ github.workspace }}-CHANGELOG.txt",
+        draft: false,
+      },
+    },
+    {
+      name: "Lint workflow generation",
+      if: isDebug,
+      run: [
+        "./.github/workflows/ci.ts --lint",
+        "./.github/workflows/publish.ts --lint",
+        "./.github/workflows/release.ts --lint",
+      ],
+    },
+  ],
+});
+
+workflow({
+  name: "CI",
+  on: {
+    pull_request: { branches: ["main"] },
+    push: { branches: ["main"], tags: ["*"] },
+  },
+  jobs: [buildJob],
+}).writeOrLint({
+  filePath: new URL("./ci.generated.yml", import.meta.url),
+  header: "# GENERATED BY ./ci.ts -- DO NOT DIRECTLY EDIT",
+  pinDeps: true,
+});