@pine-ds/core 3.29.0 → 3.31.1

package/dist/types/components/pds-modal/pds-modal-header/pds-modal-header.d.ts

@@ -1,3 +1,5 @@
 export declare class PdsModalHeader {
+    el: HTMLPdsModalHeaderElement;
+    componentDidRender(): void;
     render(): any;
 }

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

@@ -28,6 +28,16 @@ export declare class PdsModal {
      * @default true
      */
     scrollable: boolean;
+    /**
+     * 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 opened
      */
@@ -41,6 +51,7 @@ export declare class PdsModal {
      */
     focusableElementsArray: HTMLElement[];
     componentDidLoad(): void;
+    componentDidRender(): void;
     disconnectedCallback(): void;
     handleOpenChange(newValue: boolean): void;
     /**

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

@@ -70,5 +70,6 @@ export declare class PdsRadio {
     private classNames;
     componentWillLoad(): void;
     connectedCallback(): void;
+    componentDidRender(): void;
     render(): any;
 }

package/dist/types/components/pds-radio-group/pds-radio-group.d.ts

@@ -65,6 +65,7 @@ export declare class PdsRadioGroup {
     private updateChildRadios;
     componentWillLoad(): void;
     componentDidLoad(): void;
+    componentDidRender(): void;
     private classNames;
     private getGapValue;
     private getAriaDescribedBy;

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

@@ -123,6 +123,7 @@ export declare class PdsSelect {
     private getHelperMessage;
     private getErrorMessage;
     private renderMessages;
+    private isInvalid;
     private classNames;
     private renderAction;
     /**

package/dist/types/components/pds-sortable/pds-sortable-item/pds-sortable-item.d.ts

@@ -18,6 +18,7 @@ export declare class PdsSortableItem {
      * @defaultValue false
      */
     showHandle: boolean;
+    componentDidRender(): void;
     componentWillRender(): void;
     render(): any;
 }

package/dist/types/components/pds-tabs/pds-tab/pds-tab.d.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
 export declare class PdsTab {
     el: HTMLPdsTabElement;
+    componentDidRender(): void;
     /**
      * Determines the tab's disabled state.
      * @defaultValue false

package/dist/types/components/pds-tabs/pds-tabpanel/pds-tabpanel.d.ts

@@ -1,5 +1,6 @@
 export declare class PdsTabpanel {
     el: HTMLPdsTabpanelElement;
+    componentDidRender(): void;
     /**
      * Sets the related tab name, this name must match a `pds-tab`'s tab name property
      */

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

@@ -58,7 +58,10 @@ export declare class PdsTooltip {
     handleOpenToggle(newValue: boolean, oldValue: boolean): void;
     componentWillLoad(): void;
     componentDidLoad(): void;
+    private hasCheckedReconnect;
+    connectedCallback(): void;
     disconnectedCallback(): void;
+    private unwrapReconnectedSlots;
     componentDidRender(): void;
     /**
      * Shows the tooltip by enabling the opened property

package/dist/types/components.d.ts

@@ -942,6 +942,10 @@ export namespace Components {
           * @default 'neutral'
          */
         "chipSentiment": ChipSentimentType;
+        /**
+          * Clears the selected value and resets the component.
+         */
+        "clear": () => Promise<void>;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
@@ -981,6 +985,10 @@ export namespace Components {
           * @default '236px'
          */
         "dropdownWidth": string;
+        /**
+          * Error message to display.
+         */
+        "errorMessage"?: string;
         /**
           * Timeout in milliseconds for async fetch requests.
           * @default 30000
@@ -994,11 +1002,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.
          */
@@ -1464,6 +1480,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
          */
@@ -4240,6 +4261,10 @@ declare namespace LocalJSX {
           * @default '236px'
          */
         "dropdownWidth"?: string;
+        /**
+          * Error message to display.
+         */
+        "errorMessage"?: string;
         /**
           * Timeout in milliseconds for async fetch requests.
           * @default 30000
@@ -4253,11 +4278,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.
          */
@@ -4759,6 +4792,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
          */
@@ -6049,10 +6087,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';
@@ -6186,6 +6227,7 @@ declare namespace LocalJSX {
         "open": boolean;
         "size": 'sm' | 'md' | 'lg' | 'fullscreen';
         "scrollable": boolean;
+        "disableTopLayer": boolean;
     }
     interface PdsModalContentAttributes {
         "border": 'none' | 'both' | 'top' | 'bottom';

package/dist/types/{home/runner/work/pine/pine → private/tmp/claude-501/-Users-qjason-Documents-GitHub/dc3bfd4f-fc9e-49b8-b152-4257ab4ca83c/scratchpad/pine-publish-backfill}/libs/core/.stencil/scripts/vscode-custom-data-generator.d.ts

@@ -1,4 +1,4 @@
-import { JsonDocs } from '../../../../../../../../../stencil-public-runtime';
+import { JsonDocs } from '../../../../../../../../../../../stencil-public-runtime';
 export declare function generateVSCodeCustomData(docs: JsonDocs, outputPath: string): void;
 export default function vscodeCustomDataOutputTarget(outputPath?: string): {
     type: "docs-custom";

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
  */

package/dist/types/utils/reconnected-content.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unwraps a stale copy of a light-DOM (`shadow: false`) component's own wrapper,
+ * left behind when a page-cache (Turbo, browser bfcache) reconnect nests a
+ * component's previous render inside its freshly rendered one. Call from
+ * `componentDidRender` with the element that directly contains the rendered
+ * `<slot>` and the selector that identifies "another one of me." Unwraps in
+ * place (move-then-remove) so nested content is never lost.
+ *
+ * `contentSelector` is only needed when the wrapper itself further nests a
+ * separate content element (e.g. pds-tab's `<a class="pds-tab">` wrapping a
+ * `.pds-tab__content` div) — omit it when the wrapper's own children are the
+ * slotted content (e.g. pds-tabpanel's `.pds-tabpanel` div).
+ */
+export declare function unwrapReconnectedContent(container: Element | null, selector: string, contentSelector?: string): void;

package/dist/types/utils/test/reconnect-safety.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generic guard against the page-cache (Turbo, browser bfcache) reconnect bug class:
+ * a light-DOM (`shadow: false` or `scoped: true`) component that wraps its slotted
+ * content in a rendered element is reconnected over its own prior render, nesting
+ * (or duplicating, or losing) content.
+ *
+ * Hydrates `html`, re-parses the resulting markup the way a cache restore reconnects
+ * a component over its own output, and asserts no duplicate `id`s and no content
+ * loss or duplication survive the second pass.
+ */
+export declare function expectReconnectSafe(components: unknown[], html: string): Promise<void>;