Publish a @sass/types package with the types of the shared JS API

Author: stof

.github/workflows/release.yml

@@ -99,6 +99,38 @@ jobs:
       - run: git tag sass-api-${{ steps.sass-api-version.outputs.version }}
       - run: git push --tag
 
+  deploy_sass_types:
+    name: Deploy @sass/types
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+      # Set up .npmrc file to publish to npm
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+          check-latest: true
+          registry-url: 'https://registry.npmjs.org'
+      - name: Get Dart Sass version
+        id: dart-sass-version
+        run: echo "version=${{ github.ref_name }}" | tee --append "$GITHUB_OUTPUT"
+      - name: Check out the language repo
+        uses: actions/checkout@v5
+        with: {repository: sass/sass, path: build/language}
+      - name: Copy types from the language repo
+        run: cp -r build/language/js-api-doc pkg/sass-types/types
+      - name: Copy LICENSE file
+        run: cp LICENSE pkg/sass-types/
+      - name: Set the version of @sass/types
+        run: npm pkg set version='{{ steps.dart-sass-version.outputs.version }}'
+        working-directory: pkg/sass-types/
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: '${{ secrets.NPM_TOKEN }}'
+        working-directory: pkg/sass-types/
+
   deploy_sass_parser:
     name: Deploy sass-parser
     runs-on: ubuntu-latest

pkg/sass-types/README.md

@@ -0,0 +1,6 @@
+# @sass/types
+
+This package is a dual-publish of the [Sass JS API](https://sass-lang.com/documentation/js-api/)
+types. The `sass` and `sass-embedded` packages **still contain types**. This package is for
+users who _only_ need the Sass JS types (such as for `@types/gulp-sass`). It is published
+alongside every release of `sass` and `sass-embedded`, so you can always use the same version.

pkg/sass-types/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@sass/types",
+  "version": "auto",
+  "description": "A standalone types package for the Sass JS API",
+  "repository": "sass/sass",
+  "author": "Google Inc.",
+  "license": "MIT",
+  "exports": {
+    "types": "./types/index.d.ts"
+  },
+  "types": "types/index.d.ts",
+  "files": [
+    "types/**/*.d.ts"
+  ]
+}