@carbon/react 1.76.0 → 1.77.0-rc.0

package/lib/components/UIShell/HeaderMenuButton.d.ts

@@ -41,56 +41,98 @@ declare namespace HeaderMenuButton {
         length: 1;
         toString(): string;
         toLocaleString(): string;
+        toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions & Intl.DateTimeFormatOptions): string;
         pop(): string | undefined;
         push(...items: string[]): number;
         concat(...items: ConcatArray<string>[]): string[];
         concat(...items: (string | ConcatArray<string>)[]): string[];
-        join(separator?: string | undefined): string;
+        join(separator?: string): string;
         reverse(): string[];
         shift(): string | undefined;
-        slice(start?: number | undefined, end?: number | undefined): string[];
+        slice(start?: number, end?: number): string[];
         sort(compareFn?: ((a: string, b: string) => number) | undefined): [key: string];
-        splice(start: number, deleteCount?: number | undefined): string[];
+        splice(start: number, deleteCount?: number): string[];
         splice(start: number, deleteCount: number, ...items: string[]): string[];
         unshift(...items: string[]): number;
-        indexOf(searchElement: string, fromIndex?: number | undefined): number;
-        lastIndexOf(searchElement: string, fromIndex?: number | undefined): number;
+        indexOf(searchElement: string, fromIndex?: number): number;
+        lastIndexOf(searchElement: string, fromIndex?: number): number;
         every<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): this is S[];
         every(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
         some(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
         forEach(callbackfn: (value: string, index: number, array: string[]) => void, thisArg?: any): void;
         map<U>(callbackfn: (value: string, index: number, array: string[]) => U, thisArg?: any): U[];
-        filter<S_1 extends string>(predicate: (value: string, index: number, array: string[]) => value is S_1, thisArg?: any): S_1[];
+        filter<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S[];
         filter(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string[];
         reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
         reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
-        reduce<U_1>(callbackfn: (previousValue: U_1, currentValue: string, currentIndex: number, array: string[]) => U_1, initialValue: U_1): U_1;
+        reduce<U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
         reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
         reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
-        reduceRight<U_2>(callbackfn: (previousValue: U_2, currentValue: string, currentIndex: number, array: string[]) => U_2, initialValue: U_2): U_2;
-        find<S_2 extends string>(predicate: (this: void, value: string, index: number, obj: string[]) => value is S_2, thisArg?: any): S_2 | undefined;
+        reduceRight<U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
+        find<S extends string>(predicate: (value: string, index: number, obj: string[]) => value is S, thisArg?: any): S | undefined;
         find(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): string | undefined;
         findIndex(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): number;
-        fill(value: string, start?: number | undefined, end?: number | undefined): [key: string];
-        copyWithin(target: number, start: number, end?: number | undefined): [key: string];
-        entries(): IterableIterator<[number, string]>;
-        keys(): IterableIterator<number>; /**
-         * Specify whether the menu button is collapsible.
-         */
-        values(): IterableIterator<string>;
-        includes(searchElement: string, fromIndex?: number | undefined): boolean;
-        flatMap<U_3, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U_3 | readonly U_3[], thisArg?: This | undefined): U_3[];
+        fill(value: string, start?: number, end?: number): [key: string];
+        copyWithin(target: number, start: number, end?: number): [key: string];
+        entries(): ArrayIterator<[number, string]>;
+        keys(): ArrayIterator<number>;
+        values(): ArrayIterator<string>;
+        includes(searchElement: string, fromIndex?: number): boolean;
+        flatMap<U, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U | readonly U[], thisArg?: This | undefined): U[];
         flat<A, D extends number = 1>(this: A, depth?: D | undefined): FlatArray<A, D>[];
         at(index: number): string | undefined;
-        [Symbol.iterator](): IterableIterator<string>;
-        [Symbol.unscopables](): {
-            copyWithin: boolean;
-            entries: boolean;
-            fill: boolean;
-            find: boolean;
-            findIndex: boolean;
-            keys: boolean;
-            values: boolean;
+        findLast<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S | undefined;
+        findLast(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string | undefined;
+        findLastIndex(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): number;
+        toReversed(): string[];
+        toSorted(compareFn?: ((a: string, b: string) => number) | undefined): string[];
+        toSpliced(start: number, deleteCount: number, ...items: string[]): string[];
+        toSpliced(start: number, deleteCount?: number): string[];
+        with(index: number, value: string): string[];
+        [Symbol.iterator](): ArrayIterator<string>;
+        [Symbol.unscopables]: {
+            [x: number]: boolean | undefined;
+            length?: boolean | undefined;
+            toString?: boolean | undefined;
+            toLocaleString?: boolean | undefined;
+            pop?: boolean | undefined;
+            push?: boolean | undefined;
+            concat?: boolean | undefined;
+            join?: boolean | undefined;
+            reverse?: boolean | undefined;
+            shift?: boolean | undefined;
+            slice?: boolean | undefined;
+            sort?: boolean | undefined;
+            splice?: boolean | undefined;
+            unshift?: boolean | undefined;
+            indexOf?: boolean | undefined;
+            lastIndexOf?: boolean | undefined;
+            every?: boolean | undefined;
+            some?: boolean | undefined;
+            forEach?: boolean | undefined;
+            map?: boolean | undefined;
+            filter?: boolean | undefined;
+            reduce?: boolean | undefined;
+            reduceRight?: boolean | undefined;
+            find?: boolean | undefined;
+            findIndex?: boolean | undefined;
+            fill?: boolean | undefined;
+            copyWithin?: boolean | undefined;
+            entries?: boolean | undefined;
+            keys?: boolean | undefined;
+            values?: boolean | undefined;
+            includes?: boolean | undefined;
+            flatMap?: boolean | undefined;
+            flat?: boolean | undefined;
+            at?: boolean | undefined;
+            findLast?: boolean | undefined;
+            findLastIndex?: boolean | undefined;
+            toReversed?: boolean | undefined;
+            toSorted?: boolean | undefined;
+            toSpliced?: boolean | undefined;
+            with?: boolean | undefined;
+            [Symbol.iterator]?: boolean | undefined;
+            readonly [Symbol.unscopables]?: boolean | undefined;
         };
     };
 }

package/lib/components/UIShell/HeaderMenuItem.d.ts

@@ -5,8 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type ComponentProps, type ForwardedRef, type ReactNode, ElementType, WeakValidationMap } from 'react';
-import { LinkProps } from './Link';
-export type HeaderMenuItemProps<E extends ElementType> = LinkProps<E> & {
+import { PolymorphicComponentPropWithRef } from '../../internal/PolymorphicProps';
+export interface HeaderMenuItemBaseProps {
     className?: string | undefined;
     isActive?: boolean | undefined;
     isCurrentPage?: boolean | undefined;
@@ -14,7 +14,8 @@ export type HeaderMenuItemProps<E extends ElementType> = LinkProps<E> & {
     children: ReactNode;
     role?: ComponentProps<'li'>['role'];
     tabIndex?: number | undefined;
-};
+}
+export type HeaderMenuItemProps<E extends ElementType = 'a'> = PolymorphicComponentPropWithRef<E, HeaderMenuItemBaseProps>;
 export interface HeaderMenuItemComponent {
     <E extends ElementType = 'a'>(props: HeaderMenuItemProps<E> & {
         ref?: ForwardedRef<ElementType>;

package/lib/components/UIShell/HeaderMenuItem.js

@@ -47,7 +47,7 @@ const HeaderMenuItem = /*#__PURE__*/React.forwardRef(function HeaderMenuItemRend
   return /*#__PURE__*/React__default["default"].createElement("li", {
     className: className,
     role: role
-  }, /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({}, rest, {
+  }, /*#__PURE__*/React__default["default"].createElement(Link.Link, _rollupPluginBabelHelpers["extends"]({}, rest, {
     "aria-current": ariaCurrent,
     className: linkClassName,
     ref: ref,

package/lib/components/UIShell/HeaderName.js

@@ -31,7 +31,7 @@ function HeaderName(_ref) {
   } = _ref;
   const selectorPrefix = usePrefix.usePrefix();
   const className = cx__default["default"](`${selectorPrefix}--header__name`, customClassName);
-  return /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({}, rest, {
+  return /*#__PURE__*/React__default["default"].createElement(Link.Link, _rollupPluginBabelHelpers["extends"]({}, rest, {
     className: className
   }), prefix && /*#__PURE__*/React__default["default"].createElement(React__default["default"].Fragment, null, /*#__PURE__*/React__default["default"].createElement("span", {
     className: `${selectorPrefix}--header__name--prefix`

package/lib/components/UIShell/HeaderNavigation.d.ts

@@ -23,54 +23,98 @@ declare namespace HeaderNavigation {
         length: 1;
         toString(): string;
         toLocaleString(): string;
+        toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions & Intl.DateTimeFormatOptions): string;
         pop(): string | undefined;
         push(...items: string[]): number;
         concat(...items: ConcatArray<string>[]): string[];
         concat(...items: (string | ConcatArray<string>)[]): string[];
-        join(separator?: string | undefined): string;
+        join(separator?: string): string;
         reverse(): string[];
         shift(): string | undefined;
-        slice(start?: number | undefined, end?: number | undefined): string[];
+        slice(start?: number, end?: number): string[];
         sort(compareFn?: ((a: string, b: string) => number) | undefined): [key: string];
-        splice(start: number, deleteCount?: number | undefined): string[];
+        splice(start: number, deleteCount?: number): string[];
         splice(start: number, deleteCount: number, ...items: string[]): string[];
         unshift(...items: string[]): number;
-        indexOf(searchElement: string, fromIndex?: number | undefined): number;
-        lastIndexOf(searchElement: string, fromIndex?: number | undefined): number;
+        indexOf(searchElement: string, fromIndex?: number): number;
+        lastIndexOf(searchElement: string, fromIndex?: number): number;
         every<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): this is S[];
         every(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
         some(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
         forEach(callbackfn: (value: string, index: number, array: string[]) => void, thisArg?: any): void;
         map<U>(callbackfn: (value: string, index: number, array: string[]) => U, thisArg?: any): U[];
-        filter<S_1 extends string>(predicate: (value: string, index: number, array: string[]) => value is S_1, thisArg?: any): S_1[];
+        filter<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S[];
         filter(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string[];
         reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
         reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
-        reduce<U_1>(callbackfn: (previousValue: U_1, currentValue: string, currentIndex: number, array: string[]) => U_1, initialValue: U_1): U_1;
+        reduce<U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
         reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
         reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
-        reduceRight<U_2>(callbackfn: (previousValue: U_2, currentValue: string, currentIndex: number, array: string[]) => U_2, initialValue: U_2): U_2;
-        find<S_2 extends string>(predicate: (this: void, value: string, index: number, obj: string[]) => value is S_2, thisArg?: any): S_2 | undefined;
+        reduceRight<U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
+        find<S extends string>(predicate: (value: string, index: number, obj: string[]) => value is S, thisArg?: any): S | undefined;
         find(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): string | undefined;
         findIndex(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): number;
-        fill(value: string, start?: number | undefined, end?: number | undefined): [key: string];
-        copyWithin(target: number, start: number, end?: number | undefined): [key: string];
-        entries(): IterableIterator<[number, string]>;
-        keys(): IterableIterator<number>;
-        values(): IterableIterator<string>;
-        includes(searchElement: string, fromIndex?: number | undefined): boolean;
-        flatMap<U_3, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U_3 | readonly U_3[], thisArg?: This | undefined): U_3[];
+        fill(value: string, start?: number, end?: number): [key: string];
+        copyWithin(target: number, start: number, end?: number): [key: string];
+        entries(): ArrayIterator<[number, string]>;
+        keys(): ArrayIterator<number>;
+        values(): ArrayIterator<string>;
+        includes(searchElement: string, fromIndex?: number): boolean;
+        flatMap<U, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U | readonly U[], thisArg?: This | undefined): U[];
         flat<A, D extends number = 1>(this: A, depth?: D | undefined): FlatArray<A, D>[];
         at(index: number): string | undefined;
-        [Symbol.iterator](): IterableIterator<string>;
-        [Symbol.unscopables](): {
-            copyWithin: boolean;
-            entries: boolean;
-            fill: boolean;
-            find: boolean;
-            findIndex: boolean;
-            keys: boolean;
-            values: boolean;
+        findLast<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S | undefined;
+        findLast(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string | undefined;
+        findLastIndex(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): number;
+        toReversed(): string[];
+        toSorted(compareFn?: ((a: string, b: string) => number) | undefined): string[];
+        toSpliced(start: number, deleteCount: number, ...items: string[]): string[];
+        toSpliced(start: number, deleteCount?: number): string[];
+        with(index: number, value: string): string[];
+        [Symbol.iterator](): ArrayIterator<string>;
+        [Symbol.unscopables]: {
+            [x: number]: boolean | undefined;
+            length?: boolean | undefined;
+            toString?: boolean | undefined;
+            toLocaleString?: boolean | undefined;
+            pop?: boolean | undefined;
+            push?: boolean | undefined;
+            concat?: boolean | undefined;
+            join?: boolean | undefined;
+            reverse?: boolean | undefined;
+            shift?: boolean | undefined;
+            slice?: boolean | undefined;
+            sort?: boolean | undefined;
+            splice?: boolean | undefined;
+            unshift?: boolean | undefined;
+            indexOf?: boolean | undefined;
+            lastIndexOf?: boolean | undefined;
+            every?: boolean | undefined;
+            some?: boolean | undefined;
+            forEach?: boolean | undefined;
+            map?: boolean | undefined;
+            filter?: boolean | undefined;
+            reduce?: boolean | undefined;
+            reduceRight?: boolean | undefined;
+            find?: boolean | undefined;
+            findIndex?: boolean | undefined;
+            fill?: boolean | undefined;
+            copyWithin?: boolean | undefined;
+            entries?: boolean | undefined;
+            keys?: boolean | undefined;
+            values?: boolean | undefined;
+            includes?: boolean | undefined;
+            flatMap?: boolean | undefined;
+            flat?: boolean | undefined;
+            at?: boolean | undefined;
+            findLast?: boolean | undefined;
+            findLastIndex?: boolean | undefined;
+            toReversed?: boolean | undefined;
+            toSorted?: boolean | undefined;
+            toSpliced?: boolean | undefined;
+            with?: boolean | undefined;
+            [Symbol.iterator]?: boolean | undefined;
+            readonly [Symbol.unscopables]?: boolean | undefined;
         };
     };
 }

package/lib/components/UIShell/Link.d.ts

@@ -5,26 +5,29 @@
  * LICENSE file in the root directory of this source tree.
  */
 import PropTypes from 'prop-types';
-import React, { type ElementType, type Ref } from 'react';
-import { type PolymorphicProps } from '../../types/common';
-type LinkBaseProps<E extends ElementType> = {
+import React, { ForwardedRef, type ElementType, type WeakValidationMap } from 'react';
+import { PolymorphicProps } from '../../types/common';
+import { HeaderMenuItemBaseProps } from './HeaderMenuItem';
+export interface LinkBaseProps {
     /**
      * @deprecated Use `as` instead
      */
-    element?: E | undefined;
-    ref?: Ref<E>;
-};
-export type LinkProps<E extends ElementType> = PolymorphicProps<E, LinkBaseProps<E>>;
+    element?: undefined;
+    ref?: ForwardedRef<ElementType>;
+}
+export type LinkProps<E extends React.ElementType> = PolymorphicProps<E, LinkBaseProps>;
+export interface LinkComponent {
+    <E extends ElementType = 'a'>(props: LinkProps<E> | HeaderMenuItemBaseProps): JSX.Element | null;
+    displayName?: string;
+    propTypes?: WeakValidationMap<LinkProps<any>>;
+}
+export declare const Link: LinkComponent;
 /**
  * Link is a custom component that allows us to supporting rendering elements
  * other than `a` in our markup. The goal is to allow users to support passing
  * in their own components to support use-cases like `react-router` or
  * `@reach/router`
  */
-declare const Link: (<E extends React.ElementType<any, keyof React.JSX.IntrinsicElements> = "a">(props: LinkProps<E>) => JSX.Element) & {
-    displayName?: string | undefined;
-    propTypes?: React.WeakValidationMap<LinkProps<any>> | undefined;
-};
 declare const LinkPropTypes: {
     /**
      * Provide a custom element or component to render the top-level node for the

package/lib/components/UIShell/Link.js

@@ -22,7 +22,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 // Note: Maybe we should use `as` instead of `element`? `as` appears to be
 // standard and is used in other places in this project.
 
-function LinkRenderFunction(_ref, ref) {
+const Link = /*#__PURE__*/React__default["default"].forwardRef(function LinkRenderFunction(_ref, ref) {
   let {
     element,
     as: BaseComponent,
@@ -35,15 +35,14 @@ function LinkRenderFunction(_ref, ref) {
   return /*#__PURE__*/React__default["default"].createElement(BaseComponentAsAny, _rollupPluginBabelHelpers["extends"]({
     ref: ref
   }, rest));
-}
-
+});
 /**
  * Link is a custom component that allows us to supporting rendering elements
  * other than `a` in our markup. The goal is to allow users to support passing
  * in their own components to support use-cases like `react-router` or
  * `@reach/router`
  */
-const Link = /*#__PURE__*/React.forwardRef(LinkRenderFunction);
+
 const LinkPropTypes = {
   /**
    * Provide a custom element or component to render the top-level node for the
@@ -66,5 +65,6 @@ const LinkPropTypes = {
 Link.displayName = 'Link';
 Link.propTypes = LinkPropTypes;
 
+exports.Link = Link;
 exports.LinkPropTypes = LinkPropTypes;
 exports["default"] = Link;

package/lib/components/UIShell/SideNav.js

@@ -208,12 +208,12 @@ SideNav.propTypes = {
    */
   defaultExpanded: PropTypes__default["default"].bool,
   /**
-   * Specify the duration in milliseconds to delay before displaying the sidenavigation
+   * Specify the duration in milliseconds to delay before displaying the side navigation
    */
   enterDelayMs: PropTypes__default["default"].number,
   /**
    * If `true`, the SideNav will be expanded, otherwise it will be collapsed.
-   * Using this prop causes SideNav to become a controled component.
+   * Using this prop causes SideNav to become a controlled component.
    */
   expanded: PropTypes__default["default"].bool,
   /**
@@ -259,7 +259,7 @@ SideNav.propTypes = {
 
   /**
    * Provide a custom function for translating all message ids within this
-   * component. This function will take in two arguments: the mesasge Id and the
+   * component. This function will take in two arguments: the message Id and the
    * state of the component. From this, you should return a string representing
    * the label you want displayed or read by screen readers.
    */

package/lib/components/UIShell/SideNavLink.js

@@ -46,7 +46,7 @@ const SideNavLink = /*#__PURE__*/React.forwardRef(function SideNavLink(_ref, ref
   });
   return /*#__PURE__*/React__default["default"].createElement(SideNavItem["default"], {
     large: large
-  }, /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({}, rest, {
+  }, /*#__PURE__*/React__default["default"].createElement(Link.Link, _rollupPluginBabelHelpers["extends"]({}, rest, {
     className: className,
     ref: ref,
     tabIndex: tabIndex === undefined ? !isSideNavExpanded && !isRail ? -1 : 0 : tabIndex

package/lib/components/UIShell/SideNavMenuItem.d.ts

@@ -6,7 +6,7 @@
  */
 import React, { ElementType, ComponentProps } from 'react';
 import Link from './Link';
-export interface SideNavMenuItemProps extends ComponentProps<typeof Link> {
+export type SideNavMenuItemProps = ComponentProps<typeof Link> & {
     /**
      * Specify the children to be rendered inside of the `SideNavMenuItem`
      */
@@ -29,6 +29,54 @@ export interface SideNavMenuItemProps extends ComponentProps<typeof Link> {
      * Optional component to render instead of default Link
      */
     as?: ElementType;
-}
-declare const SideNavMenuItem: React.ForwardRefExoticComponent<Omit<SideNavMenuItemProps, "ref"> & React.RefAttributes<HTMLElement>>;
+};
+declare const SideNavMenuItem: React.ForwardRefExoticComponent<((import("./HeaderMenuItem").HeaderMenuItemBaseProps & {
+    /**
+     * Specify the children to be rendered inside of the `SideNavMenuItem`
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Optionally specify whether the link is "active". An active link is one that
+     * has an href that is the same as the current page. Can also pass in
+     * `aria-current="page"`, as well.
+     */
+    isActive?: boolean;
+    /**
+     * Optionally provide an href for the underlying li`
+     */
+    href?: string;
+    /**
+     * Optional component to render instead of default Link
+     */
+    as?: ElementType;
+}) | Omit<import("./Link").LinkBaseProps & Omit<any, "as"> & {
+    as?: React.ElementType | undefined;
+} & {
+    /**
+     * Specify the children to be rendered inside of the `SideNavMenuItem`
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Optionally specify whether the link is "active". An active link is one that
+     * has an href that is the same as the current page. Can also pass in
+     * `aria-current="page"`, as well.
+     */
+    isActive?: boolean;
+    /**
+     * Optionally provide an href for the underlying li`
+     */
+    href?: string;
+    /**
+     * Optional component to render instead of default Link
+     */
+    as?: ElementType;
+}, "ref">) & React.RefAttributes<HTMLElement>>;
 export default SideNavMenuItem;

package/lib/components/UIShell/SideNavMenuItem.js

@@ -28,7 +28,7 @@ const SideNavMenuItem = /*#__PURE__*/React__default["default"].forwardRef(functi
   const {
     children,
     className: customClassName,
-    as: Component = Link["default"],
+    as: Component = Link.Link,
     isActive,
     ...rest
   } = props;
@@ -46,6 +46,10 @@ const SideNavMenuItem = /*#__PURE__*/React__default["default"].forwardRef(functi
 });
 SideNavMenuItem.displayName = 'SideNavMenuItem';
 SideNavMenuItem.propTypes = {
+  /**
+   * Optional component to render instead of default Link
+   */
+  as: PropTypes__default["default"].elementType,
   /**
    * Specify the children to be rendered inside of the `SideNavMenuItem`
    */
@@ -63,11 +67,7 @@ SideNavMenuItem.propTypes = {
    * has an href that is the same as the current page. Can also pass in
    * `aria-current="page"`, as well.
    */
-  isActive: PropTypes__default["default"].bool,
-  /**
-   * Optional component to render instead of default Link
-   */
-  as: PropTypes__default["default"].elementType
+  isActive: PropTypes__default["default"].bool
 };
 
 exports["default"] = SideNavMenuItem;

package/lib/components/UIShell/SwitcherItem.d.ts

@@ -1,4 +1,4 @@
-import React, { HTMLAttributeAnchorTarget } from 'react';
+import React, { HTMLAttributeAnchorTarget, KeyboardEvent } from 'react';
 export interface BaseSwitcherItemProps {
     /**
      * Specify the text content for the link
@@ -61,5 +61,5 @@ export interface SwitcherItemWithAriaLabelledBy extends BaseSwitcherItemProps {
     'aria-labelledby': string;
 }
 export type SwitcherItemProps = SwitcherItemWithAriaLabel | SwitcherItemWithAriaLabelledBy;
-declare const SwitcherItem: React.ForwardRefExoticComponent<SwitcherItemProps & React.RefAttributes<React.ElementType<any, keyof React.JSX.IntrinsicElements>>>;
+declare const SwitcherItem: React.ForwardRefExoticComponent<SwitcherItemProps & React.RefAttributes<React.ElementType>>;
 export default SwitcherItem;

package/lib/components/UIShell/SwitcherItem.js

@@ -71,7 +71,7 @@ const SwitcherItem = /*#__PURE__*/React.forwardRef(function SwitcherItem(props,
   }
   return /*#__PURE__*/React__default["default"].createElement("li", {
     className: classNames
-  }, /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({
+  }, /*#__PURE__*/React__default["default"].createElement(Link.Link, _rollupPluginBabelHelpers["extends"]({
     onKeyDown: evt => {
       setTabFocus(evt);
       onKeyDown(evt);

package/lib/internal/PolymorphicProps.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 type AsProp<C extends React.ElementType> = {
     as?: C;
 };

package/lib/internal/Selection.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright IBM Corp. 2016, 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+interface UseSelectionProps<ItemType> {
+    disabled?: boolean;
+    filteredItems?: ItemType[];
+    initialSelectedItems?: ItemType[];
+    onChange?: (data: {
+        selectedItems: ItemType[];
+    }) => void;
+    selectAll?: boolean;
+    selectedItems?: ItemType[];
+}
+export declare const useSelection: <ItemType>({ disabled, onChange, initialSelectedItems, selectedItems: controlledItems, selectAll, filteredItems, }: UseSelectionProps<ItemType>) => {
+    clearSelection: () => void;
+    onItemChange: (item: ItemType) => void;
+    selectedItems: ItemType[];
+};
+interface SelectionRenderProps<ItemType> {
+    clearSelection: () => void;
+    onItemChange: (item: ItemType) => void;
+    selectedItems: ItemType[];
+}
+interface SelectionProps<ItemType> {
+    children?: (renderProps: SelectionRenderProps<ItemType>) => React.ReactNode;
+    disabled?: boolean;
+    initialSelectedItems: ItemType[];
+    onChange?: (state: {
+        selectedItems: ItemType[];
+    }) => void;
+    render?: (renderProps: SelectionRenderProps<ItemType>) => React.ReactNode;
+}
+export declare const Selection: <ItemType>({ children, disabled, initialSelectedItems, onChange, render, }: SelectionProps<ItemType>) => import("react/jsx-runtime").JSX.Element | null;
+export {};