umberto 9.3.0 → 10.0.0

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
@@ -151,6 +149,7 @@ module.exports = class ApiBuilder {
 		} );
 
 		this._navTreeHtml = '';
+		this._navTreeHtmlByPackage = {};
 		this._filterHtml = '';
 
 		/**
@@ -205,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' );
@@ -255,6 +254,15 @@ module.exports = class ApiBuilder {
 		return this._navTreeHtml;
 	}
 
+	/**
+	 * Get HTML of API navigation tree by package name.
+	 *
+	 * @returns {Object}
+	 */
+	getNavTreeByPackage() {
+		return Object.assign( {}, this._navTreeHtmlByPackage );
+	}
+
 	/**
 	 * Get HTML of API error codes.
 	 * @returns {String}
@@ -385,13 +393,55 @@ module.exports = class ApiBuilder {
 			}
 		}
 
-		this._navTreeHtml = this._tmplCol.renderTemplate( '_partial/navtree', {
+		this._navTreeHtml = this._renderNavTreeHtml();
+		this._navTreeHtmlByPackage = this._buildNavTreeHtmlByPackage();
+	}
+
+	/**
+	 * Renders API navigation tree HTML.
+	 *
+	 * @param {String|null} activeApiPackage Package name used to expand its subtree.
+	 * @returns {String}
+	 */
+	_renderNavTreeHtml( activeApiPackage = null ) {
+		return this._tmplCol.renderTemplate( '_partial/navtree', {
 			projectLocals: {
 				apiTree: this._navTree
-			}
+			},
+			activeApiPackage
 		} );
 	}
 
+	/**
+	 * Builds an object of API navigation tree HTML keyed by package name.
+	 *
+	 * @returns {Object}
+	 */
+	_buildNavTreeHtmlByPackage() {
+		const htmlByPackage = {};
+		const rootChildren = this._navTree.getTree().getChildren();
+
+		if ( !Array.isArray( rootChildren ) || rootChildren.length === 0 ) {
+			return htmlByPackage;
+		}
+
+		for ( const child of rootChildren ) {
+			if ( child.getProp( 'type' ) !== this._navTree.NODE_TYPES.PACKAGE ) {
+				continue;
+			}
+
+			const packageName = child.getProp( 'name' );
+
+			if ( !packageName ) {
+				continue;
+			}
+
+			htmlByPackage[ packageName ] = this._renderNavTreeHtml( packageName );
+		}
+
+		return htmlByPackage;
+	}
+
 	/**
 	 * Renders HTML of each API docs page and creates an HtmlFile instance for that page.
 	 */
@@ -412,6 +462,7 @@ module.exports = class ApiBuilder {
 				const shortModulePath = getShortModulePath( data.longname );
 				const split = splitLongname( data.longname );
 				const splitParts = [ split.packageName, ...split.directoryNames ];
+				const navTreeHtml = this._navTreeHtmlByPackage[ split.packageName ] || this._navTreeHtml;
 				const realImportPath = typeof this._getRealImportPath === 'function' ? this._getRealImportPath( shortModulePath ) : '';
 
 				let title;
@@ -452,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 } ),
@@ -461,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.
@@ -469,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,
@@ -498,7 +549,7 @@ module.exports = class ApiBuilder {
 				jobs.push(
 					pool.run( {
 						content: view.content,
-						navTreeHtml: this._navTreeHtml,
+						navTreeHtml,
 						outputPath: upath.join( view.dirname, view.basename ),
 						themeDir: hexoManager.hexo.theme_dir
 					} )

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.
@@ -267,7 +265,7 @@ module.exports = class NavigationTree {
 					return '';
 				}
 
-				const packageGuidePath = upath.join(
+				const packageGuidePath = upath.resolve(
 					that.projectRootPath,
 					packagePath.path,
 					'docs',

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 || {} );