umberto 6.1.2 → 7.0.1

package/src/tasks/write-html-files.js

@@ -5,8 +5,7 @@
 
 'use strict';
 
-const fs = require( 'fs' );
-const mkdirp = require( 'mkdirp' );
+const fs = require( 'fs-extra' );
 const upath = require( 'upath' );
 
 /**
@@ -14,29 +13,15 @@ const upath = require( 'upath' );
  *
  * @param {Array.<HtmlFile>} files HtmlFile objects containing content to be written to .html files to file system.
  * @param {String} destinationDir Additional destination path. Additional because files already have its own path.
- * @returns {Promise}
+ * @returns {Promise<void>}
  */
-module.exports = ( files, destinationDir = '.' ) => {
-	const promises = [];
-
-	for ( const file of files ) {
-		const fileDir = upath.join( destinationDir, file.dirname );
-
-		const promise = mkdirp( upath.resolve( fileDir ) )
-			.then( () => {
-				return new Promise( ( resolve, reject ) => {
-					fs.writeFile( upath.join( fileDir, file.basename ), file.content, err => {
-						if ( err ) {
-							return reject( err );
-						}
-
-						return resolve();
-					} );
-				} );
-			} );
-
-		promises.push( promise );
-	}
-
-	return Promise.all( promises );
+module.exports = async ( files, destinationDir = '.' ) => {
+	const writePromises = files.map( file =>
+		fs.outputFile(
+			upath.join( destinationDir, file.dirname, file.basename ),
+			file.content
+		)
+	);
+
+	return Promise.all( writePromises );
 };

package/src/template/template-collection.js

@@ -15,7 +15,7 @@ const splitLongname = require( '../helpers/split-longname' );
 const extractLongname = require( '../helpers/extract-longname' );
 const getApiInfoboxTooltip = require( '../helpers/get-api-infobox-tooltip' );
 const capitalize = require( '../helpers/capitalize' );
-const relative_url = require( 'hexo/lib/plugins/helper/relative_url' ); // eslint-disable-line camelcase
+const relative_url = require( 'hexo/dist/plugins/helper/relative_url' ); // eslint-disable-line camelcase
 
 /**
  * Provides pug templates and adds various helpers to them.

package/themes/umberto/layout/gloria/_api-docs/_mixin/_type.pug

@@ -56,6 +56,15 @@ mixin renderComplexStructure( complexType )
 		| !{ ' ' }
 		+renderType( complexType.values )
 
+	//- Raw operator.
+	//-
+	//- Since `typedoc@0.28`, some of known types are translated as `unknown`. To display anything, we treat
+	//- them as a pure string. We wrap it in brackets to avoid confusions when it is a part of the union type.
+	if ( complexType.type === 'raw' && complexType.value )
+		| !{ '( ' }
+		| #{ complexType.value }
+		| !{ ' )' }
+
 	//- An object with type arguments.
 	if ( complexType.type === 'generic' && complexType.name && ( complexType.typeParameters || complexType.typeParameter ) )
 		+renderGenericType( complexType )

package/themes/umberto/layout/umberto/_api-docs/_mixin/_type.pug

@@ -56,6 +56,15 @@ mixin renderComplexStructure( complexType )
 		| !{ ' ' }
 		+renderType( complexType.values )
 
+	//- Raw operator.
+	//-
+	//- Since `typedoc@0.28`, some of known types are translated as `unknown`. To display anything, we treat
+	//- them as a pure string. We wrap it in brackets to avoid confusions when it is a part of the union type.
+	if ( complexType.type === 'raw' && complexType.value )
+		| !{ '( ' }
+		| #{ complexType.value }
+		| !{ ' )' }
+
 	//- An object with type arguments.
 	if ( complexType.type === 'generic' && complexType.name && ( complexType.typeParameters || complexType.typeParameter ) )
 		+renderGenericType( complexType )

package/themes/umberto/src/gloria/js/_codeswitcherbuttons.js

@@ -100,11 +100,11 @@ export function createCodeSwitcherButtons() {
 
 		const selfHostedButton = createButton( 'Self-hosted (npm)', activeType === type.selfHosted );
 
-		selfHostedButton.setAttribute( 'title', 'Self-hosted shows imports for installations using npm or ZIP setups.' );
+		selfHostedButton.setAttribute( 'title', 'Show import snippets for npm and ZIP setups.' );
 
 		const cloudButton = createButton( 'Cloud (CDN)', activeType === type.cloud );
 
-		cloudButton.setAttribute( 'title', 'Cloud shows imports for installations using CDN setups.' );
+		cloudButton.setAttribute( 'title', 'Show import snippets for a CDN setup.' );
 
 		const switcherToolbar = switcher.querySelector( `.${ codeSwitcherToolbarClass }` );
 

package/themes/umberto/src/gloria/js/app.js

@@ -3,11 +3,6 @@
  * For licensing, see LICENSE.md.
  */
 
-// Polyfill for `window.Symbol`.
-import '@babel/polyfill';
-// Polyfill for `Element.closest()`.
-import 'element-closest/browser';
-
 import $ from 'jquery';
 import { setupPrism } from './_prism';
 import { enableCollapsables, hideTogglers } from './_collapsables';

package/themes/umberto/src/umberto/js/_codeswitcherbuttons.js

@@ -100,11 +100,11 @@ export function createCodeSwitcherButtons() {
 
 		const selfHostedButton = createButton( 'Self-hosted (npm)', activeType === type.selfHosted );
 
-		selfHostedButton.setAttribute( 'title', 'Self-hosted shows imports for installations using npm or ZIP setups.' );
+		selfHostedButton.setAttribute( 'title', 'Show import snippets for npm and ZIP setups.' );
 
 		const cloudButton = createButton( 'Cloud (CDN)', activeType === type.cloud );
 
-		cloudButton.setAttribute( 'title', 'Cloud shows imports for installations using CDN setups.' );
+		cloudButton.setAttribute( 'title', 'Show import snippets for a CDN setup.' );
 
 		const switcherToolbar = switcher.querySelector( `.${ codeSwitcherToolbarClass }` );
 

package/themes/umberto/src/umberto/js/app.js

@@ -3,11 +3,6 @@
  * For licensing, see LICENSE.md.
  */
 
-// Polyfill for `window.Symbol`.
-import '@babel/polyfill';
-// Polyfill for `Element.closest()`.
-import 'element-closest/browser';
-
 import $ from 'jquery';
 import { setupPrism } from './_prism';
 import { enableCollapsables, hideTogglers } from './_collapsables';

package/src/helpers/copy-file.js

@@ -1,34 +0,0 @@
-/**
- * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-'use strict';
-
-const fs = require( 'fs' );
-
-/**
- * Copies a specified file from the `source` path to the `destination` path.
- *
- * @param {String} source
- * @param {String} destination
- * @return {Promise}
- */
-module.exports = function copyFile( source, destination ) {
-	return new Promise( ( resolve, reject ) => {
-		const readStream = fs.createReadStream( source );
-
-		// In order to catch an error if `source` points to non-existing file, we need to wait for
-		// the `#open` event emitted by the read readStream.
-		readStream.on( 'open', () => {
-			const writeStream = fs.createWriteStream( destination );
-
-			readStream.pipe( writeStream );
-
-			writeStream.on( 'error', reject );
-			writeStream.on( 'finish', resolve );
-		} );
-
-		readStream.on( 'error', reject );
-	} );
-};