@pantheon-systems/pds-toolkit-react 2.0.0-alpha.7 → 2.0.0-alpha.70

package/dist/components/inputs/Combobox/Combobox.d.ts

@@ -1,6 +1,7 @@
-import React, { ChangeEvent, ComponentPropsWithoutRef, FocusEvent, ReactNode } from 'react';
+import React, { ChangeEvent, ComponentPropsWithoutRef, ReactNode } from 'react';
 import { ValidationStatus } from '../../../libs/types/input-types';
 import './combobox.css';
+export type ComboboxSize = 's' | 'm';
 type LabelStrings = {
     clearButton?: string;
     inputInstructions?: string;
@@ -14,10 +15,15 @@ export type ComboboxOption = {
     searchIndex?: string[];
     value: string;
 };
+export type ComboboxOptionGroup = {
+    groupLabel: string;
+    options: ComboboxOption[];
+};
+export type ComboboxOptionsType = (ComboboxOption | ComboboxOptionGroup)[];
 /**
  * Prop types for Combobox
  */
-export interface ComboboxProps extends ComponentPropsWithoutRef<'div'> {
+export interface ComboboxProps extends Omit<ComponentPropsWithoutRef<'div'>, 'onFocus' | 'onBlur'> {
     /**
      * Additional class names
      */
@@ -51,7 +57,7 @@ export interface ComboboxProps extends ComponentPropsWithoutRef<'div'> {
      */
     id: string;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -79,9 +85,9 @@ export interface ComboboxProps extends ComponentPropsWithoutRef<'div'> {
      */
     noResultsText?: string;
     /**
-     * onBlur event handler.
+     * onBlur event handler to provide the current value of the input.
      */
-    onBlur?: (e: FocusEvent<HTMLInputElement>) => void;
+    onBlur?: (currentValue: string) => void;
     /**
      * onChange event handler.
      */
@@ -91,9 +97,9 @@ export interface ComboboxProps extends ComponentPropsWithoutRef<'div'> {
      */
     onClear?: () => void;
     /**
-     * onFocus event handler.
+     * onFocus event handler to provide the current value of the input.
      */
-    onFocus?: (e: FocusEvent<HTMLInputElement>) => void;
+    onFocus?: (currentValue: string) => void;
     /**
      * Callback when an option is selected. Returns the selected option object.
      */
@@ -119,6 +125,10 @@ export interface ComboboxProps extends ComponentPropsWithoutRef<'div'> {
      * When true, clicking or focusing the input will show all available options before typing.
      */
     showUnfilteredOptions?: boolean;
+    /**
+     * Size of the combobox field.
+     */
+    size?: ComboboxSize;
     /**
      * Optional tooltip text to display additional information.
      */

package/dist/components/inputs/ComboboxMultiselect/ComboboxMultiselect.d.ts

@@ -1,5 +1,6 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import './combobox-multiselect.css';
+export type ComboboxMultiselectSize = 's' | 'm';
 type LabelStrings = {
     aiBadgeLabel?: string;
     aiPanelButton?: string;
@@ -16,7 +17,7 @@ export interface OptionProps {
     id: string;
     label: string;
 }
-interface AuxiliaryPanel {
+interface AiSuggestionsPanel {
     content?: ReactNode;
     disableRefresh?: boolean;
     isFetching?: boolean;
@@ -30,9 +31,9 @@ type DivProps = Omit<ComponentPropsWithoutRef<'div'>, 'onChange'>;
  */
 export interface ComboboxMultiselectProps extends DivProps {
     /**
-     * Optional auxiliary panel configuration (e.g., for AI suggestions)
+     * AI suggestions panel configuration. When provided, shows a sparkle button that opens a floating suggestions panel.
      */
-    auxiliaryPanel?: AuxiliaryPanel;
+    aiSuggestions?: AiSuggestionsPanel;
     /**
      * Additional class names
      */
@@ -50,7 +51,7 @@ export interface ComboboxMultiselectProps extends DivProps {
      */
     initialSelectedItems?: OptionProps[];
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -97,9 +98,13 @@ export interface ComboboxMultiselectProps extends DivProps {
      * Should the label be visible? If false, it will render for screen readers only.
      */
     showLabel?: boolean;
+    /**
+     * Size of the combobox multiselect field.
+     */
+    size?: ComboboxMultiselectSize;
 }
 /**
  * ComboboxMultiselect UI component
  */
-export declare const ComboboxMultiselect: ({ auxiliaryPanel, className, disabled, id, initialSelectedItems, inputWidth, isLoading, label, labelStrings, loadingText, noResultsText, onChange, options, placeholder, required, showAllTags, showLabel, ...props }: ComboboxMultiselectProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ComboboxMultiselect: ({ aiSuggestions, className, disabled, id, initialSelectedItems, inputWidth, isLoading, label, labelStrings, loadingText, noResultsText, onChange, options, placeholder, required, showAllTags, showLabel, size, ...props }: ComboboxMultiselectProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/inputs/Datepicker/Datepicker.d.ts

@@ -1,31 +1,111 @@
-import { HTMLAttributes } from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
 import { Locale } from 'date-fns';
-import { DateRange } from 'react-day-picker';
-import 'react-day-picker/dist/style.css';
+import { ValidationStatus } from '../../../libs/types/input-types';
 import './datepicker.css';
-type PresetType = 'today' | 'current-week' | 'current-month' | 'last-week' | 'last-month';
+/**
+ * A date range, as plain native `Date` objects. Replaces `react-day-picker`'s
+ * `DateRange` type (which consumers previously imported directly from
+ * `react-day-picker`) now that Datepicker's calendar core is built on
+ * react-aria instead. See guides/DATEPICKER-CONSUMER-MIGRATION.md.
+ */
+export interface DateRange {
+    from?: Date;
+    to?: Date;
+}
+export type PresetType = 'today' | 'current-week' | 'current-month' | 'last-week' | 'last-month';
 export interface CustomPresetConfig {
     custom?: () => DateRange;
     days?: number;
+    hours?: number;
     label: string;
+    minutes?: number;
+    /**
+     * Whether this preset's own `label` (e.g. "Last 15 min") should replace the
+     * trigger's computed date/time text while this preset is active. Defaults
+     * to `true` for sub-day presets (`hours`/`minutes` set, no `days`/`type`)
+     * and `false` otherwise — rolling sub-day windows read better as their own
+     * label than as a precise, already-stale-by-the-time-you-read-it
+     * timestamp. Set explicitly to override the default either way.
+     */
+    showLabelInTrigger?: boolean;
     type?: PresetType;
 }
+/**
+ * Options for `getPresetDateRange`. Both are optional and additive — omitting
+ * them preserves the function's original behavior (browser-local time zone,
+ * Sunday-first weeks).
+ */
+export interface GetPresetDateRangeOptions {
+    /**
+     * BCP-47 locale, used only for `current-week`/`last-week`'s week-start day
+     * (e.g. Monday-first in most of Europe vs. Sunday-first in the US).
+     * Defaults to `'en-US'` (Sunday-first), matching this function's original,
+     * locale-unaware behavior.
+     */
+    locale?: string;
+    /**
+     * IANA time zone identifier. Determines which calendar day/week/month
+     * "today" resolves to for `days`/`type` presets — irrelevant for
+     * `hours`/`minutes` presets, which are absolute-time offsets from the
+     * current instant, not calendar-day boundaries. Defaults to the browser's
+     * local time zone.
+     */
+    timeZone?: string;
+}
+/**
+ * Converts a preset config to a DateRange. Use this alongside an external
+ * SegmentedButton, Select, or other control to compose preset date pickers.
+ */
+export declare const getPresetDateRange: (preset: CustomPresetConfig, options?: GetPresetDateRangeOptions) => DateRange;
 export interface DatepickerTranslationStrings {
     clearButton?: string;
+    customPresetLabel?: string;
     doneButton?: string;
+    endTimeLabel?: string;
+    localTimeZoneLabel?: string;
+    nextMonthLabel?: string;
     noDateRangeSelected?: string;
     noDateSelected?: string;
     pleaseSelectEndDate?: string;
+    presetsGroupLabel?: string;
+    previousMonthLabel?: string;
     selectedDate?: string;
     selectedDateRange?: string;
     selectedStartDate?: string;
+    startTimeLabel?: string;
+    timeLabel?: string;
+    timeZoneSwitcherLabel?: string;
     to?: string;
+    todayButton?: string;
+    utcTimeZoneLabel?: string;
 }
 /**
  * Prop types for Datepicker.
  */
 type DatepickerHTMLProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'value'>;
-export interface DatepickerProps extends DatepickerHTMLProps {
+interface DatepickerSharedProps extends DatepickerHTMLProps {
+    /**
+     * Whether the `presets` list includes its "Custom" entry (the one that
+     * hands date selection over to the calendar). Has no effect unless
+     * `presets` is also set. Defaults to `true`. Set to `false` to offer the
+     * fixed presets *only* — a consumer that wants a rolling-window picker
+     * with no arbitrary-range escape hatch (e.g. a launch that only supports
+     * 24h/7d/30d windows). Pair with `showPresetCalendar={false}` for a
+     * popover that is nothing but the preset list; on its own it just removes
+     * the entry, leaving the always-visible calendar alongside the list.
+     */
+    allowCustomRange?: boolean;
+    /**
+     * Whether range mode may select a span of days at all. Defaults to
+     * `true` — react-aria's two-click anchor-then-commit gesture. Set to
+     * `false` where a multi-day span would be meaningless or unsupported:
+     * a single click then selects that day as its own start and end, with no
+     * second click needed. The emitted value stays a `DateRange` (with
+     * `showTime`, the whole day: 00:00 through 23:59), so it keeps composing
+     * with `presets`, whose entries still compute multi-day ranges of their
+     * own. Has no effect in single mode, which already selects one date.
+     */
+    allowDateRangeSelection?: boolean;
     /**
      * Additional class names.
      */
@@ -35,15 +115,19 @@ export interface DatepickerProps extends DatepickerHTMLProps {
      */
     disabled?: boolean;
     /**
-     * Has date range selection. If false, single date selection is used.
+     * Optional note rendered at the bottom of the calendar dropdown, below the
+     * `showTime` field(s) when present (otherwise directly below the calendar
+     * grid(s)) and above the footer actions. Accepts any `ReactNode` — e.g. an
+     * "Available window: [start] – [end]" constraint hint — this component
+     * doesn't prescribe what goes there.
      */
-    hasDateRange?: boolean;
+    footerNote?: ReactNode;
     /**
      * Input ID.
      */
     id: string;
     /**
-     * Max-width of the input field. Accepts a number in pixels.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      * Numbers below 160 will display at 160px.
      * Leave blank for width: 100%.
      */
@@ -57,15 +141,33 @@ export interface DatepickerProps extends DatepickerHTMLProps {
      */
     locale?: Locale;
     /**
-     * onChange handler
+     * Maximum selectable date.
+     */
+    maxDate?: Date;
+    /**
+     * Helper text displayed below the input.
+     */
+    message?: string | ReactNode;
+    /**
+     * Minimum selectable date.
      */
-    onChange?: (value: DateRange | Date | undefined) => void;
+    minDate?: Date;
     /**
      * Placeholder text for the trigger button.
      */
     placeholder?: string;
     /**
-     * Optional preset date ranges (only available when hasDateRange is true).
+     * Renders a preset list (each computed via `getPresetDateRange`) in a
+     * dedicated column to the left of the calendar, with a "Custom" entry
+     * below it for picking dates directly from the calendar. The calendar
+     * itself is always shown alongside the list, never hidden/collapsed.
+     * Selecting a preset drives the calendar's own selection; picking a date
+     * directly from the calendar (or editing a `showTime` field) marks
+     * "Custom" as active. Only meaningful in range mode (`mode="range"`) —
+     * every preset computes a `DateRange`. This is purely additive: the
+     * existing external-composition pattern (`getPresetDateRange` +
+     * `CustomPresetConfig` wired to an external `SegmentedButton`/`Select`)
+     * keeps working unchanged whether or not this prop is used.
      */
     presets?: CustomPresetConfig[];
     /**
@@ -76,6 +178,53 @@ export interface DatepickerProps extends DatepickerHTMLProps {
      * Should the label be visible? If false, it will render for screen readers only.
      */
     showLabel?: boolean;
+    /**
+     * Whether the calendar (and, when `showTime` is on, the time fields) is
+     * shown alongside the `presets` list from the start, or only once "Custom"
+     * is clicked. Has no effect unless `presets` is also set. Defaults to
+     * `true` — the calendar is always visible, matching this component's
+     * original `presets` behavior. Set to `false` for a compact, list-only
+     * popover (e.g. a log viewer's rolling-window picker) that expands to
+     * reveal the calendar only when the viewer picks "Custom" — once
+     * expanded, it stays expanded for the rest of that popover session (even
+     * if the viewer clicks back to a different preset afterward); it only
+     * collapses again the next time the popover is freshly opened.
+     */
+    showPresetCalendar?: boolean;
+    /**
+     * Embeds Timepicker field(s) in the calendar dropdown (one in single mode,
+     * start/end in range mode) — the selected time-of-day is baked directly
+     * into the emitted `value`'s own `Date`(s); `value`/`onChange` stay plain
+     * `Date`/`DateRange`, no shape change.
+     */
+    showTime?: boolean;
+    /**
+     * Renders an inline-labeled "UTC" / "Local" `SegmentedButton` below the
+     * embedded time field(s) that lets the viewer swap which zone the
+     * displayed (and subsequently entered) time-of-day is shown in. "Local" is
+     * whatever `timeZone` resolves to (the configured zone, not necessarily
+     * the browser's own). Only the *displayed/emitted time-of-day* changes
+     * when toggled — the selected calendar day never moves, even though, for
+     * a time near midnight, converting to a different zone can technically
+     * land in the neighboring day; this is an accepted, documented
+     * simplification rather than a full zoned re-derivation of the selected
+     * date. Has no effect unless `showTime` is also true.
+     */
+    showTimeZoneSwitcher?: boolean;
+    /**
+     * IANA time zone identifier (e.g. "America/Los_Angeles", "UTC") used to
+     * combine the selected date with `showTime`'s entered time-of-day into a
+     * correct absolute instant. Passed straight through to each embedded
+     * `Timepicker`'s own `timeZone` prop as well. Defaults to the browser's
+     * local time zone. Also acts as the "Local" side of
+     * `showTimeZoneSwitcher`, when enabled. Independently of `showTime`, this
+     * is the zone every selected day is resolved in — the day the calendar
+     * highlights, the date the trigger renders, what "today" means, and the
+     * screen-reader announcements — so a picker pinned to another zone shows
+     * the day the viewer actually picked rather than whichever day that
+     * instant happens to fall on locally.
+     */
+    timeZone?: string;
     /**
      * Optional tooltip text to display additional information.
      */
@@ -85,12 +234,66 @@ export interface DatepickerProps extends DatepickerHTMLProps {
      */
     translationStrings?: DatepickerTranslationStrings;
     /**
-     * Selected date or date range.
+     * Validation message that takes priority over `message` when set.
+     */
+    validationMessage?: string;
+    /**
+     * Validation status. Controls error/success styling and message display.
      */
-    value?: DateRange | Date;
+    validationStatus?: ValidationStatus;
+    /**
+     * Number of months shown side by side in range mode. Defaults to `2`.
+     * Fixed for the lifetime of a given `Datepicker` instance — it does not
+     * auto-adjust based on the selected range or active preset, matching the
+     * static layout shown in Figma's own "Edge logs" recipe (a one-month
+     * range+time+presets picker for short windows, since its calendar grid
+     * never needs to show more than a single month at once). Has no effect
+     * in single mode, which always shows one month.
+     */
+    visibleMonths?: 1 | 2;
 }
+export interface SingleDatepickerProps extends DatepickerSharedProps {
+    /**
+     * Single-date selection (the default) — omit `mode` entirely, or set it
+     * explicitly to `'single'`.
+     */
+    mode?: 'single';
+    /**
+     * onChange handler.
+     */
+    onChange?: (value: Date | undefined) => void;
+    /**
+     * Selected date.
+     */
+    value?: Date;
+}
+export interface RangeDatepickerProps extends DatepickerSharedProps {
+    /**
+     * Date-range selection: the calendar shows two months side-by-side and
+     * the selected span is visually highlighted.
+     */
+    mode: 'range';
+    /**
+     * onChange handler.
+     */
+    onChange?: (value: DateRange | undefined) => void;
+    /**
+     * Selected date range.
+     */
+    value?: DateRange;
+}
+/**
+ * `mode` is a discriminated union rather than a `hasDateRange` boolean —
+ * `value`/`onChange` narrow to the correct shape for the given mode at the
+ * type level, instead of relying on a boolean the compiler can't actually
+ * tie to the value's shape (which required internal `as DateRange`/`as Date`
+ * casts throughout). `mode` is optional and defaults to `'single'`, so
+ * existing single-date consumers (the common case) need no changes — only
+ * `hasDateRange` → `mode="range"` for range consumers.
+ */
+export type DatepickerProps = SingleDatepickerProps | RangeDatepickerProps;
 /**
  * Datepicker UI component.
  */
-export declare const Datepicker: ({ className, disabled, hasDateRange, id, inputWidth, label, locale, onChange, placeholder, presets, required, showLabel, tooltipText, translationStrings, value, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Datepicker: ({ allowCustomRange, allowDateRangeSelection, className, disabled, footerNote, id, inputWidth, label, locale, maxDate, message, minDate, mode, onChange, placeholder, presets, required, showLabel, showPresetCalendar, showTime, showTimeZoneSwitcher, timeZone, tooltipText, translationStrings: translationStringsProp, validationMessage, validationStatus, value, visibleMonths, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/inputs/FileUpload/FileUpload.d.ts

@@ -1,6 +1,7 @@
 import React, { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { ValidationStatus } from '../../../libs/types/input-types';
 import './file-upload.css';
+export type FileUploadSize = 's' | 'm';
 type LabelStrings = {
     chooseFile: string;
     clearButton: string;
@@ -38,7 +39,7 @@ export interface FileUploadProps extends ComponentPropsWithoutRef<'div'> {
      */
     inputProps?: ComponentPropsWithoutRef<'input'>;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -73,6 +74,10 @@ export interface FileUploadProps extends ComponentPropsWithoutRef<'div'> {
      * Should the label be visible? If false, it will render for screen readers only.
      */
     showLabel?: boolean;
+    /**
+     * Size of the input field.
+     */
+    size?: FileUploadSize;
     /**
      * Optional tooltip text to display additional information.
      */

package/dist/components/inputs/RadioGroup/RadioGroup.d.ts

@@ -44,13 +44,21 @@ export interface RadioGroupProps extends ComponentPropsWithoutRef<'div'> {
      */
     id: string;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
      * Label for the radio group
      */
     label: string;
+    /**
+     * Visual treatment of the legend. `'default'` matches other form field
+     * labels — use it when this group is one of several inputs on a form.
+     * `'heading'` is semibold with more room below it, for cases where the
+     * group reads as its own section label (e.g. a filter panel's category
+     * groups) rather than a form field among others.
+     */
+    labelVariant?: 'default' | 'heading';
     /**
      * Input message
      */
@@ -101,4 +109,4 @@ export interface RadioGroupProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * RadioGroup UI component
  */
-export declare const RadioGroup: ({ className, defaultValue, disabled, fieldsetProps, id, inputWidth, label, message, onBlur, onChange, onValueChange, options, required, showLabel, tooltipText, validationMessage, validationStatus, value, ...props }: RadioGroupProps) => import("react/jsx-runtime").JSX.Element;
+export declare const RadioGroup: ({ className, defaultValue, disabled, fieldsetProps, id, inputWidth, label, labelVariant, message, onBlur, onChange, onValueChange, options, required, showLabel, tooltipText, validationMessage, validationStatus, value, ...props }: RadioGroupProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/inputs/Select/Select.d.ts

@@ -3,6 +3,7 @@ import { ValidationStatus } from '../../../libs/types/input-types';
 import { PDSIcon } from '../../icons/Icon/Icon';
 import './select.css';
 export type SelectIconType = PDSIcon | 'google' | 'microsoft';
+export type SelectSize = 's' | 'm';
 type LabelStrings = {
     selectOptionText: string;
     triggerButton: string;
@@ -69,7 +70,7 @@ export interface SelectProps {
      */
     id: string;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -108,6 +109,14 @@ export interface SelectProps {
      * Should the label be visible? If false, it will render for screen readers only.
      */
     showLabel?: boolean;
+    /**
+     * Should the selected option show a checkmark icon in the dropdown list? Defaults to true.
+     */
+    showSelectedIcon?: boolean;
+    /**
+     * Size of the select field.
+     */
+    size?: SelectSize;
     /**
      * Optional tooltip text to display additional information.
      */
@@ -132,5 +141,5 @@ export declare const SelectOptionGroup: ({ children, label, }: SelectOptionGroup
 /**
  * Select UI component
  */
-export declare const Select: ({ autoWidth, className, defaultValue, disabled, icon, id, inputWidth, label, labelStrings, message, onBlur, onFocus, onOptionSelect, options, required, showLabel, tooltipText, validationMessage, validationStatus, value, ...props }: SelectProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Select: ({ autoWidth, className, defaultValue, disabled, icon, id, inputWidth, label, labelStrings, message, onBlur, onFocus, onOptionSelect, options, required, showLabel, showSelectedIcon, size, tooltipText, validationMessage, validationStatus, value, ...props }: SelectProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/inputs/Switch/Switch.d.ts

@@ -29,7 +29,7 @@ export interface SwitchProps extends ComponentPropsWithoutRef<'div'> {
      */
     inputProps?: ComponentPropsWithoutRef<'input'>;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -41,7 +41,7 @@ export interface SwitchProps extends ComponentPropsWithoutRef<'div'> {
      */
     message?: string | ReactNode;
     /**
-     * Status text for when switch is off.
+     * Status text for when the switch is off. Visual only (not announced to screen readers, which rely on `role="switch"`).
      */
     offLabel?: string;
     /**
@@ -49,7 +49,7 @@ export interface SwitchProps extends ComponentPropsWithoutRef<'div'> {
      */
     onChange?: (e: ChangeEvent<HTMLInputElement>) => void;
     /**
-     * Status text for when switch is on.
+     * Status text for when the switch is on. Visual only (not announced to screen readers, which rely on `role="switch"`).
      */
     onLabel?: string;
     /**
@@ -61,11 +61,11 @@ export interface SwitchProps extends ComponentPropsWithoutRef<'div'> {
      */
     showLabel?: boolean;
     /**
-     * Show toggle status label next to switch. If false, icons will render and the text will still be available to screen readers.
+     * Show the on/off status label next to the switch. Visual only; state is always available to screen readers via `role="switch"`.
      */
     showStatusLabel?: boolean;
     /**
-     * Determines the placement of the toggle status label. Default set to `right`.
+     * Determines the placement of the status label relative to the switch. Default set to `right`.
      */
     statusLabelPlacement?: 'right' | 'left';
     /**

package/dist/components/inputs/TagsInput/TagsInput.d.ts

@@ -15,6 +15,7 @@ export type TagType = {
     id: string;
     value: string;
 };
+export type TagsInputSize = 's' | 'm';
 type DivProps = Omit<ComponentPropsWithoutRef<'div'>, 'onChange'>;
 /**
  * Prop types for TagsInput
@@ -41,7 +42,7 @@ export interface TagsInputProps extends DivProps {
      */
     inputMinHeight?: number;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -72,6 +73,10 @@ export interface TagsInputProps extends DivProps {
      * Should the label be visible? If false, it will render for screen readers only.
      */
     showLabel?: boolean;
+    /**
+     * Size of the input.
+     */
+    size?: TagsInputSize;
     /**
      * Tags array. The component is controlled and requires managing state externally.
      */

package/dist/components/inputs/TextInput/TextInput.d.ts

@@ -9,7 +9,7 @@ type LabelStrings = {
     visibilityToggleHide: string;
     visibilityToggleShow: string;
 };
-type HtmlInputTypes = 'text' | 'number' | 'email' | 'password' | 'tel' | 'url' | 'search';
+type HtmlInputTypes = 'text' | 'number' | 'email' | 'password' | 'tel' | 'time' | 'url' | 'search';
 /**
  * Prop types for TextInput
  */
@@ -56,7 +56,7 @@ export interface TextInputProps extends ComponentPropsWithoutRef<'div'> {
      */
     inputProps?: ComponentPropsWithoutRef<'input'>;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -110,7 +110,7 @@ export interface TextInputProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Input size.
      */
-    size?: 's' | 'm' | 'l';
+    size?: 's' | 'm';
     /**
      * Optional tooltip text to display additional information.
      */
@@ -120,7 +120,7 @@ export interface TextInputProps extends ComponentPropsWithoutRef<'div'> {
      */
     translationStrings?: LabelStrings;
     /**
-     * Type of input field to use.
+     * Type of input field to use. For `time`, prefer the Timepicker component when possible — it offers segmented entry, 12/24-hour display, and timezone support. Use TextInput's native `time` type only as a lightweight fallback where that complexity isn't warranted; note it renders with browser-native time picker UI that isn't fully styleable to match PDS.
      */
     type?: HtmlInputTypes;
     /**

package/dist/components/inputs/Textarea/Textarea.d.ts

@@ -31,7 +31,7 @@ export interface TextareaProps {
      */
     id: string;
     /**
-     * Max-width of the input field. Accepts a number in pixels. Leave blank for width: 100%.
+     * Width of the input field in pixels. When omitted, the input fills its container.
      */
     inputWidth?: number;
     /**
@@ -82,7 +82,7 @@ export interface TextareaProps {
     /**
      * Input size.
      */
-    size?: 's' | 'm' | 'l';
+    size?: 's' | 'm';
     /**
      * Additional props for the `<textarea>` element.
      */