umberto 4.1.1 → 4.2.0

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.
Files changed (190) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/LICENSE.md +1 -1
  3. package/hexo-shim.js +1 -1
  4. package/package.json +1 -1
  5. package/scripts/filter/after-post-render/basepath-replacer.js +1 -1
  6. package/scripts/filter/after-post-render/fix-code-samples.js +1 -1
  7. package/scripts/filter/after-post-render/gather-guides.js +1 -1
  8. package/scripts/filter/after-post-render/img-linker.js +1 -1
  9. package/scripts/filter/after-post-render/import-guide.js +1 -1
  10. package/scripts/filter/after-post-render/insert-error-codes.js +1 -1
  11. package/scripts/filter/after-post-render/linker.js +1 -1
  12. package/scripts/filter/after-post-render/parseicontag.js +1 -1
  13. package/scripts/filter/after-post-render/process-variables.js +1 -1
  14. package/scripts/filter/after-post-render/snippets.js +1 -1
  15. package/scripts/filter/after-post-render/time-end.js +1 -1
  16. package/scripts/filter/after-post-render/time-start.js +1 -1
  17. package/scripts/filter/after-post-render/validate-after-render.js +1 -1
  18. package/scripts/filter/before-post-render/add-project-info-to-page.js +1 -1
  19. package/scripts/filter/before-post-render/add-repo-url.js +1 -1
  20. package/scripts/filter/before-post-render/change-output-path.js +1 -1
  21. package/scripts/filter/before-post-render/execute-and-insert-function-results.js +1 -1
  22. package/scripts/filter/before-post-render/infobox.js +1 -1
  23. package/scripts/filter/before-post-render/insertchangelog.js +1 -1
  24. package/scripts/filter/before-post-render/replace-macros.js +1 -1
  25. package/scripts/filter/before-post-render/set-layout.js +1 -1
  26. package/scripts/filter/before-post-render/validate-page-data.js +1 -1
  27. package/scripts/helper/find-main-category-page.js +1 -1
  28. package/scripts/helper/get-pages-for-nav-tree.js +1 -1
  29. package/scripts/helper/mark-empty-categories.js +1 -1
  30. package/scripts/helper/normalize-badges.js +1 -1
  31. package/scripts/helper/u-split-to-title-and-content.js +1 -1
  32. package/scripts/helper/u-toc.js +1 -1
  33. package/scripts/utils/execute-and-insert-function-results.js +1 -1
  34. package/scripts/utils/findmaincategorypage.js +1 -1
  35. package/scripts/utils/getreportissuewidgeturl.js +1 -1
  36. package/scripts/utils/insertchangelog.js +1 -1
  37. package/scripts/utils/normalizebadges.js +1 -1
  38. package/scripts/utils/parseicontag.js +1 -1
  39. package/scripts/utils/parselinks.js +1 -1
  40. package/scripts/utils/shoulddisplaynewindicator.js +1 -1
  41. package/scripts/utils/transforminfobox.js +1 -1
  42. package/src/api-builder/api-builder.js +1 -1
  43. package/src/api-builder/classes/description-parser.js +1 -1
  44. package/src/api-builder/classes/doc-data-factory.js +2 -1
  45. package/src/api-builder/classes/file-name-manager.js +1 -1
  46. package/src/api-builder/classes/html-file.js +1 -1
  47. package/src/api-builder/classes/navigation-tree.js +1 -1
  48. package/src/api-builder/classes/tree-node.js +1 -1
  49. package/src/api-builder/utils/findtargetdoclet.js +1 -1
  50. package/src/api-builder/utils/utils.js +1 -1
  51. package/src/data-converter/converters/jsdoc2umberto.js +1 -1
  52. package/src/data-converter/converters/jsduck2umberto.js +1 -1
  53. package/src/data-converter/converters/typedoc/abstractparser.js +39 -1
  54. package/src/data-converter/converters/typedoc/accessorparser.js +1 -1
  55. package/src/data-converter/converters/typedoc/classparser.js +1 -1
  56. package/src/data-converter/converters/typedoc/computedpropertyparser.js +1 -1
  57. package/src/data-converter/converters/typedoc/constantparser.js +1 -1
  58. package/src/data-converter/converters/typedoc/constructorparser.js +1 -1
  59. package/src/data-converter/converters/typedoc/errorparser.js +1 -1
  60. package/src/data-converter/converters/typedoc/eventparser.js +1 -1
  61. package/src/data-converter/converters/typedoc/functionparser.js +1 -1
  62. package/src/data-converter/converters/typedoc/interfaceparser.js +1 -1
  63. package/src/data-converter/converters/typedoc/methodparser.js +1 -1
  64. package/src/data-converter/converters/typedoc/moduleparser.js +1 -1
  65. package/src/data-converter/converters/typedoc/propertyparser.js +1 -1
  66. package/src/data-converter/converters/typedoc/typedoc.ts +1 -1
  67. package/src/data-converter/converters/typedoc/typedocconverter.js +24 -9
  68. package/src/data-converter/converters/typedoc/typeparser.js +2 -1
  69. package/src/data-converter/converters/typedoc2umberto.js +1 -1
  70. package/src/data-converter/data-collection.js +1 -1
  71. package/src/data-converter/data-provider.js +1 -1
  72. package/src/data-converter/doclet-collection.js +1 -1
  73. package/src/data-converter/middlewares/relation-fixer.js +1 -1
  74. package/src/helpers/capitalize.js +1 -1
  75. package/src/helpers/copy-file.js +1 -1
  76. package/src/helpers/create-filtering-data-attribs.js +1 -1
  77. package/src/helpers/doc-formats.js +1 -1
  78. package/src/helpers/escape-longname.js +1 -1
  79. package/src/helpers/extract-longname.js +1 -1
  80. package/src/helpers/get-api-infobox-tooltip.js +1 -1
  81. package/src/helpers/get-docsearch-config.js +1 -1
  82. package/src/helpers/get-file-patterns-to-process.js +1 -1
  83. package/src/helpers/get-short-module-path.js +1 -1
  84. package/src/helpers/github-url.js +1 -1
  85. package/src/helpers/glob-to-regexp.js +1 -1
  86. package/src/helpers/html-safe.js +1 -1
  87. package/src/helpers/is-non-empty-array.js +1 -1
  88. package/src/helpers/snippets.js +1 -1
  89. package/src/helpers/split-longname.js +1 -1
  90. package/src/hexo/filter/extend-config.js +1 -1
  91. package/src/hexo/filter/project-locals.js +1 -1
  92. package/src/hexo/get-repo-urls.js +1 -1
  93. package/src/hexo/helper/get-page-group.js +1 -1
  94. package/src/hexo/project-globals.js +1 -1
  95. package/src/hexo-manager.js +1 -1
  96. package/src/index.js +1 -1
  97. package/src/sdk-builder/get-sdk-sources.js +1 -1
  98. package/src/sdk-builder/sdk-builder.js +1 -1
  99. package/src/tasks/build-api-docs.js +1 -1
  100. package/src/tasks/build-documentation.js +1 -1
  101. package/src/tasks/build-sdk.js +1 -1
  102. package/src/tasks/build-snippets.js +1 -1
  103. package/src/tasks/cache-files.js +1 -1
  104. package/src/tasks/compile-sass.js +1 -1
  105. package/src/tasks/copy-assets.js +1 -1
  106. package/src/tasks/copy-files.js +1 -1
  107. package/src/tasks/copy-project-docs.js +1 -1
  108. package/src/tasks/copy-project-icons.js +1 -1
  109. package/src/tasks/create-redirect-page.js +1 -1
  110. package/src/tasks/create-sitemap.js +1 -1
  111. package/src/tasks/create-sym-links.js +1 -1
  112. package/src/tasks/execute-hooks.js +1 -1
  113. package/src/tasks/get-extra-files.js +1 -1
  114. package/src/tasks/get-hexo-config.js +1 -1
  115. package/src/tasks/get-main-config.js +1 -1
  116. package/src/tasks/get-project-config.js +1 -1
  117. package/src/tasks/macro-replacer.js +1 -1
  118. package/src/tasks/overwrite-api-guides.js +1 -1
  119. package/src/tasks/read-doc-sources.js +1 -1
  120. package/src/tasks/run-webpack.js +1 -1
  121. package/src/tasks/validate-html-w3c.js +1 -1
  122. package/src/tasks/validate-links.js +1 -1
  123. package/src/tasks/watcher.js +1 -1
  124. package/src/tasks/write-html-files.js +1 -1
  125. package/src/template/template-collection.js +1 -1
  126. package/themes/umberto/layout/_api-docs/_mixin/_link-or-text.pug +2 -0
  127. package/themes/umberto/layout/_api-docs/_mixin/_type.pug +3 -0
  128. package/themes/umberto/layout/_api-docs/api-base.pug +2 -1
  129. package/themes/umberto/layout/_api-docs/typedef.pug +8 -0
  130. package/themes/umberto/layout/api.pug +2 -1
  131. package/themes/umberto/layout/page.pug +2 -1
  132. package/themes/umberto/layout/sdk.pug +2 -1
  133. package/themes/umberto/src/css/_api-content.scss +1 -1
  134. package/themes/umberto/src/css/_api-info-box.scss +1 -1
  135. package/themes/umberto/src/css/_api-props-filter.scss +1 -1
  136. package/themes/umberto/src/css/_api-see-source.scss +1 -1
  137. package/themes/umberto/src/css/_api-subheader.scss +1 -1
  138. package/themes/umberto/src/css/_api-tree.scss +1 -1
  139. package/themes/umberto/src/css/_badge.scss +1 -1
  140. package/themes/umberto/src/css/_collapsinglist.scss +1 -1
  141. package/themes/umberto/src/css/_content.scss +1 -1
  142. package/themes/umberto/src/css/_docsearch.scss +1 -1
  143. package/themes/umberto/src/css/_dropdown.scss +1 -1
  144. package/themes/umberto/src/css/_editor-icon.scss +1 -1
  145. package/themes/umberto/src/css/_feedback-widget.scss +1 -1
  146. package/themes/umberto/src/css/_footer.scss +1 -1
  147. package/themes/umberto/src/css/_formatted.scss +1 -1
  148. package/themes/umberto/src/css/_guide-content.scss +1 -1
  149. package/themes/umberto/src/css/_guide-sdk-tree.scss +1 -1
  150. package/themes/umberto/src/css/_loading-spinner.scss +1 -1
  151. package/themes/umberto/src/css/_main.scss +1 -1
  152. package/themes/umberto/src/css/_navigation.scss +1 -1
  153. package/themes/umberto/src/css/_notice.scss +1 -1
  154. package/themes/umberto/src/css/_print.scss +1 -1
  155. package/themes/umberto/src/css/_prism.scss +1 -1
  156. package/themes/umberto/src/css/_rwd-breadcrumbs.scss +1 -1
  157. package/themes/umberto/src/css/_rwd-menu.scss +1 -1
  158. package/themes/umberto/src/css/_secondary-navigation.scss +1 -1
  159. package/themes/umberto/src/css/_theme-dark.scss +1 -1
  160. package/themes/umberto/src/css/_toggler.scss +1 -1
  161. package/themes/umberto/src/css/_top.scss +1 -1
  162. package/themes/umberto/src/css/_tree.scss +1 -1
  163. package/themes/umberto/src/css/_warning-banner.scss +1 -1
  164. package/themes/umberto/src/css/components/_lightbox.scss +1 -1
  165. package/themes/umberto/src/css/helpers/_color.scss +1 -1
  166. package/themes/umberto/src/css/helpers/_font.scss +1 -1
  167. package/themes/umberto/src/css/helpers/_globals.scss +1 -1
  168. package/themes/umberto/src/css/helpers/_reset.scss +1 -1
  169. package/themes/umberto/src/css/helpers/_spacing.scss +1 -1
  170. package/themes/umberto/src/css/pages/_sdk.scss +1 -1
  171. package/themes/umberto/src/css/styles.scss +1 -1
  172. package/themes/umberto/src/js/_anchors.js +1 -1
  173. package/themes/umberto/src/js/_apisearch.js +1 -1
  174. package/themes/umberto/src/js/_apitree.js +1 -1
  175. package/themes/umberto/src/js/_attachpermalinklistener.js +1 -1
  176. package/themes/umberto/src/js/_collapsables.js +1 -1
  177. package/themes/umberto/src/js/_copymobileapinavigation.js +1 -1
  178. package/themes/umberto/src/js/_devnames.js +1 -1
  179. package/themes/umberto/src/js/_dropdowns.js +1 -1
  180. package/themes/umberto/src/js/_filtering.js +1 -1
  181. package/themes/umberto/src/js/_imageModal.js +1 -1
  182. package/themes/umberto/src/js/_pagenavigation.js +1 -1
  183. package/themes/umberto/src/js/_prism.js +1 -1
  184. package/themes/umberto/src/js/_rwdmenu.js +1 -1
  185. package/themes/umberto/src/js/_samplecode.js +1 -1
  186. package/themes/umberto/src/js/_sidenavigation.js +1 -1
  187. package/themes/umberto/src/js/_toc.js +1 -1
  188. package/themes/umberto/src/js/_tooltips.js +1 -1
  189. package/themes/umberto/src/js/_warningbanner.js +1 -1
  190. package/themes/umberto/src/js/app.js +1 -1
package/src/data-converter/converters/typedoc/typedocconverter.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
@@ -415,18 +415,26 @@ class TypeConverter {
415
415
  const convertedType = this._convertSingleType( typeReflection );
416
416
 
417
417
  if ( type.type === 'array' ) {
418
- if ( !convertedType ) {
419
- return 'Array';
420
- }
418
+ return this.convertArray( convertedType );
419
+ }
421
420
 
422
- if ( convertedType instanceof Set ) {
423
- return [ ...convertedType ];
424
- }
421
+ return convertedType;
422
+ }
423
+
424
+ /**
425
+ * @param {TypedocTypeDetails|null} type
426
+ * @returns {string|Array}
427
+ */
428
+ convertArray( type ) {
429
+ if ( !type ) {
430
+ return 'Array';
431
+ }
425
432
 
426
- return [ convertedType ];
433
+ if ( type instanceof Set ) {
434
+ return [ ...type ];
427
435
  }
428
436
 
429
- return convertedType;
437
+ return [ type ];
430
438
  }
431
439
 
432
440
  /**
@@ -653,6 +661,13 @@ class TypeConverter {
653
661
  return this.convertIntrinsicType( typeReflection );
654
662
  }
655
663
 
664
+ // An array can be a part of a union type. Example: `string | Array<string> | Array<Array<string>>`.
665
+ // Hence, it needs to be parsed twice (`#convert()` and `#_convertSingleType()).
666
+ // See: #1189.
667
+ if ( typeReflection.type === 'array' ) {
668
+ return this.convertArray( typeReflection );
669
+ }
670
+
656
671
  // Inline type: an object or a function.
657
672
  if ( typeReflection.type === 'reflection' ) {
658
673
  if ( Array.isArray( typeReflection.declaration.signatures ) ) {
package/src/data-converter/converters/typedoc/typeparser.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
@@ -34,6 +34,7 @@ module.exports = class TypeParser extends AbstractParser {
34
34
  skipSource: this.shouldSkipSource( item ),
35
35
  description: this.getComment( item ),
36
36
  deprecated: this.isDeprecated( item ),
37
+ firedBy: this.getFiredBy( item, parentName ),
37
38
 
38
39
  // This property will be filled in the post-processing phase.
39
40
  typeParameters: null
package/src/data-converter/converters/typedoc2umberto.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/data-converter/data-collection.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/data-converter/data-provider.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/data-converter/doclet-collection.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/data-converter/middlewares/relation-fixer.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/capitalize.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/copy-file.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/create-filtering-data-attribs.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/doc-formats.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/escape-longname.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/extract-longname.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/get-api-infobox-tooltip.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/get-docsearch-config.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/get-file-patterns-to-process.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/get-short-module-path.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/github-url.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/glob-to-regexp.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/html-safe.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/is-non-empty-array.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/snippets.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/helpers/split-longname.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo/filter/extend-config.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo/filter/project-locals.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo/get-repo-urls.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo/helper/get-page-group.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo/project-globals.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/hexo-manager.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/sdk-builder/get-sdk-sources.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/sdk-builder/sdk-builder.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/build-api-docs.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/build-documentation.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/build-sdk.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/build-snippets.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/cache-files.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/compile-sass.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/copy-assets.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/copy-files.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/copy-project-docs.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/copy-project-icons.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/create-redirect-page.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/create-sitemap.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/create-sym-links.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/execute-hooks.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/get-extra-files.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/get-hexo-config.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/get-main-config.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/get-project-config.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/macro-replacer.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/overwrite-api-guides.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/read-doc-sources.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/run-webpack.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/validate-html-w3c.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/validate-links.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/watcher.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/tasks/write-html-files.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/src/template/template-collection.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2017-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md.
4
4
  */
5
5
 
package/themes/umberto/layout/_api-docs/_mixin/_link-or-text.pug CHANGED
@@ -27,6 +27,8 @@ mixin linkOrText( name, options = {} )
27
27
  - nameText += ( parts.isStatic ? '.' : '#' ) + parts.name
28
28
  else
29
29
  - nameText = parts.name || parts.longnameBase
30
+ if ( parts.name === 'event' && parts.label )
31
+ - nameText += `:${ parts.label }`
30
32
 
31
33
  - nameText = htmlsafe( nameText );
32
34
 
package/themes/umberto/layout/_api-docs/_mixin/_type.pug CHANGED
@@ -76,6 +76,9 @@ mixin renderType( type )
76
76
  //- Backward compatibility, when passing a `module:...` string.
77
77
  if ( typeof type === 'string' )
78
78
  +renderStringValue( type )
79
+ //- `intrinsic` type.
80
+ else if ( type.elementType )
81
+ | #{ type.elementType.name }
79
82
  else
80
83
  //- Complex structures introduced when generating API pages from TypeScript.
81
84
  if ( type instanceof Set )
package/themes/umberto/layout/_api-docs/api-base.pug CHANGED
@@ -37,7 +37,8 @@ block navtree
37
37
  != navTree
38
38
 
39
39
  block projectVersion
40
- meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
40
+ if page.permalinkDisableDomains
41
+ meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
41
42
 
42
43
  if projectLocals
43
44
  meta( name= 'project-version' content= projectLocals.projectVersion )
package/themes/umberto/layout/_api-docs/typedef.pug CHANGED
@@ -3,6 +3,7 @@ include ./_mixin/_api-title
3
3
  include ./_mixin/_params
4
4
  include ./_mixin/_return
5
5
  include ./_mixin/_related
6
+ include ./_mixin/_link-or-text
6
7
 
7
8
  block prepend content
8
9
  +apiTitle( { iconPath: 'assets/' + umbertoVersion + '/img/data.svg', kind: 'Typedef' } )
@@ -23,6 +24,13 @@ block append content
23
24
  if isNonEmptyArray( data.see )
24
25
  +related( data.see )
25
26
 
27
+ if data.firedBy
28
+ h2 Fired by
29
+ ul
30
+ each firedByItem in data.firedBy
31
+ li
32
+ +linkOrText( firedByItem.url, { linkText: firedByItem.name } )
33
+
26
34
  //- Make sure to add the report issue widget at the end of the page.
27
35
  block append content
28
36
  if page.reportIssueWidget
package/themes/umberto/layout/api.pug CHANGED
@@ -19,7 +19,8 @@ block append content
19
19
  include _partial/report-issue-widget
20
20
 
21
21
  block projectVersion
22
- meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
22
+ if page.permalinkDisableDomains
23
+ meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
23
24
 
24
25
  if projectLocals
25
26
  meta( name= 'project-version' content= projectLocals.projectVersion )
package/themes/umberto/layout/page.pug CHANGED
@@ -21,7 +21,8 @@ block navtree
21
21
  include _partial/nav-tree
22
22
 
23
23
  block projectVersion
24
- meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
24
+ if page.permalinkDisableDomains
25
+ meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
25
26
 
26
27
  if projectLocals
27
28
  meta( name= 'project-version' content= projectLocals.projectVersion )
package/themes/umberto/layout/sdk.pug CHANGED
@@ -21,7 +21,8 @@ block navtree
21
21
  != projectLocals.sdkNavTree
22
22
 
23
23
  block projectVersion
24
- meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
24
+ if page.permalinkDisableDomains
25
+ meta( name= 'permalink-disable-domains' content=page.permalinkDisableDomains )
25
26
 
26
27
  if projectLocals
27
28
  meta( name= 'project-version' content= projectLocals.projectVersion )