@pine-ds/core 3.22.1 → 3.23.0

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

@@ -1,4 +1,7 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * @part dismiss
+ */
 export declare class PdsToast {
     /**
      * A unique identifier used for the underlying component `id` attribute.

package/dist/types/components.d.ts

@@ -953,7 +953,7 @@ export namespace Components {
          */
         "getSelectedValue": () => Promise<string | null>;
         /**
-          * Visually hides the label text for instances where only the combobox should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * 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;
@@ -996,6 +996,11 @@ export namespace Components {
           * @default 'input'
          */
         "trigger": 'input' | 'button' | 'chip';
+        /**
+          * The shape of the button trigger. Use 'input' to render the trigger with input-like styling (subtle border radius, input height) for use in form or filter rows alongside PdsSelect and PdsMultiselect.
+          * @default 'pill'
+         */
+        "triggerShape": 'pill' | 'input';
         /**
           * The visual variant for the button trigger. Matches Pine button variants.
           * @default 'secondary'
@@ -1490,6 +1495,11 @@ export namespace Components {
           * @default '300px'
          */
         "maxHeight": string;
+        /**
+          * Maximum chips shown inline before collapsing to a "+N more" badge. Only applies when `selectedDisplay='pill'` and `pillPosition='inline'`.
+          * @default 3
+         */
+        "maxInlinePills": number;
         /**
           * Maximum number of selections allowed.
          */
@@ -1504,13 +1514,18 @@ export namespace Components {
          */
         "name"?: string;
         /**
-          * Options provided externally (for consumer-managed async).
+          * Options provided externally (for consumer-managed async). When using `group` on options, keep each group block contiguous in the array. The same `group` label appearing again after other items produces a separate header (same as native `<optgroup>`).
          */
         "options"?: MultiselectOption[];
         /**
           * Width of the dropdown panel. Defaults to the trigger width.
          */
         "panelWidth"?: string;
+        /**
+          * Position of pill chips when `selectedDisplay` is `'pill'`. `'inline'` places chips inside the trigger; `'below'` places chips in a flex-wrap row directly below the trigger.
+          * @default 'inline'
+         */
+        "pillPosition": 'inline' | 'below';
         /**
           * Placeholder text for the input field.
           * @default 'Select...'
@@ -1526,6 +1541,11 @@ export namespace Components {
           * @default 'Find...'
          */
         "searchPlaceholder": string;
+        /**
+          * Display mode for selected items outside the dropdown panel. `'count'` shows "N item(s)" text in the trigger (default). `'pill'` renders selected items as dismissible pds-chip tags.
+          * @default 'count'
+         */
+        "selectedDisplay": 'count' | 'pill';
         /**
           * Sets focus on the trigger button.
          */
@@ -1832,7 +1852,12 @@ export namespace Components {
          */
         "componentId": string;
         /**
-          * Deternines whether `sortable` items should be divided with border.
+          * Determines whether or not the sortable is disabled.
+          * @defaultValue false
+         */
+        "disabled": boolean;
+        /**
+          * Determines whether `sortable` items should be divided with border.
           * @default false
          */
         "dividers": boolean;
@@ -3983,7 +4008,7 @@ declare namespace LocalJSX {
          */
         "formatResult"?: (item: unknown) => ComboboxOption;
         /**
-          * Visually hides the label text for instances where only the combobox should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * 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;
@@ -4034,6 +4059,11 @@ declare namespace LocalJSX {
           * @default 'input'
          */
         "trigger"?: 'input' | 'button' | 'chip';
+        /**
+          * The shape of the button trigger. Use 'input' to render the trigger with input-like styling (subtle border radius, input height) for use in form or filter rows alongside PdsSelect and PdsMultiselect.
+          * @default 'pill'
+         */
+        "triggerShape"?: 'pill' | 'input';
         /**
           * The visual variant for the button trigger. Matches Pine button variants.
           * @default 'secondary'
@@ -4548,6 +4578,11 @@ declare namespace LocalJSX {
           * @default '300px'
          */
         "maxHeight"?: string;
+        /**
+          * Maximum chips shown inline before collapsing to a "+N more" badge. Only applies when `selectedDisplay='pill'` and `pillPosition='inline'`.
+          * @default 3
+         */
+        "maxInlinePills"?: number;
         /**
           * Maximum number of selections allowed.
          */
@@ -4582,13 +4617,18 @@ declare namespace LocalJSX {
          */
         "onPdsMultiselectSearch"?: (event: PdsMultiselectCustomEvent<MultiselectSearchEventDetail>) => void;
         /**
-          * Options provided externally (for consumer-managed async).
+          * Options provided externally (for consumer-managed async). When using `group` on options, keep each group block contiguous in the array. The same `group` label appearing again after other items produces a separate header (same as native `<optgroup>`).
          */
         "options"?: MultiselectOption[];
         /**
           * Width of the dropdown panel. Defaults to the trigger width.
          */
         "panelWidth"?: string;
+        /**
+          * Position of pill chips when `selectedDisplay` is `'pill'`. `'inline'` places chips inside the trigger; `'below'` places chips in a flex-wrap row directly below the trigger.
+          * @default 'inline'
+         */
+        "pillPosition"?: 'inline' | 'below';
         /**
           * Placeholder text for the input field.
           * @default 'Select...'
@@ -4604,6 +4644,11 @@ declare namespace LocalJSX {
           * @default 'Find...'
          */
         "searchPlaceholder"?: string;
+        /**
+          * Display mode for selected items outside the dropdown panel. `'count'` shows "N item(s)" text in the trigger (default). `'pill'` renders selected items as dismissible pds-chip tags.
+          * @default 'count'
+         */
+        "selectedDisplay"?: 'count' | 'pill';
         /**
           * Width of the trigger button (and reference for dropdown positioning).
           * @default '100%'
@@ -4926,7 +4971,12 @@ declare namespace LocalJSX {
          */
         "componentId": string;
         /**
-          * Deternines whether `sortable` items should be divided with border.
+          * Determines whether or not the sortable is disabled.
+          * @defaultValue false
+         */
+        "disabled"?: boolean;
+        /**
+          * Determines whether `sortable` items should be divided with border.
           * @default false
          */
         "dividers"?: boolean;

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

@@ -19,3 +19,13 @@ export declare const isRequired: (target: any, component: any) => void;
  * @param type - The type value (string literal) or a getter function that returns the type
  */
 export declare function exposeTypeProperty(element: Element, type: string | (() => string)): void;
+/**
+ * Determines if code is running in Stencil's spec test environment.
+ * Stencil's mock-doc logs console.error on any ElementInternals
+ * property access during spec tests. Use this guard to skip
+ * ElementInternals calls in the mock environment.
+ *
+ * Uses __STENCIL_SPEC_TESTS__ (the same env var Stencil's mock-doc checks)
+ * to avoid false positives in downstream consumer test suites.
+ */
+export declare const isSpecTest: () => boolean;