@pine-ds/core 4.11.0 → 4.12.0

package/dist/types/utils/aria-references.d.ts

@@ -16,6 +16,10 @@ export declare const ARIA_REFERENCE_ATTRIBUTES: string[];
  * The closest root wins when an ID repeats.
  */
 export declare const findInAncestorRoots: (host: Element, id: string) => HTMLElement | null;
+/**
+ * The elements an ID-reference attribute on the host names, skipping IDs that match nothing.
+ */
+export declare const referencedElements: (host: Element, attribute: string) => HTMLElement[];
 /**
  * Points the target's reflected ARIA properties at the elements the host's ID-reference attributes
  * name, or clears them. Run it again whenever the attributes or the referenced elements may have

package/dist/types/utils/truncation-tooltip.d.ts

@@ -34,6 +34,20 @@ export interface TruncationTooltipOptions {
     focusEl?: HTMLElement;
 }
 export declare const FOCUSABLE_WRAPPER = "a[href], button, summary, pds-button, pds-link, pds-tab, pds-dropdown-menu-item, [role=\"option\"], [role=\"treeitem\"]";
+/**
+ * The text `el` actually shows, with every `<slot>` it holds replaced by the
+ * nodes assigned to it.
+ *
+ * `textContent` counts a slot as empty, so a component that renders a clipped
+ * text around a slot of its own — `pds-alert` renders `<pds-text truncate><slot/></pds-text>` —
+ * would leave the tooltip with nothing to show and so no tooltip at all, even
+ * though the text is clipped and holds a tab stop.
+ *
+ * Text nodes only, as `textContent` counts too: Stencil leaves comment nodes
+ * among slotted content to mark where it was relocated from, and their data is
+ * not text anyone reads.
+ */
+export declare function flattenedText(el: Element): string;
 /**
  * Sets up automatic tooltip behavior for a truncated element.
  *
@@ -47,3 +61,28 @@ export declare const FOCUSABLE_WRAPPER = "a[href], button, summary, pds-button,
  * @returns A cleanup function that removes all listeners, observers, and DOM elements.
  */
 export declare function setupTruncationTooltip(options: TruncationTooltipOptions): () => void;
+export interface TruncationTooltipBinding {
+    /**
+     * Binds a tooltip to each of `els` that has none yet, and removes the rest.
+     * Missing elements are skipped. Call it after every render.
+     */
+    sync(els: ArrayLike<HTMLElement | null | undefined>): void;
+    /** Removes every tooltip it bound. */
+    destroy(): void;
+}
+/**
+ * Keeps tooltips bound to the elements a component's render clips, for a component
+ * that re-renders while those elements stay in place.
+ *
+ * Each tooltip holds listeners and an observer on its element, so it is rebound
+ * only when a different set of elements renders: rebinding on every render would
+ * tear down a tooltip the pointer is still inside, and a component can render
+ * again on every keystroke or when it opens its popover.
+ *
+ * Call `sync` from `componentDidRender`, and from `connectedCallback` too, since
+ * moving an element reconnects it without rendering it again. Call `destroy` from
+ * `disconnectedCallback`.
+ *
+ * @param getOptions - The options for one element, read when it is bound.
+ */
+export declare function bindTruncationTooltips(getOptions: (el: HTMLElement) => TruncationTooltipOptions): TruncationTooltipBinding;

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

@@ -1,9 +1,12 @@
 export type PlacementType = 'top-start' | 'top' | 'top-end' | 'left-start' | 'left' | 'left-end' | 'right-start' | 'right' | 'right-end' | 'bottom-start' | 'bottom' | 'bottom-end';
 export type BoxColumnType = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12';
 export type BoxSpacingType = 'none' | 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | '025' | '050' | '100' | '125' | '150' | '200' | '250' | '300' | '350' | '400' | '450' | '500' | '550' | '600' | '650' | '700' | '750' | '800';
+export type BoxMarginType = BoxSpacingType | 'auto';
+export type BoxContainerType = 'inline-size' | 'size';
 export type BoxShadowSizeType = 'none' | '050' | '100' | '150' | '200' | '300' | '400' | '500';
 export type ChipSentimentType = 'accent' | 'brand' | 'danger' | 'info' | 'neutral' | 'solid' | 'subtle' | 'success' | 'warning';
 export type ModalSizeType = 'sm' | 'md' | 'lg' | 'fullscreen';
+export type ImageRatioType = 'square' | 'landscape' | 'wide' | 'portrait' | 'tall';
 export type ChipSizeType = 'sm' | 'md' | 'lg';
 export type ChipVariantType = 'text' | 'tag' | 'dropdown';
 export type PopoverPaddingType = Extract<BoxSpacingType, 'none' | 'xs' | 'sm' | 'md'>;