@carbon/web-components 2.61.0 → 2.62.0

package/es/components/side-panel/index.js

@@ -6,3 +6,15 @@
  */
 
 import "./side-panel.js";
+//#region src/components/side-panel/index.ts
+/**
+* @license
+*
+* Copyright IBM Corp. 2023, 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.
+*/
+//#endregion
+
+//# sourceMappingURL=index.js.map

package/es/components/side-panel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/side-panel/index.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2023, 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport './side-panel';\n"],"mappings":""}

package/es/components/side-panel/side-panel.d.ts

@@ -1,4 +1,6 @@
 /**
+ * @license
+ *
  * Copyright IBM Corp. 2023, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
@@ -6,11 +8,12 @@
  */
 import { LitElement } from 'lit';
 import { SIDE_PANEL_SIZE, SIDE_PANEL_PLACEMENT } from './defs';
+import Handle from '../../globals/internal/handle';
 import '../button/index';
 import '../icon-button/index';
 import '../layer/index';
-import Handle from '../../globals/internal/handle';
-import '../button/button-set-base';
+import '../action-set/index.js';
+import '../resizer/index.js';
 export { SIDE_PANEL_SIZE, SIDE_PANEL_PLACEMENT };
 declare const CDSSidePanel_base: {
     new (...args: any[]): {
@@ -29,10 +32,6 @@ declare const CDSSidePanel_base: {
 /**
  * SidePanel.
  *
- * @deprecated Use Carbon for IBM Products `side-panel` component.
- *   This component has been deprecated in `@carbon/web-components` and will instead be maintained
- *   in the Carbon for IBM Products library:
- *   https://github.com/carbon-design-system/ibm-products/tree/main/packages/ibm-products-web-components
  * @element cds-side-panel
  * @csspart dialog The dialog.
  * @fires cds-side-panel-beingclosed
@@ -50,14 +49,6 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * The element that had focus before this side-panel gets open.
      */
     private _launcher;
-    /**
-     * Node to track focus going outside of side-panel content.
-     */
-    private _startSentinelNode;
-    /**
-     * Node to track focus going outside of side-panel content.
-     */
-    private _endSentinelNode;
     /**
      * Node to track side panel.
      */
@@ -67,7 +58,10 @@ declare class CDSSidePanel extends CDSSidePanel_base {
     private _title;
     private _subtitle;
     private _innerContent;
-    private _actions;
+    /**
+     * Reference to the resizer handle element
+     */
+    private _resizerHandle?;
     _doAnimateTitle: boolean;
     _isOpen: boolean;
     _containerScrollTop: number;
@@ -75,15 +69,27 @@ declare class CDSSidePanel extends CDSSidePanel_base {
     _hasSlug: boolean;
     _hasActionToolbar: boolean;
     _actionsCount: number;
+    _actionsMultiple: 'single' | 'double' | 'triple' | '';
     _slugCloseSize: string;
+    _customHeaderElements: Element[];
+    _customHeaderHidden: boolean;
+    _sidePanelWidth?: number;
+    _accumulatedDelta: number;
     /**
-     * Handles `blur` event on this element.
+     * Get focusable elements.
      *
-     * @param event The event.
-     * @param event.target The event target.
-     * @param event.relatedTarget The event relatedTarget.
+     * Querying all tabbable items.
+     *
+     * @returns {{first: HTMLElement, last: HTMLElement, all: HTMLElement[]}} Returns an object with various elements.
      */
-    private _handleBlur;
+    private getFocusable;
+    /**
+     * Handle the keydown event.
+     * Trap the focus inside the side-panel by tracking keydown.key == `Tab`
+     *
+     * @param {KeyboardEvent} event The keyboard event object.
+     */
+    protected _handleHostKeydown: (event: KeyboardEvent) => void;
     private _handleKeydown;
     private _reducedMotion;
     /**
@@ -110,9 +116,8 @@ declare class CDSSidePanel extends CDSSidePanel_base {
     private _checkUpdateIconButtonSizes;
     private _handleSlugChange;
     private _handleSubtitleChange;
+    private _handleCustomHeaderSlotChange;
     private _handleActionToolbarChange;
-    private _checkUpdateActionSizes;
-    private _maxActions;
     private _handleActionsChange;
     private _checkSetDoAnimateTitle;
     /**
@@ -121,6 +126,26 @@ declare class CDSSidePanel extends CDSSidePanel_base {
     private _resizeObserver;
     private _getScrollAnimationDistance;
     private _scrollObserver;
+    /**
+     * Handles resize start event from the resizer handle
+     */
+    private _handleResizeStart;
+    /**
+     * Handles resize drag event from the resizer handle
+     */
+    private _handleResizeDrag;
+    /**
+     * Handles resize end event from the resizer handle
+     */
+    private _handleResizeEnd;
+    /**
+     * Handles double-click/double-tap on resizer to reset size
+     */
+    private _handleResizeReset;
+    /**
+     * Get the percentage of screen width the panel is covering
+     */
+    private _getPanelWidthPercent;
     private _handleCurrentStepUpdate;
     /**
      * Determines if the title will animate on scroll
@@ -130,6 +155,10 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * Sets the close button icon description
      */
     closeIconDescription: string;
+    /**
+     * Sets the close button tooltip alignment
+     */
+    closeIconTooltipAlignment: string;
     /**
      * Determines whether the side panel should render the condensed version (affects action buttons primarily)
      */
@@ -170,6 +199,10 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * Selector for page content, used to push content to side except
      */
     selectorPageContent: string;
+    /**
+     * Show/hide the "X" close button
+     */
+    hideCloseButton: boolean;
     /**
      * SidePanel size.
      */
@@ -178,6 +211,10 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * Determines if this panel slides in
      */
     slideIn: boolean;
+    /**
+     * Determines if the side panel is resizable
+     */
+    resizable: boolean;
     /**
      * Sets the title text
      */
@@ -210,6 +247,7 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * The name of the custom event fired on clicking the navigate back button
      */
     static get eventNavigateBack(): string;
+    static styles: any;
 }
 export default CDSSidePanel;
 //# sourceMappingURL=side-panel.d.ts.map

package/es/components/side-panel/side-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"side-panel.d.ts","sourceRoot":"","sources":["../../../src/components/side-panel/side-panel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"side-panel.d.ts","sourceRoot":"","sources":["../../../src/components/side-panel/side-panel.ts"],"names":[],"mappings":"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"}