@itwin/core-react 4.1.0 → 4.2.0-dev.1

package/ContributeGuidelines.md

@@ -1,99 +1,99 @@
-# Guidelines for Contributing to iTwin.js UI Source Code
-
-Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
-
-## Description
-
-In order to maintain consistency in the iTwin.js UI source code, please abide by the following guidelines for classes and React components.
-
-## Guidelines
-
-* Include a copyright notice at the top of __all__ TypeScript and CSS/Sass files. The copyright notice comment should be similar to the following:
-
-```typescript
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-```
-
-* Document __all__ exported classes, interfaces, enums, types, etc.
-* Add release tags (`@public`, `@beta`, `@alpha` or `@internal`) to all exported classes, interfaces, enums, types, etc. For more information on release tags, see [Release Tags](https://www.itwinjs.org/learning/guidelines/release-tags-guidelines/).
-* In addition, it’s preferable that all *Props interface members and component public methods be documented. You can put `@internal` on React lifecycle and render methods.
-* Add a,
-
-  ```ts
-  /** @packageDocumentation
-  * @module xyz
-  */
-  ```
-
-  comment to the top of the TypeScript file for the documentation module. An existing documentation module will often be appropriate to use. However, if you need to add a documentation module, see additional guidelines below. Example of `@module` comment:
-
-  ```ts
-  /** @packageDocumentation
-   * @module Button
-  */
-  ```
-
-* Use the theme colors (e.g. $buic-text-color, $buic-background-control, $buic-background-widget, etc.). These are located in `appui/ui/core-react/src/core-react/style/themecolors.scss`. Please do __not__ use $uicore-text-color, $uicore-black, $uicore-white,  $uicore-gray*, etc.)
-* Include an appropriate prefix on CSS class names to prevent class name clashes (e.g. `uifw-` in appui-react, `core-` in core-react, `components-` in components-react, `nz-` in appui-layout-react)
-* Add an export for the component to the barrel file of the package (e.g. appui-react.ts, components-react.ts, core-react.ts, appui-layout-react.ts). Example:
-
-```typescript
-export * from "./core-react/badge/Badge";
-```
-
-* Localize all strings to be seen by the user and use `Ui*.translate` to get the localized string. Please do __not__ use hard-coded strings. The translatable strings should be in a JSON file in the `public/locales/en` of the repository. Example:
-
-```json
-{
-  . . .
-  "dialog": {
-    "ok": "OK",
-    . . .
-  }
-}
-```
-
-```typescript
-buttonText = UiCore.translate("dialog.ok");
-```
-
-* Run `npm run extract-api` to update the `*api.md` file for the package
-* Write unit tests for the new component or class. The tests should cover as many code statements, branches, functions and lines as possible (100% is the goal). To run the tests, run `npm run test` or `rush test`. To run coverage, run `npm run cover`. To see the coverage report, open the report from one of the following directories in your browser:
-  * appui/ui/appui-layout-react/lib/test/coverage/lcov-report/index.html
-  * appui/ui/appui-react/lib/test/coverage/lcov-report/index.html
-  * appui/ui/components-react/lib/test/coverage/lcov-report/index.html
-  * appui/ui/core-react/lib/test/coverage/lcov-report/index.html
-  * appui/ui/imodel-components-react/lib/test/coverage/lcov-report/index.html
-
-## New Documentation Module
-
-If the component’s documentation @module is new, please follow these guidelines:
-
-* Add a `@docs-group-description` comment to the barrel file of the package. Example:
-
-```js
-/**
- * @docs-group-description Button
- * Classes for working with various Buttons.
- */
-```
-
-Note: The following steps are in [itwinjs-core](https://github.com/itwin/itwinjs-core) repository, NOT in the appui repository:
-
-* Add the module to the itwinjs-core/docs/ui/reference/leftNav.md file in alphabetical order. Example:
-
-```md
-- [Button]($core:Button)
-```
-
-* Add the module to the appropriate `index.md` in the Learning section (e.g. itwinjs-core/docs/ui/learning/components/index.md or itwinjs-core/docs/ui/learning/core/index.md). Example:
-
-```md
-* [Button](./Button.md)
-```
-
-* Add a markdown file in the same folder as the `index.md` above (e.g. itwinjs-core/docs/ui/learning/components/Timeline.md)
-* Add learning content and an example usage to the new markdown file
+# Guidelines for Contributing to iTwin.js UI Source Code
+
+Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
+
+## Description
+
+In order to maintain consistency in the iTwin.js UI source code, please abide by the following guidelines for classes and React components.
+
+## Guidelines
+
+- Include a copyright notice at the top of **all** TypeScript and CSS/Sass files. The copyright notice comment should be similar to the following:
+
+```typescript
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+```
+
+- Document **all** exported classes, interfaces, enums, types, etc.
+- Add release tags (`@public`, `@beta`, `@alpha` or `@internal`) to all exported classes, interfaces, enums, types, etc. For more information on release tags, see [Release Tags](https://www.itwinjs.org/learning/guidelines/release-tags-guidelines/).
+- In addition, it’s preferable that all \*Props interface members and component public methods be documented. You can put `@internal` on React lifecycle and render methods.
+- Add a,
+
+  ```ts
+  /** @packageDocumentation
+   * @module xyz
+   */
+  ```
+
+  comment to the top of the TypeScript file for the documentation module. An existing documentation module will often be appropriate to use. However, if you need to add a documentation module, see additional guidelines below. Example of `@module` comment:
+
+  ```ts
+  /** @packageDocumentation
+   * @module Button
+   */
+  ```
+
+- Use the theme colors (e.g. $buic-text-color, $buic-background-control, $buic-background-widget, etc.). These are located in `appui/ui/core-react/src/core-react/style/themecolors.scss`. Please do **not** use $uicore-text-color, $uicore-black, $uicore-white, $uicore-gray\*, etc.)
+- Include an appropriate prefix on CSS class names to prevent class name clashes (e.g. `uifw-` in appui-react, `core-` in core-react, `components-` in components-react, `nz-` in appui-layout-react)
+- Add an export for the component to the barrel file of the package (e.g. appui-react.ts, components-react.ts, core-react.ts, appui-layout-react.ts). Example:
+
+```typescript
+export * from "./core-react/badge/Badge";
+```
+
+- Localize all strings to be seen by the user and use `Ui*.translate` to get the localized string. Please do **not** use hard-coded strings. The translatable strings should be in a JSON file in the `public/locales/en` of the repository. Example:
+
+```json
+{
+  . . .
+  "dialog": {
+    "ok": "OK",
+    . . .
+  }
+}
+```
+
+```typescript
+buttonText = UiCore.translate("dialog.ok");
+```
+
+- Run `npm run extract-api` to update the `*api.md` file for the package
+- Write unit tests for the new component or class. The tests should cover as many code statements, branches, functions and lines as possible (100% is the goal). To run the tests, run `npm run test` or `rush test`. To run coverage, run `npm run cover`. To see the coverage report, open the report from one of the following directories in your browser:
+  - appui/ui/appui-layout-react/lib/test/coverage/lcov-report/index.html
+  - appui/ui/appui-react/lib/test/coverage/lcov-report/index.html
+  - appui/ui/components-react/lib/test/coverage/lcov-report/index.html
+  - appui/ui/core-react/lib/test/coverage/lcov-report/index.html
+  - appui/ui/imodel-components-react/lib/test/coverage/lcov-report/index.html
+
+## New Documentation Module
+
+If the component’s documentation @module is new, please follow these guidelines:
+
+- Add a `@docs-group-description` comment to the barrel file of the package. Example:
+
+```js
+/**
+ * @docs-group-description Button
+ * Classes for working with various Buttons.
+ */
+```
+
+Note: The following steps are in [itwinjs-core](https://github.com/itwin/itwinjs-core) repository, NOT in the appui repository:
+
+- Add the module to the itwinjs-core/docs/ui/reference/leftNav.md file in alphabetical order. Example:
+
+```md
+- [Button]($core:Button)
+```
+
+- Add the module to the appropriate `index.md` in the Learning section (e.g. itwinjs-core/docs/ui/learning/components/index.md or itwinjs-core/docs/ui/learning/core/index.md). Example:
+
+```md
+- [Button](./Button.md)
+```
+
+- Add a markdown file in the same folder as the `index.md` above (e.g. itwinjs-core/docs/ui/learning/components/Timeline.md)
+- Add learning content and an example usage to the new markdown file

package/LICENSE.md

@@ -1,9 +1,9 @@
-# MIT License
-
-Copyright © 2017-2023 Bentley Systems, Incorporated. All rights reserved.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# MIT License
+
+Copyright © 2017-2023 Bentley Systems, Incorporated. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,11 +1,11 @@
-# @itwin/core-react
-
-Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
-
-## Description
-
-The __@itwin/core-react__ package contains general purpose React components, such as Dialog, MessageBox, SearchBox, RadialMenu.
-
-## Documentation
-
-See the [iTwin.js](https://www.itwinjs.org/learning/ui/core/) documentation for more information.
+# @itwin/core-react
+
+Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
+
+## Description
+
+The **@itwin/core-react** package contains general purpose React components, such as Dialog, MessageBox, SearchBox, RadialMenu.
+
+## Documentation
+
+See the [iTwin.js](https://www.itwinjs.org/learning/ui/core/) documentation for more information.

package/lib/cjs/core-react/UiCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UiCore.d.ts","sourceRoot":"","sources":["../../../src/core-react/UiCore.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,4EAA4E;AAC5E,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAe;IAE5C;;;OAGG;WACiB,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAczE,oDAAoD;WACtC,SAAS;IAQvB,gDAAgD;IAChD,WAAkB,WAAW,IAAI,OAAO,CAAgC;IAExE;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAM7C;IAED,kDAAkD;IAClD,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;IAED;;OAEG;WACW,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM;IAQvD,gBAAgB;IAChB,WAAkB,WAAW,IAAI,MAAM,CAEtC;IAED,gBAAgB;WACF,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;CAM/C"}
+{"version":3,"file":"UiCore.d.ts","sourceRoot":"","sources":["../../../src/core-react/UiCore.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,4EAA4E;AAC5E,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAe;IAE5C;;;OAGG;WACiB,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzE,oDAAoD;WACtC,SAAS;IAQvB,gDAAgD;IAChD,WAAkB,WAAW,IAAI,OAAO,CAEvC;IAED;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAS7C;IAED,kDAAkD;IAClD,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;IAED;;OAEG;WACW,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM;IAavD,gBAAgB;IAChB,WAAkB,WAAW,IAAI,MAAM,CAEtC;IAED,gBAAgB;WACF,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;CAK/C"}

package/lib/cjs/core-react/UiCore.js

@@ -1,8 +1,8 @@
 "use strict";
 /*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
 /** @packageDocumentation
  * @module Utilities
  */
@@ -45,7 +45,9 @@ class UiCore {
         UiCore._initialized = false;
     }
     /** Determines if UiCore has been initialized */
-    static get initialized() { return UiCore._initialized; }
+    static get initialized() {
+        return UiCore._initialized;
+    }
     /** The internationalization service created by the host application.
      * @internal
      */
@@ -68,7 +70,9 @@ class UiCore {
             core_bentley_1.Logger.logError(UiCore.loggerCategory(this), `translate: UiCore must be initialize with a localization provider. Returning blank string.`);
             return "";
         }
-        return UiCore._localization.getLocalizedString(key, { ns: UiCore.localizationNamespace });
+        return UiCore._localization.getLocalizedString(key, {
+            ns: UiCore.localizationNamespace,
+        });
     }
     /** @internal */
     static get packageName() {

package/lib/cjs/core-react/UiCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"UiCore.js","sourceRoot":"","sources":["../../../src/core-react/UiCore.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,4EAA4E;AAC5E,8BAA4B;AAC5B,iCAA+B;AAC/B,mCAAiC;AACjC,0BAAwB;AAExB,sDAA6C;AAE7C,0DAA8D;AAC9D,+DAA4D;AAC5D,2CAA2C;AAE3C;;;GAGG;AACH,MAAa,MAAM;IAIjB;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,YAA0B;QACvD,IAAI,MAAM,CAAC,YAAY,EAAE;YACvB,qBAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,kCAAkC,CAAC,CAAC;YAClF,OAAO;SACR;QAED,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;QACpC,MAAM,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS;YACvD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,mCAAgB,CAAC,CAAC;QAE/D,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,oDAAoD;IAC7C,MAAM,CAAC,SAAS;QACrB,IAAI,MAAM,CAAC,aAAa;YACtB,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzE,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC;QAEjC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,gDAAgD;IACzC,MAAM,KAAK,WAAW,KAAc,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAExE;;OAEG;IACI,MAAM,KAAK,YAAY;QAC5B,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,aAAa;YACvB,MAAM,IAAI,wBAAO,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,4FAA4F,CAAC,CAAC;QAC/I,uBAAuB;QACvB,OAAO,MAAM,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,kDAAkD;IAC3C,MAAM,KAAK,qBAAqB;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAS,CAAC,GAAsB;QAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;YACzB,qBAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,4FAA4F,CAAC,CAAC;YAC3I,OAAO,EAAE,CAAC;SACX;QACD,OAAO,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,gBAAgB;IACT,MAAM,KAAK,WAAW;QAC3B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,cAAc,CAAC,GAAQ;QACnC,MAAM,SAAS,GAAG,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;;AAtEc,mBAAY,GAAG,KAAK,CAAC;AADzB,wBAAM","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 Utilities\r\n */\r\n\r\n/** Import color variables, layout variables and Sass classes barrel file */\r\nimport \"./colorthemes.scss\";\r\nimport \"./colorvariables.scss\";\r\nimport \"./layout-variables.scss\";\r\nimport \"./classes.scss\";\r\n\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport type { Localization } from \"@itwin/core-common\";\r\nimport { getClassName, UiError } from \"@itwin/appui-abstract\";\r\nimport { IconWebComponent } from \"./utils/IconWebComponent\";\r\n// cSpell:ignore colorthemes colorvariables\r\n\r\n/**\r\n * Manages the Localization service for the core-react package.\r\n * @public\r\n */\r\nexport class UiCore {\r\n  private static _initialized = false;\r\n  private static _localization?: Localization;\r\n\r\n  /**\r\n   * Registers the Localization service namespace for UiCore.\r\n   * @param localization The internationalization service created by the host application.\r\n   */\r\n  public static async initialize(localization: Localization): Promise<void> {\r\n    if (UiCore._initialized) {\r\n      Logger.logInfo(UiCore.loggerCategory(UiCore), `UiCore.initialize already called`);\r\n      return;\r\n    }\r\n\r\n    UiCore._localization = localization;\r\n    await UiCore._localization.registerNamespace(UiCore.localizationNamespace);\r\n    if (window.customElements.get(\"svg-loader\") === undefined)\r\n      window.customElements.define(\"svg-loader\", IconWebComponent);\r\n\r\n    UiCore._initialized = true;\r\n  }\r\n\r\n  /** Unregisters the UiCore localization namespace */\r\n  public static terminate() {\r\n    if (UiCore._localization)\r\n      UiCore._localization.unregisterNamespace(UiCore.localizationNamespace);\r\n    UiCore._localization = undefined;\r\n\r\n    UiCore._initialized = false;\r\n  }\r\n\r\n  /** Determines if UiCore has been initialized */\r\n  public static get initialized(): boolean { return UiCore._initialized; }\r\n\r\n  /** The internationalization service created by the host application.\r\n   * @internal\r\n   */\r\n  public static get localization(): Localization {\r\n    // istanbul ignore else\r\n    if (!UiCore._localization)\r\n      throw new UiError(UiCore.loggerCategory(this), \"localization: UiCore.initialize has not been called. Unable to return Localization object.\");\r\n    // istanbul ignore next\r\n    return UiCore._localization;\r\n  }\r\n\r\n  /** The internationalization service namespace. */\r\n  public static get localizationNamespace(): string {\r\n    return \"UiCore\";\r\n  }\r\n\r\n  /** Calls localization.getLocalizedStringWithNamespace with the \"UiCore\" namespace. Do NOT include the namespace in the key.\r\n   * @internal\r\n   */\r\n  public static translate(key: string | string[]): string {\r\n    if (!UiCore._localization) {\r\n      Logger.logError(UiCore.loggerCategory(this), `translate: UiCore must be initialize with a localization provider. Returning blank string.`);\r\n      return \"\";\r\n    }\r\n    return UiCore._localization.getLocalizedString(key, { ns: UiCore.localizationNamespace });\r\n  }\r\n\r\n  /** @internal */\r\n  public static get packageName(): string {\r\n    return \"core-react\";\r\n  }\r\n\r\n  /** @internal */\r\n  public static loggerCategory(obj: any): string {\r\n    const className = getClassName(obj);\r\n    const category = UiCore.packageName + (className ? `.${className}` : \"\");\r\n    return category;\r\n  }\r\n\r\n}\r\n"]}
+{"version":3,"file":"UiCore.js","sourceRoot":"","sources":["../../../src/core-react/UiCore.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH,4EAA4E;AAC5E,8BAA4B;AAC5B,iCAA+B;AAC/B,mCAAiC;AACjC,0BAAwB;AAExB,sDAA6C;AAE7C,0DAA8D;AAC9D,+DAA4D;AAC5D,2CAA2C;AAE3C;;;GAGG;AACH,MAAa,MAAM;IAIjB;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,YAA0B;QACvD,IAAI,MAAM,CAAC,YAAY,EAAE;YACvB,qBAAM,CAAC,OAAO,CACZ,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAC7B,kCAAkC,CACnC,CAAC;YACF,OAAO;SACR;QAED,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;QACpC,MAAM,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS;YACvD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,mCAAgB,CAAC,CAAC;QAE/D,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,oDAAoD;IAC7C,MAAM,CAAC,SAAS;QACrB,IAAI,MAAM,CAAC,aAAa;YACtB,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzE,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC;QAEjC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,gDAAgD;IACzC,MAAM,KAAK,WAAW;QAC3B,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,MAAM,KAAK,YAAY;QAC5B,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,aAAa;YACvB,MAAM,IAAI,wBAAO,CACf,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC3B,4FAA4F,CAC7F,CAAC;QACJ,uBAAuB;QACvB,OAAO,MAAM,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,kDAAkD;IAC3C,MAAM,KAAK,qBAAqB;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAS,CAAC,GAAsB;QAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;YACzB,qBAAM,CAAC,QAAQ,CACb,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC3B,4FAA4F,CAC7F,CAAC;YACF,OAAO,EAAE,CAAC;SACX;QACD,OAAO,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,EAAE;YAClD,EAAE,EAAE,MAAM,CAAC,qBAAqB;SACjC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IACT,MAAM,KAAK,WAAW;QAC3B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,cAAc,CAAC,GAAQ;QACnC,MAAM,SAAS,GAAG,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;;AAnFc,mBAAY,GAAG,KAAK,CAAC;AADzB,wBAAM","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utilities\n */\n\n/** Import color variables, layout variables and Sass classes barrel file */\nimport \"./colorthemes.scss\";\nimport \"./colorvariables.scss\";\nimport \"./layout-variables.scss\";\nimport \"./classes.scss\";\n\nimport { Logger } from \"@itwin/core-bentley\";\nimport type { Localization } from \"@itwin/core-common\";\nimport { getClassName, UiError } from \"@itwin/appui-abstract\";\nimport { IconWebComponent } from \"./utils/IconWebComponent\";\n// cSpell:ignore colorthemes colorvariables\n\n/**\n * Manages the Localization service for the core-react package.\n * @public\n */\nexport class UiCore {\n  private static _initialized = false;\n  private static _localization?: Localization;\n\n  /**\n   * Registers the Localization service namespace for UiCore.\n   * @param localization The internationalization service created by the host application.\n   */\n  public static async initialize(localization: Localization): Promise<void> {\n    if (UiCore._initialized) {\n      Logger.logInfo(\n        UiCore.loggerCategory(UiCore),\n        `UiCore.initialize already called`\n      );\n      return;\n    }\n\n    UiCore._localization = localization;\n    await UiCore._localization.registerNamespace(UiCore.localizationNamespace);\n    if (window.customElements.get(\"svg-loader\") === undefined)\n      window.customElements.define(\"svg-loader\", IconWebComponent);\n\n    UiCore._initialized = true;\n  }\n\n  /** Unregisters the UiCore localization namespace */\n  public static terminate() {\n    if (UiCore._localization)\n      UiCore._localization.unregisterNamespace(UiCore.localizationNamespace);\n    UiCore._localization = undefined;\n\n    UiCore._initialized = false;\n  }\n\n  /** Determines if UiCore has been initialized */\n  public static get initialized(): boolean {\n    return UiCore._initialized;\n  }\n\n  /** The internationalization service created by the host application.\n   * @internal\n   */\n  public static get localization(): Localization {\n    // istanbul ignore else\n    if (!UiCore._localization)\n      throw new UiError(\n        UiCore.loggerCategory(this),\n        \"localization: UiCore.initialize has not been called. Unable to return Localization object.\"\n      );\n    // istanbul ignore next\n    return UiCore._localization;\n  }\n\n  /** The internationalization service namespace. */\n  public static get localizationNamespace(): string {\n    return \"UiCore\";\n  }\n\n  /** Calls localization.getLocalizedStringWithNamespace with the \"UiCore\" namespace. Do NOT include the namespace in the key.\n   * @internal\n   */\n  public static translate(key: string | string[]): string {\n    if (!UiCore._localization) {\n      Logger.logError(\n        UiCore.loggerCategory(this),\n        `translate: UiCore must be initialize with a localization provider. Returning blank string.`\n      );\n      return \"\";\n    }\n    return UiCore._localization.getLocalizedString(key, {\n      ns: UiCore.localizationNamespace,\n    });\n  }\n\n  /** @internal */\n  public static get packageName(): string {\n    return \"core-react\";\n  }\n\n  /** @internal */\n  public static loggerCategory(obj: any): string {\n    const className = getClassName(obj);\n    const category = UiCore.packageName + (className ? `.${className}` : \"\");\n    return category;\n  }\n}\n"]}

package/lib/cjs/core-react/_geometry.scss

@@ -1,70 +1,70 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-@mixin triangle-common {
-  width: 0;
-  height: 0;
-  border-style: solid;
-}
-
-@mixin triangle-left-color($color) {
-  border-color: transparent $color transparent transparent;
-}
-
-@mixin triangle-left($height, $width: $height, $color: currentColor) {
-  border-width: ($height * 0.5) $width ($height * 0.5) 0;
-
-  @include triangle-common;
-  @include triangle-left-color($color);
-}
-
-@mixin triangle-top-color($color) {
-  border-color: transparent transparent $color transparent;
-}
-
-@mixin triangle-top($height, $width: $height, $color: currentColor) {
-  border-width: 0 ($width * 0.5) $height ($width * 0.5);
-
-  @include triangle-common;
-  @include triangle-top-color($color);
-}
-
-@mixin triangle-right-color($color) {
-  border-color: transparent transparent transparent $color;
-}
-
-@mixin triangle-right($height, $width: $height, $color: currentColor) {
-  border-width: ($height * 0.5) 0 ($height * 0.5) $width;
-
-  @include triangle-common;
-  @include triangle-right-color($color);
-}
-
-@mixin triangle-bottom-color($color) {
-  border-color: $color transparent transparent transparent;
-}
-
-@mixin triangle-bottom($height, $width: $height, $color: currentColor) {
-  border-width: $height ($width * 0.5) 0 ($width * 0.5);
-
-  @include triangle-common;
-  @include triangle-bottom-color($color);
-}
-
-@mixin triangle-bottom-right-color($color) {
-  border-color: transparent transparent $color transparent;
-}
-
-@mixin triangle-bottom-right($height, $width: $height, $color: currentColor) {
-  border-width: 0 0 $height $width;
-
-  @include triangle-common;
-  @include triangle-bottom-right-color($color);
-}
-
-@mixin oval($width, $height: $width) {
-  width: $width;
-  height: $height;
-  border-radius: #{$width * 0.5} / #{$height * 0.5};
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+@mixin triangle-common {
+  width: 0;
+  height: 0;
+  border-style: solid;
+}
+
+@mixin triangle-left-color($color) {
+  border-color: transparent $color transparent transparent;
+}
+
+@mixin triangle-left($height, $width: $height, $color: currentColor) {
+  border-width: ($height * 0.5) $width ($height * 0.5) 0;
+
+  @include triangle-common;
+  @include triangle-left-color($color);
+}
+
+@mixin triangle-top-color($color) {
+  border-color: transparent transparent $color transparent;
+}
+
+@mixin triangle-top($height, $width: $height, $color: currentColor) {
+  border-width: 0 ($width * 0.5) $height ($width * 0.5);
+
+  @include triangle-common;
+  @include triangle-top-color($color);
+}
+
+@mixin triangle-right-color($color) {
+  border-color: transparent transparent transparent $color;
+}
+
+@mixin triangle-right($height, $width: $height, $color: currentColor) {
+  border-width: ($height * 0.5) 0 ($height * 0.5) $width;
+
+  @include triangle-common;
+  @include triangle-right-color($color);
+}
+
+@mixin triangle-bottom-color($color) {
+  border-color: $color transparent transparent transparent;
+}
+
+@mixin triangle-bottom($height, $width: $height, $color: currentColor) {
+  border-width: $height ($width * 0.5) 0 ($width * 0.5);
+
+  @include triangle-common;
+  @include triangle-bottom-color($color);
+}
+
+@mixin triangle-bottom-right-color($color) {
+  border-color: transparent transparent $color transparent;
+}
+
+@mixin triangle-bottom-right($height, $width: $height, $color: currentColor) {
+  border-width: 0 0 $height $width;
+
+  @include triangle-common;
+  @include triangle-bottom-right-color($color);
+}
+
+@mixin oval($width, $height: $width) {
+  width: $width;
+  height: $height;
+  border-radius: #{$width * 0.5} / #{$height * 0.5};
+}

package/lib/cjs/core-react/_helpers.scss

@@ -1,51 +1,52 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-
-// Generates map from array.
-// Key of each entry is ($array entry value: result of $fn call).
-// $fn is called with specified $args.
-// Usage example:
-/*
-  $counter: 0;
-  @function step($step) {
-    $counter: $counter + $step !global;
-    @return $counter;
-  }
-  uicore-map-from-array($array, step, 1000);
-*/
-@function uicore-map-from-array($array, $fn, $args...) {
-  $map: ();
-  @each $item in $array {
-    $kvp: (
-      $item: call($fn, $args...)
-    );
-    $map: map-merge($map, $kvp)
-  }
-  @return $map;
-}
-
-// Generates map from array.
-// Key of each entry is ($array entry value: result of $fn call).
-// $fn is called with one argument:
-// 1. First entry with $initialArg
-// 2. Other entries with previous result of $fn call.
-// Usage example:
-/*
-  @function step($counter) {
-    @return $counter + 1000;
-  }
-  uicore-map-from-array-with-result-arg($array, step, 0);
-*/
-@function uicore-map-from-array-with-result-arg($array, $fn, $initialArg) {
-  $map: ();
-  $result: $initialArg;
-  @each $item in $array {
-    $result: call($fn, $result);
-    $kvp: ($item: $result);
-    $map: map-merge($map, $kvp)
-  }
-  @return $map;
-}
-
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+
+// Generates map from array.
+// Key of each entry is ($array entry value: result of $fn call).
+// $fn is called with specified $args.
+// Usage example:
+/*
+  $counter: 0;
+  @function step($step) {
+    $counter: $counter + $step !global;
+    @return $counter;
+  }
+  uicore-map-from-array($array, step, 1000);
+*/
+@function uicore-map-from-array($array, $fn, $args...) {
+  $map: ();
+  @each $item in $array {
+    $kvp: (
+      $item: call($fn, $args...),
+    );
+    $map: map-merge($map, $kvp);
+  }
+  @return $map;
+}
+
+// Generates map from array.
+// Key of each entry is ($array entry value: result of $fn call).
+// $fn is called with one argument:
+// 1. First entry with $initialArg
+// 2. Other entries with previous result of $fn call.
+// Usage example:
+/*
+  @function step($counter) {
+    @return $counter + 1000;
+  }
+  uicore-map-from-array-with-result-arg($array, step, 0);
+*/
+@function uicore-map-from-array-with-result-arg($array, $fn, $initialArg) {
+  $map: ();
+  $result: $initialArg;
+  @each $item in $array {
+    $result: call($fn, $result);
+    $kvp: (
+      $item: $result,
+    );
+    $map: map-merge($map, $kvp);
+  }
+  @return $map;
+}

package/lib/cjs/core-react/_math.scss

@@ -1,13 +1,13 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-@function sqrt($x, $iterations: 10) {
-  $sqr: 1;
-
-  @for $i from 1 through $iterations {
-    $sqr: ($sqr - ($sqr * $sqr - $x) / (2 * $sqr));
-  }
-
-  @return $sqr;
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+@function sqrt($x, $iterations: 10) {
+  $sqr: 1;
+
+  @for $i from 1 through $iterations {
+    $sqr: ($sqr - ($sqr * $sqr - $x) / (2 * $sqr));
+  }
+
+  @return $sqr;
+}