@pine-ds/core 5.0.0-mercury.0 → 5.0.0

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

@@ -0,0 +1,22 @@
+/**
+ * @part container - The inner semantic container element
+ */
+export declare class PdsContainer {
+    /**
+     * Sets the maximum width of the container. Accepts a named size token
+     * (`'sm'` | `'md'` | `'lg'` | `'xl'` | `'full'`) or any valid CSS length value (e.g. `'640px'`, `'50rem'`).
+     * When omitted, no max-width is applied.
+     */
+    size?: string;
+    /**
+     * Sets the semantic HTML tag rendered as the inner container element.
+     * @default 'div'
+     */
+    tag: 'div' | 'main' | 'section' | 'article';
+    /**
+     * If `true`, the container is centered horizontally using `margin-inline: auto`.
+     * @default true
+     */
+    centered: boolean;
+    render(): any;
+}

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

@@ -1,12 +1,18 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 export declare class PdsCopytext {
+    el: HTMLPdsCopytextElement;
+    private hostKeeper;
+    connectedCallback(): void;
+    private truncationCleanup;
+    private valueSpanEl;
     /**
-     * Determines whether `copytext` should have a border.
+     * Determines whether `copytext` should have a visible border.
      * @defaultValue true
      */
     border: boolean;
+    restoreBorderDefault(newValue: typeof this.border): void;
     /**
-     * A unique identifier used for the underlying component `id` attribute.
+     * A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one.
      */
     componentId: string;
     /**
@@ -16,17 +22,26 @@ export declare class PdsCopytext {
     fullWidth: boolean;
     /**
      * Determines whether the `value` should truncate and display with an ellipsis.
+     * When text overflows, a tooltip showing the full value will appear on hover/focus.
      * @defaultValue false
      */
     truncate: boolean;
     /**
-     * String that is displayed and that is also copied to the clipboard upon interaction.
+     * The string displayed that is also copied to the clipboard upon interaction.
      */
     value: string;
+    handleTruncateChange(newValue: boolean): void;
+    handleValueChange(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    private initTruncationTooltip;
+    private destroyTruncationTooltip;
     /**
-     * Event when copyText button is clicked.
+     * Emitted after a click, once the copy to the clipboard succeeds or fails.
+     * `detail` is `Copied to clipboard` on success, or `Error writing text to clipboard: ` followed by the error on failure.
+     * Not emitted when `navigator.clipboard` is undefined, as it is outside a secure context.
      */
-    pdsCopyTextClick: EventEmitter;
+    pdsCopyTextClick: EventEmitter<string>;
     private copyToClipboard;
     private handleClick;
     private classNames;

package/dist/types/components/pds-datepicker/calendar-portal.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Where the open calendar lives: a `div` in `document.body`, or in the nearest `<dialog>` so it
+ * shares a modal's top layer, outside any `overflow: hidden` or transformed ancestor that would
+ * clip or misplace a fixed-position popup. The portal has its own shadow root carrying the
+ * datepicker's styles, so the calendar looks the same there without any global CSS.
+ */
+export declare class CalendarPortal {
+    private readonly datepicker;
+    static readonly className = "pds-datepicker-calendar-portal";
+    readonly host: HTMLElement;
+    private readonly root;
+    private locale?;
+    /** The custom properties copyContext set on the host, cleared before it copies again. */
+    private copiedProperties;
+    constructor(datepicker: HTMLElement);
+    /**
+     * Moves the calendar into the portal, mounting the portal first. Context is copied when the portal
+     * is attached or the locale changes, not on every render while it's open (in range mode, every
+     * hovered day). A theme set on an ancestor while the calendar is open applies when it next opens.
+     */
+    mount(calendar: HTMLElement, locale: string): void;
+    remove(): void;
+    /** Whether a node is the portal or inside it, as a focus or pointer target. */
+    contains(node: Node | null): boolean;
+    /**
+     * Carries over what the calendar would otherwise inherit from the datepicker: its styles, the
+     * reading direction and language, a theme set on an ancestor, and size overrides.
+     */
+    private copyContext;
+    /**
+     * Custom properties set on an ancestor of the datepicker that isn't an ancestor of the portal,
+     * as a token override on a card or panel, or the datepicker's own size properties: each one whose
+     * value at the datepicker differs from where the portal mounts is set on the portal host.
+     */
+    private copyCustomProperties;
+}

package/dist/types/components/pds-datepicker/date-utils.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Date-only helpers for pds-datepicker. Dates are `YYYY-MM-DD` strings and all arithmetic runs in
+ * UTC, so a date never shifts by a day with the viewer's time zone or a daylight-saving change.
+ */
+/** Parses a `YYYY-MM-DD` string to a UTC `Date`, or `null` when it isn't a real calendar date. */
+export declare function parseIsoDate(value: string | null | undefined): Date | null;
+export declare function toIsoDate(date: Date): string;
+/** Today in the viewer's time zone, as a UTC date. */
+export declare function today(): Date;
+export declare function addDays(date: Date, days: number): Date;
+/** Moves by whole months, keeping the day where it exists (Jan 31 + 1 month is Feb 28 or 29). */
+export declare function addMonths(date: Date, months: number): Date;
+export declare function daysInMonth(year: number, month: number): number;
+export declare function isSameDay(a: Date | null, b: Date | null): boolean;
+/** Clamps a date into the `[min, max]` range; either bound may be missing. */
+export declare function clampDate(date: Date, min: Date | null, max: Date | null): Date;
+export declare function isOutOfRange(date: Date, min: Date | null, max: Date | null): boolean;
+/** The column (0–6) a date falls in, for a week starting on `firstDayOfWeek` (0 = Sunday). */
+export declare function weekdayColumn(date: Date, firstDayOfWeek: number): number;
+/**
+ * The month's weeks, each seven cells long. Days from the neighbouring months are `null`, so the
+ * grid only offers dates in the month on view.
+ */
+export declare function monthWeeks(year: number, month: number, firstDayOfWeek: number): (Date | null)[][];
+/**
+ * The locale's first day of the week (0 = Sunday), from `Intl.Locale` week info where the browser
+ * has it. Falls back to Sunday.
+ */
+export declare function localeFirstDayOfWeek(locale: string): number;
+/**
+ * Weekday names, starting from `firstDayOfWeek`: a short form for the column heading and the long
+ * form for assistive tech. Latin-script names shorten to two letters (Su Mo, lu ma, Mo Di), as the
+ * admin date picker does, while the seven stay distinct; other scripts keep the locale's short form,
+ * which is already compact.
+ */
+export declare function weekdayNames(locale: string, firstDayOfWeek: number): {
+    short: string;
+    long: string;
+}[];
+/** The locale if the browser supports it, otherwise `en-US`, so a bad tag never throws while rendering. */
+export declare function supportedLocale(locale: string | null | undefined): string;
+/**
+ * A formatter for the UTC dates these helpers return. Build it once per render, not per day.
+ * Always on the Gregorian calendar the grid is laid out in, while keeping the locale's language and
+ * digits: some locales default to another calendar (Persian for `fa`, Buddhist for `th`).
+ */
+export declare function dateFormatter(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+export declare function formatDate(date: Date, locale: string, options: Intl.DateTimeFormatOptions): string;
+/**
+ * Month-day mode's year. A leap year, so February has its 29th; every date the mode holds is in it,
+ * and the value drops it (`--MM-DD`).
+ */
+export declare const MONTH_DAY_YEAR = 2000;
+/** The same month and day in month-day mode's year. */
+export declare function inMonthDayYear(date: Date): Date;
+/**
+ * Parses a month and day, `--MM-DD` (ISO 8601 without a year), to a date in month-day mode's year.
+ * A full `YYYY-MM-DD` reads as its month and day. `null` when it isn't a real month and day.
+ */
+export declare function parseMonthDay(value: string | null | undefined): Date | null;
+/** A date's month and day as `--MM-DD`. */
+export declare function toMonthDay(date: Date): string;
+/**
+ * A month's days for month-day mode, which has no weekdays: rows of seven from the 1st, with the
+ * last row filled out with `null`.
+ */
+export declare function monthDayRows(month: number): (Date | null)[][];

package/dist/types/components/pds-datepicker/datepicker-interface.d.ts

@@ -0,0 +1,47 @@
+export interface DatepickerChangeEventDetail {
+    /**
+     * The selected date as `YYYY-MM-DD`, or in range mode the range as `YYYY-MM-DD/YYYY-MM-DD`; with
+     * the time picker, each date as `YYYY-MM-DDTHH:mm`; with `month-day`, `--MM-DD`. An empty string
+     * when cleared.
+     */
+    value: string;
+    /** Range mode: the first day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */
+    start?: string;
+    /** Range mode: the last day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */
+    end?: string;
+    /**
+     * Range mode: the key of the preset the range matches, such as `last-30-days`, so a filter can
+     * keep the range relative to today.
+     */
+    preset?: string;
+}
+export interface DatepickerPreset {
+    /**
+     * A built-in key (`today`, `yesterday`, `last-7-days`, `last-30-days`, `last-90-days`,
+     * `this-month`, `last-month`, `this-quarter`, `last-quarter`, `this-year`, `last-year`,
+     * `year-to-date`, `last-12-months`), or your own key when it has `startOffset` or `endOffset`,
+     * or both `start` and `end`.
+     */
+    key: string;
+    /**
+     * The text shown in the list. Built-in keys have English defaults; set it to translate them. A key
+     * of your own needs one, or it is left out of the list.
+     */
+    label?: string;
+    /**
+     * For a preset of your own that follows today: its first day, in whole days from today, so `-6`
+     * is six days ago and `0` is today. Resolved against today every time the list is read, as a
+     * built-in is, so the range stays relative however long the page stays open. Set one offset and
+     * the other is today.
+     */
+    startOffset?: number;
+    /** For a preset of your own that follows today: its last day, in whole days from today. */
+    endOffset?: number;
+    /**
+     * For a preset of your own on fixed days: its first day, `YYYY-MM-DD`. Fixed days do not follow
+     * today, so prefer `startOffset` and `endOffset` for a range meant to stay relative.
+     */
+    start?: string;
+    /** For a preset of your own on fixed days: its last day, `YYYY-MM-DD`. */
+    end?: string;
+}