@itwin/imodel-components-react 4.0.0-dev.10 → 4.0.0-dev.11

package/lib/esm/imodel-components-react/inputs/QuantityNumberInput.d.ts

@@ -1,45 +1,45 @@
-/** @packageDocumentation
- * @module Inputs
- */
-import "./QuantityNumberInput.scss";
-import * as React from "react";
-import { QuantityTypeArg } from "@itwin/core-frontend";
-import { InputProps } from "@itwin/itwinui-react";
-/** Step function prototype for [[QuantityNumberInput]] component
- * @beta
- */
-export declare type StepFunctionProp = number | ((direction: string) => number | undefined);
-/** Properties for the [[QuantityNumberInput]] component
- * @beta
- */
-export interface QuantityNumberInputProps extends Omit<InputProps, "value" | "min" | "max" | "step" | "onFocus" | "onChange"> {
-    /** Initial magnitude in 'persistence' units. See `getPersistenceUnitByQuantityType` in [QuantityFormatter]($core-frontend).
-     * Set to `undefined` to show placeholder text */
-    persistenceValue?: number;
-    /** CSS class name for the QuantityNumberInput component container div */
-    containerClassName?: string;
-    /** number or function	Number.MIN_SAFE_INTEGER */
-    min?: number;
-    /** number or function	defaults to Number.MAX_SAFE_INTEGER */
-    max?: number;
-    /** increment step value used while incrementing or decrementing (up/down buttons or arrow keys) defaults to 1. */
-    step?: StepFunctionProp;
-    /** Set to true to "snap" to the closest step value while incrementing or decrementing (up/down buttons or arrow keys). */
-    snap?: boolean;
-    /** Function to call when the quantity value is changed. The value returned will be in 'persistence' units. */
-    onChange?: (value: number) => void;
-    /** if true up/down buttons are shown larger and side by side */
-    showTouchButtons?: boolean;
-    /** Provides ability to return reference to HTMLInputElement */
-    ref?: React.Ref<HTMLInputElement>;
-    /** Type of quantity being input. */
-    quantityType: QuantityTypeArg;
-}
-/** The QuantityNumberInput component accepts input for quantity values. The quantity value is shown as a single numeric value and the quantity's
- * "display" unit is shown next to the input control. The "display" unit is determined by the active unit system as defined by the [QuantityFormatter]($frontend).
- * The control also display buttons to increment and decrement the "displayed" value. The value reported by via the onChange function is in "persistence"
- * units that can be stored in the iModel.
- * @beta
- */
-export declare const QuantityNumberInput: (props: QuantityNumberInputProps) => JSX.Element | null;
+/** @packageDocumentation
+ * @module Inputs
+ */
+import "./QuantityNumberInput.scss";
+import * as React from "react";
+import { QuantityTypeArg } from "@itwin/core-frontend";
+import { InputProps } from "@itwin/itwinui-react";
+/** Step function prototype for [[QuantityNumberInput]] component
+ * @beta
+ */
+export declare type StepFunctionProp = number | ((direction: string) => number | undefined);
+/** Properties for the [[QuantityNumberInput]] component
+ * @beta
+ */
+export interface QuantityNumberInputProps extends Omit<InputProps, "value" | "min" | "max" | "step" | "onFocus" | "onChange"> {
+    /** Initial magnitude in 'persistence' units. See `getPersistenceUnitByQuantityType` in [QuantityFormatter]($core-frontend).
+     * Set to `undefined` to show placeholder text */
+    persistenceValue?: number;
+    /** CSS class name for the QuantityNumberInput component container div */
+    containerClassName?: string;
+    /** number or function	Number.MIN_SAFE_INTEGER */
+    min?: number;
+    /** number or function	defaults to Number.MAX_SAFE_INTEGER */
+    max?: number;
+    /** increment step value used while incrementing or decrementing (up/down buttons or arrow keys) defaults to 1. */
+    step?: StepFunctionProp;
+    /** Set to true to "snap" to the closest step value while incrementing or decrementing (up/down buttons or arrow keys). */
+    snap?: boolean;
+    /** Function to call when the quantity value is changed. The value returned will be in 'persistence' units. */
+    onChange?: (value: number) => void;
+    /** if true up/down buttons are shown larger and side by side */
+    showTouchButtons?: boolean;
+    /** Provides ability to return reference to HTMLInputElement */
+    ref?: React.Ref<HTMLInputElement>;
+    /** Type of quantity being input. */
+    quantityType: QuantityTypeArg;
+}
+/** The QuantityNumberInput component accepts input for quantity values. The quantity value is shown as a single numeric value and the quantity's
+ * "display" unit is shown next to the input control. The "display" unit is determined by the active unit system as defined by the [QuantityFormatter]($frontend).
+ * The control also display buttons to increment and decrement the "displayed" value. The value reported by via the onChange function is in "persistence"
+ * units that can be stored in the iModel.
+ * @beta
+ */
+export declare const QuantityNumberInput: (props: QuantityNumberInputProps) => JSX.Element | null;
 //# sourceMappingURL=QuantityNumberInput.d.ts.map

package/lib/esm/imodel-components-react/inputs/QuantityNumberInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuantityNumberInput.d.ts","sourceRoot":"","sources":["../../../../src/imodel-components-react/inputs/QuantityNumberInput.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAyC,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE9F,OAAO,EAAS,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,oBAAY,gBAAgB,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3H;qDACiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kHAAkH;IAClH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,0HAA0H;IAC1H,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAClC,oCAAoC;IACpC,YAAY,EAAE,eAAe,CAAC;CAC/B;AA8QD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,GAAG,CAAC,OAAO,GAAG,IAAoC,CAAC"}
+{"version":3,"file":"QuantityNumberInput.d.ts","sourceRoot":"","sources":["../../../../src/imodel-components-react/inputs/QuantityNumberInput.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAyC,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE9F,OAAO,EAAS,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;GAEG;AACH,oBAAY,gBAAgB,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3H;qDACiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kHAAkH;IAClH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,0HAA0H;IAC1H,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAClC,oCAAoC;IACpC,YAAY,EAAE,eAAe,CAAC;CAC/B;AAkRD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,GAAG,CAAC,OAAO,GAAG,IAAoC,CAAC"}

package/lib/esm/imodel-components-react/inputs/QuantityNumberInput.js

@@ -1,241 +1,244 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Inputs
- */
-import "./QuantityNumberInput.scss";
-import classnames from "classnames";
-import * as React from "react";
-import { WebFontIcon } from "@itwin/core-react";
-import { SpecialKey } from "@itwin/appui-abstract";
-import { IModelApp } from "@itwin/core-frontend";
-import { DecimalPrecision, FormatterSpec, FormatTraits, FormatType, Parser } from "@itwin/core-quantity";
-import { Input } from "@itwin/itwinui-react";
-/** adjust formatter spec to show only primary unit without a label.  */
-function adjustFormatterSpec(formatterSpec) {
-    if (undefined === formatterSpec)
-        return formatterSpec;
-    const singleUnitConversion = [];
-    singleUnitConversion.push(formatterSpec.unitConversions[0]);
-    const newFormat = formatterSpec.format.clone({
-        showOnlyPrimaryUnit: true,
-        traits: formatterSpec.format.formatTraits & ~FormatTraits.ShowUnitLabel,
-        type: FormatType.Decimal,
-        precision: FormatType.Decimal !== formatterSpec.format.type ? DecimalPrecision.Four : formatterSpec.format.precision,
-    });
-    return new FormatterSpec("single-value", newFormat, singleUnitConversion, formatterSpec.persistenceUnit);
-}
-function convertValueFromDisplayToPersistence(value, unitConversions, unit) {
-    // istanbul ignore next
-    if (!unitConversions || 0 === unitConversions.length)
-        return value;
-    const unitConversion = unitConversions.find((spec) => spec.name === unit.name);
-    // istanbul ignore next
-    if (!unitConversion)
-        return value;
-    const convertedValue = (value * unitConversion.conversion.factor) + unitConversion.conversion.offset;
-    return convertedValue;
-}
-function getUnitLabel(parserSpec) {
-    if (undefined === parserSpec)
-        return "";
-    const format = parserSpec.format;
-    // istanbul ignore else
-    if (!format.units || !format.units[0])
-        return parserSpec.outUnit.label;
-    const [unit, label] = format.units[0];
-    // istanbul ignore next
-    return label !== null && label !== void 0 ? label : unit.label;
-}
-const ForwardRefQuantityNumberInput = React.forwardRef(function ForwardRefQuantityNumberInput(props, ref) {
-    const { containerClassName, persistenceValue, min, max, onChange, onBlur, onKeyDown, step, snap, showTouchButtons, quantityType, ...otherProps } = props;
-    const rawValueRef = React.useRef(persistenceValue);
-    const [formatterSpec, setFormatterSpec] = React.useState(() => adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
-    const [parserSpec, setParserSpec] = React.useState(() => IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
-    const formatValue = React.useCallback((value) => {
-        if (undefined === value)
-            return "";
-        // istanbul ignore else
-        if (formatterSpec) {
-            return formatterSpec.applyFormatting(value);
-        }
-        // istanbul ignore next
-        return value.toFixed(2);
-    }, [formatterSpec]);
-    const lastFormattedValueRef = React.useRef(formatValue(persistenceValue));
-    const [formattedValue, setFormattedValue] = React.useState(() => lastFormattedValueRef.current);
-    React.useEffect(() => {
-        const handleUnitSystemChanged = (() => {
-            setFormatterSpec(adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
-            setParserSpec(IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
-        });
-        IModelApp.quantityFormatter.onActiveFormattingUnitSystemChanged.addListener(handleUnitSystemChanged);
-        return () => {
-            IModelApp.quantityFormatter.onActiveFormattingUnitSystemChanged.removeListener(handleUnitSystemChanged);
-        };
-    }, [quantityType]);
-    React.useEffect(() => {
-        const handleUnitSystemChanged = ((args) => {
-            const quantityKey = IModelApp.quantityFormatter.getQuantityTypeKey(quantityType);
-            // istanbul ignore else
-            if (args.quantityType === quantityKey) {
-                setFormatterSpec(adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
-                setParserSpec(IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
-            }
-        });
-        IModelApp.quantityFormatter.onQuantityFormatsChanged.addListener(handleUnitSystemChanged);
-        return () => {
-            IModelApp.quantityFormatter.onQuantityFormatsChanged.removeListener(handleUnitSystemChanged);
-        };
-    }, [quantityType]);
-    const unitLabel = getUnitLabel(parserSpec);
-    // See if new initialValue props have changed since component mounted
-    React.useEffect(() => {
-        rawValueRef.current = persistenceValue;
-        const currentFormattedValue = formatValue(rawValueRef.current);
-        setFormattedValue(currentFormattedValue);
-    }, [formatValue, persistenceValue]);
-    // this is the unprocessed input from user, it is not processed until blur or enter key press
-    const handleDisplayValueChange = React.useCallback((event) => {
-        setFormattedValue(event.currentTarget.value);
-    }, []);
-    const updateValue = React.useCallback((newValue) => {
-        let persistedValue = newValue;
-        // istanbul ignore else
-        if (parserSpec) {
-            // convert value from display unit to persistence unit
-            const [unit] = parserSpec.format.units ? parserSpec.format.units[0] : /* istanbul ignore next */ [parserSpec.outUnit];
-            persistedValue = convertValueFromDisplayToPersistence(newValue, parserSpec.unitConversions, unit);
-            rawValueRef.current = persistedValue;
-        }
-        const newFormattedVal = formatValue(persistedValue);
-        onChange && onChange(persistedValue);
-        setFormattedValue(newFormattedVal);
-    }, [formatValue, onChange, parserSpec]);
-    /**
-   * Used internally to parse the argument x to it's numeric representation.
-   * If the argument cannot be converted to finite number returns 0; If a
-   * "precision" prop is specified uses it round the number with that
-   * precision (no fixed precision here because the return value is float, not
-   * string).
-   */
-    const parseInternal = React.useCallback((x) => {
-        if (!x)
-            return 0;
-        let n = parseFloat(x);
-        // istanbul ignore next
-        if (isNaN(n) || !isFinite(n)) {
-            n = 0;
-        }
-        const localPrecision = 6; // TODO get a reasonable value from format
-        const q = Math.pow(10, localPrecision);
-        const localMin = undefined === min ? Number.MIN_SAFE_INTEGER : min;
-        const localMax = undefined === max ? Number.MAX_SAFE_INTEGER : max;
-        n = Math.min(Math.max(n, localMin), localMax);
-        n = Math.round(n * q) / q;
-        return n;
-    }, [min, max]);
-    const updateValueFromString = React.useCallback((strValue) => {
-        // istanbul ignore else
-        if (parserSpec) {
-            const parseResult = IModelApp.quantityFormatter.parseToQuantityValue(strValue, parserSpec);
-            // at this point we should have a string value in persistence units without a label
-            if (Parser.isParsedQuantity(parseResult)) {
-                const persistedValue = parseResult.value; // in persistence units
-                // set strValue and let it go through parseInternal which will ensure min/max limits are observed
-                strValue = formatValue(persistedValue);
-            }
-            else {
-                // istanbul ignore else
-                if (rawValueRef.current) { // restore last known good value
-                    const lastKnownFormattedVal = formatValue(rawValueRef.current);
-                    setFormattedValue(lastKnownFormattedVal);
-                    return;
-                }
-            }
-        }
-        const newValue = parseInternal(strValue);
-        // istanbul ignore else
-        if (undefined !== newValue)
-            updateValue(newValue);
-    }, [formatValue, parseInternal, parserSpec, updateValue]);
-    const handleBlur = React.useCallback((event) => {
-        const newVal = parseInternal(event.target.value);
-        onBlur && onBlur(event);
-        updateValue(newVal);
-    }, [parseInternal, updateValue, onBlur]);
-    const getIncrementValue = React.useCallback((increment) => {
-        if (typeof step === "function") {
-            const stepVal = step(increment ? "up" : "down");
-            return stepVal ? stepVal : 1;
-        }
-        return !step ? 1 : step;
-    }, [step]);
-    /**
-       * The internal method that actually sets the new value on the input
-       */
-    const applyStep = React.useCallback((increment) => {
-        const incrementValue = getIncrementValue(increment);
-        let num = parseInternal(formattedValue) + (increment ? incrementValue : -incrementValue);
-        if (snap) {
-            num = Math.round(num / incrementValue) * incrementValue;
-        }
-        const localMin = undefined === min ? Number.MIN_SAFE_INTEGER : min;
-        const localMax = undefined === max ? Number.MAX_SAFE_INTEGER : max;
-        num = Math.min(Math.max(num, localMin), localMax);
-        updateValue(num);
-    }, [formattedValue, getIncrementValue, max, min, parseInternal, snap, updateValue]);
-    const handleKeyDown = React.useCallback((event) => {
-        // istanbul ignore else
-        if (event.key === SpecialKey.Enter) {
-            updateValueFromString(event.currentTarget.value);
-            event.preventDefault();
-        }
-        else if (event.key === SpecialKey.Escape) {
-            setFormattedValue(formatValue(rawValueRef.current));
-            event.preventDefault();
-        }
-        else if (event.key === SpecialKey.ArrowDown) {
-            applyStep(false);
-            event.preventDefault();
-        }
-        else if (event.key === SpecialKey.ArrowUp) {
-            applyStep(true);
-            event.preventDefault();
-        }
-        onKeyDown && onKeyDown(event);
-    }, [onKeyDown, updateValueFromString, formatValue, applyStep]);
-    const handleDownClick = React.useCallback((event) => {
-        applyStep(false);
-        event.preventDefault();
-    }, [applyStep]);
-    const handleUpClick = React.useCallback((event) => {
-        applyStep(true);
-        event.preventDefault();
-    }, [applyStep]);
-    // istanbul ignore next
-    const handleFocus = React.useCallback((event) => {
-        event.currentTarget.select();
-    }, []);
-    const isDisabled = !!otherProps.disabled;
-    const containerClasses = classnames("component-quantity-number-input-container", containerClassName, showTouchButtons && "component-number-buttons-for-touch", isDisabled && "component-quantity-number-input-disabled");
-    return (React.createElement("div", { className: containerClasses },
-        React.createElement("div", { className: "component-quantity-number-input-value-and-buttons-container" },
-            React.createElement(Input, { ref: ref, value: formattedValue, onChange: handleDisplayValueChange, onKeyDown: handleKeyDown, onBlur: handleBlur, onFocus: handleFocus, size: "small", ...otherProps }),
-            React.createElement("div", { className: classnames("component-quantity-number-input-buttons-container", showTouchButtons && "component-number-buttons-for-touch") },
-                React.createElement("div", { className: "component-quantity-number-input-button component-quantity-number-input-button-up", tabIndex: -1, onClick: handleUpClick },
-                    React.createElement(WebFontIcon, { iconName: "icon-caret-up" })),
-                React.createElement("div", { className: "component-quantity-number-input-button component-quantity-number-input-button-down", tabIndex: -1, onClick: handleDownClick },
-                    React.createElement(WebFontIcon, { iconName: "icon-caret-down" })))),
-        React.createElement("span", { className: "component-quantity-number-input-suffix" }, unitLabel)));
-});
-/** The QuantityNumberInput component accepts input for quantity values. The quantity value is shown as a single numeric value and the quantity's
- * "display" unit is shown next to the input control. The "display" unit is determined by the active unit system as defined by the [QuantityFormatter]($frontend).
- * The control also display buttons to increment and decrement the "displayed" value. The value reported by via the onChange function is in "persistence"
- * units that can be stored in the iModel.
- * @beta
- */
-export const QuantityNumberInput = ForwardRefQuantityNumberInput;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Inputs
+ */
+import "./QuantityNumberInput.scss";
+import classnames from "classnames";
+import * as React from "react";
+import { Icon } from "@itwin/core-react";
+import { SpecialKey } from "@itwin/appui-abstract";
+import { IModelApp } from "@itwin/core-frontend";
+import { DecimalPrecision, FormatterSpec, FormatTraits, FormatType, Parser } from "@itwin/core-quantity";
+import { Input } from "@itwin/itwinui-react";
+import { SvgCaretDown, SvgCaretDownSmall, SvgCaretUp, SvgCaretUpSmall } from "@itwin/itwinui-icons-react";
+/** adjust formatter spec to show only primary unit without a label.  */
+function adjustFormatterSpec(formatterSpec) {
+    if (undefined === formatterSpec)
+        return formatterSpec;
+    const singleUnitConversion = [];
+    singleUnitConversion.push(formatterSpec.unitConversions[0]);
+    const newFormat = formatterSpec.format.clone({
+        showOnlyPrimaryUnit: true,
+        traits: formatterSpec.format.formatTraits & ~FormatTraits.ShowUnitLabel,
+        type: FormatType.Decimal,
+        precision: FormatType.Decimal !== formatterSpec.format.type ? DecimalPrecision.Four : formatterSpec.format.precision,
+    });
+    return new FormatterSpec("single-value", newFormat, singleUnitConversion, formatterSpec.persistenceUnit);
+}
+function convertValueFromDisplayToPersistence(value, unitConversions, unit) {
+    // istanbul ignore next
+    if (!unitConversions || 0 === unitConversions.length)
+        return value;
+    const unitConversion = unitConversions.find((spec) => spec.name === unit.name);
+    // istanbul ignore next
+    if (!unitConversion)
+        return value;
+    const convertedValue = (value * unitConversion.conversion.factor) + unitConversion.conversion.offset;
+    return convertedValue;
+}
+function getUnitLabel(parserSpec) {
+    if (undefined === parserSpec)
+        return "";
+    const format = parserSpec.format;
+    // istanbul ignore else
+    if (!format.units || !format.units[0])
+        return parserSpec.outUnit.label;
+    const [unit, label] = format.units[0];
+    // istanbul ignore next
+    return label !== null && label !== void 0 ? label : unit.label;
+}
+const ForwardRefQuantityNumberInput = React.forwardRef(function ForwardRefQuantityNumberInput(props, ref) {
+    const { containerClassName, persistenceValue, min, max, onChange, onBlur, onKeyDown, step, snap, showTouchButtons, quantityType, ...otherProps } = props;
+    const rawValueRef = React.useRef(persistenceValue);
+    const [formatterSpec, setFormatterSpec] = React.useState(() => adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
+    const [parserSpec, setParserSpec] = React.useState(() => IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
+    const formatValue = React.useCallback((value) => {
+        if (undefined === value)
+            return "";
+        // istanbul ignore else
+        if (formatterSpec) {
+            return formatterSpec.applyFormatting(value);
+        }
+        // istanbul ignore next
+        return value.toFixed(2);
+    }, [formatterSpec]);
+    const lastFormattedValueRef = React.useRef(formatValue(persistenceValue));
+    const [formattedValue, setFormattedValue] = React.useState(() => lastFormattedValueRef.current);
+    React.useEffect(() => {
+        const handleUnitSystemChanged = (() => {
+            setFormatterSpec(adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
+            setParserSpec(IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
+        });
+        IModelApp.quantityFormatter.onActiveFormattingUnitSystemChanged.addListener(handleUnitSystemChanged);
+        return () => {
+            IModelApp.quantityFormatter.onActiveFormattingUnitSystemChanged.removeListener(handleUnitSystemChanged);
+        };
+    }, [quantityType]);
+    React.useEffect(() => {
+        const handleUnitSystemChanged = ((args) => {
+            const quantityKey = IModelApp.quantityFormatter.getQuantityTypeKey(quantityType);
+            // istanbul ignore else
+            if (args.quantityType === quantityKey) {
+                setFormatterSpec(adjustFormatterSpec(IModelApp.quantityFormatter.findFormatterSpecByQuantityType(quantityType)));
+                setParserSpec(IModelApp.quantityFormatter.findParserSpecByQuantityType(quantityType));
+            }
+        });
+        IModelApp.quantityFormatter.onQuantityFormatsChanged.addListener(handleUnitSystemChanged);
+        return () => {
+            IModelApp.quantityFormatter.onQuantityFormatsChanged.removeListener(handleUnitSystemChanged);
+        };
+    }, [quantityType]);
+    const unitLabel = getUnitLabel(parserSpec);
+    // See if new initialValue props have changed since component mounted
+    React.useEffect(() => {
+        rawValueRef.current = persistenceValue;
+        const currentFormattedValue = formatValue(rawValueRef.current);
+        setFormattedValue(currentFormattedValue);
+    }, [formatValue, persistenceValue]);
+    // this is the unprocessed input from user, it is not processed until blur or enter key press
+    const handleDisplayValueChange = React.useCallback((event) => {
+        setFormattedValue(event.currentTarget.value);
+    }, []);
+    const updateValue = React.useCallback((newValue) => {
+        let persistedValue = newValue;
+        // istanbul ignore else
+        if (parserSpec) {
+            // convert value from display unit to persistence unit
+            const [unit] = parserSpec.format.units ? parserSpec.format.units[0] : /* istanbul ignore next */ [parserSpec.outUnit];
+            persistedValue = convertValueFromDisplayToPersistence(newValue, parserSpec.unitConversions, unit);
+            rawValueRef.current = persistedValue;
+        }
+        const newFormattedVal = formatValue(persistedValue);
+        onChange && onChange(persistedValue);
+        setFormattedValue(newFormattedVal);
+    }, [formatValue, onChange, parserSpec]);
+    /**
+   * Used internally to parse the argument x to it's numeric representation.
+   * If the argument cannot be converted to finite number returns 0; If a
+   * "precision" prop is specified uses it round the number with that
+   * precision (no fixed precision here because the return value is float, not
+   * string).
+   */
+    const parseInternal = React.useCallback((x) => {
+        if (!x)
+            return 0;
+        let n = parseFloat(x);
+        // istanbul ignore next
+        if (isNaN(n) || !isFinite(n)) {
+            n = 0;
+        }
+        const localPrecision = 6; // TODO get a reasonable value from format
+        const q = Math.pow(10, localPrecision);
+        const localMin = undefined === min ? Number.MIN_SAFE_INTEGER : min;
+        const localMax = undefined === max ? Number.MAX_SAFE_INTEGER : max;
+        n = Math.min(Math.max(n, localMin), localMax);
+        n = Math.round(n * q) / q;
+        return n;
+    }, [min, max]);
+    const updateValueFromString = React.useCallback((strValue) => {
+        // istanbul ignore else
+        if (parserSpec) {
+            const parseResult = IModelApp.quantityFormatter.parseToQuantityValue(strValue, parserSpec);
+            // at this point we should have a string value in persistence units without a label
+            if (Parser.isParsedQuantity(parseResult)) {
+                const persistedValue = parseResult.value; // in persistence units
+                // set strValue and let it go through parseInternal which will ensure min/max limits are observed
+                strValue = formatValue(persistedValue);
+            }
+            else {
+                // istanbul ignore else
+                if (rawValueRef.current) { // restore last known good value
+                    const lastKnownFormattedVal = formatValue(rawValueRef.current);
+                    setFormattedValue(lastKnownFormattedVal);
+                    return;
+                }
+            }
+        }
+        const newValue = parseInternal(strValue);
+        // istanbul ignore else
+        if (undefined !== newValue)
+            updateValue(newValue);
+    }, [formatValue, parseInternal, parserSpec, updateValue]);
+    const handleBlur = React.useCallback((event) => {
+        const newVal = parseInternal(event.target.value);
+        onBlur && onBlur(event);
+        updateValue(newVal);
+    }, [parseInternal, updateValue, onBlur]);
+    const getIncrementValue = React.useCallback((increment) => {
+        if (typeof step === "function") {
+            const stepVal = step(increment ? "up" : "down");
+            return stepVal ? stepVal : 1;
+        }
+        return !step ? 1 : step;
+    }, [step]);
+    /**
+       * The internal method that actually sets the new value on the input
+       */
+    const applyStep = React.useCallback((increment) => {
+        const incrementValue = getIncrementValue(increment);
+        let num = parseInternal(formattedValue) + (increment ? incrementValue : -incrementValue);
+        if (snap) {
+            num = Math.round(num / incrementValue) * incrementValue;
+        }
+        const localMin = undefined === min ? Number.MIN_SAFE_INTEGER : min;
+        const localMax = undefined === max ? Number.MAX_SAFE_INTEGER : max;
+        num = Math.min(Math.max(num, localMin), localMax);
+        updateValue(num);
+    }, [formattedValue, getIncrementValue, max, min, parseInternal, snap, updateValue]);
+    const handleKeyDown = React.useCallback((event) => {
+        // istanbul ignore else
+        if (event.key === SpecialKey.Enter) {
+            updateValueFromString(event.currentTarget.value);
+            event.preventDefault();
+        }
+        else if (event.key === SpecialKey.Escape) {
+            setFormattedValue(formatValue(rawValueRef.current));
+            event.preventDefault();
+        }
+        else if (event.key === SpecialKey.ArrowDown) {
+            applyStep(false);
+            event.preventDefault();
+        }
+        else if (event.key === SpecialKey.ArrowUp) {
+            applyStep(true);
+            event.preventDefault();
+        }
+        onKeyDown && onKeyDown(event);
+    }, [onKeyDown, updateValueFromString, formatValue, applyStep]);
+    const handleDownClick = React.useCallback((event) => {
+        applyStep(false);
+        event.preventDefault();
+    }, [applyStep]);
+    const handleUpClick = React.useCallback((event) => {
+        applyStep(true);
+        event.preventDefault();
+    }, [applyStep]);
+    // istanbul ignore next
+    const handleFocus = React.useCallback((event) => {
+        event.currentTarget.select();
+    }, []);
+    const isDisabled = !!otherProps.disabled;
+    const containerClasses = classnames("component-quantity-number-input-container", containerClassName, showTouchButtons && "component-number-buttons-for-touch", isDisabled && "component-quantity-number-input-disabled");
+    const caretUp = showTouchButtons ? React.createElement(SvgCaretUp, null) : React.createElement(SvgCaretUpSmall, null);
+    const caretDown = showTouchButtons ? React.createElement(SvgCaretDown, null) : React.createElement(SvgCaretDownSmall, null);
+    return (React.createElement("div", { className: containerClasses },
+        React.createElement("div", { className: "component-quantity-number-input-value-and-buttons-container" },
+            React.createElement(Input, { ref: ref, value: formattedValue, onChange: handleDisplayValueChange, onKeyDown: handleKeyDown, onBlur: handleBlur, onFocus: handleFocus, size: "small", ...otherProps }),
+            React.createElement("div", { className: classnames("component-quantity-number-input-buttons-container", showTouchButtons && "component-number-buttons-for-touch") },
+                React.createElement("div", { className: "component-quantity-number-input-button component-quantity-number-input-button-up", tabIndex: -1, onClick: handleUpClick },
+                    React.createElement(Icon, { iconSpec: caretUp })),
+                React.createElement("div", { className: "component-quantity-number-input-button component-quantity-number-input-button-down", tabIndex: -1, onClick: handleDownClick },
+                    React.createElement(Icon, { iconSpec: caretDown })))),
+        React.createElement("span", { className: "component-quantity-number-input-suffix" }, unitLabel)));
+});
+/** The QuantityNumberInput component accepts input for quantity values. The quantity value is shown as a single numeric value and the quantity's
+ * "display" unit is shown next to the input control. The "display" unit is determined by the active unit system as defined by the [QuantityFormatter]($frontend).
+ * The control also display buttons to increment and decrement the "displayed" value. The value reported by via the onChange function is in "persistence"
+ * units that can be stored in the iModel.
+ * @beta
+ */
+export const QuantityNumberInput = ForwardRefQuantityNumberInput;
 //# sourceMappingURL=QuantityNumberInput.js.map