@itwin/frontend-devtools 4.0.0-dev.8 → 4.0.0-dev.80

package/lib/esm/widgets/KeyinField.js

@@ -1,184 +1,183 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Widgets
- */
-import { IModelApp, MessageBoxIconType, MessageBoxType, ParseAndRunResult } from "@itwin/core-frontend";
-import { createButton } from "../ui/Button";
-import { appendDataListEntries, createDataList } from "../ui/DataList";
-import { createTextBox } from "../ui/TextBox";
-function keyinsToDataListEntries(keyins) {
-    const entries = [];
-    for (const keyin of keyins) {
-        entries.push({ value: keyin });
-    }
-    return entries;
-}
-/** Controls whether localized and/or non-localized key-in strings appear in a KeyinField's auto-completion list.
- * @beta
- */
-export var KeyinFieldLocalization;
-(function (KeyinFieldLocalization) {
-    /** Include only non-localized key-in strings. */
-    KeyinFieldLocalization[KeyinFieldLocalization["NonLocalized"] = 0] = "NonLocalized";
-    /** Include only localized key-in strings. */
-    KeyinFieldLocalization[KeyinFieldLocalization["Localized"] = 1] = "Localized";
-    /** Include localized and non-localized strings for each key-in. */
-    KeyinFieldLocalization[KeyinFieldLocalization["Both"] = 2] = "Both";
-})(KeyinFieldLocalization || (KeyinFieldLocalization = {}));
-/** A textbox allowing input of key-ins (localized tool names) combined with a drop-down that lists all registered key-ins, filtered by substring match on the current input.
- * Press `enter` or click the Enter button to run the key-in.
- * @beta
- */
-export class KeyinField {
-    constructor(props) {
-        var _a;
-        this._historyLength = 0;
-        this._localization = (_a = props.localization) !== null && _a !== void 0 ? _a : KeyinFieldLocalization.NonLocalized;
-        this.keyins = this.findKeyins();
-        const autoCompleteListId = `${props.baseId}_autoComplete`;
-        this.autoCompleteList = createDataList({
-            parent: props.parent,
-            entries: keyinsToDataListEntries(this.keyins),
-            id: autoCompleteListId,
-            inline: true,
-        });
-        this.textBox = createTextBox({
-            label: props.wantLabel ? "Key-in: " : undefined,
-            id: `${props.baseId}_textBox`,
-            parent: props.parent,
-            handler: () => this.selectAll(),
-            keypresshandler: async (_tb, ev) => { await this.handleKeyPress(ev); },
-            focushandler: (_tb) => { this.respondToKeyinFocus(); },
-            tooltip: "Type the key-in text here",
-            inline: true,
-            list: autoCompleteListId,
-        });
-        if (props.wantButton) {
-            createButton({
-                handler: async (_bt) => { await this.submitKeyin(); },
-                parent: props.parent,
-                value: "Enter",
-                inline: true,
-                tooltip: "Click here to execute the key-in",
-            });
-        }
-        if (undefined !== props.historyLength && props.historyLength > 0) {
-            this.textBox.textbox.onkeydown = (ev) => this.handleKeyDown(ev); // eslint-disable-line @typescript-eslint/promise-function-async
-            this._historyLength = props.historyLength;
-            this._history = [];
-        }
-    }
-    focus() { this.textBox.textbox.focus(); }
-    loseFocus() { this.textBox.textbox.blur(); }
-    selectAll() {
-        this.textBox.textbox.setSelectionRange(0, this.textBox.textbox.value.length);
-    }
-    async handleKeyPress(ev) {
-        ev.stopPropagation();
-        if ("Enter" === ev.key)
-            await this.submitKeyin();
-    }
-    async handleKeyDown(ev) {
-        ev.stopPropagation();
-        if (undefined === this._history || 0 === this._history.length)
-            return;
-        // NB: History list is ordered by most to least recent so moving "backwards" means incrementing the index.
-        const direction = ev.key === "ArrowDown" ? 1 : (ev.key === "ArrowUp" ? 1 : 0);
-        if (0 === direction)
-            return;
-        ev.preventDefault();
-        ev.stopPropagation();
-        if (this._historyIndex === undefined) {
-            if (direction < 0)
-                return;
-            else
-                this._historyIndex = -1;
-        }
-        const newIndex = this._historyIndex + direction;
-        if (newIndex >= 0 && newIndex < this._history.length) {
-            this._historyIndex = newIndex;
-            if (this._historyIndex >= 0)
-                this.textBox.textbox.value = this._history[newIndex];
-        }
-    }
-    resetHistoryIndex() {
-        this._historyIndex = undefined;
-    }
-    pushHistory(keyin) {
-        if (undefined === this._history)
-            return;
-        this.textBox.textbox.value = "";
-        this.resetHistoryIndex();
-        if (this._history.length === 0 || keyin.toLowerCase() !== this._history[0].toLowerCase()) {
-            this._history.unshift(keyin);
-            if (this._history.length > this._historyLength)
-                this._history.pop();
-        }
-    }
-    async submitKeyin() {
-        this.selectAll();
-        const textBox = this.textBox.textbox;
-        const input = textBox.value;
-        this.pushHistory(input);
-        let message;
-        try {
-            switch (await IModelApp.tools.parseAndRun(input)) {
-                case ParseAndRunResult.ToolNotFound:
-                    message = `Cannot find a key-in that matches: ${input}`;
-                    break;
-                case ParseAndRunResult.BadArgumentCount:
-                    message = "Incorrect number of arguments";
-                    break;
-                case ParseAndRunResult.FailedToRun:
-                    message = "Key-in failed to run";
-                    break;
-            }
-        }
-        catch (ex) {
-            message = `Key-in produced exception: ${ex}`;
-        }
-        if (undefined !== message)
-            await IModelApp.notifications.openMessageBox(MessageBoxType.MediumAlert, message, MessageBoxIconType.Warning);
-    }
-    respondToKeyinFocus() {
-        this.resetHistoryIndex();
-        // Handle case in which new tools were registered since we last populated the auto-complete list.
-        // This can occur e.g. as a result of loading a extension, or deferred initialization of a package like markup.
-        const keyins = this.findKeyins();
-        if (keyins.length > this.keyins.length) {
-            const newKeyins = [];
-            for (const keyin of keyins)
-                if (!this.keyins.includes(keyin)) {
-                    newKeyins.push(keyin);
-                    this.keyins.push(keyin);
-                }
-            if (newKeyins.length > 0)
-                appendDataListEntries(this.autoCompleteList, keyinsToDataListEntries(newKeyins));
-        }
-    }
-    findKeyins() {
-        const keyins = [];
-        const tools = IModelApp.tools.getToolList();
-        for (const tool of tools) {
-            switch (this._localization) {
-                case KeyinFieldLocalization.Localized:
-                    keyins.push(tool.keyin);
-                    break;
-                case KeyinFieldLocalization.Both:
-                    keyins.push(tool.keyin);
-                    if (tool.keyin === tool.englishKeyin)
-                        break;
-                /* falls through */
-                default:
-                case KeyinFieldLocalization.NonLocalized:
-                    keyins.push(tool.englishKeyin);
-                    break;
-            }
-        }
-        return keyins;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Widgets
+ */
+import { IModelApp, MessageBoxIconType, MessageBoxType, ParseAndRunResult } from "@itwin/core-frontend";
+import { createButton } from "../ui/Button";
+import { appendDataListEntries, createDataList } from "../ui/DataList";
+import { createTextBox } from "../ui/TextBox";
+function keyinsToDataListEntries(keyins) {
+    const entries = [];
+    for (const keyin of keyins) {
+        entries.push({ value: keyin });
+    }
+    return entries;
+}
+/** Controls whether localized and/or non-localized key-in strings appear in a KeyinField's auto-completion list.
+ * @beta
+ */
+export var KeyinFieldLocalization;
+(function (KeyinFieldLocalization) {
+    /** Include only non-localized key-in strings. */
+    KeyinFieldLocalization[KeyinFieldLocalization["NonLocalized"] = 0] = "NonLocalized";
+    /** Include only localized key-in strings. */
+    KeyinFieldLocalization[KeyinFieldLocalization["Localized"] = 1] = "Localized";
+    /** Include localized and non-localized strings for each key-in. */
+    KeyinFieldLocalization[KeyinFieldLocalization["Both"] = 2] = "Both";
+})(KeyinFieldLocalization || (KeyinFieldLocalization = {}));
+/** A textbox allowing input of key-ins (localized tool names) combined with a drop-down that lists all registered key-ins, filtered by substring match on the current input.
+ * Press `enter` or click the Enter button to run the key-in.
+ * @beta
+ */
+export class KeyinField {
+    constructor(props) {
+        this._historyLength = 0;
+        this._localization = props.localization ?? KeyinFieldLocalization.NonLocalized;
+        this.keyins = this.findKeyins();
+        const autoCompleteListId = `${props.baseId}_autoComplete`;
+        this.autoCompleteList = createDataList({
+            parent: props.parent,
+            entries: keyinsToDataListEntries(this.keyins),
+            id: autoCompleteListId,
+            inline: true,
+        });
+        this.textBox = createTextBox({
+            label: props.wantLabel ? "Key-in: " : undefined,
+            id: `${props.baseId}_textBox`,
+            parent: props.parent,
+            handler: () => this.selectAll(),
+            keypresshandler: async (_tb, ev) => { await this.handleKeyPress(ev); },
+            focushandler: (_tb) => { this.respondToKeyinFocus(); },
+            tooltip: "Type the key-in text here",
+            inline: true,
+            list: autoCompleteListId,
+        });
+        if (props.wantButton) {
+            createButton({
+                handler: async (_bt) => { await this.submitKeyin(); },
+                parent: props.parent,
+                value: "Enter",
+                inline: true,
+                tooltip: "Click here to execute the key-in",
+            });
+        }
+        if (undefined !== props.historyLength && props.historyLength > 0) {
+            this.textBox.textbox.onkeydown = (ev) => this.handleKeyDown(ev); // eslint-disable-line @typescript-eslint/promise-function-async
+            this._historyLength = props.historyLength;
+            this._history = [];
+        }
+    }
+    focus() { this.textBox.textbox.focus(); }
+    loseFocus() { this.textBox.textbox.blur(); }
+    selectAll() {
+        this.textBox.textbox.setSelectionRange(0, this.textBox.textbox.value.length);
+    }
+    async handleKeyPress(ev) {
+        ev.stopPropagation();
+        if ("Enter" === ev.key)
+            await this.submitKeyin();
+    }
+    async handleKeyDown(ev) {
+        ev.stopPropagation();
+        if (undefined === this._history || 0 === this._history.length)
+            return;
+        // NB: History list is ordered by most to least recent so moving "backwards" means incrementing the index.
+        const direction = ev.key === "ArrowDown" ? 1 : (ev.key === "ArrowUp" ? 1 : 0);
+        if (0 === direction)
+            return;
+        ev.preventDefault();
+        ev.stopPropagation();
+        if (this._historyIndex === undefined) {
+            if (direction < 0)
+                return;
+            else
+                this._historyIndex = -1;
+        }
+        const newIndex = this._historyIndex + direction;
+        if (newIndex >= 0 && newIndex < this._history.length) {
+            this._historyIndex = newIndex;
+            if (this._historyIndex >= 0)
+                this.textBox.textbox.value = this._history[newIndex];
+        }
+    }
+    resetHistoryIndex() {
+        this._historyIndex = undefined;
+    }
+    pushHistory(keyin) {
+        if (undefined === this._history)
+            return;
+        this.textBox.textbox.value = "";
+        this.resetHistoryIndex();
+        if (this._history.length === 0 || keyin.toLowerCase() !== this._history[0].toLowerCase()) {
+            this._history.unshift(keyin);
+            if (this._history.length > this._historyLength)
+                this._history.pop();
+        }
+    }
+    async submitKeyin() {
+        this.selectAll();
+        const textBox = this.textBox.textbox;
+        const input = textBox.value;
+        this.pushHistory(input);
+        let message;
+        try {
+            switch (await IModelApp.tools.parseAndRun(input)) {
+                case ParseAndRunResult.ToolNotFound:
+                    message = `Cannot find a key-in that matches: ${input}`;
+                    break;
+                case ParseAndRunResult.BadArgumentCount:
+                    message = "Incorrect number of arguments";
+                    break;
+                case ParseAndRunResult.FailedToRun:
+                    message = "Key-in failed to run";
+                    break;
+            }
+        }
+        catch (ex) {
+            message = `Key-in produced exception: ${ex}`;
+        }
+        if (undefined !== message)
+            await IModelApp.notifications.openMessageBox(MessageBoxType.MediumAlert, message, MessageBoxIconType.Warning);
+    }
+    respondToKeyinFocus() {
+        this.resetHistoryIndex();
+        // Handle case in which new tools were registered since we last populated the auto-complete list.
+        // This can occur e.g. as a result of loading a extension, or deferred initialization of a package like markup.
+        const keyins = this.findKeyins();
+        if (keyins.length > this.keyins.length) {
+            const newKeyins = [];
+            for (const keyin of keyins)
+                if (!this.keyins.includes(keyin)) {
+                    newKeyins.push(keyin);
+                    this.keyins.push(keyin);
+                }
+            if (newKeyins.length > 0)
+                appendDataListEntries(this.autoCompleteList, keyinsToDataListEntries(newKeyins));
+        }
+    }
+    findKeyins() {
+        const keyins = [];
+        const tools = IModelApp.tools.getToolList();
+        for (const tool of tools) {
+            switch (this._localization) {
+                case KeyinFieldLocalization.Localized:
+                    keyins.push(tool.keyin);
+                    break;
+                case KeyinFieldLocalization.Both:
+                    keyins.push(tool.keyin);
+                    if (tool.keyin === tool.englishKeyin)
+                        break;
+                /* falls through */
+                default:
+                case KeyinFieldLocalization.NonLocalized:
+                    keyins.push(tool.englishKeyin);
+                    break;
+            }
+        }
+        return keyins;
+    }
+}
 //# sourceMappingURL=KeyinField.js.map

package/lib/esm/widgets/KeyinField.js.map

@@ -1 +1 @@
-{"version":3,"file":"KeyinField.js","sourceRoot":"","sources":["../../../src/widgets/KeyinField.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\r\n/** @packageDocumentation\r\n * @module Widgets\r\n */\r\n\r\nimport { IModelApp, MessageBoxIconType, MessageBoxType, ParseAndRunResult } from \"@itwin/core-frontend\";\r\nimport { createButton } from \"../ui/Button\";\r\nimport { appendDataListEntries, createDataList, DataList, DataListEntry } from \"../ui/DataList\";\r\nimport { createTextBox, TextBox } from \"../ui/TextBox\";\r\n\r\nfunction keyinsToDataListEntries(keyins: string[]): DataListEntry[] {\r\n  const entries: DataListEntry[] = [];\r\n  for (const keyin of keyins) {\r\n    entries.push({ value: keyin });\r\n  }\r\n\r\n  return entries;\r\n}\r\n\r\n/** Controls whether localized and/or non-localized key-in strings appear in a KeyinField's auto-completion list.\r\n * @beta\r\n */\r\nexport enum KeyinFieldLocalization {\r\n  /** Include only non-localized key-in strings. */\r\n  NonLocalized,\r\n  /** Include only localized key-in strings. */\r\n  Localized,\r\n  /** Include localized and non-localized strings for each key-in. */\r\n  Both,\r\n}\r\n\r\n/** Properties controlling how a KeyinField is created.\r\n * @beta\r\n */\r\nexport interface KeyinFieldProps {\r\n  /** If supplied, the keyin field's elements will be added as children of this parent element. */\r\n  parent?: HTMLElement;\r\n  /** Required, unique ID prefix used to produce unique IDs for child elements. */\r\n  baseId: string;\r\n  /** Default: false. */\r\n  wantButton?: boolean;\r\n  /** Default: false. */\r\n  wantLabel?: boolean;\r\n  /** The maximum number of submitted key-ins to store in the history.\r\n   * If greater than zero, pressing up/down while the KeyinField has focus will move backwards/forwards through the history.\r\n   * Default: zero;\r\n   */\r\n  historyLength?: number;\r\n  /** Controls whether localized and/or non-localized keyin strings appear in the autocompletion list.\r\n   * Note: the KeyinField will still accept either localized or non-localized strings; this option only controls what is displayed in the auto-completion list.\r\n   * Default: non-localized\r\n   */\r\n  localization?: KeyinFieldLocalization;\r\n}\r\n\r\n/** A textbox allowing input of key-ins (localized tool names) combined with a drop-down that lists all registered key-ins, filtered by substring match on the current input.\r\n * Press `enter` or click the Enter button to run the key-in.\r\n * @beta\r\n */\r\nexport class KeyinField {\r\n  /** @alpha */\r\n  public readonly autoCompleteList: DataList;\r\n  public readonly textBox: TextBox;\r\n  public readonly keyins: string[];\r\n  private _historyIndex?: number;\r\n  private _historyLength = 0;\r\n  private readonly _history: string[] | undefined;\r\n  private readonly _localization: KeyinFieldLocalization;\r\n\r\n  public constructor(props: KeyinFieldProps) {\r\n    this._localization = props.localization ?? KeyinFieldLocalization.NonLocalized;\r\n    this.keyins = this.findKeyins();\r\n    const autoCompleteListId = `${props.baseId}_autoComplete`;\r\n    this.autoCompleteList = createDataList({\r\n      parent: props.parent,\r\n      entries: keyinsToDataListEntries(this.keyins),\r\n      id: autoCompleteListId,\r\n      inline: true,\r\n    });\r\n\r\n    this.textBox = createTextBox({\r\n      label: props.wantLabel ? \"Key-in: \" : undefined,\r\n      id: `${props.baseId}_textBox`,\r\n      parent: props.parent,\r\n      handler: () => this.selectAll(),\r\n      keypresshandler: async (_tb, ev) => { await this.handleKeyPress(ev); },\r\n      focushandler: (_tb) => { this.respondToKeyinFocus(); },\r\n      tooltip: \"Type the key-in text here\",\r\n      inline: true,\r\n      list: autoCompleteListId,\r\n    });\r\n\r\n    if (props.wantButton) {\r\n      createButton({\r\n        handler: async (_bt) => { await this.submitKeyin(); },\r\n        parent: props.parent,\r\n        value: \"Enter\",\r\n        inline: true,\r\n        tooltip: \"Click here to execute the key-in\",\r\n      });\r\n    }\r\n\r\n    if (undefined !== props.historyLength && props.historyLength > 0) {\r\n      this.textBox.textbox.onkeydown = (ev) => this.handleKeyDown(ev); // eslint-disable-line @typescript-eslint/promise-function-async\r\n      this._historyLength = props.historyLength;\r\n      this._history = [];\r\n    }\r\n  }\r\n\r\n  public focus() { this.textBox.textbox.focus(); }\r\n  public loseFocus() { this.textBox.textbox.blur(); }\r\n\r\n  public selectAll(): void {\r\n    this.textBox.textbox.setSelectionRange(0, this.textBox.textbox.value.length);\r\n  }\r\n\r\n  private async handleKeyPress(ev: KeyboardEvent): Promise<void> {\r\n    ev.stopPropagation();\r\n\r\n    if (\"Enter\" === ev.key)\r\n      await this.submitKeyin();\r\n  }\r\n\r\n  private async handleKeyDown(ev: KeyboardEvent): Promise<void> {\r\n    ev.stopPropagation();\r\n\r\n    if (undefined === this._history || 0 === this._history.length)\r\n      return;\r\n\r\n    // NB: History list is ordered by most to least recent so moving \"backwards\" means incrementing the index.\r\n    const direction = ev.key === \"ArrowDown\" ? 1 : (ev.key === \"ArrowUp\" ? 1 : 0);\r\n    if (0 === direction)\r\n      return;\r\n\r\n    ev.preventDefault();\r\n    ev.stopPropagation();\r\n\r\n    if (this._historyIndex === undefined) {\r\n      if (direction < 0)\r\n        return;\r\n      else\r\n        this._historyIndex = -1;\r\n    }\r\n\r\n    const newIndex = this._historyIndex + direction;\r\n    if (newIndex >= 0 && newIndex < this._history.length) {\r\n      this._historyIndex = newIndex;\r\n      if (this._historyIndex >= 0)\r\n        this.textBox.textbox.value = this._history[newIndex];\r\n    }\r\n  }\r\n\r\n  private resetHistoryIndex(): void {\r\n    this._historyIndex = undefined;\r\n  }\r\n\r\n  private pushHistory(keyin: string): void {\r\n    if (undefined === this._history)\r\n      return;\r\n\r\n    this.textBox.textbox.value = \"\";\r\n    this.resetHistoryIndex();\r\n    if (this._history.length === 0 || keyin.toLowerCase() !== this._history[0].toLowerCase()) {\r\n      this._history.unshift(keyin);\r\n      if (this._history.length > this._historyLength)\r\n        this._history.pop();\r\n    }\r\n  }\r\n\r\n  private async submitKeyin(): Promise<void> {\r\n    this.selectAll();\r\n    const textBox = this.textBox.textbox;\r\n\r\n    const input = textBox.value;\r\n    this.pushHistory(input);\r\n\r\n    let message: string | undefined;\r\n    try {\r\n      switch (await IModelApp.tools.parseAndRun(input)) {\r\n        case ParseAndRunResult.ToolNotFound:\r\n          message = `Cannot find a key-in that matches: ${input}`;\r\n          break;\r\n        case ParseAndRunResult.BadArgumentCount:\r\n          message = \"Incorrect number of arguments\";\r\n          break;\r\n        case ParseAndRunResult.FailedToRun:\r\n          message = \"Key-in failed to run\";\r\n          break;\r\n      }\r\n    } catch (ex) {\r\n      message = `Key-in produced exception: ${ex}`;\r\n    }\r\n\r\n    if (undefined !== message)\r\n      await IModelApp.notifications.openMessageBox(MessageBoxType.MediumAlert, message, MessageBoxIconType.Warning);\r\n  }\r\n\r\n  private respondToKeyinFocus() {\r\n    this.resetHistoryIndex();\r\n\r\n    // Handle case in which new tools were registered since we last populated the auto-complete list.\r\n    // This can occur e.g. as a result of loading a extension, or deferred initialization of a package like markup.\r\n    const keyins = this.findKeyins();\r\n    if (keyins.length > this.keyins.length) {\r\n      const newKeyins: string[] = [];\r\n      for (const keyin of keyins)\r\n        if (!this.keyins.includes(keyin)) {\r\n          newKeyins.push(keyin);\r\n          this.keyins.push(keyin);\r\n        }\r\n\r\n      if (newKeyins.length > 0)\r\n        appendDataListEntries(this.autoCompleteList, keyinsToDataListEntries(newKeyins));\r\n    }\r\n  }\r\n\r\n  private findKeyins(): string[] {\r\n    const keyins: string[] = [];\r\n    const tools = IModelApp.tools.getToolList();\r\n    for (const tool of tools) {\r\n      switch (this._localization) {\r\n        case KeyinFieldLocalization.Localized:\r\n          keyins.push(tool.keyin);\r\n          break;\r\n        case KeyinFieldLocalization.Both:\r\n          keyins.push(tool.keyin);\r\n          if (tool.keyin === tool.englishKeyin)\r\n            break;\r\n        /* falls through */\r\n        default:\r\n        case KeyinFieldLocalization.NonLocalized:\r\n          keyins.push(tool.englishKeyin);\r\n          break;\r\n      }\r\n    }\r\n\r\n    return keyins;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"KeyinField.js","sourceRoot":"","sources":["../../../src/widgets/KeyinField.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\r\n/** @packageDocumentation\r\n * @module Widgets\r\n */\r\n\r\nimport { IModelApp, MessageBoxIconType, MessageBoxType, ParseAndRunResult } from \"@itwin/core-frontend\";\r\nimport { createButton } from \"../ui/Button\";\r\nimport { appendDataListEntries, createDataList, DataList, DataListEntry } from \"../ui/DataList\";\r\nimport { createTextBox, TextBox } from \"../ui/TextBox\";\r\n\r\nfunction keyinsToDataListEntries(keyins: string[]): DataListEntry[] {\r\n  const entries: DataListEntry[] = [];\r\n  for (const keyin of keyins) {\r\n    entries.push({ value: keyin });\r\n  }\r\n\r\n  return entries;\r\n}\r\n\r\n/** Controls whether localized and/or non-localized key-in strings appear in a KeyinField's auto-completion list.\r\n * @beta\r\n */\r\nexport enum KeyinFieldLocalization {\r\n  /** Include only non-localized key-in strings. */\r\n  NonLocalized,\r\n  /** Include only localized key-in strings. */\r\n  Localized,\r\n  /** Include localized and non-localized strings for each key-in. */\r\n  Both,\r\n}\r\n\r\n/** Properties controlling how a KeyinField is created.\r\n * @beta\r\n */\r\nexport interface KeyinFieldProps {\r\n  /** If supplied, the keyin field's elements will be added as children of this parent element. */\r\n  parent?: HTMLElement;\r\n  /** Required, unique ID prefix used to produce unique IDs for child elements. */\r\n  baseId: string;\r\n  /** Default: false. */\r\n  wantButton?: boolean;\r\n  /** Default: false. */\r\n  wantLabel?: boolean;\r\n  /** The maximum number of submitted key-ins to store in the history.\r\n   * If greater than zero, pressing up/down while the KeyinField has focus will move backwards/forwards through the history.\r\n   * Default: zero;\r\n   */\r\n  historyLength?: number;\r\n  /** Controls whether localized and/or non-localized keyin strings appear in the autocompletion list.\r\n   * Note: the KeyinField will still accept either localized or non-localized strings; this option only controls what is displayed in the auto-completion list.\r\n   * Default: non-localized\r\n   */\r\n  localization?: KeyinFieldLocalization;\r\n}\r\n\r\n/** A textbox allowing input of key-ins (localized tool names) combined with a drop-down that lists all registered key-ins, filtered by substring match on the current input.\r\n * Press `enter` or click the Enter button to run the key-in.\r\n * @beta\r\n */\r\nexport class KeyinField {\r\n  /** @alpha */\r\n  public readonly autoCompleteList: DataList;\r\n  public readonly textBox: TextBox;\r\n  public readonly keyins: string[];\r\n  private _historyIndex?: number;\r\n  private _historyLength = 0;\r\n  private readonly _history: string[] | undefined;\r\n  private readonly _localization: KeyinFieldLocalization;\r\n\r\n  public constructor(props: KeyinFieldProps) {\r\n    this._localization = props.localization ?? KeyinFieldLocalization.NonLocalized;\r\n    this.keyins = this.findKeyins();\r\n    const autoCompleteListId = `${props.baseId}_autoComplete`;\r\n    this.autoCompleteList = createDataList({\r\n      parent: props.parent,\r\n      entries: keyinsToDataListEntries(this.keyins),\r\n      id: autoCompleteListId,\r\n      inline: true,\r\n    });\r\n\r\n    this.textBox = createTextBox({\r\n      label: props.wantLabel ? \"Key-in: \" : undefined,\r\n      id: `${props.baseId}_textBox`,\r\n      parent: props.parent,\r\n      handler: () => this.selectAll(),\r\n      keypresshandler: async (_tb, ev) => { await this.handleKeyPress(ev); },\r\n      focushandler: (_tb) => { this.respondToKeyinFocus(); },\r\n      tooltip: \"Type the key-in text here\",\r\n      inline: true,\r\n      list: autoCompleteListId,\r\n    });\r\n\r\n    if (props.wantButton) {\r\n      createButton({\r\n        handler: async (_bt) => { await this.submitKeyin(); },\r\n        parent: props.parent,\r\n        value: \"Enter\",\r\n        inline: true,\r\n        tooltip: \"Click here to execute the key-in\",\r\n      });\r\n    }\r\n\r\n    if (undefined !== props.historyLength && props.historyLength > 0) {\r\n      this.textBox.textbox.onkeydown = (ev) => this.handleKeyDown(ev); // eslint-disable-line @typescript-eslint/promise-function-async\r\n      this._historyLength = props.historyLength;\r\n      this._history = [];\r\n    }\r\n  }\r\n\r\n  public focus() { this.textBox.textbox.focus(); }\r\n  public loseFocus() { this.textBox.textbox.blur(); }\r\n\r\n  public selectAll(): void {\r\n    this.textBox.textbox.setSelectionRange(0, this.textBox.textbox.value.length);\r\n  }\r\n\r\n  private async handleKeyPress(ev: KeyboardEvent): Promise<void> {\r\n    ev.stopPropagation();\r\n\r\n    if (\"Enter\" === ev.key)\r\n      await this.submitKeyin();\r\n  }\r\n\r\n  private async handleKeyDown(ev: KeyboardEvent): Promise<void> {\r\n    ev.stopPropagation();\r\n\r\n    if (undefined === this._history || 0 === this._history.length)\r\n      return;\r\n\r\n    // NB: History list is ordered by most to least recent so moving \"backwards\" means incrementing the index.\r\n    const direction = ev.key === \"ArrowDown\" ? 1 : (ev.key === \"ArrowUp\" ? 1 : 0);\r\n    if (0 === direction)\r\n      return;\r\n\r\n    ev.preventDefault();\r\n    ev.stopPropagation();\r\n\r\n    if (this._historyIndex === undefined) {\r\n      if (direction < 0)\r\n        return;\r\n      else\r\n        this._historyIndex = -1;\r\n    }\r\n\r\n    const newIndex = this._historyIndex + direction;\r\n    if (newIndex >= 0 && newIndex < this._history.length) {\r\n      this._historyIndex = newIndex;\r\n      if (this._historyIndex >= 0)\r\n        this.textBox.textbox.value = this._history[newIndex];\r\n    }\r\n  }\r\n\r\n  private resetHistoryIndex(): void {\r\n    this._historyIndex = undefined;\r\n  }\r\n\r\n  private pushHistory(keyin: string): void {\r\n    if (undefined === this._history)\r\n      return;\r\n\r\n    this.textBox.textbox.value = \"\";\r\n    this.resetHistoryIndex();\r\n    if (this._history.length === 0 || keyin.toLowerCase() !== this._history[0].toLowerCase()) {\r\n      this._history.unshift(keyin);\r\n      if (this._history.length > this._historyLength)\r\n        this._history.pop();\r\n    }\r\n  }\r\n\r\n  private async submitKeyin(): Promise<void> {\r\n    this.selectAll();\r\n    const textBox = this.textBox.textbox;\r\n\r\n    const input = textBox.value;\r\n    this.pushHistory(input);\r\n\r\n    let message: string | undefined;\r\n    try {\r\n      switch (await IModelApp.tools.parseAndRun(input)) {\r\n        case ParseAndRunResult.ToolNotFound:\r\n          message = `Cannot find a key-in that matches: ${input}`;\r\n          break;\r\n        case ParseAndRunResult.BadArgumentCount:\r\n          message = \"Incorrect number of arguments\";\r\n          break;\r\n        case ParseAndRunResult.FailedToRun:\r\n          message = \"Key-in failed to run\";\r\n          break;\r\n      }\r\n    } catch (ex) {\r\n      message = `Key-in produced exception: ${ex}`;\r\n    }\r\n\r\n    if (undefined !== message)\r\n      await IModelApp.notifications.openMessageBox(MessageBoxType.MediumAlert, message, MessageBoxIconType.Warning);\r\n  }\r\n\r\n  private respondToKeyinFocus() {\r\n    this.resetHistoryIndex();\r\n\r\n    // Handle case in which new tools were registered since we last populated the auto-complete list.\r\n    // This can occur e.g. as a result of loading a extension, or deferred initialization of a package like markup.\r\n    const keyins = this.findKeyins();\r\n    if (keyins.length > this.keyins.length) {\r\n      const newKeyins: string[] = [];\r\n      for (const keyin of keyins)\r\n        if (!this.keyins.includes(keyin)) {\r\n          newKeyins.push(keyin);\r\n          this.keyins.push(keyin);\r\n        }\r\n\r\n      if (newKeyins.length > 0)\r\n        appendDataListEntries(this.autoCompleteList, keyinsToDataListEntries(newKeyins));\r\n    }\r\n  }\r\n\r\n  private findKeyins(): string[] {\r\n    const keyins: string[] = [];\r\n    const tools = IModelApp.tools.getToolList();\r\n    for (const tool of tools) {\r\n      switch (this._localization) {\r\n        case KeyinFieldLocalization.Localized:\r\n          keyins.push(tool.keyin);\r\n          break;\r\n        case KeyinFieldLocalization.Both:\r\n          keyins.push(tool.keyin);\r\n          if (tool.keyin === tool.englishKeyin)\r\n            break;\r\n        /* falls through */\r\n        default:\r\n        case KeyinFieldLocalization.NonLocalized:\r\n          keyins.push(tool.englishKeyin);\r\n          break;\r\n      }\r\n    }\r\n\r\n    return keyins;\r\n  }\r\n}\r\n"]}

package/lib/esm/widgets/MemoryTracker.d.ts

@@ -1,28 +1,28 @@
-import { Viewport } from "@itwin/core-frontend";
-/** @internal */
-export declare function formatMemory(numBytes: number): string;
-/** Displays GPU memory allocated to tile trees - either all tile trees in the system, or only those associated with a specific Viewport.
- * @beta
- */
-export declare class MemoryTracker {
-    private readonly _stats;
-    private readonly _vp;
-    private readonly _div;
-    private _curIntervalId?;
-    private _memIndex;
-    private readonly _totalElem;
-    private readonly _totalTreesElem;
-    private readonly _purgeButton;
-    private readonly _textures;
-    private readonly _buffers;
-    constructor(parent: HTMLElement, vp: Viewport);
-    dispose(): void;
-    private addSelector;
-    private addPurgeButton;
-    private addStatistics;
-    private clearInterval;
-    private change;
-    private update;
-    private purge;
-}
+import { Viewport } from "@itwin/core-frontend";
+/** @internal */
+export declare function formatMemory(numBytes: number): string;
+/** Displays GPU memory allocated to tile trees - either all tile trees in the system, or only those associated with a specific Viewport.
+ * @beta
+ */
+export declare class MemoryTracker {
+    private readonly _stats;
+    private readonly _vp;
+    private readonly _div;
+    private _curIntervalId?;
+    private _memIndex;
+    private readonly _totalElem;
+    private readonly _totalTreesElem;
+    private readonly _purgeButton;
+    private readonly _textures;
+    private readonly _buffers;
+    constructor(parent: HTMLElement, vp: Viewport);
+    dispose(): void;
+    private addSelector;
+    private addPurgeButton;
+    private addStatistics;
+    private clearInterval;
+    private change;
+    private update;
+    private purge;
+}
 //# sourceMappingURL=MemoryTracker.d.ts.map