@pine-ds/core 3.27.0 → 3.28.0

package/dist/collection/i18n/i18n-format.js

@@ -0,0 +1,59 @@
+/**
+ * i18n formatting helpers for Pine components.
+ *
+ * Pine stays string-agnostic: user-facing text is supplied by the consumer as
+ * props (English-defaulted). These helpers only handle the two things a prop
+ * value can't express on its own — interpolating live component state into a
+ * translated template, and picking the right plural form. No stored strings, no
+ * locale registry; the locale is read from the DOM (`lang`), the web-standard
+ * signal a consumer already sets.
+ *
+ * Two limitations of DOM-`lang` locale resolution, both inherent to inferring
+ * locale from the DOM rather than being told it:
+ *
+ * 1. Not reactive. `resolveLocale` is read during render; Stencil has no
+ *    reactive dependency on a DOM attribute, so changing `lang` at runtime
+ *    (`document.documentElement.lang = 'pl'`) does NOT re-render mounted
+ *    components — the plural form stays stale until unrelated state forces a
+ *    render. Fine when locale changes via full-page navigation; a consumer that
+ *    switches locale client-side should pass the already-formatted/pluralized
+ *    string as the prop instead.
+ * 2. Does not cross shadow boundaries. `el.closest('[lang]')` stops at the host's
+ *    shadow root. A Pine component nested inside another custom element whose
+ *    `lang` sits on that outer host will not see it and falls back to
+ *    `document.documentElement.lang`. Set `lang` on (or above) the Pine element
+ *    in the same tree, or pass a pre-formatted string, when that matters.
+ */
+/** Replace `{token}` placeholders with `vars`; unknown tokens stay literal. */
+export function formatMessage(template, vars) {
+    if (!vars)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_match, key) => key in vars ? String(vars[key]) : `{${key}}`);
+}
+/** Nearest `[lang]` ancestor, then `<html lang>`, then `'en'`. */
+export function resolveLocale(el) {
+    var _a;
+    const fromEl = el && typeof el.closest === 'function' ? (_a = el.closest('[lang]')) === null || _a === void 0 ? void 0 : _a.getAttribute('lang') : null;
+    const fromDoc = typeof document !== 'undefined' ? document.documentElement.lang : '';
+    return fromEl || fromDoc || 'en';
+}
+/**
+ * Pick the CLDR plural form for `count` in the element's locale (via the
+ * platform `Intl.PluralRules`) and interpolate `{count}`. `forms` come from the
+ * caller — component props, English-defaulted — and fall back to `other`.
+ */
+export function pluralize(el, count, forms, vars) {
+    let category = 'other';
+    try {
+        category = new Intl.PluralRules(resolveLocale(el)).select(count);
+    }
+    catch (_a) {
+        /* invalid locale tag → fall back to 'other' */
+    }
+    // Prefer the selected category, then the required `other`, then `one`; never
+    // return empty. `||` (not `??`) so an empty-string form is skipped too, not
+    // treated as present — a bare `{count}` still shows the number rather than
+    // leaving the trigger with no accessible name.
+    const template = forms[category] || forms.other || forms.one || '{count}';
+    return formatMessage(template, Object.assign({ count }, vars));
+}

package/dist/collection/i18n/index.js

@@ -0,0 +1 @@
+export { formatMessage, pluralize, resolveLocale } from './i18n-format';

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-20T19:37:05",
+  "timestamp": "2026-08-07T01:13:40",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -455,6 +455,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dismissLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dismiss-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the dismiss button. Pass a translated string to\nlocalize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Dismiss alert'"
+            }
+          ],
+          "default": "'Dismiss alert'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dismissible",
           "type": "boolean",
@@ -877,6 +906,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "triggerLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "trigger-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the dropdown trigger button. Pass a translated string\nto localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Avatar dropdown trigger'"
+            }
+          ],
+          "default": "'Avatar dropdown trigger'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "variant",
           "type": "\"admin\" | \"customer\"",
@@ -12661,6 +12719,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dismissLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dismiss-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the remove button. Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Remove'"
+            }
+          ],
+          "default": "'Remove'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dot",
           "type": "boolean",
@@ -17605,6 +17692,64 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "createOptionAriaLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "create-option-aria-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the create-new-option row. Pass a translated string to localize it; `{text}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Create new tag: {text}'"
+            }
+          ],
+          "default": "'Create new tag: {text}'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "createOptionLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "create-option-label",
+          "reflectToAttr": false,
+          "docs": "Visible label for the create-new-option row. Pass a translated string to localize it; `{text}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Add \"{text}\"'"
+            }
+          ],
+          "default": "'Add \"{text}\"'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "createUrl",
           "type": "string",
@@ -17923,6 +18068,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "itemRemovedLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "item-removed-label",
+          "reflectToAttr": false,
+          "docs": "Screen-reader announcement when an item is removed. Pass a translated string to localize it; `{item}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{item} removed'"
+            }
+          ],
+          "default": "'{item} removed'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -18108,6 +18282,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "noOptionsFoundLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "no-options-found-label",
+          "reflectToAttr": false,
+          "docs": "Text shown when no options match the search. Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'No options found'"
+            }
+          ],
+          "default": "'No options found'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "options",
           "type": "MultiselectOption[]",
@@ -18137,6 +18340,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "optionsLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "options-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the options listbox (falls back to this when `label` is unset). Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Options'"
+            }
+          ],
+          "default": "'Options'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "panelWidth",
           "type": "string",
@@ -18194,6 +18426,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "pillRemoveLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "pill-remove-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the remove button on each selected-item pill. Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Remove'"
+            }
+          ],
+          "default": "'Remove'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "placeholder",
           "type": "string",
@@ -18205,10 +18466,10 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "Placeholder text for the input field.",
+          "docs": "Placeholder text for the input field. Pass a translated string to localize it; defaults to English.",
           "docsTags": [
             {
-              "name": "default",
+              "name": "defaultValue",
               "text": "'Select...'"
             }
           ],
@@ -18218,7 +18479,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false,
           "getter": false,
           "setter": false
@@ -18252,6 +18513,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "searchOptionsLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "search-options-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the search input. Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Search options'"
+            }
+          ],
+          "default": "'Search options'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "searchPlaceholder",
           "type": "string",
@@ -18263,10 +18553,10 @@
           "mutable": false,
           "attr": "search-placeholder",
           "reflectToAttr": false,
-          "docs": "Placeholder text for the search input inside the dropdown panel.",
+          "docs": "Placeholder text for the search input inside the dropdown panel. Pass a translated string to localize it; defaults to English.",
           "docsTags": [
             {
-              "name": "default",
+              "name": "defaultValue",
               "text": "'Find...'"
             }
           ],
@@ -18281,6 +18571,123 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "selectedCountLabelOne",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "selected-count-label-one",
+          "reflectToAttr": false,
+          "docs": "Singular form of the selected-count trigger text. Pass a translated string to localize it; `{count}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{count} item'"
+            }
+          ],
+          "default": "'{count} item'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "selectedCountLabelOther",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "selected-count-label-other",
+          "reflectToAttr": false,
+          "docs": "Plural (and fallback) form of the selected-count trigger text — used for English and any locale whose selected plural category isn't supplied via `selectedCountLabels`. Pass a translated string to localize it; `{count}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{count} items'"
+            }
+          ],
+          "default": "'{count} items'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "selectedCountLabels",
+          "type": "\"few\" | \"many\" | \"one\" | \"other\" | \"two\" | \"zero\" | string",
+          "complexType": {
+            "original": "PluralForms | string",
+            "resolved": "\"few\" | \"many\" | \"one\" | \"other\" | \"two\" | \"zero\" | string",
+            "references": {
+              "PluralForms": {
+                "location": "import",
+                "path": "../../i18n",
+                "id": "src/i18n/index.ts::PluralForms",
+                "referenceLocation": "PluralForms"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "selected-count-labels",
+          "reflectToAttr": false,
+          "docs": "Full CLDR plural forms for the selected-count trigger text, for locales with more than the English `one`/`other` categories (e.g. Polish `few`/`many`, Arabic `zero`/`two`). Accepts an object property or a JSON string attribute keyed by CLDR category — `{ one, other, few, many, two, zero }`. Any form omitted here falls back to `selectedCountLabelOne`/`selectedCountLabelOther`. `{count}` is interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "undefined"
+            }
+          ],
+          "values": [
+            {
+              "value": "few",
+              "type": "string"
+            },
+            {
+              "value": "many",
+              "type": "string"
+            },
+            {
+              "value": "one",
+              "type": "string"
+            },
+            {
+              "value": "other",
+              "type": "string"
+            },
+            {
+              "value": "two",
+              "type": "string"
+            },
+            {
+              "value": "zero",
+              "type": "string"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "selectedDisplay",
           "type": "\"count\" | \"pill\"",
@@ -18315,6 +18722,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "selectedItemsLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "selected-items-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the selected-items region. Pass a translated string to localize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Selected items'"
+            }
+          ],
+          "default": "'Selected items'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "triggerWidth",
           "type": "string",
@@ -23206,6 +23642,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "characterCountLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "character-count-label",
+          "reflectToAttr": false,
+          "docs": "Template for the character-counter's accessible label. Pass a translated\nstring to localize it; `{current}` and `{max}` are interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{current} of {max} characters'"
+            }
+          ],
+          "default": "'{current} of {max} characters'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "componentId",
           "type": "string",
@@ -23798,6 +24263,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dismissLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "dismiss-label",
+          "reflectToAttr": false,
+          "docs": "Accessible label for the dismiss button. Pass a translated string to\nlocalize it; defaults to English.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Dismiss message'"
+            }
+          ],
+          "default": "'Dismiss message'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dismissible",
           "type": "boolean",
@@ -24392,6 +24886,11 @@
       "docstring": "",
       "path": "src/components/pds-input/input-interface.ts"
     },
+    "src/i18n/index.ts::PluralForms": {
+      "declaration": "any",
+      "docstring": "",
+      "path": "src/i18n/index.ts"
+    },
     "src/components/pds-multiselect/multiselect-interface.ts::MultiselectOption": {
       "declaration": "export interface MultiselectOption {\n  id: string | number;\n  text: string;\n  /** When `true`, the option is rendered as non-interactive and cannot be selected. */\n  disabled?: boolean;\n  /**\n   * Optional section label for grouped rendering (with `options` prop or parsed slots).\n   * Options that share a `group` value must be contiguous in the array; non-contiguous\n   * rows with the same label produce separate headers (mirrors native `<optgroup>`).\n   */\n  group?: string;\n  isCreateOption?: boolean;\n  [key: string]: unknown;\n}",
       "docstring": "",