@itwin/appui-abstract 4.0.0-dev.1 → 4.0.0-dev.3

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 (338) hide show
  1. package/CHANGELOG.md +1 -90
  2. package/lib/cjs/appui-abstract/BaseUiItemsProvider.d.ts +30 -30
  3. package/lib/cjs/appui-abstract/BaseUiItemsProvider.d.ts.map +1 -1
  4. package/lib/cjs/appui-abstract/BaseUiItemsProvider.js +78 -79
  5. package/lib/cjs/appui-abstract/BaseUiItemsProvider.js.map +1 -1
  6. package/lib/cjs/appui-abstract/UiAdmin.d.ts +221 -221
  7. package/lib/cjs/appui-abstract/UiAdmin.js +224 -224
  8. package/lib/cjs/appui-abstract/UiAdmin.js.map +1 -1
  9. package/lib/cjs/appui-abstract/UiItemsManager.d.ts +110 -113
  10. package/lib/cjs/appui-abstract/UiItemsManager.d.ts.map +1 -1
  11. package/lib/cjs/appui-abstract/UiItemsManager.js +198 -199
  12. package/lib/cjs/appui-abstract/UiItemsManager.js.map +1 -1
  13. package/lib/cjs/appui-abstract/UiItemsProvider.d.ts +27 -29
  14. package/lib/cjs/appui-abstract/UiItemsProvider.d.ts.map +1 -1
  15. package/lib/cjs/appui-abstract/UiItemsProvider.js +9 -9
  16. package/lib/cjs/appui-abstract/UiItemsProvider.js.map +1 -1
  17. package/lib/cjs/appui-abstract/backstage/BackstageItem.d.ts +83 -91
  18. package/lib/cjs/appui-abstract/backstage/BackstageItem.d.ts.map +1 -1
  19. package/lib/cjs/appui-abstract/backstage/BackstageItem.js +64 -70
  20. package/lib/cjs/appui-abstract/backstage/BackstageItem.js.map +1 -1
  21. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.d.ts +38 -38
  22. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.d.ts.map +1 -1
  23. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.js +133 -133
  24. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.js.map +1 -1
  25. package/lib/cjs/appui-abstract/common/KeyboardKey.d.ts +51 -51
  26. package/lib/cjs/appui-abstract/common/KeyboardKey.js +63 -63
  27. package/lib/cjs/appui-abstract/common/KeyboardKey.js.map +1 -1
  28. package/lib/cjs/appui-abstract/content/ContentLayoutProps.d.ts +62 -62
  29. package/lib/cjs/appui-abstract/content/ContentLayoutProps.js +9 -9
  30. package/lib/cjs/appui-abstract/content/ContentLayoutProps.js.map +1 -1
  31. package/lib/cjs/appui-abstract/content/StandardContentLayouts.d.ts +19 -19
  32. package/lib/cjs/appui-abstract/content/StandardContentLayouts.js +108 -108
  33. package/lib/cjs/appui-abstract/content/StandardContentLayouts.js.map +1 -1
  34. package/lib/cjs/appui-abstract/dialogs/DialogItem.d.ts +76 -76
  35. package/lib/cjs/appui-abstract/dialogs/DialogItem.js +67 -67
  36. package/lib/cjs/appui-abstract/dialogs/DialogItem.js.map +1 -1
  37. package/lib/cjs/appui-abstract/dialogs/UiDataProvider.d.ts +55 -55
  38. package/lib/cjs/appui-abstract/dialogs/UiDataProvider.js +66 -66
  39. package/lib/cjs/appui-abstract/dialogs/UiDataProvider.js.map +1 -1
  40. package/lib/cjs/appui-abstract/dialogs/UiLayoutDataProvider.d.ts +97 -97
  41. package/lib/cjs/appui-abstract/dialogs/UiLayoutDataProvider.js +175 -175
  42. package/lib/cjs/appui-abstract/dialogs/UiLayoutDataProvider.js.map +1 -1
  43. package/lib/cjs/appui-abstract/items/AbstractItemProps.d.ts +53 -53
  44. package/lib/cjs/appui-abstract/items/AbstractItemProps.js +9 -9
  45. package/lib/cjs/appui-abstract/items/AbstractItemProps.js.map +1 -1
  46. package/lib/cjs/appui-abstract/items/AbstractMenuItemProps.d.ts +20 -20
  47. package/lib/cjs/appui-abstract/items/AbstractMenuItemProps.js +9 -9
  48. package/lib/cjs/appui-abstract/items/AbstractMenuItemProps.js.map +1 -1
  49. package/lib/cjs/appui-abstract/items/AbstractToolbarProps.d.ts +13 -13
  50. package/lib/cjs/appui-abstract/items/AbstractToolbarProps.js +9 -9
  51. package/lib/cjs/appui-abstract/items/AbstractToolbarProps.js.map +1 -1
  52. package/lib/cjs/appui-abstract/items/BadgeType.d.ts +14 -14
  53. package/lib/cjs/appui-abstract/items/BadgeType.js +22 -22
  54. package/lib/cjs/appui-abstract/items/BadgeType.js.map +1 -1
  55. package/lib/cjs/appui-abstract/items/ConditionalBooleanValue.d.ts +27 -27
  56. package/lib/cjs/appui-abstract/items/ConditionalBooleanValue.js +60 -60
  57. package/lib/cjs/appui-abstract/items/ConditionalBooleanValue.js.map +1 -1
  58. package/lib/cjs/appui-abstract/items/ConditionalStringValue.d.ts +29 -29
  59. package/lib/cjs/appui-abstract/items/ConditionalStringValue.js +62 -62
  60. package/lib/cjs/appui-abstract/items/ConditionalStringValue.js.map +1 -1
  61. package/lib/cjs/appui-abstract/items/ProvidedItem.d.ts +10 -11
  62. package/lib/cjs/appui-abstract/items/ProvidedItem.d.ts.map +1 -1
  63. package/lib/cjs/appui-abstract/items/ProvidedItem.js +9 -9
  64. package/lib/cjs/appui-abstract/items/ProvidedItem.js.map +1 -1
  65. package/lib/cjs/appui-abstract/items/RelativePosition.d.ts +18 -18
  66. package/lib/cjs/appui-abstract/items/RelativePosition.js +26 -26
  67. package/lib/cjs/appui-abstract/items/RelativePosition.js.map +1 -1
  68. package/lib/cjs/appui-abstract/items/StageUsage.d.ts +15 -16
  69. package/lib/cjs/appui-abstract/items/StageUsage.d.ts.map +1 -1
  70. package/lib/cjs/appui-abstract/items/StageUsage.js +23 -24
  71. package/lib/cjs/appui-abstract/items/StageUsage.js.map +1 -1
  72. package/lib/cjs/appui-abstract/notification/MessagePresenter.d.ts +42 -42
  73. package/lib/cjs/appui-abstract/notification/MessagePresenter.js +24 -24
  74. package/lib/cjs/appui-abstract/notification/MessagePresenter.js.map +1 -1
  75. package/lib/cjs/appui-abstract/notification/MessageSeverity.d.ts +15 -15
  76. package/lib/cjs/appui-abstract/notification/MessageSeverity.js +23 -23
  77. package/lib/cjs/appui-abstract/notification/MessageSeverity.js.map +1 -1
  78. package/lib/cjs/appui-abstract/properties/Description.d.ts +127 -127
  79. package/lib/cjs/appui-abstract/properties/Description.js +196 -196
  80. package/lib/cjs/appui-abstract/properties/Description.js.map +1 -1
  81. package/lib/cjs/appui-abstract/properties/EditorParams.d.ts +260 -260
  82. package/lib/cjs/appui-abstract/properties/EditorParams.js +106 -106
  83. package/lib/cjs/appui-abstract/properties/EditorParams.js.map +1 -1
  84. package/lib/cjs/appui-abstract/properties/PrimitiveTypes.d.ts +60 -60
  85. package/lib/cjs/appui-abstract/properties/PrimitiveTypes.js +9 -9
  86. package/lib/cjs/appui-abstract/properties/PrimitiveTypes.js.map +1 -1
  87. package/lib/cjs/appui-abstract/properties/Record.d.ts +57 -57
  88. package/lib/cjs/appui-abstract/properties/Record.js +78 -78
  89. package/lib/cjs/appui-abstract/properties/Record.js.map +1 -1
  90. package/lib/cjs/appui-abstract/properties/StandardEditorNames.d.ts +22 -22
  91. package/lib/cjs/appui-abstract/properties/StandardEditorNames.js +30 -30
  92. package/lib/cjs/appui-abstract/properties/StandardEditorNames.js.map +1 -1
  93. package/lib/cjs/appui-abstract/properties/StandardTypeNames.d.ts +30 -30
  94. package/lib/cjs/appui-abstract/properties/StandardTypeNames.js +39 -39
  95. package/lib/cjs/appui-abstract/properties/StandardTypeNames.js.map +1 -1
  96. package/lib/cjs/appui-abstract/properties/Value.d.ts +49 -49
  97. package/lib/cjs/appui-abstract/properties/Value.js +20 -20
  98. package/lib/cjs/appui-abstract/properties/Value.js.map +1 -1
  99. package/lib/cjs/appui-abstract/quantity/BaseQuantityDescription.d.ts +22 -22
  100. package/lib/cjs/appui-abstract/quantity/BaseQuantityDescription.js +48 -48
  101. package/lib/cjs/appui-abstract/quantity/BaseQuantityDescription.js.map +1 -1
  102. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.d.ts +116 -128
  103. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.d.ts.map +1 -1
  104. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.js +81 -87
  105. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.js.map +1 -1
  106. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.d.ts +39 -39
  107. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.d.ts.map +1 -1
  108. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.js +135 -135
  109. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.js.map +1 -1
  110. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.d.ts +118 -121
  111. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.d.ts.map +1 -1
  112. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.js +62 -64
  113. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.js.map +1 -1
  114. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.d.ts +45 -45
  115. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.d.ts.map +1 -1
  116. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.js +235 -235
  117. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.js.map +1 -1
  118. package/lib/cjs/appui-abstract/utils/IconSpecUtilities.d.ts +29 -29
  119. package/lib/cjs/appui-abstract/utils/IconSpecUtilities.js +51 -51
  120. package/lib/cjs/appui-abstract/utils/IconSpecUtilities.js.map +1 -1
  121. package/lib/cjs/appui-abstract/utils/PointProps.d.ts +10 -10
  122. package/lib/cjs/appui-abstract/utils/PointProps.js +9 -9
  123. package/lib/cjs/appui-abstract/utils/PointProps.js.map +1 -1
  124. package/lib/cjs/appui-abstract/utils/UiError.d.ts +12 -12
  125. package/lib/cjs/appui-abstract/utils/UiError.js +22 -22
  126. package/lib/cjs/appui-abstract/utils/UiError.js.map +1 -1
  127. package/lib/cjs/appui-abstract/utils/UiEvent.d.ts +9 -9
  128. package/lib/cjs/appui-abstract/utils/UiEvent.js +17 -17
  129. package/lib/cjs/appui-abstract/utils/UiEvent.js.map +1 -1
  130. package/lib/cjs/appui-abstract/utils/UiEventDispatcher.d.ts +46 -46
  131. package/lib/cjs/appui-abstract/utils/UiEventDispatcher.js +131 -131
  132. package/lib/cjs/appui-abstract/utils/UiEventDispatcher.js.map +1 -1
  133. package/lib/cjs/appui-abstract/utils/callbacks.d.ts +20 -20
  134. package/lib/cjs/appui-abstract/utils/callbacks.js +9 -9
  135. package/lib/cjs/appui-abstract/utils/callbacks.js.map +1 -1
  136. package/lib/cjs/appui-abstract/utils/filter/charCode.d.ts +416 -416
  137. package/lib/cjs/appui-abstract/utils/filter/charCode.js +6 -6
  138. package/lib/cjs/appui-abstract/utils/filter/charCode.js.map +1 -1
  139. package/lib/cjs/appui-abstract/utils/filter/filters.d.ts +98 -98
  140. package/lib/cjs/appui-abstract/utils/filter/filters.js +709 -709
  141. package/lib/cjs/appui-abstract/utils/filter/filters.js.map +1 -1
  142. package/lib/cjs/appui-abstract/utils/filter/map.d.ts +59 -59
  143. package/lib/cjs/appui-abstract/utils/filter/map.js +404 -404
  144. package/lib/cjs/appui-abstract/utils/filter/map.js.map +1 -1
  145. package/lib/cjs/appui-abstract/utils/filter/strings.d.ts +20 -20
  146. package/lib/cjs/appui-abstract/utils/filter/strings.js +78 -78
  147. package/lib/cjs/appui-abstract/utils/filter/strings.js.map +1 -1
  148. package/lib/cjs/appui-abstract/utils/isLetter.d.ts +9 -9
  149. package/lib/cjs/appui-abstract/utils/isLetter.js +19 -19
  150. package/lib/cjs/appui-abstract/utils/isLetter.js.map +1 -1
  151. package/lib/cjs/appui-abstract/utils/misc.d.ts +11 -11
  152. package/lib/cjs/appui-abstract/utils/misc.js +36 -36
  153. package/lib/cjs/appui-abstract/utils/misc.js.map +1 -1
  154. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.d.ts +68 -86
  155. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.d.ts.map +1 -1
  156. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.js +9 -9
  157. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.js.map +1 -1
  158. package/lib/cjs/appui-abstract/widget/StagePanel.d.ts +19 -36
  159. package/lib/cjs/appui-abstract/widget/StagePanel.d.ts.map +1 -1
  160. package/lib/cjs/appui-abstract/widget/StagePanel.js +28 -46
  161. package/lib/cjs/appui-abstract/widget/StagePanel.js.map +1 -1
  162. package/lib/cjs/appui-abstract/widget/WidgetState.d.ts +18 -19
  163. package/lib/cjs/appui-abstract/widget/WidgetState.d.ts.map +1 -1
  164. package/lib/cjs/appui-abstract/widget/WidgetState.js +26 -27
  165. package/lib/cjs/appui-abstract/widget/WidgetState.js.map +1 -1
  166. package/lib/cjs/appui-abstract.d.ts +105 -103
  167. package/lib/cjs/appui-abstract.d.ts.map +1 -1
  168. package/lib/cjs/appui-abstract.js +121 -119
  169. package/lib/cjs/appui-abstract.js.map +1 -1
  170. package/lib/esm/appui-abstract/BaseUiItemsProvider.d.ts +30 -30
  171. package/lib/esm/appui-abstract/BaseUiItemsProvider.d.ts.map +1 -1
  172. package/lib/esm/appui-abstract/BaseUiItemsProvider.js +74 -75
  173. package/lib/esm/appui-abstract/BaseUiItemsProvider.js.map +1 -1
  174. package/lib/esm/appui-abstract/UiAdmin.d.ts +221 -221
  175. package/lib/esm/appui-abstract/UiAdmin.js +219 -219
  176. package/lib/esm/appui-abstract/UiAdmin.js.map +1 -1
  177. package/lib/esm/appui-abstract/UiItemsManager.d.ts +110 -113
  178. package/lib/esm/appui-abstract/UiItemsManager.d.ts.map +1 -1
  179. package/lib/esm/appui-abstract/UiItemsManager.js +194 -195
  180. package/lib/esm/appui-abstract/UiItemsManager.js.map +1 -1
  181. package/lib/esm/appui-abstract/UiItemsProvider.d.ts +27 -29
  182. package/lib/esm/appui-abstract/UiItemsProvider.d.ts.map +1 -1
  183. package/lib/esm/appui-abstract/UiItemsProvider.js +8 -8
  184. package/lib/esm/appui-abstract/UiItemsProvider.js.map +1 -1
  185. package/lib/esm/appui-abstract/backstage/BackstageItem.d.ts +83 -91
  186. package/lib/esm/appui-abstract/backstage/BackstageItem.d.ts.map +1 -1
  187. package/lib/esm/appui-abstract/backstage/BackstageItem.js +58 -64
  188. package/lib/esm/appui-abstract/backstage/BackstageItem.js.map +1 -1
  189. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.d.ts +38 -38
  190. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.d.ts.map +1 -1
  191. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.js +129 -129
  192. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.js.map +1 -1
  193. package/lib/esm/appui-abstract/common/KeyboardKey.d.ts +51 -51
  194. package/lib/esm/appui-abstract/common/KeyboardKey.js +59 -59
  195. package/lib/esm/appui-abstract/common/KeyboardKey.js.map +1 -1
  196. package/lib/esm/appui-abstract/content/ContentLayoutProps.d.ts +62 -62
  197. package/lib/esm/appui-abstract/content/ContentLayoutProps.js +8 -8
  198. package/lib/esm/appui-abstract/content/ContentLayoutProps.js.map +1 -1
  199. package/lib/esm/appui-abstract/content/StandardContentLayouts.d.ts +19 -19
  200. package/lib/esm/appui-abstract/content/StandardContentLayouts.js +104 -104
  201. package/lib/esm/appui-abstract/content/StandardContentLayouts.js.map +1 -1
  202. package/lib/esm/appui-abstract/dialogs/DialogItem.d.ts +76 -76
  203. package/lib/esm/appui-abstract/dialogs/DialogItem.js +63 -63
  204. package/lib/esm/appui-abstract/dialogs/DialogItem.js.map +1 -1
  205. package/lib/esm/appui-abstract/dialogs/UiDataProvider.d.ts +55 -55
  206. package/lib/esm/appui-abstract/dialogs/UiDataProvider.js +61 -61
  207. package/lib/esm/appui-abstract/dialogs/UiDataProvider.js.map +1 -1
  208. package/lib/esm/appui-abstract/dialogs/UiLayoutDataProvider.d.ts +97 -97
  209. package/lib/esm/appui-abstract/dialogs/UiLayoutDataProvider.js +170 -170
  210. package/lib/esm/appui-abstract/dialogs/UiLayoutDataProvider.js.map +1 -1
  211. package/lib/esm/appui-abstract/items/AbstractItemProps.d.ts +53 -53
  212. package/lib/esm/appui-abstract/items/AbstractItemProps.js +8 -8
  213. package/lib/esm/appui-abstract/items/AbstractItemProps.js.map +1 -1
  214. package/lib/esm/appui-abstract/items/AbstractMenuItemProps.d.ts +20 -20
  215. package/lib/esm/appui-abstract/items/AbstractMenuItemProps.js +8 -8
  216. package/lib/esm/appui-abstract/items/AbstractMenuItemProps.js.map +1 -1
  217. package/lib/esm/appui-abstract/items/AbstractToolbarProps.d.ts +13 -13
  218. package/lib/esm/appui-abstract/items/AbstractToolbarProps.js +8 -8
  219. package/lib/esm/appui-abstract/items/AbstractToolbarProps.js.map +1 -1
  220. package/lib/esm/appui-abstract/items/BadgeType.d.ts +14 -14
  221. package/lib/esm/appui-abstract/items/BadgeType.js +19 -19
  222. package/lib/esm/appui-abstract/items/BadgeType.js.map +1 -1
  223. package/lib/esm/appui-abstract/items/ConditionalBooleanValue.d.ts +27 -27
  224. package/lib/esm/appui-abstract/items/ConditionalBooleanValue.js +56 -56
  225. package/lib/esm/appui-abstract/items/ConditionalBooleanValue.js.map +1 -1
  226. package/lib/esm/appui-abstract/items/ConditionalStringValue.d.ts +29 -29
  227. package/lib/esm/appui-abstract/items/ConditionalStringValue.js +58 -58
  228. package/lib/esm/appui-abstract/items/ConditionalStringValue.js.map +1 -1
  229. package/lib/esm/appui-abstract/items/ProvidedItem.d.ts +10 -11
  230. package/lib/esm/appui-abstract/items/ProvidedItem.d.ts.map +1 -1
  231. package/lib/esm/appui-abstract/items/ProvidedItem.js +8 -8
  232. package/lib/esm/appui-abstract/items/ProvidedItem.js.map +1 -1
  233. package/lib/esm/appui-abstract/items/RelativePosition.d.ts +18 -18
  234. package/lib/esm/appui-abstract/items/RelativePosition.js +23 -23
  235. package/lib/esm/appui-abstract/items/RelativePosition.js.map +1 -1
  236. package/lib/esm/appui-abstract/items/StageUsage.d.ts +15 -16
  237. package/lib/esm/appui-abstract/items/StageUsage.d.ts.map +1 -1
  238. package/lib/esm/appui-abstract/items/StageUsage.js +20 -21
  239. package/lib/esm/appui-abstract/items/StageUsage.js.map +1 -1
  240. package/lib/esm/appui-abstract/notification/MessagePresenter.d.ts +42 -42
  241. package/lib/esm/appui-abstract/notification/MessagePresenter.js +21 -21
  242. package/lib/esm/appui-abstract/notification/MessagePresenter.js.map +1 -1
  243. package/lib/esm/appui-abstract/notification/MessageSeverity.d.ts +15 -15
  244. package/lib/esm/appui-abstract/notification/MessageSeverity.js +20 -20
  245. package/lib/esm/appui-abstract/notification/MessageSeverity.js.map +1 -1
  246. package/lib/esm/appui-abstract/properties/Description.d.ts +127 -127
  247. package/lib/esm/appui-abstract/properties/Description.js +192 -192
  248. package/lib/esm/appui-abstract/properties/Description.js.map +1 -1
  249. package/lib/esm/appui-abstract/properties/EditorParams.d.ts +260 -260
  250. package/lib/esm/appui-abstract/properties/EditorParams.js +97 -97
  251. package/lib/esm/appui-abstract/properties/EditorParams.js.map +1 -1
  252. package/lib/esm/appui-abstract/properties/PrimitiveTypes.d.ts +60 -60
  253. package/lib/esm/appui-abstract/properties/PrimitiveTypes.js +8 -8
  254. package/lib/esm/appui-abstract/properties/PrimitiveTypes.js.map +1 -1
  255. package/lib/esm/appui-abstract/properties/Record.d.ts +57 -57
  256. package/lib/esm/appui-abstract/properties/Record.js +74 -74
  257. package/lib/esm/appui-abstract/properties/Record.js.map +1 -1
  258. package/lib/esm/appui-abstract/properties/StandardEditorNames.d.ts +22 -22
  259. package/lib/esm/appui-abstract/properties/StandardEditorNames.js +27 -27
  260. package/lib/esm/appui-abstract/properties/StandardEditorNames.js.map +1 -1
  261. package/lib/esm/appui-abstract/properties/StandardTypeNames.d.ts +30 -30
  262. package/lib/esm/appui-abstract/properties/StandardTypeNames.js +36 -36
  263. package/lib/esm/appui-abstract/properties/StandardTypeNames.js.map +1 -1
  264. package/lib/esm/appui-abstract/properties/Value.d.ts +49 -49
  265. package/lib/esm/appui-abstract/properties/Value.js +17 -17
  266. package/lib/esm/appui-abstract/properties/Value.js.map +1 -1
  267. package/lib/esm/appui-abstract/quantity/BaseQuantityDescription.d.ts +22 -22
  268. package/lib/esm/appui-abstract/quantity/BaseQuantityDescription.js +44 -44
  269. package/lib/esm/appui-abstract/quantity/BaseQuantityDescription.js.map +1 -1
  270. package/lib/esm/appui-abstract/statusbar/StatusBarItem.d.ts +116 -128
  271. package/lib/esm/appui-abstract/statusbar/StatusBarItem.d.ts.map +1 -1
  272. package/lib/esm/appui-abstract/statusbar/StatusBarItem.js +74 -80
  273. package/lib/esm/appui-abstract/statusbar/StatusBarItem.js.map +1 -1
  274. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.d.ts +39 -39
  275. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.d.ts.map +1 -1
  276. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.js +131 -131
  277. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.js.map +1 -1
  278. package/lib/esm/appui-abstract/toolbars/ToolbarItem.d.ts +118 -121
  279. package/lib/esm/appui-abstract/toolbars/ToolbarItem.d.ts.map +1 -1
  280. package/lib/esm/appui-abstract/toolbars/ToolbarItem.js +58 -60
  281. package/lib/esm/appui-abstract/toolbars/ToolbarItem.js.map +1 -1
  282. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.d.ts +45 -45
  283. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.d.ts.map +1 -1
  284. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.js +231 -231
  285. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.js.map +1 -1
  286. package/lib/esm/appui-abstract/utils/IconSpecUtilities.d.ts +29 -29
  287. package/lib/esm/appui-abstract/utils/IconSpecUtilities.js +47 -47
  288. package/lib/esm/appui-abstract/utils/IconSpecUtilities.js.map +1 -1
  289. package/lib/esm/appui-abstract/utils/PointProps.d.ts +10 -10
  290. package/lib/esm/appui-abstract/utils/PointProps.js +8 -8
  291. package/lib/esm/appui-abstract/utils/PointProps.js.map +1 -1
  292. package/lib/esm/appui-abstract/utils/UiError.d.ts +12 -12
  293. package/lib/esm/appui-abstract/utils/UiError.js +18 -18
  294. package/lib/esm/appui-abstract/utils/UiError.js.map +1 -1
  295. package/lib/esm/appui-abstract/utils/UiEvent.d.ts +9 -9
  296. package/lib/esm/appui-abstract/utils/UiEvent.js +13 -13
  297. package/lib/esm/appui-abstract/utils/UiEvent.js.map +1 -1
  298. package/lib/esm/appui-abstract/utils/UiEventDispatcher.d.ts +46 -46
  299. package/lib/esm/appui-abstract/utils/UiEventDispatcher.js +126 -126
  300. package/lib/esm/appui-abstract/utils/UiEventDispatcher.js.map +1 -1
  301. package/lib/esm/appui-abstract/utils/callbacks.d.ts +20 -20
  302. package/lib/esm/appui-abstract/utils/callbacks.js +8 -8
  303. package/lib/esm/appui-abstract/utils/callbacks.js.map +1 -1
  304. package/lib/esm/appui-abstract/utils/filter/charCode.d.ts +416 -416
  305. package/lib/esm/appui-abstract/utils/filter/charCode.js +5 -5
  306. package/lib/esm/appui-abstract/utils/filter/charCode.js.map +1 -1
  307. package/lib/esm/appui-abstract/utils/filter/filters.d.ts +98 -98
  308. package/lib/esm/appui-abstract/utils/filter/filters.js +694 -694
  309. package/lib/esm/appui-abstract/utils/filter/filters.js.map +1 -1
  310. package/lib/esm/appui-abstract/utils/filter/map.d.ts +59 -59
  311. package/lib/esm/appui-abstract/utils/filter/map.js +399 -399
  312. package/lib/esm/appui-abstract/utils/filter/map.js.map +1 -1
  313. package/lib/esm/appui-abstract/utils/filter/strings.d.ts +20 -20
  314. package/lib/esm/appui-abstract/utils/filter/strings.js +70 -70
  315. package/lib/esm/appui-abstract/utils/filter/strings.js.map +1 -1
  316. package/lib/esm/appui-abstract/utils/isLetter.d.ts +9 -9
  317. package/lib/esm/appui-abstract/utils/isLetter.js +15 -15
  318. package/lib/esm/appui-abstract/utils/isLetter.js.map +1 -1
  319. package/lib/esm/appui-abstract/utils/misc.d.ts +11 -11
  320. package/lib/esm/appui-abstract/utils/misc.js +31 -31
  321. package/lib/esm/appui-abstract/utils/misc.js.map +1 -1
  322. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.d.ts +68 -86
  323. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.d.ts.map +1 -1
  324. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.js +8 -8
  325. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.js.map +1 -1
  326. package/lib/esm/appui-abstract/widget/StagePanel.d.ts +19 -36
  327. package/lib/esm/appui-abstract/widget/StagePanel.d.ts.map +1 -1
  328. package/lib/esm/appui-abstract/widget/StagePanel.js +25 -43
  329. package/lib/esm/appui-abstract/widget/StagePanel.js.map +1 -1
  330. package/lib/esm/appui-abstract/widget/WidgetState.d.ts +18 -19
  331. package/lib/esm/appui-abstract/widget/WidgetState.d.ts.map +1 -1
  332. package/lib/esm/appui-abstract/widget/WidgetState.js +23 -24
  333. package/lib/esm/appui-abstract/widget/WidgetState.js.map +1 -1
  334. package/lib/esm/appui-abstract.d.ts +105 -103
  335. package/lib/esm/appui-abstract.d.ts.map +1 -1
  336. package/lib/esm/appui-abstract.js +109 -107
  337. package/lib/esm/appui-abstract.js.map +1 -1
  338. package/package.json +7 -17
@@ -1,200 +1,199 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- /* eslint-disable deprecation/deprecation */
7
- /** @packageDocumentation
8
- * @module UiItemsProvider
9
- */
10
- Object.defineProperty(exports, "__esModule", { value: true });
11
- exports.UiItemsManager = exports.UiItemsApplicationAction = void 0;
12
- const core_bentley_1 = require("@itwin/core-bentley");
13
- const misc_1 = require("./utils/misc");
14
- /** Action taken by the application on item provided by a UiItemsProvider
15
- * @public @deprecated in 3.2. This was only used by the previously removed UiItemsArbiter.
16
- */
17
- var UiItemsApplicationAction;
18
- (function (UiItemsApplicationAction) {
19
- /** Allow the change to the item */
20
- UiItemsApplicationAction[UiItemsApplicationAction["Allow"] = 0] = "Allow";
21
- /** Disallow the change to the item */
22
- UiItemsApplicationAction[UiItemsApplicationAction["Disallow"] = 1] = "Disallow";
23
- /** Update the item during the change */
24
- UiItemsApplicationAction[UiItemsApplicationAction["Update"] = 2] = "Update";
25
- })(UiItemsApplicationAction = exports.UiItemsApplicationAction || (exports.UiItemsApplicationAction = {}));
26
- /** Controls registering of UiItemsProviders and calls the provider's methods when populating different parts of the User Interface.
27
- * @deprecated in 3.6. Use [UiItemsManager]($appui-react) instead.
28
- * @public
29
- */
30
- class UiItemsManager {
31
- /** For use in unit testing
32
- * @internal */
33
- static clearAllProviders() {
34
- UiItemsManager._registeredUiItemsProviders.clear();
35
- }
36
- /** Return number of registered UiProvider. */
37
- static get registeredProviderIds() {
38
- const ids = [...UiItemsManager._registeredUiItemsProviders.keys()];
39
- return ids;
40
- }
41
- /** Return true if there is any registered UiProvider. */
42
- static get hasRegisteredProviders() {
43
- return this._registeredUiItemsProviders.size > 0;
44
- }
45
- /**
46
- * Retrieves a previously loaded UiItemsProvider.
47
- * @param providerId id of the UiItemsProvider to get
48
- */
49
- static getUiItemsProvider(providerId) {
50
- var _a;
51
- return (_a = UiItemsManager._registeredUiItemsProviders.get(providerId)) === null || _a === void 0 ? void 0 : _a.provider;
52
- }
53
- static sendRegisteredEvent(ev) {
54
- UiItemsManager.onUiProviderRegisteredEvent.raiseEvent(ev);
55
- }
56
- /**
57
- * Registers a UiItemsProvider with the UiItemsManager.
58
- * @param uiProvider the UI items provider to register.
59
- */
60
- static register(uiProvider, overrides) {
61
- var _a;
62
- const providerId = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.providerId) !== null && _a !== void 0 ? _a : uiProvider.id;
63
- if (UiItemsManager.getUiItemsProvider(providerId)) {
64
- core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${providerId}) is already loaded`);
65
- }
66
- else {
67
- UiItemsManager._registeredUiItemsProviders.set(providerId, { provider: uiProvider, overrides });
68
- core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider ${uiProvider.id} registered as ${providerId} `);
69
- UiItemsManager.sendRegisteredEvent({ providerId });
70
- }
71
- }
72
- /** Remove a specific UiItemsProvider from the list of available providers. */
73
- static unregister(uiProviderId) {
74
- const provider = UiItemsManager.getUiItemsProvider(uiProviderId);
75
- if (!provider)
76
- return;
77
- provider.onUnregister && provider.onUnregister();
78
- UiItemsManager._registeredUiItemsProviders.delete(uiProviderId);
79
- core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${uiProviderId}) unloaded`);
80
- // trigger a refresh of the ui
81
- UiItemsManager.sendRegisteredEvent({ providerId: uiProviderId });
82
- }
83
- static allowItemsFromProvider(entry, stageId, stageUsage) {
84
- // istanbul ignore else
85
- const overrides = entry.overrides;
86
- if (undefined !== stageId && (overrides === null || overrides === void 0 ? void 0 : overrides.stageIds) && !(overrides.stageIds.some((value) => value === stageId)))
87
- return false;
88
- if (undefined !== stageUsage && (overrides === null || overrides === void 0 ? void 0 : overrides.stageUsages) && !(overrides.stageUsages.some((value) => value === stageUsage)))
89
- return false;
90
- return true;
91
- }
92
- /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute
93
- * an action or specify a registered ToolId into toolbar.
94
- * @param stageId a string identifier the active stage.
95
- * @param stageUsage the StageUsage of the active stage.
96
- * @param toolbarUsage usage of the toolbar
97
- * @param toolbarOrientation orientation of the toolbar
98
- * @returns an array of error messages. The array will be empty if the load is successful, otherwise it is a list of one or more problems.
99
- */
100
- static getToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData) {
101
- const buttonItems = [];
102
- if (0 === UiItemsManager._registeredUiItemsProviders.size)
103
- return buttonItems;
104
- UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
105
- var _a, _b;
106
- const uiProvider = entry.provider;
107
- const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
108
- // istanbul ignore else
109
- if (uiProvider.provideToolbarButtonItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
110
- uiProvider.provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData)
111
- .forEach((spec) => {
112
- // ignore duplicate ids
113
- if (-1 === buttonItems.findIndex((existingItem) => spec.id === existingItem.id))
114
- buttonItems.push({ ...spec, providerId });
115
- });
116
- }
117
- });
118
- return buttonItems;
119
- }
120
- /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
121
- * @param stageId a string identifier the active stage.
122
- * @param stageUsage the StageUsage of the active stage.
123
- * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.
124
- */
125
- static getStatusBarItems(stageId, stageUsage, stageAppData) {
126
- const statusBarItems = [];
127
- if (0 === UiItemsManager._registeredUiItemsProviders.size)
128
- return statusBarItems;
129
- UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
130
- var _a, _b;
131
- const uiProvider = entry.provider;
132
- const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
133
- // istanbul ignore else
134
- if (uiProvider.provideStatusBarItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
135
- uiProvider.provideStatusBarItems(stageId, stageUsage, stageAppData)
136
- .forEach((item) => {
137
- // ignore duplicate ids
138
- if (-1 === statusBarItems.findIndex((existingItem) => item.id === existingItem.id))
139
- statusBarItems.push({ ...item, providerId });
140
- });
141
- }
142
- });
143
- return statusBarItems;
144
- }
145
- /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
146
- * @returns An array of BackstageItem that will be used to create controls for the backstage menu.
147
- */
148
- static getBackstageItems() {
149
- const backstageItems = [];
150
- if (0 === UiItemsManager._registeredUiItemsProviders.size)
151
- return backstageItems;
152
- UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
153
- var _a, _b;
154
- const uiProvider = entry.provider;
155
- const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
156
- // istanbul ignore else
157
- if (uiProvider.provideBackstageItems) { // Note: We do not call this.allowItemsFromProvider here as backstage items
158
- uiProvider.provideBackstageItems() // should not be considered stage specific. If they need to be hidden
159
- .forEach((item) => {
160
- // ignore duplicate ids
161
- if (-1 === backstageItems.findIndex((existingItem) => item.id === existingItem.id))
162
- backstageItems.push({ ...item, providerId });
163
- });
164
- }
165
- });
166
- return backstageItems;
167
- }
168
- /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets
169
- * @param stageId a string identifier the active stage.
170
- * @param stageUsage the StageUsage of the active stage.
171
- * @param location the location within the stage.
172
- * @param section the section within location.
173
- * @returns An array of AbstractWidgetProps that will be used to create widgets.
174
- */
175
- static getWidgets(stageId, stageUsage, location, section, zoneLocation, stageAppData) {
176
- const widgets = [];
177
- if (0 === UiItemsManager._registeredUiItemsProviders.size)
178
- return widgets;
179
- UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
180
- var _a, _b;
181
- const uiProvider = entry.provider;
182
- const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
183
- // istanbul ignore else
184
- if (uiProvider.provideWidgets && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
185
- uiProvider.provideWidgets(stageId, stageUsage, location, section, zoneLocation, stageAppData)
186
- .forEach((widget) => {
187
- // ignore duplicate ids
188
- if (-1 === widgets.findIndex((existingItem) => widget.id === existingItem.id))
189
- widgets.push({ ...widget, providerId });
190
- });
191
- }
192
- });
193
- return widgets;
194
- }
195
- }
196
- exports.UiItemsManager = UiItemsManager;
197
- UiItemsManager._registeredUiItemsProviders = new Map();
198
- /** Event raised any time a UiProvider is registered or unregistered. */
199
- UiItemsManager.onUiProviderRegisteredEvent = new core_bentley_1.BeEvent();
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ /** @packageDocumentation
7
+ * @module UiItemsProvider
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.UiItemsManager = exports.UiItemsApplicationAction = void 0;
11
+ const core_bentley_1 = require("@itwin/core-bentley");
12
+ const misc_1 = require("./utils/misc");
13
+ /** Action taken by the application on item provided by a UiItemsProvider
14
+ * @public @deprecated this was only used by the previously removed UiItemsArbiter.
15
+ */
16
+ var UiItemsApplicationAction;
17
+ (function (UiItemsApplicationAction) {
18
+ /** Allow the change to the item */
19
+ UiItemsApplicationAction[UiItemsApplicationAction["Allow"] = 0] = "Allow";
20
+ /** Disallow the change to the item */
21
+ UiItemsApplicationAction[UiItemsApplicationAction["Disallow"] = 1] = "Disallow";
22
+ /** Update the item during the change */
23
+ UiItemsApplicationAction[UiItemsApplicationAction["Update"] = 2] = "Update";
24
+ })(UiItemsApplicationAction = exports.UiItemsApplicationAction || (exports.UiItemsApplicationAction = {}));
25
+ /**
26
+ * Controls registering of UiItemsProviders and calls the provider's methods when populating different parts of the User Interface.
27
+ * @public
28
+ */
29
+ class UiItemsManager {
30
+ /** For use in unit testing
31
+ * @internal */
32
+ static clearAllProviders() {
33
+ UiItemsManager._registeredUiItemsProviders.clear();
34
+ }
35
+ /** Return number of registered UiProvider. */
36
+ static get registeredProviderIds() {
37
+ const ids = [...UiItemsManager._registeredUiItemsProviders.keys()];
38
+ return ids;
39
+ }
40
+ /** Return true if there is any registered UiProvider. */
41
+ static get hasRegisteredProviders() {
42
+ return this._registeredUiItemsProviders.size > 0;
43
+ }
44
+ /**
45
+ * Retrieves a previously loaded UiItemsProvider.
46
+ * @param providerId id of the UiItemsProvider to get
47
+ */
48
+ static getUiItemsProvider(providerId) {
49
+ var _a;
50
+ return (_a = UiItemsManager._registeredUiItemsProviders.get(providerId)) === null || _a === void 0 ? void 0 : _a.provider;
51
+ }
52
+ static sendRegisteredEvent(ev) {
53
+ UiItemsManager.onUiProviderRegisteredEvent.raiseEvent(ev);
54
+ }
55
+ /**
56
+ * Registers a UiItemsProvider with the UiItemsManager.
57
+ * @param uiProvider the UI items provider to register.
58
+ */
59
+ static register(uiProvider, overrides) {
60
+ var _a;
61
+ const providerId = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.providerId) !== null && _a !== void 0 ? _a : uiProvider.id;
62
+ if (UiItemsManager.getUiItemsProvider(providerId)) {
63
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${providerId}) is already loaded`);
64
+ }
65
+ else {
66
+ UiItemsManager._registeredUiItemsProviders.set(providerId, { provider: uiProvider, overrides });
67
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider ${uiProvider.id} registered as ${providerId} `);
68
+ UiItemsManager.sendRegisteredEvent({ providerId });
69
+ }
70
+ }
71
+ /** Remove a specific UiItemsProvider from the list of available providers. */
72
+ static unregister(uiProviderId) {
73
+ const provider = UiItemsManager.getUiItemsProvider(uiProviderId);
74
+ if (!provider)
75
+ return;
76
+ provider.onUnregister && provider.onUnregister();
77
+ UiItemsManager._registeredUiItemsProviders.delete(uiProviderId);
78
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${uiProviderId}) unloaded`);
79
+ // trigger a refresh of the ui
80
+ UiItemsManager.sendRegisteredEvent({ providerId: uiProviderId });
81
+ }
82
+ static allowItemsFromProvider(entry, stageId, stageUsage) {
83
+ // istanbul ignore else
84
+ const overrides = entry.overrides;
85
+ if (undefined !== stageId && (overrides === null || overrides === void 0 ? void 0 : overrides.stageIds) && !(overrides.stageIds.some((value) => value === stageId)))
86
+ return false;
87
+ if (undefined !== stageUsage && (overrides === null || overrides === void 0 ? void 0 : overrides.stageUsages) && !(overrides.stageUsages.some((value) => value === stageUsage)))
88
+ return false;
89
+ return true;
90
+ }
91
+ /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute
92
+ * an action or specify a registered ToolId into toolbar.
93
+ * @param stageId a string identifier the active stage.
94
+ * @param stageUsage the StageUsage of the active stage.
95
+ * @param toolbarUsage usage of the toolbar
96
+ * @param toolbarOrientation orientation of the toolbar
97
+ * @returns an array of error messages. The array will be empty if the load is successful, otherwise it is a list of one or more problems.
98
+ */
99
+ static getToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation) {
100
+ const buttonItems = [];
101
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
102
+ return buttonItems;
103
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
104
+ var _a, _b;
105
+ const uiProvider = entry.provider;
106
+ const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
107
+ // istanbul ignore else
108
+ if (uiProvider.provideToolbarButtonItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
109
+ uiProvider.provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation)
110
+ .forEach((spec) => {
111
+ // ignore duplicate ids
112
+ if (-1 === buttonItems.findIndex((existingItem) => spec.id === existingItem.id))
113
+ buttonItems.push({ ...spec, providerId });
114
+ });
115
+ }
116
+ });
117
+ return buttonItems;
118
+ }
119
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
120
+ * @param stageId a string identifier the active stage.
121
+ * @param stageUsage the StageUsage of the active stage.
122
+ * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.
123
+ */
124
+ static getStatusBarItems(stageId, stageUsage) {
125
+ const statusBarItems = [];
126
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
127
+ return statusBarItems;
128
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
129
+ var _a, _b;
130
+ const uiProvider = entry.provider;
131
+ const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
132
+ // istanbul ignore else
133
+ if (uiProvider.provideStatusBarItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
134
+ uiProvider.provideStatusBarItems(stageId, stageUsage)
135
+ .forEach((item) => {
136
+ // ignore duplicate ids
137
+ if (-1 === statusBarItems.findIndex((existingItem) => item.id === existingItem.id))
138
+ statusBarItems.push({ ...item, providerId });
139
+ });
140
+ }
141
+ });
142
+ return statusBarItems;
143
+ }
144
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
145
+ * @returns An array of BackstageItem that will be used to create controls for the backstage menu.
146
+ */
147
+ static getBackstageItems() {
148
+ const backstageItems = [];
149
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
150
+ return backstageItems;
151
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
152
+ var _a, _b;
153
+ const uiProvider = entry.provider;
154
+ const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
155
+ // istanbul ignore else
156
+ if (uiProvider.provideBackstageItems) { // Note: We do not call this.allowItemsFromProvider here as backstage items
157
+ uiProvider.provideBackstageItems() // should not be considered stage specific. If they need to be hidden
158
+ .forEach((item) => {
159
+ // ignore duplicate ids
160
+ if (-1 === backstageItems.findIndex((existingItem) => item.id === existingItem.id))
161
+ backstageItems.push({ ...item, providerId });
162
+ });
163
+ }
164
+ });
165
+ return backstageItems;
166
+ }
167
+ /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets
168
+ * @param stageId a string identifier the active stage.
169
+ * @param stageUsage the StageUsage of the active stage.
170
+ * @param location the location within the stage.
171
+ * @param section the section within location.
172
+ * @returns An array of AbstractWidgetProps that will be used to create widgets.
173
+ */
174
+ static getWidgets(stageId, stageUsage, location, section) {
175
+ const widgets = [];
176
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
177
+ return widgets;
178
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
179
+ var _a, _b;
180
+ const uiProvider = entry.provider;
181
+ const providerId = (_b = (_a = entry.overrides) === null || _a === void 0 ? void 0 : _a.providerId) !== null && _b !== void 0 ? _b : uiProvider.id;
182
+ // istanbul ignore else
183
+ if (uiProvider.provideWidgets && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
184
+ uiProvider.provideWidgets(stageId, stageUsage, location, section)
185
+ .forEach((widget) => {
186
+ // ignore duplicate ids
187
+ if (-1 === widgets.findIndex((existingItem) => widget.id === existingItem.id))
188
+ widgets.push({ ...widget, providerId });
189
+ });
190
+ }
191
+ });
192
+ return widgets;
193
+ }
194
+ }
195
+ exports.UiItemsManager = UiItemsManager;
196
+ UiItemsManager._registeredUiItemsProviders = new Map();
197
+ /** Event raised any time a UiProvider is registered or unregistered. */
198
+ UiItemsManager.onUiProviderRegisteredEvent = new core_bentley_1.BeEvent();
200
199
  //# sourceMappingURL=UiItemsManager.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"UiItemsManager.js","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/* eslint-disable deprecation/deprecation */\r\n/** @packageDocumentation\r\n * @module UiItemsProvider\r\n */\r\n\r\nimport { BeEvent, Logger, MarkRequired } from \"@itwin/core-bentley\";\r\nimport { BackstageItem } from \"./backstage/BackstageItem\";\r\nimport { CommonStatusBarItem } from \"./statusbar/StatusBarItem\";\r\nimport { CommonToolbarItem, ToolbarOrientation, ToolbarUsage } from \"./toolbars/ToolbarItem\";\r\nimport { AbstractWidgetProps } from \"./widget/AbstractWidgetProps\";\r\nimport { AbstractZoneLocation, StagePanelLocation, StagePanelSection } from \"./widget/StagePanel\";\r\nimport { loggerCategory } from \"./utils/misc\";\r\nimport { UiItemsProvider } from \"./UiItemsProvider\";\r\n\r\n/** Action taken by the application on item provided by a UiItemsProvider\r\n * @public @deprecated in 3.2. This was only used by the previously removed UiItemsArbiter.\r\n */\r\nexport enum UiItemsApplicationAction {\r\n /** Allow the change to the item */\r\n Allow,\r\n /** Disallow the change to the item */\r\n Disallow,\r\n /** Update the item during the change */\r\n Update,\r\n}\r\n\r\n/** UIProvider Registered Event Args interface.\r\n * @deprecated in 3.6. Use [UiItemsProviderRegisteredEventArgs]($appui-react) instead.\r\n * @public\r\n */\r\nexport interface UiItemProviderRegisteredEventArgs {\r\n providerId: string;\r\n}\r\n\r\n/** UiItemProviderOverrides allows the application that registers a provider to limit when it is allowed to provide items\r\n * @deprecated in 3.6. Use [AllowedUiItemsProviderOverrides]($appui-react) instead.\r\n * @public\r\n */\r\nexport interface AllowedUiItemProviderOverrides {\r\n /** allows providerId to be overridden in the items manager for cases where the same provider needs to provide different content to different stages\r\n * @beta\r\n */\r\n providerId?: string;\r\n /** if specified then the current stage's Usage will be compared before allowing any items to be provided\r\n * @beta\r\n */\r\n stageUsages?: string[];\r\n /** if specified then the current stage's Id will be compared before allowing any items to be provided\r\n * @beta\r\n */\r\n stageIds?: string[];\r\n}\r\n\r\n/** Allowed overrides applied to a UiItemsProvider the application that registers a provider to limit when it is allowed to provide items.\r\n * Note that if an override `providerId` is specified then either `stageIds` or `stageUsages` must be defined to limit when the provider's\r\n * items are allowed.\r\n * @deprecated in 3.6. Use [UiItemsProviderOverrides]($appui-react) instead.\r\n * @public\r\n */\r\nexport type UiItemProviderOverrides = MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageUsages\"> |\r\n MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageIds\"> | // eslint-disable-line @typescript-eslint/indent\r\n MarkRequired<AllowedUiItemProviderOverrides, \"stageIds\"> | // eslint-disable-line @typescript-eslint/indent\r\n MarkRequired<AllowedUiItemProviderOverrides, \"stageUsages\"> | // eslint-disable-line @typescript-eslint/indent\r\n MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageUsages\" | \"stageIds\">; // eslint-disable-line @typescript-eslint/indent\r\n\r\n/** Interface that defines an instance of a UiItemsProvider and its application specified overrides. */\r\ninterface UiItemProviderEntry {\r\n provider: UiItemsProvider;\r\n overrides?: UiItemProviderOverrides;\r\n}\r\n\r\n/** Controls registering of UiItemsProviders and calls the provider's methods when populating different parts of the User Interface.\r\n * @deprecated in 3.6. Use [UiItemsManager]($appui-react) instead.\r\n * @public\r\n */\r\nexport class UiItemsManager {\r\n private static _registeredUiItemsProviders: Map<string, UiItemProviderEntry> = new Map<string, UiItemProviderEntry>();\r\n\r\n /** For use in unit testing\r\n * @internal */\r\n public static clearAllProviders() {\r\n UiItemsManager._registeredUiItemsProviders.clear();\r\n }\r\n\r\n /** Event raised any time a UiProvider is registered or unregistered. */\r\n public static readonly onUiProviderRegisteredEvent = new BeEvent<(ev: UiItemProviderRegisteredEventArgs) => void>();\r\n\r\n /** Return number of registered UiProvider. */\r\n public static get registeredProviderIds() {\r\n const ids = [...UiItemsManager._registeredUiItemsProviders.keys()];\r\n return ids;\r\n }\r\n\r\n /** Return true if there is any registered UiProvider. */\r\n public static get hasRegisteredProviders(): boolean {\r\n return this._registeredUiItemsProviders.size > 0;\r\n }\r\n\r\n /**\r\n * Retrieves a previously loaded UiItemsProvider.\r\n * @param providerId id of the UiItemsProvider to get\r\n */\r\n public static getUiItemsProvider(providerId: string): UiItemsProvider | undefined {\r\n return UiItemsManager._registeredUiItemsProviders.get(providerId)?.provider;\r\n }\r\n\r\n private static sendRegisteredEvent(ev: UiItemProviderRegisteredEventArgs) {\r\n UiItemsManager.onUiProviderRegisteredEvent.raiseEvent(ev);\r\n }\r\n\r\n /**\r\n * Registers a UiItemsProvider with the UiItemsManager.\r\n * @param uiProvider the UI items provider to register.\r\n */\r\n public static register(uiProvider: UiItemsProvider, overrides?: UiItemProviderOverrides): void {\r\n const providerId = overrides?.providerId ?? uiProvider.id;\r\n\r\n if (UiItemsManager.getUiItemsProvider(providerId)) {\r\n Logger.logInfo(loggerCategory(this), `UiItemsProvider (${providerId}) is already loaded`);\r\n } else {\r\n UiItemsManager._registeredUiItemsProviders.set(providerId, { provider: uiProvider, overrides });\r\n Logger.logInfo(loggerCategory(this), `UiItemsProvider ${uiProvider.id} registered as ${providerId} `);\r\n\r\n UiItemsManager.sendRegisteredEvent({ providerId } as UiItemProviderRegisteredEventArgs);\r\n }\r\n }\r\n\r\n /** Remove a specific UiItemsProvider from the list of available providers. */\r\n public static unregister(uiProviderId: string): void {\r\n const provider = UiItemsManager.getUiItemsProvider(uiProviderId);\r\n if (!provider)\r\n return;\r\n\r\n provider.onUnregister && provider.onUnregister();\r\n\r\n UiItemsManager._registeredUiItemsProviders.delete(uiProviderId);\r\n Logger.logInfo(loggerCategory(this), `UiItemsProvider (${uiProviderId}) unloaded`);\r\n\r\n // trigger a refresh of the ui\r\n UiItemsManager.sendRegisteredEvent({ providerId: uiProviderId } as UiItemProviderRegisteredEventArgs);\r\n }\r\n\r\n private static allowItemsFromProvider(entry: UiItemProviderEntry, stageId?: string, stageUsage?: string) {\r\n // istanbul ignore else\r\n const overrides = entry.overrides;\r\n if (undefined !== stageId && overrides?.stageIds && !(overrides.stageIds.some((value: string) => value === stageId)))\r\n return false;\r\n if (undefined !== stageUsage && overrides?.stageUsages && !(overrides.stageUsages.some((value: string) => value === stageUsage)))\r\n return false;\r\n return true;\r\n }\r\n\r\n /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute\r\n * an action or specify a registered ToolId into toolbar.\r\n * @param stageId a string identifier the active stage.\r\n * @param stageUsage the StageUsage of the active stage.\r\n * @param toolbarUsage usage of the toolbar\r\n * @param toolbarOrientation orientation of the toolbar\r\n * @returns an array of error messages. The array will be empty if the load is successful, otherwise it is a list of one or more problems.\r\n */\r\n public static getToolbarButtonItems(stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage,\r\n toolbarOrientation: ToolbarOrientation, stageAppData?: any): CommonToolbarItem[] {\r\n const buttonItems: CommonToolbarItem[] = [];\r\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\r\n return buttonItems;\r\n\r\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\r\n const uiProvider = entry.provider;\r\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\r\n // istanbul ignore else\r\n if (uiProvider.provideToolbarButtonItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\r\n uiProvider.provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData)\r\n .forEach((spec: CommonToolbarItem) => {\r\n // ignore duplicate ids\r\n if (-1 === buttonItems.findIndex((existingItem)=> spec.id === existingItem.id ))\r\n buttonItems.push({ ...spec, providerId });\r\n });\r\n }\r\n });\r\n\r\n return buttonItems;\r\n }\r\n\r\n /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields\r\n * @param stageId a string identifier the active stage.\r\n * @param stageUsage the StageUsage of the active stage.\r\n * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.\r\n */\r\n public static getStatusBarItems(stageId: string, stageUsage: string, stageAppData?: any): CommonStatusBarItem[] {\r\n const statusBarItems: CommonStatusBarItem[] = [];\r\n\r\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\r\n return statusBarItems;\r\n\r\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\r\n const uiProvider = entry.provider;\r\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\r\n\r\n // istanbul ignore else\r\n if (uiProvider.provideStatusBarItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\r\n uiProvider.provideStatusBarItems(stageId, stageUsage, stageAppData)\r\n .forEach((item: CommonStatusBarItem) => {\r\n // ignore duplicate ids\r\n if (-1 === statusBarItems.findIndex((existingItem)=> item.id === existingItem.id ))\r\n statusBarItems.push({ ...item, providerId });\r\n });\r\n }\r\n });\r\n\r\n return statusBarItems;\r\n }\r\n\r\n /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields\r\n * @returns An array of BackstageItem that will be used to create controls for the backstage menu.\r\n */\r\n public static getBackstageItems(): BackstageItem[] {\r\n const backstageItems: BackstageItem[] = [];\r\n\r\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\r\n return backstageItems;\r\n\r\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\r\n const uiProvider = entry.provider;\r\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\r\n\r\n // istanbul ignore else\r\n if (uiProvider.provideBackstageItems) { // Note: We do not call this.allowItemsFromProvider here as backstage items\r\n uiProvider.provideBackstageItems() // should not be considered stage specific. If they need to be hidden\r\n .forEach((item: BackstageItem) => { // the isHidden property should be set to a ConditionalBooleanValue\r\n // ignore duplicate ids\r\n if (-1 === backstageItems.findIndex((existingItem)=> item.id === existingItem.id ))\r\n backstageItems.push({ ...item, providerId });\r\n });\r\n }\r\n });\r\n return backstageItems;\r\n }\r\n\r\n /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets\r\n * @param stageId a string identifier the active stage.\r\n * @param stageUsage the StageUsage of the active stage.\r\n * @param location the location within the stage.\r\n * @param section the section within location.\r\n * @returns An array of AbstractWidgetProps that will be used to create widgets.\r\n */\r\n public static getWidgets(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection, zoneLocation?: AbstractZoneLocation, stageAppData?: any): ReadonlyArray<AbstractWidgetProps> {\r\n const widgets: AbstractWidgetProps[] = [];\r\n\r\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\r\n return widgets;\r\n\r\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\r\n const uiProvider = entry.provider;\r\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\r\n\r\n // istanbul ignore else\r\n if (uiProvider.provideWidgets && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\r\n uiProvider.provideWidgets(stageId, stageUsage, location, section, zoneLocation, stageAppData)\r\n .forEach((widget: AbstractWidgetProps) => {\r\n // ignore duplicate ids\r\n if (-1 === widgets.findIndex((existingItem)=> widget.id === existingItem.id ))\r\n widgets.push({ ...widget, providerId });\r\n });\r\n }\r\n });\r\n return widgets;\r\n }\r\n\r\n}\r\n"]}
1
+ {"version":3,"file":"UiItemsManager.js","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module UiItemsProvider\n */\n\nimport { BeEvent, Logger, MarkRequired } from \"@itwin/core-bentley\";\nimport { BackstageItem } from \"./backstage/BackstageItem\";\nimport { CommonStatusBarItem } from \"./statusbar/StatusBarItem\";\nimport { CommonToolbarItem, ToolbarOrientation, ToolbarUsage } from \"./toolbars/ToolbarItem\";\nimport { AbstractWidgetProps } from \"./widget/AbstractWidgetProps\";\nimport { StagePanelLocation, StagePanelSection } from \"./widget/StagePanel\";\nimport { loggerCategory } from \"./utils/misc\";\nimport { UiItemsProvider } from \"./UiItemsProvider\";\n\n/** Action taken by the application on item provided by a UiItemsProvider\n * @public @deprecated this was only used by the previously removed UiItemsArbiter.\n */\nexport enum UiItemsApplicationAction {\n /** Allow the change to the item */\n Allow,\n /** Disallow the change to the item */\n Disallow,\n /** Update the item during the change */\n Update,\n}\n\n/** UIProvider Registered Event Args interface.\n * @public\n */\nexport interface UiItemProviderRegisteredEventArgs {\n providerId: string;\n}\n\n/** UiItemProviderOverrides allows the application that registers a provider to limit when it is allowed to provide items\n * @public\n */\nexport interface AllowedUiItemProviderOverrides {\n /** allows providerId to be overridden in the items manager for cases where the same provider needs to provide different content to different stages\n * @beta\n */\n providerId?: string;\n /** if specified then the current stage's Usage will be compared before allowing any items to be provided\n * @beta\n */\n stageUsages?: string[];\n /** if specified then the current stage's Id will be compared before allowing any items to be provided\n * @beta\n */\n stageIds?: string[];\n}\n\n/** Allowed overrides applied to a UiItemsProvider the application that registers a provider to limit when it is allowed to provide items.\n * Note that if an override `providerId` is specified then either `stageIds` or `stageUsages` must be defined to limit when the provider's\n * items are allowed.\n * @public\n */\nexport type UiItemProviderOverrides = MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageUsages\"> |\n MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageIds\"> | // eslint-disable-line @typescript-eslint/indent\n MarkRequired<AllowedUiItemProviderOverrides, \"stageIds\"> | // eslint-disable-line @typescript-eslint/indent\n MarkRequired<AllowedUiItemProviderOverrides, \"stageUsages\"> | // eslint-disable-line @typescript-eslint/indent\n MarkRequired<AllowedUiItemProviderOverrides, \"providerId\" | \"stageUsages\" | \"stageIds\">; // eslint-disable-line @typescript-eslint/indent\n\n/** Interface that defines an instance of a UiItemsProvider and its application specified overrides.\n * @beta\n */\ninterface UiItemProviderEntry {\n provider: UiItemsProvider;\n overrides?: UiItemProviderOverrides;\n}\n\n/**\n * Controls registering of UiItemsProviders and calls the provider's methods when populating different parts of the User Interface.\n * @public\n */\nexport class UiItemsManager {\n private static _registeredUiItemsProviders: Map<string, UiItemProviderEntry> = new Map<string, UiItemProviderEntry>();\n\n /** For use in unit testing\n * @internal */\n public static clearAllProviders() {\n UiItemsManager._registeredUiItemsProviders.clear();\n }\n\n /** Event raised any time a UiProvider is registered or unregistered. */\n public static readonly onUiProviderRegisteredEvent = new BeEvent<(ev: UiItemProviderRegisteredEventArgs) => void>();\n\n /** Return number of registered UiProvider. */\n public static get registeredProviderIds() {\n const ids = [...UiItemsManager._registeredUiItemsProviders.keys()];\n return ids;\n }\n\n /** Return true if there is any registered UiProvider. */\n public static get hasRegisteredProviders(): boolean {\n return this._registeredUiItemsProviders.size > 0;\n }\n\n /**\n * Retrieves a previously loaded UiItemsProvider.\n * @param providerId id of the UiItemsProvider to get\n */\n public static getUiItemsProvider(providerId: string): UiItemsProvider | undefined {\n return UiItemsManager._registeredUiItemsProviders.get(providerId)?.provider;\n }\n\n private static sendRegisteredEvent(ev: UiItemProviderRegisteredEventArgs) {\n UiItemsManager.onUiProviderRegisteredEvent.raiseEvent(ev);\n }\n\n /**\n * Registers a UiItemsProvider with the UiItemsManager.\n * @param uiProvider the UI items provider to register.\n */\n public static register(uiProvider: UiItemsProvider, overrides?: UiItemProviderOverrides): void {\n const providerId = overrides?.providerId ?? uiProvider.id;\n\n if (UiItemsManager.getUiItemsProvider(providerId)) {\n Logger.logInfo(loggerCategory(this), `UiItemsProvider (${providerId}) is already loaded`);\n } else {\n UiItemsManager._registeredUiItemsProviders.set(providerId, { provider: uiProvider, overrides });\n Logger.logInfo(loggerCategory(this), `UiItemsProvider ${uiProvider.id} registered as ${providerId} `);\n\n UiItemsManager.sendRegisteredEvent({ providerId } as UiItemProviderRegisteredEventArgs);\n }\n }\n\n /** Remove a specific UiItemsProvider from the list of available providers. */\n public static unregister(uiProviderId: string): void {\n const provider = UiItemsManager.getUiItemsProvider(uiProviderId);\n if (!provider)\n return;\n\n provider.onUnregister && provider.onUnregister();\n\n UiItemsManager._registeredUiItemsProviders.delete(uiProviderId);\n Logger.logInfo(loggerCategory(this), `UiItemsProvider (${uiProviderId}) unloaded`);\n\n // trigger a refresh of the ui\n UiItemsManager.sendRegisteredEvent({ providerId: uiProviderId } as UiItemProviderRegisteredEventArgs);\n }\n\n private static allowItemsFromProvider(entry: UiItemProviderEntry, stageId?: string, stageUsage?: string) {\n // istanbul ignore else\n const overrides = entry.overrides;\n if (undefined !== stageId && overrides?.stageIds && !(overrides.stageIds.some((value: string) => value === stageId)))\n return false;\n if (undefined !== stageUsage && overrides?.stageUsages && !(overrides.stageUsages.some((value: string) => value === stageUsage)))\n return false;\n return true;\n }\n\n /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute\n * an action or specify a registered ToolId into toolbar.\n * @param stageId a string identifier the active stage.\n * @param stageUsage the StageUsage of the active stage.\n * @param toolbarUsage usage of the toolbar\n * @param toolbarOrientation orientation of the toolbar\n * @returns an array of error messages. The array will be empty if the load is successful, otherwise it is a list of one or more problems.\n */\n public static getToolbarButtonItems(stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage,\n toolbarOrientation: ToolbarOrientation): CommonToolbarItem[] {\n const buttonItems: CommonToolbarItem[] = [];\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\n return buttonItems;\n\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\n const uiProvider = entry.provider;\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\n // istanbul ignore else\n if (uiProvider.provideToolbarButtonItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\n uiProvider.provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation)\n .forEach((spec: CommonToolbarItem) => {\n // ignore duplicate ids\n if (-1 === buttonItems.findIndex((existingItem) => spec.id === existingItem.id))\n buttonItems.push({ ...spec, providerId });\n });\n }\n });\n\n return buttonItems;\n }\n\n /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields\n * @param stageId a string identifier the active stage.\n * @param stageUsage the StageUsage of the active stage.\n * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.\n */\n public static getStatusBarItems(stageId: string, stageUsage: string): CommonStatusBarItem[] {\n const statusBarItems: CommonStatusBarItem[] = [];\n\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\n return statusBarItems;\n\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\n const uiProvider = entry.provider;\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\n\n // istanbul ignore else\n if (uiProvider.provideStatusBarItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\n uiProvider.provideStatusBarItems(stageId, stageUsage)\n .forEach((item: CommonStatusBarItem) => {\n // ignore duplicate ids\n if (-1 === statusBarItems.findIndex((existingItem) => item.id === existingItem.id))\n statusBarItems.push({ ...item, providerId });\n });\n }\n });\n\n return statusBarItems;\n }\n\n /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields\n * @returns An array of BackstageItem that will be used to create controls for the backstage menu.\n */\n public static getBackstageItems(): BackstageItem[] {\n const backstageItems: BackstageItem[] = [];\n\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\n return backstageItems;\n\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\n const uiProvider = entry.provider;\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\n\n // istanbul ignore else\n if (uiProvider.provideBackstageItems) { // Note: We do not call this.allowItemsFromProvider here as backstage items\n uiProvider.provideBackstageItems() // should not be considered stage specific. If they need to be hidden\n .forEach((item: BackstageItem) => { // the isHidden property should be set to a ConditionalBooleanValue\n // ignore duplicate ids\n if (-1 === backstageItems.findIndex((existingItem) => item.id === existingItem.id))\n backstageItems.push({ ...item, providerId });\n });\n }\n });\n return backstageItems;\n }\n\n /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets\n * @param stageId a string identifier the active stage.\n * @param stageUsage the StageUsage of the active stage.\n * @param location the location within the stage.\n * @param section the section within location.\n * @returns An array of AbstractWidgetProps that will be used to create widgets.\n */\n public static getWidgets(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection): ReadonlyArray<AbstractWidgetProps> {\n const widgets: AbstractWidgetProps[] = [];\n\n if (0 === UiItemsManager._registeredUiItemsProviders.size)\n return widgets;\n\n UiItemsManager._registeredUiItemsProviders.forEach((entry: UiItemProviderEntry) => {\n const uiProvider = entry.provider;\n const providerId = entry.overrides?.providerId ?? uiProvider.id;\n\n // istanbul ignore else\n if (uiProvider.provideWidgets && this.allowItemsFromProvider(entry, stageId, stageUsage)) {\n uiProvider.provideWidgets(stageId, stageUsage, location, section)\n .forEach((widget: AbstractWidgetProps) => {\n // ignore duplicate ids\n if (-1 === widgets.findIndex((existingItem) => widget.id === existingItem.id))\n widgets.push({ ...widget, providerId });\n });\n }\n });\n return widgets;\n }\n\n}\n"]}
@@ -1,30 +1,28 @@
1
- /** @packageDocumentation
2
- * @module UiItemsProvider
3
- */
4
- import { BackstageItem } from "./backstage/BackstageItem";
5
- import { CommonStatusBarItem } from "./statusbar/StatusBarItem";
6
- import { CommonToolbarItem, ToolbarOrientation, ToolbarUsage } from "./toolbars/ToolbarItem";
7
- import { AbstractWidgetProps } from "./widget/AbstractWidgetProps";
8
- import { AbstractZoneLocation, StagePanelLocation, StagePanelSection } from "./widget/StagePanel";
9
- /** Describes interface of objects that want to provide UI component to the running IModelApp.
10
- * @deprecated in 3.6. Use [UiItemsProvider]($appui-react) instead.
11
- * @public
12
- */
13
- export interface UiItemsProvider {
14
- /** id of provider */
15
- readonly id: string;
16
- /** UiItemsManager calls following method to get items to populate specific toolbars */
17
- provideToolbarButtonItems?: (stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation, stageAppData?: any) => CommonToolbarItem[];
18
- /** UiItemsManager calls following method to augment base statusbar for stages that allow it. */
19
- provideStatusBarItems?: (stageId: string, stageUsage: string, stageAppData?: any) => CommonStatusBarItem[];
20
- /** UiItemsManager calls following method to augment backstage items. */
21
- provideBackstageItems?: () => BackstageItem[];
22
- /** UiItemsManager calls following method to augment Widget lists.
23
- * @note Returned widgets must provide unique `AbstractWidgetProps["id"]` to correctly save/restore App layout.
24
- */
25
- provideWidgets?: (stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection, // eslint-disable-line deprecation/deprecation
26
- zoneLocation?: AbstractZoneLocation, stageAppData?: any) => ReadonlyArray<AbstractWidgetProps>;
27
- /** Function called when the provider is unregistered via `ItemsManager.unregister` to allow provider to do cleanup. */
28
- onUnregister?: () => void;
29
- }
1
+ /** @packageDocumentation
2
+ * @module UiItemsProvider
3
+ */
4
+ import { BackstageItem } from "./backstage/BackstageItem";
5
+ import { CommonStatusBarItem } from "./statusbar/StatusBarItem";
6
+ import { CommonToolbarItem, ToolbarOrientation, ToolbarUsage } from "./toolbars/ToolbarItem";
7
+ import { AbstractWidgetProps } from "./widget/AbstractWidgetProps";
8
+ import { StagePanelLocation, StagePanelSection } from "./widget/StagePanel";
9
+ /** Describes interface of objects that want to provide UI component to the running IModelApp.
10
+ * @public
11
+ */
12
+ export interface UiItemsProvider {
13
+ /** id of provider */
14
+ readonly id: string;
15
+ /** UiItemsManager calls following method to get items to populate specific toolbars */
16
+ provideToolbarButtonItems?: (stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation) => CommonToolbarItem[];
17
+ /** UiItemsManager calls following method to augment base statusbar for stages that allow it. */
18
+ provideStatusBarItems?: (stageId: string, stageUsage: string) => CommonStatusBarItem[];
19
+ /** UiItemsManager calls following method to augment backstage items. */
20
+ provideBackstageItems?: () => BackstageItem[];
21
+ /** UiItemsManager calls following method to augment Widget lists.
22
+ * @note Returned widgets must provide unique `AbstractWidgetProps["id"]` to correctly save/restore App layout.
23
+ */
24
+ provideWidgets?: (stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection) => ReadonlyArray<AbstractWidgetProps>;
25
+ /** Function called when the provider is unregistered via `ItemsManager.unregister` to allow provider to do cleanup. */
26
+ onUnregister?: () => void;
27
+ }
30
28
  //# sourceMappingURL=UiItemsProvider.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"UiItemsProvider.d.ts","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,uFAAuF;IACvF,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,GAAG,KAAK,iBAAiB,EAAE,CAAC;IACjL,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,KAAK,mBAAmB,EAAE,CAAC;IAC3G,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,aAAa,EAAE,CAAC;IAC9C;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,8CAA8C;IAC9J,YAAY,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,EAAE,GAAG,KAAK,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACjG,uHAAuH;IACvH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B"}
1
+ {"version":3,"file":"UiItemsProvider.d.ts","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,uFAAuF;IACvF,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,KAAK,iBAAiB,EAAE,CAAC;IAC7J,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,mBAAmB,EAAE,CAAC;IACvF,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,aAAa,EAAE,CAAC;IAC9C;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACxJ,uHAAuH;IACvH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B"}
@@ -1,10 +1,10 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- /** @packageDocumentation
7
- * @module UiItemsProvider
8
- */
9
- Object.defineProperty(exports, "__esModule", { value: true });
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ /** @packageDocumentation
7
+ * @module UiItemsProvider
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
10
  //# sourceMappingURL=UiItemsProvider.js.map