@itwin/appui-react 3.7.1 → 3.7.3

package/lib/esm/appui-react/widgets/WidgetHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetHost.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetHost.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,4CAA4C;AAC5C;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C;;;GAGG;AACH,MAAM,OAAO,UAAU;IAMrB;OACG;IACH;QANQ,gBAAW,GAAgB,IAAI,KAAK,EAAa,CAAC;QAElD,sBAAiB,GAA6B,EAAE,CAAC;IAIzC,CAAC;IAEjB;;OAEG;IACI,YAAY,CAAC,SAAoB;QACtC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,gCAAgC;IAChC,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,kCAAkC;IAClC,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,kBAAkB;QACvB,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SAC3B;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,EAAU;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAoB,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACI,uBAAuB,CAAC,OAAe,EAAE,UAAkB,EAAE,QAA2C,EAAE,OAAsC,EACrJ,kBAA+B,EAAE,yBAA+B;;QAEhE,gEAAgE;QAChE,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;YAC1D,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,kBAAkB,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;QAE1C,IAAI,iBAAmD,CAAC;QAExD,IAAI,WAAW,CAAC,SAAS,KAAK,GAAG,EAAE;YACjC,uBAAuB;YACvB,IAAI,QAAQ,IAAI,YAAY,EAAE;gBAC5B,QAAQ,QAAQ,EAAE;oBAChB,KAAK,YAAY,CAAC,UAAU;wBAC1B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BAChK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;yBAClD;wBACD,MAAM;oBACR,KAAK,YAAY,CAAC,UAAU;wBAC1B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BAChK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;yBAClD;wBACD,MAAM;oBACR,KAAK,YAAY,CAAC,WAAW;wBAC3B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BACjK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;yBAClD;wBACD,MAAM,CAAC,uBAAuB;oBAChC,KAAK,YAAY,CAAC,WAAW;wBAC3B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BACjK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;yBAClD;wBACD,MAAM;iBACT;aACF;iBAAM,IAAI,CAAC,QAAQ,IAAI,kBAAkB,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE;gBACpE,QAAQ,OAAO,EAAE;oBACf,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;wBAC5B,iBAAiB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBACrJ,MAAM;qBACP;oBACD,KAAK,iBAAiB,CAAC,MAAM;wBAC3B,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBAClK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;wBACjD,MAAM,CAAC,sBAAsB;oBAC/B,KAAK,iBAAiB,CAAC,GAAG,CAAC,CAAC;wBAC1B,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,GAAG,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBAC/J,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;wBACjD,MAAM;qBACP;iBACF;aACF;SAEF;aAAM;YACL,IAAI,QAAQ,IAAI,YAAY,EAAE;gBAC5B,QAAQ,QAAQ,EAAE;oBAChB,KAAK,YAAY,CAAC,UAAU;wBAC1B,MAAM,CAAC,sBAAsB;oBAC/B,KAAK,YAAY,CAAC,UAAU;wBAC1B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BAChK,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BAChK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,EAAE,GAAG,uBAAuB,CAAC,CAAC;yBAC9E;wBACD,MAAM;oBACR,KAAK,YAAY,CAAC,WAAW;wBAC3B,MAAM,CAAC,uBAAuB;oBAChC,KAAK,YAAY,CAAC,WAAW;wBAC3B;4BACE,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BACjK,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;4BACjK,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,EAAE,GAAG,uBAAuB,CAAC,CAAC;yBAC9E;wBACD,MAAM;iBACT;aACF;;YACD,uBAAuB;YACvB,IAAI,CAAC,QAAQ,IAAI,kBAAkB,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE;gBAC7D,QAAQ,OAAO,EAAE;oBACf,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;wBAC5B,iBAAiB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBACrJ,MAAM;qBACP;oBACD,KAAK,iBAAiB,CAAC,MAAM;wBAC3B,MAAM,CAAC,sBAAsB;oBAC/B,KAAK,iBAAiB,CAAC,GAAG,CAAC,CAAC;wBAC1B,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBAClK,MAAM,uBAAuB,GAAG,MAAA,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,GAAG,EAAE,yBAAyB,CAAC,mCAAI,EAAE,CAAC;wBAC/J,iBAAiB,GAAG,CAAC,GAAG,uBAAuB,EAAE,GAAG,uBAAuB,CAAC,CAAC;wBAC7E,MAAM;qBACP;iBACF;aACF;SACF;QAED,MAAM,uBAAuB,GAAG,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;YACtE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,oHAAoH;QACpH,kHAAkH;QAClH,IAAI,uBAAuB,EAAE;YAC3B,kBAAkB,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,CAAC;YACpD,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;SACxD;QACD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,wBAAwB;IAChB,cAAc;QACpB,IAAI,gBAAgB,GAAG,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,kBAAkB;YACzB,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;;YAEpE,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAE9C,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEzD,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAC5C,CAAC;CACF","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 Widget\r\n */\r\n\r\nimport { StagePanelLocation, StagePanelSection } from \"@itwin/appui-abstract\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { ZoneLocation } from \"../zones/Zone\";\r\nimport { WidgetDef } from \"./WidgetDef\";\r\n\r\n/**\r\n * A WidgetHost represents a definition that hosts one or most Widgets in a Frontstage.\r\n * @public\r\n */\r\nexport class WidgetHost {\r\n\r\n  private _widgetDefs: WidgetDef[] = new Array<WidgetDef>();\r\n  private _dynamicWidgetDefs: ReadonlyArray<WidgetDef> | undefined;\r\n  private _sortedWidgetDefs: ReadonlyArray<WidgetDef> = [];\r\n\r\n  /** Constructor for WidgetHost.\r\n   */\r\n  constructor() { }\r\n\r\n  /** Adds a WidgetDef to the list of Widgets.\r\n   * @param widgetDef  Definition of the Widget to add\r\n   */\r\n  public addWidgetDef(widgetDef: WidgetDef) {\r\n    this._widgetDefs.push(widgetDef);\r\n    this.sortWidgetDefs();\r\n  }\r\n\r\n  /** Gets the list of Widgets. */\r\n  public get widgetDefs(): ReadonlyArray<WidgetDef> {\r\n    return this._sortedWidgetDefs;\r\n  }\r\n\r\n  /** Gets the number of Widgets. */\r\n  public get widgetCount(): number {\r\n    return this.widgetDefs.length;\r\n  }\r\n\r\n  /** If there is only one Widget in the Panel, gets the single WidgetDef.\r\n   * @returns The single WidgetDef if there is only one Widget; otherwise, undefined is returned.\r\n   */\r\n  public getSingleWidgetDef(): WidgetDef | undefined {\r\n    if (this.widgetCount === 1) {\r\n      return this.widgetDefs[0];\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /** Finds a WidgetDef with a given Id.\r\n   * @param id  Id of the WidgetDef to find\r\n   * @returns The WidgetDef if found; otherwise, undefined is returned.\r\n   */\r\n  public findWidgetDef(id: string): WidgetDef | undefined {\r\n    return this.widgetDefs.find((widgetDef: WidgetDef) => widgetDef.id === id);\r\n  }\r\n\r\n  /** Updates the WidgetHost with dynamic widgets\r\n   * @internal\r\n   */\r\n  public updateDynamicWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section: StagePanelSection | undefined,\r\n    allStageWidgetDefs: WidgetDef[], frontstageApplicationData?: any\r\n  ): void {\r\n    // get widgetDefs not already in allStageWidgetDefs and add them\r\n    const uniqueWidgets = this._widgetDefs.filter((widgetDef) => {\r\n      return !allStageWidgetDefs.find((wDef) => wDef.id === widgetDef.id);\r\n    });\r\n\r\n    allStageWidgetDefs.push(...uniqueWidgets);\r\n\r\n    let dynamicWidgetDefs: readonly WidgetDef[] | undefined;\r\n\r\n    if (UiFramework.uiVersion === \"1\") {\r\n      // istanbul ignore next\r\n      if (location in ZoneLocation) {\r\n        switch (location) {\r\n          case ZoneLocation.CenterLeft:\r\n            {\r\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterLeft, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs];\r\n            }\r\n            break;\r\n          case ZoneLocation.BottomLeft:\r\n            {\r\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomLeft, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\r\n            }\r\n            break;\r\n          case ZoneLocation.CenterRight:\r\n            {\r\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterRight, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs];\r\n            }\r\n            break; // added to BottomRight\r\n          case ZoneLocation.BottomRight:\r\n            {\r\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomRight, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\r\n            }\r\n            break;\r\n        }\r\n      } else if ((location in StagePanelLocation) && undefined !== section) {\r\n        switch (section) {\r\n          case StagePanelSection.Start: {\r\n            dynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Start, frontstageApplicationData) ?? [];\r\n            break;\r\n          }\r\n          case StagePanelSection.Middle:\r\n            const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Middle, frontstageApplicationData) ?? [];\r\n            dynamicWidgetDefs = [...middleDynamicWidgetDefs];\r\n            break; // added to BottomLeft\r\n          case StagePanelSection.End: {\r\n            const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.End, frontstageApplicationData) ?? [];\r\n            dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\r\n            break;\r\n          }\r\n        }\r\n      }\r\n\r\n    } else {\r\n      if (location in ZoneLocation) {\r\n        switch (location) {\r\n          case ZoneLocation.CenterLeft:\r\n            break; // added to BottomLeft\r\n          case ZoneLocation.BottomLeft:\r\n            {\r\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterLeft, section, frontstageApplicationData) ?? [];\r\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomLeft, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\r\n            }\r\n            break;\r\n          case ZoneLocation.CenterRight:\r\n            break; // added to BottomRight\r\n          case ZoneLocation.BottomRight:\r\n            {\r\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterRight, section, frontstageApplicationData) ?? [];\r\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomRight, section, frontstageApplicationData) ?? [];\r\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\r\n            }\r\n            break;\r\n        }\r\n      } else\r\n      // istanbul ignore else\r\n      if ((location in StagePanelLocation) && undefined !== section) {\r\n        switch (section) {\r\n          case StagePanelSection.Start: {\r\n            dynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Start, frontstageApplicationData) ?? [];\r\n            break;\r\n          }\r\n          case StagePanelSection.Middle:\r\n            break; // added to BottomLeft\r\n          case StagePanelSection.End: {\r\n            const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Middle, frontstageApplicationData) ?? [];\r\n            const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.End, frontstageApplicationData) ?? [];\r\n            dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\r\n            break;\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    const uniqueDynamicWidgetDefs = dynamicWidgetDefs?.filter((widgetDef) => {\r\n      return ((!allStageWidgetDefs.find((wDef) => wDef.id === widgetDef.id)));\r\n    });\r\n\r\n    // Now that we no longer support a middle panel section, yet we have existing API that allows a middle section to be\r\n    // defined, the following is needed to combining middle and end panel section widgets into a single set of widgets\r\n    if (uniqueDynamicWidgetDefs) {\r\n      allStageWidgetDefs.push(...uniqueDynamicWidgetDefs);\r\n      this._dynamicWidgetDefs = [...uniqueDynamicWidgetDefs];\r\n    }\r\n    this.sortWidgetDefs();\r\n  }\r\n\r\n  /** Sorts all widgets */\r\n  private sortWidgetDefs(): void {\r\n    let sortedWidgetDefs = [];\r\n    if (this._dynamicWidgetDefs)\r\n      sortedWidgetDefs = this._widgetDefs.concat(this._dynamicWidgetDefs);\r\n    else\r\n      sortedWidgetDefs = this._widgetDefs.slice();\r\n\r\n    sortedWidgetDefs.sort((a, b) => a.priority - b.priority);\r\n\r\n    this._sortedWidgetDefs = sortedWidgetDefs;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"WidgetHost.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetHost.tsx"],"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/* eslint-disable deprecation/deprecation */\n/** @packageDocumentation\n * @module Widget\n */\n\nimport { StagePanelLocation, StagePanelSection } from \"@itwin/appui-abstract\";\nimport { UiFramework } from \"../UiFramework\";\nimport { ZoneLocation } from \"../zones/Zone\";\nimport { WidgetDef } from \"./WidgetDef\";\n\n/**\n * A WidgetHost represents a definition that hosts one or most Widgets in a Frontstage.\n * @public\n */\nexport class WidgetHost {\n\n  private _widgetDefs: WidgetDef[] = new Array<WidgetDef>();\n  private _dynamicWidgetDefs: ReadonlyArray<WidgetDef> | undefined;\n  private _sortedWidgetDefs: ReadonlyArray<WidgetDef> = [];\n\n  /** Constructor for WidgetHost.\n   */\n  constructor() { }\n\n  /** Adds a WidgetDef to the list of Widgets.\n   * @param widgetDef  Definition of the Widget to add\n   */\n  public addWidgetDef(widgetDef: WidgetDef) {\n    this._widgetDefs.push(widgetDef);\n    this.sortWidgetDefs();\n  }\n\n  /** Gets the list of Widgets. */\n  public get widgetDefs(): ReadonlyArray<WidgetDef> {\n    return this._sortedWidgetDefs;\n  }\n\n  /** Gets the number of Widgets. */\n  public get widgetCount(): number {\n    return this.widgetDefs.length;\n  }\n\n  /** If there is only one Widget in the Panel, gets the single WidgetDef.\n   * @returns The single WidgetDef if there is only one Widget; otherwise, undefined is returned.\n   */\n  public getSingleWidgetDef(): WidgetDef | undefined {\n    if (this.widgetCount === 1) {\n      return this.widgetDefs[0];\n    }\n    return undefined;\n  }\n\n  /** Finds a WidgetDef with a given Id.\n   * @param id  Id of the WidgetDef to find\n   * @returns The WidgetDef if found; otherwise, undefined is returned.\n   */\n  public findWidgetDef(id: string): WidgetDef | undefined {\n    return this.widgetDefs.find((widgetDef: WidgetDef) => widgetDef.id === id);\n  }\n\n  /** Updates the WidgetHost with dynamic widgets\n   * @internal\n   */\n  public updateDynamicWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section: StagePanelSection | undefined,\n    allStageWidgetDefs: WidgetDef[], frontstageApplicationData?: any\n  ): void {\n    // get widgetDefs not already in allStageWidgetDefs and add them\n    const uniqueWidgets = this._widgetDefs.filter((widgetDef) => {\n      return !allStageWidgetDefs.find((wDef) => wDef.id === widgetDef.id);\n    });\n\n    allStageWidgetDefs.push(...uniqueWidgets);\n\n    let dynamicWidgetDefs: readonly WidgetDef[] | undefined;\n\n    if (UiFramework.uiVersion === \"1\") {\n      // istanbul ignore next\n      if (location in ZoneLocation) {\n        switch (location) {\n          case ZoneLocation.CenterLeft:\n            {\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterLeft, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs];\n            }\n            break;\n          case ZoneLocation.BottomLeft:\n            {\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomLeft, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\n            }\n            break;\n          case ZoneLocation.CenterRight:\n            {\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterRight, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs];\n            }\n            break; // added to BottomRight\n          case ZoneLocation.BottomRight:\n            {\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomRight, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\n            }\n            break;\n        }\n      } else if ((location in StagePanelLocation) && undefined !== section) {\n        switch (section) {\n          case StagePanelSection.Start: {\n            dynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Start, frontstageApplicationData) ?? [];\n            break;\n          }\n          case StagePanelSection.Middle:\n            const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Middle, frontstageApplicationData) ?? [];\n            dynamicWidgetDefs = [...middleDynamicWidgetDefs];\n            break; // added to BottomLeft\n          case StagePanelSection.End: {\n            const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.End, frontstageApplicationData) ?? [];\n            dynamicWidgetDefs = [...bottomDynamicWidgetDefs];\n            break;\n          }\n        }\n      }\n\n    } else {\n      if (location in ZoneLocation) {\n        switch (location) {\n          case ZoneLocation.CenterLeft:\n            break; // added to BottomLeft\n          case ZoneLocation.BottomLeft:\n            {\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterLeft, section, frontstageApplicationData) ?? [];\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomLeft, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\n            }\n            break;\n          case ZoneLocation.CenterRight:\n            break; // added to BottomRight\n          case ZoneLocation.BottomRight:\n            {\n              const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.CenterRight, section, frontstageApplicationData) ?? [];\n              const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, ZoneLocation.BottomRight, section, frontstageApplicationData) ?? [];\n              dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\n            }\n            break;\n        }\n      } else\n      // istanbul ignore else\n      if ((location in StagePanelLocation) && undefined !== section) {\n        switch (section) {\n          case StagePanelSection.Start: {\n            dynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Start, frontstageApplicationData) ?? [];\n            break;\n          }\n          case StagePanelSection.Middle:\n            break; // added to BottomLeft\n          case StagePanelSection.End: {\n            const middleDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.Middle, frontstageApplicationData) ?? [];\n            const bottomDynamicWidgetDefs = UiFramework.widgetManager.getWidgetDefs(stageId, stageUsage, location, StagePanelSection.End, frontstageApplicationData) ?? [];\n            dynamicWidgetDefs = [...middleDynamicWidgetDefs, ...bottomDynamicWidgetDefs];\n            break;\n          }\n        }\n      }\n    }\n\n    const uniqueDynamicWidgetDefs = dynamicWidgetDefs?.filter((widgetDef) => {\n      return ((!allStageWidgetDefs.find((wDef) => wDef.id === widgetDef.id)));\n    });\n\n    // Now that we no longer support a middle panel section, yet we have existing API that allows a middle section to be\n    // defined, the following is needed to combining middle and end panel section widgets into a single set of widgets\n    if (uniqueDynamicWidgetDefs) {\n      allStageWidgetDefs.push(...uniqueDynamicWidgetDefs);\n      this._dynamicWidgetDefs = [...uniqueDynamicWidgetDefs];\n    }\n    this.sortWidgetDefs();\n  }\n\n  /** Sorts all widgets */\n  private sortWidgetDefs(): void {\n    let sortedWidgetDefs = [];\n    if (this._dynamicWidgetDefs)\n      sortedWidgetDefs = this._widgetDefs.concat(this._dynamicWidgetDefs);\n    else\n      sortedWidgetDefs = this._widgetDefs.slice();\n\n    sortedWidgetDefs.sort((a, b) => a.priority - b.priority);\n\n    this._sortedWidgetDefs = sortedWidgetDefs;\n  }\n}\n"]}

package/lib/esm/appui-react/widgets/WidgetManager.d.ts

@@ -1,57 +1,57 @@
-/** @packageDocumentation
- * @module Widget
- */
-import { BeUiEvent } from "@itwin/core-bentley";
-import { StagePanelLocation, StagePanelSection } from "@itwin/appui-abstract";
-import { ZoneLocation } from "../zones/Zone";
-import { WidgetDef } from "./WidgetDef";
-/** Information about WidgetDefs in the WidgetManager
- * @internal
- */
-export interface WidgetInfo {
-    widgetDef: WidgetDef;
-    stageId?: string;
-    stageUsage?: string;
-    location: ZoneLocation | StagePanelLocation;
-    section: StagePanelSection;
-}
-/** Arguments of [[this.onWidgetsChanged]] event.
- * @internal
- */
-export interface WidgetsChangedEventArgs {
-    readonly items: ReadonlyArray<WidgetInfo>;
-}
-/** Event class for [[this.onWidgetsChanged]].
- * @internal
- */
-export declare class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> {
-}
-/** Widget Manager class.
- * @beta
- */
-export declare class WidgetManager {
-    private _widgets;
-    /** Event raised when Widgets are changed.
-     * @internal
-     */
-    readonly onWidgetsChanged: WidgetsChangedEvent;
-    /** @internal */
-    get widgetCount(): number;
-    /** @internal */
-    get widgets(): ReadonlyArray<WidgetInfo>;
-    set widgets(w: ReadonlyArray<WidgetInfo>);
-    /** Adds a WidgetDef for use in a Frontstage.
-     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
-     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
-     * but correctness of such id depends on `addWidgetDef` call order and widget location.
-     */
-    addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean;
-    /** Removes a WidgetDef.
-     */
-    removeWidgetDef(widgetId: string): boolean;
-    private getStagePanelLocationFromZoneLocation;
-    /** Gets WidgetDefs for a Frontstage location.
-     */
-    getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection, frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined;
-}
+/** @packageDocumentation
+ * @module Widget
+ */
+import { BeUiEvent } from "@itwin/core-bentley";
+import { StagePanelLocation, StagePanelSection } from "@itwin/appui-abstract";
+import { ZoneLocation } from "../zones/Zone";
+import { WidgetDef } from "./WidgetDef";
+/** Information about WidgetDefs in the WidgetManager
+ * @internal
+ */
+export interface WidgetInfo {
+    widgetDef: WidgetDef;
+    stageId?: string;
+    stageUsage?: string;
+    location: ZoneLocation | StagePanelLocation;
+    section: StagePanelSection;
+}
+/** Arguments of [[this.onWidgetsChanged]] event.
+ * @internal
+ */
+export interface WidgetsChangedEventArgs {
+    readonly items: ReadonlyArray<WidgetInfo>;
+}
+/** Event class for [[this.onWidgetsChanged]].
+ * @internal
+ */
+export declare class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> {
+}
+/** Widget Manager class.
+ * @beta
+ */
+export declare class WidgetManager {
+    private _widgets;
+    /** Event raised when Widgets are changed.
+     * @internal
+     */
+    readonly onWidgetsChanged: WidgetsChangedEvent;
+    /** @internal */
+    get widgetCount(): number;
+    /** @internal */
+    get widgets(): ReadonlyArray<WidgetInfo>;
+    set widgets(w: ReadonlyArray<WidgetInfo>);
+    /** Adds a WidgetDef for use in a Frontstage.
+     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
+     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
+     * but correctness of such id depends on `addWidgetDef` call order and widget location.
+     */
+    addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean;
+    /** Removes a WidgetDef.
+     */
+    removeWidgetDef(widgetId: string): boolean;
+    private getStagePanelLocationFromZoneLocation;
+    /** Gets WidgetDefs for a Frontstage location.
+     */
+    getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection, frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined;
+}
 //# sourceMappingURL=WidgetManager.d.ts.map

package/lib/esm/appui-react/widgets/WidgetManager.js

@@ -1,150 +1,150 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/* eslint-disable deprecation/deprecation */
-/** @packageDocumentation
- * @module Widget
- */
-import { BeUiEvent, Logger } from "@itwin/core-bentley";
-import { AbstractZoneLocation, StagePanelLocation, StagePanelSection, UiItemsManager } from "@itwin/appui-abstract";
-import { UiFramework } from "../UiFramework";
-import { getStableWidgetProps, ZoneLocation } from "../zones/Zone";
-import { WidgetDef } from "./WidgetDef";
-import { createStableWidgetDef } from "./StableWidgetDef";
-/** Event class for [[this.onWidgetsChanged]].
- * @internal
- */
-export class WidgetsChangedEvent extends BeUiEvent {
-}
-function isZoneLocation(location) {
-    return location >= ZoneLocation.TopLeft && location <= ZoneLocation.BottomRight;
-}
-function getLocationName(location) {
-    return isZoneLocation(location) ? ZoneLocation[location] : StagePanelLocation[location];
-}
-function getWidgetManagerStableWidgetId(stageUsage, location, section, index) {
-    return `uifw-wm-${stageUsage || ""}-${getLocationName(location)}-${StagePanelSection[section]}-${index}`;
-}
-function getAddonStableWidgetId(stageUsage, location, section, index) {
-    return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;
-}
-/** Widget Manager class.
- * @beta
- */
-export class WidgetManager {
-    constructor() {
-        this._widgets = [];
-        /** Event raised when Widgets are changed.
-         * @internal
-         */
-        this.onWidgetsChanged = new WidgetsChangedEvent();
-    }
-    /** @internal */
-    get widgetCount() {
-        return this._widgets.length;
-    }
-    /** @internal */
-    get widgets() { return this._widgets; }
-    set widgets(w) {
-        this._widgets = w;
-        this.onWidgetsChanged.emit({ items: w });
-    }
-    /** Adds a WidgetDef for use in a Frontstage.
-     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
-     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
-     * but correctness of such id depends on `addWidgetDef` call order and widget location.
-     */
-    addWidgetDef(widgetDef, stageId, stageUsage, location, section) {
-        if (stageId === undefined && stageUsage === undefined) {
-            Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);
-            return false;
-        }
-        section = (section !== undefined) ? section : StagePanelSection.Start;
-        const index = this._widgets.reduce((acc, info) => {
-            if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)
-                return acc + 1;
-            return acc;
-        }, 0);
-        const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);
-        const stableWidget = createStableWidgetDef(widgetDef, stableId);
-        const newWidget = { widgetDef: stableWidget, stageId, stageUsage, location, section };
-        const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);
-        const updatedWidgets = [
-            ...oldWidgets,
-            newWidget,
-        ];
-        this.widgets = updatedWidgets;
-        return true;
-    }
-    /** Removes a WidgetDef.
-     */
-    removeWidgetDef(widgetId) {
-        let result = false;
-        const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);
-        if (updatedWidgets.length !== this._widgets.length) {
-            this.widgets = updatedWidgets;
-            result = true;
-        }
-        return result;
-    }
-    // Used when WidgetDefs are requested from UiItemProviders when uiVersion="1"
-    // istanbul ignore next
-    getStagePanelLocationFromZoneLocation(location) {
-        switch (location) {
-            case ZoneLocation.BottomCenter:
-            case ZoneLocation.TopCenter:
-            case ZoneLocation.TopRight:
-            case ZoneLocation.TopLeft:
-                return undefined; // an existing stage does not support appending widgets to these zones
-            case ZoneLocation.BottomLeft:
-            case ZoneLocation.CenterLeft:
-                return StagePanelLocation.Left;
-            case ZoneLocation.BottomRight:
-            case ZoneLocation.CenterRight:
-                return StagePanelLocation.Right;
-        }
-    }
-    /** Gets WidgetDefs for a Frontstage location.
-     */
-    getWidgetDefs(stageId, stageUsage, location, section, frontstageApplicationData) {
-        const definedSection = section === undefined ? StagePanelSection.Start : section;
-        const widgetInfos = this._widgets.filter((info) => {
-            return (!info.stageId || info.stageId === stageId)
-                && (!info.stageUsage || info.stageUsage === stageUsage)
-                && info.location === location
-                && info.section === definedSection;
-        });
-        const widgetDefs = widgetInfos.map((info) => info.widgetDef);
-        // Consult the UiItemsManager to get any Abstract widgets
-        if (location in StagePanelLocation) {
-            const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location, definedSection, undefined, frontstageApplicationData);
-            widgets.forEach((abstractProps, index) => {
-                const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
-                const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
-                const stableProps = getStableWidgetProps(props, stableId);
-                const wd = new WidgetDef(stableProps);
-                widgetDefs.push(wd);
-            });
-        }
-        else {
-            // istanbul ignore else
-            if (location in ZoneLocation) {
-                const panelLocation = this.getStagePanelLocationFromZoneLocation(location);
-                // istanbul ignore else
-                if (panelLocation && location in AbstractZoneLocation) {
-                    const widgets = UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location, frontstageApplicationData);
-                    widgets.forEach((abstractProps, index) => {
-                        const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
-                        const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
-                        const stableProps = getStableWidgetProps(props, stableId);
-                        const wd = new WidgetDef(stableProps);
-                        widgetDefs.push(wd);
-                    });
-                }
-            }
-        }
-        return widgetDefs.length > 0 ? widgetDefs : undefined;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/* eslint-disable deprecation/deprecation */
+/** @packageDocumentation
+ * @module Widget
+ */
+import { BeUiEvent, Logger } from "@itwin/core-bentley";
+import { AbstractZoneLocation, StagePanelLocation, StagePanelSection, UiItemsManager } from "@itwin/appui-abstract";
+import { UiFramework } from "../UiFramework";
+import { getStableWidgetProps, ZoneLocation } from "../zones/Zone";
+import { WidgetDef } from "./WidgetDef";
+import { createStableWidgetDef } from "./StableWidgetDef";
+/** Event class for [[this.onWidgetsChanged]].
+ * @internal
+ */
+export class WidgetsChangedEvent extends BeUiEvent {
+}
+function isZoneLocation(location) {
+    return location >= ZoneLocation.TopLeft && location <= ZoneLocation.BottomRight;
+}
+function getLocationName(location) {
+    return isZoneLocation(location) ? ZoneLocation[location] : StagePanelLocation[location];
+}
+function getWidgetManagerStableWidgetId(stageUsage, location, section, index) {
+    return `uifw-wm-${stageUsage || ""}-${getLocationName(location)}-${StagePanelSection[section]}-${index}`;
+}
+function getAddonStableWidgetId(stageUsage, location, section, index) {
+    return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;
+}
+/** Widget Manager class.
+ * @beta
+ */
+export class WidgetManager {
+    constructor() {
+        this._widgets = [];
+        /** Event raised when Widgets are changed.
+         * @internal
+         */
+        this.onWidgetsChanged = new WidgetsChangedEvent();
+    }
+    /** @internal */
+    get widgetCount() {
+        return this._widgets.length;
+    }
+    /** @internal */
+    get widgets() { return this._widgets; }
+    set widgets(w) {
+        this._widgets = w;
+        this.onWidgetsChanged.emit({ items: w });
+    }
+    /** Adds a WidgetDef for use in a Frontstage.
+     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
+     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
+     * but correctness of such id depends on `addWidgetDef` call order and widget location.
+     */
+    addWidgetDef(widgetDef, stageId, stageUsage, location, section) {
+        if (stageId === undefined && stageUsage === undefined) {
+            Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);
+            return false;
+        }
+        section = (section !== undefined) ? section : StagePanelSection.Start;
+        const index = this._widgets.reduce((acc, info) => {
+            if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)
+                return acc + 1;
+            return acc;
+        }, 0);
+        const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);
+        const stableWidget = createStableWidgetDef(widgetDef, stableId);
+        const newWidget = { widgetDef: stableWidget, stageId, stageUsage, location, section };
+        const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);
+        const updatedWidgets = [
+            ...oldWidgets,
+            newWidget,
+        ];
+        this.widgets = updatedWidgets;
+        return true;
+    }
+    /** Removes a WidgetDef.
+     */
+    removeWidgetDef(widgetId) {
+        let result = false;
+        const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);
+        if (updatedWidgets.length !== this._widgets.length) {
+            this.widgets = updatedWidgets;
+            result = true;
+        }
+        return result;
+    }
+    // Used when WidgetDefs are requested from UiItemProviders when uiVersion="1"
+    // istanbul ignore next
+    getStagePanelLocationFromZoneLocation(location) {
+        switch (location) {
+            case ZoneLocation.BottomCenter:
+            case ZoneLocation.TopCenter:
+            case ZoneLocation.TopRight:
+            case ZoneLocation.TopLeft:
+                return undefined; // an existing stage does not support appending widgets to these zones
+            case ZoneLocation.BottomLeft:
+            case ZoneLocation.CenterLeft:
+                return StagePanelLocation.Left;
+            case ZoneLocation.BottomRight:
+            case ZoneLocation.CenterRight:
+                return StagePanelLocation.Right;
+        }
+    }
+    /** Gets WidgetDefs for a Frontstage location.
+     */
+    getWidgetDefs(stageId, stageUsage, location, section, frontstageApplicationData) {
+        const definedSection = section === undefined ? StagePanelSection.Start : section;
+        const widgetInfos = this._widgets.filter((info) => {
+            return (!info.stageId || info.stageId === stageId)
+                && (!info.stageUsage || info.stageUsage === stageUsage)
+                && info.location === location
+                && info.section === definedSection;
+        });
+        const widgetDefs = widgetInfos.map((info) => info.widgetDef);
+        // Consult the UiItemsManager to get any Abstract widgets
+        if (location in StagePanelLocation) {
+            const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location, definedSection, undefined, frontstageApplicationData);
+            widgets.forEach((abstractProps, index) => {
+                const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
+                const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
+                const stableProps = getStableWidgetProps(props, stableId);
+                const wd = new WidgetDef(stableProps);
+                widgetDefs.push(wd);
+            });
+        }
+        else {
+            // istanbul ignore else
+            if (location in ZoneLocation) {
+                const panelLocation = this.getStagePanelLocationFromZoneLocation(location);
+                // istanbul ignore else
+                if (panelLocation && location in AbstractZoneLocation) {
+                    const widgets = UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location, frontstageApplicationData);
+                    widgets.forEach((abstractProps, index) => {
+                        const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
+                        const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
+                        const stableProps = getStableWidgetProps(props, stableId);
+                        const wd = new WidgetDef(stableProps);
+                        widgetDefs.push(wd);
+                    });
+                }
+            }
+        }
+        return widgetDefs.length > 0 ? widgetDefs : undefined;
+    }
+}
 //# sourceMappingURL=WidgetManager.js.map

package/lib/esm/appui-react/widgets/WidgetManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetManager.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.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 Widget\r\n */\r\n\r\nimport { BeUiEvent, Logger } from \"@itwin/core-bentley\";\r\nimport { AbstractWidgetProps, AbstractZoneLocation, StagePanelLocation, StagePanelSection, UiItemsManager } from \"@itwin/appui-abstract\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { getStableWidgetProps, ZoneLocation } from \"../zones/Zone\";\r\nimport { WidgetDef } from \"./WidgetDef\";\r\nimport { createStableWidgetDef } from \"./StableWidgetDef\";\r\n\r\n/** Information about WidgetDefs in the WidgetManager\r\n * @internal\r\n */\r\nexport interface WidgetInfo {\r\n  widgetDef: WidgetDef;\r\n  stageId?: string;\r\n  stageUsage?: string;\r\n  location: ZoneLocation | StagePanelLocation;\r\n  section: StagePanelSection;\r\n}\r\n\r\n/** Arguments of [[this.onWidgetsChanged]] event.\r\n * @internal\r\n */\r\nexport interface WidgetsChangedEventArgs {\r\n  readonly items: ReadonlyArray<WidgetInfo>;\r\n}\r\n\r\n/** Event class for [[this.onWidgetsChanged]].\r\n * @internal\r\n */\r\nexport class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> { }\r\n\r\nfunction isZoneLocation(location: ZoneLocation | StagePanelLocation): location is ZoneLocation {\r\n  return location >= ZoneLocation.TopLeft && location <= ZoneLocation.BottomRight;\r\n}\r\n\r\nfunction getLocationName(location: ZoneLocation | StagePanelLocation) {\r\n  return isZoneLocation(location) ? ZoneLocation[location] : StagePanelLocation[location];\r\n}\r\n\r\nfunction getWidgetManagerStableWidgetId(stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section: StagePanelSection,\r\n  index: number) {\r\n  return `uifw-wm-${stageUsage || \"\"}-${getLocationName(location)}-${StagePanelSection[section]}-${index}`;\r\n}\r\n\r\nfunction getAddonStableWidgetId(stageUsage: string, location: StagePanelLocation, section: StagePanelSection, index: number) {\r\n  return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;\r\n}\r\n\r\n/** Widget Manager class.\r\n * @beta\r\n */\r\nexport class WidgetManager {\r\n  private _widgets: ReadonlyArray<WidgetInfo> = [];\r\n\r\n  /** Event raised when Widgets are changed.\r\n   * @internal\r\n   */\r\n  public readonly onWidgetsChanged = new WidgetsChangedEvent();\r\n\r\n  /** @internal */\r\n  public get widgetCount(): number {\r\n    return this._widgets.length;\r\n  }\r\n\r\n  /** @internal */\r\n  public get widgets(): ReadonlyArray<WidgetInfo> { return this._widgets; }\r\n  public set widgets(w: ReadonlyArray<WidgetInfo>) {\r\n    this._widgets = w;\r\n    this.onWidgetsChanged.emit({ items: w });\r\n  }\r\n\r\n  /** Adds a WidgetDef for use in a Frontstage.\r\n   * @note Added `widgetDef` must return unique id to correctly save/restore App layout.\r\n   * Semi-stable id is generated when auto-generated `widgetDef` id is detected,\r\n   * but correctness of such id depends on `addWidgetDef` call order and widget location.\r\n   */\r\n  public addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean {\r\n    if (stageId === undefined && stageUsage === undefined) {\r\n      Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);\r\n      return false;\r\n    }\r\n\r\n    section = (section !== undefined) ? section : StagePanelSection.Start;\r\n    const index = this._widgets.reduce((acc, info) => {\r\n      if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)\r\n        return acc + 1;\r\n      return acc;\r\n    }, 0);\r\n    const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);\r\n    const stableWidget = createStableWidgetDef(widgetDef, stableId);\r\n    const newWidget: WidgetInfo = { widgetDef: stableWidget, stageId, stageUsage, location, section };\r\n\r\n    const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);\r\n    const updatedWidgets = [\r\n      ...oldWidgets,\r\n      newWidget,\r\n    ];\r\n    this.widgets = updatedWidgets;\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Removes a WidgetDef.\r\n   */\r\n  public removeWidgetDef(widgetId: string): boolean {\r\n    let result = false;\r\n    const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);\r\n\r\n    if (updatedWidgets.length !== this._widgets.length) {\r\n      this.widgets = updatedWidgets;\r\n      result = true;\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  // Used when WidgetDefs are requested from UiItemProviders when uiVersion=\"1\"\r\n  // istanbul ignore next\r\n  private getStagePanelLocationFromZoneLocation(location: ZoneLocation): StagePanelLocation | undefined {\r\n    switch (location) {\r\n      case ZoneLocation.BottomCenter:\r\n      case ZoneLocation.TopCenter:\r\n      case ZoneLocation.TopRight:\r\n      case ZoneLocation.TopLeft:\r\n        return undefined; // an existing stage does not support appending widgets to these zones\r\n      case ZoneLocation.BottomLeft:\r\n      case ZoneLocation.CenterLeft:\r\n        return StagePanelLocation.Left;\r\n      case ZoneLocation.BottomRight:\r\n      case ZoneLocation.CenterRight:\r\n        return StagePanelLocation.Right;\r\n    }\r\n  }\r\n\r\n  /** Gets WidgetDefs for a Frontstage location.\r\n   */\r\n  public getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection,\r\n    frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined {\r\n    const definedSection = section === undefined ? StagePanelSection.Start : section;\r\n\r\n    const widgetInfos = this._widgets.filter((info) => {\r\n      return (!info.stageId || info.stageId === stageId)\r\n        && (!info.stageUsage || info.stageUsage === stageUsage)\r\n        && info.location === location\r\n        && info.section === definedSection;\r\n    });\r\n\r\n    const widgetDefs = widgetInfos.map((info) => info.widgetDef);\r\n\r\n    // Consult the UiItemsManager to get any Abstract widgets\r\n    if (location in StagePanelLocation) {\r\n      const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location as StagePanelLocation, definedSection, undefined, frontstageApplicationData);\r\n      widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\r\n        const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\r\n        const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\r\n        const stableProps = getStableWidgetProps(props, stableId);\r\n        const wd = new WidgetDef(stableProps);\r\n        widgetDefs.push(wd);\r\n      });\r\n    } else {\r\n      // istanbul ignore else\r\n      if (location in ZoneLocation) {\r\n        const panelLocation = this.getStagePanelLocationFromZoneLocation(location as ZoneLocation);\r\n        // istanbul ignore else\r\n        if (panelLocation && location in AbstractZoneLocation) {\r\n          const widgets = UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location as unknown as AbstractZoneLocation, frontstageApplicationData);\r\n          widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\r\n            const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\r\n            const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\r\n            const stableProps = getStableWidgetProps(props, stableId);\r\n            const wd = new WidgetDef(stableProps);\r\n            widgetDefs.push(wd);\r\n          });\r\n        }\r\n      }\r\n    }\r\n\r\n    return widgetDefs.length > 0 ? widgetDefs : undefined;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"WidgetManager.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.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/* eslint-disable deprecation/deprecation */\n/** @packageDocumentation\n * @module Widget\n */\n\nimport { BeUiEvent, Logger } from \"@itwin/core-bentley\";\nimport { AbstractWidgetProps, AbstractZoneLocation, StagePanelLocation, StagePanelSection, UiItemsManager } from \"@itwin/appui-abstract\";\nimport { UiFramework } from \"../UiFramework\";\nimport { getStableWidgetProps, ZoneLocation } from \"../zones/Zone\";\nimport { WidgetDef } from \"./WidgetDef\";\nimport { createStableWidgetDef } from \"./StableWidgetDef\";\n\n/** Information about WidgetDefs in the WidgetManager\n * @internal\n */\nexport interface WidgetInfo {\n  widgetDef: WidgetDef;\n  stageId?: string;\n  stageUsage?: string;\n  location: ZoneLocation | StagePanelLocation;\n  section: StagePanelSection;\n}\n\n/** Arguments of [[this.onWidgetsChanged]] event.\n * @internal\n */\nexport interface WidgetsChangedEventArgs {\n  readonly items: ReadonlyArray<WidgetInfo>;\n}\n\n/** Event class for [[this.onWidgetsChanged]].\n * @internal\n */\nexport class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> { }\n\nfunction isZoneLocation(location: ZoneLocation | StagePanelLocation): location is ZoneLocation {\n  return location >= ZoneLocation.TopLeft && location <= ZoneLocation.BottomRight;\n}\n\nfunction getLocationName(location: ZoneLocation | StagePanelLocation) {\n  return isZoneLocation(location) ? ZoneLocation[location] : StagePanelLocation[location];\n}\n\nfunction getWidgetManagerStableWidgetId(stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section: StagePanelSection,\n  index: number) {\n  return `uifw-wm-${stageUsage || \"\"}-${getLocationName(location)}-${StagePanelSection[section]}-${index}`;\n}\n\nfunction getAddonStableWidgetId(stageUsage: string, location: StagePanelLocation, section: StagePanelSection, index: number) {\n  return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;\n}\n\n/** Widget Manager class.\n * @beta\n */\nexport class WidgetManager {\n  private _widgets: ReadonlyArray<WidgetInfo> = [];\n\n  /** Event raised when Widgets are changed.\n   * @internal\n   */\n  public readonly onWidgetsChanged = new WidgetsChangedEvent();\n\n  /** @internal */\n  public get widgetCount(): number {\n    return this._widgets.length;\n  }\n\n  /** @internal */\n  public get widgets(): ReadonlyArray<WidgetInfo> { return this._widgets; }\n  public set widgets(w: ReadonlyArray<WidgetInfo>) {\n    this._widgets = w;\n    this.onWidgetsChanged.emit({ items: w });\n  }\n\n  /** Adds a WidgetDef for use in a Frontstage.\n   * @note Added `widgetDef` must return unique id to correctly save/restore App layout.\n   * Semi-stable id is generated when auto-generated `widgetDef` id is detected,\n   * but correctness of such id depends on `addWidgetDef` call order and widget location.\n   */\n  public addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean {\n    if (stageId === undefined && stageUsage === undefined) {\n      Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);\n      return false;\n    }\n\n    section = (section !== undefined) ? section : StagePanelSection.Start;\n    const index = this._widgets.reduce((acc, info) => {\n      if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)\n        return acc + 1;\n      return acc;\n    }, 0);\n    const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);\n    const stableWidget = createStableWidgetDef(widgetDef, stableId);\n    const newWidget: WidgetInfo = { widgetDef: stableWidget, stageId, stageUsage, location, section };\n\n    const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);\n    const updatedWidgets = [\n      ...oldWidgets,\n      newWidget,\n    ];\n    this.widgets = updatedWidgets;\n\n    return true;\n  }\n\n  /** Removes a WidgetDef.\n   */\n  public removeWidgetDef(widgetId: string): boolean {\n    let result = false;\n    const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);\n\n    if (updatedWidgets.length !== this._widgets.length) {\n      this.widgets = updatedWidgets;\n      result = true;\n    }\n\n    return result;\n  }\n\n  // Used when WidgetDefs are requested from UiItemProviders when uiVersion=\"1\"\n  // istanbul ignore next\n  private getStagePanelLocationFromZoneLocation(location: ZoneLocation): StagePanelLocation | undefined {\n    switch (location) {\n      case ZoneLocation.BottomCenter:\n      case ZoneLocation.TopCenter:\n      case ZoneLocation.TopRight:\n      case ZoneLocation.TopLeft:\n        return undefined; // an existing stage does not support appending widgets to these zones\n      case ZoneLocation.BottomLeft:\n      case ZoneLocation.CenterLeft:\n        return StagePanelLocation.Left;\n      case ZoneLocation.BottomRight:\n      case ZoneLocation.CenterRight:\n        return StagePanelLocation.Right;\n    }\n  }\n\n  /** Gets WidgetDefs for a Frontstage location.\n   */\n  public getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection,\n    frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined {\n    const definedSection = section === undefined ? StagePanelSection.Start : section;\n\n    const widgetInfos = this._widgets.filter((info) => {\n      return (!info.stageId || info.stageId === stageId)\n        && (!info.stageUsage || info.stageUsage === stageUsage)\n        && info.location === location\n        && info.section === definedSection;\n    });\n\n    const widgetDefs = widgetInfos.map((info) => info.widgetDef);\n\n    // Consult the UiItemsManager to get any Abstract widgets\n    if (location in StagePanelLocation) {\n      const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location as StagePanelLocation, definedSection, undefined, frontstageApplicationData);\n      widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\n        const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\n        const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\n        const stableProps = getStableWidgetProps(props, stableId);\n        const wd = new WidgetDef(stableProps);\n        widgetDefs.push(wd);\n      });\n    } else {\n      // istanbul ignore else\n      if (location in ZoneLocation) {\n        const panelLocation = this.getStagePanelLocationFromZoneLocation(location as ZoneLocation);\n        // istanbul ignore else\n        if (panelLocation && location in AbstractZoneLocation) {\n          const widgets = UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location as unknown as AbstractZoneLocation, frontstageApplicationData);\n          widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\n            const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\n            const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\n            const stableProps = getStableWidgetProps(props, stableId);\n            const wd = new WidgetDef(stableProps);\n            widgetDefs.push(wd);\n          });\n        }\n      }\n    }\n\n    return widgetDefs.length > 0 ? widgetDefs : undefined;\n  }\n}\n"]}

package/lib/esm/appui-react/widgets/WidgetProps.d.ts

@@ -1,33 +1,33 @@
-/** @packageDocumentation
- * @module Widget
- */
-import * as React from "react";
-import { AbstractWidgetProps } from "@itwin/appui-abstract";
-import { IconProps } from "@itwin/core-react";
-import { ConfigurableUiControlConstructor } from "../configurableui/ConfigurableUiControl";
-/** Properties for a [[Widget]] component.
- * @deprecated in 3.5. Props of a deprecated component.
- * @public
- */
-export interface WidgetProps extends Omit<AbstractWidgetProps, "getWidgetContent">, IconProps {
-    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */
-    labelKey?: string;
-    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if tooltip is not explicitly set. */
-    tooltipKey?: string;
-    /** A [[WidgetControl]] providing information about the Widget. */
-    control?: ConfigurableUiControlConstructor;
-    /** A React component for the Widget. */
-    element?: React.ReactNode;
-    /** Control's class id */
-    classId?: string | ConfigurableUiControlConstructor;
-    /** @alpha */
-    preferredPanelSize?: "fit-content";
-}
-/** Properties of a Widget.
- * @beta
- */
-export interface CommonWidgetProps extends Readonly<AbstractWidgetProps> {
-    /** Id used to uniquely identify the widget. */
-    readonly id: string;
-}
+/** @packageDocumentation
+ * @module Widget
+ */
+import * as React from "react";
+import { AbstractWidgetProps } from "@itwin/appui-abstract";
+import { IconProps } from "@itwin/core-react";
+import { ConfigurableUiControlConstructor } from "../configurableui/ConfigurableUiControl";
+/** Properties for a [[Widget]] component.
+ * @deprecated in 3.5. Props of a deprecated component.
+ * @public
+ */
+export interface WidgetProps extends Omit<AbstractWidgetProps, "getWidgetContent">, IconProps {
+    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */
+    labelKey?: string;
+    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if tooltip is not explicitly set. */
+    tooltipKey?: string;
+    /** A [[WidgetControl]] providing information about the Widget. */
+    control?: ConfigurableUiControlConstructor;
+    /** A React component for the Widget. */
+    element?: React.ReactNode;
+    /** Control's class id */
+    classId?: string | ConfigurableUiControlConstructor;
+    /** @alpha */
+    preferredPanelSize?: "fit-content";
+}
+/** Properties of a Widget.
+ * @beta
+ */
+export interface CommonWidgetProps extends Readonly<AbstractWidgetProps> {
+    /** Id used to uniquely identify the widget. */
+    readonly id: string;
+}
 //# sourceMappingURL=WidgetProps.d.ts.map