@qubit-ltd/jsdoc-theme 1.5.1 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # qubit-jsdoc-theme
2
2
 
3
- [![Stars](https://img.shields.io/github/stars/Haixing-Hu/qubit-jsdoc-theme)](https://github.com/Haixing-Hu/qubit-jsdoc-theme) [![Fork](https://img.shields.io/github/forks/Haixing-Hu/qubit-jsdoc-theme)](https://github.com/Haixing-Hu/qubit-jsdoc-theme/fork) ![Version](https://img.shields.io/badge/version-1.5.0-005bff) [![Issues Open](https://img.shields.io/github/issues/Haixing-Hu/qubit-jsdoc-theme)](https://github.com/Haixing-Hu/qubit-jsdoc-theme/issues) [![Contributors](https://img.shields.io/github/contributors/Haixing-Hu/qubit-jsdoc-theme)](https://github.com/Haixing-Hu/qubit-jsdoc-theme/graphs/contributors) [![license](https://img.shields.io/github/license/Haixing-Hu/qubit-jsdoc-theme)](https://github.com/Haixing-Hu/qubit-jsdoc-theme/blob/master/LICENSE)
3
+ [![Stars](https://img.shields.io/github/stars/qubit-ltd/jsdoc-theme)](https://github.com/qubit-ltd/jsdoc-theme) [![Fork](https://img.shields.io/github/forks/qubit-ltd/jsdoc-theme)](https://github.com/qubit-ltd/jsdoc-theme/fork) ![Version](https://img.shields.io/badge/version-1.5.0-005bff) [![Issues Open](https://img.shields.io/github/issues/qubit-ltd/jsdoc-theme)](https://github.com/qubit-ltd/jsdoc-theme/issues) [![Contributors](https://img.shields.io/github/contributors/qubit-ltd/jsdoc-theme)](https://github.com/qubit-ltd/jsdoc-theme/graphs/contributors) [![license](https://img.shields.io/github/license/qubit-ltd/jsdoc-theme)](https://github.com/qubit-ltd/jsdoc-theme/blob/master/LICENSE)
4
4
 
5
5
  <br>
6
6
 
@@ -826,8 +826,8 @@ For the base theme changelog, see [clean-jsdoc-theme changelog](https://github.c
826
826
  ## Developing
827
827
 
828
828
  ```bash
829
- git clone https://github.com/Haixing-Hu/qubit-jsdoc-theme.git
830
- cd qubit-jsdoc-theme
829
+ git clone https://github.com/qubit-ltd/jsdoc-theme.git
830
+ cd jsdoc-theme
831
831
  npm install
832
832
  npm install jsdoc --no-save
833
833
  npm run build
@@ -844,7 +844,7 @@ This will generate demo documentation in the `output` folder.
844
844
 
845
845
  ## Contributing
846
846
 
847
- We welcome contributions! Please feel free to submit issues and pull requests on [GitHub](https://github.com/Haixing-Hu/qubit-jsdoc-theme).
847
+ We welcome contributions! Please feel free to submit issues and pull requests on [GitHub](https://github.com/qubit-ltd/jsdoc-theme).
848
848
 
849
849
  ## Acknowledgments
850
850
 
@@ -852,8 +852,8 @@ This project is based on the excellent [clean-jsdoc-theme](https://github.com/an
852
852
 
853
853
  ## Contributors
854
854
 
855
- <a href="https://github.com/Haixing-Hu/qubit-jsdoc-theme/graphs/contributors">
856
- <img src="https://contrib.rocks/image?repo=Haixing-Hu/qubit-jsdoc-theme" alt="qubit-jsdoc-theme-contributors" />
855
+ <a href="https://github.com/qubit-ltd/jsdoc-theme/graphs/contributors">
856
+ <img src="https://contrib.rocks/image?repo=qubit-ltd/jsdoc-theme" alt="qubit-jsdoc-theme-contributors" />
857
857
  </a>
858
858
 
859
859
  ## Thanks
@@ -862,7 +862,7 @@ Thanks to [fuse.js](https://fusejs.io/), [hljs](https://highlightjs.org/), [tipp
862
862
 
863
863
  ## Contact
864
864
 
865
- If you like this project, please give it a <a href="https://github.com/Haixing-Hu/qubit-jsdoc-theme" data-icon="octicon-star" aria-label="Star Haixing-Hu/qubit-jsdoc-theme on GitHub">star</a>.
865
+ If you like this project, please give it a <a href="https://github.com/qubit-ltd/jsdoc-theme" data-icon="octicon-star" aria-label="Star qubit-ltd/jsdoc-theme on GitHub">star</a>.
866
866
 
867
867
  Mail: <a href="mailto:starfish.hu@gmail.com">starfish.hu@gmail.com</a> <br>
868
868
 
package/helpers/i18n.js CHANGED
@@ -17,7 +17,7 @@ function loadTranslations(language) {
17
17
  __dirname,
18
18
  "..",
19
19
  "i18n",
20
- `${language}.json`
20
+ `${language}.json`,
21
21
  );
22
22
 
23
23
  try {
@@ -29,7 +29,7 @@ function loadTranslations(language) {
29
29
  } catch (error) {
30
30
  console.warn(
31
31
  `Failed to load translations for language: ${language}`,
32
- error.message
32
+ error.message,
33
33
  );
34
34
  }
35
35
  return false;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qubit-ltd/jsdoc-theme",
3
- "version": "1.5.1",
3
+ "version": "1.5.2",
4
4
  "description": "A customized JSDoc theme based on clean-jsdoc-theme, enhanced with properties table and constructor detection features for Qubit projects.",
5
5
  "main": "publish.js",
6
6
  "author": "Haixing Hu (starfish.hu@gmail.com)",
@@ -12,18 +12,16 @@
12
12
  "lint:style": "stylelint-config-prettier-check && stylelint static/styles/",
13
13
  "lint": "npm run lint:js && npm run lint:style",
14
14
  "prepublishOnly": "npm run lint && npm run build",
15
- "deploy": "npm run lint && npm run build && npm publish --registry='https://npm.qubit.ltd/' --access public",
16
- "deploy:public": "npm run lint && npm run build && npm publish --registry='https://registry.npmjs.org/' --access public",
17
- "deploy:all": "npm run deploy && npm publish --registry='https://registry.npmjs.org/' --access public"
15
+ "deploy": "npm run lint && npm run build && npm publish --registry='https://registry.npmjs.org/' --access public"
18
16
  },
19
17
  "repository": {
20
18
  "type": "git",
21
- "url": "git+https://github.com/Haixing-Hu/qubit-jsdoc-theme.git"
19
+ "url": "git+https://github.com/qubit-ltd/jsdoc-theme.git"
22
20
  },
23
21
  "bugs": {
24
- "url": "https://github.com/Haixing-Hu/qubit-jsdoc-theme/issues"
22
+ "url": "https://github.com/qubit-ltd/jsdoc-theme/issues"
25
23
  },
26
- "homepage": "https://github.com/Haixing-Hu/qubit-jsdoc-theme",
24
+ "homepage": "https://github.com/qubit-ltd/jsdoc-theme",
27
25
  "files": [
28
26
  "publish.js",
29
27
  "tmpl/**/*",
@@ -62,7 +60,7 @@
62
60
  "jsdoc": "^4.0.4",
63
61
  "postcss": "^8.5.6",
64
62
  "postcss-scss": "^4.0.9",
65
- "prettier": "^2.2.1",
63
+ "prettier": "^3.3.3",
66
64
  "stylelint": "^14.9.1",
67
65
  "stylelint-config-prettier": "^9.0.3",
68
66
  "stylelint-config-sass-guidelines": "^9.0.0",
package/publish.js CHANGED
@@ -153,7 +153,7 @@ function updateItemName(item) {
153
153
 
154
154
  if (attributes && attributes.length) {
155
155
  itemName = `${itemName}<span class="signature-attributes">${attributes.join(
156
- ", "
156
+ ", ",
157
157
  )}</span>`;
158
158
  }
159
159
 
@@ -307,9 +307,9 @@ function prefixModuleToItemAnchor(item) {
307
307
  "a",
308
308
  modulename,
309
309
  methodname,
310
- anchorLink
310
+ anchorLink,
311
311
  );
312
- }
312
+ },
313
313
  );
314
314
 
315
315
  return prettyAnchor || anchor;
@@ -355,14 +355,14 @@ function generateSourceFiles(sourceFiles, packageInfo, encoding = "utf8") {
355
355
  kind: "source",
356
356
  title: sourceOutFile.replace(".html", ""),
357
357
  code: helper.htmlsafe(
358
- fs.readFileSync(sourceFiles[file].resolved, encoding)
358
+ fs.readFileSync(sourceFiles[file].resolved, encoding),
359
359
  ),
360
360
  };
361
361
  } catch (e) {
362
362
  logger.error(
363
363
  "Error while generating source file %s: %s",
364
364
  file,
365
- e.message
365
+ e.message,
366
366
  );
367
367
  }
368
368
 
@@ -371,7 +371,7 @@ function generateSourceFiles(sourceFiles, packageInfo, encoding = "utf8") {
371
371
  [source],
372
372
  sourceOutFile,
373
373
  false,
374
- packageInfo
374
+ packageInfo,
375
375
  );
376
376
  });
377
377
  }
@@ -453,7 +453,7 @@ function buildSidebarMembers({
453
453
  if (!hasOwnProp.call(itemsSeen, item.longname)) {
454
454
  currentItem.anchor = linktoFn(
455
455
  item.longname,
456
- item.name.replace(/^module:/, "")
456
+ item.name.replace(/^module:/, ""),
457
457
  );
458
458
 
459
459
  if (methods.length) {
@@ -721,7 +721,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
721
721
 
722
722
  if (
723
723
  example.match(
724
- /^\s*<caption>([\s\S]+?)<\/caption>(\s*[\n\r])([\s\S]+)$/i
724
+ /^\s*<caption>([\s\S]+?)<\/caption>(\s*[\n\r])([\s\S]+)$/i,
725
725
  )
726
726
  ) {
727
727
  caption = RegExp.$1;
@@ -788,7 +788,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
788
788
  staticFilePaths =
789
789
  conf.default.staticFiles.include || conf.default.staticFiles.paths || [];
790
790
  staticFileFilter = new (require("jsdoc/src/filter").Filter)(
791
- conf.default.staticFiles
791
+ conf.default.staticFiles,
792
792
  );
793
793
  staticFileScanner = new (require("jsdoc/src/scanner").Scanner)();
794
794
 
@@ -797,7 +797,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
797
797
  const extraStaticFiles = staticFileScanner.scan(
798
798
  [filePath],
799
799
  10,
800
- staticFileFilter
800
+ staticFileFilter,
801
801
  );
802
802
 
803
803
  extraStaticFiles.forEach((fileName) => {
@@ -866,7 +866,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
866
866
 
867
867
  // output pretty-printed source files by default
868
868
  outputSourceFiles = Boolean(
869
- conf.default && conf.default.outputSourceFiles !== false
869
+ conf.default && conf.default.outputSourceFiles !== false,
870
870
  );
871
871
 
872
872
  // add template helpers
@@ -901,7 +901,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
901
901
  view.excludeInherited = Boolean(themeOpts.exclude_inherited);
902
902
  view.baseURL = getBaseURL(themeOpts);
903
903
  view.shouldRemoveScrollbarStyle = Boolean(
904
- themeOpts.shouldRemoveScrollbarStyle
904
+ themeOpts.shouldRemoveScrollbarStyle,
905
905
  );
906
906
  attachModuleSymbols(find({ longname: { left: "module:" } }), members.modules);
907
907
 
@@ -926,7 +926,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
926
926
  [{ kind: "globalobj" }],
927
927
  globalUrl,
928
928
  true,
929
- packageInfo
929
+ packageInfo,
930
930
  );
931
931
  }
932
932
 
@@ -950,7 +950,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
950
950
  .concat(includeFilesListInHomepage ? files : []),
951
951
  indexUrl,
952
952
  true,
953
- packageInfo
953
+ packageInfo,
954
954
  );
955
955
 
956
956
  // set up the lists that we'll use to generate pages
@@ -975,7 +975,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
975
975
  myModules,
976
976
  helper.longnameToUrl[longname],
977
977
  true,
978
- packageInfo
978
+ packageInfo,
979
979
  );
980
980
  }
981
981
 
@@ -985,7 +985,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
985
985
  myClasses,
986
986
  helper.longnameToUrl[longname],
987
987
  true,
988
- packageInfo
988
+ packageInfo,
989
989
  );
990
990
  }
991
991
 
@@ -995,7 +995,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
995
995
  myNamespaces,
996
996
  helper.longnameToUrl[longname],
997
997
  true,
998
- packageInfo
998
+ packageInfo,
999
999
  );
1000
1000
  }
1001
1001
 
@@ -1005,7 +1005,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1005
1005
  myMixins,
1006
1006
  helper.longnameToUrl[longname],
1007
1007
  true,
1008
- packageInfo
1008
+ packageInfo,
1009
1009
  );
1010
1010
  }
1011
1011
 
@@ -1015,7 +1015,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1015
1015
  myExternals,
1016
1016
  helper.longnameToUrl[longname],
1017
1017
  true,
1018
- packageInfo
1018
+ packageInfo,
1019
1019
  );
1020
1020
  }
1021
1021
 
@@ -1025,7 +1025,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1025
1025
  myInterfaces,
1026
1026
  helper.longnameToUrl[longname],
1027
1027
  true,
1028
- packageInfo
1028
+ packageInfo,
1029
1029
  );
1030
1030
  }
1031
1031
  });
@@ -1084,7 +1084,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1084
1084
  }
1085
1085
  } catch (error) {
1086
1086
  console.error(
1087
- "There was some error while creating search array for tutorial."
1087
+ "There was some error while creating search array for tutorial.",
1088
1088
  );
1089
1089
  console.error(error);
1090
1090
  }
@@ -1096,7 +1096,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1096
1096
  generateTutorial(
1097
1097
  `Tutorial: ${child.title}`,
1098
1098
  child,
1099
- helper.tutorialToUrl(child.name)
1099
+ helper.tutorialToUrl(child.name),
1100
1100
  );
1101
1101
  saveChildren(child);
1102
1102
  });
@@ -1113,7 +1113,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
1113
1113
  path.join(outdir, "data", "search.json"),
1114
1114
  JSON.stringify({
1115
1115
  list: searchList,
1116
- })
1116
+ }),
1117
1117
  );
1118
1118
  }
1119
1119
  };
@@ -179,7 +179,7 @@ function bringElementIntoView(element, updateHistory = true) {
179
179
  setTimeout(
180
180
  // eslint-disable-next-line no-undef
181
181
  () => tocbotInstance.updateTocListActiveElement(element),
182
- 60
182
+ 60,
183
183
  );
184
184
  }
185
185
  var navbar = document.querySelector(".navbar-container");
@@ -431,7 +431,7 @@ function localUpdateFontSize(fontSize) {
431
431
  html.style.fontSize = fontSize + "px";
432
432
 
433
433
  var fontSizeText = document.querySelector(
434
- "#b77a68a492f343baabea06fad81f651e"
434
+ "#b77a68a492f343baabea06fad81f651e",
435
435
  );
436
436
 
437
437
  if (fontSizeText) {
@@ -621,7 +621,7 @@ function highlightActiveLinkInSidebar() {
621
621
  if (!element) {
622
622
  try {
623
623
  element = document.querySelector(
624
- `.sidebar a[href*='${targetURL.split("#")[0]}']`
624
+ `.sidebar a[href*='${targetURL.split("#")[0]}']`,
625
625
  );
626
626
  } catch (e) {
627
627
  console.error(e);
@@ -11,7 +11,7 @@ var NAVBAR_OPTIONS = {};
11
11
  var mainSection = document.querySelector("#main");
12
12
  var localStorageResizeObject = JSON.parse(
13
13
  // eslint-disable-next-line no-undef
14
- localStorage.getItem(NAVBAR_RESIZE_LOCAL_STORAGE_KEY)
14
+ localStorage.getItem(NAVBAR_RESIZE_LOCAL_STORAGE_KEY),
15
15
  );
16
16
 
17
17
  /**
@@ -66,7 +66,7 @@ var NAVBAR_OPTIONS = {};
66
66
  NAVBAR_RESIZE_LOCAL_STORAGE_KEY,
67
67
  JSON.stringify({
68
68
  width: navbar.style.width,
69
- })
69
+ }),
70
70
  );
71
71
  }
72
72