@pine-ds/core 4.9.1 → 4.11.0

package/dist/types/components.d.ts

@@ -1206,7 +1206,8 @@ export namespace Components {
     /**
      * A field for one date, or in range mode a start and end date, with a calendar to pick from.
      * The value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each
-     * date carries a time, as `YYYY-MM-DDTHH:mm`.
+     * date carries a time, as `YYYY-MM-DDTHH:mm`. In month-day mode, for a date that comes round every
+     * year such as a birthday, it's a month and day with no year, as `--MM-DD`.
      */
     interface PdsDatepicker {
         /**
@@ -1265,7 +1266,7 @@ export namespace Components {
          */
         "firstDayOfWeek"?: number;
         /**
-          * How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name, in the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H` (24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`, `MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value and the change event stay ISO (`YYYY-MM-DD`), whatever the format. Typed ISO dates are always accepted too.
+          * How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name, in the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H` (24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`, `MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value and the change event stay ISO (`YYYY-MM-DD`; `--MM-DD` with `month-day`), whatever the format. Typed ISO dates are always accepted too. With `month-day`, a format without `YYYY` is taken as a month-and-day format and used as given, rather than reordered for the locale; leave it unset to follow the locale instead.
           * @default 'YYYY-MM-DD'
          */
         "format": string;
@@ -1331,6 +1332,11 @@ export namespace Components {
           * @default 'Minute'
          */
         "minuteLabel": string;
+        /**
+          * Picks a month and day with no year, for a date that comes round every year, such as a birthday. The value is `--MM-DD` (ISO 8601 without a year), the field shows the date as the locale writes a month and day, and the calendar shows each month without a year or weekdays, with February always having its 29th. Turns off `range`, `time-picker`, `show-dropdowns`, `min` and `max`, and has no effect with `auto-apply`, `presets`, `first-day-of-week`, `min-date-message` or `max-date-message`, which all depend on them.
+          * @default false
+         */
+        "monthDay": boolean;
         /**
           * Accessible label for the month dropdown, when `show-dropdowns` is set.
           * @default 'Month'
@@ -1355,7 +1361,7 @@ export namespace Components {
          */
         "periodLabel": string;
         /**
-          * Specifies a short hint that describes the expected value of the field. Defaults to the format the field takes, such as `YYYY-MM-DD`.
+          * Specifies a short hint that describes the expected value of the field. Defaults to the format the field takes, such as `YYYY-MM-DD`; with `month-day`, to an example date instead, such as `December 31`.
          */
         "placeholder"?: string;
         /**
@@ -1420,7 +1426,7 @@ export namespace Components {
          */
         "triggerLabel": string;
         /**
-          * 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`. An empty string when nothing is selected.
+          * 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`, the month and day with no year, as `--MM-DD` (a full date is read too, as that month and day, and rewritten to it). An empty string when nothing is selected.
           * @default ''
          */
         "value"?: string;
@@ -3288,7 +3294,8 @@ declare global {
     /**
      * A field for one date, or in range mode a start and end date, with a calendar to pick from.
      * The value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each
-     * date carries a time, as `YYYY-MM-DDTHH:mm`.
+     * date carries a time, as `YYYY-MM-DDTHH:mm`. In month-day mode, for a date that comes round every
+     * year such as a birthday, it's a month and day with no year, as `--MM-DD`.
      */
     interface HTMLPdsDatepickerElement extends Components.PdsDatepicker, HTMLStencilElement {
         addEventListener<K extends keyof HTMLPdsDatepickerElementEventMap>(type: K, listener: (this: HTMLPdsDatepickerElement, ev: PdsDatepickerCustomEvent<HTMLPdsDatepickerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -5118,7 +5125,8 @@ declare namespace LocalJSX {
     /**
      * A field for one date, or in range mode a start and end date, with a calendar to pick from.
      * The value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each
-     * date carries a time, as `YYYY-MM-DDTHH:mm`.
+     * date carries a time, as `YYYY-MM-DDTHH:mm`. In month-day mode, for a date that comes round every
+     * year such as a birthday, it's a month and day with no year, as `--MM-DD`.
      */
     interface PdsDatepicker {
         /**
@@ -5177,7 +5185,7 @@ declare namespace LocalJSX {
          */
         "form"?: string;
         /**
-          * How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name, in the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H` (24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`, `MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value and the change event stay ISO (`YYYY-MM-DD`), whatever the format. Typed ISO dates are always accepted too.
+          * How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name, in the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H` (24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`, `MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value and the change event stay ISO (`YYYY-MM-DD`; `--MM-DD` with `month-day`), whatever the format. Typed ISO dates are always accepted too. With `month-day`, a format without `YYYY` is taken as a month-and-day format and used as given, rather than reordered for the locale; leave it unset to follow the locale instead.
           * @default 'YYYY-MM-DD'
          */
         "format"?: string;
@@ -5243,6 +5251,11 @@ declare namespace LocalJSX {
           * @default 'Minute'
          */
         "minuteLabel"?: string;
+        /**
+          * Picks a month and day with no year, for a date that comes round every year, such as a birthday. The value is `--MM-DD` (ISO 8601 without a year), the field shows the date as the locale writes a month and day, and the calendar shows each month without a year or weekdays, with February always having its 29th. Turns off `range`, `time-picker`, `show-dropdowns`, `min` and `max`, and has no effect with `auto-apply`, `presets`, `first-day-of-week`, `min-date-message` or `max-date-message`, which all depend on them.
+          * @default false
+         */
+        "monthDay"?: boolean;
         /**
           * Accessible label for the month dropdown, when `show-dropdowns` is set.
           * @default 'Month'
@@ -5275,7 +5288,7 @@ declare namespace LocalJSX {
          */
         "periodLabel"?: string;
         /**
-          * Specifies a short hint that describes the expected value of the field. Defaults to the format the field takes, such as `YYYY-MM-DD`.
+          * Specifies a short hint that describes the expected value of the field. Defaults to the format the field takes, such as `YYYY-MM-DD`; with `month-day`, to an example date instead, such as `December 31`.
          */
         "placeholder"?: string;
         /**
@@ -5336,7 +5349,7 @@ declare namespace LocalJSX {
          */
         "triggerLabel"?: string;
         /**
-          * 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`. An empty string when nothing is selected.
+          * 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`, the month and day with no year, as `--MM-DD` (a full date is read too, as that month and day, and rewritten to it). An empty string when nothing is selected.
           * @default ''
          */
         "value"?: string;
@@ -7296,6 +7309,7 @@ declare namespace LocalJSX {
         "minuteIncrement": number;
         "minuteLabel": string;
         "monthLabel": string;
+        "monthDay": boolean;
         "name": string;
         "nextMonthLabel": string;
         "periodLabel": string;
@@ -7780,7 +7794,8 @@ declare module "@stencil/core" {
             /**
              * A field for one date, or in range mode a start and end date, with a calendar to pick from.
              * The value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each
-             * date carries a time, as `YYYY-MM-DDTHH:mm`.
+             * date carries a time, as `YYYY-MM-DDTHH:mm`. In month-day mode, for a date that comes round every
+             * year such as a birthday, it's a month and day with no year, as `--MM-DD`.
              */
             "pds-datepicker": LocalJSX.IntrinsicElements["pds-datepicker"] & JSXBase.HTMLAttributes<HTMLPdsDatepickerElement>;
             "pds-divider": LocalJSX.IntrinsicElements["pds-divider"] & JSXBase.HTMLAttributes<HTMLPdsDividerElement>;

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

@@ -33,7 +33,7 @@ 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\"]";
+export declare const FOCUSABLE_WRAPPER = "a[href], button, summary, pds-button, pds-link, pds-tab, pds-dropdown-menu-item, [role=\"option\"], [role=\"treeitem\"]";
 /**
  * Sets up automatic tooltip behavior for a truncated element.
  *

package/dist/vscode.html-data.json

@@ -7776,7 +7776,7 @@
       "name": "pds-datepicker",
       "description": {
         "kind": "markdown",
-        "value": "Datepicker captures a single date, or in range mode a start and an end date. For a single date, people can type it as `YYYY-MM-DD` or pick it from a calendar that opens from the button in the field. The value is always a `YYYY-MM-DD` string (`YYYY-MM-DD/YYYY-MM-DD` for a range), so it never shifts by a day with the viewer's time zone.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#default), [Min and max](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#min-and-max), [Locale and first day of the week](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#locale-and-first-day-of-the-week), [Format](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#format), [Range](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range), [Range with presets](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-presets), [Range that applies on pick](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-that-applies-on-pick), [Range with times](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-times), [Month and year dropdowns](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-year-dropdowns), [Initially empty, with Clear](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#initially-empty,-with-clear), [Placement](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#placement), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#invalid), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#disabled)\n\n**CSS Parts:**\n- `calendar` - The open calendar. It's portaled out of the datepicker, so style it with `.pds-datepicker-calendar-portal::part(calendar)`.\n- `presets` - The list of preset ranges in the calendar, styled with `.pds-datepicker-calendar-portal::part(presets)`.\n\n**Events:**\n- `pdsBlur` - Emitted when the datepicker loses focus: when focus leaves the field and the calendar.\n- `pdsDatepickerChange` - Emitted when the value changes.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the datepicker gains focus: when focus moves into the field or the calendar from outside."
+        "value": "Datepicker captures a single date, or in range mode a start and an end date. For a single date, people can type it as `YYYY-MM-DD` or pick it from a calendar that opens from the button in the field. The value is always a `YYYY-MM-DD` string (`YYYY-MM-DD/YYYY-MM-DD` for a range), so it never shifts by a day with the viewer's time zone. With `month-day`, for a date that comes round every year such as a birthday, it's a month and day with no year, `--MM-DD`.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#default), [Min and max](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#min-and-max), [Locale and first day of the week](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#locale-and-first-day-of-the-week), [Format](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#format), [Range](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range), [Range with presets](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-presets), [Range that applies on pick](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-that-applies-on-pick), [Range with times](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-times), [Month and year dropdowns](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-year-dropdowns), [Month and day, without a year](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-day,-without-a-year), [Initially empty, with Clear](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#initially-empty,-with-clear), [Placement](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#placement), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#invalid), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#disabled)\n\n**CSS Parts:**\n- `calendar` - The open calendar. It's portaled out of the datepicker, so style it with `.pds-datepicker-calendar-portal::part(calendar)`.\n- `presets` - The list of preset ranges in the calendar, styled with `.pds-datepicker-calendar-portal::part(presets)`.\n\n**Events:**\n- `pdsBlur` - Emitted when the datepicker loses focus: when focus leaves the field and the calendar.\n- `pdsDatepickerChange` - Emitted when the value changes.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the datepicker gains focus: when focus moves into the field or the calendar from outside."
       },
       "attributes": [
         {
@@ -7860,7 +7860,7 @@
           "name": "format",
           "description": {
             "kind": "markdown",
-            "value": "How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name,\nin the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H`\n(24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`,\n`MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value\nand the change event stay ISO (`YYYY-MM-DD`), whatever the format. Typed ISO dates are always\naccepted too.\n\n**Default:** `'YYYY-MM-DD'`"
+            "value": "How the field shows dates and reads typed ones, as tokens: `YYYY`, `MMMM` or `MMM` (month name,\nin the locale), `MM` or `M` (month), `DD` or `D` (day), and with the time picker `HH` or `H`\n(24-hour), `hh` or `h` (12-hour), `mm` and `A` (AM/PM, in the locale), as `MM/DD/YYYY`,\n`MMM D, YYYY` or `D.M.YYYY h:mm A`. Put literal text in brackets, as `[Due] D/M/YYYY`. The value\nand the change event stay ISO (`YYYY-MM-DD`; `--MM-DD` with `month-day`), whatever the format.\nTyped ISO dates are always accepted too. With `month-day`, a format without `YYYY` is taken as a\nmonth-and-day format and used as given, rather than reordered for the locale; leave it unset to\nfollow the locale instead.\n\n**Default:** `'YYYY-MM-DD'`"
           }
         },
         {
@@ -7961,6 +7961,13 @@
             "value": "Accessible label for the minute in the time picker.\n\n**Default:** `'Minute'`"
           }
         },
+        {
+          "name": "month-day",
+          "description": {
+            "kind": "markdown",
+            "value": "Picks a month and day with no year, for a date that comes round every year, such as a birthday.\nThe value is `--MM-DD` (ISO 8601 without a year), the field shows the date as the locale writes\na month and day, and the calendar shows each month without a year or weekdays, with February\nalways having its 29th. Turns off `range`, `time-picker`, `show-dropdowns`, `min` and `max`, and\nhas no effect with `auto-apply`, `presets`, `first-day-of-week`, `min-date-message` or\n`max-date-message`, which all depend on them.\n\n**Default:** `false`"
+          }
+        },
         {
           "name": "month-label",
           "description": {
@@ -7993,7 +8000,7 @@
           "name": "placeholder",
           "description": {
             "kind": "markdown",
-            "value": "Specifies a short hint that describes the expected value of the field. Defaults to the format\nthe field takes, such as `YYYY-MM-DD`."
+            "value": "Specifies a short hint that describes the expected value of the field. Defaults to the format\nthe field takes, such as `YYYY-MM-DD`; with `month-day`, to an example date instead, such as\n`December 31`."
           }
         },
         {
@@ -8122,7 +8129,7 @@
           "name": "value",
           "description": {
             "kind": "markdown",
-            "value": "The selected date as `YYYY-MM-DD`, or in range mode the range as `YYYY-MM-DD/YYYY-MM-DD`; with\nthe time picker, each date as `YYYY-MM-DDTHH:mm`. An empty string when nothing is selected.\n\n**Default:** `''`"
+            "value": "The selected date as `YYYY-MM-DD`, or in range mode the range as `YYYY-MM-DD/YYYY-MM-DD`; with\nthe time picker, each date as `YYYY-MM-DDTHH:mm`; with `month-day`, the month and day with no\nyear, as `--MM-DD` (a full date is read too, as that month and day, and rewritten to it). An\nempty string when nothing is selected.\n\n**Default:** `''`"
           }
         },
         {