@itwin/imodel-components-react 3.0.0-dev.77 → 3.0.0-dev.81

package/lib/esm/imodel-components-react/color/ColorPickerPanel.scss

@@ -0,0 +1,94 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+@import "~@itwin/core-react/lib/cjs/core-react/index";
+
+$hovered-icon-color: $buic-foreground-primary-tone;
+$saturation-hue-height: 150px;
+
+.components-colorpicker-panel {
+  display: flex;
+  flex-direction: column;
+
+  .components-colorpicker-panel-color {
+    display: flex;
+    flex-direction: row;
+    height: 100%;
+    column-gap: 20px;
+
+    .components-colorpicker-saturation {
+      margin: 1em;
+      display: block;
+      width: calc(100% - 40px);
+      height: $saturation-hue-height;
+    }
+
+    .components-hue-container-vertical {
+      height: $saturation-hue-height;
+      margin-top: 1em;
+      margin-right: .5em;
+    }
+  }
+
+  .components-color-swatch {
+    width: 2.0em;
+    height: 2.0em;
+  }
+}
+
+.components-colorpicker-panel-presets {
+  width: 100%;
+  height: 100%;
+  padding-top: 10px;
+  margin-top: 10px;
+  margin-bottom: 10px;
+  display: grid;
+  grid-template-columns: 1fr 1fr 1fr 1fr 1fr 1fr 1fr 1fr;
+  column-gap: 2px;
+  row-gap: 10px;
+  border-top: 1px solid $buic-inputs-border;
+  justify-items: center;
+
+  .components-colorpicker-panel-swatch {
+    width: 2em;
+    height: 2em;
+    padding: 0;
+    border-color: $buic-inputs-border;
+  }
+}
+
+.components-colorpicker-popup-panel-padding {
+  display: flex;
+  flex-direction: column;
+
+  button.core-dialog-close {
+    margin-left: auto;
+    background: transparent;
+    border: none;
+    color: var(--buic-foreground-body);
+  }
+}
+
+.components-colorpicker-input-panel {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: space-evenly;
+
+  .components-colorpicker-input-value-wrapper {
+    align-items: center;
+    display: flex;
+    flex-direction: row;
+    gap: 4px;
+
+    .uicore-inputs-labeled-input {
+      text-align: right;
+      margin: 0;
+    }
+
+    .core-number-input-container {
+      width: 54px;
+    }
+  }
+}

package/lib/esm/imodel-components-react/color/ColorPickerPopup.d.ts

@@ -0,0 +1,44 @@
+/** @packageDocumentation
+ * @module Color
+ */
+import * as React from "react";
+import { ColorDef } from "@itwin/core-common";
+import { RelativePosition } from "@itwin/appui-abstract";
+import { CommonProps } from "@itwin/core-react";
+import "./ColorPickerPopup.scss";
+/** Properties for the [[ColorPickerPopup]] React component
+ * @public
+ */
+export interface ColorPickerPopupProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, CommonProps {
+    /** Current color */
+    initialColor: ColorDef;
+    /** Preset colors. Pass undefined to show default preset colors. Pass empty array to show no presets. */
+    colorDefs?: ColorDef[];
+    /** Function to call when the color value is changed */
+    onColorChange?: ((newColor: ColorDef) => void) | undefined;
+    /** Function to call when the popup is closed */
+    onClose?: ((colorValue: ColorDef) => void) | undefined;
+    /** Disabled or not */
+    disabled?: boolean;
+    /** Readonly or not, color displayed on button but button will not trigger pop-up */
+    readonly?: boolean;
+    /** popup position. If not set RelativePosition.BottomLeft is used */
+    popupPosition?: RelativePosition;
+    /** Provides ability to return reference to HTMLButtonElement */
+    ref?: React.Ref<HTMLButtonElement>;
+    /** If true show up/down caret next to color  */
+    showCaret?: boolean;
+    /** If true, don't propagate clicks out of the ColorPicker */
+    captureClicks?: boolean;
+    /** If true, don't show close button at top */
+    hideCloseButton?: boolean;
+    /** If set show either HSL or RGB input values */
+    colorInputType?: "HSL" | "RGB";
+}
+/**
+ * ColorPickerButton component that allows user to select a color from a set of color swatches or to define a new color.
+ * @note Using forwardRef so the ColorEditor (Type Editor) can access the ref of the button element inside this component.
+ * @public
+ */
+export declare const ColorPickerPopup: (props: ColorPickerPopupProps) => JSX.Element | null;
+//# sourceMappingURL=ColorPickerPopup.d.ts.map

package/lib/esm/imodel-components-react/color/ColorPickerPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPickerPopup.d.ts","sourceRoot":"","sources":["../../../../src/imodel-components-react/color/ColorPickerPopup.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAe,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA+B,MAAM,mBAAmB,CAAC;AAG7E,OAAO,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,WAAW;IACvG,oBAAoB;IACpB,YAAY,EAAE,QAAQ,CAAC;IACvB,wGAAwG;IACxG,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3D,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvD,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,gEAAgE;IAChE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAChC;AA4GD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,GAAG,CAAC,OAAO,GAAG,IAAiC,CAAC"}

package/lib/esm/imodel-components-react/color/ColorPickerPopup.js

@@ -0,0 +1,94 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Color
+ */
+// cSpell:ignore colorpicker
+import * as React from "react";
+import classnames from "classnames";
+import { ColorByName, ColorDef } from "@itwin/core-common";
+import { RelativePosition } from "@itwin/appui-abstract";
+import { Popup, useRefs, WebFontIcon } from "@itwin/core-react";
+import { ColorPickerPanel } from "./ColorPickerPanel";
+import "./ColorPickerPopup.scss";
+import { getCSSColorFromDef } from "./getCSSColorFromDef";
+// Defined using following pattern (const ColorPickerPopup at bottom) to ensure useful API documentation is extracted
+const ForwardRefColorPickerPopup = React.forwardRef(function ForwardRefColorPickerPopup(props, ref) {
+    const target = React.useRef();
+    const refs = useRefs(target, ref); // combine ref needed for target with the forwardRef needed by the Parent when parent is a Type Editor.
+    const [showPopup, setShowPopup] = React.useState(false);
+    const [colorDef, setColorDef] = React.useState(props.initialColor);
+    const initialColorRef = React.useRef(props.initialColor);
+    React.useEffect(() => {
+        if (props.initialColor !== initialColorRef.current) {
+            initialColorRef.current = props.initialColor;
+            setColorDef(props.initialColor);
+        }
+    }, [props.initialColor]);
+    const defaultColors = React.useRef([
+        ColorDef.create(ColorByName.red),
+        ColorDef.create(ColorByName.orange),
+        ColorDef.create(ColorByName.yellow),
+        ColorDef.create(ColorByName.green),
+        ColorDef.create(ColorByName.blue),
+        ColorDef.create(ColorByName.indigo),
+        ColorDef.create(ColorByName.violet),
+        ColorDef.create(ColorByName.black),
+        ColorDef.create(ColorByName.white),
+        ColorDef.create(ColorByName.cyan),
+        ColorDef.create(ColorByName.fuchsia),
+        ColorDef.create(ColorByName.tan),
+        ColorDef.create(ColorByName.gray),
+        ColorDef.create(ColorByName.brown),
+        ColorDef.create(ColorByName.purple),
+        ColorDef.create(ColorByName.olive),
+    ]);
+    // istanbul ignore next
+    const closePopup = React.useCallback(() => {
+        props.onClose && props.onClose(colorDef);
+        setShowPopup(false);
+    }, [colorDef, props]);
+    const togglePopup = React.useCallback(() => {
+        setShowPopup(!showPopup);
+    }, [showPopup]);
+    const handleColorChanged = React.useCallback((newColor) => {
+        // istanbul ignore else
+        if (!newColor.equals(colorDef)) {
+            setColorDef(newColor);
+            // istanbul ignore else
+            props.onColorChange && props.onColorChange(newColor);
+        }
+    }, [colorDef, props]);
+    const rgbaString = getCSSColorFromDef(colorDef);
+    const buttonStyle = { ...props.style };
+    const swatchStyle = { backgroundColor: rgbaString };
+    const buttonClassNames = classnames("components-colorpicker-popup-button", props.readonly && "readonly", props.className);
+    const clickHandler = (event) => {
+        // istanbul ignore else
+        if (props.captureClicks)
+            event.stopPropagation();
+    };
+    const colorOptions = props.colorDefs && props.colorDefs.length ? props.colorDefs : defaultColors.current;
+    const popupPosition = undefined !== props.popupPosition ? props.popupPosition : RelativePosition.BottomLeft;
+    return (
+    /* eslint-disable-next-line jsx-a11y/no-static-element-interactions, jsx-a11y/click-events-have-key-events */
+    React.createElement("div", { onClick: clickHandler },
+        React.createElement("button", { "data-testid": "components-colorpicker-popup-button", onClick: togglePopup, className: buttonClassNames, style: buttonStyle, disabled: props.disabled, ref: refs },
+            React.createElement("div", { className: "components-colorpicker-button-container" },
+                React.createElement("div", { className: "components-colorpicker-button-color-swatch", style: swatchStyle }),
+                props.showCaret && React.createElement(WebFontIcon, { className: "components-caret", iconName: showPopup ? "icon-caret-up" : "icon-caret-down", iconSize: "x-small" }))),
+        React.createElement(Popup, { className: "components-colorpicker-popup", isOpen: showPopup, position: popupPosition, onClose: closePopup, target: target.current, closeOnNestedPopupOutsideClick: true },
+            React.createElement("div", { className: "components-colorpicker-popup-panel-padding" },
+                !props.hideCloseButton &&
+                    React.createElement("button", { className: "core-focus-trap-ignore-initial core-dialog-close icon icon-close", "data-testid": "core-dialog-close", onClick: togglePopup }),
+                React.createElement(ColorPickerPanel, { colorInputType: props.colorInputType, activeColor: colorDef, colorPresets: colorOptions, onColorChange: handleColorChanged })))));
+});
+/**
+ * ColorPickerButton component that allows user to select a color from a set of color swatches or to define a new color.
+ * @note Using forwardRef so the ColorEditor (Type Editor) can access the ref of the button element inside this component.
+ * @public
+ */
+export const ColorPickerPopup = ForwardRefColorPickerPopup;
+//# sourceMappingURL=ColorPickerPopup.js.map

package/lib/esm/imodel-components-react/color/ColorPickerPopup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPickerPopup.js","sourceRoot":"","sources":["../../../../src/imodel-components-react/color/ColorPickerPopup.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Color\n */\n\n// cSpell:ignore colorpicker\n\nimport * as React from \"react\";\nimport classnames from \"classnames\";\nimport { ColorByName, ColorDef } from \"@itwin/core-common\";\nimport { RelativePosition } from \"@itwin/appui-abstract\";\nimport { CommonProps, Popup, useRefs, WebFontIcon } from \"@itwin/core-react\";\nimport { ColorPickerPanel } from \"./ColorPickerPanel\";\n\nimport \"./ColorPickerPopup.scss\";\nimport { getCSSColorFromDef } from \"./getCSSColorFromDef\";\n\n/** Properties for the [[ColorPickerPopup]] React component\n * @public\n */\nexport interface ColorPickerPopupProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, CommonProps {\n  /** Current color */\n  initialColor: ColorDef;\n  /** Preset colors. Pass undefined to show default preset colors. Pass empty array to show no presets. */\n  colorDefs?: ColorDef[];\n  /** Function to call when the color value is changed */\n  onColorChange?: ((newColor: ColorDef) => void) | undefined;\n  /** Function to call when the popup is closed */\n  onClose?: ((colorValue: ColorDef) => void) | undefined;\n  /** Disabled or not */\n  disabled?: boolean;\n  /** Readonly or not, color displayed on button but button will not trigger pop-up */\n  readonly?: boolean;\n  /** popup position. If not set RelativePosition.BottomLeft is used */\n  popupPosition?: RelativePosition;\n  /** Provides ability to return reference to HTMLButtonElement */\n  ref?: React.Ref<HTMLButtonElement>;\n  /** If true show up/down caret next to color  */\n  showCaret?: boolean;\n  /** If true, don't propagate clicks out of the ColorPicker */\n  captureClicks?: boolean;\n  /** If true, don't show close button at top */\n  hideCloseButton?: boolean;\n  /** If set show either HSL or RGB input values */\n  colorInputType?: \"HSL\" | \"RGB\";\n}\n\n// Defined using following pattern (const ColorPickerPopup at bottom) to ensure useful API documentation is extracted\n\nconst ForwardRefColorPickerPopup = React.forwardRef<HTMLButtonElement, ColorPickerPopupProps>(\n  function ForwardRefColorPickerPopup(props, ref) {\n    const target = React.useRef<HTMLButtonElement>();\n    const refs = useRefs(target, ref);  // combine ref needed for target with the forwardRef needed by the Parent when parent is a Type Editor.\n    const [showPopup, setShowPopup] = React.useState(false);\n    const [colorDef, setColorDef] = React.useState(props.initialColor);\n    const initialColorRef = React.useRef(props.initialColor);\n\n    React.useEffect(() => {\n      if (props.initialColor !== initialColorRef.current) {\n        initialColorRef.current = props.initialColor;\n        setColorDef(props.initialColor);\n      }\n    }, [props.initialColor]);\n\n    const defaultColors = React.useRef(\n      [\n        ColorDef.create(ColorByName.red),\n        ColorDef.create(ColorByName.orange),\n        ColorDef.create(ColorByName.yellow),\n        ColorDef.create(ColorByName.green),\n        ColorDef.create(ColorByName.blue),\n        ColorDef.create(ColorByName.indigo),\n        ColorDef.create(ColorByName.violet),\n        ColorDef.create(ColorByName.black),\n        ColorDef.create(ColorByName.white),\n        ColorDef.create(ColorByName.cyan),\n        ColorDef.create(ColorByName.fuchsia),\n        ColorDef.create(ColorByName.tan),\n        ColorDef.create(ColorByName.gray),\n        ColorDef.create(ColorByName.brown),\n        ColorDef.create(ColorByName.purple),\n        ColorDef.create(ColorByName.olive),\n      ]);\n\n    // istanbul ignore next\n    const closePopup = React.useCallback(() => {\n      props.onClose && props.onClose(colorDef);\n      setShowPopup(false);\n    }, [colorDef, props]);\n\n    const togglePopup = React.useCallback(() => {\n      setShowPopup(!showPopup);\n    }, [showPopup]);\n\n    const handleColorChanged = React.useCallback((newColor: ColorDef) => {\n      // istanbul ignore else\n      if (!newColor.equals(colorDef)) {\n        setColorDef(newColor);\n\n        // istanbul ignore else\n        props.onColorChange && props.onColorChange(newColor);\n      }\n    }, [colorDef, props]);\n\n    const rgbaString = getCSSColorFromDef(colorDef);\n\n    const buttonStyle = { ...props.style } as React.CSSProperties;\n    const swatchStyle = { backgroundColor: rgbaString } as React.CSSProperties;\n    const buttonClassNames = classnames(\"components-colorpicker-popup-button\",\n      props.readonly && \"readonly\",\n      props.className,\n    );\n\n    const clickHandler = (event: React.MouseEvent) => {\n      // istanbul ignore else\n      if (props.captureClicks)\n        event.stopPropagation();\n    };\n\n    const colorOptions = props.colorDefs && props.colorDefs.length ? props.colorDefs : defaultColors.current;\n    const popupPosition = undefined !== props.popupPosition ? props.popupPosition : RelativePosition.BottomLeft;\n    return (\n      /* eslint-disable-next-line jsx-a11y/no-static-element-interactions, jsx-a11y/click-events-have-key-events */\n      <div onClick={clickHandler}>\n        <button data-testid=\"components-colorpicker-popup-button\" onClick={togglePopup} className={buttonClassNames} style={buttonStyle} disabled={props.disabled} ref={refs} >\n          <div className=\"components-colorpicker-button-container\">\n            <div className=\"components-colorpicker-button-color-swatch\" style={swatchStyle} />\n            {props.showCaret && <WebFontIcon className=\"components-caret\" iconName={showPopup ? \"icon-caret-up\" : \"icon-caret-down\"} iconSize=\"x-small\" />}\n          </div>\n        </button>\n        <Popup\n          className=\"components-colorpicker-popup\"\n          isOpen={showPopup}\n          position={popupPosition}\n          onClose={closePopup}\n          target={target.current}\n          closeOnNestedPopupOutsideClick\n        >\n          <div className=\"components-colorpicker-popup-panel-padding\">\n            {!props.hideCloseButton &&\n              <button\n                className={\"core-focus-trap-ignore-initial core-dialog-close icon icon-close\"}\n                data-testid=\"core-dialog-close\"\n                onClick={togglePopup}\n              />}\n            <ColorPickerPanel colorInputType={props.colorInputType} activeColor={colorDef} colorPresets={colorOptions} onColorChange={handleColorChanged} />\n          </div>\n        </Popup>\n      </div>\n    );\n  }\n);\n\n/**\n * ColorPickerButton component that allows user to select a color from a set of color swatches or to define a new color.\n * @note Using forwardRef so the ColorEditor (Type Editor) can access the ref of the button element inside this component.\n * @public\n */\nexport const ColorPickerPopup: (props: ColorPickerPopupProps) => JSX.Element | null = ForwardRefColorPickerPopup;\n"]}

package/lib/esm/imodel-components-react/color/ColorPickerPopup.scss

@@ -0,0 +1,53 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+@import "~@itwin/core-react/lib/cjs/core-react/style/themecolors";
+@import "~@itwin/itwinui-css/scss/style/typography";
+
+button.components-colorpicker-popup-button {
+  font-family: $iui-font-family;
+  font-size: $iui-font-size;
+  color: $buic-foreground-body;
+  background-color: transparent;
+  box-sizing: border-box;
+  border-radius: 3px;
+  border: none;
+  padding: 0;
+
+  &:not(.readonly) {
+    cursor: pointer;
+  }
+
+  >.components-colorpicker-button-container {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+
+    >.components-colorpicker-button-color-swatch {
+      border: 1px solid $buic-inputs-border;
+      border-radius: 3px;
+      width: 1.25em;
+      height: 1.25em;
+    }
+
+    >.components-caret {
+      margin-left: .25em;
+      margin-right: .25em;
+    }
+  }
+
+  &:disabled {
+    pointer-events: none;
+
+    >.components-colorpicker-button-container {
+      >.components-caret {
+        color: $buic-icon-color-disabled;
+      }
+    }
+  }
+}
+
+.components-colorpicker-popup-panel-padding {
+  padding: 6px;
+}

package/lib/esm/imodel-components-react/color/HueSlider.d.ts

@@ -0,0 +1,23 @@
+/** @packageDocumentation
+ * @module Color
+ */
+import "./HueSlider.scss";
+import * as React from "react";
+import { HSVColor } from "@itwin/core-common";
+import { CommonProps } from "@itwin/core-react";
+/** Properties for the [[HueSlider]] React component
+ * @beta
+ */
+export interface HueSliderProps extends React.HTMLAttributes<HTMLDivElement>, CommonProps {
+    /** true if slider is oriented horizontal, else vertical orientation is assumed */
+    isHorizontal?: boolean;
+    /** function to run when user hue is changed */
+    onHueChange?: ((hue: HSVColor) => void) | undefined;
+    /** HSV Color Value */
+    hsv: HSVColor;
+}
+/** HueSlider component used to set the hue value.
+ * @beta
+ */
+export declare function HueSlider({ isHorizontal, onHueChange, hsv, className, style }: HueSliderProps): JSX.Element;
+//# sourceMappingURL=HueSlider.d.ts.map

package/lib/esm/imodel-components-react/color/HueSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HueSlider.d.ts","sourceRoot":"","sources":["../../../../src/imodel-components-react/color/HueSlider.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAyDhD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW;IACvF,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,sBAAsB;IACtB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,cAAc,eAwI7F"}

package/lib/esm/imodel-components-react/color/HueSlider.js

@@ -0,0 +1,174 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Color
+ */
+import "./HueSlider.scss";
+import classnames from "classnames";
+import * as React from "react";
+import { SpecialKey } from "@itwin/appui-abstract";
+import { UiIModelComponents } from "../UiIModelComponents";
+// hue is a value from 0 to 360
+function calculateHue(currentPos, high, isVertical) {
+    // istanbul ignore next
+    if (currentPos <= 0) {
+        return isVertical ? 359 : 0;
+    }
+    else if (currentPos >= high) {
+        return isVertical ? 0 : 359;
+    }
+    else {
+        let percent = ((currentPos * 100) / high);
+        if (isVertical)
+            percent = 100 - percent;
+        return Math.round(((359 * percent) / 100));
+    }
+}
+function calculateChange(currentHue, e, isHorizontal, container) {
+    const { width: containerWidth, height: containerHeight, top: containerTop, left: containerLeft } = container.getBoundingClientRect();
+    let x;
+    if ("pageX" in e) {
+        x = e.pageX;
+    }
+    else {
+        // istanbul ignore if
+        if (undefined === e.touches || 0 === e.touches.length)
+            return currentHue;
+        x = e.touches[0].pageX;
+    }
+    // istanbul ignore if
+    if (undefined === x)
+        return currentHue;
+    let y;
+    if ("pageY" in e) {
+        y = e.pageY;
+    }
+    else {
+        // istanbul ignore if
+        if (undefined === e.touches || 0 === e.touches.length)
+            return currentHue;
+        y = e.touches[0].pageY;
+    }
+    // istanbul ignore if
+    if (undefined === y)
+        return currentHue;
+    const pointerX = x - (containerLeft + window.scrollX);
+    const pointerY = y - (containerTop + window.scrollY);
+    if (!isHorizontal) { // vertical
+        return calculateHue(pointerY, containerHeight, true);
+    }
+    else { // horizontal
+        return calculateHue(pointerX, containerWidth, false);
+    }
+}
+/** HueSlider component used to set the hue value.
+ * @beta
+ */
+export function HueSlider({ isHorizontal, onHueChange, hsv, className, style }) {
+    const container = React.useRef(null);
+    const [hueLabel] = React.useState(() => UiIModelComponents.translate("color.hue"));
+    const isDragging = React.useRef(false);
+    const onChange = React.useCallback((e) => {
+        // istanbul ignore else
+        if (container.current) {
+            const newHue = calculateChange(hsv.h, e, !!isHorizontal, container.current);
+            // istanbul ignore else
+            const newColor = hsv.clone(newHue);
+            // istanbul ignore else
+            if (onHueChange)
+                onHueChange(newColor);
+        }
+    }, [isHorizontal, hsv, onHueChange]);
+    const onDragging = React.useCallback((e) => {
+        // istanbul ignore else
+        if (isDragging.current) {
+            onChange(e);
+        }
+    }, [onChange]);
+    const onMouseUp = React.useCallback(() => {
+        // istanbul ignore else
+        if (isDragging.current) {
+            isDragging.current = false;
+        }
+    }, []);
+    const onTouchEnd = React.useCallback((event) => {
+        event.preventDefault();
+        // istanbul ignore else
+        if (isDragging.current) {
+            onChange(event);
+            isDragging.current = false;
+        }
+    }, [onChange]);
+    const onMouseDown = React.useCallback((e) => {
+        e.preventDefault();
+        // istanbul ignore else
+        if (e.target !== e.currentTarget) {
+            // istanbul ignore else
+            if (!isDragging.current) {
+                document.addEventListener("mouseup", onMouseUp, { capture: true, once: true });
+                isDragging.current = true;
+            }
+        }
+        onChange(e);
+        // istanbul ignore else
+        if (container.current)
+            container.current.focus();
+    }, [onChange, onMouseUp]);
+    const onTouchStart = React.useCallback((e) => {
+        // istanbul ignore else
+        if (e.target !== e.currentTarget)
+            isDragging.current = true;
+        onChange(e);
+        // istanbul ignore else
+        if (container.current)
+            container.current.focus();
+    }, [onChange]);
+    const onKeyDown = React.useCallback((evt) => {
+        let newHue;
+        const hueValue = hsv.h;
+        if (evt.key === SpecialKey.ArrowLeft || evt.key === SpecialKey.ArrowDown) {
+            newHue = hueValue - (evt.ctrlKey ? 10 : 1);
+        }
+        else if (evt.key === SpecialKey.ArrowRight || evt.key === SpecialKey.ArrowUp) {
+            newHue = hueValue + (evt.ctrlKey ? 10 : 1);
+        }
+        else if (evt.key === SpecialKey.PageDown) {
+            newHue = hueValue - (evt.ctrlKey ? 180 : 60);
+        }
+        else if (evt.key === SpecialKey.PageUp) {
+            newHue = hueValue + (evt.ctrlKey ? 180 : 60);
+        }
+        else if (evt.key === SpecialKey.Home) {
+            newHue = 0;
+        }
+        else {
+            // istanbul ignore else
+            if (evt.key === SpecialKey.End) {
+                newHue = 359;
+            }
+        }
+        // istanbul ignore else
+        if (undefined !== newHue) {
+            // istanbul ignore if
+            if (newHue > 359)
+                newHue = 359; // 360 is same as zero
+            // istanbul ignore if
+            if (newHue < 0)
+                newHue = 0;
+            const newColor = hsv.clone(newHue);
+            // istanbul ignore else
+            if (onHueChange)
+                onHueChange(newColor);
+            evt.preventDefault();
+        }
+    }, [hsv, onHueChange]);
+    const containerClasses = classnames(isHorizontal ? "components-hue-container-horizontal" : "components-hue-container-vertical", className);
+    const pointerStyle = isHorizontal ? { left: `${(hsv.h * 100) / 360}%`, backgroundColor: `hsl(${hsv.h} ,100%, 50%)` } :
+        { left: `0px`, top: `${-((hsv.h * 100) / 360) + 100}%`, backgroundColor: `hsl(${hsv.h} ,100%, 50%)` };
+    return (React.createElement("div", { className: containerClasses, style: style, "data-testid": "hue-container" },
+        React.createElement("div", { "data-testid": "hue-slider", role: "slider", "aria-label": hueLabel, "aria-valuemin": 0, "aria-valuemax": 360, "aria-valuenow": hsv.h, className: "components-hue-slider", ref: container, onMouseDown: onMouseDown, onMouseMove: onDragging, onTouchMove: onDragging, onMouseUp: onMouseUp, onTouchStart: onTouchStart, onTouchEnd: onTouchEnd, tabIndex: 0, onKeyDown: onKeyDown },
+            React.createElement("div", { style: pointerStyle, className: "components-hue-pointer", "data-testid": "hue-pointer" }))));
+}
+//# sourceMappingURL=HueSlider.js.map

package/lib/esm/imodel-components-react/color/HueSlider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HueSlider.js","sourceRoot":"","sources":["../../../../src/imodel-components-react/color/HueSlider.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Color\n */\n\nimport \"./HueSlider.scss\";\nimport classnames from \"classnames\";\nimport * as React from \"react\";\nimport { HSVColor } from \"@itwin/core-common\";\nimport { SpecialKey } from \"@itwin/appui-abstract\";\nimport { CommonProps } from \"@itwin/core-react\";\nimport { UiIModelComponents } from \"../UiIModelComponents\";\n\n// hue is a value from 0 to 360\nfunction calculateHue(currentPos: number, high: number, isVertical: boolean) {\n  // istanbul ignore next\n  if (currentPos <= 0) {\n    return isVertical ? 359 : 0;\n  } else if (currentPos >= high) {\n    return isVertical ? 0 : 359;\n  } else {\n    let percent = ((currentPos * 100) / high);\n    if (isVertical)\n      percent = 100 - percent;\n    return Math.round(((359 * percent) / 100));\n  }\n}\n\nfunction calculateChange(currentHue: number, e: React.MouseEvent<HTMLDivElement> | React.TouchEvent<HTMLDivElement>, isHorizontal: boolean, container: HTMLDivElement) {\n  const { width: containerWidth, height: containerHeight, top: containerTop, left: containerLeft } = container.getBoundingClientRect();\n\n  let x: number | undefined;\n  if (\"pageX\" in e) {\n    x = e.pageX;\n  } else {\n    // istanbul ignore if\n    if (undefined === e.touches || 0 === e.touches.length)\n      return currentHue;\n    x = e.touches[0].pageX;\n  }\n  // istanbul ignore if\n  if (undefined === x)\n    return currentHue;\n\n  let y: number | undefined;\n  if (\"pageY\" in e) {\n    y = e.pageY;\n  } else {\n    // istanbul ignore if\n    if (undefined === e.touches || 0 === e.touches.length)\n      return currentHue;\n    y = e.touches[0].pageY;\n  }\n  // istanbul ignore if\n  if (undefined === y)\n    return currentHue;\n\n  const pointerX = x - (containerLeft + window.scrollX);\n  const pointerY = y - (containerTop + window.scrollY);\n\n  if (!isHorizontal) { // vertical\n    return calculateHue(pointerY, containerHeight, true);\n  } else {  // horizontal\n    return calculateHue(pointerX, containerWidth, false);\n  }\n}\n\n/** Properties for the [[HueSlider]] React component\n * @beta\n */\nexport interface HueSliderProps extends React.HTMLAttributes<HTMLDivElement>, CommonProps {\n  /** true if slider is oriented horizontal, else vertical orientation is assumed */\n  isHorizontal?: boolean;\n  /** function to run when user hue is changed */\n  onHueChange?: ((hue: HSVColor) => void) | undefined;\n  /** HSV Color Value */\n  hsv: HSVColor;\n}\n\n/** HueSlider component used to set the hue value.\n * @beta\n */\nexport function HueSlider({ isHorizontal, onHueChange, hsv, className, style }: HueSliderProps) {\n  const container = React.useRef<HTMLDivElement>(null);\n  const [hueLabel] = React.useState(() => UiIModelComponents.translate(\"color.hue\"));\n  const isDragging = React.useRef(false);\n\n  const onChange = React.useCallback((e: React.MouseEvent<HTMLDivElement> | React.TouchEvent<HTMLDivElement>) => {\n    // istanbul ignore else\n    if (container.current) {\n      const newHue = calculateChange(hsv.h, e, !!isHorizontal, container.current);\n      // istanbul ignore else\n      const newColor = hsv.clone(newHue);\n      // istanbul ignore else\n      if (onHueChange)\n        onHueChange(newColor);\n    }\n  }, [isHorizontal, hsv, onHueChange]);\n\n  const onDragging = React.useCallback((e: React.MouseEvent<HTMLDivElement> | React.TouchEvent<HTMLDivElement>) => {\n    // istanbul ignore else\n    if (isDragging.current) {\n      onChange(e);\n    }\n  }, [onChange]);\n\n  const onMouseUp = React.useCallback(() => {\n    // istanbul ignore else\n    if (isDragging.current) {\n      isDragging.current = false;\n    }\n  }, []);\n\n  const onTouchEnd = React.useCallback((event: React.TouchEvent<HTMLDivElement>) => {\n    event.preventDefault();\n\n    // istanbul ignore else\n    if (isDragging.current) {\n      onChange(event);\n      isDragging.current = false;\n    }\n  }, [onChange]);\n\n  const onMouseDown = React.useCallback((e: React.MouseEvent<HTMLDivElement>) => {\n    e.preventDefault();\n\n    // istanbul ignore else\n    if (e.target !== e.currentTarget) {\n      // istanbul ignore else\n      if (!isDragging.current) {\n        document.addEventListener(\"mouseup\", onMouseUp, { capture: true, once: true });\n        isDragging.current = true;\n      }\n    }\n\n    onChange(e);\n\n    // istanbul ignore else\n    if (container.current)\n      container.current.focus();\n  }, [onChange, onMouseUp]);\n\n  const onTouchStart = React.useCallback((e: React.TouchEvent<HTMLDivElement>) => {\n    // istanbul ignore else\n    if (e.target !== e.currentTarget)\n      isDragging.current = true;\n\n    onChange(e);\n\n    // istanbul ignore else\n    if (container.current)\n      container.current.focus();\n  }, [onChange]);\n\n  const onKeyDown = React.useCallback((evt: React.KeyboardEvent<HTMLDivElement>) => {\n    let newHue: number | undefined;\n    const hueValue = hsv.h;\n    if (evt.key === SpecialKey.ArrowLeft || evt.key === SpecialKey.ArrowDown) {\n      newHue = hueValue - (evt.ctrlKey ? 10 : 1);\n    } else if (evt.key === SpecialKey.ArrowRight || evt.key === SpecialKey.ArrowUp) {\n      newHue = hueValue + (evt.ctrlKey ? 10 : 1);\n    } else if (evt.key === SpecialKey.PageDown) {\n      newHue = hueValue - (evt.ctrlKey ? 180 : 60);\n    } else if (evt.key === SpecialKey.PageUp) {\n      newHue = hueValue + (evt.ctrlKey ? 180 : 60);\n    } else if (evt.key === SpecialKey.Home) {\n      newHue = 0;\n    } else {\n      // istanbul ignore else\n      if (evt.key === SpecialKey.End) {\n        newHue = 359;\n      }\n    }\n\n    // istanbul ignore else\n    if (undefined !== newHue) {\n      // istanbul ignore if\n      if (newHue > 359) newHue = 359; // 360 is same as zero\n      // istanbul ignore if\n      if (newHue < 0) newHue = 0;\n\n      const newColor = hsv.clone(newHue);\n      // istanbul ignore else\n      if (onHueChange)\n        onHueChange(newColor);\n      evt.preventDefault();\n    }\n  }, [hsv, onHueChange]);\n\n  const containerClasses = classnames(\n    isHorizontal ? \"components-hue-container-horizontal\" : \"components-hue-container-vertical\",\n    className,\n  );\n\n  const pointerStyle: React.CSSProperties = isHorizontal ? { left: `${(hsv.h * 100) / 360}%`, backgroundColor: `hsl(${hsv.h} ,100%, 50%)` } :\n    { left: `0px`, top: `${-((hsv.h * 100) / 360) + 100}%`, backgroundColor: `hsl(${hsv.h} ,100%, 50%)` };\n\n  return (\n    <div className={containerClasses} style={style} data-testid=\"hue-container\" >\n      <div\n        data-testid=\"hue-slider\"\n        role=\"slider\" aria-label={hueLabel}\n        aria-valuemin={0} aria-valuemax={360} aria-valuenow={hsv.h}\n        className=\"components-hue-slider\"\n        ref={container}\n        onMouseDown={onMouseDown}\n        onMouseMove={onDragging}\n        onTouchMove={onDragging}\n        onMouseUp={onMouseUp}\n        onTouchStart={onTouchStart}\n        onTouchEnd={onTouchEnd}\n        tabIndex={0}\n        onKeyDown={onKeyDown}\n      >\n        <div style={pointerStyle} className=\"components-hue-pointer\" data-testid=\"hue-pointer\" />\n      </div>\n    </div >\n  );\n}\n"]}

package/lib/esm/imodel-components-react/color/HueSlider.scss

@@ -0,0 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+.components-hue-pointer {
+  position: absolute;
+  width: 1.2em;
+  height: 1.2em;
+  border-radius: 50%;
+  box-shadow: rgba(0, 0, 0, 0.37) 0px 1px 4px 0px;
+
+  &:focus {
+    outline: none;
+    border: none;
+  }
+}
+
+.components-hue-container-horizontal {
+  width: 100%;
+  height: .5em;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  .components-hue-slider {
+    position: relative;
+    width: 100%;
+    height: 100%;
+    border-radius: 1em;
+    background: linear-gradient(to right, #f00 0%, #ff0 17%, #0f0 33%, #0ff 50%, #00f 67%, #f0f 83%, #f00 100%);
+  }
+
+  .components-hue-pointer {
+    transform: translate(-.6em, -.45em);
+    cursor: pointer;
+    border: 1px solid #fff;
+  }
+}
+
+.components-hue-container-vertical {
+  width: .5em;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+
+  .components-hue-slider {
+    position: relative;
+    width: 100%;
+    height: 100%;
+    border-radius: 1em;
+    background: linear-gradient(to top, #f00 0%, #ff0 17%, #0f0 33%,
+      #0ff 50%, #00f 67%, #f0f 83%, #f00 100%);
+  }
+
+  .components-hue-pointer {
+    transform: translate(-.45em, -.6em);
+    cursor: pointer;
+    border: 1px solid #fff;
+  }
+}

package/lib/esm/imodel-components-react/color/SaturationPicker.d.ts

@@ -0,0 +1,21 @@
+/** @packageDocumentation
+ * @module Color
+ */
+import "./SaturationPicker.scss";
+import * as React from "react";
+import { HSVColor } from "@itwin/core-common";
+import { CommonProps } from "@itwin/core-react";
+/** Properties for the [[SaturationPicker]] React component
+ * @beta
+ */
+export interface SaturationPickerProps extends React.HTMLAttributes<HTMLDivElement>, CommonProps {
+    /** function to run when user selects location in saturation region */
+    onSaturationChange?: ((saturation: HSVColor) => void) | undefined;
+    /** HSV Color Value */
+    hsv: HSVColor;
+}
+/** SaturationPicker component used to set the saturation value.
+ * @beta
+ */
+export declare function SaturationPicker({ onSaturationChange, hsv, className, style }: SaturationPickerProps): JSX.Element;
+//# sourceMappingURL=SaturationPicker.d.ts.map

package/lib/esm/imodel-components-react/color/SaturationPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaturationPicker.d.ts","sourceRoot":"","sources":["../../../../src/imodel-components-react/color/SaturationPicker.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,yBAAyB,CAAC;AAEjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAY,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgEhD;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW;IAC9F,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClE,sBAAsB;IACtB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,qBAAqB,eA6IpG"}