@pine-ds/core 3.28.0 → 3.30.0

package/dist/types/components.d.ts

@@ -157,6 +157,21 @@ export namespace Components {
   | 'sm' // 32px
   | 'xs' // 24px
   | string;
+        /**
+          * Displays a presence status indicator (a dot) on the avatar: `online` (success), `away` (warning), or `offline` (neutral). For a simple active/inactive presence, map active to `online` and inactive to `offline`. Takes precedence over `badge` — they share the same corner, so the badge is hidden while `status` is set.
+          * @defaultValue null
+         */
+        "status"?: 'online' | 'away' | 'offline' | null;
+        /**
+          * Accessible label for the presence status indicator. Pass a translated string to localize it; defaults to English (`"{status} status"`). Has no effect on dropdown avatars, where the trigger's `triggerLabel` owns the accessible name — fold presence into `triggerLabel` there.
+          * @defaultValue null
+         */
+        "statusLabel"?: string;
+        /**
+          * Determines whether a ring is shown around the avatar in the `status` color. Has no effect unless `status` is set.
+          * @defaultValue false
+         */
+        "statusRing"?: boolean;
         /**
           * Accessible label for the dropdown trigger button. Pass a translated string to localize it; defaults to English.
           * @defaultValue 'Avatar dropdown trigger'
@@ -966,6 +981,10 @@ export namespace Components {
           * @default '236px'
          */
         "dropdownWidth": string;
+        /**
+          * Error message to display.
+         */
+        "errorMessage"?: string;
         /**
           * Timeout in milliseconds for async fetch requests.
           * @default 30000
@@ -979,11 +998,19 @@ export namespace Components {
           * Gets the value of the currently selected option.
          */
         "getSelectedValue": () => Promise<string | null>;
+        /**
+          * Helper message to display below the combobox.
+         */
+        "helperMessage"?: string;
         /**
           * Visually hides the label text for instances where only the combobox should be displayed. The visible `<label>` is omitted (same pattern as `pds-select`) so label spacing does not reserve layout; the trigger uses `aria-label` so the name stays available to assistive technology.
           * @default false
          */
         "hideLabel": boolean;
+        /**
+          * If true, the combobox is in an invalid state.
+         */
+        "invalid"?: boolean;
         /**
           * Text to be displayed as the combobox label.
          */
@@ -1336,6 +1363,11 @@ export namespace Components {
         "value"?: string | number | null;
     }
     interface PdsLink {
+        /**
+          * Marks the link as the current/active navigation item — for tab strips and nav rails built from links. Applies the active treatment (persistent underline + strong text) and sets `aria-current="page"`.
+          * @defaultValue false
+         */
+        "active": boolean;
         /**
           * Sets the link color.
          */
@@ -1444,6 +1476,11 @@ export namespace Components {
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
+        /**
+          * Whether the modal opens outside the browser top layer as a non-modal dialog. When `true` it opens with `dialog.show()` instead of `dialog.showModal()`, so overlays rendered elsewhere in the DOM (file pickers, editor menus) can display above it via `z-index`. The page is not made inert and focus is not trapped in this mode. Read when the modal opens; changing it while the modal is open is not supported.
+          * @default false
+         */
+        "disableTopLayer": boolean;
         /**
           * Closes the modal
          */
@@ -2064,21 +2101,43 @@ export namespace Components {
         "value": string;
     }
     interface PdsTab {
+        /**
+          * Marks this tab as the current one in navigation mode (`href` set). Applies the active treatment and `aria-current="page"`. Ignored in panel mode, where the active tab is derived from the parent's `activeTabName`.
+          * @defaultValue false
+         */
+        "active"?: boolean;
         /**
           * Determines the tab's disabled state.
           * @defaultValue false
          */
         "disabled"?: boolean;
+        /**
+          * Turns the tab into a navigation link to this URL. When set, the tab renders an `<a href>` (marked `aria-current="page"` when `active`) instead of a `role="tab"` button, so each tab is its own page/URL — for tab strips that navigate rather than switch in-page panels. Pairs with `pds-tabs` navigation mode; no `pds-tabpanel`s are needed. Apply `href` to all tabs in a `pds-tabs` or none — mixing navigation and panel tabs is not supported.
+         */
+        "href"?: string;
         "index": number;
         /**
           * Sets the related tab name, this name must match a `pds-tabpanel`'s tab name property
          */
         "name": string;
+        "navMode"?: boolean;
         "parentComponentId": string;
         /**
           * @default false
          */
         "selected": boolean;
+        /**
+          * Where to open the linked URL, in navigation mode. Maps to the anchor's `target` attribute.
+         */
+        "target"?: '_blank' | '_self' | '_parent' | '_top';
+        /**
+          * Navigation mode: the Turbo visit action. Maps to `data-turbo-action` on the anchor (`advance` gives each tab its own history entry).
+         */
+        "turboAction"?: 'advance' | 'replace';
+        /**
+          * Navigation mode: the Turbo Frame to target. Maps to `data-turbo-frame` on the anchor, so a tab can swap a single frame (e.g. a page body) while leaving the rest of the page in place.
+         */
+        "turboFrame"?: string;
         "variant": string;
     }
     interface PdsTable {
@@ -2194,18 +2253,37 @@ export namespace Components {
           * @default false
          */
         "selected": boolean;
+        /**
+          * @default false
+         */
+        "stretch": boolean;
         "variant": string;
     }
     interface PdsTabs {
         "activeTabIndex": number;
         /**
-          * Sets the starting active tab name and maintains the name as the component re-renders
+          * Sets the starting active tab name and maintains the name as the component re-renders. Panel mode only — in navigation mode (`nav`) the active tab is set per-tab via `active`, so this is not required there.
          */
-        "activeTabName": string;
+        "activeTabName"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
+        /**
+          * Adds a divider rule beneath the tab list.
+          * @defaultValue false
+         */
+        "divider"?: boolean;
+        /**
+          * Renders the tab strip as navigation instead of an in-page panel switcher: each `pds-tab` becomes an `<a href>` inside a `<nav>` landmark (with `aria-current` on the `active` tab) rather than a `role="tab"` button over a `pds-tabpanel`. Give every `pds-tab` an `href` and omit `pds-tabpanel`s.
+          * @defaultValue false
+         */
+        "nav"?: boolean;
+        /**
+          * Stretches the component so the active tab panel fills the remaining height. Requires the component to have a constrained height (e.g. a flex parent).
+          * @defaultValue false
+         */
+        "stretch"?: boolean;
         /**
           * Sets the aria-label attached to the tablist element
          */
@@ -3341,6 +3419,21 @@ declare namespace LocalJSX {
   | 'sm' // 32px
   | 'xs' // 24px
   | string;
+        /**
+          * Displays a presence status indicator (a dot) on the avatar: `online` (success), `away` (warning), or `offline` (neutral). For a simple active/inactive presence, map active to `online` and inactive to `offline`. Takes precedence over `badge` — they share the same corner, so the badge is hidden while `status` is set.
+          * @defaultValue null
+         */
+        "status"?: 'online' | 'away' | 'offline' | null;
+        /**
+          * Accessible label for the presence status indicator. Pass a translated string to localize it; defaults to English (`"{status} status"`). Has no effect on dropdown avatars, where the trigger's `triggerLabel` owns the accessible name — fold presence into `triggerLabel` there.
+          * @defaultValue null
+         */
+        "statusLabel"?: string;
+        /**
+          * Determines whether a ring is shown around the avatar in the `status` color. Has no effect unless `status` is set.
+          * @defaultValue false
+         */
+        "statusRing"?: boolean;
         /**
           * Accessible label for the dropdown trigger button. Pass a translated string to localize it; defaults to English.
           * @defaultValue 'Avatar dropdown trigger'
@@ -4164,6 +4257,10 @@ declare namespace LocalJSX {
           * @default '236px'
          */
         "dropdownWidth"?: string;
+        /**
+          * Error message to display.
+         */
+        "errorMessage"?: string;
         /**
           * Timeout in milliseconds for async fetch requests.
           * @default 30000
@@ -4177,11 +4274,19 @@ declare namespace LocalJSX {
           * Function to format async results. Receives raw API response item.
          */
         "formatResult"?: (item: unknown) => ComboboxOption;
+        /**
+          * Helper message to display below the combobox.
+         */
+        "helperMessage"?: string;
         /**
           * Visually hides the label text for instances where only the combobox should be displayed. The visible `<label>` is omitted (same pattern as `pds-select`) so label spacing does not reserve layout; the trigger uses `aria-label` so the name stays available to assistive technology.
           * @default false
          */
         "hideLabel"?: boolean;
+        /**
+          * If true, the combobox is in an invalid state.
+         */
+        "invalid"?: boolean;
         /**
           * Text to be displayed as the combobox label.
          */
@@ -4570,6 +4675,11 @@ declare namespace LocalJSX {
         "value"?: string | number | null;
     }
     interface PdsLink {
+        /**
+          * Marks the link as the current/active navigation item — for tab strips and nav rails built from links. Applies the active treatment (persistent underline + strong text) and sets `aria-current="page"`.
+          * @defaultValue false
+         */
+        "active"?: boolean;
         /**
           * Sets the link color.
          */
@@ -4678,6 +4788,11 @@ declare namespace LocalJSX {
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId"?: string;
+        /**
+          * Whether the modal opens outside the browser top layer as a non-modal dialog. When `true` it opens with `dialog.show()` instead of `dialog.showModal()`, so overlays rendered elsewhere in the DOM (file pickers, editor menus) can display above it via `z-index`. The page is not made inert and focus is not trapped in this mode. Read when the modal opens; changing it while the modal is open is not supported.
+          * @default false
+         */
+        "disableTopLayer"?: boolean;
         /**
           * Emitted when the modal is closed
          */
@@ -5350,15 +5465,36 @@ declare namespace LocalJSX {
         "value"?: string;
     }
     interface PdsTab {
+        /**
+          * Marks this tab as the current one in navigation mode (`href` set). Applies the active treatment and `aria-current="page"`. Ignored in panel mode, where the active tab is derived from the parent's `activeTabName`.
+          * @defaultValue false
+         */
+        "active"?: boolean;
         /**
           * Determines the tab's disabled state.
           * @defaultValue false
          */
         "disabled"?: boolean;
+        /**
+          * Turns the tab into a navigation link to this URL. When set, the tab renders an `<a href>` (marked `aria-current="page"` when `active`) instead of a `role="tab"` button, so each tab is its own page/URL — for tab strips that navigate rather than switch in-page panels. Pairs with `pds-tabs` navigation mode; no `pds-tabpanel`s are needed. Apply `href` to all tabs in a `pds-tabs` or none — mixing navigation and panel tabs is not supported.
+         */
+        "href"?: string;
         /**
           * Sets the related tab name, this name must match a `pds-tabpanel`'s tab name property
          */
         "name": string;
+        /**
+          * Where to open the linked URL, in navigation mode. Maps to the anchor's `target` attribute.
+         */
+        "target"?: '_blank' | '_self' | '_parent' | '_top';
+        /**
+          * Navigation mode: the Turbo visit action. Maps to `data-turbo-action` on the anchor (`advance` gives each tab its own history entry).
+         */
+        "turboAction"?: 'advance' | 'replace';
+        /**
+          * Navigation mode: the Turbo Frame to target. Maps to `data-turbo-frame` on the anchor, so a tab can swap a single frame (e.g. a page body) while leaving the rest of the page in place.
+         */
+        "turboFrame"?: string;
     }
     interface PdsTable {
         /**
@@ -5478,13 +5614,28 @@ declare namespace LocalJSX {
     }
     interface PdsTabs {
         /**
-          * Sets the starting active tab name and maintains the name as the component re-renders
+          * Sets the starting active tab name and maintains the name as the component re-renders. Panel mode only — in navigation mode (`nav`) the active tab is set per-tab via `active`, so this is not required there.
          */
-        "activeTabName": string;
+        "activeTabName"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
         "componentId": string;
+        /**
+          * Adds a divider rule beneath the tab list.
+          * @defaultValue false
+         */
+        "divider"?: boolean;
+        /**
+          * Renders the tab strip as navigation instead of an in-page panel switcher: each `pds-tab` becomes an `<a href>` inside a `<nav>` landmark (with `aria-current` on the `active` tab) rather than a `role="tab"` button over a `pds-tabpanel`. Give every `pds-tab` an `href` and omit `pds-tabpanel`s.
+          * @defaultValue false
+         */
+        "nav"?: boolean;
+        /**
+          * Stretches the component so the active tab panel fills the remaining height. Requires the component to have a constrained height (e.g. a flex parent).
+          * @defaultValue false
+         */
+        "stretch"?: boolean;
         /**
           * Sets the aria-label attached to the tablist element
          */
@@ -5757,6 +5908,9 @@ declare namespace LocalJSX {
   | 'sm' // 32px
   | 'xs' // 24px
   | string;
+        "status": 'online' | 'away' | 'offline' | null;
+        "statusLabel": string;
+        "statusRing": boolean;
         "variant": 'customer' | 'admin';
         "triggerLabel": string;
     }
@@ -5929,10 +6083,13 @@ declare namespace LocalJSX {
         "customOptionLayouts": boolean;
         "customTriggerContent": boolean;
         "disabled": boolean;
+        "errorMessage": string;
         "dropdownPlacement": 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
         "dropdownWidth": string;
         "dropdownMount": 'host' | 'body';
+        "helperMessage": string;
         "hideLabel": boolean;
+        "invalid": boolean;
         "label": string;
         "maxHeight": string;
         "mode": 'filter' | 'select-only';
@@ -6031,6 +6188,7 @@ declare namespace LocalJSX {
         "highlight": boolean;
     }
     interface PdsLinkAttributes {
+        "active": boolean;
         "color": string;
         "download": string;
         "componentId": string;
@@ -6065,6 +6223,7 @@ declare namespace LocalJSX {
         "open": boolean;
         "size": 'sm' | 'md' | 'lg' | 'fullscreen';
         "scrollable": boolean;
+        "disableTopLayer": boolean;
     }
     interface PdsModalContentAttributes {
         "border": 'none' | 'both' | 'top' | 'bottom';
@@ -6209,6 +6368,11 @@ declare namespace LocalJSX {
     }
     interface PdsTabAttributes {
         "disabled": boolean;
+        "href": string;
+        "active": boolean;
+        "target": '_blank' | '_self' | '_parent' | '_top';
+        "turboFrame": string;
+        "turboAction": 'advance' | 'replace';
         "name": string;
     }
     interface PdsTableAttributes {
@@ -6247,6 +6411,9 @@ declare namespace LocalJSX {
         "tablistLabel": string;
         "componentId": string;
         "variant": 'primary' | 'availability' | 'filter' | 'pill';
+        "divider": boolean;
+        "stretch": boolean;
+        "nav": boolean;
         "activeTabName": string;
     }
     interface PdsTextAttributes {
@@ -6359,7 +6526,7 @@ declare namespace LocalJSX {
         "pds-table-head-cell": Omit<PdsTableHeadCell, keyof PdsTableHeadCellAttributes> & { [K in keyof PdsTableHeadCell & keyof PdsTableHeadCellAttributes]?: PdsTableHeadCell[K] } & { [K in keyof PdsTableHeadCell & keyof PdsTableHeadCellAttributes as `attr:${K}`]?: PdsTableHeadCellAttributes[K] } & { [K in keyof PdsTableHeadCell & keyof PdsTableHeadCellAttributes as `prop:${K}`]?: PdsTableHeadCell[K] };
         "pds-table-row": Omit<PdsTableRow, keyof PdsTableRowAttributes> & { [K in keyof PdsTableRow & keyof PdsTableRowAttributes]?: PdsTableRow[K] } & { [K in keyof PdsTableRow & keyof PdsTableRowAttributes as `attr:${K}`]?: PdsTableRowAttributes[K] } & { [K in keyof PdsTableRow & keyof PdsTableRowAttributes as `prop:${K}`]?: PdsTableRow[K] };
         "pds-tabpanel": Omit<PdsTabpanel, keyof PdsTabpanelAttributes> & { [K in keyof PdsTabpanel & keyof PdsTabpanelAttributes]?: PdsTabpanel[K] } & { [K in keyof PdsTabpanel & keyof PdsTabpanelAttributes as `attr:${K}`]?: PdsTabpanelAttributes[K] } & { [K in keyof PdsTabpanel & keyof PdsTabpanelAttributes as `prop:${K}`]?: PdsTabpanel[K] } & OneOf<"name", PdsTabpanel["name"], PdsTabpanelAttributes["name"]>;
-        "pds-tabs": Omit<PdsTabs, keyof PdsTabsAttributes> & { [K in keyof PdsTabs & keyof PdsTabsAttributes]?: PdsTabs[K] } & { [K in keyof PdsTabs & keyof PdsTabsAttributes as `attr:${K}`]?: PdsTabsAttributes[K] } & { [K in keyof PdsTabs & keyof PdsTabsAttributes as `prop:${K}`]?: PdsTabs[K] } & OneOf<"tablistLabel", PdsTabs["tablistLabel"], PdsTabsAttributes["tablistLabel"]> & OneOf<"componentId", PdsTabs["componentId"], PdsTabsAttributes["componentId"]> & OneOf<"variant", PdsTabs["variant"], PdsTabsAttributes["variant"]> & OneOf<"activeTabName", PdsTabs["activeTabName"], PdsTabsAttributes["activeTabName"]>;
+        "pds-tabs": Omit<PdsTabs, keyof PdsTabsAttributes> & { [K in keyof PdsTabs & keyof PdsTabsAttributes]?: PdsTabs[K] } & { [K in keyof PdsTabs & keyof PdsTabsAttributes as `attr:${K}`]?: PdsTabsAttributes[K] } & { [K in keyof PdsTabs & keyof PdsTabsAttributes as `prop:${K}`]?: PdsTabs[K] } & OneOf<"tablistLabel", PdsTabs["tablistLabel"], PdsTabsAttributes["tablistLabel"]> & OneOf<"componentId", PdsTabs["componentId"], PdsTabsAttributes["componentId"]> & OneOf<"variant", PdsTabs["variant"], PdsTabsAttributes["variant"]>;
         "pds-text": Omit<PdsText, keyof PdsTextAttributes> & { [K in keyof PdsText & keyof PdsTextAttributes]?: PdsText[K] } & { [K in keyof PdsText & keyof PdsTextAttributes as `attr:${K}`]?: PdsTextAttributes[K] } & { [K in keyof PdsText & keyof PdsTextAttributes as `prop:${K}`]?: PdsText[K] };
         "pds-textarea": Omit<PdsTextarea, keyof PdsTextareaAttributes> & { [K in keyof PdsTextarea & keyof PdsTextareaAttributes]?: PdsTextarea[K] } & { [K in keyof PdsTextarea & keyof PdsTextareaAttributes as `attr:${K}`]?: PdsTextareaAttributes[K] } & { [K in keyof PdsTextarea & keyof PdsTextareaAttributes as `prop:${K}`]?: PdsTextarea[K] } & OneOf<"componentId", PdsTextarea["componentId"], PdsTextareaAttributes["componentId"]>;
         "pds-toast": Omit<PdsToast, keyof PdsToastAttributes> & { [K in keyof PdsToast & keyof PdsToastAttributes]?: PdsToast[K] } & { [K in keyof PdsToast & keyof PdsToastAttributes as `attr:${K}`]?: PdsToastAttributes[K] } & { [K in keyof PdsToast & keyof PdsToastAttributes as `prop:${K}`]?: PdsToast[K] } & OneOf<"componentId", PdsToast["componentId"], PdsToastAttributes["componentId"]>;

package/dist/types/utils/form.d.ts

@@ -4,8 +4,11 @@
 export declare const messageId: (id: string, messageType: string) => string;
 /**
  * Assign aria-description id to relate messages with form element
+ *
+ * Returns the error message id when invalid, otherwise the helper message id.
+ * Pass only messages the component renders — a described id must exist in the DOM.
  */
-export declare const assignDescription: (id: string, invalid: boolean, helperMessage: string) => string;
+export declare const assignDescription: (id: string, invalid: boolean, helperMessage?: string, errorMessage?: string) => string;
 /**
  * Updates the `invalid` prop of a form element based on it's values validity
  */