@esri/solutions-components 0.6.1 → 0.6.2

package/dist/esm/calcite-color-picker.entry.js

@@ -4,123 +4,33 @@
  * http://www.apache.org/licenses/LICENSE-2.0
  */
 import { r as registerInstance, c as createEvent, h, g as getElement } from './index-d298aca9.js';
-import { c as color } from './index-9fdcb8d3.js';
-import { i as isPrimaryPointerButton, b as getElementDir } from './dom-0fc13266.js';
-import { n as normalizeHex, C as CSSColorMode, p as parseMode, c as colorEqual } from './utils-0b3e94fe.js';
-import { u as updateHostInteraction } from './interactive-b1987dfd.js';
-import { i as isActivationKey } from './key-218d8d4d.js';
-import { c as componentLoaded, s as setUpLoadableComponent, a as setComponentLoaded } from './loadable-e6dce690.js';
-import { c as connectLocalized, d as disconnectLocalized } from './locale-aabc8f45.js';
-import { c as clamp } from './math-37b6afea.js';
-import { u as updateMessages, s as setUpMessages, c as connectMessages, d as disconnectMessages } from './t9n-a539118a.js';
+import { c as color, C as CSS, D as DEFAULT_COLOR, a as DIMENSIONS, H as HSV_LIMITS, O as OPACITY_LIMITS, b as DEFAULT_STORAGE_KEY_PREFIX, R as RGB_LIMITS } from './resources-6c49ff61.js';
+import { i as isPrimaryPointerButton, b as getElementDir } from './dom-e14bb980.js';
+import { C as CSSColorMode, n as normalizeHex, h as hexify, o as opacityToAlpha, a as alphaToOpacity, b as alphaCompatible, p as parseMode, c as colorEqual, t as toNonAlphaMode, d as normalizeAlpha, e as toAlphaMode, f as normalizeColor } from './utils-d5304067.js';
+import { u as updateHostInteraction } from './interactive-eaa1e00b.js';
+import { i as isActivationKey } from './key-2c25459c.js';
+import { c as componentLoaded, s as setUpLoadableComponent, a as setComponentLoaded } from './loadable-fca3f617.js';
+import { c as connectLocalized, d as disconnectLocalized } from './locale-b550eae4.js';
+import { c as clamp } from './math-778f9699.js';
+import { u as updateMessages, s as setUpMessages, c as connectMessages, d as disconnectMessages } from './t9n-4c43412c.js';
 import { t as throttle } from './throttle-26fa347b.js';
 import './_commonjsHelpers-d5f9d613.js';
-import './guid-2069664e.js';
-import './resources-e83f65b3.js';
-import './observers-81c91acd.js';
+import './guid-5c8ddb45.js';
+import './resources-a9874e81.js';
+import './observers-b17e5da7.js';
 import './debounce-4c884e5c.js';
 
-/*!
- * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
- * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.2.0
- */
-const CSS = {
-  container: "container",
-  controlSection: "control-section",
-  hexOptions: "color-hex-options",
-  section: "section",
-  header: "header",
-  control: "control",
-  splitSection: "section--split",
-  colorModeContainer: "color-mode-container",
-  colorMode: "color-mode",
-  channels: "channels",
-  channel: "channel",
-  savedColors: "saved-colors",
-  savedColorsSection: "saved-colors-section",
-  saveColor: "save-color",
-  deleteColor: "delete-color",
-  savedColorsButtons: "saved-colors-buttons",
-  headerHex: "header--hex",
-  colorFieldAndSlider: "color-field-and-slider",
-  colorFieldAndSliderInteractive: "color-field-and-slider--interactive",
-  colorFieldAndSliderWrap: "color-field-and-slider-wrap",
-  scope: "scope",
-  hueScope: "scope--hue",
-  colorFieldScope: "scope--color-field",
-  savedColor: "saved-color"
-};
-const DEFAULT_COLOR = color("#007AC2");
-const DEFAULT_STORAGE_KEY_PREFIX = "calcite-color-";
-const RGB_LIMITS = {
-  r: 255,
-  g: 255,
-  b: 255
-};
-const HSV_LIMITS = {
-  h: 360,
-  s: 100,
-  v: 100
-};
-const DIMENSIONS = {
-  s: {
-    slider: {
-      height: 10,
-      width: 160
-    },
-    colorField: {
-      height: 80,
-      width: 160
-    },
-    thumb: {
-      radius: 8
-    }
-  },
-  m: {
-    slider: {
-      height: 14,
-      width: 272
-    },
-    colorField: {
-      height: 150,
-      width: 272
-    },
-    thumb: {
-      radius: 10
-    }
-  },
-  l: {
-    slider: {
-      height: 16,
-      width: 464
-    },
-    colorField: {
-      height: 200,
-      width: 464
-    },
-    thumb: {
-      radius: 12
-    }
-  }
-};
-
-const colorPickerCss = "@keyframes in{0%{opacity:0}100%{opacity:1}}@keyframes in-down{0%{opacity:0;transform:translate3D(0, -5px, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-up{0%{opacity:0;transform:translate3D(0, 5px, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-scale{0%{opacity:0;transform:scale3D(0.95, 0.95, 1)}100%{opacity:1;transform:scale3D(1, 1, 1)}}:root{--calcite-animation-timing:calc(150ms * var(--calcite-internal-duration-factor));--calcite-internal-duration-factor:var(--calcite-duration-factor, 1);--calcite-internal-animation-timing-fast:calc(100ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-medium:calc(200ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-slow:calc(300ms * var(--calcite-internal-duration-factor))}.calcite-animate{opacity:0;animation-fill-mode:both;animation-duration:var(--calcite-animation-timing)}.calcite-animate__in{animation-name:in}.calcite-animate__in-down{animation-name:in-down}.calcite-animate__in-up{animation-name:in-up}.calcite-animate__in-scale{animation-name:in-scale}@media (prefers-reduced-motion: reduce){:root{--calcite-internal-duration-factor:0.01}}:root{--calcite-floating-ui-transition:var(--calcite-animation-timing);--calcite-floating-ui-z-index:600}:host([hidden]){display:none}:host([disabled]){pointer-events:none;cursor:default;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:var(--calcite-ui-opacity-disabled)}:host{display:inline-block;font-size:var(--calcite-font-size--2);line-height:1rem;font-weight:var(--calcite-font-weight-normal)}:host([disabled]) ::slotted([calcite-hydrated][disabled]),:host([disabled]) [calcite-hydrated][disabled]{opacity:1}:host([scale=s]) .container{inline-size:160px}:host([scale=s]) .saved-colors{grid-template-columns:repeat(auto-fill, minmax(20px, 1fr))}:host([scale=s]) .channels{flex-direction:column}:host([scale=s]) .channel{inline-size:100%;-webkit-margin-after:4px;margin-block-end:4px}:host([scale=s]) .channel:last-child{-webkit-margin-after:0;margin-block-end:0}:host([scale=m]) .container{inline-size:272px}:host([scale=l]) .header{-webkit-padding-after:0px;padding-block-end:0px}:host([scale=l]){font-size:var(--calcite-font-size--1);line-height:1rem}:host([scale=l]) .container{inline-size:464px}:host([scale=l]) .color-field-and-slider{-webkit-margin-after:-20px;margin-block-end:-20px}:host([scale=l]) .section{padding-block:0 16px;padding-inline:16px}:host([scale=l]) .section:first-of-type{-webkit-padding-before:16px;padding-block-start:16px}:host([scale=l]) .saved-colors{grid-template-columns:repeat(auto-fill, minmax(28px, 1fr));grid-gap:12px;-webkit-padding-before:16px;padding-block-start:16px}:host([scale=l]) .control-section{flex-wrap:nowrap;align-items:baseline}:host([scale=l]) .control-section>:nth-child(2){-webkit-margin-start:12px;margin-inline-start:12px}:host([scale=l]) .color-hex-options{display:flex;flex-shrink:1;flex-direction:column;justify-content:space-around;min-block-size:98px;inline-size:160px}:host([scale=l]) .color-mode-container{flex-shrink:3}.container{background-color:var(--calcite-ui-foreground-1);display:inline-block;border:1px solid var(--calcite-ui-border-1)}.color-field-and-slider-wrap{position:relative}.scope{pointer-events:none;position:absolute;font-size:var(--calcite-font-size--1);outline-color:transparent;outline-offset:14px}.scope:focus{outline:2px solid var(--calcite-ui-brand);outline-offset:16px}.color-field-and-slider{-webkit-margin-after:-16px;margin-block-end:-16px;touch-action:none}.color-field-and-slider--interactive{cursor:pointer}.control-section{display:flex;flex-direction:row;flex-wrap:wrap}.section{padding-block:0 12px;padding-inline:12px}.section:first-of-type{-webkit-padding-before:12px;padding-block-start:12px}.color-hex-options,.section--split{flex-grow:1}.header{display:flex;align-items:center;justify-content:space-between;-webkit-padding-after:0.25rem;padding-block-end:0.25rem;color:var(--calcite-ui-text-1)}.header--hex,.color-mode-container{-webkit-padding-before:12px;padding-block-start:12px}.channels{display:flex;justify-content:space-between}.channel{inline-size:31%}.saved-colors{-webkit-padding-before:12px;padding-block-start:12px;display:grid;grid-template-columns:repeat(auto-fill, minmax(24px, 1fr));grid-gap:8px;inline-size:100%}.saved-colors-buttons{display:flex}.saved-color{outline-offset:0;outline-color:transparent;cursor:pointer}.saved-color:focus{outline:2px solid var(--calcite-ui-brand);outline-offset:2px}.saved-color:hover{transition:outline-color var(--calcite-internal-animation-timing-fast) ease-in-out;outline:2px solid var(--calcite-ui-border-2);outline-offset:2px}";
+const colorPickerCss = "@keyframes in{0%{opacity:0}100%{opacity:1}}@keyframes in-down{0%{opacity:0;transform:translate3D(0, -5px, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-up{0%{opacity:0;transform:translate3D(0, 5px, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-right{0%{opacity:0;transform:translate3D(-5px, 0, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-left{0%{opacity:0;transform:translate3D(5px, 0, 0)}100%{opacity:1;transform:translate3D(0, 0, 0)}}@keyframes in-scale{0%{opacity:0;transform:scale3D(0.95, 0.95, 1)}100%{opacity:1;transform:scale3D(1, 1, 1)}}:root{--calcite-animation-timing:calc(150ms * var(--calcite-internal-duration-factor));--calcite-internal-duration-factor:var(--calcite-duration-factor, 1);--calcite-internal-animation-timing-fast:calc(100ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-medium:calc(200ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-slow:calc(300ms * var(--calcite-internal-duration-factor))}.calcite-animate{opacity:0;animation-fill-mode:both;animation-duration:var(--calcite-animation-timing)}.calcite-animate__in{animation-name:in}.calcite-animate__in-down{animation-name:in-down}.calcite-animate__in-up{animation-name:in-up}.calcite-animate__in-right{animation-name:in-right}.calcite-animate__in-left{animation-name:in-left}.calcite-animate__in-scale{animation-name:in-scale}@media (prefers-reduced-motion: reduce){:root{--calcite-internal-duration-factor:0.01}}:root{--calcite-floating-ui-transition:var(--calcite-animation-timing);--calcite-floating-ui-z-index:var(--calcite-app-z-index-dropdown)}:host([hidden]){display:none}:host([disabled]){cursor:default;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:var(--calcite-ui-opacity-disabled)}:host([disabled]) *,:host([disabled]) ::slotted(*){pointer-events:none}:host{display:inline-block;font-size:var(--calcite-font-size--2);line-height:1rem;font-weight:var(--calcite-font-weight-normal)}:host([disabled]) ::slotted([calcite-hydrated][disabled]),:host([disabled]) [calcite-hydrated][disabled]{opacity:1}:host([scale=s]){--calcite-color-picker-spacing:8px}:host([scale=s]) .container{inline-size:160px}:host([scale=s]) .saved-colors{gap:0.25rem;grid-template-columns:repeat(auto-fill, 20px)}:host([scale=m]){--calcite-color-picker-spacing:12px}:host([scale=m]) .container{inline-size:272px}:host([scale=l]){--calcite-color-picker-spacing:16px;font-size:var(--calcite-font-size--1);line-height:1rem}:host([scale=l]) .container{inline-size:464px}:host([scale=l]) .section:first-of-type{-webkit-padding-before:var(--calcite-color-picker-spacing);padding-block-start:var(--calcite-color-picker-spacing)}:host([scale=l]) .saved-colors{grid-template-columns:repeat(auto-fill, 32px)}:host([scale=l]) .control-section{flex-wrap:nowrap;align-items:baseline;flex-wrap:wrap}:host([scale=l]) .color-hex-options{display:flex;flex-shrink:1;flex-direction:column;justify-content:space-around}:host([scale=l]) .color-mode-container{flex-shrink:3}.container{background-color:var(--calcite-ui-foreground-1);display:inline-block;border:1px solid var(--calcite-ui-border-1)}.control-and-scope{position:relative;display:flex;cursor:pointer;touch-action:none}.scope{position:absolute;z-index:var(--calcite-app-z-index);font-size:var(--calcite-font-size--1);outline-color:transparent}.scope:focus{outline:2px solid var(--calcite-ui-focus-color, var(--calcite-ui-brand));outline-offset:calc(\n            2px *\n            calc(\n              1 -\n              2 * clamp(\n                0,\n                var(--calcite-ui-focus-offset-invert),\n                1\n              )\n            )\n          );outline-offset:16px}.hex-and-channels-group{inline-size:100%}.hex-and-channels-group,.control-section{display:flex;flex-direction:row;flex-wrap:wrap}.section{padding-block:0 var(--calcite-color-picker-spacing);padding-inline:var(--calcite-color-picker-spacing)}.section:first-of-type{-webkit-padding-before:var(--calcite-color-picker-spacing);padding-block-start:var(--calcite-color-picker-spacing)}.sliders{display:flex;flex-direction:column;justify-content:space-between;-webkit-margin-start:var(--calcite-color-picker-spacing);margin-inline-start:var(--calcite-color-picker-spacing)}.preview-and-sliders{display:flex;align-items:center;padding:var(--calcite-color-picker-spacing)}.color-hex-options,.section--split{flex-grow:1}.header{display:flex;align-items:center;justify-content:space-between;color:var(--calcite-ui-text-1)}.color-mode-container{-webkit-padding-before:var(--calcite-color-picker-spacing);padding-block-start:var(--calcite-color-picker-spacing)}.channels{display:flex;row-gap:0.125rem}.channel[data-channel-index=\"3\"]{inline-size:159px}:host([scale=s]) .channels{flex-wrap:wrap}:host([scale=s]) .channel{flex-basis:30%;flex-grow:1}:host([scale=s]) .channel[data-channel-index=\"3\"]{inline-size:unset;-webkit-margin-start:unset;margin-inline-start:unset}:host([scale=l]) .channel[data-channel-index=\"3\"]{inline-size:131px}.saved-colors{display:grid;gap:0.5rem;-webkit-padding-before:var(--calcite-color-picker-spacing);padding-block-start:var(--calcite-color-picker-spacing);grid-template-columns:repeat(auto-fill, 24px)}.saved-colors-buttons{display:flex}.saved-color{outline-offset:0;outline-color:transparent;cursor:pointer}.saved-color:focus{outline:2px solid var(--calcite-ui-brand);outline-offset:2px}.saved-color:hover{transition:outline-color var(--calcite-internal-animation-timing-fast) ease-in-out;outline:2px solid var(--calcite-ui-border-2);outline-offset:2px}";
 
 const throttleFor60FpsInMs = 16;
-const defaultValue = normalizeHex(DEFAULT_COLOR.hex());
-const defaultFormat = "auto";
 const ColorPicker = class {
   constructor(hostRef) {
     registerInstance(this, hostRef);
     this.calciteColorPickerChange = createEvent(this, "calciteColorPickerChange", 6);
     this.calciteColorPickerInput = createEvent(this, "calciteColorPickerInput", 6);
-    this.colorFieldAndSliderHovered = false;
-    this.hueThumbState = "idle";
     this.internalColorUpdateContext = null;
     this.mode = CSSColorMode.HEX;
     this.shiftKeyChannelAdjustment = 0;
-    this.sliderThumbState = "idle";
     this.handleTabActivate = (event) => {
       this.channelMode = event.currentTarget.getAttribute("data-color-mode");
       this.updateChannelsFromColor(this.color);
@@ -165,7 +75,7 @@ const ColorPicker = class {
         this.internalColorSet(null);
         return;
       }
-      const normalizedHex = color$1 && normalizeHex(color$1.hex());
+      const normalizedHex = color$1 && normalizeHex(hexify(color$1, alphaCompatible(this.mode)));
       if (hex !== normalizedHex) {
         this.internalColorSet(color(hex));
       }
@@ -177,16 +87,20 @@ const ColorPicker = class {
     this.handleChannelInput = (event) => {
       const input = event.currentTarget;
       const channelIndex = Number(input.getAttribute("data-channel-index"));
-      const limit = this.channelMode === "rgb"
-        ? RGB_LIMITS[Object.keys(RGB_LIMITS)[channelIndex]]
-        : HSV_LIMITS[Object.keys(HSV_LIMITS)[channelIndex]];
+      const isAlphaChannel = channelIndex === 3;
+      const limit = isAlphaChannel
+        ? OPACITY_LIMITS.max
+        : this.channelMode === "rgb"
+          ? RGB_LIMITS[Object.keys(RGB_LIMITS)[channelIndex]]
+          : HSV_LIMITS[Object.keys(HSV_LIMITS)[channelIndex]];
       let inputValue;
       if (this.allowEmpty && !input.value) {
         inputValue = "";
       }
       else {
-        const value = Number(input.value) + this.shiftKeyChannelAdjustment;
-        const clamped = clamp(value, 0, limit);
+        const value = Number(input.value);
+        const adjustedValue = value + this.shiftKeyChannelAdjustment;
+        const clamped = clamp(adjustedValue, 0, limit);
         inputValue = clamped.toString();
       }
       input.value = inputValue;
@@ -200,11 +114,13 @@ const ColorPicker = class {
       const channels = [...this.channels];
       const shouldClearChannels = this.allowEmpty && !input.value;
       if (shouldClearChannels) {
-        this.channels = [null, null, null];
+        this.channels = [null, null, null, null];
         this.internalColorSet(null);
         return;
       }
-      channels[channelIndex] = Number(input.value);
+      const isAlphaChannel = channelIndex === 3;
+      const value = Number(input.value);
+      channels[channelIndex] = isAlphaChannel ? opacityToAlpha(value) : value;
       this.updateColorFromChannels(channels);
     };
     this.handleSavedColorKeyDown = (event) => {
@@ -213,147 +129,101 @@ const ColorPicker = class {
         this.handleSavedColorSelect(event);
       }
     };
-    this.handleColorFieldAndSliderPointerLeave = () => {
-      this.colorFieldAndSliderInteractive = false;
-      this.colorFieldAndSliderHovered = false;
-      if (this.sliderThumbState !== "drag" && this.hueThumbState !== "drag") {
-        this.hueThumbState = "idle";
-        this.sliderThumbState = "idle";
-        this.drawColorFieldAndSlider();
+    this.handleColorFieldPointerDown = (event) => {
+      if (!isPrimaryPointerButton(event)) {
+        return;
       }
+      const { offsetX, offsetY } = event;
+      document.addEventListener("pointermove", this.globalPointerMoveHandler);
+      document.addEventListener("pointerup", this.globalPointerUpHandler, { once: true });
+      this.activeCanvasInfo = {
+        context: this.colorFieldRenderingContext,
+        bounds: this.colorFieldRenderingContext.canvas.getBoundingClientRect()
+      };
+      this.captureColorFieldColor(offsetX, offsetY);
+      this.colorFieldScopeNode.focus();
     };
-    this.handleColorFieldAndSliderPointerDown = (event) => {
-      var _a, _b;
+    this.handleHueSliderPointerDown = (event) => {
       if (!isPrimaryPointerButton(event)) {
         return;
       }
-      const { offsetX, offsetY } = event;
-      const region = this.getCanvasRegion(offsetY);
-      if (region === "color-field") {
-        this.hueThumbState = "drag";
-        this.captureColorFieldColor(offsetX, offsetY);
-        (_a = this.colorFieldScopeNode) === null || _a === void 0 ? void 0 : _a.focus();
-      }
-      else if (region === "slider") {
-        this.sliderThumbState = "drag";
-        this.captureHueSliderColor(offsetX);
-        (_b = this.hueScopeNode) === null || _b === void 0 ? void 0 : _b.focus();
-      }
-      // prevent text selection outside of color field & slider area
-      event.preventDefault();
+      const { offsetX } = event;
       document.addEventListener("pointermove", this.globalPointerMoveHandler);
       document.addEventListener("pointerup", this.globalPointerUpHandler, { once: true });
-      this.activeColorFieldAndSliderRect =
-        this.fieldAndSliderRenderingContext.canvas.getBoundingClientRect();
+      this.activeCanvasInfo = {
+        context: this.hueSliderRenderingContext,
+        bounds: this.hueSliderRenderingContext.canvas.getBoundingClientRect()
+      };
+      this.captureHueSliderColor(offsetX);
+      this.hueScopeNode.focus();
+    };
+    this.handleOpacitySliderPointerDown = (event) => {
+      if (!isPrimaryPointerButton(event)) {
+        return;
+      }
+      const { offsetX } = event;
+      document.addEventListener("pointermove", this.globalPointerMoveHandler);
+      document.addEventListener("pointerup", this.globalPointerUpHandler, { once: true });
+      this.activeCanvasInfo = {
+        context: this.opacitySliderRenderingContext,
+        bounds: this.opacitySliderRenderingContext.canvas.getBoundingClientRect()
+      };
+      this.captureOpacitySliderValue(offsetX);
+      this.opacityScopeNode.focus();
     };
     this.globalPointerUpHandler = (event) => {
       if (!isPrimaryPointerButton(event)) {
         return;
       }
-      const previouslyDragging = this.sliderThumbState === "drag" || this.hueThumbState === "drag";
-      this.hueThumbState = "idle";
-      this.sliderThumbState = "idle";
-      this.activeColorFieldAndSliderRect = null;
-      this.drawColorFieldAndSlider();
+      const previouslyDragging = this.activeCanvasInfo;
+      this.activeCanvasInfo = null;
+      this.drawColorControls();
       if (previouslyDragging) {
         this.calciteColorPickerChange.emit();
       }
     };
     this.globalPointerMoveHandler = (event) => {
-      const { el, dimensions } = this;
-      const sliderThumbDragging = this.sliderThumbState === "drag";
-      const hueThumbDragging = this.hueThumbState === "drag";
-      if (!el.isConnected || (!sliderThumbDragging && !hueThumbDragging)) {
+      const { activeCanvasInfo, el } = this;
+      if (!el.isConnected || !activeCanvasInfo) {
         return;
       }
+      const { context, bounds } = activeCanvasInfo;
       let samplingX;
       let samplingY;
-      const colorFieldAndSliderRect = this.activeColorFieldAndSliderRect;
       const { clientX, clientY } = event;
-      if (this.colorFieldAndSliderHovered) {
-        samplingX = clientX - colorFieldAndSliderRect.x;
-        samplingY = clientY - colorFieldAndSliderRect.y;
+      if (context.canvas.matches(":hover")) {
+        samplingX = clientX - bounds.x;
+        samplingY = clientY - bounds.y;
       }
       else {
-        const colorFieldWidth = dimensions.colorField.width;
-        const colorFieldHeight = dimensions.colorField.height;
-        const hueSliderHeight = dimensions.slider.height;
-        if (clientX < colorFieldAndSliderRect.x + colorFieldWidth &&
-          clientX > colorFieldAndSliderRect.x) {
-          samplingX = clientX - colorFieldAndSliderRect.x;
+        // snap x and y to the closest edge
+        if (clientX < bounds.x + bounds.width && clientX > bounds.x) {
+          samplingX = clientX - bounds.x;
         }
-        else if (clientX < colorFieldAndSliderRect.x) {
+        else if (clientX < bounds.x) {
           samplingX = 0;
         }
         else {
-          samplingX = colorFieldWidth - 1;
+          samplingX = bounds.width - 1;
         }
-        if (clientY < colorFieldAndSliderRect.y + colorFieldHeight + hueSliderHeight &&
-          clientY > colorFieldAndSliderRect.y) {
-          samplingY = clientY - colorFieldAndSliderRect.y;
+        if (clientY < bounds.y + bounds.height && clientY > bounds.y) {
+          samplingY = clientY - bounds.y;
         }
-        else if (clientY < colorFieldAndSliderRect.y) {
+        else if (clientY < bounds.y) {
           samplingY = 0;
         }
         else {
-          samplingY = colorFieldHeight + hueSliderHeight;
+          samplingY = bounds.height;
         }
       }
-      if (hueThumbDragging) {
+      if (context === this.colorFieldRenderingContext) {
         this.captureColorFieldColor(samplingX, samplingY, false);
       }
-      else {
+      else if (context === this.hueSliderRenderingContext) {
         this.captureHueSliderColor(samplingX);
       }
-    };
-    this.handleColorFieldAndSliderPointerEnterOrMove = ({ offsetX, offsetY }) => {
-      const { dimensions: { colorField, slider, thumb } } = this;
-      this.colorFieldAndSliderInteractive = offsetY <= colorField.height + slider.height;
-      this.colorFieldAndSliderHovered = true;
-      const region = this.getCanvasRegion(offsetY);
-      if (region === "color-field") {
-        const prevHueThumbState = this.hueThumbState;
-        const color = this.baseColorFieldColor.hsv();
-        const centerX = Math.round(color.saturationv() / (HSV_LIMITS.s / colorField.width));
-        const centerY = Math.round(colorField.height - color.value() / (HSV_LIMITS.v / colorField.height));
-        const hoveringThumb = this.containsPoint(offsetX, offsetY, centerX, centerY, thumb.radius);
-        let transitionedBetweenHoverAndIdle = false;
-        if (prevHueThumbState === "idle" && hoveringThumb) {
-          this.hueThumbState = "hover";
-          transitionedBetweenHoverAndIdle = true;
-        }
-        else if (prevHueThumbState === "hover" && !hoveringThumb) {
-          this.hueThumbState = "idle";
-          transitionedBetweenHoverAndIdle = true;
-        }
-        if (this.hueThumbState !== "drag") {
-          if (transitionedBetweenHoverAndIdle) {
-            // refresh since we won't update color and thus no redraw
-            this.drawColorFieldAndSlider();
-          }
-        }
-      }
-      else if (region === "slider") {
-        const sliderThumbColor = this.baseColorFieldColor.hsv().saturationv(100).value(100);
-        const prevSliderThumbState = this.sliderThumbState;
-        const sliderThumbCenterX = Math.round(sliderThumbColor.hue() / (360 / slider.width));
-        const sliderThumbCenterY = Math.round((slider.height + this.getSliderCapSpacing()) / 2) + colorField.height;
-        const hoveringSliderThumb = this.containsPoint(offsetX, offsetY, sliderThumbCenterX, sliderThumbCenterY, thumb.radius);
-        let sliderThumbTransitionedBetweenHoverAndIdle = false;
-        if (prevSliderThumbState === "idle" && hoveringSliderThumb) {
-          this.sliderThumbState = "hover";
-          sliderThumbTransitionedBetweenHoverAndIdle = true;
-        }
-        else if (prevSliderThumbState === "hover" && !hoveringSliderThumb) {
-          this.sliderThumbState = "idle";
-          sliderThumbTransitionedBetweenHoverAndIdle = true;
-        }
-        if (this.sliderThumbState !== "drag") {
-          if (sliderThumbTransitionedBetweenHoverAndIdle) {
-            // refresh since we won't update color and thus no redraw
-            this.drawColorFieldAndSlider();
-          }
-        }
+      else if (context === this.opacitySliderRenderingContext) {
+        this.captureOpacitySliderValue(samplingX);
       }
     };
     this.storeColorFieldScope = (node) => {
@@ -369,23 +239,35 @@ const ColorPicker = class {
       return (h("calcite-tab-title", { class: CSS.colorMode, "data-color-mode": channelMode, key: channelMode, onCalciteTabsActivate: this.handleTabActivate, selected: selected }, label));
     };
     this.renderChannelsTab = (channelMode) => {
-      const { channelMode: activeChannelMode, channels, messages } = this;
+      const { allowEmpty, channelMode: activeChannelMode, channels, messages, alphaChannel } = this;
       const selected = channelMode === activeChannelMode;
       const isRgb = channelMode === "rgb";
-      const channelLabels = isRgb
-        ? [messages.r, messages.g, messages.b]
-        : [messages.h, messages.s, messages.v];
       const channelAriaLabels = isRgb
         ? [messages.red, messages.green, messages.blue]
         : [messages.hue, messages.saturation, messages.value];
       const direction = getElementDir(this.el);
-      return (h("calcite-tab", { class: CSS.control, key: channelMode, selected: selected }, h("div", { class: CSS.channels, dir: "ltr" }, channels.map((channel, index) => 
-      /* the channel container is ltr, so we apply the host's direction */
-      this.renderChannel(channel, index, channelLabels[index], channelAriaLabels[index], direction)))));
+      const channelsToRender = alphaChannel ? channels : channels.slice(0, 3);
+      return (h("calcite-tab", { class: CSS.control, key: channelMode, selected: selected }, h("div", { class: CSS.channels, dir: "ltr" }, channelsToRender.map((channelValue, index) => {
+        const isAlphaChannel = index === 3;
+        if (isAlphaChannel) {
+          channelValue =
+            allowEmpty && !channelValue ? channelValue : alphaToOpacity(channelValue);
+        }
+        /* the channel container is ltr, so we apply the host's direction */
+        return this.renderChannel(channelValue, index, channelAriaLabels[index], direction, isAlphaChannel ? "%" : "");
+      }))));
+    };
+    this.renderChannel = (value, index, ariaLabel, direction, suffix) => {
+      return (h("calcite-input", { class: CSS.channel, "data-channel-index": index, dir: direction, key: index, label: ariaLabel, lang: this.effectiveLocale, numberButtonType: "none", numberingSystem: this.numberingSystem, onCalciteInputChange: this.handleChannelChange, onCalciteInputInput: this.handleChannelInput, onKeyDown: this.handleKeyDown, scale: this.scale === "l" ? "m" : "s",
+        // workaround to ensure input borders overlap as desired
+        // this is because the build transforms margin-left to its
+        // logical-prop, which is undesired as channels are always ltr
+        style: {
+          marginLeft: index > 0 && !(this.scale === "s" && this.alphaChannel && index === 3) ? "-1px" : ""
+        }, suffixText: suffix, type: "number", value: value === null || value === void 0 ? void 0 : value.toString() }));
     };
-    this.renderChannel = (value, index, label, ariaLabel, direction) => (h("calcite-input", { class: CSS.channel, "data-channel-index": index, dir: direction, label: ariaLabel, lang: this.effectiveLocale, numberButtonType: "none", numberingSystem: this.numberingSystem, onCalciteInputChange: this.handleChannelChange, onCalciteInputInput: this.handleChannelInput, onKeyDown: this.handleKeyDown, prefixText: label, scale: this.scale === "l" ? "m" : "s", type: "number", value: value === null || value === void 0 ? void 0 : value.toString() }));
     this.deleteColor = () => {
-      const colorToDelete = this.color.hex();
+      const colorToDelete = hexify(this.color, this.alphaChannel);
       const inStorage = this.savedColors.indexOf(colorToDelete) > -1;
       if (!inStorage) {
         return;
@@ -398,7 +280,7 @@ const ColorPicker = class {
       }
     };
     this.saveColor = () => {
-      const colorToSave = this.color.hex();
+      const colorToSave = hexify(this.color, this.alphaChannel);
       const alreadySaved = this.savedColors.indexOf(colorToSave) > -1;
       if (alreadySaved) {
         return;
@@ -410,12 +292,18 @@ const ColorPicker = class {
         localStorage.setItem(storageKey, JSON.stringify(savedColors));
       }
     };
-    this.drawColorFieldAndSlider = throttle(() => {
-      if (!this.fieldAndSliderRenderingContext) {
-        return;
+    this.drawColorControls = throttle((type = "all") => {
+      if ((type === "all" || type === "color-field") && this.colorFieldRenderingContext) {
+        this.drawColorField();
+      }
+      if ((type === "all" || type === "hue-slider") && this.hueSliderRenderingContext) {
+        this.drawHueSlider();
+      }
+      if (this.alphaChannel &&
+        (type === "all" || type === "opacity-slider") &&
+        this.opacitySliderRenderingContext) {
+        this.drawOpacitySlider();
       }
-      this.drawColorField();
-      this.drawHueSlider();
     }, throttleFor60FpsInMs);
     this.captureColorFieldColor = (x, y, skipEqual = true) => {
       const { dimensions: { colorField: { height, width } } } = this;
@@ -423,24 +311,56 @@ const ColorPicker = class {
       const value = Math.round((HSV_LIMITS.v / height) * (height - y));
       this.internalColorSet(this.baseColorFieldColor.hsv().saturationv(saturation).value(value), skipEqual);
     };
-    this.initColorFieldAndSlider = (canvas) => {
-      this.fieldAndSliderRenderingContext = canvas.getContext("2d");
-      this.updateCanvasSize(canvas);
+    this.initColorField = (canvas) => {
+      this.colorFieldRenderingContext = canvas.getContext("2d");
+      this.updateCanvasSize("color-field");
+      this.drawColorControls();
+    };
+    this.initHueSlider = (canvas) => {
+      this.hueSliderRenderingContext = canvas.getContext("2d");
+      this.updateCanvasSize("hue-slider");
+      this.drawHueSlider();
+    };
+    this.initOpacitySlider = (canvas) => {
+      this.opacitySliderRenderingContext = canvas.getContext("2d");
+      this.updateCanvasSize("opacity-slider");
+      this.drawOpacitySlider();
+    };
+    this.storeOpacityScope = (node) => {
+      this.opacityScopeNode = node;
+    };
+    this.handleOpacityScopeKeyDown = (event) => {
+      const modifier = event.shiftKey ? 10 : 1;
+      const { key } = event;
+      const arrowKeyToXOffset = {
+        ArrowUp: 1,
+        ArrowRight: 1,
+        ArrowDown: -1,
+        ArrowLeft: -1
+      };
+      if (arrowKeyToXOffset[key]) {
+        event.preventDefault();
+        const delta = opacityToAlpha(arrowKeyToXOffset[key] * modifier);
+        this.captureHueSliderColor(this.opacityScopeLeft + delta);
+      }
     };
     this.allowEmpty = false;
+    this.alphaChannel = false;
+    this.channelsDisabled = false;
     this.color = DEFAULT_COLOR;
     this.disabled = false;
-    this.format = defaultFormat;
-    this.hideHex = false;
+    this.format = "auto";
     this.hideChannels = false;
+    this.hexDisabled = false;
+    this.hideHex = false;
     this.hideSaved = false;
+    this.savedDisabled = false;
     this.scale = "m";
     this.storageId = undefined;
     this.messageOverrides = undefined;
     this.numberingSystem = undefined;
-    this.value = defaultValue;
+    this.value = normalizeHex(hexify(DEFAULT_COLOR, this.alphaChannel));
     this.defaultMessages = undefined;
-    this.colorFieldAndSliderInteractive = false;
     this.channelMode = "rgb";
     this.channels = this.toChannels(DEFAULT_COLOR);
     this.dimensions = DIMENSIONS.m;
@@ -449,12 +369,19 @@ const ColorPicker = class {
     this.savedColors = [];
     this.colorFieldScopeTop = undefined;
     this.colorFieldScopeLeft = undefined;
-    this.scopeOrientation = undefined;
     this.hueScopeLeft = undefined;
-    this.hueScopeTop = undefined;
+    this.opacityScopeLeft = undefined;
+    this.scopeOrientation = undefined;
+  }
+  handleAlphaChannelChange(alphaChannel) {
+    const { format } = this;
+    if (alphaChannel && format !== "auto" && !alphaCompatible(format)) {
+      console.warn(`ignoring alphaChannel as the current format (${format}) does not support alpha`);
+      this.alphaChannel = false;
+    }
   }
   handleColorChange(color, oldColor) {
-    this.drawColorFieldAndSlider();
+    this.drawColorControls();
     this.updateChannelsFromColor(color);
     this.previousColor = oldColor;
   }
@@ -463,9 +390,9 @@ const ColorPicker = class {
     this.internalColorSet(this.color, false, "internal");
   }
   handleScaleChange(scale = "m") {
-    var _a;
     this.updateDimensions(scale);
-    this.updateCanvasSize((_a = this.fieldAndSliderRenderingContext) === null || _a === void 0 ? void 0 : _a.canvas);
+    this.updateCanvasSize("all");
+    this.drawColorControls();
   }
   onMessagesChange() {
     /* wired up by t9n util */
@@ -482,9 +409,9 @@ const ColorPicker = class {
         return;
       }
       modeChanged = this.mode !== nextMode;
-      this.setMode(nextMode);
+      this.setMode(nextMode, this.internalColorUpdateContext === null);
     }
-    const dragging = this.sliderThumbState === "drag" || this.hueThumbState === "drag";
+    const dragging = this.activeCanvasInfo;
     if (this.internalColorUpdateContext === "initial") {
       return;
     }
@@ -495,17 +422,16 @@ const ColorPicker = class {
       }
       return;
     }
-    const color$1 = allowEmpty && !value ? null : color(value);
+    const color$1 = allowEmpty && !value
+      ? null
+      : color(value != null && typeof value === "object" && alphaCompatible(this.mode)
+        ? normalizeColor(value)
+        : value);
     const colorChanged = !colorEqual(color$1, this.color);
     if (modeChanged || colorChanged) {
-      this.internalColorSet(color$1, true, "internal");
+      this.internalColorSet(color$1, this.alphaChannel && !(this.mode.endsWith("a") || this.mode.endsWith("a-css")), "internal");
     }
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Internal State/Props
-  //
-  //--------------------------------------------------------------------------
   get baseColorFieldColor() {
     return this.color || this.previousColor || DEFAULT_COLOR;
   }
@@ -561,7 +487,7 @@ const ColorPicker = class {
     if (!valueIsCompatible) {
       this.showIncompatibleColorWarning(value, format);
     }
-    this.setMode(format);
+    this.setMode(format, false);
     this.internalColorSet(initialColor, false, "initial");
     this.updateDimensions(this.scale);
     const storageKey = `${DEFAULT_STORAGE_KEY_PREFIX}${this.storageId}`;
@@ -592,34 +518,37 @@ const ColorPicker = class {
   //
   //--------------------------------------------------------------------------
   render() {
-    const { allowEmpty, color, messages, hideHex, hideChannels, hideSaved, savedColors, scale } = this;
-    const selectedColorInHex = color ? color.hex() : null;
-    const hexInputScale = scale === "l" ? "m" : "s";
-    const { colorFieldAndSliderInteractive, colorFieldScopeTop, colorFieldScopeLeft, hueScopeLeft, hueScopeTop, scopeOrientation, dimensions: { colorField: { height: colorFieldHeight, width: colorFieldWidth }, slider: { height: sliderHeight } } } = this;
-    const hueTop = hueScopeTop !== null && hueScopeTop !== void 0 ? hueScopeTop : sliderHeight / 2 + colorFieldHeight;
-    const hueLeft = hueScopeLeft !== null && hueScopeLeft !== void 0 ? hueScopeLeft : (colorFieldWidth * DEFAULT_COLOR.hue()) / HSV_LIMITS.h;
+    const { allowEmpty, channelsDisabled, color, colorFieldScopeLeft, colorFieldScopeTop, dimensions: { colorField: { width: colorFieldWidth }, slider: { width: sliderWidth }, thumb: { radius: thumbRadius } }, hexDisabled, hideChannels, hideHex, hideSaved, hueScopeLeft, messages, alphaChannel, opacityScopeLeft, savedColors, savedDisabled, scale, scopeOrientation } = this;
+    const selectedColorInHex = color ? hexify(color, alphaChannel) : null;
+    const hueTop = thumbRadius;
+    const hueLeft = hueScopeLeft !== null && hueScopeLeft !== void 0 ? hueScopeLeft : (sliderWidth * DEFAULT_COLOR.hue()) / HSV_LIMITS.h;
+    const opacityTop = thumbRadius;
+    const opacityLeft = opacityScopeLeft !== null && opacityScopeLeft !== void 0 ? opacityScopeLeft : (colorFieldWidth * alphaToOpacity(DEFAULT_COLOR.alpha())) / OPACITY_LIMITS.max;
     const noColor = color === null;
     const vertical = scopeOrientation === "vertical";
-    return (h("div", { class: CSS.container }, h("div", { class: CSS.colorFieldAndSliderWrap }, h("canvas", { class: {
-        [CSS.colorFieldAndSlider]: true,
-        [CSS.colorFieldAndSliderInteractive]: colorFieldAndSliderInteractive
-      }, onPointerDown: this.handleColorFieldAndSliderPointerDown, onPointerEnter: this.handleColorFieldAndSliderPointerEnterOrMove, onPointerLeave: this.handleColorFieldAndSliderPointerLeave, onPointerMove: this.handleColorFieldAndSliderPointerEnterOrMove,
+    const noHex = hexDisabled || hideHex;
+    const noChannels = channelsDisabled || hideChannels;
+    const noSaved = savedDisabled || hideSaved;
+    return (h("div", { class: CSS.container }, h("div", { class: CSS.controlAndScope }, h("canvas", { class: CSS.colorField, onPointerDown: this.handleColorFieldPointerDown,
+      // eslint-disable-next-line react/jsx-sort-props
+      ref: this.initColorField }), h("div", { "aria-label": vertical ? messages.value : messages.saturation, "aria-valuemax": vertical ? HSV_LIMITS.v : HSV_LIMITS.s, "aria-valuemin": "0", "aria-valuenow": (vertical ? color === null || color === void 0 ? void 0 : color.saturationv() : color === null || color === void 0 ? void 0 : color.value()) || "0", class: { [CSS.scope]: true, [CSS.colorFieldScope]: true }, onKeyDown: this.handleColorFieldScopeKeyDown, role: "slider", style: { top: `${colorFieldScopeTop || 0}px`, left: `${colorFieldScopeLeft || 0}px` }, tabindex: "0",
       // eslint-disable-next-line react/jsx-sort-props
-      ref: this.initColorFieldAndSlider }), h("div", { "aria-label": vertical ? messages.value : messages.saturation, "aria-valuemax": vertical ? HSV_LIMITS.v : HSV_LIMITS.s, "aria-valuemin": "0", "aria-valuenow": (vertical ? color === null || color === void 0 ? void 0 : color.saturationv() : color === null || color === void 0 ? void 0 : color.value()) || "0", class: { [CSS.scope]: true, [CSS.colorFieldScope]: true }, onKeyDown: this.handleColorFieldScopeKeyDown, role: "slider", style: { top: `${colorFieldScopeTop || 0}px`, left: `${colorFieldScopeLeft || 0}px` }, tabindex: "0",
+      ref: this.storeColorFieldScope })), h("div", { class: CSS.previewAndSliders }, h("calcite-color-picker-swatch", { class: CSS.preview, color: selectedColorInHex, scale: "l" }), h("div", { class: CSS.sliders }, h("div", { class: CSS.controlAndScope }, h("canvas", { class: { [CSS.slider]: true, [CSS.hueSlider]: true }, onPointerDown: this.handleHueSliderPointerDown,
       // eslint-disable-next-line react/jsx-sort-props
-      ref: this.storeColorFieldScope }), h("div", { "aria-label": messages.hue, "aria-valuemax": HSV_LIMITS.h, "aria-valuemin": "0", "aria-valuenow": (color === null || color === void 0 ? void 0 : color.round().hue()) || DEFAULT_COLOR.round().hue(), class: { [CSS.scope]: true, [CSS.hueScope]: true }, onKeyDown: this.handleHueScopeKeyDown, role: "slider", style: { top: `${hueTop}px`, left: `${hueLeft}px` }, tabindex: "0",
+      ref: this.initHueSlider }), h("div", { "aria-label": messages.hue, "aria-valuemax": HSV_LIMITS.h, "aria-valuemin": "0", "aria-valuenow": (color === null || color === void 0 ? void 0 : color.round().hue()) || DEFAULT_COLOR.round().hue(), class: { [CSS.scope]: true, [CSS.hueScope]: true }, onKeyDown: this.handleHueScopeKeyDown, role: "slider", style: { top: `${hueTop}px`, left: `${hueLeft}px` }, tabindex: "0",
       // eslint-disable-next-line react/jsx-sort-props
-      ref: this.storeHueScope })), hideHex && hideChannels ? null : (h("div", { class: {
+      ref: this.storeHueScope })), alphaChannel ? (h("div", { class: CSS.controlAndScope }, h("canvas", { class: { [CSS.slider]: true, [CSS.opacitySlider]: true }, onPointerDown: this.handleOpacitySliderPointerDown,
+      // eslint-disable-next-line react/jsx-sort-props
+      ref: this.initOpacitySlider }), h("div", { "aria-label": messages.opacity, "aria-valuemax": OPACITY_LIMITS.max, "aria-valuemin": OPACITY_LIMITS.min, "aria-valuenow": (color || DEFAULT_COLOR).round().alpha(), class: { [CSS.scope]: true, [CSS.opacityScope]: true }, onKeyDown: this.handleOpacityScopeKeyDown, role: "slider", style: { top: `${opacityTop}px`, left: `${opacityLeft}px` }, tabindex: "0",
+      // eslint-disable-next-line react/jsx-sort-props
+      ref: this.storeOpacityScope }))) : null)), noHex && noChannels ? null : (h("div", { class: {
         [CSS.controlSection]: true,
         [CSS.section]: true
-      } }, hideHex ? null : (h("div", { class: CSS.hexOptions }, h("span", { class: {
-        [CSS.header]: true,
-        [CSS.headerHex]: true
-      } }, messages.hex), h("calcite-color-picker-hex-input", { allowEmpty: allowEmpty, class: CSS.control, hexLabel: messages.hex, numberingSystem: this.numberingSystem, onCalciteColorPickerHexInputChange: this.handleHexInputChange, scale: hexInputScale, value: selectedColorInHex }))), hideChannels ? null : (h("calcite-tabs", { class: {
+      } }, h("div", { class: CSS.hexAndChannelsGroup }, noHex ? null : (h("div", { class: CSS.hexOptions }, h("calcite-color-picker-hex-input", { allowEmpty: allowEmpty, alphaChannel: alphaChannel, class: CSS.control, messages: messages, numberingSystem: this.numberingSystem, onCalciteColorPickerHexInputChange: this.handleHexInputChange, scale: scale, value: selectedColorInHex }))), noChannels ? null : (h("calcite-tabs", { class: {
         [CSS.colorModeContainer]: true,
         [CSS.splitSection]: true
-      }, scale: hexInputScale }, h("calcite-tab-nav", { slot: "title-group" }, this.renderChannelsTabTitle("rgb"), this.renderChannelsTabTitle("hsv")), this.renderChannelsTab("rgb"), this.renderChannelsTab("hsv"))))), hideSaved ? null : (h("div", { class: { [CSS.savedColorsSection]: true, [CSS.section]: true } }, h("div", { class: CSS.header }, h("label", null, messages.saved), h("div", { class: CSS.savedColorsButtons }, h("calcite-button", { appearance: "transparent", class: CSS.deleteColor, disabled: noColor, iconStart: "minus", kind: "neutral", label: messages.deleteColor, onClick: this.deleteColor, scale: hexInputScale, type: "button" }), h("calcite-button", { appearance: "transparent", class: CSS.saveColor, disabled: noColor, iconStart: "plus", kind: "neutral", label: messages.saveColor, onClick: this.saveColor, scale: hexInputScale, type: "button" }))), savedColors.length > 0 ? (h("div", { class: CSS.savedColors }, [
-      ...savedColors.map((color) => (h("calcite-color-picker-swatch", { active: selectedColorInHex === color, class: CSS.savedColor, color: color, key: color, onClick: this.handleSavedColorSelect, onKeyDown: this.handleSavedColorKeyDown, scale: scale, tabIndex: 0 })))
+      }, scale: scale === "l" ? "m" : "s" }, h("calcite-tab-nav", { slot: "title-group" }, this.renderChannelsTabTitle("rgb"), this.renderChannelsTabTitle("hsv")), this.renderChannelsTab("rgb"), this.renderChannelsTab("hsv")))))), noSaved ? null : (h("div", { class: { [CSS.savedColorsSection]: true, [CSS.section]: true } }, h("div", { class: CSS.header }, h("label", null, messages.saved), h("div", { class: CSS.savedColorsButtons }, h("calcite-button", { appearance: "transparent", class: CSS.deleteColor, disabled: noColor, iconStart: "minus", kind: "neutral", label: messages.deleteColor, onClick: this.deleteColor, scale: scale, type: "button" }), h("calcite-button", { appearance: "transparent", class: CSS.saveColor, disabled: noColor, iconStart: "plus", kind: "neutral", label: messages.saveColor, onClick: this.saveColor, scale: scale, type: "button" }))), savedColors.length > 0 ? (h("div", { class: CSS.savedColors }, [
+      ...savedColors.map((color) => (h("calcite-color-picker-swatch", { class: CSS.savedColor, color: color, key: color, onClick: this.handleSavedColorSelect, onKeyDown: this.handleSavedColorKeyDown, scale: scale, tabIndex: 0 })))
     ])) : null))));
   }
   // --------------------------------------------------------------------------
@@ -635,23 +564,38 @@ const ColorPicker = class {
   showIncompatibleColorWarning(value, format) {
     console.warn(`ignoring color value (${value}) as it is not compatible with the current format (${format})`);
   }
-  setMode(format) {
-    this.mode = format === "auto" ? this.mode : format;
+  setMode(format, warn = true) {
+    const mode = format === "auto" ? this.mode : format;
+    this.mode = this.ensureCompatibleMode(mode, warn);
+  }
+  ensureCompatibleMode(mode, warn) {
+    const { alphaChannel } = this;
+    const isAlphaCompatible = alphaCompatible(mode);
+    if (alphaChannel && !isAlphaCompatible) {
+      const alphaMode = toAlphaMode(mode);
+      if (warn) {
+        console.warn(`setting format to (${alphaMode}) as the provided one (${mode}) does not support alpha`);
+      }
+      return alphaMode;
+    }
+    if (!alphaChannel && isAlphaCompatible) {
+      const nonAlphaMode = toNonAlphaMode(mode);
+      if (warn) {
+        console.warn(`setting format to (${nonAlphaMode}) as the provided one (${mode}) does not support alpha`);
+      }
+      return nonAlphaMode;
+    }
+    return mode;
   }
   captureHueSliderColor(x) {
     const { dimensions: { slider: { width } } } = this;
     const hue = (360 / width) * x;
     this.internalColorSet(this.baseColorFieldColor.hue(hue), false);
   }
-  getCanvasRegion(y) {
-    const { dimensions: { colorField: { height: colorFieldHeight }, slider: { height: sliderHeight } } } = this;
-    if (y <= colorFieldHeight) {
-      return "color-field";
-    }
-    if (y <= colorFieldHeight + sliderHeight) {
-      return "slider";
-    }
-    return "none";
+  captureOpacitySliderValue(x) {
+    const { dimensions: { slider: { width } } } = this;
+    const alpha = opacityToAlpha((OPACITY_LIMITS.max / width) * x);
+    this.internalColorSet(this.baseColorFieldColor.alpha(alpha), false);
   }
   internalColorSet(color, skipEqual = true, context = "user-interaction") {
     if (skipEqual && colorEqual(color, this.color)) {
@@ -668,16 +612,25 @@ const ColorPicker = class {
     }
     const hexMode = "hex";
     if (format.includes(hexMode)) {
-      return normalizeHex(color.round()[hexMode]());
+      const hasAlpha = format === CSSColorMode.HEXA;
+      return normalizeHex(hexify(color.round(), hasAlpha), hasAlpha);
     }
     if (format.includes("-css")) {
-      return color[format.replace("-css", "").replace("a", "")]().round().string();
+      const value = color[format.replace("-css", "").replace("a", "")]().round().string();
+      // Color omits alpha values when alpha is 1
+      const needToInjectAlpha = (format.endsWith("a") || format.endsWith("a-css")) && color.alpha() === 1;
+      if (needToInjectAlpha) {
+        const model = value.slice(0, 3);
+        const values = value.slice(4, -1);
+        return `${model}a(${values}, ${color.alpha()})`;
+      }
+      return value;
     }
-    const colorObject = color[format]().round().object();
+    const colorObject = 
+    /* Color() does not support hsva, hsla nor rgba, so we use the non-alpha mode */
+    color[toNonAlphaMode(format)]().round().object();
     if (format.endsWith("a")) {
-      // normalize alpha prop
-      colorObject.a = colorObject.alpha;
-      delete colorObject.alpha;
+      return normalizeAlpha(colorObject);
     }
     return colorObject;
   }
@@ -689,9 +642,14 @@ const ColorPicker = class {
     this.dimensions = DIMENSIONS[scale];
   }
   drawColorField() {
-    const context = this.fieldAndSliderRenderingContext;
+    const context = this.colorFieldRenderingContext;
     const { dimensions: { colorField: { height, width } } } = this;
-    context.fillStyle = this.baseColorFieldColor.hsv().saturationv(100).value(100).string();
+    context.fillStyle = this.baseColorFieldColor
+      .hsv()
+      .saturationv(100)
+      .value(100)
+      .alpha(1)
+      .string();
     context.fillRect(0, 0, width, height);
     const whiteGradient = context.createLinearGradient(0, 0, width, 0);
     whiteGradient.addColorStop(0, "rgba(255,255,255,1)");
@@ -706,6 +664,9 @@ const ColorPicker = class {
     this.drawActiveColorFieldColor();
   }
   setCanvasContextSize(canvas, { height, width }) {
+    if (!canvas) {
+      return;
+    }
     const devicePixelRatio = window.devicePixelRatio || 1;
     canvas.width = width * devicePixelRatio;
     canvas.height = height * devicePixelRatio;
@@ -714,21 +675,22 @@ const ColorPicker = class {
     const context = canvas.getContext("2d");
     context.scale(devicePixelRatio, devicePixelRatio);
   }
-  updateCanvasSize(canvas) {
-    if (!canvas) {
-      return;
+  updateCanvasSize(context = "all") {
+    var _a, _b, _c;
+    const { dimensions } = this;
+    if (context === "all" || context === "color-field") {
+      this.setCanvasContextSize((_a = this.colorFieldRenderingContext) === null || _a === void 0 ? void 0 : _a.canvas, dimensions.colorField);
+    }
+    const adjustedSliderDimensions = {
+      width: dimensions.slider.width,
+      height: dimensions.slider.height + (dimensions.thumb.radius - dimensions.slider.height / 2) * 2
+    };
+    if (context === "all" || context === "hue-slider") {
+      this.setCanvasContextSize((_b = this.hueSliderRenderingContext) === null || _b === void 0 ? void 0 : _b.canvas, adjustedSliderDimensions);
+    }
+    if (context === "all" || context === "opacity-slider") {
+      this.setCanvasContextSize((_c = this.opacitySliderRenderingContext) === null || _c === void 0 ? void 0 : _c.canvas, adjustedSliderDimensions);
     }
-    this.setCanvasContextSize(canvas, {
-      width: this.dimensions.colorField.width,
-      height: this.dimensions.colorField.height +
-        this.dimensions.slider.height +
-        this.getSliderCapSpacing() * 2
-    });
-    this.drawColorFieldAndSlider();
-  }
-  containsPoint(testPointX, testPointY, boundsX, boundsY, boundsRadius) {
-    return (Math.pow(testPointX - boundsX, 2) + Math.pow(testPointY - boundsY, 2) <=
-      Math.pow(boundsRadius, 2));
   }
   drawActiveColorFieldColor() {
     const { color } = this;
@@ -743,22 +705,23 @@ const ColorPicker = class {
       this.colorFieldScopeLeft = x;
       this.colorFieldScopeTop = y;
     });
-    this.drawThumb(this.fieldAndSliderRenderingContext, radius, x, y, hsvColor, this.hueThumbState);
+    this.drawThumb(this.colorFieldRenderingContext, radius, x, y, hsvColor);
   }
-  drawThumb(context, radius, x, y, color, state) {
+  drawThumb(context, radius, x, y, color) {
     const startAngle = 0;
     const endAngle = 2 * Math.PI;
+    const outlineWidth = 1;
+    radius = radius - outlineWidth;
     context.beginPath();
     context.arc(x, y, radius, startAngle, endAngle);
-    context.shadowBlur = state === "hover" ? 32 : 16;
-    context.shadowColor = `rgba(0, 0, 0, ${state === "drag" ? 0.32 : 0.16})`;
     context.fillStyle = "#fff";
     context.fill();
+    context.strokeStyle = "rgba(0,0,0,0.3)";
+    context.lineWidth = outlineWidth;
+    context.stroke();
     context.beginPath();
     context.arc(x, y, radius - 3, startAngle, endAngle);
-    context.shadowBlur = 0;
-    context.shadowColor = "transparent";
-    context.fillStyle = color.rgb().string();
+    context.fillStyle = color.rgb().alpha(1).string();
     context.fill();
   }
   drawActiveHueSliderColor() {
@@ -767,18 +730,19 @@ const ColorPicker = class {
       return;
     }
     const hsvColor = color.hsv().saturationv(100).value(100);
-    const { dimensions: { colorField: { height: colorFieldHeight }, slider: { height, width }, thumb: { radius } } } = this;
+    const { dimensions: { slider: { height, width }, thumb: { radius } } } = this;
     const x = hsvColor.hue() / (360 / width);
-    const y = height / 2 + colorFieldHeight;
+    const y = radius - height / 2 + height / 2;
     requestAnimationFrame(() => {
       this.hueScopeLeft = x;
-      this.hueScopeTop = y;
     });
-    this.drawThumb(this.fieldAndSliderRenderingContext, radius, x, y, hsvColor, this.sliderThumbState);
+    this.drawThumb(this.hueSliderRenderingContext, radius, x, y, hsvColor);
   }
   drawHueSlider() {
-    const context = this.fieldAndSliderRenderingContext;
-    const { dimensions: { colorField: { height: colorFieldHeight }, slider: { height, width } } } = this;
+    const context = this.hueSliderRenderingContext;
+    const { dimensions: { slider: { height, width }, thumb: { radius: thumbRadius } } } = this;
+    const x = 0;
+    const y = thumbRadius - height / 2;
     const gradient = context.createLinearGradient(0, 0, width, 0);
     const hueSliderColorStopKeywords = ["red", "yellow", "lime", "cyan", "blue", "magenta", "red"];
     const offset = 1 / (hueSliderColorStopKeywords.length - 1);
@@ -787,27 +751,107 @@ const ColorPicker = class {
       gradient.addColorStop(currentOffset, color(keyword).string());
       currentOffset += offset;
     });
+    context.clearRect(0, 0, width, height + this.getSliderCapSpacing() * 2);
+    this.drawSliderPath(context, height, width, x, y);
     context.fillStyle = gradient;
-    context.clearRect(0, colorFieldHeight, width, height + this.getSliderCapSpacing() * 2);
-    context.fillRect(0, colorFieldHeight, width, height);
+    context.fill();
+    context.strokeStyle = "rgba(0,0,0,0.3)";
+    context.lineWidth = 1;
+    context.stroke();
     this.drawActiveHueSliderColor();
   }
+  drawOpacitySlider() {
+    const context = this.opacitySliderRenderingContext;
+    const { baseColorFieldColor: previousColor, dimensions: { slider: { height, width }, thumb: { radius: thumbRadius } } } = this;
+    const x = 0;
+    const y = thumbRadius - height / 2;
+    context.clearRect(0, 0, width, height + this.getSliderCapSpacing() * 2);
+    const gradient = context.createLinearGradient(0, y, width, 0);
+    const startColor = previousColor.rgb().alpha(0);
+    const midColor = previousColor.rgb().alpha(0.5);
+    const endColor = previousColor.rgb().alpha(1);
+    gradient.addColorStop(0, startColor.string());
+    gradient.addColorStop(0.5, midColor.string());
+    gradient.addColorStop(1, endColor.string());
+    this.drawSliderPath(context, height, width, x, y);
+    const pattern = context.createPattern(this.getCheckeredBackgroundPattern(), "repeat");
+    context.fillStyle = pattern;
+    context.fill();
+    context.fillStyle = gradient;
+    context.fill();
+    context.strokeStyle = "rgba(0,0,0,0.3)";
+    context.lineWidth = 1;
+    context.stroke();
+    this.drawActiveOpacitySliderColor();
+  }
+  drawSliderPath(context, height, width, x, y) {
+    const radius = height / 2 + 1;
+    context.beginPath();
+    context.moveTo(x + radius, y);
+    context.lineTo(x + width - radius, y);
+    context.quadraticCurveTo(x + width, y, x + width, y + radius);
+    context.lineTo(x + width, y + height - radius);
+    context.quadraticCurveTo(x + width, y + height, x + width - radius, y + height);
+    context.lineTo(x + radius, y + height);
+    context.quadraticCurveTo(x, y + height, x, y + height - radius);
+    context.lineTo(x, y + radius);
+    context.quadraticCurveTo(x, y, x + radius, y);
+    context.closePath();
+  }
+  getCheckeredBackgroundPattern() {
+    if (this.checkerPattern) {
+      return this.checkerPattern;
+    }
+    const pattern = document.createElement("canvas");
+    pattern.width = 10;
+    pattern.height = 10;
+    const patternContext = pattern.getContext("2d");
+    patternContext.fillStyle = "#ccc";
+    patternContext.fillRect(0, 0, 10, 10);
+    patternContext.fillStyle = "#fff";
+    patternContext.fillRect(0, 0, 5, 5);
+    patternContext.fillRect(5, 5, 5, 5);
+    this.checkerPattern = pattern;
+    return pattern;
+  }
+  drawActiveOpacitySliderColor() {
+    const { color } = this;
+    if (!color) {
+      return;
+    }
+    const hsvColor = color;
+    const { dimensions: { slider: { width }, thumb: { radius } } } = this;
+    const x = alphaToOpacity(hsvColor.alpha()) / (OPACITY_LIMITS.max / width);
+    const y = radius;
+    requestAnimationFrame(() => {
+      this.opacityScopeLeft = x;
+    });
+    this.drawThumb(this.opacitySliderRenderingContext, radius, x, y, hsvColor);
+  }
   updateColorFromChannels(channels) {
     this.internalColorSet(color(channels, this.channelMode));
   }
   updateChannelsFromColor(color) {
-    this.channels = color ? this.toChannels(color) : [null, null, null];
+    this.channels = color ? this.toChannels(color) : [null, null, null, null];
   }
   toChannels(color) {
     const { channelMode } = this;
-    return color[channelMode]()
+    const channels = color[channelMode]()
       .array()
-      .map((value) => Math.floor(value));
+      .map((value, index) => {
+      const isAlpha = index === 3;
+      return isAlpha ? value : Math.floor(value);
+    });
+    if (channels.length === 3) {
+      channels.push(1); // Color omits alpha when 1
+    }
+    return channels;
   }
   static get delegatesFocus() { return true; }
   static get assetsDirs() { return ["assets"]; }
   get el() { return getElement(this); }
   static get watchers() { return {
+    "alphaChannel": ["handleAlphaChannelChange"],
     "color": ["handleColorChange"],
     "format": ["handleFormatChange"],
     "scale": ["handleScaleChange"],