@carbon/ibm-products-web-components 0.33.0 → 0.34.0

package/es-custom/utilities/makeDraggable/makeDraggable.js

@@ -38,12 +38,17 @@ const makeDraggable = ({ el, dragHandle, focusableDragHandle, dragStep, shiftDra
     const onKeyDown = (e) => {
         if (e.key === 'Enter') {
             isDragging = !isDragging;
-        }
-        if (isDragging) {
-            dispatch('dragstart', { keyboard: true });
-        }
-        else {
-            dispatch('dragend', { keyboard: true });
+            if (isDragging) {
+                // Get current transform values when starting keyboard drag
+                const style = window.getComputedStyle(el);
+                const matrix = new DOMMatrix(style.transform);
+                currentX = matrix.m41;
+                currentY = matrix.m42;
+                dispatch('dragstart', { keyboard: true });
+            }
+            else {
+                dispatch('dragend', { keyboard: true });
+            }
         }
         if (!isDragging) {
             return;
@@ -55,16 +60,20 @@ const makeDraggable = ({ el, dragHandle, focusableDragHandle, dragStep, shiftDra
                 e.preventDefault();
                 break;
             case 'ArrowLeft':
-                el.style.left = `${el.offsetLeft - distance}px`;
+                currentX -= distance;
+                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
                 break;
             case 'ArrowRight':
-                el.style.left = `${el.offsetLeft + distance}px`;
+                currentX += distance;
+                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
                 break;
             case 'ArrowUp':
-                el.style.top = `${el.offsetTop - distance}px`;
+                currentY -= distance;
+                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
                 break;
             case 'ArrowDown':
-                el.style.top = `${el.offsetTop + distance}px`;
+                currentY += distance;
+                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
                 break;
         }
     };

package/es-custom/utilities/makeDraggable/makeDraggable.js.map

@@ -1 +1 @@
-{"version":3,"file":"makeDraggable.js","sources":["../../../src/utilities/makeDraggable/makeDraggable.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"makeDraggable.js","sources":["../../../src/utilities/makeDraggable/makeDraggable.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/es-custom/utilities/snapscroll/index.d.ts

@@ -4,4 +4,4 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { snapScroll, scrollNext, scrollPrevious, blockClass, getNextSibling, getPreviousSibling, } from './snapscroll';
+export { snapScroll, scrollNext, scrollPrevious, blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, } from './snapscroll';

package/es-custom/utilities/snapscroll/index.js

@@ -5,5 +5,5 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-export { blockClass, getNextSibling, getPreviousSibling, scrollNext, scrollPrevious, snapScroll } from './snapscroll.js';
+export { blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, scrollNext, scrollPrevious, snapScroll } from './snapscroll.js';
 //# sourceMappingURL=index.js.map

package/es-custom/utilities/snapscroll/snapscroll.d.ts

@@ -27,3 +27,13 @@ export declare function scrollNext(): void;
 export declare function scrollPrevious(): void;
 export declare function getNextSibling(): Element | null | undefined;
 export declare function getPreviousSibling(): Element | null | undefined;
+/**
+ * Checks if there are any next siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the next direction
+ */
+export declare function hasNextSiblingNotInView(): boolean;
+/**
+ * Checks if there are any previous siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the previous direction
+ */
+export declare function hasPreviousSiblingNotInView(): boolean;

package/es-custom/utilities/snapscroll/snapscroll.js

@@ -95,25 +95,92 @@ function snapScroll(body, child) {
 function getFocusedItem() {
     return document.querySelector(`.${selectionClass}`);
 }
+/**
+ * Helper function to check if an element is fully visible within its parent
+ * @param element The element to check
+ * @param parent The parent container
+ * @returns true if element is fully visible within parent bounds
+ */
+function isElementFullyInView(element, parent) {
+    const elementRect = element.getBoundingClientRect();
+    const parentRect = parent.getBoundingClientRect();
+    return (elementRect.left >= parentRect.left && elementRect.right <= parentRect.right);
+}
+/**
+ * Finds the first sibling that is not in view by traversing in the specified direction
+ * @param startSibling The sibling to start checking from
+ * @param parent The parent container
+ * @param direction 'next' to check nextElementSibling, 'previous' to check previousElementSibling
+ * @returns The first sibling not in view, or the last sibling if all are in view
+ */
+function findFirstSiblingNotInView(startSibling, parent, direction) {
+    let currentSibling = startSibling;
+    let lastCheckedSibling = startSibling;
+    while (currentSibling) {
+        if (!isElementFullyInView(currentSibling, parent)) {
+            return currentSibling;
+        }
+        lastCheckedSibling = currentSibling;
+        currentSibling =
+            direction === 'next'
+                ? currentSibling.nextElementSibling
+                : currentSibling.previousElementSibling;
+    }
+    // If all siblings are in view, return the last one checked
+    return lastCheckedSibling;
+}
+/**
+ * Helper function to scroll to a sibling element with proper handling for already-visible items
+ * @param sibling The sibling element to start checking from
+ * @param inline The scroll alignment ('start' for next, 'nearest' for previous)
+ * @param direction The direction to traverse ('next' or 'previous')
+ */
+function scrollToSibling(sibling, inline, direction) {
+    const parent = sibling.parentElement;
+    if (!parent) {
+        return;
+    }
+    // Find the first sibling that is not in view
+    const targetSibling = findFirstSiblingNotInView(sibling, parent, direction);
+    const isFullyInView = isElementFullyInView(targetSibling, parent);
+    // Update the selection class for already visible items
+    if (isFullyInView) {
+        const currentlySnapped = document.querySelector(`.${selectionClass}`);
+        if (currentlySnapped) {
+            currentlySnapped.classList.remove(selectionClass);
+        }
+        targetSibling.classList.add(selectionClass);
+    }
+    // Always scroll to ensure proper snap alignment
+    targetSibling.scrollIntoView({
+        behavior: 'smooth',
+        inline,
+    });
+    // If already in view, scrollIntoView won't trigger scrollend
+    // So we manually dispatch it to ensure navigation buttons update
+    if (isFullyInView) {
+        setTimeout(() => {
+            parent.dispatchEvent(new Event('scrollend', { bubbles: true }));
+        }, 50);
+    }
+}
 /**
  * Scrolls to the next sibling element of the currently focused element
  */
 function scrollNext() {
     const sibling = getNextSibling();
-    sibling === null || sibling === void 0 ? void 0 : sibling.scrollIntoView({
-        behavior: 'smooth',
-        inline: 'start',
-    });
+    if (sibling) {
+        scrollToSibling(sibling, 'start', 'next');
+    }
 }
 /**
  * Scrolls to the previous sibling element of the currently focused element
  */
 function scrollPrevious() {
     const sibling = getPreviousSibling();
-    sibling === null || sibling === void 0 ? void 0 : sibling.scrollIntoView({
-        behavior: 'smooth',
-        inline: 'start',
-    });
+    if (sibling) {
+        scrollToSibling(sibling, 'nearest', 'previous');
+    }
 }
 function getNextSibling() {
     const item = getFocusedItem();
@@ -129,6 +196,42 @@ function getPreviousSibling() {
     }
     return item.previousElementSibling;
 }
+/**
+ * Checks if there are any next siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the next direction
+ */
+function hasNextSiblingNotInView() {
+    const item = getFocusedItem();
+    if (!item || !item.parentElement) {
+        return false;
+    }
+    let currentSibling = item.nextElementSibling;
+    while (currentSibling) {
+        if (!isElementFullyInView(currentSibling, item.parentElement)) {
+            return true;
+        }
+        currentSibling = currentSibling.nextElementSibling;
+    }
+    return false;
+}
+/**
+ * Checks if there are any previous siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the previous direction
+ */
+function hasPreviousSiblingNotInView() {
+    const item = getFocusedItem();
+    if (!item || !item.parentElement) {
+        return false;
+    }
+    let currentSibling = item.previousElementSibling;
+    while (currentSibling) {
+        if (!isElementFullyInView(currentSibling, item.parentElement)) {
+            return true;
+        }
+        currentSibling = currentSibling.previousElementSibling;
+    }
+    return false;
+}
 
-export { blockClass, getFocusedItem, getNextSibling, getPreviousSibling, scrollNext, scrollPrevious, snapScroll };
+export { blockClass, getFocusedItem, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, scrollNext, scrollPrevious, snapScroll };
 //# sourceMappingURL=snapscroll.js.map

package/es-custom/utilities/snapscroll/snapscroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapscroll.js","sources":["../../../src/utilities/snapscroll/snapscroll.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"snapscroll.js","sources":["../../../src/utilities/snapscroll/snapscroll.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/components/coachmark/coachmark-helpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ *
+ * 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.
+ */
+export declare const handleClick: () => void;
+export declare const handleDone: () => void;
+export declare const handleCoachmarkOpened: () => void;

package/lib/components/options-tile/options-tile.d.ts

@@ -405,8 +405,13 @@ declare class CDSOptionsTile extends CDSOptionsTile_base {
      * here and only referenced internally.
      */
     private _open;
+    /**
+     * Tracks whether the toggle slot has content
+     */
+    private _hasToggle;
     static get eventOpen(): string;
     static get eventClose(): string;
+    private _handleToggleSlotChange;
     private _toggle;
     private _handleOpen;
     private _handleClose;

package/lib/utilities/snapscroll/index.d.ts

@@ -4,4 +4,4 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { snapScroll, scrollNext, scrollPrevious, blockClass, getNextSibling, getPreviousSibling, } from './snapscroll';
+export { snapScroll, scrollNext, scrollPrevious, blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, } from './snapscroll';

package/lib/utilities/snapscroll/snapscroll.d.ts

@@ -27,3 +27,13 @@ export declare function scrollNext(): void;
 export declare function scrollPrevious(): void;
 export declare function getNextSibling(): Element | null | undefined;
 export declare function getPreviousSibling(): Element | null | undefined;
+/**
+ * Checks if there are any next siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the next direction
+ */
+export declare function hasNextSiblingNotInView(): boolean;
+/**
+ * Checks if there are any previous siblings that are not fully in view
+ * @returns true if there are more items to scroll to in the previous direction
+ */
+export declare function hasPreviousSiblingNotInView(): boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products-web-components",
   "description": "Carbon for IBM Products Web Components",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "license": "Apache-2.0",
   "main": "es/index.js",
   "module": "es/index.js",
@@ -56,11 +56,10 @@
   },
   "dependencies": {
     "@carbon-labs/wc-empty-state": "^0.13.0",
-    "@carbon/ibm-products-styles": "^2.80.0",
+    "@carbon/ibm-products-styles": "^2.81.0",
     "@carbon/styles": "^1.100.0",
     "@carbon/utilities": "^0.16.0",
     "@carbon/web-components": "2.48.0",
-    "@figma/code-connect": "^1.3.6",
     "@ibm/telemetry-js": "^1.10.2",
     "@lit-labs/signals": "^0.1.2",
     "@lit/context": "^1.1.5",
@@ -72,7 +71,7 @@
     "@carbon/icon-helpers": "^10.72.0",
     "@carbon/icons": "^11.75.0",
     "@carbon/motion": "^11.41.0",
-    "@figma/code-connect": "^1.3.6",
+    "@figma/code-connect": "^1.4.0",
     "@ibm/telemetry-js-config-generator": "^2.1.0",
     "@mordech/vite-lit-loader": "^0.37.0",
     "@open-wc/testing": "^4.0.0",
@@ -113,5 +112,5 @@
     "vitest": "^3.2.0",
     "web-component-analyzer": "2.0.0"
   },
-  "gitHead": "7b0c5737d123755ee2ed937568fcd568e9c76b3f"
+  "gitHead": "d5645922d967cd5c602f4c111bab8a6b5f633abe"
 }

package/scss/components/guide-banner/guide-banner.scss

@@ -29,4 +29,8 @@ $block-class: #{$prefix}--guidebanner;
     display: none;
     content: '';
   }
+
+  .#{$block-class}__title {
+    padding-block-end: $spacing-05;
+  }
 }

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

@@ -18,7 +18,10 @@ $prefix: 'c4p';
 $block-class: #{$prefix}--options-tile;
 
 :host(#{$prefix}-options-tile) {
+  position: relative;
+
   .#{$block-class} {
+    position: relative;
     background: $layer-01;
     border-block-end: 1px solid $border-subtle-01;
 
@@ -52,8 +55,17 @@ $block-class: #{$prefix}--options-tile;
       }
 
       &-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)));
       }
     }