@carbon/web-components 2.62.0 → 2.63.0

package/scss/components/menu/menu.scss

@@ -1,5 +1,5 @@
 //
-// Copyright IBM Corp. 2024
+// Copyright IBM Corp. 2024, 2026
 //
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
@@ -13,6 +13,8 @@ $css--plex: true !default;
 @use '@carbon/styles/scss/motion' as *;
 @use '@carbon/styles/scss/utilities' as *;
 @use '@carbon/styles/scss/components/menu' as *;
+@use '@carbon/styles/scss/feature-flags' as flags;
+@use '@carbon/styles/scss/utilities/convert';
 @use './menu-variables' as *;
 
 :host(#{$prefix}-menu) {
@@ -27,6 +29,7 @@ $css--plex: true !default;
     pointer-events: none;
   }
 }
+
 .#{$prefix}--menu--with-icons {
   --grid-template: #{$spacing-05} 1fr max-content;
   --display-icon-item: flex;
@@ -93,3 +96,31 @@ $css--plex: true !default;
 .#{$prefix}--menu--lg {
   --block-size-value: 3rem;
 }
+
+// A submenu is spaced away from its parent menu item, so the pointer has to cross a
+// gap belonging to neither. This causes `mouseleave` to fire, closing the submenu prematurely
+//
+// This spans exactly that gap, stopping at the item's edge, so it covers only the
+// space in between.
+//
+// Visually, everything looks the same, but functionally, the submenu stays open since
+// the cursor technically never left it.
+:host(#{$prefix}-menu[ischild]) .#{$prefix}--menu {
+  &::before {
+    position: absolute;
+    content: '';
+    cursor: auto;
+    inline-size: $spacing-01;
+    inset-block: 0;
+    inset-inline-start: -$spacing-01;
+
+    @if flags.enabled('enable-v12-release') {
+      inline-size: convert.to-rem(6px);
+      inset-inline-start: calc(-1 * convert.to-rem(6px));
+    }
+  }
+
+  &--shown {
+    overflow: visible;
+  }
+}

package/scss/components/multi-select/multi-select.scss

@@ -1,5 +1,5 @@
 //
-// Copyright IBM Corp. 2026
+// Copyright IBM Corp. 2019, 2026
 //
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
@@ -8,6 +8,7 @@
 $css--plex: true !default;
 
 @use '@carbon/styles/scss/config' as *;
+@use '@carbon/styles/scss/feature-flags' as flags;
 @use '@carbon/styles/scss/theme' as *;
 @use '@carbon/styles/scss/spacing' as *;
 @use '@carbon/styles/scss/utilities' as *;
@@ -36,11 +37,20 @@ $css--plex: true !default;
   }
 
   .#{$prefix}--list-box__menu {
-    inset-block-start: 100%;
-    margin-block-start: 1px;
+    @if not flags.enabled('enable-v12-release') {
+      inset-block-start: 100%;
+      margin-block-start: 1px;
+    }
+
     outline: none;
   }
 
+  @if flags.enabled('enable-v12-release') {
+    .#{$prefix}--list-box__field {
+      block-size: calc(100% + 1px);
+    }
+  }
+
   .#{$prefix}--text-input {
     border: none;
     padding-inline-start: 0;
@@ -57,20 +67,19 @@ $css--plex: true !default;
     color: $text-disabled;
   }
 
-  .#{$prefix}--list-box__field:focus {
-    @extend .#{$prefix}--multi-select--filterable--input-focused;
-  }
-
-  /* stylelint-disable declaration-no-important */
-  .#{$prefix}--list-box__selection--multi::after {
-    display: none !important;
+  @if not flags.enabled('enable-v12-release') {
+    .#{$prefix}--list-box__field:focus {
+      @extend .#{$prefix}--multi-select--filterable--input-focused;
+    }
   }
 }
 
 :host(#{$prefix}-multi-select[filterable]) {
-  .#{$prefix}--list-box__field:focus-within {
-    outline: $spacing-01 solid $focus;
-    outline-offset: -#{$spacing-01};
+  @if not flags.enabled('enable-v12-release') {
+    .#{$prefix}--list-box__field:focus-within {
+      outline: $spacing-01 solid $focus;
+      outline-offset: -#{$spacing-01};
+    }
   }
   .#{$prefix}--list-box {
     .#{$prefix}--list-box__field {
@@ -78,6 +87,52 @@ $css--plex: true !default;
     }
   }
 }
+@if flags.enabled('enable-v12-release') {
+  // Default: full outline on trigger, none when navigating items, thin
+  // when something is selected
+  :host(#{$prefix}-multi-select:not([filterable]):not([item-clicked])) {
+    .#{$prefix}--list-box:focus-within:not(
+        :has([aria-activedescendant]:not([aria-activedescendant='']))
+      ):not(
+        .#{$prefix}--list-box--expanded.#{$prefix}--multi-select--selected
+      ) {
+      @include focus-outline('outline');
+    }
+  }
+
+  :host(#{$prefix}-multi-select:not([filterable])) {
+    .#{$prefix}--list-box--expanded.#{$prefix}--multi-select--selected:focus-within {
+      @include focus-outline('outline');
+
+      outline-offset: rem(-1px);
+      outline-width: rem(1px);
+    }
+  }
+
+  // Filterable: full outline on trigger, thin whenever an option is
+  // active or anything is selected
+  :host(#{$prefix}-multi-select[filterable]) {
+    .#{$prefix}--list-box:focus-within {
+      @include focus-outline('outline');
+    }
+
+    .#{$prefix}--list-box:focus-within:has(
+        [aria-activedescendant]:not([aria-activedescendant=''])
+      ),
+    .#{$prefix}--list-box.#{$prefix}--multi-select--selected:focus-within {
+      outline-offset: rem(-1px);
+      outline-width: rem(1px);
+    }
+  }
+
+  :host(#{$prefix}-multi-select[filterable][item-clicked]) {
+    .#{$prefix}--list-box:focus-within {
+      outline-offset: rem(-1px);
+      outline-width: rem(1px);
+    }
+  }
+}
+
 :host(#{$prefix}-multi-select[filterable][has-value])
   .#{$prefix}--list-box__field
   ~ ::slotted(#{$prefix}-ai-label) {
@@ -439,14 +494,33 @@ $css--plex: true !default;
   }
 }
 
-// When select all is turned on, the first item in the listbox
-// is always the "Select all" option and gets special border
-// treatment
-:host(#{$prefix}-multi-select-item[is-select-all]) {
-  .#{$prefix}--list-box__menu-item__option {
-    padding: 0.6875rem $spacing-05;
-    margin: 0;
-    border-block-end: 1px solid $border-subtle-01;
+@if flags.enabled('enable-v12-release') {
+  // When select all is turned on, the "Select all" option is separated from
+  // the rest of the options by a divider
+  :host(#{$prefix}-multi-select-item[is-select-all]) {
+    position: relative;
+
+    // spacing-02 margin * 2 + 1px divider
+    margin-block-end: calc(#{$spacing-02} * 2 + 1px);
+
+    .#{$prefix}--list-box__menu-divider {
+      position: absolute;
+      background-color: $border-subtle;
+      block-size: convert.to-rem(1px);
+      inset-block-start: calc(100% + #{$spacing-02});
+      inset-inline: -$spacing-02;
+    }
+  }
+} @else {
+  // When select all is turned on, the first item in the listbox
+  // is always the "Select all" option and gets special border
+  // treatment
+  :host(#{$prefix}-multi-select-item[is-select-all]) {
+    .#{$prefix}--list-box__menu-item__option {
+      padding: 0.6875rem $spacing-05;
+      margin: 0;
+      border-block-end: 1px solid $border-subtle-01;
+    }
   }
 }
 
@@ -470,14 +544,41 @@ $css--plex: true !default;
 :host(#{$prefix}-multi-select[ai-label])
   .#{$prefix}--list-box__wrapper--decorator {
   @include ai-gradient;
-}
 
-:host(#{$prefix}-multi-select[item-clicked]),
-:host(#{$prefix}-multi-select[has-value]) {
-  .#{$prefix}--list-box__field,
-  .#{$prefix}--multi-select--invalid {
-    outline: 1px solid $focus !important;
-    outline-offset: -1px !important;
+  @if flags.enabled('enable-v12-release') {
+    // Reset the bottom-edge color override from @include ai-gradient so the
+    // border-box gradient layer controls all four sides uniformly.
+    background:
+      linear-gradient(
+          0deg,
+          $ai-aura-start-sm 0%,
+          15%,
+          $ai-aura-end 50%,
+          transparent 100%
+        )
+        padding-box,
+      linear-gradient($field, $field) padding-box,
+      // (ai-border-start → ai-border-end), mirroring the default v12 border gradient
+      linear-gradient(
+          to bottom,
+          $ai-border-start calc(100% - 4px),
+          $ai-border-strong 100%
+        )
+        border-box;
+    border-block-end-color: transparent;
+  }
+}
+
+@if not flags.enabled('enable-v12-release') {
+  :host(#{$prefix}-multi-select[item-clicked]),
+  :host(#{$prefix}-multi-select[has-value]) {
+    .#{$prefix}--list-box__field,
+    .#{$prefix}--multi-select--invalid {
+      /* stylelint-disable-next-line declaration-no-important */
+      outline: 1px solid $focus !important;
+      /* stylelint-disable-next-line declaration-no-important */
+      outline-offset: -1px !important;
+    }
   }
 }
 
@@ -515,6 +616,7 @@ $css--plex: true !default;
   }
   .#{$prefix}--list-box__field:focus,
   .#{$prefix}--list-box__selection:focus {
+    /* stylelint-disable-next-line declaration-no-important */
     outline: none !important;
   }
 }

package/scss/components/number-input/number-input.scss

@@ -8,6 +8,7 @@
 $css--plex: true !default;
 
 @use '@carbon/styles/scss/config' as *;
+@use '@carbon/styles/scss/feature-flags' as flags;
 @use '@carbon/styles/scss/theme' as *;
 @use '@carbon/styles/scss/utilities/convert' as *;
 @use '@carbon/styles/scss/utilities';
@@ -44,7 +45,11 @@ $css--plex: true !default;
 .#{$prefix}--number--readonly {
   .#{$prefix}--number__controls {
     .#{$prefix}--number__control-btn {
-      border-block-end: 0;
+      @if flags.enabled('enable-v12-release') {
+        border-block-end-color: transparent;
+      } @else {
+        border-block-end: 0;
+      }
     }
   }
 }
@@ -73,6 +78,10 @@ $css--plex: true !default;
       content: '';
       inline-size: to-rem(1px);
       inset-inline-start: -#{$spacing-05};
+
+      @if flags.enabled('enable-v12-release') {
+        display: none;
+      }
     }
   }
 }
@@ -87,6 +96,31 @@ $css--plex: true !default;
 }
 :host(#{$prefix}-number-input[ai-label]) input {
   @include ai-gradient;
+
+  padding-inline-end: to-rem(145px);
+
+  @if flags.enabled('enable-v12-release') {
+    // Reset the bottom-edge color override from @include ai-gradient so the
+    // border-box gradient layer controls all four sides uniformly.
+    background:
+      linear-gradient(
+          0deg,
+          $ai-aura-start-sm 0%,
+          15%,
+          $ai-aura-end 50%,
+          transparent 100%
+        )
+        padding-box,
+      linear-gradient($field, $field) padding-box,
+      // (ai-border-start → ai-border-end), mirroring the default v12 border gradient
+      linear-gradient(
+          to bottom,
+          $ai-border-start calc(100% - 4px),
+          $ai-border-strong 100%
+        )
+        border-box;
+    border-block-end-color: transparent;
+  }
 }
 
 :host(#{$prefix}-number-input[invalid][fluid]) {

package/scss/components/options-tile/options-tile.scss

@@ -0,0 +1,157 @@
+/*
+* Copyright IBM Corp. 2025, 2026
+*
+* This source code is licensed under the Apache-2.0 license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+
+$css--plex: true !default;
+
+@use '@carbon/styles/scss/reset';
+@use '@carbon/styles/scss/config' as *;
+@use '@carbon/styles/scss/spacing' as *;
+@use '@carbon/styles/scss/theme' as *;
+@use '@carbon/styles/scss/colors' as *;
+@use '@carbon/styles/scss/type';
+@use '@carbon/styles/scss/components/options-tile/index' as *;
+
+$block-class: #{$prefix}--options-tile;
+
+:host(#{$prefix}-options-tile) {
+  position: relative;
+
+  .#{$block-class} {
+    @extend .#{$block-class} !optional;
+
+    position: relative;
+    display: block;
+    background: $layer-01;
+    border-block-end: 1px solid $border-subtle-01;
+
+    ::marker,
+    ::-webkit-details-marker {
+      display: none;
+      content: '';
+    }
+
+    &__header,
+    &__static-content {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      block-size: $spacing-09;
+      padding-inline: $spacing-05;
+      padding-inline-end: $spacing-05;
+    }
+
+    &__header {
+      cursor: pointer;
+
+      &:hover {
+        background: $background-hover;
+      }
+
+      &:focus {
+        outline: 2px solid $focus;
+        outline-offset: -2px;
+      }
+
+      &-left {
+        display: flex;
+        align-items: center;
+      }
+
+      &-right {
+        position: absolute;
+        display: flex;
+        align-items: center;
+        block-size: $spacing-09;
+        inset-block-start: 0;
+        inset-inline-end: 0;
+        padding-inline: $spacing-05;
+      }
+
+      &--has-toggle {
+        inline-size: calc(100% - ($spacing-09 + ($spacing-05 * 3)));
+      }
+    }
+
+    &__title {
+      @include type.type-style('heading-compact-01');
+
+      &-block {
+        margin-inline-end: $spacing-05;
+        margin-inline-start: $spacing-05;
+      }
+    }
+
+    &__summary {
+      @include type.type-style('helper-text-01');
+
+      display: flex;
+      align-items: center;
+      color: $text-secondary;
+      gap: $spacing-02;
+      margin-block-start: $spacing-02;
+
+      &--locked {
+        color: $text-secondary;
+      }
+
+      &--warn {
+        color: $text-primary;
+
+        svg {
+          color: $support-warning;
+
+          path[fill='none'] {
+            fill: $black-100;
+          }
+        }
+      }
+
+      &-icon {
+        flex-shrink: 0;
+      }
+
+      &-text {
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+    }
+
+    &__body {
+      padding-block-end: $spacing-06;
+      padding-block-start: $spacing-03;
+      padding-inline: $spacing-05;
+      padding-inline-start: $spacing-09;
+    }
+  }
+
+  .#{$block-class}--lg {
+    .#{$block-class}__summary {
+      margin-block-start: $spacing-01;
+    }
+  }
+
+  .#{$block-class}--xl {
+    .#{$block-class}__header {
+      block-size: $spacing-10;
+    }
+
+    .#{$block-class}__summary {
+      margin-block-start: $spacing-01;
+    }
+  }
+
+  .#{$block-class}--open {
+    .#{$block-class}__chevron {
+      transform: rotate(-180deg);
+    }
+
+    .#{$block-class}__summary {
+      display: none;
+    }
+  }
+}

package/scss/components/options-tile/story-styles.scss

@@ -0,0 +1,32 @@
+/*
+ * Copyright IBM Corp. 2025, 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+@use '@carbon/styles/scss/type';
+@use '@carbon/styles/scss/spacing' as *;
+
+.options-tile-stories__wrapper {
+  display: flex;
+  align-items: center;
+  justify-content: left;
+  min-block-size: 100vh;
+}
+
+.options-tile-stories__viewport {
+  inline-size: 80vw;
+  max-inline-size: 48rem;
+  min-inline-size: 16rem;
+}
+
+.options-tile-stories__body p {
+  @include type.type-style('body-01');
+
+  margin-block-end: $spacing-05;
+}
+
+.options-tile-stories__dropdown:first-of-type {
+  margin-block-end: $spacing-05;
+}

package/scss/components/search/search.scss

@@ -41,6 +41,13 @@ $css--plex: true !default;
   outline: none;
 }
 
+:host(#{$prefix}-search[expandable]:not([expanded])) {
+  .#{$prefix}--search-input {
+    border: 0;
+    background: none;
+  }
+}
+
 :host(#{$prefix}-search[expandable][expanded]) {
   @extend .#{$prefix}--search--expanded;
 

package/scss/components/select/select.scss

@@ -1,5 +1,5 @@
 //
-// Copyright IBM Corp. 2020, 2024
+// Copyright IBM Corp. 2020, 2026
 //
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
@@ -75,8 +75,12 @@ $divider-width: 1px;
   @extend .#{$prefix}--select--slug;
 }
 
-:host(#{$prefix}-select[readonly]) select {
-  pointer-events: none;
+:host(#{$prefix}-select[readonly]) {
+  @extend .#{$prefix}--select--readonly;
+
+  select {
+    pointer-events: none;
+  }
 }
 
 :host(#{$prefix}-select[pagination]) {

package/scss/components/slider/slider.scss

@@ -1,5 +1,5 @@
 //
-// Copyright IBM Corp. 2019, 2024
+// Copyright IBM Corp. 2019, 2026
 //
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
@@ -12,6 +12,8 @@ $css--plex: true !default;
 @use '@carbon/styles/scss/components/slider';
 @use '@carbon/styles/scss/type' as type;
 @use '@carbon/styles/scss/utilities/layout' as *;
+@use '@carbon/styles/scss/border-radius' as *;
+@use '@carbon/styles/scss/feature-flags' as flags;
 
 :host(#{$prefix}-slider),
 :host(#{$prefix}-slider-skeleton) {
@@ -78,7 +80,12 @@ $css--plex: true !default;
 
 :host(#{$prefix}-slider-input[readonly]) {
   input {
-    background-color: transparent;
+    background: transparent;
+    border-block-end-color: var(--cds-border-subtle);
+
+    @if flags.enabled('enable-v12-release') {
+      border-radius: $border-radius-00;
+    }
   }
 }
 .#{$prefix}--slider__thumb-wrapper:focus-within .#{$prefix}--slider__thumb-icon,

package/scss/components/tabs/tabs.scss

@@ -88,6 +88,7 @@ $inset-transition: inset 110ms motion(standard, productive);
 
 :host(#{$prefix}-tabs[size='sm']) {
   @extend .#{$prefix}--layout--size-sm;
+  --#{$prefix}-tabs-icon-only-badge-indicator-offset: #{$spacing-02};
 }
 
 :host(#{$prefix}-tabs[size='md']) {
@@ -318,8 +319,14 @@ $inset-transition: inset 110ms motion(standard, productive);
       )
   )
   #{$prefix}-badge-indicator {
-  margin-block-start: $spacing-02;
-  margin-inline-end: $spacing-02;
+  margin-block-start: var(
+    --#{$prefix}-tabs-icon-only-badge-indicator-offset,
+    #{$spacing-03}
+  );
+  margin-inline-end: var(
+    --#{$prefix}-tabs-icon-only-badge-indicator-offset,
+    #{$spacing-03}
+  );
 }
 
 :host(#{$prefix}-tab[icon-only]),

package/scss/components/tag/tag-story.scss

@@ -0,0 +1,19 @@
+//
+// Copyright IBM Corp. 2026
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@use '@carbon/styles/scss/spacing' as *;
+
+.tag-group {
+  display: flex;
+  flex-wrap: wrap;
+  gap: $spacing-02;
+}
+
+.tag-group--column {
+  flex-direction: column;
+  padding: $spacing-05;
+}