First draft, color space announcement

.eslintignore

@@ -13,7 +13,6 @@
 /source/assets/sass/vendor/
 /source/blog/*.md
 /source/documentation/js-api
-/source/assets/js
 coverage/
 node_modules/
 package-lock.json

.eslintrc.json

@@ -1,11 +1,3 @@
 {
-  "extends": "./node_modules/gts/",
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2021
-  },
-  "rules": {
-    "node/no-unpublished-import": "off",
-    "node/no-unpublished-require": "off"
-  }
+  "extends": "./node_modules/gts/"
 }

.github/workflows/ci.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - name: Lint
-        run: npm run lint:ci
+        run: npm run check
 
   release:
     name: Deploy

CONTRIBUTING.md

@@ -62,7 +62,7 @@ You can also run individual commands:
 npm run build
 
 # format and lint all files
-npm run lint
+npm run fix
 ```
 
 ## Templates

package.json

@@ -26,27 +26,33 @@
     "build:typedoc": "./tool/typedoc-build.sh",
     "build:11ty": "NODE_OPTIONS='-r ts-node/register' eleventy",
     "watch:11ty": "npm run build:11ty -- --serve --incremental",
-    "tsc": "tsc",
-    "gts": "gts fix",
-    "gts:ci": "gts lint",
-    "prettier": "prettier --write '**/*.{json,yml,scss}'",
-    "prettier:ci": "prettier --check '**/*.{json,yml,scss}'",
-    "stylelint": "stylelint 'source/assets/sass/*.{css,scss}' --fix",
-    "stylelint:ci": "stylelint 'source/assets/sass/*.{css,scss}'",
-    "lint": "run-s prettier gts stylelint tsc",
-    "lint:ci": "run-s prettier:ci gts:ci stylelint:ci tsc",
+    "check": "run-s check:gts check:tsc check:stylelint",
+    "check:gts": "gts check",
+    "check:stylelint": "stylelint 'source/assets/sass/*.{css,scss}'",
+    "check:tsc": "tsc --noEmit",
+    "fix": "run-s fix:gts fix:stylelint",
+    "fix:gts": "gts fix",
+    "fix:stylelint": "stylelint 'source/assets/sass/*.{css,scss}' --fix",
     "test": "echo \"Error: no test specified\" && exit 1",
     "checklinks:internal": "npx --yes --package=hyperlink -- 'hyperlink --canonicalroot https://sass-lang.com/ --root _site/ -r -p -i --skip \"fragment-redirect\" --skip \"types.Map\" _site/index.html'",
     "checklinks:external": "npx --yes --package=broken-link-checker -- 'blc -ro --exclude=twitter.com --exclude=mvnrepository.com --exclude=drupal.org --exclude=web.archive.org https://sass-lang.com'"
   },
   "devDependencies": {
     "@11ty/eleventy": "^2.0.1",
-    "@11ty/eleventy-plugin-rss": "^2.0.1",
+    "@11ty/eleventy-plugin-rss": "^2.0.2",
     "@11ty/eleventy-plugin-syntaxhighlight": "^5.0.0",
-    "@babel/core": "^7.24.7",
-    "@babel/preset-env": "^7.24.7",
+    "@babel/core": "^7.25.2",
+    "@babel/preset-env": "^7.25.4",
     "@babel/preset-typescript": "^7.24.7",
+    "@codemirror/autocomplete": "^6.18.0",
+    "@codemirror/commands": "^6.6.1",
+    "@codemirror/lang-css": "^6.2.1",
     "@codemirror/lang-sass": "^6.0.2",
+    "@codemirror/language": "^6.10.2",
+    "@codemirror/lint": "^6.8.1",
+    "@codemirror/state": "^6.4.1",
+    "@codemirror/view": "^6.33.0",
+    "@lezer/highlight": "^1.2.1",
     "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-commonjs": "^26.0.1",
     "@rollup/plugin-inject": "^5.0.5",
@@ -55,48 +61,49 @@
     "@sindresorhus/slugify": "^1.1.2",
     "@types/deep-equal": "^1.0.4",
     "@types/jquery": "^3.5.30",
-    "@types/jqueryui": "^1.12.22",
-    "@types/lodash": "^4.17.5",
-    "@types/markdown-it": "^14.1.1",
+    "@types/jqueryui": "^1.12.23",
+    "@types/lodash": "^4.17.7",
+    "@types/markdown-it": "^14.1.2",
     "@types/markdown-it-attrs": "^4.1.3",
     "@types/markdown-it-footnote": "^3.0.4",
     "@types/node": "^16",
     "@types/pako": "^2.0.3",
     "@types/prismjs": "^1.26.4",
     "@types/seedrandom": "^3.0.8",
     "@types/semver": "^7.5.8",
-    "@typescript-eslint/eslint-plugin": "^7.16.0",
+    "@typescript-eslint/eslint-plugin": "^8.4.0",
     "cheerio": "^1.0.0-rc.12",
     "codemirror": "^6.0.1",
     "date-fns": "^3.6.0",
     "deep-equal": "^2.2.3",
-    "eslint-plugin-prettier": "^5.1.3",
+    "eslint-plugin-import": "^2.30.0",
+    "eslint-plugin-prettier": "^5.2.1",
     "gts": "^5.3.1",
-    "immutable": "^4.3.6",
+    "immutable": "^4.3.7",
     "jquery": "^3.7.1",
-    "jquery-ui": "^1.13.3",
+    "jquery-ui": "^1.14.0",
     "js-yaml": "^4.1.0",
     "kleur": "^4.1.5",
-    "liquidjs": "^10.14.0",
+    "liquidjs": "^10.16.7",
     "lodash": "^4.17.21",
     "lorem-ipsum": "^2.0.8",
     "markdown-it": "^14.1.0",
-    "markdown-it-anchor": "^9.0.1",
+    "markdown-it-anchor": "^9.1.0",
     "markdown-it-attrs": "^4.1.6",
     "markdown-it-deflist": "^3.0.0",
     "markdown-it-footnote": "^4.0.0",
     "netlify-plugin-11ty": "^1.4.0",
     "npm-run-all": "^4.1.5",
-    "prettier": "^3.3.2",
+    "prettier": "^3.3.3",
     "prismjs": "^1.29.0",
-    "rollup": "^4.18.0",
-    "sass": "^1.77.8",
-    "semver": "^7.6.2",
+    "rollup": "^4.21.2",
+    "sass": "^1.78.0",
+    "semver": "^7.6.3",
     "stylelint": "^15.11.0",
     "stylelint-config-standard-scss": "^11.1.0",
-    "truncate-html": "^1.1.1",
+    "truncate-html": "^1.1.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.4.5",
+    "typescript": "^5.5.4",
     "typogr": "^0.6.8"
   },
   "dependencies": {

source/_data/documentation.yml

@@ -75,6 +75,7 @@ toc:
       - abs() Percentage: /documentation/breaking-changes/abs-percent/
       - Functions and Mixins Beginning with <code>--</code>: /documentation/breaking-changes/css-function-mixin/
       - Mixed Declarations: /documentation/breaking-changes/mixed-decls/
+      - <code>meta.feature-exists</code>: /documentation/breaking-changes/feature-exists/
   - Command Line: /documentation/cli/
     :children:
       - Dart Sass: /documentation/cli/dart-sass/

source/_data/redirects.ts

@@ -1,63 +1,74 @@
 import * as fs from 'fs';
 import * as p from 'path';
 
+/** Returns `path` without any file extensions. */
 function withoutExtensions(path: string): string {
   return path.substring(0, path.indexOf('.'));
 }
 
-module.exports = {
-  breaking: fs
-    .readdirSync(p.join(__dirname, '../documentation/breaking-changes'))
-    .filter(path => path.endsWith('.md'))
-    .map(path => withoutExtensions(p.basename(path))),
-  multiple: [
-    {
-      from: [
-        '/d/random-with-units',
-        '/documentation/breaking-changes/random-with-units',
-        '/d/color-units',
-        '/documentation/breaking-changes/color-units',
-      ],
-      to: '/documentation/breaking-changes/function-units',
-    },
-    {
-      from: [
-        '/docs/yardoc/file.SASS_REFERENCE.html',
-        '/documentation/file.SASS_REFERENCE.html',
-      ],
-      to: '/documentation',
-    },
-    {
-      from: [
-        '/docs/yardoc/file.SASS_CHANGELOG.html',
-        '/documentation/file.SASS_CHANGELOG.html',
-      ],
-      to: 'https://github.com/sass/dart-sass/blob/main/CHANGELOG.md',
-    },
-    {
-      from: [
-        '/docs/yardoc/file.INDENTED_SYNTAX.html',
-        '/documentation/file.INDENTED_SYNTAX.html',
-        '/docs/yardoc/file.SCSS_FOR_SASS_USERS.html',
-        '/documentation/file.SCSS_FOR_SASS_USERS.html',
-      ],
-      to: '/documentation/syntax',
-    },
-    {
-      from: [
-        '/docs/yardoc/Sass/Script/Functions.html',
-        '/documentation/Sass/Script/Functions.html',
-        '/docs/yardoc/functions.html',
-        '/documentation/functions.html',
-      ],
-      to: '/documentation/modules',
-    },
-    {
-      from: [
-        '/docs/yardoc/functions/css.html',
-        '/documentation/functions/css.html',
-      ],
-      to: '/documentation/at-rules/function/#plain-css-functions',
-    },
-  ],
-};
+/** A list of breaking change URLs. */
+export const breaking: string[] = fs
+  .readdirSync(p.join(__dirname, '../documentation/breaking-changes'))
+  .filter(path => path.endsWith('.md'))
+  .map(path => withoutExtensions(p.basename(path)));
+
+/** A set of redirects from multiple sources to one target. */
+export interface MultipleRedirect {
+  /** The source URLs that should redirect to `to`. */
+  from: string[];
+
+  /** The URL to redirect to. */
+  to: string;
+}
+
+/** A list of redirects from mmultiple sources to single targets. */
+export const multiple: MultipleRedirect[] = [
+  {
+    from: [
+      '/d/random-with-units',
+      '/documentation/breaking-changes/random-with-units',
+      '/d/color-units',
+      '/documentation/breaking-changes/color-units',
+    ],
+    to: '/documentation/breaking-changes/function-units',
+  },
+  {
+    from: [
+      '/docs/yardoc/file.SASS_REFERENCE.html',
+      '/documentation/file.SASS_REFERENCE.html',
+    ],
+    to: '/documentation',
+  },
+  {
+    from: [
+      '/docs/yardoc/file.SASS_CHANGELOG.html',
+      '/documentation/file.SASS_CHANGELOG.html',
+    ],
+    to: 'https://github.com/sass/dart-sass/blob/main/CHANGELOG.md',
+  },
+  {
+    from: [
+      '/docs/yardoc/file.INDENTED_SYNTAX.html',
+      '/documentation/file.INDENTED_SYNTAX.html',
+      '/docs/yardoc/file.SCSS_FOR_SASS_USERS.html',
+      '/documentation/file.SCSS_FOR_SASS_USERS.html',
+    ],
+    to: '/documentation/syntax',
+  },
+  {
+    from: [
+      '/docs/yardoc/Sass/Script/Functions.html',
+      '/documentation/Sass/Script/Functions.html',
+      '/docs/yardoc/functions.html',
+      '/documentation/functions.html',
+    ],
+    to: '/documentation/modules',
+  },
+  {
+    from: [
+      '/docs/yardoc/functions/css.html',
+      '/documentation/functions/css.html',
+    ],
+    to: '/documentation/at-rules/function/#plain-css-functions',
+  },
+];

source/_data/releases.ts

@@ -1,10 +1,19 @@
-import {spawn as nodeSpawn, SpawnOptionsWithoutStdio} from 'node:child_process';
+import {SpawnOptionsWithoutStdio, spawn as nodeSpawn} from 'node:child_process';
 import fs from 'node:fs/promises';
 
 import deepEqual from 'deep-equal';
 import kleur from 'kleur';
 import {compare, parse} from 'semver';
 
+/** A release of a version of Sass. */
+export interface Release {
+  /** The version of this Sass release. */
+  version: string;
+
+  /** The URL for this version. */
+  url: string;
+}
+
 type VersionCache = Record<string, string>;
 
 const VERSION_CACHE_PATH = './source/_data/versionCache.json';
@@ -13,11 +22,11 @@ const VERSION_CACHE_PATH = './source/_data/versionCache.json';
  * Promise version of `spawn` to avoid blocking the main thread while waiting
  * for the child processes.
  */
-const spawn = (
+function spawn(
   cmd: string,
   args: string[],
   options: SpawnOptionsWithoutStdio
-) => {
+): Promise<string> {
   return new Promise((resolve, reject) => {
     const child = nodeSpawn(cmd, args, options);
     const stderr: string[] = [];
@@ -36,12 +45,12 @@ const spawn = (
       }
     });
   });
-};
+}
 
 /**
  * Retrieves cached version object from cache file.
  */
-const getCacheFile = async () => {
+async function getCacheFile(): Promise<VersionCache> {
   let versionCache;
   try {
     const versionFile = await fs.readFile(VERSION_CACHE_PATH);
@@ -54,20 +63,20 @@ const getCacheFile = async () => {
     }
   }
   return versionCache;
-};
+}
 
 /**
  * Writes version object to cache file.
  */
-const writeCacheFile = async (cache: VersionCache) => {
+async function writeCacheFile(cache: VersionCache): Promise<void> {
   console.info(kleur.green('[11ty] Writing version cache file...'));
   await fs.writeFile(VERSION_CACHE_PATH, JSON.stringify(cache));
-};
+}
 
 /**
  * Retrieves the highest stable version of `repo`, based on its git tags.
  */
-const getLatestVersion = async (repo: string) => {
+async function getLatestVersion(repo: string): Promise<string> {
   console.info(kleur.cyan(`[11ty] Fetching version information for ${repo}`));
   let stdout;
   try {
@@ -80,10 +89,10 @@ const getLatestVersion = async (repo: string) => {
     console.error(kleur.red(`[11ty] Failed to fetch git tags for ${repo}`));
     throw err;
   }
-  const isNotPreRelease = (version: string) => {
+  function isNotPreRelease(version: string): boolean | null {
     const parsed = parse(version);
     return parsed && parsed.prerelease.length === 0;
-  };
+  }
   const version = stdout
     .split('\n')
     .map(line => line.split('refs/tags/').at(-1) ?? '')
@@ -92,12 +101,12 @@ const getLatestVersion = async (repo: string) => {
     .at(-1);
 
   return version ?? '';
-};
+}
 
 /**
  * Returns the version and URL for the latest release of all implementations.
  */
-module.exports = async () => {
+export default async function (): Promise<Record<string, Release>> {
   const repos = ['sass/libsass', 'sass/dart-sass', 'sass/migrator'];
   const cache = await getCacheFile();
 
@@ -120,4 +129,4 @@ module.exports = async () => {
   }
 
   return data;
-};
+}