umberto 10.1.0 → 10.1.1

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 Changelog
 =========
 
+## [10.1.1](https://github.com/cksource/umberto/compare/v10.1.0...v10.1.1) (March 4, 2026)
+
+### Bug fixes
+
+* Fixed a deprecation warning displayed during documentation builds by migrating Sass compilation to the modern Dart Sass JavaScript API. The `legacy-js-api` warning is no longer emitted.
+
+
 ## [10.1.0](https://github.com/cksource/umberto/compare/v10.0.0...v10.1.0) (March 4, 2026)
 
 ### Features
@@ -51,18 +58,6 @@ Changelog
 
 * Improved rendering of [`templateLiteral`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html) types that reference a module. They are now rendered as clickable links pointing to the corresponding page.
 
-
-## [9.2.0](https://github.com/cksource/umberto/compare/v9.1.3...v9.2.0) (January 7, 2026)
-
-### Features
-
-* Enabled Shiki syntax highlighting for diff blocks in Gloria. This improves the readability and usability of diffs in the documentation.
-
-### Bug fixes
-
-* Fix crashes of Table of Contents on some pages where headings are not placed in expected HTML structure.
-* No longer stop building of the document when invalid links are found during link validation if some parts of the documentation are skipped (API, SDK, Guides).
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.1.0",
+  "version": "10.1.1",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",

package/src/tasks/compile-sass.js

@@ -3,17 +3,16 @@
  * For licensing, see LICENSE.md.
  */
 
-import { fileURLToPath } from 'node:url';
+import { pathToFileURL } from 'node:url';
 import * as sass from 'sass';
 import fs from 'fs-extra';
 import upath from 'upath';
 
-export function compileSass( src, dst ) {
-	return new Promise( ( resolve, reject ) => {
-		const options = {
-			file: src,
-			outputStyle: 'compressed',
-			importer( url, file, done ) {
+export async function compileSass( src, dst ) {
+	const options = {
+		style: 'compressed',
+		importers: [ {
+			findFileUrl( url ) {
 				// In case of import from the `themes/umberto/src` directory.
 				const themeMatch = url && url.match( /@([^/]+)\/(.+)/ );
 
@@ -22,53 +21,24 @@ export function compileSass( src, dst ) {
 					const filePath = upath.join( import.meta.dirname, '../../themes/umberto/src', theme, 'css', remainingPath );
 
 					if ( fs.existsSync( filePath ) ) {
-						return done( { file: filePath } );
+						return pathToFileURL( filePath );
 					}
 				}
 
 				// In case of an import from the `node_modules` directory.
 				if ( url.startsWith( '~' ) ) {
-					// Resolve the path regarding the current working directory.
-					const absolutePath = fileURLToPath( import.meta.resolve( url.substr( 1 ) ) );
-
-					return fs.readFile( absolutePath, 'utf-8', ( err, data ) => {
-						if ( err ) {
-							return done( err );
-						}
-
-						return done( {
-							contents: data
-						} );
-					} );
+					return new URL( import.meta.resolve( url.substr( 1 ) ) );
 				}
 
-				// Import a local file (a relative path).
-				const directory = upath.dirname( file );
-
-				// Replace "directory/filename" with "directory/_filename.scss".
-				const fileName = url.replace( /(.+)(?:\/(.+))$/, ( match, dirName, fileName ) => {
-					return dirName + '/_' + fileName + '.scss';
-				} );
-
-				return done( {
-					file: upath.join( directory, fileName )
-				} );
+				return null;
 			}
-		};
+		} ]
+	};
 
-		sass.render( options, ( err, result ) => {
-			if ( err ) {
-				return reject( err );
-			}
+	const result = await sass.compileAsync( src, options );
 
-			fs.mkdirsSync( upath.dirname( dst ) );
-			fs.writeFile( upath.resolve( dst ), result.css.toString( 'utf-8' ), err => {
-				if ( err ) {
-					return reject( err );
-				}
+	fs.mkdirsSync( upath.dirname( dst ) );
+	await fs.writeFile( upath.resolve( dst ), result.css );
 
-				return resolve( true );
-			} );
-		} );
-	} );
+	return true;
 }