umberto 9.4.0 → 10.1.0

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/{normalizebadges.js → normalizebadges.cjs}

@@ -9,6 +9,10 @@ const KNOWN_BADGES = {
 	premium: {
 		name: 'premium',
 		label: 'Premium feature'
+	},
+	experimental: {
+		name: 'experiment',
+		label: 'Experimental feature'
 	}
 };
 

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.

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

@@ -7,7 +7,7 @@
 
 const crypto = require( 'node:crypto' );
 const upath = require( 'upath' );
-const logCrossProjectReference = require( './logcrossprojectreference' );
+const logCrossProjectReference = require( './logcrossprojectreference.cjs' );
 
 const ICON_REGEXP = /\\?{@icon(?:\s+@(\w+))?\s+([^}\s]+)\s*([^}]*)\\?}/g;
 
@@ -21,6 +21,8 @@ const ICON_REGEXP = /\\?{@icon(?:\s+@(\w+))?\s+([^}\s]+)\s*([^}]*)\\?}/g;
  * @returns {Object}
  */
 module.exports = function parseIconTag( page, hexo ) {
+	const { logCrossProjectReference } = module.exports._dependencies;
+
 	const relativeUrlHelper = hexo.extend.helper.store.relative_url;
 
 	page.content = page.content.replace( ICON_REGEXP, ( match, iconProject, iconPath, alternativeText ) => {
@@ -57,6 +59,10 @@ module.exports = function parseIconTag( page, hexo ) {
 	return page;
 };
 
+module.exports._dependencies = {
+	logCrossProjectReference
+};
+
 /**
  * @param {String} value
  * @return {String}

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

@@ -7,14 +7,13 @@
 
 const { styleText } = require( 'node:util' );
 const upath = require( 'upath' );
-const splitLongname = require( '../../src/helpers/split-longname' );
+const { splitLongname } = require( '../../src/helpers/split-longname.js' );
+const { findTargetDoclet } = require( '../../src/api-builder/utils/findtargetdoclet.js' );
+const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP } = require( '../../src/api-builder/utils/utils.js' );
+const logCrossProjectReference = require( './logcrossprojectreference.cjs' );
 
 const LINK_REGEXP = /\\?{(?:@linkapi|@link|@linksdk|@linkexample)\s+[^{]+?({[^}]+})?[^{}]*\\?}/g;
 
-const findTargetDoclet = require( '../../src/api-builder/utils/findtargetdoclet' );
-const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP } = require( '../../src/api-builder/utils/utils' );
-const logCrossProjectReference = require( './logcrossprojectreference' );
-
 /**
  * Converts @link or @linkapi tags into working links to guides or API docs.
  *
@@ -40,7 +39,7 @@ function parseLinks( page, hexo ) {
 	} );
 
 	return page;
-};
+}
 
 /**
  * @param {String} str
@@ -51,6 +50,7 @@ function parseLinks( page, hexo ) {
  * @param {Boolean} options.isSilentError
  */
 function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError }, onlyHref = false ) {
+	const { logCrossProjectReference } = module.exports._dependencies;
 	const linkMatchResult = str.match( /^{((?:@linkapi|@link)[\s\S]+)}$/ );
 
 	if ( !linkMatchResult ) {
@@ -236,6 +236,7 @@ function getOutputLink( href, description, isCustomDescription ) {
  * @param {Boolean} options.isSilentError
  */
 function linkToSdk( str, data, hexo, { relativeUrlHelper, isSilentError }, onlyHref = false ) {
+	const { logCrossProjectReference } = module.exports._dependencies;
 	const regExp = /(?:@linksdk|@linkexample) (?:@(\w+) )?(\w+)(?:\.html)?(#\S+)? ([^}]+)/;
 	const match = regExp.exec( str );
 
@@ -278,6 +279,7 @@ function linkToSdk( str, data, hexo, { relativeUrlHelper, isSilentError }, onlyH
  * @param {Boolean} options.isSilentError
  */
 function linkToGuide( str, data, hexo, { relativeUrlHelper, isSilentError }, onlyHref = false ) {
+	const { logCrossProjectReference } = module.exports._dependencies;
 	const rgxp = /@link(?:\s+@(\w+))?\s+([^}\s]+)\s*([^}]*)}/;
 	const match = rgxp.exec( str );
 
@@ -354,6 +356,7 @@ function linkToGuide( str, data, hexo, { relativeUrlHelper, isSilentError }, onl
  * @return {String}
  */
 function onError( { value, source, isSilent, description } ) {
+	const { styleText } = module.exports._dependencies;
 	if ( !isSilent ) {
 		process.exitCode = 1;
 
@@ -392,3 +395,8 @@ module.exports = {
 	linkToSdk,
 	linkToGuide
 };
+
+module.exports._dependencies = {
+	logCrossProjectReference,
+	styleText
+};

package/scripts/utils/pug-renderer/{create-prerender-pug-template.js → create-prerender-pug-template.cjs}

@@ -5,8 +5,8 @@
 
 'use strict';
 
-const { randomId, regenerateRandomIds } = require( '../random-id' );
-const renderPugComponent = require( './render-pug-component' );
+const { randomId, regenerateRandomIds } = require( '../random-id.cjs' );
+const renderPugComponent = require( './render-pug-component.cjs' );
 
 /**
  * Creates a template function for a Pug component with a built-in caching mechanism.
@@ -28,7 +28,7 @@ const renderPugComponent = require( './render-pug-component' );
  *   such as code in a code block.
  *
  * @example
- * const createPrerenderPugTemplate = require( './create-prerender-pug-template' );
+ * const createPrerenderPugTemplate = require( './create-prerender-pug-template.cjs' );
  *
  * // Creates a template for the 'code-block' component.
  * const codeBlockTemplate = createPrerenderPugTemplate( {

package/scripts/utils/pug-renderer/{render-pug-component.js → render-pug-component.cjs}

@@ -5,8 +5,8 @@
 
 'use strict';
 
-const path = require( 'node:path' );
-const hexoManager = require( '../../../src/hexo-manager' );
+const upath = require( 'upath' );
+const { hexoManager } = require( '../../../src/hexo-manager.js' );
 
 /**
  * Renders a Pug component with specified includes and parameters.
@@ -35,8 +35,8 @@ module.exports = function renderPugComponent(
 	// Default base path is the components directory in the theme
 	// Handle case where hexo.theme_dir might be undefined
 	const resolvedHexo = hexo || hexoManager.hexo;
-	const themeDir = resolvedHexo && resolvedHexo.theme_dir || path.join( __dirname, '../../themes/umberto' );
-	const componentsPath = basePath || path.join( themeDir, 'layout', 'gloria', '_components' );
+	const themeDir = resolvedHexo && resolvedHexo.theme_dir || upath.join( __dirname, '../../themes/umberto' );
+	const componentsPath = basePath || upath.join( themeDir, 'layout', 'gloria', '_components' );
 
 	// Prepare includes statements
 	const includeStatements = requires.map( include => `include ${ include }` );

package/scripts/utils/pug-to-xml-binding/parser/{xml-components-parser.js → xml-components-parser.cjs}

@@ -7,8 +7,8 @@
 
 const { inspect } = require( 'node:util' );
 
-const removeIndentation = require( '../../remove-indentation.js' );
-const ParserCursor = require( '../../parser-cursor.js' );
+const removeIndentation = require( '../../remove-indentation.cjs' );
+const ParserCursor = require( '../../parser-cursor.cjs' );
 
 /**
  * A parser for converting markdown containing HTML-like markup into a tree structure.

package/scripts/utils/pug-to-xml-binding/{render-xml-pug-components-in-markdown.js → render-xml-pug-components-in-markdown.cjs}

@@ -5,9 +5,9 @@
 
 'use strict';
 
-const transformXMLTreeToPug = require( './transform-xml-tree-to-pug.js' );
-const XMLComponentsParser = require( './parser/xml-components-parser.js' );
-const { walkXMLTree, TreeWalkActions } = require( './parser/walk-xml-tree.js' );
+const transformXMLTreeToPug = require( './transform-xml-tree-to-pug.cjs' );
+const XMLComponentsParser = require( './parser/xml-components-parser.cjs' );
+const { walkXMLTree, TreeWalkActions } = require( './parser/walk-xml-tree.cjs' );
 
 /**
  * Slices XML components from Markdown content and transforms them to Pug format.

package/scripts/utils/pug-to-xml-binding/{transform-xml-tree-to-pug.js → transform-xml-tree-to-pug.cjs}

@@ -10,7 +10,7 @@
 
 'use strict';
 
-const { TreeWalkActions, walkXMLTree } = require( './parser/walk-xml-tree' );
+const { TreeWalkActions, walkXMLTree } = require( './parser/walk-xml-tree.cjs' );
 
 /**
  * Transforms an XML tree structure into Pug mixin syntax.

package/scripts/utils/{spritesheet-svg.js → spritesheet-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, cloneNode } = require( 'domhandler' );
 const { selectAll, selectOne } = require( 'css-select' );
@@ -84,7 +84,7 @@ function createSpritesheet( svgFiles, themeDir ) {
 	const iconViewBoxes = new Map();
 
 	for ( const [ iconId, svgPath ] of svgFiles.entries() ) {
-		const absolutePath = path.join( themeDir, svgPath );
+		const absolutePath = upath.join( themeDir, svgPath );
 
 		if ( !fs.existsSync( absolutePath ) ) {
 			console.warn( `SVG file not found: ${ absolutePath }` );

package/scripts/utils/{transform-markdown-admonitions.js → transform-markdown-admonitions.cjs}

@@ -5,7 +5,7 @@
 
 'use strict';
 
-const ParserCursor = require( './parser-cursor' );
+const ParserCursor = require( './parser-cursor.cjs' );
 
 /**
  * Transforms Github style admonitions in markdown to a rendered callouts.

package/src/api-builder/api-builder.js

@@ -3,38 +3,36 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const upath = require( 'upath' );
-const fs = require( 'fs-extra' );
-const { parseDocument } = require( 'htmlparser2' );
-const { selectAll } = require( 'css-select' );
-const { textContent, removeElement } = require( 'domutils' );
-const { default: TinyPool } = require( 'tinypool' );
-const FileNameManager = require( './classes/file-name-manager' );
-const HtmlFile = require( './classes/html-file' );
-const DocDataFactory = require( './classes/doc-data-factory' );
-const DescriptionParser = require( './classes/description-parser' );
-const NavigationTree = require( './classes/navigation-tree' );
-const capitalize = require( '../helpers/capitalize' );
-const getShortModulePath = require( '../helpers/get-short-module-path' );
-const getDocSearchConfig = require( '../helpers/get-docsearch-config' );
-const splitLongname = require( '../helpers/split-longname' );
-const githubUrlUtils = require( '../helpers/github-url' );
-const getReportIssueWidgetUrl = require( '../../scripts/utils/getreportissuewidgeturl' );
-const getPageGroupHelper = require( '../../src/hexo/helper/get-page-group' );
-const findTargetDoclet = require( './utils/findtargetdoclet' );
-
-const { randomId } = require( '../../scripts/utils/random-id' );
-const parseHref = require( '../../scripts/utils/parse-href' );
-const hexoManager = require( '../hexo-manager' );
+import upath from 'upath';
+import fs from 'fs-extra';
+import { parseDocument } from 'htmlparser2';
+import { selectAll } from 'css-select';
+import { textContent, removeElement } from 'domutils';
+import TinyPool from 'tinypool';
+import { FileNameManager } from './classes/file-name-manager.js';
+import { HtmlFile } from './classes/html-file.js';
+import { DocDataFactory } from './classes/doc-data-factory.js';
+import { DescriptionParser } from './classes/description-parser.js';
+import { NavigationTree } from './classes/navigation-tree.js';
+import { capitalize } from '../helpers/capitalize.js';
+import { getShortModulePath } from '../helpers/get-short-module-path.js';
+import { getDocsearchConfig as getDocSearchConfig } from '../helpers/get-docsearch-config.js';
+import { splitLongname } from '../helpers/split-longname.js';
+import { getIssueUrl, getFullGithubLink } from '../helpers/github-url.js';
+import getReportIssueWidgetUrl from '../../scripts/utils/getreportissuewidgeturl.cjs';
+import { randomId } from '../../scripts/utils/random-id.cjs';
+import parseHref from '../../scripts/utils/parse-href.cjs';
+import { getPageGroup as getPageGroupHelper } from '../hexo/helper/get-page-group.js';
+
+import { hexoManager } from '../hexo-manager.js';
+import { findTargetDoclet } from './utils/findtargetdoclet.js';
 
 /**
  * Renders HTML for every module, class, mixin etc.
  *
  * @type {module.ApiBuilder}
  */
-module.exports = class ApiBuilder {
+export class ApiBuilder {
 	/**
 	 * @param templateCollection
 	 * @param dataCollection
@@ -206,7 +204,7 @@ module.exports = class ApiBuilder {
 		this._filterHtml = this._tmplCol.renderTemplate( '_partial/filter' );
 
 		const pool = new TinyPool( {
-			filename: require.resolve( './build-page-worker.js' )
+			filename: new URL( './build-page-worker.js', import.meta.url ).pathname
 		} );
 
 		await this._getPages( pool, modulesData, 'module' );
@@ -505,7 +503,7 @@ module.exports = class ApiBuilder {
 					realImportPath,
 					shortHiddenPath: splitParts.length > 0 ? splitParts.join( '/' ) : '',
 					isApi: true,
-					issuesUrl: githubUrlUtils.getIssueUrl( this._projectConfig ),
+					issuesUrl: getIssueUrl( this._projectConfig ),
 					startPage: this._projectConfig.startPage ? '/' + this._projectConfig.startPage : '/index.html',
 					canonicalUrlBeginning: this.canonicalUrlBeginning,
 					'meta-description': trimDescription( { min: 155, max: 300, text: metaDescription } ),
@@ -514,7 +512,7 @@ module.exports = class ApiBuilder {
 					'dc-description': trimDescription( { min: 300, max: 600, text: metaDescription } )
 				};
 
-				// This line needs to be sync with the `scripts/filter/before-post-render/add-project-info-to-page.js` file.
+				// This line needs to be sync with the `scripts/filter/before-post-render/add-project-info-to-page.cjs` file.
 				page.reportIssueWidget = getReportIssueWidgetUrl( page, this._projectConfig );
 
 				// More locals to be used in templates. Matching locals used by hexo.
@@ -522,7 +520,7 @@ module.exports = class ApiBuilder {
 					latestBasePath: upath.join( this._projectSlug, 'latest' ),
 					groups,
 					seeSourceRepositoryUrl: this._projectConfig.github !== undefined ? this._projectConfig.github.url : realImportPath,
-					getLinkToSource: githubUrlUtils.getFullGithubLink.bind( this ),
+					getLinkToSource: getFullGithubLink.bind( this ),
 					docSearchConfig: getDocSearchConfig( this._docSearch, {
 						groups: this._groups,
 						slug: this._projectSlug,

package/src/api-builder/build-page-worker.js

@@ -3,16 +3,14 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
+import fs from 'node:fs';
+import upath from 'upath';
+import { parseDocument } from 'htmlparser2';
+import render from 'dom-serializer';
+import inlineSvg from '../../scripts/utils/inline-svg.cjs';
+import spritesheetSvg from '../../scripts/utils/spritesheet-svg.cjs';
 
-const fs = require( 'node:fs' );
-const upath = require( 'upath' );
-const { parseDocument } = require( 'htmlparser2' );
-const { default: render } = require( 'dom-serializer' );
-const inlineSvg = require( '../../scripts/utils/inline-svg' );
-const spritesheetSvg = require( '../../scripts/utils/spritesheet-svg' );
-
-module.exports = function( {
+export const buildPageWorker = function( {
 	content,
 	navTreeHtml,
 	outputPath,
@@ -33,3 +31,5 @@ module.exports = function( {
 
 	fs.writeFileSync( outputPath, content, 'utf-8' );
 };
+
+export default buildPageWorker;

package/src/api-builder/classes/description-parser.js

@@ -3,19 +3,17 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const { styleText } = require( 'node:util' );
-const { parseDocument } = require( 'htmlparser2' );
-const { default: render } = require( 'dom-serializer' );
-const { selectAll, selectOne } = require( 'css-select' );
-const { replaceElement, removeElement, appendChild } = require( 'domutils' );
-const splitLongname = require( '../../helpers/split-longname' );
-const macroReplacer = require( '../../tasks/macro-replacer' );
-const findTargetDoclet = require( '../utils/findtargetdoclet' );
-const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP, LONG_NAME_MEMBER_SEPARATOR_REGEXP } = require( '../utils/utils' );
-const logCrossProjectReference = require( '../../../scripts/utils/logcrossprojectreference' );
-const createPrerenderPugTemplate = require( '../../../scripts/utils/pug-renderer/create-prerender-pug-template' );
+import { styleText } from 'node:util';
+import { parseDocument } from 'htmlparser2';
+import render from 'dom-serializer';
+import { selectAll, selectOne } from 'css-select';
+import { replaceElement, removeElement, appendChild } from 'domutils';
+import { splitLongname } from '../../helpers/split-longname.js';
+import { macroReplacer } from '../../tasks/macro-replacer.js';
+import { findTargetDoclet } from '../utils/findtargetdoclet.js';
+import { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP, LONG_NAME_MEMBER_SEPARATOR_REGEXP } from '../utils/utils.js';
+import logCrossProjectReference from '../../../scripts/utils/logcrossprojectreference.cjs';
+import createPrerenderPugTemplate from '../../../scripts/utils/pug-renderer/create-prerender-pug-template.cjs';
 
 const renderCodeBlockPug = createPrerenderPugTemplate( {
 	requires: [
@@ -39,7 +37,7 @@ const renderCodeBlockPug = createPrerenderPugTemplate( {
  * Class responsible for parsing doc descriptions.
  * @type {DescriptionParser}
  */
-module.exports = class DescriptionParser {
+export class DescriptionParser {
 	constructor( fileNameManager, dataCollection, { macrosVariables } = {} ) {
 		this._fileNameManager = fileNameManager;
 		this._dataCollection = dataCollection;

package/src/api-builder/classes/doc-data-factory.js

@@ -3,10 +3,8 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const isNonEmptyArray = require( '../../helpers/is-non-empty-array' );
-const splitLongname = require( '../../helpers/split-longname' );
+import { isNonEmptyArray } from '../../helpers/is-non-empty-array.js';
+import { splitLongname } from '../../helpers/split-longname.js';
 
 /**
  * Factory creating docs data to be used in templates.
@@ -14,7 +12,7 @@ const splitLongname = require( '../../helpers/split-longname' );
  * For example data of a class has to include all properties, methods, etc.
  * @type {DocDataFactory}
  */
-module.exports = class DocDataFactory {
+export class DocDataFactory {
 	/**
 	 * @param dataCollection
 	 * @param descriptionParser

package/src/api-builder/classes/file-name-manager.js

@@ -3,15 +3,13 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const escapeLongname = require( '../../helpers/escape-longname' );
+import { escapeLongname } from '../../helpers/escape-longname.js';
 
 /**
  * Handles filenames of various entities. Makes sure filenames are unique and do not contain forbidden characters.
  * Allows to get a filename for a doclet's longname.
  */
-module.exports = class FileNameManager {
+export class FileNameManager {
 	constructor() {
 		this.longnameToUrl = new Map();
 		this.fileNames = new Set();

package/src/api-builder/classes/html-file.js

@@ -3,15 +3,13 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const upath = require( 'upath' );
+import upath from 'upath';
 
 /**
  * Stores HTML rendered by a pug template.
  * @type {module.HtmlFile}
  */
-module.exports = class HtmlFile {
+export class HtmlFile {
 	/**
 	 * @param {String} content Content of the file.
 	 * @param {String} pathToFile Path to the file.

package/src/api-builder/classes/navigation-tree.js

@@ -3,13 +3,11 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
-const upath = require( 'upath' );
-const isNonEmptyArray = require( '../../helpers/is-non-empty-array' );
-const TreeModel = require( 'tree-model' );
-const Node = require( './tree-node' );
-const fs = require( 'fs-extra' );
+import upath from 'upath';
+import { isNonEmptyArray } from '../../helpers/is-non-empty-array.js';
+import TreeModel from 'tree-model';
+import { Node } from './tree-node.js';
+import fs from 'fs-extra';
 
 const NODE_TYPES = {
 	ROOT: 'root',
@@ -38,7 +36,7 @@ const NODE_ORDER = {
  * Creates a data structure representing API navigation tree.
  * @type {module.NavigationTree}
  */
-module.exports = class NavigationTree {
+export class NavigationTree {
 	/**
 	 * @param {String} rootPath Path of the root node.
 	 * @param {Function} longnameToUrl Function returning a filename for a given longname.

package/src/api-builder/classes/tree-node.js

@@ -3,13 +3,11 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
 /**
  * Tree node used by API navigation tree.
  * @type {module.Node}
  */
-module.exports = class Node {
+export class Node {
 	/**
 	 * @param {NODE_TYPES} type
 	 * @param {String} name Name of the node. The name will be displayed to the user in a nav tree.

package/src/api-builder/utils/findtargetdoclet.js

@@ -3,8 +3,6 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
 /**
  * A helper function used for searching for a proper doclet structure when creating a link
  * from a guide or an API page.
@@ -22,7 +20,7 @@
  * @param {Boolean} [options.query.memberOnly=false]
  * @returns {Object|null}
  */
-module.exports = function findTargetDoclet( docletCollection, options ) {
+export function findTargetDoclet( docletCollection, options ) {
 	const { module, structure, member, label, query } = options;
 	const { skipModule, memberOnly } = ( query || {} );
 

package/src/api-builder/utils/utils.js

@@ -3,8 +3,6 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
-
 const DEDICATED_PAGE_DOCLET_KINDS = [
 	'module', 'class', 'typedef', 'mixin', 'interface', 'namespace'
 ];
@@ -12,30 +10,25 @@ const DEDICATED_PAGE_DOCLET_KINDS = [
 /**
  * Set of utils used in helpers to generate links to API definitions.
  */
-module.exports = {
-	/**
-	 * A regular expression used for extracting a member name from doclet full name, member of or just a name.
-	 */
-	MEMBER_NAME_REGEXP: /([{}\-\w$]+)(?::([A-Z0-9a-z_:{}]+))?$/,
-	//                               ^ Sync with the `LONG_NAME_LABEL_REGEXP` value.
+export const MEMBER_NAME_REGEXP = /([{}\-\w$]+)(?::([A-Z0-9a-z_:{}]+))?$/;
+//                                             ^ Sync with the `LONG_NAME_LABEL_REGEXP` value.
 
-	/**
-	 * A regular expression used for removing a label (if specified) from a member name.
-	 * The regexp is used in `MEMBER_NAME_REGEXP` as a group, so the particular group should be synced.
-	 */
-	LONG_NAME_LABEL_REGEXP: /(?::([A-Z0-9a-z_:{}]+))?$/,
+/**
+ * A regular expression used for removing a label (if specified) from a member name.
+ * The regexp is used in `MEMBER_NAME_REGEXP` as a group, so the particular group should be synced.
+ */
+export const LONG_NAME_LABEL_REGEXP = /(?::([A-Z0-9a-z_:{}]+))?$/;
 
-	/**
-	 * A regular expression used for separating a definition (a class, an interface, etc.) and a member name.
-	 */
-	LONG_NAME_MEMBER_SEPARATOR_REGEXP: /[#.]/,
+/**
+ * A regular expression used for separating a definition (a class, an interface, etc.) and a member name.
+ */
+export const LONG_NAME_MEMBER_SEPARATOR_REGEXP = /[#.]/;
 
-	/**
-	 * @param {Object} doclet
-	 * @param {String} doclet.kind
-	 * @returns {Boolean}
-	 */
-	hasDedicatedApiPages( doclet ) {
-		return DEDICATED_PAGE_DOCLET_KINDS.includes( doclet.kind );
-	}
-};
+/**
+ * @param {Object} doclet
+ * @param {String} doclet.kind
+ * @returns {Boolean}
+ */
+export function hasDedicatedApiPages( doclet ) {
+	return DEDICATED_PAGE_DOCLET_KINDS.includes( doclet.kind );
+}

package/src/data-converter/converters/jsdoc2umberto.js

@@ -3,11 +3,9 @@
  * For licensing, see LICENSE.md.
  */
 
-'use strict';
+import upath from 'upath';
 
-const upath = require( 'upath' );
-
-module.exports = data => {
+export const jsdoc2umberto = data => {
 	const parsed = JSON.parse( data ).doclets;
 
 	if ( !parsed ) {