@itwin/components-react 4.17.6 → 5.0.0-dev.3

package/lib/components-react/common/Links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Links.js","sourceRoot":"","sources":["../../../src/components-react/common/Links.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Common\n */\n\n// cSpell:ignore linkify\n\nimport LinkifyIt from \"linkify-it\";\n\nconst linkify = new LinkifyIt({ fuzzyLink: false });\n\nlinkify\n  .add(\"pw:\", {\n    validate: (\n      text: string,\n      pos: number,\n      self: LinkifyIt.LinkifyIt\n    ): number => {\n      const tail = text.slice(pos);\n\n      if (!self.re.pw) {\n        self.re.pw = new RegExp(\n          `(//|\\\\\\\\\\\\\\\\)${self.re.src_host}:` +\n            // Regex for path according to RFC 3986 standards plus the possibility to write '{}' brackets for ProjectWise monikers\n            `([a-zA-Z0-9-._~!$&'()*+,;=@%{}]+/)+[a-zA-Z0-9-._~!$&'()*+,;=@%{}]*`,\n          \"i\"\n        );\n      }\n      if (self.re.pw.test(tail)) {\n        const matches = tail.match(self.re.pw);\n        if (matches !== null) return matches[0].length;\n      }\n      return 0;\n    },\n  })\n  /* Adding a custom schema for links that start with `www.`.\n     With fuzzyLink option set to true it matches text without `www.` as a prefix, which is not wanted in our case. */\n  .add(\"www.\", {\n    validate: (\n      text: string,\n      pos: number,\n      self: LinkifyIt.LinkifyIt\n    ): number => {\n      const tail = text.slice(pos);\n\n      if (!self.re.www) {\n        self.re.www = new RegExp(\n          `^${self.re.src_auth}${self.re.src_host_port_strict}${self.re.src_path}`,\n          \"i\"\n        );\n      }\n      if (self.re.www.test(tail)) {\n        const matches = tail.match(self.re.www);\n        if (matches !== null) return matches[0].length;\n      }\n      return 0;\n    },\n    normalize: (match: LinkifyIt.Match) => {\n      match.schema = \"http:\";\n      match.url = `http://${match.url}`;\n    },\n  });\n\n/** Returns a list of links from a text\n * @public\n */\nexport const matchLinks = (\n  text: string\n): Array<{ index: number; lastIndex: number; schema: string; url: string }> => {\n  const head = text.slice(0, 5);\n  if (head === \"pw://\" || head === \"pw:\\\\\\\\\")\n    return Array({\n      index: 0,\n      lastIndex: text.length,\n      schema: \"pw:\",\n      url: text,\n    });\n\n  const matches = linkify.match(text);\n  return matches\n    ? (matches as Array<{\n        index: number;\n        lastIndex: number;\n        schema: string;\n        url: string;\n      }>)\n    : [];\n};\n\n/**\n * @internal\n */\nexport const openLink = (url: string) => {\n  if (url.startsWith(\"mailto:\")) {\n    location.href = url;\n    return;\n  }\n\n  const openAndFocus = (link: string) => {\n    const windowOpen = window.open(link, \"_blank\");\n    windowOpen?.focus();\n  };\n\n  if (url.startsWith(\"pw:\")) {\n    // remove // or \\\\ from the link. Links with custom schema should use opaque path like `schema:path` instead of `schema://path`\n    const validUrl = url.replace(/pw:\\/\\/|pw:\\\\\\\\/g, \"pw:\");\n    openAndFocus(validUrl);\n    return;\n  }\n\n  openAndFocus(url);\n};\n"]}

package/lib/components-react/common/Orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Orientation.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/Orientation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AACvC;;GAEG;AAEH,eAAO,MAAM,WAAW,qBAAe,CAAC"}

package/lib/components-react/common/Orientation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Orientation.js","sourceRoot":"","sources":["../../../src/components-react/common/Orientation.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQhE;;GAEG;AACH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC","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 Common\n */\n\nimport { Orientation as _Orientation } from \"@itwin/core-react\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** Enumeration of orientation.\n * @public\n */\nexport type Orientation = _Orientation;\n/** Enumeration of orientation.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport const Orientation = _Orientation;\n"]}

package/lib/components-react/common/PageOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageOptions.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/PageOptions.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/components-react/common/PageOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageOptions.js","sourceRoot":"","sources":["../../../src/components-react/common/PageOptions.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG","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 Common\n */\n\n/** Paging options.\n * @public\n */\nexport interface PageOptions {\n  size?: number;\n  start?: number;\n}\n"]}

package/lib/components-react/common/SubscriptionScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionScheduler.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/SubscriptionScheduler.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,MAAM,CAAC;AAmBpD;;;;;;;;GAQG;AACH,qBAAa,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAiC;;IA6BnD;;;;;;;;OAQG;IACI,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;CAelE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAClC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAE1C"}

package/lib/components-react/common/SubscriptionScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionScheduler.js","sourceRoot":"","sources":["../../../src/components-react/common/SubscriptionScheduler.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAGH,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,EACL,KAAK,EACL,QAAQ,EACR,GAAG,EACH,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,cAAc,EACd,OAAO,EACP,WAAW,EACX,GAAG,GACJ,MAAM,MAAM,CAAC;AAEd,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAqB;IAGhC;QAFQ,eAAU,GAAG,IAAI,OAAO,EAAkB,CAAC;QAGjD,IAAI,CAAC,UAAU;aACZ,IAAI,CACH,QAAQ,CACN,CAAC,gBAAgB,EAAE,EAAE,CACnB,gBAAgB,CAAC,IAAI;QACnB,sDAAsD;QACtD,GAAG,CAAC;YACF,SAAS,EAAE,GAAG,EAAE;gBACd,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;SACF,CAAC;QACF,0GAA0G;QAC1G,4EAA4E;QAC5E,SAAS,CAAC,cAAc,CAAC;QACzB,qDAAqD;QACrD,WAAW,CAAC,aAAa,CAAC;QAC1B,gFAAgF;QAChF,qBAAqB,EAAE,CACxB,EACH,4BAA4B,CAC7B,CACF;YACD,wCAAwC;aACvC,SAAS,EAAE,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACI,oBAAoB,CAAC,MAAqB;QAC/C,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,IAAI,YAAY,GAAG,KAAK,CAAC;YACzB,4GAA4G;YAC5G,MAAM,qBAAqB,GAAG,WAAW,CACvC,GAAG,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,EACtC;gBACE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,EAAK;gBACjC,iBAAiB,EAAE,KAAK;aACzB,CACF,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC5C,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAmC;IAEnC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC","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 Common\n */\n\nimport type { Connectable, Observable } from \"rxjs\";\nimport {\n  asapScheduler,\n  connectable,\n  defer,\n  EMPTY,\n  finalize,\n  iif,\n  mergeMap,\n  observeOn,\n  onErrorResumeNextWith,\n  queueScheduler,\n  Subject,\n  subscribeOn,\n  tap,\n} from \"rxjs\";\n\nconst MAX_CONCURRENT_SUBSCRIPTIONS = 1;\n\n/**\n * Limits concurrent observable subscriptions to one.\n *\n * Scheduled observables are placed at the end of a queue. Each queued observable is subscribed to and awaited until the\n * completion.\n *\n * To schedule an observable, subscribe to the result of `scheduleSubscription()` call.\n * @internal\n */\nexport class SubscriptionScheduler<T> {\n  private _scheduler = new Subject<Connectable<T>>();\n\n  constructor() {\n    this._scheduler\n      .pipe(\n        mergeMap(\n          (sourceObservable) =>\n            sourceObservable.pipe(\n              // connect source observable when scheduler subscribes\n              tap({\n                subscribe: () => {\n                  sourceObservable.connect();\n                },\n              }),\n              // Guard against stack overflow when a lot of observables are scheduled. Without this operation `mergeMap`\n              // will process each observable that is present in the pipeline recursively.\n              observeOn(queueScheduler),\n              // Delay the connection until another event loop task\n              subscribeOn(asapScheduler),\n              // Ignore errors in this pipeline without suppressing them for other subscribers\n              onErrorResumeNextWith()\n            ),\n          MAX_CONCURRENT_SUBSCRIPTIONS\n        )\n      )\n      // Start consuming scheduled observables\n      .subscribe();\n  }\n\n  /**\n   * Schedules `source` for subscription in the current scheduler.\n   *\n   * The actual scheduling is performed when the returned observable is subscribed to. To cancel, remove all subscribers\n   * from the returned observable.\n   *\n   * @param source Input observable for which to schedule a subscription.\n   * @returns Hot observable which starts emitting `source` values after subscription.\n   */\n  public scheduleSubscription(source: Observable<T>): Observable<T> {\n    return defer(() => {\n      let unsubscribed = false;\n      // Do not subscribe to source observable if it was unsubscribed from before being processed by the scheduler\n      const connectableObservable = connectable(\n        iif(() => unsubscribed, EMPTY, source),\n        {\n          connector: () => new Subject<T>(),\n          resetOnDisconnect: false,\n        }\n      );\n      this._scheduler.next(connectableObservable);\n      return connectableObservable.pipe(finalize(() => (unsubscribed = true)));\n    });\n  }\n}\n\n/**\n * Helper function for use as a `pipe()` argument with `rxjs` observables.\n * @internal\n */\nexport function scheduleSubscription<T>(\n  scheduler: SubscriptionScheduler<T>\n): (source: Observable<T>) => Observable<T> {\n  return (source) => scheduler.scheduleSubscription(source);\n}\n"]}

package/lib/components-react/common/TimeFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFormat.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/TimeFormat.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AACrC;;GAEG;AAEH,eAAO,MAAM,UAAU,oBAAc,CAAC"}

package/lib/components-react/common/TimeFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFormat.js","sourceRoot":"","sources":["../../../src/components-react/common/TimeFormat.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAO9D;;GAEG;AACH,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC","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 Common\n */\n\nimport { TimeFormat as _TimeFormat } from \"@itwin/core-react\";\n\n/** Enumeration of time formats.\n * @public\n */\n// eslint-disable-next-line deprecation/deprecation\nexport type TimeFormat = _TimeFormat;\n/** Enumeration of time formats.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-redeclare, deprecation/deprecation\nexport const TimeFormat = _TimeFormat;\n"]}

package/lib/components-react/common/UseAsyncValue.d.ts

@@ -0,0 +1,13 @@
+/** @packageDocumentation
+ * @module Common
+ */
+/**
+ * Custom hook for working with possibly async values.
+ * @public
+ */
+export declare function useAsyncValue<T>(value: T | PromiseLike<T>): T | undefined;
+/** Checks if the specified argument is a promise
+ * @internal
+ */
+export declare function isPromiseLike<T>(obj: T | PromiseLike<T>): obj is PromiseLike<T>;
+//# sourceMappingURL=UseAsyncValue.d.ts.map

package/lib/components-react/common/UseAsyncValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseAsyncValue.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/UseAsyncValue.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAqBzE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GACtB,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAEvB"}

package/lib/components-react/common/UseAsyncValue.js

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Common
+ */
+import * as React from "react";
+import { from } from "rxjs";
+/**
+ * Custom hook for working with possibly async values.
+ * @public
+ */
+export function useAsyncValue(value) {
+    const [result, setResult] = React.useState(() => {
+        if (isPromiseLike(value)) {
+            return undefined;
+        }
+        return value;
+    });
+    React.useEffect(() => {
+        if (isPromiseLike(value)) {
+            const subscription = from(value).subscribe({
+                next: (resolvedValue) => setResult(resolvedValue),
+            });
+            return () => subscription.unsubscribe();
+        }
+        setResult(value);
+        return;
+    }, [value]);
+    return result;
+}
+/** Checks if the specified argument is a promise
+ * @internal
+ */
+export function isPromiseLike(obj) {
+    return typeof obj === "object" && typeof obj.then === "function";
+}
+//# sourceMappingURL=UseAsyncValue.js.map

package/lib/components-react/common/UseAsyncValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseAsyncValue.js","sourceRoot":"","sources":["../../../src/components-react/common/UseAsyncValue.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAI,KAAyB;IACxD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE;QAC9C,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;gBACzC,IAAI,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC;aAClD,CAAC,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;QAED,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO;IACT,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAuB;IAEvB,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAQ,GAAW,CAAC,IAAI,KAAK,UAAU,CAAC;AAC5E,CAAC","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 Common\n */\n\nimport * as React from \"react\";\nimport { from } from \"rxjs\";\n\n/**\n * Custom hook for working with possibly async values.\n * @public\n */\nexport function useAsyncValue<T>(value: T | PromiseLike<T>): T | undefined {\n  const [result, setResult] = React.useState(() => {\n    if (isPromiseLike(value)) {\n      return undefined;\n    }\n    return value;\n  });\n\n  React.useEffect(() => {\n    if (isPromiseLike(value)) {\n      const subscription = from(value).subscribe({\n        next: (resolvedValue) => setResult(resolvedValue),\n      });\n      return () => subscription.unsubscribe();\n    }\n\n    setResult(value);\n    return;\n  }, [value]);\n\n  return result;\n}\n\n/** Checks if the specified argument is a promise\n * @internal\n */\nexport function isPromiseLike<T>(\n  obj: T | PromiseLike<T>\n): obj is PromiseLike<T> {\n  return typeof obj === \"object\" && typeof (obj as any).then === \"function\";\n}\n"]}

package/lib/components-react/common/UseContextWithMandatoryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseContextWithMandatoryProvider.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/UseContextWithMandatoryProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,gBAAgB;AAChB,wBAAgB,kCAAkC,CAAC,CAAC,EAClD,WAAW,EAAE,MAAM,GAClB;IACD,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC;CAC5C,CAgBA"}

package/lib/components-react/common/UseContextWithMandatoryProvider.js

@@ -0,0 +1,21 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import React from "react";
+import { UiError } from "@itwin/appui-abstract";
+import { UiComponents } from "../UiComponents.js";
+/** @internal */
+export function createContextWithMandatoryProvider(contextName) {
+    const context = React.createContext(undefined);
+    function useContextWithoutDefaultValue(ConsumingComponent) {
+        const value = React.useContext(context);
+        if (value === undefined) {
+            // eslint-disable-next-line deprecation/deprecation
+            throw new UiError(UiComponents.loggerCategory("createContextWithMandatoryProvider"), `'${ConsumingComponent.displayName}' expects to be wrapped by a '${contextName}' provider.`);
+        }
+        return value;
+    }
+    return [context.Provider, context.Consumer, useContextWithoutDefaultValue];
+}
+//# sourceMappingURL=UseContextWithMandatoryProvider.js.map

package/lib/components-react/common/UseContextWithMandatoryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseContextWithMandatoryProvider.js","sourceRoot":"","sources":["../../../src/components-react/common/UseContextWithMandatoryProvider.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,gBAAgB;AAChB,MAAM,UAAU,kCAAkC,CAChD,WAAmB;IAMnB,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAI,SAAqB,CAAC,CAAC;IAC9D,SAAS,6BAA6B,CACpC,kBAA0C;QAE1C,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,mDAAmD;YACnD,MAAM,IAAI,OAAO,CACf,YAAY,CAAC,cAAc,CAAC,oCAAoC,CAAC,EACjE,IAAI,kBAAkB,CAAC,WAAW,iCAAiC,WAAW,aAAa,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;AAC7E,CAAC","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 *--------------------------------------------------------------------------------------------*/\nimport React from \"react\";\nimport { UiError } from \"@itwin/appui-abstract\";\nimport { UiComponents } from \"../UiComponents.js\";\n\n/** @internal */\nexport function createContextWithMandatoryProvider<T>(\n  contextName: string\n): [\n  React.ProviderExoticComponent<React.ProviderProps<T>>,\n  React.ExoticComponent<React.ConsumerProps<T>>,\n  <P>(component: React.ComponentType<P>) => T\n] {\n  const context = React.createContext<T>(undefined as any as T);\n  function useContextWithoutDefaultValue<P>(\n    ConsumingComponent: React.ComponentType<P>\n  ) {\n    const value = React.useContext(context);\n    if (value === undefined) {\n      // eslint-disable-next-line deprecation/deprecation\n      throw new UiError(\n        UiComponents.loggerCategory(\"createContextWithMandatoryProvider\"),\n        `'${ConsumingComponent.displayName}' expects to be wrapped by a '${contextName}' provider.`\n      );\n    }\n    return value;\n  }\n  return [context.Provider, context.Consumer, useContextWithoutDefaultValue];\n}\n"]}

package/lib/components-react/common/UseDebouncedAsyncValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseDebouncedAsyncValue.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/UseDebouncedAsyncValue.ts"],"names":[],"mappings":"AAIA;;GAEG;AASH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAC5C,iBAAiB,EAAE,SAAS,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;;;EAuDxD"}

package/lib/components-react/common/UseDebouncedAsyncValue.js

@@ -0,0 +1,66 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Common
+ */
+import { useEffect, useState } from "react";
+import { defer, share } from "rxjs";
+import { scheduleSubscription, SubscriptionScheduler, } from "./SubscriptionScheduler.js";
+/**
+ * Custom hook for working with promise values.
+ * Promises are debounced using trailing and leading edge.
+ * The first promise will always be executed.
+ * Any promises following the first while it is executing will be scheduled (and unscheduled), leaving only the last promise to be resolved.
+ * Once the first promise finishes resolving, the last passed promise starts resolving.
+ * @throws if/when `valueToBeResolved` promise is rejected. The error is thrown in the React's render loop, so it can be caught using an error boundary.
+ * @beta
+ */
+export function useDebouncedAsyncValue(valueToBeResolved) {
+    const [scheduler] = useState(() => new SubscriptionScheduler());
+    const [{ result, inProgress }, setState] = useState({
+        result: undefined,
+        inProgress: false,
+    });
+    useEffect(() => {
+        if (!valueToBeResolved) {
+            setState((prev) => ({ ...prev, result: undefined, inProgress: false }));
+            return;
+        }
+        setState((prev) => ({
+            ...prev,
+            inProgress: true,
+        }));
+        // schedule and subscribe to the observable emitting value from valueToBeResolved promise
+        const subscription = defer(valueToBeResolved)
+            .pipe(share({
+            resetOnError: false,
+            resetOnComplete: false,
+            resetOnRefCountZero: true,
+        }), scheduleSubscription(scheduler))
+            .subscribe({
+            next: (data) => {
+                setState((prev) => ({ ...prev, result: data, inProgress: false }));
+            },
+            error: (err) => {
+                setState((prev) => ({
+                    ...prev,
+                    result: { error: err, hasError: true },
+                    inProgress: false,
+                }));
+            },
+        });
+        return () => {
+            subscription.unsubscribe();
+        };
+    }, [valueToBeResolved, scheduler]);
+    if (isErrorResult(result)) {
+        throw result.error ?? new Error("Exception in `useDebouncedAsyncValue`");
+    }
+    return { value: result, inProgress };
+}
+function isErrorResult(obj) {
+    return obj !== undefined && obj.hasError;
+}
+//# sourceMappingURL=UseDebouncedAsyncValue.js.map

package/lib/components-react/common/UseDebouncedAsyncValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseDebouncedAsyncValue.js","sourceRoot":"","sources":["../../../src/components-react/common/UseDebouncedAsyncValue.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,iBAAuD;IAEvD,MAAM,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAW,CAAC,CAAC;IAEzE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAGhD;QACD,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClB,GAAG,IAAI;YACP,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC,CAAC;QACJ,yFAAyF;QACzF,MAAM,YAAY,GAAG,KAAK,CAAC,iBAAiB,CAAC;aAC1C,IAAI,CACH,KAAK,CAAC;YACJ,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,mBAAmB,EAAE,IAAI;SAC1B,CAAC,EACF,oBAAoB,CAAC,SAAS,CAAC,CAChC;aACA,SAAS,CAAC;YACT,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACb,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACrE,CAAC;YACD,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;gBACb,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAClB,GAAG,IAAI;oBACP,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACtC,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAC,CAAC;YACN,CAAC;SACF,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC;AAOD,SAAS,aAAa,CACpB,GAA2B;IAE3B,OAAO,GAAG,KAAK,SAAS,IAAK,GAAmB,CAAC,QAAQ,CAAC;AAC5D,CAAC","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 Common\n */\n\nimport { useEffect, useState } from \"react\";\nimport { defer, share } from \"rxjs\";\nimport {\n  scheduleSubscription,\n  SubscriptionScheduler,\n} from \"./SubscriptionScheduler.js\";\n\n/**\n * Custom hook for working with promise values.\n * Promises are debounced using trailing and leading edge.\n * The first promise will always be executed.\n * Any promises following the first while it is executing will be scheduled (and unscheduled), leaving only the last promise to be resolved.\n * Once the first promise finishes resolving, the last passed promise starts resolving.\n * @throws if/when `valueToBeResolved` promise is rejected. The error is thrown in the React's render loop, so it can be caught using an error boundary.\n * @beta\n */\nexport function useDebouncedAsyncValue<TReturn>(\n  valueToBeResolved: undefined | (() => Promise<TReturn>)\n) {\n  const [scheduler] = useState(() => new SubscriptionScheduler<TReturn>());\n\n  const [{ result, inProgress }, setState] = useState<{\n    result: TReturn | ErrorResult | undefined;\n    inProgress: boolean;\n  }>({\n    result: undefined,\n    inProgress: false,\n  });\n\n  useEffect(() => {\n    if (!valueToBeResolved) {\n      setState((prev) => ({ ...prev, result: undefined, inProgress: false }));\n      return;\n    }\n\n    setState((prev) => ({\n      ...prev,\n      inProgress: true,\n    }));\n    // schedule and subscribe to the observable emitting value from valueToBeResolved promise\n    const subscription = defer(valueToBeResolved)\n      .pipe(\n        share({\n          resetOnError: false,\n          resetOnComplete: false,\n          resetOnRefCountZero: true,\n        }),\n        scheduleSubscription(scheduler)\n      )\n      .subscribe({\n        next: (data) => {\n          setState((prev) => ({ ...prev, result: data, inProgress: false }));\n        },\n        error: (err) => {\n          setState((prev) => ({\n            ...prev,\n            result: { error: err, hasError: true },\n            inProgress: false,\n          }));\n        },\n      });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [valueToBeResolved, scheduler]);\n\n  if (isErrorResult(result)) {\n    throw result.error ?? new Error(\"Exception in `useDebouncedAsyncValue`\");\n  }\n\n  return { value: result, inProgress };\n}\n\ninterface ErrorResult {\n  error: Error | undefined;\n  hasError: boolean;\n}\n\nfunction isErrorResult<TResult>(\n  obj?: TResult | ErrorResult\n): obj is ErrorResult {\n  return obj !== undefined && (obj as ErrorResult).hasError;\n}\n"]}

package/lib/components-react/common/UseElementsScrollStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseElementsScrollStorage.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/UseElementsScrollStorage.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,OAAO,EACxD,iBAAiB,EAAE,MAAM,GACxB;IACD,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAoCA"}

package/lib/components-react/common/UseElementsScrollStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseElementsScrollStorage.js","sourceRoot":"","sources":["../../../src/components-react/common/UseElementsScrollStorage.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAGhG,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,iBAAyB;IAMzB,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAW,EAAE,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,+DAA+D;IAC/D,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9B,CAAC,CAAC;IAEF,2FAA2F;IAC3F,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACjD,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC","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\nimport type { Ref } from \"react\";\nimport { useRef } from \"react\";\n\n/**\n * Returns callbacks for persisting and restoring elements `scrollTop` property value.\n * This can be used to restore elements scroll position if it needs to be hidden and\n * later shown again without unmounting React component.\n * @internal\n */\nexport function useElementsScrollStorage<T extends Element>(\n  elementsClassName: string\n): {\n  ref: Ref<T>;\n  persist: () => void;\n  restore: () => void;\n} {\n  const ref = useRef<T>(null);\n  const scrollTop = useRef<number[]>([]);\n\n  const getElements = () => {\n    if (!ref.current) {\n      return [];\n    }\n    return ref.current.getElementsByClassName(elementsClassName);\n  };\n\n  /** Persists current `scrollTop` property value of elements. */\n  const persist = () => {\n    const elements = getElements();\n    const offsets: number[] = [];\n    for (const element of elements) {\n      offsets.push(element.scrollTop);\n    }\n    scrollTop.current = offsets;\n  };\n\n  /** Restores `scrollTop` property values back. If `persist` was not called does nothing. */\n  const restore = () => {\n    const elements = getElements();\n    if (elements.length !== scrollTop.current.length) {\n      scrollTop.current = [];\n      return;\n    }\n\n    for (let i = 0; i < scrollTop.current.length; i++) {\n      elements[i].scrollTop = scrollTop.current[i];\n    }\n    scrollTop.current = [];\n  };\n\n  return { ref, persist, restore };\n}\n"]}

package/lib/components-react/common/countMatchesInString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countMatchesInString.d.ts","sourceRoot":"","sources":["../../../src/components-react/common/countMatchesInString.ts"],"names":[],"mappings":"AAMA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAe/D"}

package/lib/components-react/common/countMatchesInString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countMatchesInString.js","sourceRoot":"","sources":["../../../src/components-react/common/countMatchesInString.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,gEAAgE;AAEhE;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,MAAc;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,GAAG,CAAC,EACP,GAAG,GAAG,CAAC,CAAC;IACV,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAE3B,OAAO,IAAI,EAAE,CAAC;QACZ,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,EAAE,CAAC,CAAC;YACJ,GAAG,IAAI,IAAI,CAAC;QACd,CAAC;;YAAM,MAAM;IACf,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC","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/* @author Vitim.us https://gist.github.com/victornpb/7736865 */\n\n/** @packageDocumentation\n * @module Common\n */\n\n/** Counts how many times string 'lookup' is repeated in string 'str'.\n * @internal\n */\nexport function countMatchesInString(str: string, lookup: string) {\n  if (!str.length || !lookup.length) return 0;\n\n  let n = 0,\n    pos = 0;\n  const step = lookup.length;\n\n  while (true) {\n    pos = str.indexOf(lookup, pos);\n    if (pos >= 0) {\n      ++n;\n      pos += step;\n    } else break;\n  }\n  return n;\n}\n"]}

package/lib/components-react/common/selection/SelectionHandler.d.ts

@@ -0,0 +1,123 @@
+/** @packageDocumentation
+ * @module Common
+ */
+import { SelectionMode } from "./SelectionModes.js";
+/** Prototype for a Selection Changed handler
+ * @public
+ */
+export declare type OnSelectionChanged = (shiftDown?: boolean, ctrlDown?: boolean) => void;
+/**
+ * Contains single item specific methods required by selection handler.
+ * @internal
+ */
+export interface SingleSelectionHandler<TItem> {
+    /**
+     * Callback for before an item is selected.
+     */
+    preselect: () => void;
+    /**
+     * Selects the item.
+     */
+    select: () => void;
+    /**
+     * Deselects the item.
+     */
+    deselect: () => void;
+    /**
+     * Returns true if item is selected.
+     */
+    isSelected: () => boolean;
+    /**
+     * Returns the item.
+     */
+    item: () => TItem;
+}
+/**
+ * Contains multi-selection methods required by selection handler.
+ * @internal
+ */
+export interface MultiSelectionHandler<TItem> {
+    /**
+     * Shift selects between two items.
+     * Returns items that were selected.
+     */
+    selectBetween: (item1: TItem, item2: TItem) => TItem[];
+    /**
+     * Updates selection.
+     * @param selections Items to be added to selection.
+     * @param deselections Items to be removed from selection.
+     */
+    updateSelection: (selections: TItem[], deselections: TItem[]) => void;
+    /**
+     * Deselects all items.
+     */
+    deselectAll: () => void;
+    /**
+     * Returns true if items are equal.
+     */
+    areEqual: (item1: TItem, item2: TItem) => boolean;
+}
+/**
+ * Called after items were selected.
+ * @param items Items that were selected.
+ * @param replace Should replace current selection.
+ * @public
+ */
+export declare type OnItemsSelectedCallback<TItem> = (items: TItem[], replace: boolean) => void | boolean;
+/**
+ * Called after items were deselected.
+ * @param items Items that were deselected.
+ * @public
+ */
+export declare type OnItemsDeselectedCallback<Item> = (items: Item[]) => void | boolean;
+/** @internal */
+export declare class DragAction<Item> {
+    private _itemSelectionHandlers;
+    private _componentSelectionHandler;
+    private _previousRow;
+    private _previousColumn;
+    private _firstItemRow;
+    private _firstItemColumn;
+    private _firstItemSelected;
+    constructor(componentSelectionHandler: MultiSelectionHandler<Item>, itemSelectionHandlers: Array<Array<SingleSelectionHandler<Item>>>, firstItem: Item);
+    updateDragAction(latestItem: Item): {
+        selections: Item[];
+        deselections: Item[];
+    };
+    private findItem;
+}
+/** @internal */
+export declare class SelectionHandler<Item> {
+    /** Selection mode. */
+    selectionMode: SelectionMode;
+    onItemsSelectedCallback?: OnItemsSelectedCallback<Item>;
+    onItemsDeselectedCallback?: OnItemsDeselectedCallback<Item>;
+    private _currentOperation?;
+    private _lastItem?;
+    private _processedItem?;
+    private _dragAction?;
+    private _componentSelectionHandler?;
+    constructor(selectionMode: SelectionMode, onItemsSelectedCallback?: OnItemsSelectedCallback<Item>, onItemsDeselectedCallback?: OnItemsDeselectedCallback<Item>);
+    /** Get the onSelectionChange processed item */
+    get processedItem(): Item | undefined;
+    /** Creates a function that should be called when selection changes. */
+    createSelectionFunction(componentHandler: MultiSelectionHandler<Item>, itemHandler: SingleSelectionHandler<Item>): OnSelectionChanged;
+    private completeOperation;
+    /**
+     * Creates drag action.
+     * @param componentSelectionHandler Component selection handler.
+     * @param items Ordered item selection handlers separated into arrays by rows.
+     * @param firstItem Item on which drag action was started.
+     */
+    createDragAction(componentSelectionHandler: MultiSelectionHandler<Item>, items: Array<Array<SingleSelectionHandler<Item>>>, firstItem: Item): void;
+    /**
+     * Updates existing drag action.
+     * @param latestItem Latest item in drag action.
+     */
+    updateDragAction(latestItem: Item): void;
+    /**
+     * Completes drag action.
+     */
+    completeDragAction(): void;
+}
+//# sourceMappingURL=SelectionHandler.d.ts.map

package/lib/components-react/common/selection/SelectionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionHandler.d.ts","sourceRoot":"","sources":["../../../../src/components-react/common/selection/SelectionHandler.ts"],"names":[],"mappings":"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"}

package/lib/components-react/common/selection/SelectionHandler.js

@@ -0,0 +1,235 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Common
+ */
+import { Rectangle } from "@itwin/core-react/internal";
+import { hasSelectionModeFlag, SelectionMode, SelectionModeFlags, } from "./SelectionModes.js";
+class BatchSelectionOperation {
+    constructor(componentSelectionHandler, shouldReplace) {
+        this.selections = new Array();
+        this.deselections = new Array();
+        this.shouldReplace = shouldReplace;
+        this._componentSelectionHandler = componentSelectionHandler;
+    }
+    select(node) {
+        this.addNodes(node, this.selections, this.shouldReplace ? undefined : this.deselections);
+    }
+    deselect(node) {
+        this.addNodes(node, this.deselections, this.shouldReplace ? undefined : this.selections);
+    }
+    addNodes(node, addTo, removeFrom) {
+        if (Array.isArray(node)) {
+            for (const n of node) {
+                if (removeFrom) {
+                    const index = removeFrom.findIndex((x) => this._componentSelectionHandler.areEqual(x, n));
+                    if (index > -1) {
+                        removeFrom.splice(index, 1);
+                        continue;
+                    }
+                }
+                addTo.push(n);
+            }
+        }
+        else {
+            this.addNodes([node], addTo, removeFrom);
+        }
+    }
+}
+/** @internal */
+export class DragAction {
+    constructor(componentSelectionHandler, itemSelectionHandlers, firstItem) {
+        this._itemSelectionHandlers = itemSelectionHandlers;
+        this._componentSelectionHandler = componentSelectionHandler;
+        const itemPos = this.findItem(this._itemSelectionHandlers, firstItem);
+        this._previousRow = itemPos.y;
+        this._previousColumn = itemPos.x;
+        this._firstItemRow = itemPos.y;
+        this._firstItemColumn = itemPos.x;
+        this._firstItemSelected = false;
+    }
+    updateDragAction(latestItem) {
+        const currentPos = this.findItem(this._itemSelectionHandlers, latestItem);
+        if ((currentPos.y === this._previousRow &&
+            currentPos.x === this._previousColumn) ||
+            currentPos.x < 0 ||
+            currentPos.y < 0)
+            return { selections: [], deselections: [] };
+        const currentRange = Rectangle.createXYXY(this._firstItemColumn, this._firstItemRow, currentPos.x, currentPos.y);
+        const previousRange = Rectangle.createXYXY(this._firstItemColumn, this._firstItemRow, this._previousColumn, this._previousRow);
+        const wholeRange = Rectangle.createXYXY(currentRange.right > previousRange.right
+            ? currentRange.right
+            : previousRange.right, currentRange.bottom > previousRange.bottom
+            ? currentRange.bottom
+            : previousRange.bottom, currentRange.left < previousRange.left
+            ? currentRange.left
+            : previousRange.left, currentRange.top < previousRange.top
+            ? currentRange.top
+            : previousRange.top);
+        const selections = [];
+        const deselections = [];
+        // have to select first item separately since it is will always be in both previous and current ranges.
+        if (!this._firstItemSelected) {
+            const handler = this._itemSelectionHandlers[this._firstItemRow][this._firstItemColumn];
+            if (handler.isSelected())
+                deselections.push(handler.item());
+            else
+                selections.push(handler.item());
+            this._firstItemSelected = true;
+        }
+        for (let r = wholeRange.top; r <= wholeRange.bottom; r++) {
+            for (let c = wholeRange.left; c <= wholeRange.right; c++) {
+                const insidePrevious = previousRange.containsXY(c, r);
+                const insideCurrent = currentRange.containsXY(c, r);
+                // If item is in only one of the ranges that means it's selection needs to be toggled.
+                if ((insidePrevious || insideCurrent) &&
+                    insideCurrent !== insidePrevious) {
+                    const itemHandler = this._itemSelectionHandlers[r][c];
+                    if (itemHandler.isSelected())
+                        deselections.push(itemHandler.item());
+                    else
+                        selections.push(itemHandler.item());
+                }
+            }
+        }
+        this._previousRow = currentPos.y;
+        this._previousColumn = currentPos.x;
+        return { selections, deselections };
+    }
+    findItem(itemSelectionHandlers, item) {
+        if (this._previousRow !== undefined &&
+            this._previousRow !== -1 &&
+            this._previousColumn !== undefined &&
+            this._previousColumn !== -1 &&
+            this._componentSelectionHandler.areEqual(itemSelectionHandlers[this._previousRow][this._previousColumn].item(), item)) {
+            return { y: this._previousRow, x: this._previousColumn };
+        }
+        for (let row = 0; row < itemSelectionHandlers.length; row++) {
+            for (let column = 0; column < itemSelectionHandlers[row].length; column++) {
+                if (this._componentSelectionHandler.areEqual(itemSelectionHandlers[row][column].item(), item))
+                    return { x: column, y: row };
+            }
+        }
+        return { x: -1, y: -1 };
+    }
+}
+/** @internal */
+export class SelectionHandler {
+    constructor(selectionMode, onItemsSelectedCallback, onItemsDeselectedCallback) {
+        this.selectionMode = selectionMode;
+        this.onItemsSelectedCallback = onItemsSelectedCallback;
+        this.onItemsDeselectedCallback = onItemsDeselectedCallback;
+    }
+    /** Get the onSelectionChange processed item */
+    get processedItem() {
+        return this._processedItem;
+    }
+    /** Creates a function that should be called when selection changes. */
+    createSelectionFunction(componentHandler, itemHandler) {
+        const onSelectionChange = (shiftDown, ctrlDown) => {
+            this._processedItem = itemHandler.item();
+            if (this.selectionMode === SelectionMode.None) {
+                return;
+            }
+            let operationCreated = false;
+            let shiftSelected = false;
+            if (!this._currentOperation) {
+                // will replace selection if it is limited to one or keys are enabled but ctrl is not down
+                const shouldReplace = (hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.KeysEnabled) &&
+                    !ctrlDown) ||
+                    hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.SelectionLimitOne);
+                this._currentOperation = new BatchSelectionOperation(componentHandler, shouldReplace);
+                operationCreated = true;
+            }
+            if (hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.KeysEnabled)) {
+                if (!ctrlDown)
+                    componentHandler.deselectAll();
+                if (shiftDown && this._lastItem !== undefined) {
+                    const selected = componentHandler.selectBetween(this._lastItem, itemHandler.item());
+                    this._currentOperation.select(selected);
+                    shiftSelected = true;
+                }
+            }
+            if (!shiftSelected) {
+                itemHandler.preselect();
+                if (hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.SelectionLimitOne) &&
+                    !(hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.ToggleEnabled) && itemHandler.isSelected())) {
+                    componentHandler.deselectAll();
+                }
+                if (itemHandler.isSelected()) {
+                    itemHandler.deselect();
+                    this._currentOperation.deselect(itemHandler.item());
+                }
+                else {
+                    itemHandler.select();
+                    this._currentOperation.select(itemHandler.item());
+                }
+                this._lastItem = itemHandler.item();
+            }
+            if (operationCreated)
+                this.completeOperation();
+        };
+        return onSelectionChange.bind(this);
+    }
+    completeOperation() {
+        if (!this._currentOperation)
+            return;
+        if (0 !== this._currentOperation.selections.length) {
+            if (this.onItemsSelectedCallback) {
+                this.onItemsSelectedCallback(this._currentOperation.selections, this._currentOperation.shouldReplace);
+                if (this._currentOperation.shouldReplace) {
+                    this._currentOperation = undefined;
+                    return;
+                }
+            }
+        }
+        if (0 !== this._currentOperation.deselections.length) {
+            if (this.onItemsDeselectedCallback)
+                this.onItemsDeselectedCallback(this._currentOperation.deselections);
+        }
+        this._currentOperation = undefined;
+    }
+    /**
+     * Creates drag action.
+     * @param componentSelectionHandler Component selection handler.
+     * @param items Ordered item selection handlers separated into arrays by rows.
+     * @param firstItem Item on which drag action was started.
+     */
+    createDragAction(componentSelectionHandler, items, firstItem) {
+        if (!hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.DragEnabled))
+            return;
+        this._dragAction = new DragAction(componentSelectionHandler, items, firstItem);
+        this._componentSelectionHandler = componentSelectionHandler;
+    }
+    /**
+     * Updates existing drag action.
+     * @param latestItem Latest item in drag action.
+     */
+    updateDragAction(latestItem) {
+        if (!hasSelectionModeFlag(this.selectionMode, SelectionModeFlags.DragEnabled))
+            return;
+        if (!this._dragAction || !this._componentSelectionHandler)
+            return;
+        this._lastItem = latestItem;
+        const selectionChanges = this._dragAction.updateDragAction(latestItem);
+        if (selectionChanges.deselections.length !== 0 ||
+            selectionChanges.selections.length !== 0) {
+            if (!this._currentOperation)
+                this._currentOperation = new BatchSelectionOperation(this._componentSelectionHandler, false);
+            this._currentOperation.select(selectionChanges.selections);
+            this._currentOperation.deselect(selectionChanges.deselections);
+            this._componentSelectionHandler.updateSelection(selectionChanges.selections, selectionChanges.deselections);
+        }
+    }
+    /**
+     * Completes drag action.
+     */
+    completeDragAction() {
+        this._dragAction = undefined;
+        this._componentSelectionHandler = undefined;
+        this.completeOperation();
+    }
+}
+//# sourceMappingURL=SelectionHandler.js.map