@pine-ds/core 2.14.0-mercury.0 → 2.14.0

package/dist/types/components.d.ts

@@ -7,9 +7,11 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { BoxColumnType, BoxShadowSizeType, BoxTShirtSizeType } from "./utils/types";
 import { CheckboxChangeEventDetail } from "./components/pds-checkbox/checkbox-interface";
+import { PlacementType } from "./utils/types";
 import { TextareaChangeEventDetail } from "./components/pds-textarea/textarea-interface";
 export { BoxColumnType, BoxShadowSizeType, BoxTShirtSizeType } from "./utils/types";
 export { CheckboxChangeEventDetail } from "./components/pds-checkbox/checkbox-interface";
+export { PlacementType } from "./utils/types";
 export { TextareaChangeEventDetail } from "./components/pds-textarea/textarea-interface";
 export namespace Components {
     interface PdsAccordion {
@@ -194,20 +196,21 @@ export namespace Components {
          */
         "componentId": string;
         /**
-          * Toggles disabled state of button
+          * Determines the button's disabled state.
           * @defaultValue false
          */
         "disabled"?: boolean;
         /**
-          * Displays icon before text when icon string matches an icon name
+          * Displays an icon before the text when the icon string matches an icon name.
+          * @defaultValue null
          */
         "icon"?: string;
         /**
-          * Provides button with a submittable name
+          * Provides the button with a submittable name.
          */
         "name"?: string;
         /**
-          * Provides button with a type
+          * Provides button with a type.
           * @defaultValue button
          */
         "type"?: 'button' | 'reset' | 'submit';
@@ -216,7 +219,8 @@ export namespace Components {
          */
         "value"?: string;
         /**
-          * Sets button variant styles as outlined in Figma documentation
+          * Sets the style variant of the button.
+          * @defaultValue primary
          */
         "variant": 'primary' | 'secondary' | 'accent' | 'disclosure' | 'destructive' | 'unstyled';
     }
@@ -285,12 +289,12 @@ export namespace Components {
          */
         "label": string;
         /**
-          * Determines whether the chip should be rendered in a larger size.
+          * Determines whether the chip should be displayed in a larger size.
           * @defaultValue false
          */
         "large": boolean;
         /**
-          * Sets the color scheme of the chip.
+          * Defines the color scheme of the chip.
           * @defaultValue 'neutral'
          */
         "sentiment": 'accent' | 'danger' | 'info' | 'neutral' | 'success' | 'warning';
@@ -302,7 +306,7 @@ export namespace Components {
     }
     interface PdsCopytext {
         /**
-          * Determines whether `copytext` should have a border.
+          * Determines whether `copytext` should have a visible border.
           * @defaultValue true
          */
         "border": boolean;
@@ -321,7 +325,7 @@ export namespace Components {
          */
         "truncate": boolean;
         /**
-          * String that is displayed and that is also copied to the clipboard upon interaction.
+          * The string displayed that is also copied to the clipboard upon interaction.
          */
         "value": string;
     }
@@ -335,14 +339,15 @@ export namespace Components {
          */
         "offset": 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
         /**
-          * Sets divider to display vertically
+          * Sets divider to display vertically.
           * @defaultValue false
          */
         "vertical": boolean;
     }
     interface PdsImage {
         /**
-          * The image's alt tag. If none is provided, it will default to an empty string.
+          * The image's alt tag. If none is provided, it will default to an empty string, which is desired for decorative images.
+          * @defaultValue ''
          */
         "alt"?: string;
         /**
@@ -355,10 +360,11 @@ export namespace Components {
         "height"?: number;
         /**
           * Indicates how the browser should load the image.
+          * @defaultValue eager
          */
         "loading"?: 'eager' | 'lazy';
         /**
-          * Determines the intended display size of an image within certian breakpoints. Has no effect if `srcset` is not set or value has no width descriptor.
+          * Determines the intended display size of an image within certain breakpoints. Has no effect if `srcset` is not set or value has no width descriptor.
          */
         "sizes"?: string;
         /**
@@ -366,7 +372,7 @@ export namespace Components {
          */
         "src": string;
         /**
-          * A set of image sources for the browser to use.
+          * A set of image sources for the browser to use for responsiveness.
          */
         "srcset"?: string;
         /**
@@ -375,12 +381,16 @@ export namespace Components {
         "width"?: number;
     }
     interface PdsInput {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete": string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
         /**
-          * Indicates whether or not the input field is disabled.
+          * Determines whether or not the input field is disabled.
          */
         "disabled"?: boolean;
         /**
@@ -392,7 +402,7 @@ export namespace Components {
          */
         "helperMessage"?: string;
         /**
-          * Indicates whether or not the input field is invalid or throws an error.
+          * Determines whether or not the input field is invalid or throws an error.
          */
         "invalid"?: boolean;
         /**
@@ -408,11 +418,11 @@ export namespace Components {
          */
         "placeholder"?: string;
         /**
-          * Indicates whether or not the input field is readonly.
+          * Determines whether or not the input field is readonly.
          */
         "readonly"?: boolean;
         /**
-          * Indicates whether or not the input field is required.
+          * Determines whether or not the input field is required.
          */
         "required"?: boolean;
         /**
@@ -431,21 +441,22 @@ export namespace Components {
          */
         "componentId": string;
         /**
-          * When enabled, opens link in a new tab.
+          * Determines whether the link should open in a new tab.
           * @defaultValue false
          */
         "external": boolean;
         /**
-          * The Font size follows t-shirt model sm: 12px md: 14px lg: 16px
+          * The font size of the link's text.
           * @defaultValue lg
          */
         "fontSize": 'sm' | 'md' | 'lg';
         /**
-          * The URL that the hyperlink points to.
+          * The hyperlink's destination URL. If no text is provided in the custom slot, the href will be used.
          */
         "href": string;
         /**
-          * Modifies the look of the link
+          * Sets the link variant styles.
+          * @defaultValue inline
          */
         "variant": 'inline' | 'plain';
     }
@@ -472,6 +483,35 @@ export namespace Components {
          */
         "variant": 'spinner' | 'typing';
     }
+    interface PdsPopover {
+        /**
+          * A unique identifier used for the underlying component `id` attribute.
+         */
+        "componentId": string;
+        /**
+          * Sets the maximum width of the popover content
+          * @defaultValue 352
+         */
+        "maxWidth"?: number;
+        /**
+          * Determines the preferred position of the popover
+          * @defaultValue "right"
+         */
+        "placement": PlacementType;
+        /**
+          * Determines the action that triggers the popover. For manual popovers, the consumer is responsible for toggling this value.
+          * @defaultValue "show"
+         */
+        "popoverTargetAction": 'show' | 'toggle' | 'hide';
+        /**
+          * Determines the type of popover. Auto popovers can be "light dismissed" by clicking outside of the popover. Manual popovers require the consumer to handle the visibility of the popover.
+         */
+        "popoverType": 'auto' | 'manual';
+        /**
+          * Text that appears on the trigger element
+         */
+        "text": string;
+    }
     interface PdsProgress {
         /**
           * Determines whether or not progress is animated.
@@ -518,11 +558,11 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * Displays message text describing an invalid state.
+          * Displays error message text describing an invalid state.
          */
         "errorMessage": string;
         /**
-          * String used for helper message below radio.
+          * Displays helper message text below radio.
          */
         "helperMessage": string;
         /**
@@ -580,6 +620,55 @@ export namespace Components {
          */
         "noWrap"?: boolean;
     }
+    interface PdsSelect {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete": string;
+        /**
+          * A unique identifier used for the underlying component `id` attribute.
+         */
+        "componentId": string;
+        /**
+          * Indicates whether or not the select field is disabled.
+          * @defaultValue false
+         */
+        "disabled": boolean;
+        /**
+          * Displays error message text describing an invalid state.
+         */
+        "errorMessage": string;
+        /**
+          * Displays helper message text below select.
+         */
+        "helperMessage": string;
+        /**
+          * Determines whether or not the select is invalid.
+         */
+        "invalid"?: boolean;
+        /**
+          * Text to be displayed as the select label.
+         */
+        "label": string;
+        /**
+          * Indicates whether multiple options can be selected.
+          * @defaultValue false
+         */
+        "multiple": boolean;
+        /**
+          * Specifies the name. Submitted with the form name/value pair.
+         */
+        "name": string;
+        /**
+          * Indicates whether or not the select field is required.
+          * @defaultValue false
+         */
+        "required": boolean;
+        /**
+          * The value(s) of the selected option(s).
+         */
+        "value"?: string | string[];
+    }
     interface PdsSortable {
         /**
           * Determines whether `sortable` should have a border.
@@ -617,7 +706,7 @@ export namespace Components {
     }
     interface PdsSwitch {
         /**
-          * Determines the input 'checked' state
+          * Determines the input 'checked' state.
          */
         "checked": boolean;
         /**
@@ -625,40 +714,35 @@ export namespace Components {
          */
         "componentId": string;
         /**
-          * Determines the input 'disabled' state, preventing user interaction
+          * Determines the input 'disabled' state, preventing user interaction.
          */
         "disabled"?: boolean;
         /**
-          * Displays message text describing an invalid state
+          * Displays message text describing an invalid state.
          */
         "errorMessage"?: string;
         /**
-          * Displays help text for additional description of an input
+          * Displays help text for additional description of an input.
          */
         "helperMessage": string;
         /**
-          * Determines the input 'invalid' state, signifying an error is present
+          * Determines the input 'invalid' state, signifying an error is present.
          */
         "invalid"?: boolean;
         /**
-          * Displays text to describe the input
+          * Displays text to describe the input.
          */
         "label": string;
         /**
-          * Identifies form data and unifies a group of radio inputs for toggling a single property/value
+          * Identifies form data and unifies a group of radio inputs for toggling a single property/value.
          */
         "name": string;
         /**
-          * Determines the 'required' state of the input
+          * Determines the 'required' state of the input.
          */
         "required"?: boolean;
         /**
-          * Specifies the underlying input element type
-          * @defaultValue 'checkbox'
-         */
-        "type": 'checkbox' | 'radio';
-        /**
-          * Provides input with a string submitted in form data, and can be used to distinguish radio inputs
+          * Provides input with a string submitted in form data.
          */
         "value": string;
     }
@@ -674,7 +758,7 @@ export namespace Components {
     }
     interface PdsTable {
         /**
-          * Determines if table displays compact which reduces the spacing of table cells.
+          * Determines if the table displays with reduced table cell padding.
          */
         "compact": boolean;
         /**
@@ -682,7 +766,7 @@ export namespace Components {
          */
         "componentId": string;
         /**
-          * Determines if table displays fixed column which fixes the first column of the table.
+          * Determines if the should display a fixed first column.
          */
         "fixedColumn": boolean;
         /**
@@ -690,7 +774,7 @@ export namespace Components {
          */
         "responsive": boolean;
         /**
-          * Determines if table displays checkboxes for selectable rows.
+          * Determines if the table displays checkboxes for selectable rows.
          */
         "selectable": boolean;
     }
@@ -704,11 +788,12 @@ export namespace Components {
     }
     interface PdsTableHead {
         /**
-          * Indicates that the selection state is indeterminate.
+          * Determines if the select all checkbox is in an indeterminate state.
          */
         "indeterminate"?: boolean;
         /**
-          * A local state to track whether the row is currently selected.
+          * Determines if the table row is currently selected.
+          * @defaultValue false
          */
         "isSelected": boolean;
     }
@@ -720,11 +805,11 @@ export namespace Components {
     }
     interface PdsTableRow {
         /**
-          * Indicates that the selection state is indeterminate.
+          * Determines if the row selected is in an indeterminate state.
          */
         "indeterminate"?: boolean;
         /**
-          * A local state to track whether the row is currently selected.
+          * Determines if the table row is currently selected.
          */
         "isSelected"?: boolean;
     }
@@ -756,57 +841,126 @@ export namespace Components {
          */
         "variant": 'primary' | 'availability' | 'filter';
     }
+    interface PdsText {
+        /**
+          * Sets the text alignment.
+         */
+        "align"?: 'start' | 'center' | 'end' | 'justify';
+        /**
+          * Sets the text color.
+         */
+        "color"?: | 'primary'
+  | 'secondary'
+  | 'neutral'
+  | 'accent'
+  | 'danger'
+  | 'info'
+  | 'success'
+  | 'warning';
+        /**
+          * Sets the text decoration.
+         */
+        "decoration"?: | 'strikethrough'
+  | 'underline-dotted';
+        /**
+          * Set the bottom margin for the text.
+         */
+        "gutter"?: | '2xl'
+  | 'xl'
+  | 'lg'
+  | 'md'
+  | 'sm'
+  | 'xs'
+  | '2xs';
+        /**
+          * Sets the font size.
+         */
+        "size"?: | '2xl'
+  | 'xl'
+  | 'lg'
+  | 'md'
+  | 'sm'
+  | 'xs'
+  | '2xs';
+        /**
+          * Determines what semantic text tag to render.
+         */
+        "tag": | 'h1'
+  | 'h2'
+  | 'h3'
+  | 'h4'
+  | 'h5'
+  | 'h6'
+  | 'p'
+  | 'code'
+  | 'pre'
+  | 'strong'
+  | 'em';
+        /**
+          * Sets the font weight.
+         */
+        "weight"?: | 'extra-light'
+  | 'light'
+  | 'regular'
+  | 'medium'
+  | 'semibold'
+  | 'bold';
+    }
     interface PdsTextarea {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete": string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
         /**
-          * Indicates whether or not the textarea is disabled
+          * Determines whether or not the textarea is disabled.
           * @defaultValue false
          */
         "disabled": boolean;
         /**
-          * Specifies the error text and provides an error-themed treatment to the field
+          * Displays an error message below the textarea field.
          */
         "errorMessage"?: string;
         /**
-          * Displays a hint or description of the textarea
+          * Displays a message or hint below the textarea field.
          */
         "helperMessage"?: string;
         /**
-          * Indicates whether or not the textarea is invalid or throws an error
+          * Determines whether or not the textarea is invalid or throws an error.
           * @defaultValue false
          */
         "invalid": boolean;
         /**
-          * Text to be displayed as the textarea label
+          * Text to be displayed as the textarea label.
          */
         "label"?: string;
         /**
-          * Specifies the name, submitted with the form name/value pair. This value will mirror the componentId
+          * Specifies the name. Submitted with the form name/value pair. This value will mirror the componentId.
          */
         "name": string;
         /**
-          * Specifies a short hint that describes the expected value of the textarea
+          * Specifies a short hint that describes the expected value of the textarea.
          */
         "placeholder"?: string;
         /**
-          * Indicates whether or not the textarea is readonly
+          * Determines whether or not the textarea is readonly.
           * @defaultValue false
          */
         "readonly": boolean;
         /**
-          * Indicates whether or not the textarea is required
+          * Determines whether or not the textarea is required.
           * @defaultValue false
          */
         "required": boolean;
         /**
-          * Sets number of rows of text visible without needing to scroll in the textarea
+          * Sets number of rows of text visible without needing to scroll in the textarea.
          */
         "rows"?: number;
         /**
-          * The value of the textarea
+          * The value of the textarea.
          */
         "value"?: string;
     }
@@ -833,6 +987,11 @@ export namespace Components {
           * @defaultValue false
          */
         "htmlContent": boolean;
+        /**
+          * Sets the maximum width of the tooltip content
+          * @defaultValue "352px"
+         */
+        "maxWidth": string;
         /**
           * Determines whether or not the tooltip is visible
           * @defaultValue false
@@ -860,6 +1019,10 @@ export namespace Components {
         "showTooltip": () => Promise<void>;
     }
 }
+export interface PdsButtonCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLPdsButtonElement;
+}
 export interface PdsCheckboxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLPdsCheckboxElement;
@@ -880,6 +1043,10 @@ export interface PdsRadioCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLPdsRadioElement;
 }
+export interface PdsSelectCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLPdsSelectElement;
+}
 export interface PdsSortableCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLPdsSortableElement;
@@ -912,10 +1079,6 @@ export interface PdsTextareaCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLPdsTextareaElement;
 }
-export interface PdsTooltipCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLPdsTooltipElement;
-}
 declare global {
     interface HTMLPdsAccordionElement extends Components.PdsAccordion, HTMLStencilElement {
     }
@@ -935,7 +1098,18 @@ declare global {
         prototype: HTMLPdsBoxElement;
         new (): HTMLPdsBoxElement;
     };
+    interface HTMLPdsButtonElementEventMap {
+        "pdsClick": any;
+    }
     interface HTMLPdsButtonElement extends Components.PdsButton, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLPdsButtonElementEventMap>(type: K, listener: (this: HTMLPdsButtonElement, ev: PdsButtonCustomEvent<HTMLPdsButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLPdsButtonElementEventMap>(type: K, listener: (this: HTMLPdsButtonElement, ev: PdsButtonCustomEvent<HTMLPdsButtonElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     }
     var HTMLPdsButtonElement: {
         prototype: HTMLPdsButtonElement;
@@ -1034,6 +1208,12 @@ declare global {
         prototype: HTMLPdsLoaderElement;
         new (): HTMLPdsLoaderElement;
     };
+    interface HTMLPdsPopoverElement extends Components.PdsPopover, HTMLStencilElement {
+    }
+    var HTMLPdsPopoverElement: {
+        prototype: HTMLPdsPopoverElement;
+        new (): HTMLPdsPopoverElement;
+    };
     interface HTMLPdsProgressElement extends Components.PdsProgress, HTMLStencilElement {
     }
     var HTMLPdsProgressElement: {
@@ -1063,6 +1243,23 @@ declare global {
         prototype: HTMLPdsRowElement;
         new (): HTMLPdsRowElement;
     };
+    interface HTMLPdsSelectElementEventMap {
+        "pdsSelectChange": InputEvent;
+    }
+    interface HTMLPdsSelectElement extends Components.PdsSelect, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLPdsSelectElementEventMap>(type: K, listener: (this: HTMLPdsSelectElement, ev: PdsSelectCustomEvent<HTMLPdsSelectElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLPdsSelectElementEventMap>(type: K, listener: (this: HTMLPdsSelectElement, ev: PdsSelectCustomEvent<HTMLPdsSelectElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLPdsSelectElement: {
+        prototype: HTMLPdsSelectElement;
+        new (): HTMLPdsSelectElement;
+    };
     interface HTMLPdsSortableElementEventMap {
         "pdsSortableItemMoved": any;
     }
@@ -1213,6 +1410,12 @@ declare global {
         prototype: HTMLPdsTabsElement;
         new (): HTMLPdsTabsElement;
     };
+    interface HTMLPdsTextElement extends Components.PdsText, HTMLStencilElement {
+    }
+    var HTMLPdsTextElement: {
+        prototype: HTMLPdsTextElement;
+        new (): HTMLPdsTextElement;
+    };
     interface HTMLPdsTextareaElementEventMap {
         "pdsTextareaChange": TextareaChangeEventDetail;
     }
@@ -1230,19 +1433,7 @@ declare global {
         prototype: HTMLPdsTextareaElement;
         new (): HTMLPdsTextareaElement;
     };
-    interface HTMLPdsTooltipElementEventMap {
-        "pdsTooltipHide": any;
-        "pdsTooltipShow": any;
-    }
     interface HTMLPdsTooltipElement extends Components.PdsTooltip, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLPdsTooltipElementEventMap>(type: K, listener: (this: HTMLPdsTooltipElement, ev: PdsTooltipCustomEvent<HTMLPdsTooltipElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLPdsTooltipElementEventMap>(type: K, listener: (this: HTMLPdsTooltipElement, ev: PdsTooltipCustomEvent<HTMLPdsTooltipElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     }
     var HTMLPdsTooltipElement: {
         prototype: HTMLPdsTooltipElement;
@@ -1261,9 +1452,11 @@ declare global {
         "pds-input": HTMLPdsInputElement;
         "pds-link": HTMLPdsLinkElement;
         "pds-loader": HTMLPdsLoaderElement;
+        "pds-popover": HTMLPdsPopoverElement;
         "pds-progress": HTMLPdsProgressElement;
         "pds-radio": HTMLPdsRadioElement;
         "pds-row": HTMLPdsRowElement;
+        "pds-select": HTMLPdsSelectElement;
         "pds-sortable": HTMLPdsSortableElement;
         "pds-sortable-item": HTMLPdsSortableItemElement;
         "pds-switch": HTMLPdsSwitchElement;
@@ -1276,6 +1469,7 @@ declare global {
         "pds-table-row": HTMLPdsTableRowElement;
         "pds-tabpanel": HTMLPdsTabpanelElement;
         "pds-tabs": HTMLPdsTabsElement;
+        "pds-text": HTMLPdsTextElement;
         "pds-textarea": HTMLPdsTextareaElement;
         "pds-tooltip": HTMLPdsTooltipElement;
     }
@@ -1463,20 +1657,22 @@ declare namespace LocalJSX {
          */
         "componentId"?: string;
         /**
-          * Toggles disabled state of button
+          * Determines the button's disabled state.
           * @defaultValue false
          */
         "disabled"?: boolean;
         /**
-          * Displays icon before text when icon string matches an icon name
+          * Displays an icon before the text when the icon string matches an icon name.
+          * @defaultValue null
          */
         "icon"?: string;
         /**
-          * Provides button with a submittable name
+          * Provides the button with a submittable name.
          */
         "name"?: string;
+        "onPdsClick"?: (event: PdsButtonCustomEvent<any>) => void;
         /**
-          * Provides button with a type
+          * Provides button with a type.
           * @defaultValue button
          */
         "type"?: 'button' | 'reset' | 'submit';
@@ -1485,7 +1681,8 @@ declare namespace LocalJSX {
          */
         "value"?: string;
         /**
-          * Sets button variant styles as outlined in Figma documentation
+          * Sets the style variant of the button.
+          * @defaultValue primary
          */
         "variant"?: 'primary' | 'secondary' | 'accent' | 'disclosure' | 'destructive' | 'unstyled';
     }
@@ -1559,16 +1756,16 @@ declare namespace LocalJSX {
          */
         "label"?: string;
         /**
-          * Determines whether the chip should be rendered in a larger size.
+          * Determines whether the chip should be displayed in a larger size.
           * @defaultValue false
          */
         "large"?: boolean;
         /**
-          * Event when close button is clicked on tag variant.
+          * Event emitted when the close button is clicked on a tag variant chip.
          */
         "onPdsTagCloseClick"?: (event: PdsChipCustomEvent<any>) => void;
         /**
-          * Sets the color scheme of the chip.
+          * Defines the color scheme of the chip.
           * @defaultValue 'neutral'
          */
         "sentiment"?: 'accent' | 'danger' | 'info' | 'neutral' | 'success' | 'warning';
@@ -1580,7 +1777,7 @@ declare namespace LocalJSX {
     }
     interface PdsCopytext {
         /**
-          * Determines whether `copytext` should have a border.
+          * Determines whether `copytext` should have a visible border.
           * @defaultValue true
          */
         "border"?: boolean;
@@ -1594,7 +1791,7 @@ declare namespace LocalJSX {
          */
         "fullWidth"?: boolean;
         /**
-          * Event when copyText button is clicked.
+          * Event fired when copyText button is clicked.
          */
         "onPdsCopyTextClick"?: (event: PdsCopytextCustomEvent<any>) => void;
         /**
@@ -1603,7 +1800,7 @@ declare namespace LocalJSX {
          */
         "truncate"?: boolean;
         /**
-          * String that is displayed and that is also copied to the clipboard upon interaction.
+          * The string displayed that is also copied to the clipboard upon interaction.
          */
         "value": string;
     }
@@ -1617,14 +1814,15 @@ declare namespace LocalJSX {
          */
         "offset"?: 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
         /**
-          * Sets divider to display vertically
+          * Sets divider to display vertically.
           * @defaultValue false
          */
         "vertical"?: boolean;
     }
     interface PdsImage {
         /**
-          * The image's alt tag. If none is provided, it will default to an empty string.
+          * The image's alt tag. If none is provided, it will default to an empty string, which is desired for decorative images.
+          * @defaultValue ''
          */
         "alt"?: string;
         /**
@@ -1637,10 +1835,11 @@ declare namespace LocalJSX {
         "height"?: number;
         /**
           * Indicates how the browser should load the image.
+          * @defaultValue eager
          */
         "loading"?: 'eager' | 'lazy';
         /**
-          * Determines the intended display size of an image within certian breakpoints. Has no effect if `srcset` is not set or value has no width descriptor.
+          * Determines the intended display size of an image within certain breakpoints. Has no effect if `srcset` is not set or value has no width descriptor.
          */
         "sizes"?: string;
         /**
@@ -1648,7 +1847,7 @@ declare namespace LocalJSX {
          */
         "src"?: string;
         /**
-          * A set of image sources for the browser to use.
+          * A set of image sources for the browser to use for responsiveness.
          */
         "srcset"?: string;
         /**
@@ -1657,12 +1856,16 @@ declare namespace LocalJSX {
         "width"?: number;
     }
     interface PdsInput {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
         /**
-          * Indicates whether or not the input field is disabled.
+          * Determines whether or not the input field is disabled.
          */
         "disabled"?: boolean;
         /**
@@ -1674,7 +1877,7 @@ declare namespace LocalJSX {
          */
         "helperMessage"?: string;
         /**
-          * Indicates whether or not the input field is invalid or throws an error.
+          * Determines whether or not the input field is invalid or throws an error.
          */
         "invalid"?: boolean;
         /**
@@ -1686,7 +1889,7 @@ declare namespace LocalJSX {
          */
         "name"?: string;
         /**
-          * Emitted when a keyboard input occurred.
+          * Emitted when a keyboard input occurs.
          */
         "onPdsInput"?: (event: PdsInputCustomEvent<InputEvent>) => void;
         /**
@@ -1694,11 +1897,11 @@ declare namespace LocalJSX {
          */
         "placeholder"?: string;
         /**
-          * Indicates whether or not the input field is readonly.
+          * Determines whether or not the input field is readonly.
          */
         "readonly"?: boolean;
         /**
-          * Indicates whether or not the input field is required.
+          * Determines whether or not the input field is required.
          */
         "required"?: boolean;
         /**
@@ -1717,21 +1920,22 @@ declare namespace LocalJSX {
          */
         "componentId"?: string;
         /**
-          * When enabled, opens link in a new tab.
+          * Determines whether the link should open in a new tab.
           * @defaultValue false
          */
         "external"?: boolean;
         /**
-          * The Font size follows t-shirt model sm: 12px md: 14px lg: 16px
+          * The font size of the link's text.
           * @defaultValue lg
          */
         "fontSize"?: 'sm' | 'md' | 'lg';
         /**
-          * The URL that the hyperlink points to.
+          * The hyperlink's destination URL. If no text is provided in the custom slot, the href will be used.
          */
         "href": string;
         /**
-          * Modifies the look of the link
+          * Sets the link variant styles.
+          * @defaultValue inline
          */
         "variant"?: 'inline' | 'plain';
     }
@@ -1758,6 +1962,35 @@ declare namespace LocalJSX {
          */
         "variant"?: 'spinner' | 'typing';
     }
+    interface PdsPopover {
+        /**
+          * A unique identifier used for the underlying component `id` attribute.
+         */
+        "componentId"?: string;
+        /**
+          * Sets the maximum width of the popover content
+          * @defaultValue 352
+         */
+        "maxWidth"?: number;
+        /**
+          * Determines the preferred position of the popover
+          * @defaultValue "right"
+         */
+        "placement"?: PlacementType;
+        /**
+          * Determines the action that triggers the popover. For manual popovers, the consumer is responsible for toggling this value.
+          * @defaultValue "show"
+         */
+        "popoverTargetAction"?: 'show' | 'toggle' | 'hide';
+        /**
+          * Determines the type of popover. Auto popovers can be "light dismissed" by clicking outside of the popover. Manual popovers require the consumer to handle the visibility of the popover.
+         */
+        "popoverType"?: 'auto' | 'manual';
+        /**
+          * Text that appears on the trigger element
+         */
+        "text"?: string;
+    }
     interface PdsProgress {
         /**
           * Determines whether or not progress is animated.
@@ -1804,11 +2037,11 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * Displays message text describing an invalid state.
+          * Displays error message text describing an invalid state.
          */
         "errorMessage"?: string;
         /**
-          * String used for helper message below radio.
+          * Displays helper message text below radio.
          */
         "helperMessage"?: string;
         /**
@@ -1870,6 +2103,59 @@ declare namespace LocalJSX {
          */
         "noWrap"?: boolean;
     }
+    interface PdsSelect {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete"?: string;
+        /**
+          * A unique identifier used for the underlying component `id` attribute.
+         */
+        "componentId": string;
+        /**
+          * Indicates whether or not the select field is disabled.
+          * @defaultValue false
+         */
+        "disabled"?: boolean;
+        /**
+          * Displays error message text describing an invalid state.
+         */
+        "errorMessage"?: string;
+        /**
+          * Displays helper message text below select.
+         */
+        "helperMessage"?: string;
+        /**
+          * Determines whether or not the select is invalid.
+         */
+        "invalid"?: boolean;
+        /**
+          * Text to be displayed as the select label.
+         */
+        "label"?: string;
+        /**
+          * Indicates whether multiple options can be selected.
+          * @defaultValue false
+         */
+        "multiple"?: boolean;
+        /**
+          * Specifies the name. Submitted with the form name/value pair.
+         */
+        "name": string;
+        /**
+          * Emitted when a keyboard input occurs.
+         */
+        "onPdsSelectChange"?: (event: PdsSelectCustomEvent<InputEvent>) => void;
+        /**
+          * Indicates whether or not the select field is required.
+          * @defaultValue false
+         */
+        "required"?: boolean;
+        /**
+          * The value(s) of the selected option(s).
+         */
+        "value"?: string | string[];
+    }
     interface PdsSortable {
         /**
           * Determines whether `sortable` should have a border.
@@ -1911,7 +2197,7 @@ declare namespace LocalJSX {
     }
     interface PdsSwitch {
         /**
-          * Determines the input 'checked' state
+          * Determines the input 'checked' state.
          */
         "checked"?: boolean;
         /**
@@ -1919,44 +2205,39 @@ declare namespace LocalJSX {
          */
         "componentId": string;
         /**
-          * Determines the input 'disabled' state, preventing user interaction
+          * Determines the input 'disabled' state, preventing user interaction.
          */
         "disabled"?: boolean;
         /**
-          * Displays message text describing an invalid state
+          * Displays message text describing an invalid state.
          */
         "errorMessage"?: string;
         /**
-          * Displays help text for additional description of an input
+          * Displays help text for additional description of an input.
          */
         "helperMessage"?: string;
         /**
-          * Determines the input 'invalid' state, signifying an error is present
+          * Determines the input 'invalid' state, signifying an error is present.
          */
         "invalid"?: boolean;
         /**
-          * Displays text to describe the input
+          * Displays text to describe the input.
          */
         "label": string;
         /**
-          * Identifies form data and unifies a group of radio inputs for toggling a single property/value
+          * Identifies form data and unifies a group of radio inputs for toggling a single property/value.
          */
         "name"?: string;
         /**
-          * Emits an event on input change
+          * Emits an event on input change.
          */
         "onPdsSwitchChange"?: (event: PdsSwitchCustomEvent<InputEvent>) => void;
         /**
-          * Determines the 'required' state of the input
+          * Determines the 'required' state of the input.
          */
         "required"?: boolean;
         /**
-          * Specifies the underlying input element type
-          * @defaultValue 'checkbox'
-         */
-        "type"?: 'checkbox' | 'radio';
-        /**
-          * Provides input with a string submitted in form data, and can be used to distinguish radio inputs
+          * Provides input with a string submitted in form data.
          */
         "value"?: string;
     }
@@ -1968,7 +2249,7 @@ declare namespace LocalJSX {
     }
     interface PdsTable {
         /**
-          * Determines if table displays compact which reduces the spacing of table cells.
+          * Determines if the table displays with reduced table cell padding.
          */
         "compact"?: boolean;
         /**
@@ -1976,7 +2257,7 @@ declare namespace LocalJSX {
          */
         "componentId": string;
         /**
-          * Determines if table displays fixed column which fixes the first column of the table.
+          * Determines if the should display a fixed first column.
          */
         "fixedColumn"?: boolean;
         /**
@@ -1992,7 +2273,7 @@ declare namespace LocalJSX {
          */
         "responsive"?: boolean;
         /**
-          * Determines if table displays checkboxes for selectable rows.
+          * Determines if the table displays checkboxes for selectable rows.
          */
         "selectable"?: boolean;
     }
@@ -2006,11 +2287,12 @@ declare namespace LocalJSX {
     }
     interface PdsTableHead {
         /**
-          * Indicates that the selection state is indeterminate.
+          * Determines if the select all checkbox is in an indeterminate state.
          */
         "indeterminate"?: boolean;
         /**
-          * A local state to track whether the row is currently selected.
+          * Determines if the table row is currently selected.
+          * @defaultValue false
          */
         "isSelected"?: boolean;
         /**
@@ -2030,11 +2312,11 @@ declare namespace LocalJSX {
     }
     interface PdsTableRow {
         /**
-          * Indicates that the selection state is indeterminate.
+          * Determines if the row selected is in an indeterminate state.
          */
         "indeterminate"?: boolean;
         /**
-          * A local state to track whether the row is currently selected.
+          * Determines if the table row is currently selected.
          */
         "isSelected"?: boolean;
         /**
@@ -2066,61 +2348,130 @@ declare namespace LocalJSX {
          */
         "variant": 'primary' | 'availability' | 'filter';
     }
+    interface PdsText {
+        /**
+          * Sets the text alignment.
+         */
+        "align"?: 'start' | 'center' | 'end' | 'justify';
+        /**
+          * Sets the text color.
+         */
+        "color"?: | 'primary'
+  | 'secondary'
+  | 'neutral'
+  | 'accent'
+  | 'danger'
+  | 'info'
+  | 'success'
+  | 'warning';
+        /**
+          * Sets the text decoration.
+         */
+        "decoration"?: | 'strikethrough'
+  | 'underline-dotted';
+        /**
+          * Set the bottom margin for the text.
+         */
+        "gutter"?: | '2xl'
+  | 'xl'
+  | 'lg'
+  | 'md'
+  | 'sm'
+  | 'xs'
+  | '2xs';
+        /**
+          * Sets the font size.
+         */
+        "size"?: | '2xl'
+  | 'xl'
+  | 'lg'
+  | 'md'
+  | 'sm'
+  | 'xs'
+  | '2xs';
+        /**
+          * Determines what semantic text tag to render.
+         */
+        "tag"?: | 'h1'
+  | 'h2'
+  | 'h3'
+  | 'h4'
+  | 'h5'
+  | 'h6'
+  | 'p'
+  | 'code'
+  | 'pre'
+  | 'strong'
+  | 'em';
+        /**
+          * Sets the font weight.
+         */
+        "weight"?: | 'extra-light'
+  | 'light'
+  | 'regular'
+  | 'medium'
+  | 'semibold'
+  | 'bold';
+    }
     interface PdsTextarea {
+        /**
+          * Specifies if and how the browser provides `autocomplete` assistance for the field.
+         */
+        "autocomplete"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
         /**
-          * Indicates whether or not the textarea is disabled
+          * Determines whether or not the textarea is disabled.
           * @defaultValue false
          */
         "disabled"?: boolean;
         /**
-          * Specifies the error text and provides an error-themed treatment to the field
+          * Displays an error message below the textarea field.
          */
         "errorMessage"?: string;
         /**
-          * Displays a hint or description of the textarea
+          * Displays a message or hint below the textarea field.
          */
         "helperMessage"?: string;
         /**
-          * Indicates whether or not the textarea is invalid or throws an error
+          * Determines whether or not the textarea is invalid or throws an error.
           * @defaultValue false
          */
         "invalid"?: boolean;
         /**
-          * Text to be displayed as the textarea label
+          * Text to be displayed as the textarea label.
          */
         "label"?: string;
         /**
-          * Specifies the name, submitted with the form name/value pair. This value will mirror the componentId
+          * Specifies the name. Submitted with the form name/value pair. This value will mirror the componentId.
          */
         "name"?: string;
         /**
-          * Event emitted whenever the value of the textarea changes
+          * Event emitted whenever the value of the textarea changes.
          */
         "onPdsTextareaChange"?: (event: PdsTextareaCustomEvent<TextareaChangeEventDetail>) => void;
         /**
-          * Specifies a short hint that describes the expected value of the textarea
+          * Specifies a short hint that describes the expected value of the textarea.
          */
         "placeholder"?: string;
         /**
-          * Indicates whether or not the textarea is readonly
+          * Determines whether or not the textarea is readonly.
           * @defaultValue false
          */
         "readonly"?: boolean;
         /**
-          * Indicates whether or not the textarea is required
+          * Determines whether or not the textarea is required.
           * @defaultValue false
          */
         "required"?: boolean;
         /**
-          * Sets number of rows of text visible without needing to scroll in the textarea
+          * Sets number of rows of text visible without needing to scroll in the textarea.
          */
         "rows"?: number;
         /**
-          * The value of the textarea
+          * The value of the textarea.
          */
         "value"?: string;
     }
@@ -2144,13 +2495,10 @@ declare namespace LocalJSX {
          */
         "htmlContent"?: boolean;
         /**
-          * Emitted after a tooltip is closed
-         */
-        "onPdsTooltipHide"?: (event: PdsTooltipCustomEvent<any>) => void;
-        /**
-          * Emitted after a tooltip is shown
+          * Sets the maximum width of the tooltip content
+          * @defaultValue "352px"
          */
-        "onPdsTooltipShow"?: (event: PdsTooltipCustomEvent<any>) => void;
+        "maxWidth"?: string;
         /**
           * Determines whether or not the tooltip is visible
           * @defaultValue false
@@ -2186,9 +2534,11 @@ declare namespace LocalJSX {
         "pds-input": PdsInput;
         "pds-link": PdsLink;
         "pds-loader": PdsLoader;
+        "pds-popover": PdsPopover;
         "pds-progress": PdsProgress;
         "pds-radio": PdsRadio;
         "pds-row": PdsRow;
+        "pds-select": PdsSelect;
         "pds-sortable": PdsSortable;
         "pds-sortable-item": PdsSortableItem;
         "pds-switch": PdsSwitch;
@@ -2201,6 +2551,7 @@ declare namespace LocalJSX {
         "pds-table-row": PdsTableRow;
         "pds-tabpanel": PdsTabpanel;
         "pds-tabs": PdsTabs;
+        "pds-text": PdsText;
         "pds-textarea": PdsTextarea;
         "pds-tooltip": PdsTooltip;
     }
@@ -2221,9 +2572,11 @@ declare module "@stencil/core" {
             "pds-input": LocalJSX.PdsInput & JSXBase.HTMLAttributes<HTMLPdsInputElement>;
             "pds-link": LocalJSX.PdsLink & JSXBase.HTMLAttributes<HTMLPdsLinkElement>;
             "pds-loader": LocalJSX.PdsLoader & JSXBase.HTMLAttributes<HTMLPdsLoaderElement>;
+            "pds-popover": LocalJSX.PdsPopover & JSXBase.HTMLAttributes<HTMLPdsPopoverElement>;
             "pds-progress": LocalJSX.PdsProgress & JSXBase.HTMLAttributes<HTMLPdsProgressElement>;
             "pds-radio": LocalJSX.PdsRadio & JSXBase.HTMLAttributes<HTMLPdsRadioElement>;
             "pds-row": LocalJSX.PdsRow & JSXBase.HTMLAttributes<HTMLPdsRowElement>;
+            "pds-select": LocalJSX.PdsSelect & JSXBase.HTMLAttributes<HTMLPdsSelectElement>;
             "pds-sortable": LocalJSX.PdsSortable & JSXBase.HTMLAttributes<HTMLPdsSortableElement>;
             "pds-sortable-item": LocalJSX.PdsSortableItem & JSXBase.HTMLAttributes<HTMLPdsSortableItemElement>;
             "pds-switch": LocalJSX.PdsSwitch & JSXBase.HTMLAttributes<HTMLPdsSwitchElement>;
@@ -2236,6 +2589,7 @@ declare module "@stencil/core" {
             "pds-table-row": LocalJSX.PdsTableRow & JSXBase.HTMLAttributes<HTMLPdsTableRowElement>;
             "pds-tabpanel": LocalJSX.PdsTabpanel & JSXBase.HTMLAttributes<HTMLPdsTabpanelElement>;
             "pds-tabs": LocalJSX.PdsTabs & JSXBase.HTMLAttributes<HTMLPdsTabsElement>;
+            "pds-text": LocalJSX.PdsText & JSXBase.HTMLAttributes<HTMLPdsTextElement>;
             "pds-textarea": LocalJSX.PdsTextarea & JSXBase.HTMLAttributes<HTMLPdsTextareaElement>;
             "pds-tooltip": LocalJSX.PdsTooltip & JSXBase.HTMLAttributes<HTMLPdsTooltipElement>;
         }