29 lines
927 B
JavaScript
29 lines
927 B
JavaScript
|
'use strict';
|
||
|
|
|
||
|
|
// We can use .replaceAll since Node.js 15
|
||
|
|
/* eslint-disable es-x/no-string-prototype-replaceall */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* JSDoc incorrectly handles dots in 'module' annotations. When the module name includes any dots,
|
||
|
|
* it removes everything up to the last dot. This makes no sense because file names (and MediaWiki
|
||
|
|
* module names) can contain dots. https://github.com/jsdoc/jsdoc/issues/1157
|
||
|
|
*
|
||
|
|
* To work around this bug, replace dots with special markers before JSDoc parses the code,
|
||
|
|
* and then replace them back after it has parsed the code.
|
||
|
|
*/
|
||
|
|
exports.handlers = {
|
||
|
|
beforeParse: function ( e ) {
|
||
|
|
e.source = e.source.replaceAll( /@(module|exports) .+/g, function ( m ) {
|
||
|
|
return m.replaceAll( '.', '(DOT)' );
|
||
|
|
} );
|
||
|
|
},
|
||
|
|
|
||
|
|
newDoclet: function ( e ) {
|
||
|
|
for ( const key in e.doclet ) {
|
||
|
|
if ( typeof e.doclet[ key ] === 'string' ) {
|
||
|
|
e.doclet[ key ] = e.doclet[ key ].replaceAll( '(DOT)', '.' );
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
};
|