carbon-components-svelte/types/UIShell/Header.svelte.d.ts
Eric Liu 6bf72d4602
fix(types): loosen icon prop type to any (#2095)
Fixes https://github.com/carbon-design-system/carbon-icons-svelte/issues/207

`carbon-icons-svelte@13` and `carbon-pictograms-svelte@13` now  
only support TypeScript for Svelte 4/5.

The new `Component` type is incompatible with the `icon` prop in  
`carbon-components-svelte`, causing a type error with Svelte 5, as  
`typeof SvelteComponent` doesn't match the new `Component` type.

Since `Component` isn't available in Svelte 3/4, this PR changes  
the `icon` prop type to `any` for compatibility across Svelte 3, 4, and 5.
2025-02-02 19:49:53 -08:00

93 lines
2.1 KiB
TypeScript

import type { SvelteComponentTyped } from "svelte";
import type { SvelteHTMLElements } from "svelte/elements";
type $RestProps = SvelteHTMLElements["a"];
type $Props = {
/**
* Set to `false` to hide the side nav by default
* @default true
*/
expandedByDefault?: boolean;
/**
* Set to `true` to open the side nav
* @default false
*/
isSideNavOpen?: boolean;
/**
* Specify the ARIA label for the header
* @default undefined
*/
uiShellAriaLabel?: string;
/**
* Specify the `href` attribute
* @default undefined
*/
href?: string;
/**
* Specify the company name.
*
* Alternatively, use the named slot "company" (e.g., `<span slot="company">...</span>`)
* @default undefined
*/
company?: string;
/**
* Specify the platform name.
* Alternatively, use the named slot "platform" (e.g., `<span slot="platform">...</span>`)
* @default ""
*/
platformName?: string;
/**
* Set to `true` to persist the hamburger menu
* @default false
*/
persistentHamburgerMenu?: boolean;
/**
* The window width (px) at which the SideNav is expanded and the hamburger menu is hidden.
* 1056 represents the "large" breakpoint in pixels from the Carbon Design System:
* - small: 320
* - medium: 672
* - large: 1056
* - x-large: 1312
* - max: 1584
* @default 1056
*/
expansionBreakpoint?: number;
/**
* Obtain a reference to the HTML anchor element
* @default null
*/
ref?: null | HTMLAnchorElement;
/**
* Specify the icon to render for the closed state.
* Defaults to `<Menu size={20} />`
* @default undefined
*/
iconMenu?: any;
/**
* Specify the icon to render for the opened state.
* Defaults to `<Close size={20} />`
* @default undefined
*/
iconClose?: any;
[key: `data-${string}`]: any;
};
export type HeaderProps = Omit<$RestProps, keyof $Props> & $Props;
export default class Header extends SvelteComponentTyped<
HeaderProps,
{ click: WindowEventMap["click"] },
{ default: {}; company: {}; platform: {}; ["skip-to-content"]: {} }
> {}