@pine-ds/core 4.9.1 → 4.11.0

package/dist/collection/components/pds-datepicker/value.js

@@ -1,4 +1,4 @@
-import { parseIsoDate, toIsoDate } from "./date-utils";
+import { MONTH_DAY_YEAR, dateFormatter, inMonthDayYear, parseIsoDate, parseMonthDay, toIsoDate } from "./date-utils";
 const DATE_TIME = /^(\d{4}-\d{2}-\d{2})(?:[T ](\d{2}):(\d{2}))?$/;
 /** Parses `YYYY-MM-DD`, `YYYY-MM-DDTHH:mm` or `YYYY-MM-DD HH:mm`. */
 export function parseDateTime(text) {
@@ -47,32 +47,50 @@ const wordsCache = new Map();
 function localeWords(locale) {
     let words = wordsCache.get(locale);
     if (!words) {
-        const month = (style) => {
-            const format = new Intl.DateTimeFormat(locale, {
-                month: style,
-                timeZone: 'UTC',
-                calendar: 'gregory',
+        const month = (style, withDay) => {
+            const format = new Intl.DateTimeFormat(locale, Object.assign(Object.assign({ month: style }, (withDay ? { day: 'numeric' } : {})), { timeZone: 'UTC', calendar: 'gregory' }));
+            return Array.from({ length: 12 }, (_, m) => {
+                const date = new Date(Date.UTC(2023, m, 1));
+                if (!withDay)
+                    return format.format(date);
+                const parts = format.formatToParts(date);
+                const index = parts.findIndex((part) => part.type === 'month');
+                if (index === -1)
+                    return format.format(date);
+                // CJK locales split a counter word, as Japanese `月`, into its own literal right after the
+                // month; a literal with no space is that word, not the separator before the day.
+                const suffix = parts[index + 1];
+                return (suffix === null || suffix === void 0 ? void 0 : suffix.type) === 'literal' && !/\s/.test(suffix.value) ? parts[index].value + suffix.value : parts[index].value;
             });
-            return Array.from({ length: 12 }, (_, m) => format.format(new Date(Date.UTC(2023, m, 1))));
         };
         const clock = clockFor(locale);
-        words = { months: month('long'), shortMonths: month('short'), am: clock.am, pm: clock.pm };
+        words = {
+            months: month('long', false),
+            shortMonths: month('short', false),
+            monthsWithDay: month('long', true),
+            shortMonthsWithDay: month('short', true),
+            am: clock.am,
+            pm: clock.pm,
+        };
         wordsCache.set(locale, words);
     }
     return words;
 }
+/** Whether a format's tokens (see `tokensOnly`) have a day, so a month name should inflect for one. */
+const hasDayToken = (tokens) => /D/.test(tokens);
 /** Writes a date in a format of tokens (see `FORMAT_PARTS`), with month names and AM/PM in the locale. */
 export function formatWith(value, format, locale = 'en-US') {
     var _a;
     const words = localeWords(locale);
+    const withDay = hasDayToken(tokensOnly(format));
     const [hours, minutes] = splitTime((_a = value.time) !== null && _a !== void 0 ? _a : '00:00');
     const hour12 = hours % 12 || 12;
     const month = value.date.getUTCMonth();
     const period = hours < 12 ? words.am : words.pm;
     const parts = {
         YYYY: pad(value.date.getUTCFullYear(), 4),
-        MMMM: words.months[month],
-        MMM: words.shortMonths[month],
+        MMMM: withDay ? words.monthsWithDay[month] : words.months[month],
+        MMM: withDay ? words.shortMonthsWithDay[month] : words.shortMonths[month],
         MM: pad(month + 1),
         M: String(month + 1),
         DD: pad(value.date.getUTCDate()),
@@ -94,17 +112,23 @@ const alternatives = (words) => `(${words.map(escapeRegExp).join('|')})`;
 /**
  * Reads typed text in a format of tokens, as written by `formatWith`. Leading zeros are optional,
  * spaces are loose, and month names and AM/PM are matched without regard to case, in the locale or
- * in English. Returns `null` for anything that isn't a real date and time in that format.
+ * in English. A format without `YYYY` reads into `year`, and without `year` it reads nothing.
+ * Returns `null` for anything that isn't a real date and time in that format.
  */
-export function parseWith(text, format, locale = 'en-US') {
+export function parseWith(text, format, locale = 'en-US', year) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     const words = localeWords(locale);
     const english = localeWords('en-US');
+    const withDay = hasDayToken(tokensOnly(format));
+    const months = withDay ? words.monthsWithDay : words.months;
+    const shortMonths = withDay ? words.shortMonthsWithDay : words.shortMonths;
+    const englishMonths = withDay ? english.monthsWithDay : english.months;
+    const englishShortMonths = withDay ? english.shortMonthsWithDay : english.shortMonths;
     const periods = [words.am, words.pm, english.am, english.pm];
     const patterns = {
         YYYY: '(\\d{4})',
-        MMMM: alternatives([...words.months, ...english.months]),
-        MMM: alternatives([...words.shortMonths, ...english.shortMonths]),
+        MMMM: alternatives([...months, ...englishMonths]),
+        MMM: alternatives([...shortMonths, ...englishShortMonths]),
         MM: '(\\d{1,2})',
         M: '(\\d{1,2})',
         DD: '(\\d{1,2})',
@@ -151,7 +175,7 @@ export function parseWith(text, format, locale = 'en-US') {
     const monthIndex = (name, long) => {
         if (name === undefined)
             return undefined;
-        const lists = long ? [words.months, english.months] : [words.shortMonths, english.shortMonths];
+        const lists = long ? [months, englishMonths] : [shortMonths, englishShortMonths];
         for (const list of lists) {
             const index = list.findIndex((candidate) => candidate.toLowerCase() === name.toLowerCase());
             if (index >= 0)
@@ -159,12 +183,12 @@ export function parseWith(text, format, locale = 'en-US') {
         }
         return undefined;
     };
-    const year = Number(read.YYYY);
+    const readYear = read.YYYY ? Number(read.YYYY) : year;
     const month = (_b = (_a = monthIndex(read.MMMM, true)) !== null && _a !== void 0 ? _a : monthIndex(read.MMM, false)) !== null && _b !== void 0 ? _b : Number((_c = read.MM) !== null && _c !== void 0 ? _c : read.M);
     const day = Number((_d = read.DD) !== null && _d !== void 0 ? _d : read.D);
-    if (!read.YYYY || !month || !day)
+    if (readYear === undefined || !month || !day)
         return null;
-    const date = parseIsoDate(`${pad(year, 4)}-${pad(month)}-${pad(day)}`);
+    const date = parseIsoDate(`${pad(readYear, 4)}-${pad(month)}-${pad(day)}`);
     if (!date)
         return null;
     const hourText = (_g = (_f = (_e = read.HH) !== null && _e !== void 0 ? _e : read.H) !== null && _f !== void 0 ? _f : read.hh) !== null && _g !== void 0 ? _g : read.h;
@@ -186,6 +210,40 @@ export function parseFieldText(text, format = DEFAULT_FORMAT, locale = 'en-US')
     var _a;
     return (_a = parseWith(text, format, locale)) !== null && _a !== void 0 ? _a : parseDateTime(text);
 }
+/**
+ * The locale's way of writing a month and day, as a format of tokens: `MMMM D` in English, `D MMMM`
+ * in French, `M月D日` in Japanese, or with `numeric`, `M/D` and `D/M`.
+ */
+export function monthDayFormat(locale = 'en-US', month = 'long') {
+    const parts = dateFormatter(locale, { month, day: 'numeric' }).formatToParts(new Date(Date.UTC(MONTH_DAY_YEAR, 11, 31)));
+    return parts
+        .map((part) => {
+        // Some locales write even the long month in digits, as Japanese `12月31日`.
+        if (part.type === 'month')
+            return /^\d+$/.test(part.value) ? 'M' : 'MMMM';
+        if (part.type === 'day')
+            return 'D';
+        // Bracketed, spaces included, only when it has letters a token could be read from, as
+        // Spanish `D[ de ]MMMM`.
+        return /[A-Za-z]/.test(part.value) ? `[${part.value}]` : part.value;
+    })
+        .join('');
+}
+/**
+ * Reads a typed month and day, into month-day mode's year: in the format, then as the locale writes
+ * it with a month name or in numbers, with the English order too, then as `--MM-DD` or a full ISO
+ * date, whose year is dropped.
+ */
+export function parseMonthDayText(text, format, locale = 'en-US') {
+    const formats = [format, monthDayFormat(locale), monthDayFormat(locale, 'numeric'), 'MMMM D', 'D MMMM', 'MMM D', 'D MMM'];
+    for (const candidate of formats) {
+        const read = parseWith(text, candidate, locale, MONTH_DAY_YEAR);
+        if (read)
+            return { date: inMonthDayYear(read.date), time: null };
+    }
+    const date = parseMonthDay(text);
+    return date ? { date, time: null } : null;
+}
 /**
  * Parses a typed range: two dates (with times, optionally) joined by a dash or `to` with spaces
  * around it, as `2026-09-13 – 2026-10-13`, or by `/` when the format doesn't use slashes. The

package/dist/collection/components/pds-dropdown-menu/pds-dropdown-menu.js

@@ -107,7 +107,7 @@ export class PdsDropdownMenu {
             this.currentFocusIndex = -1;
             // Return focus to trigger
             if (this.isFocusInMenu()) {
-                this.triggerEl.focus();
+                this.focusTrigger();
             }
         };
         // Handle click on the trigger element
@@ -158,6 +158,14 @@ export class PdsDropdownMenu {
         const focused = this.host.getRootNode().activeElement;
         return focused != null && this.host.contains(focused);
     }
+    // A trigger whose host can't take focus itself, such as pds-chip, passes it to the control inside.
+    focusTrigger() {
+        var _a, _b;
+        this.triggerEl.focus();
+        if (this.host.getRootNode().activeElement === this.triggerEl)
+            return;
+        (_b = (_a = this.triggerEl.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector('button, [href], [tabindex]:not([tabindex="-1"])')) === null || _b === void 0 ? void 0 : _b.focus();
+    }
     // Check if a menu item is disabled (handles both component and raw elements)
     isItemDisabled(item) {
         const tagName = item.tagName.toLowerCase();
@@ -253,6 +261,23 @@ export class PdsDropdownMenu {
             this.focusItemByIndex(prevIndex);
         }
     }
+    // Unlike the arrow keys, Tab stops at either end of the menu instead of wrapping.
+    adjacentEnabledIndex(fromIndex, step) {
+        for (let index = fromIndex + step; index >= 0 && index < this.menuItems.length; index += step) {
+            if (!this.isItemDisabled(this.menuItems[index]))
+                return index;
+        }
+        return -1;
+    }
+    // An enabled item can still refuse focus (hidden, or a link with no href), so each one is tried in turn.
+    focusAdjacentItem(fromIndex, step) {
+        for (let index = this.adjacentEnabledIndex(fromIndex, step); index !== -1; index = this.adjacentEnabledIndex(index, step)) {
+            this.focusItemByIndex(index);
+            if (this.getFocusedItemIndex() === index)
+                return true;
+        }
+        return false;
+    }
     // Escape is taken in document's capture phase, before a modal around the menu hears it on
     // document and closes too.
     handleEscapeKeyDown(event) {
@@ -261,6 +286,28 @@ export class PdsDropdownMenu {
         event.preventDefault();
         this.closeDropdown();
     }
+    // Taken in the capture phase, so a modal or popover around the menu that traps Tab finds the key
+    // already handled, or focus back on the trigger with the items hidden.
+    handleTabKeyDown(event) {
+        if (!this.isOpen || event.key !== 'Tab' || event.defaultPrevented)
+            return;
+        const currentIndex = this.getFocusedItemIndex();
+        if (currentIndex === -1) {
+            // The menu sits after the trigger, so Shift+Tab from the trigger leaves it behind. So does Shift+Tab
+            // from outside the menu, where focus stays after a mouse open in Safari.
+            if (event.shiftKey && (document.activeElement === this.triggerEl || !this.isFocusInMenu()))
+                this.closeDropdown();
+            return;
+        }
+        if (this.focusAdjacentItem(currentIndex, event.shiftKey ? -1 : 1)) {
+            event.preventDefault();
+            return;
+        }
+        // Past either end, closing moves focus to the trigger. Shift+Tab stays there; Tab carries on past it.
+        if (event.shiftKey)
+            event.preventDefault();
+        this.closeDropdown();
+    }
     // Handle keyboard events for the dropdown
     handleKeyDown(event) {
         if (!this.isOpen)
@@ -300,54 +347,19 @@ export class PdsDropdownMenu {
                     }
                 }
                 break;
-            case 'Tab':
-                if (event.shiftKey) {
-                    // Let Shift+Tab navigate naturally from first item to trigger
-                    // For all other items, move to previous item
-                    const currentIndex = this.getFocusedItemIndex();
-                    if (currentIndex > 0) {
-                        // If not on first item, prevent default and go to previous item
-                        event.preventDefault();
-                        this.focusPreviousItem(); // Use our method that skips disabled items
-                    }
-                    // If on first item or no item, let natural tab order move back to trigger
+            case 'Tab': {
+                // Tab from an item is handled in handleTabKeyDown; from anywhere else it moves into the menu.
+                if (event.shiftKey || this.getFocusedItemIndex() !== -1)
+                    break;
+                if (this.focusAdjacentItem(-1, 1)) {
+                    event.preventDefault();
                 }
                 else {
-                    // Forward Tab navigation
-                    const activeElement = document.activeElement;
-                    const isTriggerFocused = activeElement === this.triggerEl;
-                    const currentIndex = this.getFocusedItemIndex();
-                    if (isTriggerFocused && this.menuItems.length > 0) {
-                        // If trigger is focused, move to first non-disabled menu item
-                        event.preventDefault();
-                        // Find the first non-disabled item
-                        let firstFocusableIndex = 0;
-                        while (firstFocusableIndex < this.menuItems.length && this.isItemDisabled(this.menuItems[firstFocusableIndex])) {
-                            firstFocusableIndex++;
-                        }
-                        if (firstFocusableIndex < this.menuItems.length) {
-                            this.focusItemByIndex(firstFocusableIndex);
-                        }
-                    }
-                    else if (currentIndex === -1 && this.menuItems.length > 0) {
-                        // If no menu item is focused, focus the first non-disabled one
-                        event.preventDefault();
-                        // Find the first non-disabled item
-                        let firstFocusableIndex = 0;
-                        while (firstFocusableIndex < this.menuItems.length && this.isItemDisabled(this.menuItems[firstFocusableIndex])) {
-                            firstFocusableIndex++;
-                        }
-                        if (firstFocusableIndex < this.menuItems.length) {
-                            this.focusItemByIndex(firstFocusableIndex);
-                        }
-                    }
-                    else if (currentIndex !== -1) {
-                        // Use our method that skips disabled items
-                        event.preventDefault();
-                        this.focusNextItem();
-                    }
+                    // With no item to move to, Tab carries on past the menu, as it does past the last item.
+                    this.closeDropdown();
                 }
                 break;
+            }
         }
     }
     // Handle clicks outside the dropdown to close it
@@ -357,7 +369,7 @@ export class PdsDropdownMenu {
         }
     }
     render() {
-        return (h(Host, { key: '0ed3d8ee889a5423ca9de66a86791d084f75abf0', id: this.componentId }, h("slot", { key: '6bab71652d6afe094075623d3a48641a4d89b232', name: "trigger", onSlotchange: this.handleTriggerSlotChange }), h("pds-box", { key: 'fcef0667f999ae5b8cd03eb94a0db0be7be502cb', "border-radius": "sm", display: "flex", direction: "column", class: "pds-dropdown-menu--panel is-hidden", shadow: "100", part: "menu-panel" }, h("div", { key: 'c78d5bd7e48c5483b12171341271f9132f4b2ff9', class: { 'pds-dropdown-menu__header': true, 'is-hidden': !this.hasHeader } }, h("slot", { key: '6464994260720d6046da548f4aad0896965cc47c', name: "header", onSlotchange: this.handleHeaderSlotChange })), h("div", { key: '3e97dfc4e1911f91ce8917faf981d436e71e5c24', class: "pds-dropdown-menu__items", role: "menu", "aria-orientation": "vertical" }, h("slot", { key: 'dfd77a8b73df5ce9eef3e661d3f9501cb8bfdba2', onSlotchange: this.handleSlotChange })))));
+        return (h(Host, { key: 'aa4ce84354cf87638ee46fd7ed69520228b7e656', id: this.componentId }, h("slot", { key: '948800e67d18c8c6cc9e77ef3aeab635c5035453', name: "trigger", onSlotchange: this.handleTriggerSlotChange }), h("pds-box", { key: '3ce2a2879b14aad975cea8ae72fcbf8c3abcf20c', "border-radius": "sm", display: "flex", direction: "column", class: "pds-dropdown-menu--panel is-hidden", shadow: "100", part: "menu-panel" }, h("div", { key: 'ad25fbf4f3c7a24653c229e64fe2ce893a92e4c8', class: { 'pds-dropdown-menu__header': true, 'is-hidden': !this.hasHeader } }, h("slot", { key: '35a5903543e08577997b456bcd312bdd009fd8fc', name: "header", onSlotchange: this.handleHeaderSlotChange })), h("div", { key: 'a9593adacf047918c1d87494f8c951a2a4a5f76f', class: "pds-dropdown-menu__items", role: "menu", "aria-orientation": "vertical" }, h("slot", { key: '8d2def1cc7020608220099f4ced0f44e9838cce8', onSlotchange: this.handleSlotChange })))));
     }
     static get is() { return "pds-dropdown-menu"; }
     static get encapsulation() { return "shadow"; }
@@ -435,6 +447,12 @@ export class PdsDropdownMenu {
                 "target": "document",
                 "capture": true,
                 "passive": false
+            }, {
+                "name": "keydown",
+                "method": "handleTabKeyDown",
+                "target": "document",
+                "capture": true,
+                "passive": false
             }, {
                 "name": "keydown",
                 "method": "handleKeyDown",

package/dist/collection/utils/truncation-tooltip.js

@@ -2,7 +2,7 @@ import { computePosition, flip, offset, shift, } from "@floating-ui/dom";
 import { findPortalTarget, isTopLayerInDocument, onTopLayerClose } from "./portal-target";
 // Controls that clipped text can sit inside that already take focus, so the text adds no tab stop of its own.
 // Not any `[tabindex]`: a focusable scroll region full of chips would show every chip's tooltip at once.
-export const FOCUSABLE_WRAPPER = 'a[href], button, summary, pds-button, pds-link, pds-tab, pds-dropdown-menu-item, [role="option"]';
+export const FOCUSABLE_WRAPPER = 'a[href], button, summary, pds-button, pds-link, pds-tab, pds-dropdown-menu-item, [role="option"], [role="treeitem"]';
 /** CSS class prefix used for truncation tooltip portal elements */
 const TOOLTIP_CLASS = 'pds-truncation-tooltip';
 /**

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-11-04T18:16:35",
+  "timestamp": "2026-11-09T22:28:16",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -15253,7 +15253,7 @@
       "encapsulation": "shadow",
       "tag": "pds-datepicker",
       "readme": "# pds-datepicker\n\n\n",
-      "docs": "A field for one date, or in range mode a start and end date, with a calendar to pick from.\nThe value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each\ndate carries a time, as `YYYY-MM-DDTHH:mm`.",
+      "docs": "A field for one date, or in range mode a start and end date, with a calendar to pick from.\nThe value is `YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` for a range; with the time picker, each\ndate carries a time, as `YYYY-MM-DDTHH:mm`. In month-day mode, for a date that comes round every\nyear such as a birthday, it's a month and day with no year, as `--MM-DD`.",
       "docsTags": [
         {
           "name": "part",
@@ -15572,7 +15572,7 @@
           "mutable": false,
           "attr": "format",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -15948,6 +15948,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "monthDay",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "month-day",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "monthLabel",
           "type": "string",
@@ -16069,7 +16098,7 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "Specifies a short hint that describes the expected value of the field. Defaults to the format\nthe field takes, such as `YYYY-MM-DD`.",
+          "docs": "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`.",
           "docsTags": [],
           "values": [
             {
@@ -16484,7 +16513,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -17370,6 +17399,12 @@
           "capture": true,
           "passive": false
         },
+        {
+          "event": "keydown",
+          "target": "document",
+          "capture": true,
+          "passive": false
+        },
         {
           "event": "keydown",
           "target": "window",
@@ -28271,7 +28306,7 @@
       "path": "src/utils/types.ts"
     },
     "src/components/pds-combobox/combobox-interface.ts::ComboboxOption": {
-      "declaration": "export interface ComboboxOption {\n  id: string | number;\n  text: string;\n  /**\n   * Label of the group this option belongs to. Options sharing a group are rendered together\n   * under one group label, where the group first appears, the same as slotted `<optgroup>`\n   * markup. With `group-display=\"inline\"`, options without a group are listed before every group;\n   * with `flyout` and `drill-in`, options without a group and groups keep the array's order.\n   */\n  group?: string;\n  /**\n   * Pine icon name shown beside the group's label (letters, digits and hyphens, for example\n   * `hashtag`); URLs and file paths are not accepted. The first option in the group that sets\n   * one wins, the same as `data-icon` on a slotted `<optgroup>`.\n   */\n  groupIcon?: string;\n  /**\n   * Pine icon name shown before the option's text (letters, digits and hyphens, for example\n   * `hashtag`); URLs and file paths are not accepted. The same as `data-icon` on a slotted `<option>`.\n   * Once the option is chosen, the `button` trigger shows it too.\n   */\n  icon?: string;\n  /**\n   * When `true`, the option stays reachable by the arrow keys and the pointer, so assistive tech\n   * announces it as unavailable, but it cannot be selected.\n   */\n  disabled?: boolean;\n  [key: string]: unknown;\n}",
+      "declaration": "export interface ComboboxOption {\n  id: string | number;\n  text: string;\n  /**\n   * Label of the group this option belongs to. Options sharing a group are rendered together\n   * under one group label, where the group first appears, the same as slotted `<optgroup>`\n   * markup. With `group-display=\"inline\"`, options without a group are listed before every group;\n   * with `flyout` and `drill-in`, options without a group and groups keep the array's order.\n   */\n  group?: string;\n  /**\n   * Pine icon name shown beside the group's label (letters, digits and hyphens, for example\n   * `hashtag`); URLs and file paths are not accepted. The first option in the group that sets\n   * one wins, the same as `data-icon` on a slotted `<optgroup>`.\n   */\n  groupIcon?: string;\n  /**\n   * A small chip after the group's label, such as \"Premium\". `label` is its text; `sentiment` is a\n   * `pds-chip` sentiment (`neutral` when unset or unknown); `icon` is a Pine icon name (letters,\n   * digits and hyphens, for example `premium`); URLs and file paths are not accepted. The first\n   * option in the group that sets one wins, the same as `data-badge`, `data-badge-sentiment` and\n   * `data-badge-icon` on a slotted `<optgroup>`. It isn't matched by search, and screen readers\n   * read it as part of the group's name. It isn't shown on a drilled-in group's row back.\n   */\n  groupBadge?: { label: string; sentiment?: string; icon?: string };\n  /**\n   * Pine icon name shown before the option's text (letters, digits and hyphens, for example\n   * `hashtag`); URLs and file paths are not accepted. The same as `data-icon` on a slotted `<option>`.\n   * Once the option is chosen, the `button` trigger shows it too.\n   */\n  icon?: string;\n  /**\n   * A small chip after the option's text, such as \"New\". `label` is its text; `sentiment` is a\n   * `pds-chip` sentiment (`neutral` when unset or unknown); `icon` is a Pine icon name (letters,\n   * digits and hyphens, for example `star`); URLs and file paths are not accepted. The same as\n   * `data-badge`, `data-badge-sentiment` and `data-badge-icon` on a slotted `<option>`. It isn't\n   * shown in the trigger or matched by search, and screen readers read it as part of the option's\n   * name. Options that are chips or custom layouts don't show it.\n   */\n  badge?: { label: string; sentiment?: string; icon?: string };\n  /**\n   * When `true`, the option stays reachable by the arrow keys and the pointer, so assistive tech\n   * announces it as unavailable, but it cannot be selected.\n   */\n  disabled?: boolean;\n  [key: string]: unknown;\n}",
       "docstring": "",
       "path": "src/components/pds-combobox/combobox-interface.ts"
     },
@@ -28296,7 +28331,7 @@
       "path": "src/components/pds-datepicker/datepicker-interface.ts"
     },
     "src/components/pds-datepicker/datepicker-interface.ts::DatepickerChangeEventDetail": {
-      "declaration": "export interface DatepickerChangeEventDetail {\n  /**\n   * The selected date as `YYYY-MM-DD`, or in range mode the range as `YYYY-MM-DD/YYYY-MM-DD`; with\n   * the time picker, each date as `YYYY-MM-DDTHH:mm`. An empty string when cleared.\n   */\n  value: string;\n  /** Range mode: the first day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */\n  start?: string;\n  /** Range mode: the last day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */\n  end?: string;\n  /**\n   * Range mode: the key of the preset the range matches, such as `last-30-days`, so a filter can\n   * keep the range relative to today.\n   */\n  preset?: string;\n}",
+      "declaration": "export interface DatepickerChangeEventDetail {\n  /**\n   * The selected date as `YYYY-MM-DD`, or in range mode the range as `YYYY-MM-DD/YYYY-MM-DD`; with\n   * the time picker, each date as `YYYY-MM-DDTHH:mm`; with `month-day`, `--MM-DD`. An empty string\n   * when cleared.\n   */\n  value: string;\n  /** Range mode: the first day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */\n  start?: string;\n  /** Range mode: the last day of the range, `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm` with the time picker. */\n  end?: string;\n  /**\n   * Range mode: the key of the preset the range matches, such as `last-30-days`, so a filter can\n   * keep the range relative to today.\n   */\n  preset?: string;\n}",
       "docstring": "",
       "path": "src/components/pds-datepicker/datepicker-interface.ts"
     },