@ukic/web-components 2.35.2 → 3.0.0-alpha.10

package/dist/types/components/ic-text-field/ic-text-field.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcAutocompleteTypes, IcAutocorrectStates, IcInformationStatusOrEmpty, IcValueEventDetail, IcSizesNoLarge } from "../../utils/types";
+import { IcAutocompleteTypes, IcAutocorrectStates, IcInformationStatusOrEmpty, IcValueEventDetail, IcSizesNoLarge, IcThemeMode } from "../../utils/types";
 import { IcAriaAutocompleteTypes, IcTextFieldInputModes, IcTextFieldTypes } from "./ic-text-field.types";
 /**
  * @slot icon - Content will be placed to the left of the text input.
@@ -8,12 +8,12 @@ export declare class TextField {
     private inheritedAttributes;
     private inputEl;
     private hostMutationObserver;
+    private interval;
     el: HTMLIcTextFieldElement;
     numChars: number;
     maxCharactersReached: boolean;
-    maxCharactersError: boolean;
+    maxCharactersWarning: boolean;
     minCharactersUnattained: boolean;
-    maxLengthExceeded: boolean;
     maxValueExceeded: boolean;
     minValueUnattained: boolean;
     /**
@@ -53,7 +53,7 @@ export declare class TextField {
     /**
      * If `true`, the form control will have input focus when the page loads.
      */
-    autoFocus: boolean;
+    autofocus: boolean;
     /**
      * If `true`, the disabled state will be set.
      */
@@ -68,6 +68,10 @@ export declare class TextField {
      * The helper text that will be displayed for additional field guidance.
      */
     helperText: string;
+    /**
+     * If `true`, the character count which is displayed when `maxCharacters` is set will be visually hidden.
+     */
+    hideCharCount: boolean;
     /**
      * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
      */
@@ -95,17 +99,9 @@ export declare class TextField {
      */
     max: string | number;
     /**
-     * The maximum number of characters that can be entered in the field. Will display an error if too many characters are entered.
+     * The count of characters in the field. Will display a warning if the bound is reached. (NOTE: If the value of the text field has been set using the `value` prop, it will be truncated to this number of characters)
      */
     maxCharacters: number;
-    /**
-     * The count of characters in the field. Will display a warning if the bound is reached.
-     */
-    maxLength: number;
-    /**
-     * The text to display as the validation message when the maximum length is exceeded.
-     */
-    maxLengthMessage: string;
     /**
      * The minimum number that can be accepted as a value, when `type` is `number` and `rows` is `1`. (NOTE: Ensure to include visual indication of min value in `helperText` or `label`)
      */
@@ -146,14 +142,14 @@ export declare class TextField {
      * The size of the text field component.
      */
     size?: IcSizesNoLarge;
-    /**
-     * @deprecated This prop should not be used anymore. Set prop `size` to "small" instead.
-     */
-    small?: boolean;
     /**
      * If `true`, the value of the text field will have its spelling and grammar checked.
      */
     spellcheck: boolean;
+    /**
+     * Sets the theme color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
+     */
+    theme: IcThemeMode;
     /**
      * @internal If `true`, an ellipsis will be displayed at the end of the value if the value is longer than the container.
      */
@@ -219,13 +215,14 @@ export declare class TextField {
     disconnectedCallback(): void;
     componentWillLoad(): void;
     componentDidLoad(): void;
+    private checkChildHydration;
     handleKeyDown(ev: KeyboardEvent): void;
     /**
      * Sets focus on the native `input`.
      */
     setFocus(): Promise<void>;
     private getNumberOfCharacters;
-    private getMaxLengthExceeded;
+    private getMaxValueExceeded;
     private getMaxCharactersReached;
     private onInput;
     private onBlur;
@@ -233,6 +230,5 @@ export declare class TextField {
     private hasStatus;
     private handleFormReset;
     private hostMutationCallback;
-    private showValidation;
     render(): any;
 }

package/dist/types/components/ic-theme/ic-theme.d.ts

@@ -1,17 +1,24 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcColor, IcTheme } from "../../utils/types";
+import { IcColor, IcBrand } from "../../utils/types";
 export declare class Theme {
+    themeClass: string;
     /**
-     * The theme colour. Can be a hex value e.g. "#ff0000", RGB e.g. "rgb(255, 0, 0)", or RGBA e.g. "rgba(255, 0, 0, 1)".
+     * The brand colour. Can be a hex value e.g. "#ff0000", RGB e.g. "rgb(255, 0, 0)", or RGBA e.g. "rgba(255, 0, 0, 1)".
      */
-    color?: IcColor;
-    watchColorPropHandler(): void;
+    brandColor?: IcColor;
+    watchBrandColorPropHandler(): void;
     /**
-     * @internal Emitted when the theme is changed.
+     * The theme mode. Can be "dark", "light", or "system". "system" will use the device or browser settings.
      */
-    themeChange: EventEmitter<IcTheme>;
+    theme: "dark" | "light" | "system";
+    watchThemePropHandler(): void;
+    /**
+     * @internal Emitted when the brand color is changed.
+     */
+    brandChange: EventEmitter<IcBrand>;
     componentWillLoad(): void;
-    private checkThemeColorContrast;
-    private setThemeColor;
+    private darkModeChangeHandler;
+    private checkBrandColorContrast;
+    private setBrandColor;
     render(): any;
 }

package/dist/types/components/ic-toast/ic-toast.d.ts

@@ -7,10 +7,12 @@ import { IcActivationTypes, IcStatusVariants } from "../../utils/types";
 export declare class Toast {
     private dismissTimeout;
     private interactiveElements;
-    private isManual;
     private neutralVariantLabel;
     private timerRefreshInterval;
+    private focusInteractiveElement;
+    private shiftKeyPressed;
     el: HTMLIcToastElement;
+    isManual: boolean;
     timerProgress: number;
     visible: boolean;
     /**
@@ -50,6 +52,8 @@ export declare class Toast {
     disconnectedCallback(): void;
     componentWillLoad(): void;
     componentDidLoad(): void;
+    componentDidUpdate(): void;
+    watchVisibleHandler(): void;
     handleDismiss(): void;
     handleKeyboard(ev: KeyboardEvent): void;
     handleTimer(ev: MouseEvent): void;
@@ -62,6 +66,9 @@ export declare class Toast {
     private handleProgressChange;
     private handleLongText;
     private findNextInteractiveElement;
+    private resetAutoDismissTimer;
     private isActive;
+    private onFocus;
+    private onBlur;
     render(): any;
 }

package/dist/types/components/ic-toast-region/ic-toast-region.d.ts

@@ -10,10 +10,5 @@ export declare class ToastRegion {
     componentDidLoad(): void;
     handleDismissedToast(): void;
     private showToast;
-    /**
-     * @deprecated Use openToast prop to display toast instead.
-     * @param {HTMLIcToastElement} toast The toast component to display
-     */
-    setVisible(toast: HTMLIcToastElement): Promise<void>;
     render(): any;
 }

package/dist/types/components/ic-toggle-button/ic-toggle-button.d.ts

@@ -1,21 +1,19 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcButtonTooltipPlacement, IcSizes, IcThemeForeground } from "../../utils/types";
+import { IcSizes, IcThemeMode, IcIconPlacementOptions, IcButtonTooltipPlacement } from "../../utils/types";
 /**
  * @slot icon - Content will be displayed alongside the toggle button label.
  * @slot badge - Badge component overlaying the top right of the toggle button.
  */
 export declare class ToggleButton {
-    private iconPosition;
-    private hostMutationObserver;
     el: HTMLIcToggleButtonElement;
     /**
      * The accessible label that will be applied to the toggle button. This is required for the icon variant of toggle buttons.
      */
     accessibleLabel?: string;
     /**
-     * The appearance of the toggle button.
+     * If `true`, the toggle button will be in a checked state.
      */
-    appearance?: IcThemeForeground;
+    checked: boolean;
     /**
      * If `true`, the toggle button will be in disabled state.
      */
@@ -28,7 +26,7 @@ export declare class ToggleButton {
     /**
      * The placement of the icon in relation to the toggle button label.
      */
-    iconPlacement?: "left" | "right" | "top";
+    iconPlacement?: IcIconPlacementOptions;
     /**
      * The label to display in the toggle button. This is required for the default variant of toggle buttons.
      */
@@ -37,14 +35,18 @@ export declare class ToggleButton {
      * If `true`, the toggle button will be in loading state.
      */
     loading?: boolean;
+    /**
+     * If `true`, the toggle button will display as black in the light theme, and white in dark theme.
+     */
+    monochrome?: boolean;
     /**
      * The size of the toggle button to be displayed.
      */
     size?: IcSizes;
     /**
-     * If `true`, the toggle button will be in a checked state.
+     * Sets the theme color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
      */
-    toggleChecked: boolean;
+    theme?: IcThemeMode;
     /**
      * The position of the tooltip in relation to the toggle button.
      */
@@ -61,9 +63,8 @@ export declare class ToggleButton {
     }>;
     componentWillLoad(): void;
     componentDidLoad(): void;
-    disconnectedCallback(): void;
-    private hostMutationCallback;
     handleHostClick(e: Event): void;
+    private loopAttributes;
     private handleFocus;
     private handleClick;
     render(): any;

package/dist/types/components/ic-toggle-button-group/ic-toggle-button-group.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcSizes, IcThemeForeground, IcSelectTypes, IcSelectMethodTypes, IcButtonTooltipPlacement } from "../../utils/types";
+import { IcSizes, IcSelectTypes, IcSelectMethodTypes, IcThemeMode, IcButtonTooltipPlacement } from "../../utils/types";
 import { IcChangeEventDetail } from "./ic-toggle-button-group.types";
 interface lastKey {
     key: string | null;
@@ -12,10 +12,6 @@ export declare class ToggleButtonGroup {
      * The accessible label of the toggle button group component to provide context for screen reader users.
      */
     accessibleLabel?: string;
-    /**
-     * The appearance of the toggle button group, e.g dark, or light.
-     */
-    appearance: IcThemeForeground;
     /**
      * If `true`, the toggle button group will be set to the disabled state.
      */
@@ -25,6 +21,7 @@ export declare class ToggleButtonGroup {
      * If `true`, the toggle button group will fill the width of the container.
      */
     fullWidth?: boolean;
+    watchFullWidthHandler(): void;
     /**
      * The placement of the icons in relation to the toggle button labels.
      */
@@ -33,6 +30,12 @@ export declare class ToggleButtonGroup {
      * If `true`, the toggle button group will be in loading state.
      */
     loading?: boolean;
+    watchLoadingHandler(): void;
+    /**
+     * If `true`, the toggle button group will display as black in the light theme, and white in dark theme.
+     */
+    monochrome?: boolean;
+    watchMonochromeHandler(): void;
     /**
      * If `auto`, controls are toggled automatically when navigated to. If `manual`, the controls must be actioned to change their toggled state. The value of this prop is ignored if `selectType` is set to`multi`.
      */
@@ -45,6 +48,12 @@ export declare class ToggleButtonGroup {
      * The size of the toggle buttons to be displayed. This does not affect the font size of the accessible label.
      */
     size?: IcSizes;
+    watchSizeHandler(): void;
+    /**
+     * Sets the theme color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
+     */
+    theme?: IcThemeMode;
+    watchThemeHandler(): void;
     /**
      * The position of the tooltip in relation to the toggle buttons.
      */
@@ -54,6 +63,7 @@ export declare class ToggleButtonGroup {
      * The variant of the toggle button.
      */
     variant: "default" | "icon";
+    watchVariantHandler(): void;
     /**
      * Emitted when a toggle button is selected.
      */

package/dist/types/components/ic-toggle-button-group/ic-toggle-button-group.types.d.ts

@@ -1,5 +1,5 @@
 export interface IcChangeEventDetail {
-    toggleChecked: boolean[] | boolean;
+    checked: boolean[] | boolean;
     toggledOptions?: {
         toggleButton: HTMLIcToggleButtonElement;
     }[];

package/dist/types/components/ic-tooltip/ic-tooltip.d.ts

@@ -1,5 +1,6 @@
 import { Options } from "@popperjs/core";
 import { IcTooltipPlacements } from "./ic-tooltip.types";
+import { IcThemeMode } from "../../utils/types";
 export declare class Tooltip {
     private arrow;
     private delayedHideEvents;
@@ -37,6 +38,10 @@ export declare class Tooltip {
      * The ID of the element the tooltip is describing - for when aria-labelledby or aria-describedby is used.
      */
     target?: string;
+    /**
+     * Sets the tooltip to the dark or light theme colors. "inherit" will set the color based on the system settings or ic-theme component.
+     */
+    theme?: IcThemeMode;
     /**
      * The text to display on the tooltip.
      */

package/dist/types/components/ic-top-navigation/ic-top-navigation.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcAlignment, IcThemeForeground, IcTheme, IcDeviceSizes, IcValueEventDetail } from "../../utils/types";
+import { IcAlignment, IcBrandForeground, IcBrand, IcDeviceSizes, IcValueEventDetail, IcThemeMode } from "../../utils/types";
 import { IcSearchBarBlurEventDetail } from "../ic-search-bar/ic-search-bar.types";
 /**
  * @slot app-icon - Content will be rendered to left of app title. Anything that is slotted here will be hidden from screen readers.
@@ -20,7 +20,7 @@ export declare class TopNavigation {
     private searchBar;
     el: HTMLIcTopNavigationElement;
     deviceSize: number;
-    foregroundColor: IcThemeForeground;
+    foregroundColor: IcBrandForeground;
     hasFullWidthSearchBar: boolean;
     mobileSearchBarVisible: boolean;
     mobileSearchHiddenOnBlur: boolean;
@@ -52,6 +52,10 @@ export declare class TopNavigation {
      * The status info to be displayed.
      */
     status: string;
+    /**
+     * Sets the theme color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
+     */
+    theme?: IcThemeMode;
     /**
      * The version info to be displayed.
      */
@@ -72,7 +76,7 @@ export declare class TopNavigation {
     /**
      * Emitted when the top navigation is resized.
      */
-    topNavResized: EventEmitter<{
+    icTopNavResized: EventEmitter<{
         size: number;
     }>;
     disconnectedCallback(): void;
@@ -82,7 +86,7 @@ export declare class TopNavigation {
     navBarMenuCloseHandler(): void;
     searchInputBlurHandler({ detail, }: CustomEvent<IcSearchBarBlurEventDetail>): void;
     searchValueChangeHandler({ detail }: CustomEvent<IcValueEventDetail>): void;
-    themeChangeHandler({ detail }: CustomEvent<IcTheme>): void;
+    brandChangeHandler({ detail }: CustomEvent<IcBrand>): void;
     private checkSlots;
     private initialiseSearchBar;
     private toggleSearchBar;

package/dist/types/components/ic-typography/ic-typography.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "../../stencil-public-runtime";
-import { IcTypographyVariants } from "../../utils/types";
+import { IcTypographyVariants, IcThemeMode } from "../../utils/types";
 export declare class Typography {
     private focusBtnFromKeyboard;
     private inAGGrid;
@@ -34,6 +34,10 @@ export declare class Typography {
      * If `true`, the typography will have a line through it.
      */
     strikethrough?: boolean;
+    /**
+     * Sets the text color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
+     */
+    theme?: IcThemeMode;
     /**
      * If `true`, the typography will have a line under it.
      */