umberto 9.4.0 → 10.0.0

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 Changelog
 =========
 
+## [10.0.0](https://github.com/cksource/umberto/compare/v9.4.0...v10.0.0) (February 16, 2026)
+
+### BREAKING CHANGES
+
+* Migrate the package to [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules).
+* Remove the `validateW3C` option.
+
+
 ## [9.4.0](https://github.com/cksource/umberto/compare/v9.3.0...v9.4.0) (February 2, 2026)
 
 ### Features
@@ -54,15 +62,6 @@ Changelog
 
 * Added CKBox (`CKBOX_VERSION`) and CKEditor 5 (`CKEDITOR_VERSION`) versions to events sent to Sentry integration.
 
-
-## [9.1.2](https://github.com/cksource/umberto/compare/v9.1.1...v9.1.2) (December 8, 2025)
-
-### Bug fixes
-
-* Fix a race condition in the Tooltip/Popover component between `createTooltipPopover` and `TooltipPopover.attach` that could cause duplicate initialization. Tooltips now initialize only once per element and more reliably detect when trigger elements have been detached.
-* Minification should preserve closing tags and output spec-compliant HTML.
-* Fix encoding of SDK sources.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/LICENSE.md

@@ -9,47 +9,3 @@ Sources of Intellectual Property Included in Umberto
 -----------------------------------------------------
 
 Where not otherwise indicated, all Umberto content is authored by CKSource engineers and consists of CKSource-owned intellectual property. In some specific instances, Umberto will incorporate work done by developers outside of CKSource with their express permission.
-
-The following libraries are included in Umberto under the [MIT license](https://opensource.org/licenses/MIT):
-
-* @babel/core - Copyright (c) 2014-present Sebastian McKenzie and other contributors
-* @babel/preset-env - Copyright (c) 2014-present Sebastian McKenzie and other contributors
-* babel-loader - Copyright (c) 2014-2019 Luís Couto <hello@luiscouto.pt>
-* cheerio - Copyright (c) 2022 The Cheerio contributors
-* escape-string-regexp - Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
-* fs-extra - Copyright (c) 2011-2024 JP Richardson
-* hexo - Copyright (c) 2012-present Tommy Chen
-* hexo-generator-archive - Copyright (c) 2014 Tommy Chen
-* hexo-generator-category - Copyright (c) 2014 Tommy Chen
-* hexo-generator-index - Copyright (c) 2014 Tommy Chen
-* hexo-generator-tag - Copyright (c) 2014 Tommy Chen
-* hexo-renderer-pug - Copyright (c) 2012 Tommy Chen
-* hexo-renderer-markdown-it-plus - Copyright (c) 2017 CHENXCHEN
-* htmlparser2 - Copyright 2010, 2011, Chris Winberry <chris@winberry.net>
-* javascript-stringify - Copyright (c) 2013 Blake Embrey (hello@blakeembrey.com)
-* jquery - Copyright OpenJS Foundation and other contributors, https://openjsf.org/
-* js-beautify - Copyright (c) 2007-2018 Einar Lielmanis, Liam Newman, and contributors.
-* lodash - Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
-* markdown-it - Copyright (c) 2014 Vitaly Puzrin, Alex Kocharin.
-* markdown-it-toc-and-anchor - Copyright (c) 2015 Maxime Thirouin
-* medium-zoom - Copyright (c) 2016-present François Chalifour
-* moment - Copyright (c) JS Foundation and other contributors
-* pug - Copyright (c) 2009-2014 TJ Holowaychuk <tj@vision-media.ca>
-* sass - Copyright (c) 2016, Google Inc.
-* sitemap - Copyright (c) 2011 Eugene Kalinin
-* tippy.js - Copyright (c) 2017-present atomiks
-* tree-model - Copyright (c) 2013 João Nuno Silva
-* upath - Copyright(c) 2014-2020 Angelos Pikoulas (agelos.pikoulas@gmail.com)
-* vnu-jar - Copyright (c) 2007-2016 Mozilla Foundation
-* webpack - Copyright JS Foundation and other contributors
-
-The following libraries are included in Umberto under the [Apache License, version 2.0](https://opensource.org/license/apache-2-0/):
-
-* fuse.js - Copyright 2017 Kirollos Risk
-
-The following libraries are included in Umberto under the [ISC license](https://opensource.org/license/isc-license-txt):
-
-* glob - Copyright (c) 2009-2023 Isaac Z. Schlueter and Contributors
-* markdown-it-expand-tabs - Copyright (c) 2016, Revin Guillen
-* minimatch - Copyright (c) 2011-2023 Isaac Z. Schlueter and Contributors
-* nyc - Copyright (c) 2015, Contributors

package/README.md

@@ -178,7 +178,6 @@ Sample documentation setup for the example above:
 * `verbose` - displays more information during generating documentation.
 * `createSymLinks` - add symbolic links ('latest') to necessary projects in output folder.
 * `watch` - activate watch mode in Umberto. Markdown files are rebuild and refreshed in destination directory without rebuilding rest of the documentation.
-* `validateW3C` - activate validation of builded page with [The Nu Html Checker](https://github.com/validator/validator).
 
 The documentation will be output to the `build/docs` directory.
 

package/hexo-shim.js

@@ -3,6 +3,6 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
+import Hexo from 'hexo';
 
-module.exports = require( 'hexo' );
+export default Hexo;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "umberto",
-  "version": "9.4.0",
+  "version": "10.0.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
+  "type": "module",
   "files": [
     "scripts",
     "src",
@@ -45,7 +46,6 @@
     "medium-zoom": "^1.0.6",
     "minimatch": "^10.0.1",
     "moment": "^2.29.4",
-    "nyc": "^17.1.0",
     "pug": "^3.0.2",
     "sass": "^1.54.0",
     "shiki": "^3.4.0",
@@ -54,7 +54,6 @@
     "tippy.js": "^6.3.7",
     "tree-model": "^1.0.7",
     "upath": "^2.0.1",
-    "vnu-jar": "^21.10.12",
     "webpack": "^5.94.0"
   },
   "engines": {
@@ -62,12 +61,6 @@
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "MIT",
-  "homepage": "https://github.com/cksource/umberto",
-  "bugs": "https://github.com/cksource/umberto/issues",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cksource/umberto.git"
-  },
   "lint-staged": {
     "**/*": [
       "eslint --quiet"

package/scripts/filter/after-post-render/{gloria.js → gloria.cjs}

@@ -8,9 +8,9 @@
 const { parseDocument } = require( 'htmlparser2' );
 const { default: render } = require( 'dom-serializer' );
 
-const appendCopyHeadingButtons = require( '../../utils/gloria-after-post-render/append-copy-heading-buttons' );
-const applyDesignDocClasses = require( '../../utils/gloria-after-post-render/apply-design-doc-classes' );
-const wrapTableIntoWrappers = require( '../../utils/gloria-after-post-render/wrap-table-into-wrappers' );
+const appendCopyHeadingButtons = require( '../../utils/gloria-after-post-render/append-copy-heading-buttons.cjs' );
+const applyDesignDocClasses = require( '../../utils/gloria-after-post-render/apply-design-doc-classes.cjs' );
+const wrapTableIntoWrappers = require( '../../utils/gloria-after-post-render/wrap-table-into-wrappers.cjs' );
 
 hexo.extend.filter.register( 'after_post_render', page => {
 	if ( page.projectTheme !== 'gloria' ) {

package/scripts/filter/after-post-render/{insert-error-codes.js → insert-error-codes.cjs}

@@ -10,7 +10,7 @@ const { parseDocument } = require( 'htmlparser2' );
 const { default: render } = require( 'dom-serializer' );
 const { selectAll } = require( 'css-select' );
 const { getAttributeValue } = require( 'domutils' );
-const applyDesignDocClasses = require( '../../utils/gloria-after-post-render/apply-design-doc-classes' );
+const applyDesignDocClasses = require( '../../utils/gloria-after-post-render/apply-design-doc-classes.cjs' );
 
 /**
  * Support @errors tag.

package/scripts/filter/after-post-render/{linker.js → linker.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const { parseLinks } = require( '../../utils/parselinks' );
+const { parseLinks } = require( '../../utils/parselinks.cjs' );
 
 hexo.extend.filter.register( 'after_post_render', page => {
 	return parseLinks( page, hexo );

package/scripts/filter/after-post-render/{parseicontag.js → parseicontag.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const parseIconTag = require( '../../utils/parseicontag' );
+const parseIconTag = require( '../../utils/parseicontag.cjs' );
 
 /**
  * Syntax: `{@icon [@projectName] path/to/icon}`.

package/scripts/filter/after-post-render/{snippets.js → snippets.cjs}

@@ -5,8 +5,8 @@
 
 'use strict';
 
-const hexoManager = require( '../../../src/hexo-manager' );
-const { shouldBuildSnippets, getSnippetPlaceholder, getSnippetSourcePaths } = require( '../../../src/helpers/snippets' );
+const { hexoManager } = require( '../../../src/hexo-manager.js' );
+const { shouldBuildSnippets, getSnippetPlaceholder, getSnippetSourcePaths } = require( '../../../src/helpers/snippets.js' );
 
 const upath = require( 'upath' );
 

package/scripts/filter/after-render/{process-svg.js → process-svg.cjs}

@@ -7,9 +7,9 @@
 
 const { parseDocument } = require( 'htmlparser2' );
 const { default: render } = require( 'dom-serializer' );
-const inlineSvg = require( '../../utils/inline-svg' );
-const spritesheetSvg = require( '../../utils/spritesheet-svg' );
-const hexoManager = require( '../../../src/hexo-manager' );
+const inlineSvg = require( '../../utils/inline-svg.cjs' );
+const spritesheetSvg = require( '../../utils/spritesheet-svg.cjs' );
+const { hexoManager } = require( '../../../src/hexo-manager.js' );
 
 hexo.extend.filter.register( 'after_render:html', html => {
 	let doc = parseDocument( html );

package/scripts/filter/before-post-render/{add-project-info-to-page.js → add-project-info-to-page.cjs}

@@ -6,8 +6,8 @@
 'use strict';
 
 const upath = require( 'upath' );
-const shouldDisplayNewIndicator = require( '../../utils/shoulddisplaynewindicator' );
-const getReportIssueWidgetUrl = require( '../../utils/getreportissuewidgeturl' );
+const shouldDisplayNewIndicator = require( '../../utils/shoulddisplaynewindicator.cjs' );
+const getReportIssueWidgetUrl = require( '../../utils/getreportissuewidgeturl.cjs' );
 
 /**
  * Adds project information (e.g. BASE_PATH, project name, group id) to each page.

package/scripts/filter/before-post-render/{add-repo-url.js → add-repo-url.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const githubUrlUtils = require( '../../../src/helpers/github-url' );
+const { getIssueUrl, getContributeUrl } = require( '../../../src/helpers/github-url.js' );
 
 /**
  * Gets url to project repository.
@@ -32,7 +32,7 @@ hexo.extend.filter.register( 'before_post_render', data => {
 		.replace( '.html', '.md' );
 
 	if ( data.issuesUrl === undefined || data.issuesUrl === true ) {
-		data.issuesUrl = githubUrlUtils.getIssueUrl( projectConfig.config );
+		data.issuesUrl = getIssueUrl( projectConfig.config );
 	}
 
 	const repoUrlDocs = guidesToRepos.default;
@@ -55,13 +55,13 @@ hexo.extend.filter.register( 'before_post_render', data => {
 		// Since each CKEditor 5's package has own `docs/` directory, we need to add the directory manually.
 		// Before: `/package/ckeditor5-package/features/foo.md`
 		// After: `/package/ckeditor5-package/docs/features/foo.md`
-		// That's why we need to disable adding `docs/` part in the `githubUrlUtils.getContributeUrl()` util.
+		// That's why we need to disable adding `docs/` part in the `getContributeUrl()` util.
 		pathKey = pathKey.split( '/' );
 		pathKey.splice( 3, 0, 'docs' );
 		pathKey = pathKey.join( '/' );
 	}
 
 	if ( data.contributeUrl === undefined || data.issuesUrl === true ) {
-		data.contributeUrl = githubUrlUtils.getContributeUrl( { contributeUrl, repoUrlDocs, doNotAddDocsInPath }, pathKey );
+		data.contributeUrl = getContributeUrl( { contributeUrl, repoUrlDocs, doNotAddDocsInPath }, pathKey );
 	}
 } );

package/scripts/filter/before-post-render/{code-switcher.js → code-switcher.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const transformCodeSwitcher = require( '../../utils/transformcodeswitcher' );
+const transformCodeSwitcher = require( '../../utils/transformcodeswitcher.cjs' );
 
 /**
  * Replaces <code-switcher> tags with the switchable code.

package/scripts/filter/before-post-render/{execute-and-insert-function-results.js → execute-and-insert-function-results.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const executeAndInsertFunctionResults = require( '../../utils/execute-and-insert-function-results' );
+const executeAndInsertFunctionResults = require( '../../utils/execute-and-insert-function-results.cjs' );
 
 /**
  * Replaces the `{@exec path/to/function.js}` expression with the module results.

package/scripts/filter/before-post-render/gloria/{add-breadcrumbs-data-to-page.js → add-breadcrumbs-data-to-page.cjs}

@@ -6,11 +6,11 @@
 'use strict';
 
 const upath = require( 'upath' );
-const decodeHtmlEntities = require( '../../../utils/decode-html-entities' );
-const dropUrlProtocol = require( '../../../utils/drop-url-protocol' );
-const concatUrlParts = require( '../../../utils/concat-url-parts' );
+const decodeHtmlEntities = require( '../../../utils/decode-html-entities.cjs' );
+const dropUrlProtocol = require( '../../../utils/drop-url-protocol.cjs' );
+const concatUrlParts = require( '../../../utils/concat-url-parts.cjs' );
 const relative_url = require( 'hexo/dist/plugins/helper/relative_url' ); // eslint-disable-line camelcase
-const dropInitSlash = require( '../../../utils/drop-init-slash' );
+const dropInitSlash = require( '../../../utils/drop-init-slash.cjs' );
 
 /**
  * `hexo.model` calls are REALLY slow, so we cache them. It takes approx

package/scripts/filter/before-post-render/gloria/{prerender-admonitions.js → prerender-admonitions.cjs}

@@ -8,7 +8,7 @@
 const {
 	transformMarkdownAdmonitions,
 	fastCheckIfContainsAdmonition
-} = require( '../../../utils/transform-markdown-admonitions' );
+} = require( '../../../utils/transform-markdown-admonitions.cjs' );
 
 /**
  * Make sure it's executed after `execute-and-insert-function-results.js` filter.

package/scripts/filter/before-post-render/gloria/{prerender-xml-pug-components.js → prerender-xml-pug-components.cjs}

@@ -42,13 +42,13 @@
 
 'use strict';
 
-const path = require( 'node:path' );
-const removeIndentation = require( '../../../utils/remove-indentation' );
-const createPrerenderPugTemplate = require( '../../../utils/pug-renderer/create-prerender-pug-template' );
+const upath = require( 'upath' );
+const removeIndentation = require( '../../../utils/remove-indentation.cjs' );
+const createPrerenderPugTemplate = require( '../../../utils/pug-renderer/create-prerender-pug-template.cjs' );
 const {
 	renderXMLPugComponentsInMarkdown,
 	extractReplacementBase64Tag
-} = require( '../../../utils/pug-to-xml-binding/render-xml-pug-components-in-markdown' );
+} = require( '../../../utils/pug-to-xml-binding/render-xml-pug-components-in-markdown.cjs' );
 
 const PATTERN_ELEMENTS = [
 	// Info boxes
@@ -320,7 +320,7 @@ hexo.extend.filter.register( 'before_post_render', page => {
 		return page;
 	}
 
-	const basePath = path.join( hexo.theme_dir, 'layout', 'gloria', '_components' );
+	const basePath = upath.join( hexo.theme_dir, 'layout', 'gloria', '_components' );
 	const result = renderXMLPugComponentsInMarkdown( page.content, {
 		hexo,
 		basePath,

package/scripts/filter/before-post-render/gloria/{render-post-render-pug-components.js → render-post-render-pug-components.cjs}

@@ -10,7 +10,7 @@ const { cloneNode } = require( 'domhandler' );
 const { default: render } = require( 'dom-serializer' );
 const { selectAll, selectOne } = require( 'css-select' );
 const { getAttributeValue, getChildren, replaceElement } = require( 'domutils' );
-const createPrerenderPugTemplate = require( '../../../utils/pug-renderer/create-prerender-pug-template' );
+const createPrerenderPugTemplate = require( '../../../utils/pug-renderer/create-prerender-pug-template.cjs' );
 
 /**
  * Components to be processed after markdown rendering

package/scripts/filter/before-post-render/{has-own-favicons.js → has-own-favicons.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const hasOwnFavicons = require( '../../utils/has-own-favicons' );
+const hasOwnFavicons = require( '../../utils/has-own-favicons.cjs' );
 
 hexo.extend.filter.register( 'before_post_render', data => {
 	return hasOwnFavicons( data, hexo );

package/scripts/filter/before-post-render/{infobox.js → infobox.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const transformInfoBox = require( '../../utils/transforminfobox' );
+const transformInfoBox = require( '../../utils/transforminfobox.cjs' );
 
 /**
  * Replaces <info-box> tags with notice box HTML.

package/scripts/filter/before-post-render/{insertchangelog.js → insertchangelog.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const insertChangelog = require( '../../utils/insertchangelog' );
+const insertChangelog = require( '../../utils/insertchangelog.cjs' );
 
 /**
  * Replaces the `{@changelog X.Y.Z}` expression with the changelog entries for the specified version.

package/scripts/filter/before-post-render/{replace-macros.js → replace-macros.cjs}

@@ -4,7 +4,7 @@
  */
 
 'use strict';
-const macroReplacer = require( '../../../src/tasks/macro-replacer' );
+const { macroReplacer } = require( '../../../src/tasks/macro-replacer.js' );
 
 /*
 Umberto issue: #697

package/scripts/helper/{find-main-category-page.js → find-main-category-page.cjs}

@@ -5,6 +5,6 @@
 
 'use strict';
 
-const findMainCategoryPage = require( '../utils/findmaincategorypage.js' );
+const findMainCategoryPage = require( '../utils/findmaincategorypage.cjs' );
 
 hexo.extend.helper.register( 'findMainCategoryPage', findMainCategoryPage );

package/scripts/helper/{normalize-badges.js → normalize-badges.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const normalizeBadges = require( '../utils/normalizebadges' );
+const normalizeBadges = require( '../utils/normalizebadges.cjs' );
 
 /**
  * Normalizes badged in page configuration

package/scripts/helper/{parse-href.js → parse-href.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const parseHref = require( '../utils/parse-href' );
+const parseHref = require( '../utils/parse-href.cjs' );
 
 /**
  * Parses an href string to generate a relative URL. If the href contains a cross-project reference, it will be logged.

package/scripts/helper/{u-capitalize.js → u-capitalize.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const capitalize = require( '../utils/capitalize' );
+const capitalize = require( '../utils/capitalize.cjs' );
 
 /**
  * Capitalizes the first letter of a string.

package/scripts/helper/{u-random-id.js → u-random-id.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const { randomId } = require( '../utils/random-id' );
+const { randomId } = require( '../utils/random-id.cjs' );
 
 /**
  * Generates a random UUID (v4). If a prefix is provided, it will be prepended to the UUID.

package/scripts/helper/{u-remove-indentation.js → u-remove-indentation.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const removeIndentation = require( '../utils/remove-indentation' );
+const removeIndentation = require( '../utils/remove-indentation.cjs' );
 
 /**
  * Removes indentation from a given string.

package/scripts/helper/{u-toc.js → u-toc.cjs}

@@ -5,6 +5,6 @@
 
 'use strict';
 
-const toc = require( '../utils/toc' );
+const toc = require( '../utils/toc.cjs' );
 
 hexo.extend.helper.register( 'uToc', toc );

package/scripts/utils/{concat-url-parts.js → concat-url-parts.cjs}

@@ -5,9 +5,9 @@
 
 'use strict';
 
-const dropInitSlash = require( './drop-init-slash' );
-const dropTrailingSlash = require( './drop-trailing-slash' );
-const compose = require( './compose' );
+const dropInitSlash = require( './drop-init-slash.cjs' );
+const dropTrailingSlash = require( './drop-trailing-slash.cjs' );
+const compose = require( './compose.cjs' );
 
 module.exports = function concatUrlParts( ...urls ) {
 	return (

package/scripts/utils/{execute-and-insert-function-results.js → execute-and-insert-function-results.cjs}

@@ -26,6 +26,8 @@ const PATH_REGEXP = /[\w.\\/-]+\.c?js$/;
  * @returns {Object}
  */
 module.exports = function executeAndInsertFunctionResults( page, hexo ) {
+	const { fs, require } = module.exports._dependencies;
+
 	page.content = page.content.replace( EXEC_REGEXP, ( match, path ) => {
 		if ( !page.projectName ) {
 			console.error( `"${ match }" expression cannot be executed on a page that is assigned to no project.` );
@@ -75,3 +77,8 @@ module.exports = function executeAndInsertFunctionResults( page, hexo ) {
 
 	return page;
 };
+
+module.exports._dependencies = {
+	fs,
+	require
+};

package/scripts/utils/gloria-after-post-render/{append-copy-heading-buttons.js → append-copy-heading-buttons.cjs}

@@ -16,25 +16,15 @@ const {
 	textContent
 } = require( 'domutils' );
 
-const createPrerenderPugTemplate = require( '../pug-renderer/create-prerender-pug-template' );
+const createPrerenderPugTemplate = require( '../pug-renderer/create-prerender-pug-template.cjs' );
 
-/**
- * Renders the button using Pug template.
- */
-const renderButton = createPrerenderPugTemplate( {
-	requires: [
-		'_components/svg/index',
-		'_components/icon/index',
-		'_components/tooltip-popover/index',
-		'_components/heading-link/index'
-	],
-	component: 'heading-link',
-	componentAttrs: {
-		mask: [ 'headingId' ]
-	}
-} );
+const renderButtonCache = new WeakMap();
 
 module.exports = function appendCopyHeadingButtons( doc ) {
+	const { createPrerenderPugTemplate } = module.exports._dependencies;
+
+	const renderButton = getRenderButton( createPrerenderPugTemplate );
+
 	// Do not process h1 tags as it's processed further by Umberto and may be removed.
 	for ( const heading of selectAll( 'h2, h3, h4, h5, h6', doc ) ) {
 		if ( hasClassOrParentWithClass( heading, 'no-transform' ) ) {
@@ -61,6 +51,33 @@ module.exports = function appendCopyHeadingButtons( doc ) {
 	return doc;
 };
 
+module.exports._dependencies = {
+	createPrerenderPugTemplate
+};
+
+function getRenderButton( createPrerenderPugTemplate ) {
+	if ( renderButtonCache.has( createPrerenderPugTemplate ) ) {
+		return renderButtonCache.get( createPrerenderPugTemplate );
+	}
+
+	const renderButton = createPrerenderPugTemplate( {
+		requires: [
+			'_components/svg/index',
+			'_components/icon/index',
+			'_components/tooltip-popover/index',
+			'_components/heading-link/index'
+		],
+		component: 'heading-link',
+		componentAttrs: {
+			mask: [ 'headingId' ]
+		}
+	} );
+
+	renderButtonCache.set( createPrerenderPugTemplate, renderButton );
+
+	return renderButton;
+}
+
 /**
  * Removes all empty anchors that were created to hold the heading links buttons.
  * "Empty" = no element children AND text content (after trimming and removing a single '#') is empty.

package/scripts/utils/{has-own-favicons.js → has-own-favicons.cjs}

@@ -21,6 +21,8 @@ const fs = require( 'node:fs' );
  * @returns {*}
  */
 module.exports = function hasOwnFavicons( page, hexo ) {
+	const { fs } = module.exports._dependencies;
+
 	const projectConfig = hexo.projectGlobals[ page.projectName ];
 
 	let hasOwnAssets = false;
@@ -40,6 +42,10 @@ module.exports = function hasOwnFavicons( page, hexo ) {
 	return page;
 };
 
+module.exports._dependencies = {
+	fs
+};
+
 /**
  * @typedef {object} ProjectGlobalConfig
  * @property {string} projectRootPath

package/scripts/utils/{inline-svg.js → inline-svg.cjs}

@@ -6,7 +6,7 @@
 'use strict';
 
 const fs = require( 'node:fs' );
-const path = require( 'node:path' );
+const upath = require( 'upath' );
 const { parseDocument } = require( 'htmlparser2' );
 const { Element, Text } = require( 'domhandler' );
 const { selectAll, selectOne } = require( 'css-select' );
@@ -21,7 +21,7 @@ module.exports = function inlineSvg( doc, themeDir ) {
 
 		// Construct the absolute path to the SVG file.
 		// Assuming the path is relative to the Hexo root.
-		const absolutePath = path.join( themeDir, svgPath );
+		const absolutePath = upath.join( themeDir, svgPath );
 
 		// Read the SVG file content
 		if ( !fs.existsSync( absolutePath ) ) {

package/scripts/utils/{logcrossprojectreference.js → logcrossprojectreference.cjs}

@@ -17,6 +17,8 @@ const { styleText } = require( 'node:util' );
  * @returns {String}
  */
 module.exports = function logCrossProjectReference( { expression, source } ) {
+	const { styleText } = module.exports._dependencies;
+
 	process.exitCode = 1;
 
 	const message = `${ styleText( 'red', 'Error:' ) } Failed while convert ${ styleText( 'cyanBright', expression ) } tag`;
@@ -27,3 +29,7 @@ module.exports = function logCrossProjectReference( { expression, source } ) {
 
 	return expression;
 };
+
+module.exports._dependencies = {
+	styleText
+};

package/scripts/utils/{parse-href.js → parse-href.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const { linkToApi, linkToSdk, linkToGuide } = require( './parselinks' );
+const { linkToApi, linkToSdk, linkToGuide } = require( './parselinks.cjs' );
 
 /**
  * Parses an href link from a string and returns the appropriate URL.