@ardium-ui/ui 5.0.0-alpha.1 → 5.0.0-alpha.100

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

@@ -3,25 +3,79 @@
 @use '../clear-button' as CB;
 @use '../../variables' as ARD;
 
-.ard-hex-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+@layer ard-ui {
+  // the variables are commented out intentionally
+  // read more in docs/dev/css-variables.md
+  :root {
+    // --ard-hex-input-height: ;
+    // --ard-hex-input-height-compact: ;
+    --ard-hex-input-gap: 0.625rem;
+    // --ard-hex-input-font-size: ;
+    // --ard-hex-input-font-size-compact: ;
+    --ard-hex-input-line-height: 1.25;
+    --ard-hex-input-line-height-compact: 1;
+    --ard-hex-input-font-weight: 400;
+    // --ard-hex-input-padding-top: ;
+    // --ard-hex-input-padding-right: ;
+    // --ard-hex-input-padding-bottom: ;
+    // --ard-hex-input-padding-left: ;
+    // --ard-hex-input-padding-top-compact: ;
+    // --ard-hex-input-padding-right-compact: ;
+    // --ard-hex-input-padding-bottom-compact: ;
+    // --ard-hex-input-padding-left-compact: ;
+    // --ard-hex-input-color: ;
+    // --ard-hex-input-placeholder-color: ;
+    --ard-hex-input-placeholder-opacity: 60%;
+    // --ard-hex-input-readonly-cursor: ;
 
-  @include CB.clearButton();
+    --ard-hex-input-min-width: 10rem;
+    --ard-hex-input-max-width: 100%;
+    // --ard-hex-input-hash-color: ;
+    --ard-hex-input-hash-opacity: 70%;
+  }
+
+  .ard-hex-input {
+    @include inputMixin.genericInput(
+      var(--ard-hex-input-height, var(--ard-form-field-height, 2.3125rem)),
+      var(--ard-hex-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+      var(--ard-hex-input-gap, 0.625rem),
+      var(--ard-hex-input-font-size, var(--ard-form-field-font-size, 1rem)),
+      var(--ard-hex-input-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+      var(--ard-hex-input-line-height, 1.25),
+      var(--ard-hex-input-line-height-compact, 1),
+      var(--ard-hex-input-font-weight, 400),
+      var(--ard-hex-input-padding-top, var(--ard-form-field-padding-top, 0)),
+      var(--ard-hex-input-padding-right, var(--ard-form-field-padding-right, 0.375rem)),
+      var(--ard-hex-input-padding-bottom, var(--ard-form-field-padding-bottom, 0)),
+      var(--ard-hex-input-padding-left, var(--ard-form-field-padding-left, 0.375rem)),
+      var(--ard-hex-input-padding-top-compact, var(--ard-form-field-padding-top-compact, 0)),
+      var(--ard-hex-input-padding-right-compact, var(--ard-form-field-padding-right-compact, 0.375rem)),
+      var(--ard-hex-input-padding-bottom-compact, var(--ard-form-field-padding-bottom-compact, 0)),
+      var(--ard-hex-input-padding-left-compact, var(--ard-form-field-padding-left-compact, 0.375rem)),
+      var(--ard-hex-input-color, #{ARD.$text}),
+      var(--ard-hex-input-placeholder-color, #{ARD.$text}),
+      var(--ard-hex-input-placeholder-opacity, 60%),
+      var(--ard-hex-input-readonly-cursor, var(--ard-readonly-cursor, default))
+    );
+    min-width: var(--ard-hex-input-min-width, 10rem);
+    max-width: var(--ard-hex-input-max-width, 100%);
+
+    @include CB.clearButton();
 
-  .ard-input-container {
-    input {
-      font-family: monospace;
+    .ard-input-container {
+      input {
+        font-family: var(--ard-font-family-mono);
+      }
     }
-  }
 
-  .ard-hash-container {
-    margin-right: -0.5rem;
-    color: ARD.$text3;
-    opacity: 70%;
-    user-select: none;
-    font-family: monospace;
+    .ard-hash-container {
+      color: var(--ard-hex-input-hash-color, #{ARD.$text});
+      opacity: var(--ard-hex-input-hash-opacity, 70%);
+      user-select: none;
+      font-family: var(--ard-font-family-mono);
+      display: flex;
+      align-items: center;
+      height: 100%;
+    }
   }
 }

package/themes/default/inputs/input.scss

@@ -1,12 +1,63 @@
 @use './shared' as inputMixin;
 @use '../mixins' as defaultMixins;
 @use '../clear-button' as CB;
+@use '../../variables' as ARD;
 
-.ard-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+@layer ard-ui {
+  // 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-readonly-cursor: ;
 
-  @include CB.clearButton();
+    --ard-input-min-width: 10rem;
+    --ard-input-max-width: 100%;
+  }
+
+  .ard-input {
+    @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%),
+      var(--ard-input-readonly-cursor, var(--ard-readonly-cursor, default))
+    );
+    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,130 +2,213 @@
 @use '../mixins' as defaultMixins;
 @use '../../variables' as ARD;
 
-ard-number-input {
-  width: 9.5rem;
-
-  &:not(:has(.ard-quick-change-button)) {
-    width: 6rem;
+@layer ard-ui {
+  // 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.375rem;
+    // --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;
+    // --ard-number-input-readonly-cursor: ;
   }
-}
-
-.ard-number-input {
-  @include inputMixin.genericInput();
-  @include defaultMixins.formAppearances();
-  min-height: 2.1875rem;
-  height: 2.1875rem;
-  gap: 0;
-  width: 100%;
 
-  .ard-input-container {
-    height: 100%;
-    max-width: 100%;
-
-    & > input {
-      width: 100%;
-    }
+  ard-number-input {
+    width: var(--ard-number-input-width, unset);
   }
 
-  .ard-quick-change-button {
-    position: relative;
-
-    .ard-button {
+  .ard-number-input {
+    @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)),
+      0,
+      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),
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      var(--ard-number-input-color, #{ARD.$text}),
+      var(--ard-number-input-placeholder-color, #{ARD.$text}),
+      var(--ard-number-input-placeholder-opacity, 60%),
+      var(--ard-number-input-readonly-cursor, var(--ard-readonly-cursor, default))
+    );
+    @include defaultMixins.formAppearances();
+    gap: 0;
+    width: 100%;
+
+    .ard-number-input-wrapper {
+      flex-grow: 1;
+      text-size-adjust: 100%;
+      display: flex;
+      align-items: center;
       height: 100%;
-      aspect-ratio: 1;
-      padding: 0;
-      border-color: var(--ard-appearance-border-color);
+      gap: var(--ard-number-input-gap, 0.375rem);
+    }
+    .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));
+    }
+
+    //! prefix & suffix
+    .ard-number-input-prefix-container,
+    .ard-number-input-suffix-container {
+      height: max-content;
+      max-height: 100%;
       display: flex;
-      justify-content: center;
-      margin: 0;
+      align-items: center;
+    }
+    .ard-number-input-prefix-container {
+      padding-left: var(--ard-number-input-gap, 0.375rem);
     }
-    &.ard-disabled .ard-focus-overlay {
-      opacity: 0;
+    .ard-number-input-suffix-container {
+      padding-right: var(--ard-number-input-gap, 0.375rem);
     }
 
-    &.decrement {
-      left: 1px;
+    //! buttons
+    .ard-quick-change-button {
+      position: relative;
+      min-width: var(--ard-number-input-height, var(--ard-form-field-height, 2.3125rem));
 
       .ard-button {
-        border-top-right-radius: 0;
-        border-bottom-right-radius: 0;
+        height: 100%;
+        aspect-ratio: 1;
+        padding: 0;
+        border-color: var(--ard-appearance-border-color);
+        display: flex;
+        justify-content: center;
+        margin: 0;
+      }
+      &.ard-disabled .ard-focus-overlay {
+        opacity: 0;
       }
-    }
-    &.increment {
-      right: 1px;
 
-      .ard-button {
-        border-top-left-radius: 0;
-        border-bottom-left-radius: 0;
+      &.decrement {
+        left: 1px;
+
+        .ard-button {
+          border-top-right-radius: 0;
+          border-bottom-right-radius: 0;
+        }
+      }
+      &.increment {
+        right: 1px;
+
+        .ard-button {
+          border-top-left-radius: 0;
+          border-bottom-left-radius: 0;
+        }
       }
     }
-  }
 
-  //! variants
-  &.ard-variant-rounded {
-    border-radius: 8px;
+    //! variants
+    &.ard-variant-rounded {
+      border-radius: var(--ard-number-input-rounded-border-radius, 8px);
 
-    &.ard-quick-change-false {
-      .ard-input-container {
-        border-radius: 8px;
+      &.ard-quick-change-false {
+        .ard-number-input-wrapper {
+          border-radius: var(--ard-number-input-rounded-border-radius, 8px);
+        }
       }
     }
-  }
-  &.ard-variant-sharp {
-    border-radius: 0;
-  }
-  &.ard-variant-pill {
-    border-radius: 9999px;
-
-    .ard-button {
-      border-radius: 9999px !important;
-      height: 30px;
-      width: 30px;
-      margin: 0 2px;
+    &.ard-variant-sharp {
+      border-radius: 0;
     }
+    &.ard-variant-pill {
+      border-radius: 9999px;
 
-    &.ard-quick-change-false {
-      .ard-input-container {
-        border-radius: 9999px;
+      .ard-button {
+        border-radius: 9999px !important;
+        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-number-input-wrapper {
+          border-radius: 9999px;
+        }
       }
     }
-  }
 
-  //! variant-specific appearances
-  &.ard-variant-rounded,
-  &.ard-variant-sharp {
-    &:not(.ard-appearance-filled) .ard-input-container {
-      box-sizing: border-box;
-      background: var(--ard-appearance-background);
-      border: var(--ard-appearance-border);
+    //! variant-specific appearances
+    &.ard-variant-rounded,
+    &.ard-variant-sharp {
+      &:not(.ard-appearance-filled) .ard-number-input-wrapper {
+        box-sizing: border-box;
+        background: var(--ard-appearance-background);
+        border: var(--ard-appearance-border);
+      }
+      &.ard-appearance-filled {
+        background: var(--ard-appearance-background);
+        border: var(--ard-appearance-border);
+      }
     }
-    &.ard-appearance-filled {
+    &.ard-variant-pill {
       background: var(--ard-appearance-background);
       border: var(--ard-appearance-border);
     }
-  }
-  &.ard-variant-pill {
-    background: var(--ard-appearance-background);
-    border: var(--ard-appearance-border);
-  }
 
-  //! compact
-  &.ard-compact {
-    min-height: 1.6875rem;
-    height: 1.6875rem;
-    font-size: 0.925rem;
+    //! compact
+    &.ard-compact {
+      .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%;
-
-    .ard-button .ard-focus-overlay {
-      opacity: 0;
+  .ard-disabled,
+  .ard-readonly {
+    > .ard-number-input {
+      .ard-button .ard-focus-overlay {
+        opacity: 0;
+      }
+    }
+  }
+  .ard-disabled {
+    > .ard-number-input {
+      pointer-events: none;
+      opacity: var(--ard-number-input-disabled-opacity, 50%);
+      background: ARD.$bg-f;
+    }
+  }
+  .ard-readonly {
+    > .ard-number-input {
+      cursor: var(--ard-number-input-readonly-cursor, var(--ard-readonly-cursor, default));
     }
-
-    background: ARD.$bg-f;
   }
 }

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

@@ -3,41 +3,114 @@
 @use '../clear-button' as CB;
 @use '../../variables' as ARD;
 
-.ard-password-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+@layer ard-ui {
+  // 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-readonly-cursor: ;
 
-  &.ard-revealable {
-    padding-right: 0;
+    --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-reveal-button {
-    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;
-    outline: none;
-    cursor: pointer;
+  .ard-password-input {
+    @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%),
+      var(--ard-password-input-readonly-cursor, var(--ard-readonly-cursor, default))
+    );
+    min-width: var(--ard-password-input-min-width, 10rem);
+    max-width: var(--ard-password-input-max-width, 100%);
 
-    transition: background-color 0.2s ARD.$timing-fn;
-
-    &:hover {
-      background: rgba(0, 0, 0, 4%);
+    &.ard-revealable {
+      padding-right: 0;
     }
-    &:focus {
-      background: rgba(0, 0, 0, 12%);
+
+    .ard-reveal-button {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      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: var(--ard-password-input-reveal-button-hover-background, rgba(0, 0, 0, 4%));
+      }
+      &:focus {
+        background: var(--ard-password-input-reveal-button-focus-background, rgba(0, 0, 0, 12%));
+      }
+      &:active {
+        background: var(--ard-password-input-reveal-button-active-background, rgba(0, 0, 0, 20%));
+      }
     }
-    &: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,21 @@
 @use '../variables' as ARD;
 
-.ard-kbd-shortcut {
-  font-family: monospace;
-  color: ARD.$text2;
-
-  > span {
-    font-size: 0.9em;
+@layer ard-ui {
+  // 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-appearance-transparent > span {
-    font-size: 0.75em;
+
+  .ard-kbd-shortcut {
+    font-family: var(--ard-font-family-mono);
+
+    > span {
+      font-size: var(--ard-kbd-shortcut-font-size, 0.875em);
+    }
+    &.ard-appearance-transparent > span {
+      font-size: var(--ard-kbd-shortcut-transparent-font-size, 0.75em);
+    }
   }
 }