@ardium-ui/ui 5.0.0-alpha.6 → 5.0.0-alpha.61

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

@@ -4,18 +4,73 @@
 @use '../coloring' as CM;
 @use '../../variables' as ARD;
 
+// the variables are commented out intentionally
+// read more in docs/dev/css-variables.md
+:root {
+  // --ard-file-input-height: ;
+  // --ard-file-input-height-compact: ;
+  --ard-file-input-gap: 0.625rem;
+  // --ard-file-input-font-size: ;
+  // --ard-file-input-font-size-compact: ;
+  --ard-file-input-line-height: 1.25;
+  --ard-file-input-line-height-compact: 1;
+  --ard-file-input-font-weight: 400;
+  // --ard-file-input-padding: ;
+  // --ard-file-input-padding-compact: ;
+  // --ard-file-input-color: ;
+  // --ard-file-input-placeholder-color: ;
+  --ard-file-input-placeholder-opacity: 60%;
+
+  --ard-file-input-min-width: 10rem;
+  --ard-file-input-max-width: 100%;
+  --ard-file-input-gap: 0.375rem;
+  --ard-file-input-dragover-outline-width: 2px;
+  --ard-file-input-dragover-outline-style: solid;
+  --ard-file-input-browse-button-height: calc(100% - 0.25rem);
+  --ard-file-input-browse-button-width: unset;
+  --ard-file-input-browse-button-margin: 0.125rem;
+  --ard-file-input-browse-button-aspect-ratio: 1;
+  --ard-file-input-browse-button-border: none;
+  --ard-file-input-browse-button-border-radius: 9999px;
+  --ard-file-input-browse-button-background: none;
+  --ard-file-input-browse-button-padding: 0;
+  // --ard-file-input-browse-button-color: ;
+  // --ard-file-input-browse-button-color-error: ;
+  --ard-file-input-browse-button-overlay-offset: 0rem;
+  // --ard-file-input-browse-button-overlay-color: ;
+  --ard-file-input-browse-button-overlay-hover-opacity: 4%;
+  --ard-file-input-browse-button-overlay-focus-opacity: 0;
+  --ard-file-input-browse-button-overlay-active-opacity: 12%;
+  --ard-file-input-browse-button-overlay-focus-visible-opacity: 16%;
+  --ard-file-input-file-name-font-weight: 500;
+  --ard-file-input-file-ext-font-weight: 500;
+}
+
 .ard-file-input-form-field-frame {
   .ard-form-field-overlay {
     display: none;
   }
 }
 .ard-file-input {
+  @include inputMixin.genericInput(
+    var(--ard-file-input-height, var(--ard-form-field-height, 2.3125rem)),
+    var(--ard-file-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+    var(--ard-file-input-gap, 0.625rem),
+    var(--ard-file-input-font-size, var(--ard-form-field-font-size, 1rem)),
+    var(--ard-file-input-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+    var(--ard-file-input-line-height, 1.25),
+    var(--ard-file-input-line-height-compact, 1),
+    var(--ard-file-input-font-weight, 400),
+    var(--ard-file-input-padding, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-file-input-padding-compact, var(--ard-form-field-padding-compact, 0 0.375rem)),
+    var(--ard-file-input-color, #{ARD.$text}),
+    var(--ard-file-input-placeholder-color, #{ARD.$text}),
+    var(--ard-file-input-placeholder-opacity, 60%)
+  );
   @include CM.typeColors();
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
-  gap: 0.375rem;
+  min-width: var(--ard-file-input-min-width, 10rem);
+  max-width: var(--ard-file-input-max-width, 100%);
+  gap: var(--ard-file-input-gap, 0.375rem);
   cursor: default;
   border-radius: var(--ard-variant-border-radius);
 
@@ -25,23 +80,25 @@
   }
 
   &.ard-state-dragover {
-    outline: 2px solid var(--ard-cmpcl--content-light);
+    outline: var(--ard-file-input-dragover-outline-width, 2px) var(--ard-file-input-dragover-outline-style, solid)
+      var(--ard-cmpcl--content-light);
   }
 
   .ard-file-input__value {
-    font-size: 92%;
     overflow: hidden;
     text-overflow: ellipsis;
-    max-height: 1.25rem;
   }
   .ard-browse-button {
     cursor: pointer;
-    height: calc(100% - 0.25rem);
-    margin: 0.125rem;
-    aspect-ratio: 1;
-    border: none;
-    background: none;
-    padding: 0;
+    height: var(--ard-file-input-browse-button-height, calc(100% - 0.25rem));
+    width: var(--ard-file-input-browse-button-width, unset);
+    margin: var(--ard-file-input-browse-button-margin, 0.125rem);
+    aspect-ratio: var(--ard-file-input-browse-button-aspect-ratio, 1);
+    border: var(--ard-file-input-browse-button-border, none);
+    border-radius: var(--ard-file-input-browse-button-border-radius, 9999px);
+    background: var(--ard-file-input-browse-button-background, none);
+    padding: var(--ard-file-input-browse-butto-padding, 0);
+    color: var(--ard-file-input-browse-button-color, #{ARD.$text});
     position: relative;
     display: flex;
     justify-content: center;
@@ -49,28 +106,28 @@
     outline: none;
 
     .ard-focus-overlay {
-      @include defaultMixins.focus-overlay(0.25rem);
-      background: ARD.$overlay;
-      border-radius: 9999px;
+      @include defaultMixins.focus-overlay(var(--ard-file-input-browse-button-overlay-offset, 0.25rem));
+      background: var(--ard-file-input-browse-button-overlay-color, #{ARD.$overlay});
+      border-radius: var(--ard-file-input-browse-button-border-radius, 9999px);
     }
     &:hover {
       .ard-focus-overlay {
-        opacity: 4%;
+        opacity: var(--ard-file-input-browse-button-overlay-hover-opacity, 4%);
       }
     }
     &:focus {
       .ard-focus-overlay {
-        opacity: 8%;
+        opacity: var(--ard-file-input-browse-button-overlay-focus-opacity, 8%);
       }
     }
     &:active {
       .ard-focus-overlay {
-        opacity: 12%;
+        opacity: var(--ard-file-input-browse-button-overlay-active-opacity, 12%);
       }
     }
     &:focus-visible {
       .ard-focus-overlay {
-        opacity: 16%;
+        opacity: var(--ard-file-input-browse-button-overlay-focus-visible-opacity, 16%);
       }
     }
   }
@@ -92,7 +149,13 @@
   .ard-file-input__full-file-name {
     display: grid;
     grid-template-columns: 1fr max-content;
-    font-weight: 500;
+
+    .ard-file-input__file-name {
+      font-weight: var(--ard-file-input-file-name-font-weight, 500);
+    }
+    .ard-file-input__file-ext {
+      font-weight: var(--ard-file-input-file-ext-font-weight, 500);
+    }
   }
 }
 ard-file-input .ard-form-field-content-container {
@@ -102,7 +165,7 @@ ard-file-input .ard-form-field-frame {
   &.ard-has-error .ard-file-input {
     .ard-file-input__value,
     .ard-browse-button {
-      color: ARD.$danger700;
+      color: var(--ard-file-input-browse-button-color-error, #{ARD.$danger700});
     }
   }
 }

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

@@ -3,25 +3,62 @@
 @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-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: ;
+  // --ard-hex-input-padding-compact: ;
+  // --ard-hex-input-color: ;
+  // --ard-hex-input-placeholder-color: ;
+  --ard-hex-input-placeholder-opacity: 60%;
+
+  --ard-hex-input-min-width: 10rem;
+  --ard-hex-input-max-width: 100%;
+  --ard-hex-input-hash-margin: 0 0 -0.5rem 0;
+  // --ard-hex-input-hash-color: ;
+  --ard-hex-input-hash-opacity: 70%;
+}
+
 .ard-hex-input {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+  @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, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-hex-input-padding-compact, var(--ard-form-field-padding-compact, 0 0.375rem)),
+    var(--ard-hex-input-color, #{ARD.$text}),
+    var(--ard-hex-input-placeholder-color, #{ARD.$text}),
+    var(--ard-hex-input-placeholder-opacity, 60%)
+  );
+  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;
+      font-family: var(--ard-font-family-mono);
     }
   }
 
   .ard-hash-container {
-    margin-right: -0.5rem;
-    color: ARD.$text3;
-    opacity: 70%;
+    margin: var(--ard-hex-input-hash-margin, 0 0 -0.5rem 0);
+    color: var(--ard-hex-input-hash-color, #{ARD.$text});
+    opacity: var(--ard-hex-input-hash-opacity, 70%);
     user-select: none;
-    font-family: monospace;
+    font-family: var(--ard-font-family-mono);
   }
 }

package/themes/default/inputs/input.scss

@@ -1,12 +1,47 @@
 @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: ;
+  // --ard-input-padding-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, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-input-padding-compact, var(--ard-form-field-padding-compact, 0 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,67 @@
 @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: ;
+  // --ard-number-input-padding-compact: ;
+  // --ard-number-input-color: ;
+  // --ard-number-input-placeholder-color: ;
+  --ard-number-input-placeholder-opacity: 60%;
+
+  // --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, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-number-input-padding-compact, var(--ard-form-field-padding-compact, 0 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 {
     height: 100%;
     max-width: 100%;
+    padding: var(--ard-number-input-padding, var(--ard-form-field-padding, 0 0.375rem));
 
     & > input {
       width: 100%;
     }
   }
+  .ard-placeholder {
+    padding: var(--ard-number-input-padding, var(--ard-form-field-padding, 0 0.375rem));
+  }
 
   .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 +97,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;
+        border-radius: var(--ard-number-input-rounded-border-radius, 8px);
       }
     }
   }
@@ -79,8 +113,8 @@ 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;
     }
 
@@ -111,9 +145,15 @@ ard-number-input {
 
   //! compact
   &.ard-compact {
-    min-height: 1.6875rem;
-    height: 1.6875rem;
-    font-size: 0.925rem;
+    .ard-input-container {
+      padding: var(--ard-number-input-padding-compact, var(--ard-form-field-padding-compact, 0 0.375rem));
+    }
+    .ard-placeholder {
+      padding: var(--ard-number-input-padding-compact, var(--ard-form-field-padding-compact, 0 0.375rem));
+    }
+    .ard-quick-change-button {
+      min-width: var(--ard-number-input-height-compact, var(--ard-form-field-height-compact, 1.6875rem));
+    }
   }
 }
 

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

@@ -3,11 +3,59 @@
 @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: ;
+  // --ard-password-input-padding-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, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-password-input-padding-compact, var(--ard-form-field-padding-compact, 0 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 +65,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/inputs/search-bar.scss

@@ -1,12 +1,48 @@
 @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-search-bar-height: ;
+  // --ard-search-bar-height-compact: ;
+  --ard-search-bar-gap: 0.625rem;
+  // --ard-search-bar-font-size: ;
+  // --ard-search-bar-font-size-compact: ;
+  --ard-search-bar-line-height: 1.25;
+  --ard-search-bar-line-height-compact: 1;
+  --ard-search-bar-font-weight: 400;
+  // --ard-search-bar-padding: ;
+  // --ard-search-bar-padding-compact: ;
+  // --ard-search-bar-color: ;
+  // --ard-search-bar-placeholder-color: ;
+  --ard-search-bar-placeholder-opacity: 60%;
+
+  --ard-search-bar-min-width: 10rem;
+  --ard-search-bar-max-width: 100%;
+  --ard-search-bar-disabled-opacity: 50%;
+}
 
 .ard-search-bar {
-  @include inputMixin.genericInput();
-  padding: 0 0.375rem;
-  min-width: 10rem;
-  max-width: 100%;
+  @include inputMixin.genericInput(
+    var(--ard-search-bar-height, var(--ard-form-field-height, 2.3125rem)),
+    var(--ard-search-bar-height-compact, var(--ard-form-field-height-compact, 1.6875rem)),
+    var(--ard-search-bar-gap, 0.625rem),
+    var(--ard-search-bar-font-size, var(--ard-form-field-font-size, 1rem)),
+    var(--ard-search-bar-font-size-compact, var(--ard-form-field-font-size-compact, 0.875rem)),
+    var(--ard-search-bar-line-height, 1.25),
+    var(--ard-search-bar-line-height-compact, 1),
+    var(--ard-search-bar-font-weight, 400),
+    var(--ard-search-bar-padding, var(--ard-form-field-padding, 0 0.375rem)),
+    var(--ard-search-bar-padding-compact, var(--ard-form-field-padding-compact, 0 0.375rem)),
+    var(--ard-search-bar-color, #{ARD.$text}),
+    var(--ard-search-bar-placeholder-color, #{ARD.$text}),
+    var(--ard-search-bar-placeholder-opacity, 60%)
+  );
+  min-width: var(--ard-search-bar-min-width, 10rem);
+  max-width: var(--ard-search-bar-max-width, 100%);
 
   @include CB.clearButton();
 }
@@ -14,6 +50,6 @@
 .ard-disabled {
   .ard-search-bar {
     pointer-events: none;
-    opacity: 50%;
+    opacity: var(--ard-search-bar-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});
   }
 }