@ardium-ui/ui 5.0.0-alpha.7 → 5.0.0-alpha.71

package/themes/default/inputs/input.scss

@@ -1,12 +1,59 @@
 @use './shared' as inputMixin;
 @use '../mixins' as defaultMixins;
 @use '../clear-button' as CB;
+@use '../../variables' as ARD;
+
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-input-height: ;
+  // --ard-input-height-compact: ;
+  --ard-input-gap: 0.625rem;
+  // --ard-input-font-size: ;
+  // --ard-input-font-size-compact: ;
+  --ard-input-line-height: 1.25;
+  --ard-input-line-height-compact: 1;
+  --ard-input-font-weight: 400;
+  // --ard-input-padding-left: ;
+  // --ard-input-padding-right: ;
+  // --ard-input-padding-top: ;
+  // --ard-input-padding-bottom: ;
+  // --ard-input-padding-left-compact: ;
+  // --ard-input-padding-right-compact: ;
+  // --ard-input-padding-top-compact: ;
+  // --ard-input-padding-bottom-compact: ;
+  // --ard-input-color: ;
+  // --ard-input-placeholder-color: ;
+  --ard-input-placeholder-opacity: 60%;
+
+  --ard-input-min-width: 10rem;
+  --ard-input-max-width: 100%;
+}
 
 .ard-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+  @include inputMixin.genericInput(
+    var(--ard-input-height, var(--ard-form-field-height, 2.3125rem)),
+    var(--ard-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+    var(--ard-input-gap, 0.625rem),
+    var(--ard-input-font-size, var(--ard-form-field-font-size, 1rem)),
+    var(--ard-input-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+    var(--ard-input-line-height, 1.25),
+    var(--ard-input-line-height-compact, 1),
+    var(--ard-input-font-weight, 400),
+    var(--ard-input-padding-top, var(--ard-form-field-padding-top, 0)),
+    var(--ard-input-padding-right, var(--ard-form-field-padding-right, 0.375rem)),
+    var(--ard-input-padding-bottom, var(--ard-form-field-padding-bottom, 0)),
+    var(--ard-input-padding-left, var(--ard-form-field-padding-left, 0.375rem)),
+    var(--ard-input-padding-top-compact, var(--ard-form-field-padding-top-compact, 0)),
+    var(--ard-input-padding-right-compact, var(--ard-form-field-padding-right-compact, 0.375rem)),
+    var(--ard-input-padding-bottom-compact, var(--ard-form-field-padding-bottom-compact, 0)),
+    var(--ard-input-padding-left-compact, var(--ard-form-field-padding-left-compact, 0.375rem)),
+    var(--ard-input-color, #{ARD.$text}),
+    var(--ard-input-placeholder-color, #{ARD.$text}),
+    var(--ard-input-placeholder-opacity, 60%)
+  );
+  min-width: var(--ard-input-min-width, 10rem);
+  max-width: var(--ard-input-max-width, 100%);
 
   @include CB.clearButton();
 }

package/themes/default/inputs/number-input.scss

@@ -2,33 +2,97 @@
 @use '../mixins' as defaultMixins;
 @use '../../variables' as ARD;
 
-ard-number-input {
-  width: 9.5rem;
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-number-input-height: ;
+  // --ard-number-input-height-compact: ;
+  --ard-number-input-gap: 0.625rem;
+  // --ard-number-input-font-size: ;
+  // --ard-number-input-font-size-compact: ;
+  --ard-number-input-line-height: 1.25;
+  --ard-number-input-line-height-compact: 1;
+  --ard-number-input-font-weight: 400;
+  // --ard-number-input-padding-top: ;
+  // --ard-number-input-padding-right: ;
+  // --ard-number-input-padding-bottom: ;
+  // --ard-number-input-padding-left: ;
+  // --ard-number-input-padding-top-compact: ;
+  // --ard-number-input-padding-right-compact: ;
+  // --ard-number-input-padding-bottom-compact: ;
+  // --ard-number-input-padding-left-compact: ;
+  // --ard-number-input-color: ;
+  // --ard-number-input-placeholder-color: ;
+  --ard-number-input-placeholder-opacity: 60%;
+  --ard-number-input-disabled-opacity: 50%;
+  // --ard-number-input-width: ;
+  --ard-number-input-rounded-border-radius: 8px;
+}
 
-  &:not(:has(.ard-quick-change-button)) {
-    width: 6rem;
-  }
+ard-number-input {
+  width: var(--ard-number-input-width, unset);
 }
 
 .ard-number-input {
-  @include inputMixin.genericInput();
+  @include inputMixin.genericInput(
+    var(--ard-number-input-height, var(--ard-form-field-height, 2.3125rem)),
+    var(--ard-number-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+    var(--ard-number-input-gap, 0.625rem),
+    var(--ard-number-input-font-size, var(--ard-form-field-font-size, 1rem)),
+    var(--ard-number-input-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+    var(--ard-number-input-line-height, 1.25),
+    var(--ard-number-input-line-height-compact, 1),
+    var(--ard-number-input-font-weight, 400),
+    var(--ard-number-input-padding-top, var(--ard-form-field-padding-top, 0)),
+    var(--ard-number-input-padding-right, var(--ard-form-field-padding-right, 0.375rem)),
+    var(--ard-number-input-padding-bottom, var(--ard-form-field-padding-bottom, 0)),
+    var(--ard-number-input-padding-left, var(--ard-form-field-padding-left, 0.375rem)),
+    var(--ard-number-input-padding-top-compact, var(--ard-form-field-padding-top-compact, 0)),
+    var(--ard-number-input-padding-right-compact, var(--ard-form-field-padding-right-compact, 0.375rem)),
+    var(--ard-number-input-padding-bottom-compact, var(--ard-form-field-padding-bottom-compact, 0)),
+    var(--ard-number-input-padding-left-compact, var(--ard-form-field-padding-left-compact, 0.375rem)),
+    var(--ard-number-input-color, #{ARD.$text}),
+    var(--ard-number-input-placeholder-color, #{ARD.$text}),
+    var(--ard-number-input-placeholder-opacity, 60%)
+  );
   @include defaultMixins.formAppearances();
-  min-height: 2.1875rem;
-  height: 2.1875rem;
   gap: 0;
   width: 100%;
 
-  .ard-input-container {
+  .ard-number-input-wrapper {
+    flex-grow: 1;
+    text-size-adjust: 100%;
+    display: flex;
+    align-items: center;
     height: 100%;
-    max-width: 100%;
+  }
+  .ard-input-container {
+    position: relative;
+    padding-left: var(--ard-number-input-padding-left, var(--ard-form-field-padding-left, 0.375rem));
+    padding-right: var(--ard-number-input-padding-right, var(--ard-form-field-padding-right, 0.375rem));
+    padding-top: var(--ard-number-input-padding-top, var(--ard-form-field-padding-top, 0));
+    padding-bottom: var(--ard-number-input-padding-bottom, var(--ard-form-field-padding-bottom, 0));
+  }
 
-    & > input {
-      width: 100%;
-    }
+  //! prefix & suffix
+  .ard-number-input-prefix-container,
+  .ard-number-input-suffix-container {
+    height: max-content;
+    max-height: 100%;
+    display: flex;
+    align-items: center;
+  }
+  .ard-number-input-prefix-container {
+    padding-left: var(--ard-number-input-padding-left, 0.375rem);
+  }
+  .ard-number-input-suffix-container {
+    padding-right: var(--ard-number-input-padding-right, 0.375rem);
   }
 
+  //! buttons
   .ard-quick-change-button {
     position: relative;
+    min-width: var(--ard-number-input-height, var(--ard-form-field-height, 2.3125rem));
 
     .ard-button {
       height: 100%;
@@ -63,11 +127,11 @@ ard-number-input {
 
   //! variants
   &.ard-variant-rounded {
-    border-radius: 8px;
+    border-radius: var(--ard-number-input-rounded-border-radius, 8px);
 
     &.ard-quick-change-false {
-      .ard-input-container {
-        border-radius: 8px;
+      .ard-number-input-wrapper {
+        border-radius: var(--ard-number-input-rounded-border-radius, 8px);
       }
     }
   }
@@ -79,13 +143,13 @@ ard-number-input {
 
     .ard-button {
       border-radius: 9999px !important;
-      height: 30px;
-      width: 30px;
+      width: var(--ard-number-input-height, var(--ard-form-field-height, 2.3125rem));
+      height: var(--ard-number-input-height, var(--ard-form-field-height, 2.3125rem));
       margin: 0 2px;
     }
 
     &.ard-quick-change-false {
-      .ard-input-container {
+      .ard-number-input-wrapper {
         border-radius: 9999px;
       }
     }
@@ -94,7 +158,7 @@ ard-number-input {
   //! variant-specific appearances
   &.ard-variant-rounded,
   &.ard-variant-sharp {
-    &:not(.ard-appearance-filled) .ard-input-container {
+    &:not(.ard-appearance-filled) .ard-number-input-wrapper {
       box-sizing: border-box;
       background: var(--ard-appearance-background);
       border: var(--ard-appearance-border);
@@ -111,16 +175,22 @@ ard-number-input {
 
   //! compact
   &.ard-compact {
-    min-height: 1.6875rem;
-    height: 1.6875rem;
-    font-size: 0.925rem;
+    .ard-number-input-wrapper {
+      padding-left: var(--ard-number-input-padding-left-compact, var(--ard-form-field-padding-left-compact, 0.375rem));
+      padding-right: var(--ard-number-input-padding-right-compact, var(--ard-form-field-padding-right-compact, 0.375rem));
+      padding-top: var(--ard-number-input-padding-top-compact, var(--ard-form-field-padding-top-compact, 0));
+      padding-bottom: var(--ard-number-input-padding-bottom-compact, var(--ard-form-field-padding-bottom-compact, 0));
+    }
+    .ard-quick-change-button {
+      min-width: var(--ard-number-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem));
+    }
   }
 }
 
 .ard-disabled {
   > .ard-number-input {
     pointer-events: none;
-    opacity: 50%;
+    opacity: var(--ard-number-input-disabled-opacity, 50%);
 
     .ard-button .ard-focus-overlay {
       opacity: 0;

package/themes/default/inputs/password-input.scss

@@ -3,11 +3,71 @@
 @use '../clear-button' as CB;
 @use '../../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-password-input-height: ;
+  // --ard-password-input-height-compact: ;
+  --ard-password-input-gap: 0.625rem;
+  // --ard-password-input-font-size: ;
+  // --ard-password-input-font-size-compact: ;
+  --ard-password-input-line-height: 1.25;
+  --ard-password-input-line-height-compact: 1;
+  --ard-password-input-font-weight: 400;
+  // --ard-password-input-padding-top: ;
+  // --ard-password-input-padding-right: ;
+  // --ard-password-input-padding-bottom: ;
+  // --ard-password-input-padding-left: ;
+  // --ard-password-input-padding-top-compact: ;
+  // --ard-password-input-padding-right-compact: ;
+  // --ard-password-input-padding-bottom-compact: ;
+  // --ard-password-input-padding-left-compact: ;
+  // --ard-password-input-color: ;
+  // --ard-password-input-placeholder-color: ;
+  --ard-password-input-placeholder-opacity: 60%;
+
+  --ard-password-input-min-width: 10rem;
+  --ard-password-input-max-width: 100%;
+  --ard-password-input-disabled-opacity: 50%;
+  --ard-password-input-reveal-button-margin: 0.125rem;
+  --ard-password-input-reveal-button-font-size: 0.8rem;
+  --ard-password-input-reveal-button-height: calc(100% - 0.25rem);
+  --ard-password-input-reveal-button-width: unset;
+  --ard-password-input-reveal-button-aspect-ratio: 1;
+  --ard-password-input-reveal-button-padding: 0;
+  // --ard-password-input-reveal-button-color: ;
+  --ard-password-input-reveal-button-border-radius: 9999px;
+  --ard-password-input-reveal-button-border: none;
+  --ard-password-input-reveal-button-background: transparent;
+  --ard-password-input-reveal-button-hover-background: rgba(0, 0, 0, 4%);
+  --ard-password-input-reveal-button-focus-background: rgba(0, 0, 0, 12%);
+  --ard-password-input-reveal-button-active-background: rgba(0, 0, 0, 20%);
+}
+
 .ard-password-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+  @include inputMixin.genericInput(
+    var(--ard-password-input-height, var(--ard-form-field-height, 2.3125rem)),
+    var(--ard-password-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+    var(--ard-password-input-gap, 0.625rem),
+    var(--ard-password-input-font-size, var(--ard-form-field-font-size, 1rem)),
+    var(--ard-password-input-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+    var(--ard-password-input-line-height, 1.25),
+    var(--ard-password-input-line-height-compact, 1),
+    var(--ard-password-input-font-weight, 400),
+    var(--ard-password-input-padding-top, var(--ard-form-field-padding-top, 0)),
+    var(--ard-password-input-padding-right, var(--ard-form-field-padding-right, 0.375rem)),
+    var(--ard-password-input-padding-bottom, var(--ard-form-field-padding-bottom, 0)),
+    var(--ard-password-input-padding-left, var(--ard-form-field-padding-left, 0.375rem)),
+    var(--ard-password-input-padding-top-compact, var(--ard-form-field-padding-top-compact, 0)),
+    var(--ard-password-input-padding-right-compact, var(--ard-form-field-padding-right-compact, 0.375rem)),
+    var(--ard-password-input-padding-bottom-compact, var(--ard-form-field-padding-bottom-compact, 0)),
+    var(--ard-password-input-padding-left-compact, var(--ard-form-field-padding-left-compact, 0.375rem)),
+    var(--ard-password-input-color, #{ARD.$text}),
+    var(--ard-password-input-placeholder-color, #{ARD.$text}),
+    var(--ard-password-input-placeholder-opacity, 60%)
+  );
+  min-width: var(--ard-password-input-min-width, 10rem);
+  max-width: var(--ard-password-input-max-width, 100%);
 
   &.ard-revealable {
     padding-right: 0;
@@ -17,27 +77,36 @@
     display: flex;
     align-items: center;
     justify-content: center;
-    padding: 0;
-    margin: 0.125rem;
-    height: calc(100% - 0.25rem);
-    aspect-ratio: 1;
-    font-size: 0.8rem;
-    border-radius: 9999px;
-    border: none;
-    background: transparent;
+    padding: var(--ard-password-input-reveal-button-padding, 0);
+    color: var(--ard-password-input-reveal-button-color, #{ARD.$text});
+    margin: var(--ard-password-input-reveal-button-margin, 0.125rem);
+    height: var(--ard-password-input-reveal-button-height, calc(100% - 0.25rem));
+    width: var(--ard-password-input-reveal-button-width, unset);
+    aspect-ratio: var(--ard-password-input-reveal-button-aspect-ratio, 1);
+    font-size: var(--ard-password-input-reveal-button-font-size, 0.8rem);
+    border-radius: var(--ard-password-input-reveal-button-border-radius, 9999px);
+    border: var(--ard-password-input-reveal-button-border, none);
+    background: var(--ard-password-input-reveal-button-background, transparent);
     outline: none;
     cursor: pointer;
 
     transition: background-color 0.2s ARD.$timing-fn;
 
     &:hover {
-      background: rgba(0, 0, 0, 4%);
+      background: var(--ard-password-input-reveal-button-hover-background, rgba(0, 0, 0, 4%));
     }
     &:focus {
-      background: rgba(0, 0, 0, 12%);
+      background: var(--ard-password-input-reveal-button-focus-background, rgba(0, 0, 0, 12%));
     }
     &:active {
-      background: rgba(0, 0, 0, 20%);
+      background: var(--ard-password-input-reveal-button-active-background, rgba(0, 0, 0, 20%));
     }
   }
 }
+//! disabled state
+.ard-disabled {
+  .ard-password-input {
+    pointer-events: none;
+    opacity: var(--ard-password-input-disabled-opacity, 50%);
+  }
+}

package/themes/default/kbd-shortcut.scss

@@ -1,13 +1,19 @@
 @use '../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  --ard-kbd-shortcut-font-size: 0.875em;
+  --ard-kbd-shortcut-transparent-font-size: 0.75em;
+}
+
 .ard-kbd-shortcut {
-  font-family: monospace;
-  color: ARD.$text2;
+  font-family: var(--ard-font-family-mono);
 
   > span {
-    font-size: 0.9em;
+    font-size: var(--ard-kbd-shortcut-font-size, 0.875em);
   }
   &.ard-appearance-transparent > span {
-    font-size: 0.75em;
+    font-size: var(--ard-kbd-shortcut-transparent-font-size, 0.75em);
   }
 }

package/themes/default/kbd.scss

@@ -1,21 +1,38 @@
 @use '../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-kbd-font-size: ;
+  --ard-kbd-border-radius: 0.1875em;
+  --ard-kbd-margin: 0 0.125em;
+  --ard-kbd-padding: 0.125em 0.375em;
+  --ard-kbd-border-width: 1px;
+  --ard-kbd-border-style: solid;
+  --ard-kbd-border-color: ;
+  --ard-kbd-box-shadow-settings: inset 0 -1px 0;
+  // --ard-kbd-box-shadow-color: ;
+  // --ard-kbd-bg: ;
+  // --ard-kbd-filled-bg: ;
+}
+
 .ard-kbd {
-  border-radius: 0.2em;
-  font-family: monospace;
-  font-size: 0.9em;
-  margin: 0 0.125em;
+  border-radius: var(--ard-kbd-border-radius, 0.1875em);
+  font-family: var(--ard-font-family-mono);
+  font-size: var(--ard-kbd-font-size, 0.875em);
+  margin: var(--ard-kbd-margin, 0 0.125em);
   color: ARD.$text2;
 
   //! appearance
   &.ard-appearance-outlined,
   &.ard-appearance-filled {
-    border: 1px solid ARD.$detail-ultralight;
-    box-shadow: inset 0 -1px 0 ARD.$darken-overlay;
-    padding: 0.15em 0.35em;
-    background-color: ARD.$bg;
+    border: var(--ard-kbd-border-width, 1px) var(--ard-kbd-border-style, solid)
+      var(--ard-kbd-border-color, #{ARD.$detail-ultralight});
+    box-shadow: var(--ard-kbd-box-shadow-settings, inset 0 -1px 0) var(--ard-kbd-box-shadow-color, #{ARD.$detail-light});
+    padding: var(--ard-kbd-padding, 0.125em 0.375em);
+    background-color: var(--ard-kbd-bg, #{ARD.$bg});
   }
   &.ard-appearance-filled {
-    background: ARD.$bg-d;
+    background: var(--ard-kbd-filled-bg, #{ARD.$bg-d});
   }
 }

package/themes/default/modal.scss

@@ -1,5 +1,33 @@
 @use '../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-modal-width: ;
+  // --ard-modal-height: ;
+  // --ard-modal-min-width: ;
+  // --ard-modal-min-height: ;
+  // --ard-modal-max-width: ;
+  // --ard-modal-max-height: ;
+  --ard-modal-viewport-spacing: 2rem;
+  --ard-modal-padding: 1.25rem;
+  --ard-modal-padding-top: 1rem;
+  --ard-modal-gap: 1.5rem;
+  // --ard-modal-bg: ;
+  --ard-modal-no-heading-gap: 0.25rem;
+  --ard-modal-close-button-offset: 0.5rem;
+  --ard-modal-heading-padding-right: 2rem;
+  --ard-modal-heading-font-size: 1.25rem;
+  --ard-modal-heading-font-weight: 500;
+  // --ard-modal-heading-color: ;
+  --ard-modal-rounded-border-radius: 8px;
+  --ard-modal-font-size: 1rem;
+  --ard-modal-font-size-compact: 0.875rem;
+  --ard-modal-padding-compact: 0.75rem 2rem 1rem 2rem;
+  --ard-modal-gap-compact: 1rem;
+  --ard-modal-close-button-offset-compact: 0.25rem;
+}
+
 .ard-modal {
   position: fixed;
   top: 0;
@@ -13,28 +41,34 @@
     background: ARD.$darken-overlay-strong;
   }
   .ard-modal-panel {
-    padding: 1.25rem;
-    padding-top: 1rem;
-    background: ARD.$bg;
-    max-width: calc(100vw - 4rem);
+    padding: var(--ard-modal-padding, 1.25rem);
+    padding-top: var(--ard-modal-padding-top, 1rem);
+    width: var(--ard-modal-width);
+    height: var(--ard-modal-height);
+    min-width: var(--ard-modal-min-width);
+    min-height: var(--ard-modal-min-height);
+    max-width: var(--ard-modal-max-width, calc(100vw - var(--ard-modal-viewport-spacing, 2rem) * 2));
+    max-height: var(--ard-modal-max-height, calc(100vh - var(--ard-modal-viewport-spacing, 2rem) * 2));
+    background: var(--ard-modal-bg, #{ARD.$bg});
     position: relative;
     display: flex;
     flex-direction: column;
     align-items: flex-start;
-    gap: 1.5rem;
+    gap: var(--ard-modal-gap, 1.5rem);
+    font-size: 1rem;
 
     &.ard-modal-no-heading-text {
-      gap: 0.25rem;
+      gap: var(--ard-modal-no-heading-gap, 0.25rem);
 
       .ard-modal-close-button {
         position: absolute;
-        right: 0.5rem;
-        top: 0.5rem;
+        right: var(--ard-modal-close-button-offset, 0.5rem);
+        top: var(--ard-modal-close-button-offset, 0.5rem);
       }
     }
     &.ard-modal-has-close-button {
       .ard-modal-heading {
-        padding-right: 2rem;
+        padding-right: var(--ard-modal-heading-padding-right, 2rem);
       }
     }
   }
@@ -44,15 +78,15 @@
     justify-content: space-between;
 
     .ard-modal-heading-text {
-      font-size: 1.25rem;
-      color: ARD.$text;
-      font-weight: 500;
-      font-family: Roboto;
+      font-size: var(--ard-modal-heading-font-size, 1.25rem);
+      color: var(--ard-modal-heading-color, #{ARD.$text});
+      font-weight: var(--ard-modal-heading-font-weight, 500);
+      font-family: var(--ard-font-family);
     }
     .ard-modal-close-button {
       position: absolute;
-      right: 0.5rem;
-      top: 0.5rem;
+      right: var(--ard-modal-close-button-offset, 0.5rem);
+      top: var(--ard-modal-close-button-offset, 0.5rem);
     }
   }
   //! appearances
@@ -64,7 +98,7 @@
   //! variants
   &.ard-variant-rounded {
     .ard-modal-panel {
-      border-radius: 8px;
+      border-radius: var(--ard-modal-rounded-border-radius, 8px);
     }
   }
   &.ard-variant-sharp {
@@ -76,17 +110,17 @@
   //! compact
   &.ard-compact {
     .ard-modal-panel {
-      font-size: 90%;
-      padding: 0.75rem 2rem 1rem 2rem;
-      gap: 1rem;
+      font-size: var(--ard-modal-font-size-compact, 0.875rem);
+      padding: var(--ard-modal-padding-compact, 0.75rem 2rem 1rem 2rem);
+      gap: var(--ard-modal-gap-compact, 1rem);
 
       &.ard-modal-no-heading-text {
-        gap: 0.25rem;
+        gap: var(--ard-modal-no-heading-gap, 0.25rem);
 
         .ard-modal-close-button {
           position: absolute;
-          right: 0.25rem;
-          top: 0.25rem;
+          right: var(--ard-modal-close-button-offset-compact, 0.25rem);
+          top: var(--ard-modal-close-button-offset-compact, 0.25rem);
         }
       }
     }

package/themes/default/progress-circle.scss

@@ -1,9 +1,20 @@
 @use './coloring' as coloringMixins;
 @use '../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  --ard-progress-circle-size: 3em;
+  // --ard-progress-circle-colorless-background-color: ;
+  --ard-progress-circle-colorless-background-opacity: 100%;
+  --ard-progress-circle-colored-background-opacity: 100%;
+  --ard-progress-circle-value-font-size: 0.875em;
+}
+
 .ard-progress-circle {
   @include coloringMixins.typeColors;
-  width: 3em;
+  width: var(--ard-progress-circle-size, 3em);
+  height: var(--ard-progress-circle-size, 3em);
 
   --ard-_progress-circle-fill-color: var(--ard-cmpcl--bg-colored);
 
@@ -15,20 +26,15 @@
   }
   &.ard-appearance-colorless {
     .ard-progress-circle-background {
-      background: ARD.$darken-overlay-medium;
+      background: var(--ard-progress-circle-colorless-background-color, #{ARD.$darken-overlay-medium});
+      opacity: var(--ard-progress-circle-colorless-background-opacity, 100%);
     }
   }
   &.ard-appearance-colored {
     .ard-progress-circle-background {
-      opacity: 16%;
+      opacity: var(--ard-progress-circle-colored-background-opacity, 100%);
       background: var(--ard-cmpcl--bg-colored);
     }
-    //special case for no coloring
-    &.ard-color-none {
-      .ard-progress-circle-background {
-        opacity: 8%;
-      }
-    }
   }
   //! ring variant
   &.ard-progress-circle-variant-ring {
@@ -46,7 +52,7 @@
     top: 50%;
     transform: translate(-50%, -50%);
     font-weight: bold;
-    font-size: 0.9em;
+    font-size: var(--ard-progress-circle-value-font-size, 0.875em);
   }
   &.ard-progress-circle-variant-full {
     .ard-progress-circle-value {