umberto 2.1.8 → 2.3.0

package/.eslintrc.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 
@@ -10,7 +10,7 @@ module.exports = {
 	rules: {
 		'ckeditor5-rules/license-header': [ 'error', { headerLines: [
 			'/**',
-			' * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.',
+			' * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.',
 			' * For licensing, see LICENSE.md.',
 			' */'
 		] } ]

package/LICENSE.md

@@ -1,7 +1,7 @@
 Software License Agreement
 ==========================
 
-Copyright (c) 2017-2022, [CKSource](http://cksource.com) Holding sp. z o.o. All rights reserved.
+Copyright (c) 2017-2023, [CKSource](http://cksource.com) Holding sp. z o.o. All rights reserved.
 
 Licensed under the terms of [MIT License](https://opensource.org/licenses/MIT).
 

package/README.md

@@ -108,6 +108,7 @@ You can also have a look at [CKEditor5](https://github.com/ckeditor/ckeditor5/tr
 | `path` | Path where to look for documentation source files (Markdown files, images etc.). The path is relative to the location of `umberto.json`. |
 | `startPage` | Path to page linked in drop down menu. If there is nothing provided, then `index.html` (from main project directory) is used. |
 | `redirects` | Object where as a key is stored string representing `old-url` and as a value is stored string representing `new-url`. (_Currently redirects are used only in deployment scripts of big-bang docs._) |
+| `googleoptimize` | `domains` - Array of whitelisted domains from which GO can be used; `id` - container ID |
 | `googletagmanager` | `domains` - Array of whitelisted domains from which GA can be used; `gtm` - container ID |
 | `googleanalytics` | `domains` - Array of whitelisted domains from which GA can be used; `config` - options passed to ga('create') method |
 | `feedbackWidget` | `domains` - Array of whitelisted domains from which feedback widget can be used; `apiKey` - unique key for widget |

package/hexo-shim.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "2.1.8",
+  "version": "2.3.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "files": [
@@ -10,13 +10,14 @@
     ".editorconfig",
     ".eslintrc.js",
     "hexo-config.json",
-    "hexo-shim.js"
+    "hexo-shim.js",
+    "scripts-dev/postinstall.js"
   ],
   "dependencies": {
     "@babel/core": "^7.18.10",
     "@babel/polyfill": "^7.12.1",
     "@babel/preset-env": "^7.18.10",
-    "@ckeditor/jsdoc-plugins": "^30.3.5",
+    "@ckeditor/jsdoc-plugins": "^32.0.1",
     "babel-loader": "^8.2.5",
     "chalk": "^4.1.0",
     "cheerio": "^1.0.0-rc.12",
@@ -37,6 +38,7 @@
     "jquery": "~3.6.0",
     "js-beautify": "^1.14.4",
     "lodash": "^4.17.21",
+    "markdown-it": "^13.0.1",
     "markdown-it-expand-tabs": "^1.0.13",
     "markdown-it-toc-and-anchor": "^4.2.0",
     "medium-zoom": "^1.0.6",
@@ -54,7 +56,9 @@
     "webpack": "^5.74.0"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-dev-env": "^30.3.5",
+    "@ckeditor/ckeditor5-dev-bump-year": "^32.0.1",
+    "@ckeditor/ckeditor5-dev-ci": "^32.0.1",
+    "@ckeditor/ckeditor5-dev-release-tools": "^32.0.1",
     "browser-sync": "^2.27.10",
     "chai": "^4.3.6",
     "chokidar": "^3.5.3",
@@ -71,7 +75,7 @@
     "npm": ">=5.7.1"
   },
   "scripts": {
-    "postinstall": "node ./scripts/postinstall.js",
+    "postinstall": "node ./scripts-dev/postinstall.js",
     "dev:build-single": "node ./scripts-dev/build-single.js",
     "dev:build-multi": "node ./scripts-dev/build-multi.js",
     "dev:serve": "node ./scripts-dev/serve.js",
@@ -101,6 +105,6 @@
     "packages/**"
   ],
   "hexo": {
-    "version": "6.2.0"
+    "version": "6.3.0"
   }
 }

package/scripts/filter/after-post-render/basepath-replacer.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/fix-code-samples.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/gather-guides.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/img-linker.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/import-guide.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/insert-error-codes.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/linker.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/parseicontag.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/process-variables.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/snippets.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/time-end.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/time-start.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/after-post-render/validate-after-render.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/add-project-info-to-page.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/add-repo-url.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/change-output-path.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/escape-special-characters.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/execute-and-insert-function-results.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/infobox.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/insertchangelog.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/replace-macros.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/set-layout.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/filter/before-post-render/validate-page-data.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/find-main-category-page.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/get-pages-for-nav-tree.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/mark-empty-categories.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/normalize-badges.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/u-split-to-title-and-content.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/helper/u-toc.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/execute-and-insert-function-results.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/findmaincategorypage.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/getreportissuewidgeturl.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/insertchangelog.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/normalizebadges.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/parseicontag.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/parselinks.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 
@@ -11,6 +11,9 @@ const chalk = require( 'chalk' );
 
 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' );
+
 /**
  * Converts @link or @linkapi tags into working links to guides or API docs.
  *
@@ -68,8 +71,9 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 	}
 
 	const projectName = linkContentMatchResult[ 1 ] || data.projectName;
-	const itemName = linkContentMatchResult[ 2 ];
-	let linkText = linkContentMatchResult[ 3 ] || splitLongname( itemName ).name;
+	const { name, label } = splitLongname( linkContentMatchResult[ 2 ] );
+	const itemName = linkContentMatchResult[ 2 ].replace( LONG_NAME_LABEL_REGEXP, '' );
+	let linkText = linkContentMatchResult[ 3 ] || name;
 
 	// Support link texts with backticks, wrapping them in <code>.
 	// TODO - a naive implementation.
@@ -86,10 +90,25 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 	}
 
 	const baseItemName = getBaseItemName( itemName );
-	const hashWithoutPrefix = itemName.replace( baseItemName, '' ).slice( 1 );
+	let hashWithoutPrefix = itemName.replace( baseItemName, '' ).slice( 1 );
 	const hash = hashWithoutPrefix ? `#${ hashWithoutPrefix }` : '';
 	const project = hexo.projectGlobals[ projectName ];
 
+	if ( hashWithoutPrefix.includes( '-' ) ) {
+		let [ type, description ] = hashWithoutPrefix.split( '-' );
+
+		// JSDuck replaces `$` with `s-`.
+		if ( type === 's' ) {
+			description = `s-${ description }`;
+		}
+
+		if ( type === 'event' ) {
+			hashWithoutPrefix = type;
+		} else {
+			hashWithoutPrefix = description;
+		}
+	}
+
 	let apiSlug;
 
 	if ( project && project.config ) {
@@ -105,49 +124,42 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 		} );
 	}
 
-	const basePath = projectName === data.projectName ?
-		data.BASE_PATH :
-		`${ projectName }/latest`;
-
+	const basePath = projectName === data.projectName ? data.BASE_PATH : `${ projectName }/latest`;
 	const fileName = getFileName( baseItemName );
 
 	let href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + hash ) );
 
-	if ( project && project.doclets ) {
-		const doclet = project.doclets.get( `ln:${ itemName }` ).getFirst();
-
-		const docletByExtraId = project.doclets.get( `id:${ itemName }` ).getFirst() ||
-			project.doclets.get( `id:${ baseItemName }#constant-${ hashWithoutPrefix }` ).getFirst();
-
-		// TODO The following code is buggy. E.g. for static method and instance method sharing the same name.
-		// Actually the `docletByBaseAndHash` should be just `doclet` - IDK why it was designed this way.
-		// This should be fixed in the future with tests on CKE5 and CKE4 codebases.
-		const docletByBaseAndHash = project.doclets.get( `ln:${ baseItemName }#${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }.${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }~${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }#event:${ hashWithoutPrefix }` ).getFirst();
-
-		if ( doclet && [ 'module', 'class', 'typedef', 'mixin', 'interface', 'namespace' ].includes( doclet.kind ) ) {
-			// If there is a doclet, having own HTML page (e.g. a class doclet),
-			// exactly matching the longname from @link tag, link directly without hash.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, getFileName( itemName ) ) );
-		} else if ( docletByExtraId ) {
-			// When link tag follows notation: ...SomeClass#method-methodName.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + `#${ docletByExtraId.extraId }` ) );
-		} else if ( docletByBaseAndHash ) {
-			// When link tag follows notation: ...SomeClass#methodName, then must use 'extraId' as the hash.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + `#${ docletByBaseAndHash.extraId }` ) );
-		} else {
-			return onError( {
-				value: str,
-				source: data.source,
-				isSilent: isSilentError,
-				description: 'No doclet found. Link remain not transformed.'
-			} );
-		}
+	if ( !project || !project.doclets ) {
+		return getOutputLink( href, linkText, !!linkContentMatchResult[ 3 ] );
 	}
 
-	return linkContentMatchResult[ 3 ] ? `<a href=${ href }>${ linkText }</a>` : `<a href=${ href }><code>${ linkText }</code></a>`;
+	const targetDoclet = findTargetDoclet( project.doclets, {
+		module: itemName,
+		structure: baseItemName,
+		member: hashWithoutPrefix,
+		label
+	} );
+
+	if ( !targetDoclet ) {
+		return onError( {
+			value: str, source: data.source, isSilent: isSilentError, description: 'No doclet found. Link remain not transformed.'
+		} );
+	}
+
+	if ( hasDedicatedApiPages( targetDoclet ) ) {
+		href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, getFileName( itemName ) ) );
+	} else {
+		href = [
+			relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName ) ),
+			encodeURI( targetDoclet.extraId )
+		].join( '#' );
+	}
+
+	if ( !linkContentMatchResult[ 3 ] && targetDoclet.kind === 'event' ) {
+		linkText = `event-${ targetDoclet.name }`;
+	}
+
+	return getOutputLink( href, linkText, !!linkContentMatchResult[ 3 ] );
 }
 
 /**
@@ -180,6 +192,14 @@ function getFileName( itemName ) {
 	return itemName.replace( /[/:.]/g, '_' ).replace( '~', '-' ) + '.html';
 }
 
+function getOutputLink( href, description, isCustomDescription ) {
+	if ( isCustomDescription ) {
+		return `<a href=${ href }>${ description }</a>`;
+	}
+
+	return `<a href=${ href }><code>${ description }</code></a>`;
+}
+
 /**
  * @param {String} str
  * @param {Object} data

package/scripts/utils/shoulddisplaynewindicator.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/scripts/utils/transforminfobox.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

package/{scripts → scripts-dev}/postinstall.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 

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

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
 
@@ -20,6 +20,8 @@ const splitLongname = require( '../helpers/split-longname' );
 const githubUrlUtils = require( '../helpers/github-url' );
 const getReportIssueWidgetUrl = require( '../../scripts/utils/getreportissuewidgeturl' );
 
+const findTargetDoclet = require( './utils/findtargetdoclet' );
+
 /**
  * Renders HTML for every module, class, mixin etc.
  *
@@ -523,15 +525,33 @@ module.exports = class ApiBuilder {
 		}
 	}
 
-	_getUrlAddressFromLongname( longname ) {
-		const doclet = this._dataCollection.get( `ln:${ longname }` ).getFirst();
+	/**
+	 * @protected
+	 * @param {LongNameParts} parts
+	 * @returns {String|null}
+	 */
+	_getUrlAddressFromLongname( parts ) {
+		if ( !parts.longnameBase ) {
+			return null;
+		}
 
-		if ( !doclet ) {
+		// Get a doclet to which we link.
+		const targetDoclet = findTargetDoclet( this._dataCollection, {
+			structure: parts.longnameBase,
+			member: parts.name,
+			label: parts.label,
+			query: {
+				memberOnly: true
+			}
+		} );
+
+		if ( !targetDoclet ) {
 			return null;
-		} else if ( [ 'cfg', 'member', 'function', 'event' ].includes( doclet.kind ) ) {
-			return `${ doclet.memberof }#${ doclet.extraId }`;
-		} else {
-			return doclet.longname;
 		}
+
+		return [
+			targetDoclet.memberof,
+			encodeURI( targetDoclet.extraId )
+		].join( parts.isStatic ? '.' : '#' );
 	}
 };