@itwin/appui-abstract 4.1.0-dev.5 → 4.1.0-dev.7

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 (129) hide show
  1. package/lib/cjs/appui-abstract/BaseUiItemsProvider.d.ts +31 -0
  2. package/lib/cjs/appui-abstract/BaseUiItemsProvider.d.ts.map +1 -0
  3. package/lib/cjs/appui-abstract/BaseUiItemsProvider.js +80 -0
  4. package/lib/cjs/appui-abstract/BaseUiItemsProvider.js.map +1 -0
  5. package/lib/cjs/appui-abstract/UiItemsManager.d.ts +114 -0
  6. package/lib/cjs/appui-abstract/UiItemsManager.d.ts.map +1 -0
  7. package/lib/cjs/appui-abstract/UiItemsManager.js +194 -0
  8. package/lib/cjs/appui-abstract/UiItemsManager.js.map +1 -0
  9. package/lib/cjs/appui-abstract/UiItemsProvider.d.ts +30 -0
  10. package/lib/cjs/appui-abstract/UiItemsProvider.d.ts.map +1 -0
  11. package/lib/cjs/appui-abstract/UiItemsProvider.js +10 -0
  12. package/lib/cjs/appui-abstract/UiItemsProvider.js.map +1 -0
  13. package/lib/cjs/appui-abstract/backstage/BackstageItem.d.ts +92 -0
  14. package/lib/cjs/appui-abstract/backstage/BackstageItem.d.ts.map +1 -0
  15. package/lib/cjs/appui-abstract/backstage/BackstageItem.js +71 -0
  16. package/lib/cjs/appui-abstract/backstage/BackstageItem.js.map +1 -0
  17. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.d.ts +39 -0
  18. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.d.ts.map +1 -0
  19. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.js +134 -0
  20. package/lib/cjs/appui-abstract/backstage/BackstageItemsManager.js.map +1 -0
  21. package/lib/cjs/appui-abstract/items/ProvidedItem.d.ts +12 -0
  22. package/lib/cjs/appui-abstract/items/ProvidedItem.d.ts.map +1 -0
  23. package/lib/cjs/appui-abstract/items/ProvidedItem.js +10 -0
  24. package/lib/cjs/appui-abstract/items/ProvidedItem.js.map +1 -0
  25. package/lib/cjs/appui-abstract/items/StageUsage.d.ts +17 -0
  26. package/lib/cjs/appui-abstract/items/StageUsage.d.ts.map +1 -0
  27. package/lib/cjs/appui-abstract/items/StageUsage.js +25 -0
  28. package/lib/cjs/appui-abstract/items/StageUsage.js.map +1 -0
  29. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.d.ts +129 -0
  30. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.d.ts.map +1 -0
  31. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.js +88 -0
  32. package/lib/cjs/appui-abstract/statusbar/StatusBarItem.js.map +1 -0
  33. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.d.ts +40 -0
  34. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.d.ts.map +1 -0
  35. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.js +136 -0
  36. package/lib/cjs/appui-abstract/statusbar/StatusBarItemsManager.js.map +1 -0
  37. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.d.ts +27 -1
  38. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.d.ts.map +1 -1
  39. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.js +23 -1
  40. package/lib/cjs/appui-abstract/toolbars/ToolbarItem.js.map +1 -1
  41. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.d.ts +46 -0
  42. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.d.ts.map +1 -0
  43. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.js +236 -0
  44. package/lib/cjs/appui-abstract/toolbars/ToolbarItemsManager.js.map +1 -0
  45. package/lib/cjs/appui-abstract/utils/isLetter.d.ts +10 -0
  46. package/lib/cjs/appui-abstract/utils/isLetter.d.ts.map +1 -0
  47. package/lib/cjs/appui-abstract/utils/isLetter.js +20 -0
  48. package/lib/cjs/appui-abstract/utils/isLetter.js.map +1 -0
  49. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.d.ts +87 -0
  50. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.d.ts.map +1 -0
  51. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.js +10 -0
  52. package/lib/cjs/appui-abstract/widget/AbstractWidgetProps.js.map +1 -0
  53. package/lib/cjs/appui-abstract/widget/StagePanel.d.ts +37 -0
  54. package/lib/cjs/appui-abstract/widget/StagePanel.d.ts.map +1 -0
  55. package/lib/cjs/appui-abstract/widget/StagePanel.js +47 -0
  56. package/lib/cjs/appui-abstract/widget/StagePanel.js.map +1 -0
  57. package/lib/cjs/appui-abstract/widget/WidgetState.d.ts +20 -0
  58. package/lib/cjs/appui-abstract/widget/WidgetState.d.ts.map +1 -0
  59. package/lib/cjs/appui-abstract/widget/WidgetState.js +28 -0
  60. package/lib/cjs/appui-abstract/widget/WidgetState.js.map +1 -0
  61. package/lib/cjs/appui-abstract.d.ts +32 -0
  62. package/lib/cjs/appui-abstract.d.ts.map +1 -1
  63. package/lib/cjs/appui-abstract.js +32 -0
  64. package/lib/cjs/appui-abstract.js.map +1 -1
  65. package/lib/esm/appui-abstract/BaseUiItemsProvider.d.ts +31 -0
  66. package/lib/esm/appui-abstract/BaseUiItemsProvider.d.ts.map +1 -0
  67. package/lib/esm/appui-abstract/BaseUiItemsProvider.js +76 -0
  68. package/lib/esm/appui-abstract/BaseUiItemsProvider.js.map +1 -0
  69. package/lib/esm/appui-abstract/UiItemsManager.d.ts +114 -0
  70. package/lib/esm/appui-abstract/UiItemsManager.d.ts.map +1 -0
  71. package/lib/esm/appui-abstract/UiItemsManager.js +191 -0
  72. package/lib/esm/appui-abstract/UiItemsManager.js.map +1 -0
  73. package/lib/esm/appui-abstract/UiItemsProvider.d.ts +30 -0
  74. package/lib/esm/appui-abstract/UiItemsProvider.d.ts.map +1 -0
  75. package/lib/esm/appui-abstract/UiItemsProvider.js +9 -0
  76. package/lib/esm/appui-abstract/UiItemsProvider.js.map +1 -0
  77. package/lib/esm/appui-abstract/backstage/BackstageItem.d.ts +92 -0
  78. package/lib/esm/appui-abstract/backstage/BackstageItem.d.ts.map +1 -0
  79. package/lib/esm/appui-abstract/backstage/BackstageItem.js +66 -0
  80. package/lib/esm/appui-abstract/backstage/BackstageItem.js.map +1 -0
  81. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.d.ts +39 -0
  82. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.d.ts.map +1 -0
  83. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.js +130 -0
  84. package/lib/esm/appui-abstract/backstage/BackstageItemsManager.js.map +1 -0
  85. package/lib/esm/appui-abstract/items/ProvidedItem.d.ts +12 -0
  86. package/lib/esm/appui-abstract/items/ProvidedItem.d.ts.map +1 -0
  87. package/lib/esm/appui-abstract/items/ProvidedItem.js +9 -0
  88. package/lib/esm/appui-abstract/items/ProvidedItem.js.map +1 -0
  89. package/lib/esm/appui-abstract/items/StageUsage.d.ts +17 -0
  90. package/lib/esm/appui-abstract/items/StageUsage.d.ts.map +1 -0
  91. package/lib/esm/appui-abstract/items/StageUsage.js +22 -0
  92. package/lib/esm/appui-abstract/items/StageUsage.js.map +1 -0
  93. package/lib/esm/appui-abstract/statusbar/StatusBarItem.d.ts +129 -0
  94. package/lib/esm/appui-abstract/statusbar/StatusBarItem.d.ts.map +1 -0
  95. package/lib/esm/appui-abstract/statusbar/StatusBarItem.js +82 -0
  96. package/lib/esm/appui-abstract/statusbar/StatusBarItem.js.map +1 -0
  97. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.d.ts +40 -0
  98. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.d.ts.map +1 -0
  99. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.js +132 -0
  100. package/lib/esm/appui-abstract/statusbar/StatusBarItemsManager.js.map +1 -0
  101. package/lib/esm/appui-abstract/toolbars/ToolbarItem.d.ts +27 -1
  102. package/lib/esm/appui-abstract/toolbars/ToolbarItem.d.ts.map +1 -1
  103. package/lib/esm/appui-abstract/toolbars/ToolbarItem.js +22 -0
  104. package/lib/esm/appui-abstract/toolbars/ToolbarItem.js.map +1 -1
  105. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.d.ts +46 -0
  106. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.d.ts.map +1 -0
  107. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.js +232 -0
  108. package/lib/esm/appui-abstract/toolbars/ToolbarItemsManager.js.map +1 -0
  109. package/lib/esm/appui-abstract/utils/isLetter.d.ts +10 -0
  110. package/lib/esm/appui-abstract/utils/isLetter.d.ts.map +1 -0
  111. package/lib/esm/appui-abstract/utils/isLetter.js +16 -0
  112. package/lib/esm/appui-abstract/utils/isLetter.js.map +1 -0
  113. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.d.ts +87 -0
  114. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.d.ts.map +1 -0
  115. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.js +9 -0
  116. package/lib/esm/appui-abstract/widget/AbstractWidgetProps.js.map +1 -0
  117. package/lib/esm/appui-abstract/widget/StagePanel.d.ts +37 -0
  118. package/lib/esm/appui-abstract/widget/StagePanel.d.ts.map +1 -0
  119. package/lib/esm/appui-abstract/widget/StagePanel.js +44 -0
  120. package/lib/esm/appui-abstract/widget/StagePanel.js.map +1 -0
  121. package/lib/esm/appui-abstract/widget/WidgetState.d.ts +20 -0
  122. package/lib/esm/appui-abstract/widget/WidgetState.d.ts.map +1 -0
  123. package/lib/esm/appui-abstract/widget/WidgetState.js +25 -0
  124. package/lib/esm/appui-abstract/widget/WidgetState.js.map +1 -0
  125. package/lib/esm/appui-abstract.d.ts +32 -0
  126. package/lib/esm/appui-abstract.d.ts.map +1 -1
  127. package/lib/esm/appui-abstract.js +32 -0
  128. package/lib/esm/appui-abstract.js.map +1 -1
  129. package/package.json +5 -5
@@ -0,0 +1,31 @@
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
+ import { UiItemsProvider } from "./UiItemsProvider";
10
+ /** Base implementation of a UiItemsProvider. The base class allows the user to pass in a function that is used to determine if the
11
+ * active stage should be provided items. Derived provider classes should override the `xxxInternal` methods to provide items.
12
+ * @deprecated in 3.6. Use [BaseUiItemsProvider]($appui-react) instead.
13
+ * @public
14
+ */
15
+ export declare class BaseUiItemsProvider implements UiItemsProvider {
16
+ protected _providerId: string;
17
+ isSupportedStage?: ((stageId: string, stageUsage: string, stageAppData?: any, provider?: UiItemsProvider) => boolean) | undefined;
18
+ constructor(_providerId: string, isSupportedStage?: ((stageId: string, stageUsage: string, stageAppData?: any, provider?: UiItemsProvider) => boolean) | undefined);
19
+ get id(): string;
20
+ onUnregister(): void;
21
+ unregister(): void;
22
+ /** Backstage items are not stage specific so no callback is used */
23
+ provideBackstageItems(): BackstageItem[];
24
+ provideToolbarButtonItemsInternal(_stageId: string, _stageUsage: string, _toolbarUsage: ToolbarUsage, _toolbarOrientation: ToolbarOrientation, _stageAppData?: any): CommonToolbarItem[];
25
+ provideToolbarButtonItems(stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation, stageAppData?: any): CommonToolbarItem[];
26
+ provideStatusBarItemsInternal(_stageId: string, _stageUsage: string, _stageAppData?: any): CommonStatusBarItem[];
27
+ provideStatusBarItems(stageId: string, stageUsage: string, stageAppData?: any): CommonStatusBarItem[];
28
+ provideWidgetsInternal(_stageId: string, _stageUsage: string, _location: StagePanelLocation, _section?: StagePanelSection, _zoneLocation?: AbstractZoneLocation, _stageAppData?: any): AbstractWidgetProps[];
29
+ provideWidgets(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection, _zoneLocation?: AbstractZoneLocation, stageAppData?: any): ReadonlyArray<AbstractWidgetProps>;
30
+ }
31
+ //# sourceMappingURL=BaseUiItemsProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BaseUiItemsProvider.d.ts","sourceRoot":"","sources":["../../../src/appui-abstract/BaseUiItemsProvider.ts"],"names":[],"mappings":"AAKA;;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,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IAO7C,SAAS,CAAC,WAAW,EAAE,MAAM;IAAS,gBAAgB,CAAC,aAAY,MAAM,cAAc,MAAM,iBAAiB,GAAG,aAAa,eAAe,KAAK,OAAO;gBAA/I,WAAW,EAAE,MAAM,EAAS,gBAAgB,CAAC,aAAY,MAAM,cAAc,MAAM,iBAAiB,GAAG,aAAa,eAAe,KAAK,OAAO,aAAA;IAErK,IAAW,EAAE,IAAI,MAAM,CAA6B;IAC7C,YAAY,IAAI,IAAI;IAEpB,UAAU;IAIjB,oEAAoE;IAC7D,qBAAqB,IAAI,aAAa,EAAE;IAIxC,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,iBAAiB,EAAE;IAGxL,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,iBAAiB,EAAE;IAY3K,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,mBAAmB,EAAE;IAGhH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,mBAAmB,EAAE;IAYrG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,oBAAoB,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,mBAAmB,EAAE;IAI5M,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAClH,aAAa,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC,mBAAmB,CAAC;CAWhG"}
@@ -0,0 +1,80 @@
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.BaseUiItemsProvider = void 0;
12
+ const StageUsage_1 = require("./items/StageUsage");
13
+ const UiItemsManager_1 = require("./UiItemsManager");
14
+ /** Base implementation of a UiItemsProvider. The base class allows the user to pass in a function that is used to determine if the
15
+ * active stage should be provided items. Derived provider classes should override the `xxxInternal` methods to provide items.
16
+ * @deprecated in 3.6. Use [BaseUiItemsProvider]($appui-react) instead.
17
+ * @public
18
+ */
19
+ class BaseUiItemsProvider {
20
+ /*
21
+ * @param providerId - unique identifier for this instance of the provider. This is required in case separate packages want
22
+ * to set up custom stage with their own subset of standard tools.
23
+ * @param isSupportedStage - optional function that will be called to determine if tools should be added to current stage. If not set and
24
+ * the current stage's `usage` is set to `StageUsage.General` then the provider will add items to frontstage.
25
+ */
26
+ constructor(_providerId, isSupportedStage) {
27
+ this._providerId = _providerId;
28
+ this.isSupportedStage = isSupportedStage;
29
+ }
30
+ get id() { return this._providerId; }
31
+ onUnregister() { }
32
+ unregister() {
33
+ UiItemsManager_1.UiItemsManager.unregister(this._providerId);
34
+ }
35
+ /** Backstage items are not stage specific so no callback is used */
36
+ provideBackstageItems() {
37
+ return [];
38
+ }
39
+ provideToolbarButtonItemsInternal(_stageId, _stageUsage, _toolbarUsage, _toolbarOrientation, _stageAppData) {
40
+ return [];
41
+ }
42
+ provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData) {
43
+ let provideToStage = false;
44
+ if (this.isSupportedStage) {
45
+ provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);
46
+ }
47
+ else {
48
+ provideToStage = (stageUsage === StageUsage_1.StageUsage.General);
49
+ }
50
+ return provideToStage ? this.provideToolbarButtonItemsInternal(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData) : [];
51
+ }
52
+ provideStatusBarItemsInternal(_stageId, _stageUsage, _stageAppData) {
53
+ return [];
54
+ }
55
+ provideStatusBarItems(stageId, stageUsage, stageAppData) {
56
+ let provideToStage = false;
57
+ if (this.isSupportedStage) {
58
+ provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);
59
+ }
60
+ else {
61
+ provideToStage = (stageUsage === StageUsage_1.StageUsage.General);
62
+ }
63
+ return provideToStage ? this.provideStatusBarItemsInternal(stageId, stageUsage, stageAppData) : [];
64
+ }
65
+ provideWidgetsInternal(_stageId, _stageUsage, _location, _section, _zoneLocation, _stageAppData) {
66
+ return [];
67
+ }
68
+ provideWidgets(stageId, stageUsage, location, section, _zoneLocation, stageAppData) {
69
+ let provideToStage = false;
70
+ if (this.isSupportedStage) {
71
+ provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);
72
+ }
73
+ else {
74
+ provideToStage = (stageUsage === StageUsage_1.StageUsage.General);
75
+ }
76
+ return provideToStage ? this.provideWidgetsInternal(stageId, stageUsage, location, section, _zoneLocation, stageAppData) : [];
77
+ }
78
+ }
79
+ exports.BaseUiItemsProvider = BaseUiItemsProvider;
80
+ //# sourceMappingURL=BaseUiItemsProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BaseUiItemsProvider.js","sourceRoot":"","sources":["../../../src/appui-abstract/BaseUiItemsProvider.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F,4CAA4C;AAC5C;;GAEG;;;AAOH,mDAAgD;AAEhD,qDAAkD;AAElD;;;;GAIG;AACH,MAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,YAAsB,WAAmB,EAAS,gBAAmH;QAA/I,gBAAW,GAAX,WAAW,CAAQ;QAAS,qBAAgB,GAAhB,gBAAgB,CAAmG;IAAI,CAAC;IAE1K,IAAW,EAAE,KAAa,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7C,YAAY,KAAW,CAAC;IAExB,UAAU;QACf,+BAAc,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,oEAAoE;IAC7D,qBAAqB;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,iCAAiC,CAAC,QAAgB,EAAE,WAAmB,EAAE,aAA2B,EAAE,mBAAuC,EAAE,aAAmB;QACvK,OAAO,EAAE,CAAC;IACZ,CAAC;IACM,yBAAyB,CAAC,OAAe,EAAE,UAAkB,EAAE,YAA0B,EAAE,kBAAsC,EAAE,YAAkB;QAC1J,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,IAAI,IAAI,CAAC,gBAAgB,EAAE;YACzB,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;SACjF;aAAM;YACL,cAAc,GAAG,CAAC,UAAU,KAAK,uBAAU,CAAC,OAAO,CAAC,CAAC;SACtD;QAED,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3I,CAAC;IAEM,6BAA6B,CAAC,QAAgB,EAAE,WAAmB,EAAE,aAAmB;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;IACM,qBAAqB,CAAC,OAAe,EAAE,UAAkB,EAAE,YAAkB;QAClF,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,IAAI,IAAI,CAAC,gBAAgB,EAAE;YACzB,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;SACjF;aAAM;YACL,cAAc,GAAG,CAAC,UAAU,KAAK,uBAAU,CAAC,OAAO,CAAC,CAAC;SACtD;QAED,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,CAAC;IAEM,sBAAsB,CAAC,QAAgB,EAAE,WAAmB,EAAE,SAA6B,EAAE,QAA4B,EAAE,aAAoC,EAAE,aAAmB;QACzL,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,cAAc,CAAC,OAAe,EAAE,UAAkB,EAAE,QAA4B,EAAE,OAA2B,EAClH,aAAoC,EAAE,YAAkB;QACxD,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,IAAI,IAAI,CAAC,gBAAgB,EAAE;YACzB,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;SACjF;aAAM;YACL,cAAc,GAAG,CAAC,UAAU,KAAK,uBAAU,CAAC,OAAO,CAAC,CAAC;SACtD;QAED,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChI,CAAC;CACF;AAnED,kDAmEC","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 { 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 { StageUsage } from \"./items/StageUsage\";\r\nimport { UiItemsProvider } from \"./UiItemsProvider\";\r\nimport { UiItemsManager } from \"./UiItemsManager\";\r\n\r\n/** Base implementation of a UiItemsProvider. The base class allows the user to pass in a function that is used to determine if the\r\n * active stage should be provided items. Derived provider classes should override the `xxxInternal` methods to provide items.\r\n * @deprecated in 3.6. Use [BaseUiItemsProvider]($appui-react) instead.\r\n * @public\r\n */\r\nexport class BaseUiItemsProvider implements UiItemsProvider {\r\n /*\r\n * @param providerId - unique identifier for this instance of the provider. This is required in case separate packages want\r\n * to set up custom stage with their own subset of standard tools.\r\n * @param isSupportedStage - optional function that will be called to determine if tools should be added to current stage. If not set and\r\n * the current stage's `usage` is set to `StageUsage.General` then the provider will add items to frontstage.\r\n */\r\n constructor(protected _providerId: string, public isSupportedStage?: (stageId: string, stageUsage: string, stageAppData?: any, provider?: UiItemsProvider) => boolean) { }\r\n\r\n public get id(): string { return this._providerId; }\r\n public onUnregister(): void { }\r\n\r\n public unregister() {\r\n UiItemsManager.unregister(this._providerId);\r\n }\r\n\r\n /** Backstage items are not stage specific so no callback is used */\r\n public provideBackstageItems(): BackstageItem[] {\r\n return [];\r\n }\r\n\r\n public provideToolbarButtonItemsInternal(_stageId: string, _stageUsage: string, _toolbarUsage: ToolbarUsage, _toolbarOrientation: ToolbarOrientation, _stageAppData?: any): CommonToolbarItem[] {\r\n return [];\r\n }\r\n public provideToolbarButtonItems(stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation, stageAppData?: any): CommonToolbarItem[] {\r\n let provideToStage = false;\r\n\r\n if (this.isSupportedStage) {\r\n provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);\r\n } else {\r\n provideToStage = (stageUsage === StageUsage.General);\r\n }\r\n\r\n return provideToStage ? this.provideToolbarButtonItemsInternal(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData) : [];\r\n }\r\n\r\n public provideStatusBarItemsInternal(_stageId: string, _stageUsage: string, _stageAppData?: any): CommonStatusBarItem[] {\r\n return [];\r\n }\r\n public provideStatusBarItems(stageId: string, stageUsage: string, stageAppData?: any): CommonStatusBarItem[] {\r\n let provideToStage = false;\r\n\r\n if (this.isSupportedStage) {\r\n provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);\r\n } else {\r\n provideToStage = (stageUsage === StageUsage.General);\r\n }\r\n\r\n return provideToStage ? this.provideStatusBarItemsInternal(stageId, stageUsage, stageAppData) : [];\r\n }\r\n\r\n public provideWidgetsInternal(_stageId: string, _stageUsage: string, _location: StagePanelLocation, _section?: StagePanelSection, _zoneLocation?: AbstractZoneLocation, _stageAppData?: any): AbstractWidgetProps[] {\r\n return [];\r\n }\r\n\r\n public provideWidgets(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection,\r\n _zoneLocation?: AbstractZoneLocation, stageAppData?: any): ReadonlyArray<AbstractWidgetProps> {\r\n let provideToStage = false;\r\n\r\n if (this.isSupportedStage) {\r\n provideToStage = this.isSupportedStage(stageId, stageUsage, stageAppData, this);\r\n } else {\r\n provideToStage = (stageUsage === StageUsage.General);\r\n }\r\n\r\n return provideToStage ? this.provideWidgetsInternal(stageId, stageUsage, location, section, _zoneLocation, stageAppData) : [];\r\n }\r\n}\r\n"]}
@@ -0,0 +1,114 @@
1
+ /** @packageDocumentation
2
+ * @module UiItemsProvider
3
+ */
4
+ import { BeEvent, MarkRequired } from "@itwin/core-bentley";
5
+ import { BackstageItem } from "./backstage/BackstageItem";
6
+ import { CommonStatusBarItem } from "./statusbar/StatusBarItem";
7
+ import { CommonToolbarItem, ToolbarOrientation, ToolbarUsage } from "./toolbars/ToolbarItem";
8
+ import { AbstractWidgetProps } from "./widget/AbstractWidgetProps";
9
+ import { AbstractZoneLocation, StagePanelLocation, StagePanelSection } from "./widget/StagePanel";
10
+ import { UiItemsProvider } from "./UiItemsProvider";
11
+ /** Action taken by the application on item provided by a UiItemsProvider
12
+ * @public @deprecated in 3.2. This was only used by the previously removed UiItemsArbiter.
13
+ */
14
+ export declare enum UiItemsApplicationAction {
15
+ /** Allow the change to the item */
16
+ Allow = 0,
17
+ /** Disallow the change to the item */
18
+ Disallow = 1,
19
+ /** Update the item during the change */
20
+ Update = 2
21
+ }
22
+ /** UIProvider Registered Event Args interface.
23
+ * @deprecated in 3.6. Use [UiItemsProviderRegisteredEventArgs]($appui-react) instead.
24
+ * @public
25
+ */
26
+ export interface UiItemProviderRegisteredEventArgs {
27
+ providerId: string;
28
+ }
29
+ /** UiItemProviderOverrides allows the application that registers a provider to limit when it is allowed to provide items
30
+ * @deprecated in 3.6. Use [AllowedUiItemsProviderOverrides]($appui-react) instead.
31
+ * @public
32
+ */
33
+ export interface AllowedUiItemProviderOverrides {
34
+ /** allows providerId to be overridden in the items manager for cases where the same provider needs to provide different content to different stages
35
+ * @beta
36
+ */
37
+ providerId?: string;
38
+ /** if specified then the current stage's Usage will be compared before allowing any items to be provided
39
+ * @beta
40
+ */
41
+ stageUsages?: string[];
42
+ /** if specified then the current stage's Id will be compared before allowing any items to be provided
43
+ * @beta
44
+ */
45
+ stageIds?: string[];
46
+ }
47
+ /** Allowed overrides applied to a UiItemsProvider the application that registers a provider to limit when it is allowed to provide items.
48
+ * Note that if an override `providerId` is specified then either `stageIds` or `stageUsages` must be defined to limit when the provider's
49
+ * items are allowed.
50
+ * @deprecated in 3.6. Use [UiItemsProviderOverrides]($appui-react) instead.
51
+ * @public
52
+ */
53
+ export type UiItemProviderOverrides = MarkRequired<AllowedUiItemProviderOverrides, "providerId" | "stageUsages"> | MarkRequired<AllowedUiItemProviderOverrides, "providerId" | "stageIds"> | // eslint-disable-line @typescript-eslint/indent
54
+ MarkRequired<AllowedUiItemProviderOverrides, "stageIds"> | // eslint-disable-line @typescript-eslint/indent
55
+ MarkRequired<AllowedUiItemProviderOverrides, "stageUsages"> | // eslint-disable-line @typescript-eslint/indent
56
+ MarkRequired<AllowedUiItemProviderOverrides, "providerId" | "stageUsages" | "stageIds">;
57
+ /** Controls registering of UiItemsProviders and calls the provider's methods when populating different parts of the User Interface.
58
+ * @deprecated in 3.6. Use [UiItemsManager]($appui-react) instead.
59
+ * @public
60
+ */
61
+ export declare class UiItemsManager {
62
+ private static _registeredUiItemsProviders;
63
+ /** For use in unit testing
64
+ * @internal */
65
+ static clearAllProviders(): void;
66
+ /** Event raised any time a UiProvider is registered or unregistered. */
67
+ static readonly onUiProviderRegisteredEvent: BeEvent<(ev: UiItemProviderRegisteredEventArgs) => void>;
68
+ /** Return number of registered UiProvider. */
69
+ static get registeredProviderIds(): string[];
70
+ /** Return true if there is any registered UiProvider. */
71
+ static get hasRegisteredProviders(): boolean;
72
+ /**
73
+ * Retrieves a previously loaded UiItemsProvider.
74
+ * @param providerId id of the UiItemsProvider to get
75
+ */
76
+ static getUiItemsProvider(providerId: string): UiItemsProvider | undefined;
77
+ private static sendRegisteredEvent;
78
+ /**
79
+ * Registers a UiItemsProvider with the UiItemsManager.
80
+ * @param uiProvider the UI items provider to register.
81
+ */
82
+ static register(uiProvider: UiItemsProvider, overrides?: UiItemProviderOverrides): void;
83
+ /** Remove a specific UiItemsProvider from the list of available providers. */
84
+ static unregister(uiProviderId: string): void;
85
+ private static allowItemsFromProvider;
86
+ /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute
87
+ * an action or specify a registered ToolId into toolbar.
88
+ * @param stageId a string identifier the active stage.
89
+ * @param stageUsage the StageUsage of the active stage.
90
+ * @param toolbarUsage usage of the toolbar
91
+ * @param toolbarOrientation orientation of the toolbar
92
+ * @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.
93
+ */
94
+ static getToolbarButtonItems(stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation, stageAppData?: any): CommonToolbarItem[];
95
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
96
+ * @param stageId a string identifier the active stage.
97
+ * @param stageUsage the StageUsage of the active stage.
98
+ * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.
99
+ */
100
+ static getStatusBarItems(stageId: string, stageUsage: string, stageAppData?: any): CommonStatusBarItem[];
101
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
102
+ * @returns An array of BackstageItem that will be used to create controls for the backstage menu.
103
+ */
104
+ static getBackstageItems(): BackstageItem[];
105
+ /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets
106
+ * @param stageId a string identifier the active stage.
107
+ * @param stageUsage the StageUsage of the active stage.
108
+ * @param location the location within the stage.
109
+ * @param section the section within location.
110
+ * @returns An array of AbstractWidgetProps that will be used to create widgets.
111
+ */
112
+ static getWidgets(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection, zoneLocation?: AbstractZoneLocation, stageAppData?: any): ReadonlyArray<AbstractWidgetProps>;
113
+ }
114
+ //# sourceMappingURL=UiItemsManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UiItemsManager.d.ts","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,194 @@
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
+ return UiItemsManager._registeredUiItemsProviders.get(providerId)?.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
+ const providerId = overrides?.providerId ?? uiProvider.id;
61
+ if (UiItemsManager.getUiItemsProvider(providerId)) {
62
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${providerId}) is already loaded`);
63
+ }
64
+ else {
65
+ UiItemsManager._registeredUiItemsProviders.set(providerId, { provider: uiProvider, overrides });
66
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider ${uiProvider.id} registered as ${providerId} `);
67
+ UiItemsManager.sendRegisteredEvent({ providerId });
68
+ }
69
+ }
70
+ /** Remove a specific UiItemsProvider from the list of available providers. */
71
+ static unregister(uiProviderId) {
72
+ const provider = UiItemsManager.getUiItemsProvider(uiProviderId);
73
+ if (!provider)
74
+ return;
75
+ provider.onUnregister && provider.onUnregister();
76
+ UiItemsManager._registeredUiItemsProviders.delete(uiProviderId);
77
+ core_bentley_1.Logger.logInfo((0, misc_1.loggerCategory)(this), `UiItemsProvider (${uiProviderId}) unloaded`);
78
+ // trigger a refresh of the ui
79
+ UiItemsManager.sendRegisteredEvent({ providerId: uiProviderId });
80
+ }
81
+ static allowItemsFromProvider(entry, stageId, stageUsage) {
82
+ // istanbul ignore else
83
+ const overrides = entry.overrides;
84
+ if (undefined !== stageId && overrides?.stageIds && !(overrides.stageIds.some((value) => value === stageId)))
85
+ return false;
86
+ if (undefined !== stageUsage && overrides?.stageUsages && !(overrides.stageUsages.some((value) => value === stageUsage)))
87
+ return false;
88
+ return true;
89
+ }
90
+ /** Called when the application is populating a toolbar so that any registered UiItemsProvider can add tool buttons that either either execute
91
+ * an action or specify a registered ToolId into toolbar.
92
+ * @param stageId a string identifier the active stage.
93
+ * @param stageUsage the StageUsage of the active stage.
94
+ * @param toolbarUsage usage of the toolbar
95
+ * @param toolbarOrientation orientation of the toolbar
96
+ * @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.
97
+ */
98
+ static getToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData) {
99
+ const buttonItems = [];
100
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
101
+ return buttonItems;
102
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
103
+ const uiProvider = entry.provider;
104
+ const providerId = entry.overrides?.providerId ?? uiProvider.id;
105
+ // istanbul ignore else
106
+ if (uiProvider.provideToolbarButtonItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
107
+ uiProvider.provideToolbarButtonItems(stageId, stageUsage, toolbarUsage, toolbarOrientation, stageAppData)
108
+ .forEach((spec) => {
109
+ // ignore duplicate ids
110
+ if (-1 === buttonItems.findIndex((existingItem) => spec.id === existingItem.id))
111
+ buttonItems.push({ ...spec, providerId });
112
+ });
113
+ }
114
+ });
115
+ return buttonItems;
116
+ }
117
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
118
+ * @param stageId a string identifier the active stage.
119
+ * @param stageUsage the StageUsage of the active stage.
120
+ * @returns An array of CommonStatusBarItem that will be used to create controls for the status bar.
121
+ */
122
+ static getStatusBarItems(stageId, stageUsage, stageAppData) {
123
+ const statusBarItems = [];
124
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
125
+ return statusBarItems;
126
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
127
+ const uiProvider = entry.provider;
128
+ const providerId = entry.overrides?.providerId ?? uiProvider.id;
129
+ // istanbul ignore else
130
+ if (uiProvider.provideStatusBarItems && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
131
+ uiProvider.provideStatusBarItems(stageId, stageUsage, stageAppData)
132
+ .forEach((item) => {
133
+ // ignore duplicate ids
134
+ if (-1 === statusBarItems.findIndex((existingItem) => item.id === existingItem.id))
135
+ statusBarItems.push({ ...item, providerId });
136
+ });
137
+ }
138
+ });
139
+ return statusBarItems;
140
+ }
141
+ /** Called when the application is populating the statusbar so that any registered UiItemsProvider can add status fields
142
+ * @returns An array of BackstageItem that will be used to create controls for the backstage menu.
143
+ */
144
+ static getBackstageItems() {
145
+ const backstageItems = [];
146
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
147
+ return backstageItems;
148
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
149
+ const uiProvider = entry.provider;
150
+ const providerId = entry.overrides?.providerId ?? uiProvider.id;
151
+ // istanbul ignore else
152
+ if (uiProvider.provideBackstageItems) { // Note: We do not call this.allowItemsFromProvider here as backstage items
153
+ uiProvider.provideBackstageItems() // should not be considered stage specific. If they need to be hidden
154
+ .forEach((item) => {
155
+ // ignore duplicate ids
156
+ if (-1 === backstageItems.findIndex((existingItem) => item.id === existingItem.id))
157
+ backstageItems.push({ ...item, providerId });
158
+ });
159
+ }
160
+ });
161
+ return backstageItems;
162
+ }
163
+ /** Called when the application is populating the Stage Panels so that any registered UiItemsProvider can add widgets
164
+ * @param stageId a string identifier the active stage.
165
+ * @param stageUsage the StageUsage of the active stage.
166
+ * @param location the location within the stage.
167
+ * @param section the section within location.
168
+ * @returns An array of AbstractWidgetProps that will be used to create widgets.
169
+ */
170
+ static getWidgets(stageId, stageUsage, location, section, zoneLocation, stageAppData) {
171
+ const widgets = [];
172
+ if (0 === UiItemsManager._registeredUiItemsProviders.size)
173
+ return widgets;
174
+ UiItemsManager._registeredUiItemsProviders.forEach((entry) => {
175
+ const uiProvider = entry.provider;
176
+ const providerId = entry.overrides?.providerId ?? uiProvider.id;
177
+ // istanbul ignore else
178
+ if (uiProvider.provideWidgets && this.allowItemsFromProvider(entry, stageId, stageUsage)) {
179
+ uiProvider.provideWidgets(stageId, stageUsage, location, section, zoneLocation, stageAppData)
180
+ .forEach((widget) => {
181
+ // ignore duplicate ids
182
+ if (-1 === widgets.findIndex((existingItem) => widget.id === existingItem.id))
183
+ widgets.push({ ...widget, providerId });
184
+ });
185
+ }
186
+ });
187
+ return widgets;
188
+ }
189
+ }
190
+ UiItemsManager._registeredUiItemsProviders = new Map();
191
+ /** Event raised any time a UiProvider is registered or unregistered. */
192
+ UiItemsManager.onUiProviderRegisteredEvent = new core_bentley_1.BeEvent();
193
+ exports.UiItemsManager = UiItemsManager;
194
+ //# sourceMappingURL=UiItemsManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UiItemsManager.js","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsManager.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F,4CAA4C;AAC5C;;GAEG;;;AAEH,sDAAoE;AAMpE,uCAA8C;AAG9C;;GAEG;AACH,IAAY,wBAOX;AAPD,WAAY,wBAAwB;IAClC,mCAAmC;IACnC,yEAAK,CAAA;IACL,sCAAsC;IACtC,+EAAQ,CAAA;IACR,wCAAwC;IACxC,2EAAM,CAAA;AACR,CAAC,EAPW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAOnC;AA+CD;;;GAGG;AACH,MAAa,cAAc;IAGzB;mBACe;IACR,MAAM,CAAC,iBAAiB;QAC7B,cAAc,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;IAKD,8CAA8C;IACvC,MAAM,KAAK,qBAAqB;QACrC,MAAM,GAAG,GAAG,CAAC,GAAG,cAAc,CAAC,2BAA2B,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yDAAyD;IAClD,MAAM,KAAK,sBAAsB;QACtC,OAAO,IAAI,CAAC,2BAA2B,CAAC,IAAI,GAAG,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,kBAAkB,CAAC,UAAkB;QACjD,OAAO,cAAc,CAAC,2BAA2B,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAC9E,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAAC,EAAqC;QACtE,cAAc,CAAC,2BAA2B,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,QAAQ,CAAC,UAA2B,EAAE,SAAmC;QACrF,MAAM,UAAU,GAAG,SAAS,EAAE,UAAU,IAAI,UAAU,CAAC,EAAE,CAAC;QAE1D,IAAI,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE;YACjD,qBAAM,CAAC,OAAO,CAAC,IAAA,qBAAc,EAAC,IAAI,CAAC,EAAE,oBAAoB,UAAU,qBAAqB,CAAC,CAAC;SAC3F;aAAM;YACL,cAAc,CAAC,2BAA2B,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAChG,qBAAM,CAAC,OAAO,CAAC,IAAA,qBAAc,EAAC,IAAI,CAAC,EAAE,mBAAmB,UAAU,CAAC,EAAE,kBAAkB,UAAU,GAAG,CAAC,CAAC;YAEtG,cAAc,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAuC,CAAC,CAAC;SACzF;IACH,CAAC;IAED,8EAA8E;IACvE,MAAM,CAAC,UAAU,CAAC,YAAoB;QAC3C,MAAM,QAAQ,GAAG,cAAc,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ;YACX,OAAO;QAET,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAEjD,cAAc,CAAC,2BAA2B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChE,qBAAM,CAAC,OAAO,CAAC,IAAA,qBAAc,EAAC,IAAI,CAAC,EAAE,oBAAoB,YAAY,YAAY,CAAC,CAAC;QAEnF,8BAA8B;QAC9B,cAAc,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAuC,CAAC,CAAC;IACxG,CAAC;IAEO,MAAM,CAAC,sBAAsB,CAAC,KAA0B,EAAE,OAAgB,EAAE,UAAmB;QACrG,uBAAuB;QACvB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,EAAE,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;YAClH,OAAO,KAAK,CAAC;QACf,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,EAAE,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;YAC9H,OAAO,KAAK,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,qBAAqB,CAAC,OAAe,EAAE,UAAkB,EAAE,YAA0B,EACjG,kBAAsC,EAAE,YAAkB;QAC1D,MAAM,WAAW,GAAwB,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,cAAc,CAAC,2BAA2B,CAAC,IAAI;YACvD,OAAO,WAAW,CAAC;QAErB,cAAc,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,KAA0B,EAAE,EAAE;YAChF,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,IAAI,UAAU,CAAC,EAAE,CAAC;YAChE,uBAAuB;YACvB,IAAI,UAAU,CAAC,yBAAyB,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE;gBACnG,UAAU,CAAC,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,CAAC;qBACtG,OAAO,CAAC,CAAC,IAAuB,EAAE,EAAE;oBACnC,uBAAuB;oBACvB,IAAI,CAAC,CAAC,KAAK,WAAW,CAAC,SAAS,CAAC,CAAC,YAAY,EAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,CAAE;wBAC7E,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;aACN;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,OAAe,EAAE,UAAkB,EAAE,YAAkB;QACrF,MAAM,cAAc,GAA0B,EAAE,CAAC;QAEjD,IAAI,CAAC,KAAK,cAAc,CAAC,2BAA2B,CAAC,IAAI;YACvD,OAAO,cAAc,CAAC;QAExB,cAAc,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,KAA0B,EAAE,EAAE;YAChF,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,IAAI,UAAU,CAAC,EAAE,CAAC;YAEhE,uBAAuB;YACvB,IAAI,UAAU,CAAC,qBAAqB,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE;gBAC/F,UAAU,CAAC,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC;qBAChE,OAAO,CAAC,CAAC,IAAyB,EAAE,EAAE;oBACrC,uBAAuB;oBACvB,IAAI,CAAC,CAAC,KAAK,cAAc,CAAC,SAAS,CAAC,CAAC,YAAY,EAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,CAAE;wBAChF,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;aACN;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB;QAC7B,MAAM,cAAc,GAAoB,EAAE,CAAC;QAE3C,IAAI,CAAC,KAAK,cAAc,CAAC,2BAA2B,CAAC,IAAI;YACvD,OAAO,cAAc,CAAC;QAExB,cAAc,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,KAA0B,EAAE,EAAE;YAChF,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,IAAI,UAAU,CAAC,EAAE,CAAC;YAEhE,uBAAuB;YACvB,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,2EAA2E;gBACjH,UAAU,CAAC,qBAAqB,EAAE,CAAI,2EAA2E;qBAC9G,OAAO,CAAC,CAAC,IAAmB,EAAE,EAAE;oBAC/B,uBAAuB;oBACvB,IAAI,CAAC,CAAC,KAAK,cAAc,CAAC,SAAS,CAAC,CAAC,YAAY,EAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,CAAE;wBAChF,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;aACN;QACH,CAAC,CAAC,CAAC;QACH,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,UAAU,CAAC,OAAe,EAAE,UAAkB,EAAE,QAA4B,EAAE,OAA2B,EAAE,YAAmC,EAAE,YAAkB;QAC9K,MAAM,OAAO,GAA0B,EAAE,CAAC;QAE1C,IAAI,CAAC,KAAK,cAAc,CAAC,2BAA2B,CAAC,IAAI;YACvD,OAAO,OAAO,CAAC;QAEjB,cAAc,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,KAA0B,EAAE,EAAE;YAChF,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,IAAI,UAAU,CAAC,EAAE,CAAC;YAEhE,uBAAuB;YACvB,IAAI,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE;gBACxF,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC;qBAC1F,OAAO,CAAC,CAAC,MAA2B,EAAE,EAAE;oBACvC,uBAAuB;oBACvB,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,YAAY,EAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,CAAE;wBAC3E,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC5C,CAAC,CAAC,CAAC;aACN;QACH,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;;AA9Lc,0CAA2B,GAAqC,IAAI,GAAG,EAA+B,CAAC;AAQtH,wEAAwE;AACjD,0CAA2B,GAAG,IAAI,sBAAO,EAAmD,CAAC;AAVzG,wCAAc","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"]}
@@ -0,0 +1,30 @@
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
+ }
30
+ //# sourceMappingURL=UiItemsProvider.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +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 });
10
+ //# sourceMappingURL=UiItemsProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UiItemsProvider.js","sourceRoot":"","sources":["../../../src/appui-abstract/UiItemsProvider.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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/** @packageDocumentation\r\n * @module UiItemsProvider\r\n */\r\n\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\n\r\n/** Describes interface of objects that want to provide UI component to the running IModelApp.\r\n * @deprecated in 3.6. Use [UiItemsProvider]($appui-react) instead.\r\n * @public\r\n */\r\nexport interface UiItemsProvider {\r\n /** id of provider */\r\n readonly id: string;\r\n\r\n /** UiItemsManager calls following method to get items to populate specific toolbars */\r\n provideToolbarButtonItems?: (stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation, stageAppData?: any) => CommonToolbarItem[]; // eslint-disable-line deprecation/deprecation\r\n /** UiItemsManager calls following method to augment base statusbar for stages that allow it. */\r\n provideStatusBarItems?: (stageId: string, stageUsage: string, stageAppData?: any) => CommonStatusBarItem[]; // eslint-disable-line deprecation/deprecation\r\n /** UiItemsManager calls following method to augment backstage items. */\r\n provideBackstageItems?: () => BackstageItem[]; // eslint-disable-line deprecation/deprecation\r\n /** UiItemsManager calls following method to augment Widget lists.\r\n * @note Returned widgets must provide unique `AbstractWidgetProps[\"id\"]` to correctly save/restore App layout.\r\n */\r\n provideWidgets?: (stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection, // eslint-disable-line deprecation/deprecation\r\n zoneLocation?: AbstractZoneLocation, stageAppData?: any) => ReadonlyArray<AbstractWidgetProps>; // eslint-disable-line deprecation/deprecation\r\n /** Function called when the provider is unregistered via `ItemsManager.unregister` to allow provider to do cleanup. */\r\n onUnregister?: () => void;\r\n}\r\n"]}