@ds-autonomie/web-components 2.19.0 → 2.21.0

package/cdn/custom-elements.json

@@ -1754,6 +1754,163 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/banner/banner.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "DSABanner",
+          "slots": [
+            {
+              "description": "The banner's message content.",
+              "name": ""
+            },
+            {
+              "description": "Optional icon content.",
+              "name": "icon"
+            },
+            {
+              "description": "Optional action content.",
+              "name": "action"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'dsa-icon-button': DSAIconButton, }"
+            },
+            {
+              "kind": "field",
+              "name": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController( this, 'icon', 'action' )"
+            },
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "closeButton",
+              "type": {
+                "text": "DSAIconButton | null"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "closable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables a close button that allows users to dismiss the banner.",
+              "attribute": "closable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "mobile",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables compact mobile layout.",
+              "attribute": "mobile",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "closeLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible label for the close button.",
+              "attribute": "close-label"
+            },
+            {
+              "kind": "method",
+              "name": "handleClose",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the user closes the banner.",
+              "name": "dsa-close"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "closable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables a close button that allows users to dismiss the banner.",
+              "fieldName": "closable"
+            },
+            {
+              "name": "mobile",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables compact mobile layout.",
+              "fieldName": "mobile"
+            },
+            {
+              "name": "close-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible label for the close button.",
+              "fieldName": "closeLabel"
+            }
+          ],
+          "superclass": {
+            "name": "ShoelaceElement",
+            "package": "@internal/shoelace-element"
+          },
+          "summary": "Banners are used to display key information in a contrasted area with optional actions.",
+          "dependencies": [
+            "dsa-icon-button"
+          ],
+          "tagName": "dsa-banner",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "DSABanner",
+            "module": "components/banner/banner.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "dsa-banner",
+          "declaration": {
+            "name": "DSABanner",
+            "module": "components/banner/banner.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/breadcrumb/breadcrumb.js",
@@ -5423,6 +5580,16 @@
               "description": "Deactivates the combobox inner filtering logic",
               "attribute": "override-default-filtering"
             },
+            {
+              "kind": "field",
+              "name": "keepSearchAfterSelection",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Keeps the current search term after selecting an option when multiple is true.",
+              "attribute": "keep-search-after-selection"
+            },
             {
               "kind": "field",
               "name": "validity",
@@ -5531,6 +5698,11 @@
               "name": "resetDisplayedOptionsCount",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "resetSearchAfterSelection",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "toggleOptionSelection",
@@ -6027,6 +6199,15 @@
               "default": "false",
               "description": "Deactivates the combobox inner filtering logic",
               "fieldName": "overrideDefaultFiltering"
+            },
+            {
+              "name": "keep-search-after-selection",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Keeps the current search term after selecting an option when multiple is true.",
+              "fieldName": "keepSearchAfterSelection"
             }
           ],
           "superclass": {
@@ -6835,6 +7016,15 @@
               "description": "The name of the downloaded file",
               "attribute": "filename"
             },
+            {
+              "kind": "field",
+              "name": "cachedDocumentInfo",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
             {
               "kind": "method",
               "name": "handleFocus",
@@ -7011,6 +7201,15 @@
               "description": "The name of the downloaded file",
               "attribute": "filename"
             },
+            {
+              "kind": "field",
+              "name": "cachedDocumentInfo",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
             {
               "kind": "method",
               "name": "handleFocus",
@@ -8136,7 +8335,8 @@
               },
               "default": "false",
               "description": "The fieldset's content orientation.",
-              "attribute": "horizontal"
+              "attribute": "horizontal",
+              "reflects": true
             },
             {
               "kind": "field",
@@ -8318,6 +8518,15 @@
               "privacy": "private",
               "default": "[]"
             },
+            {
+              "kind": "field",
+              "name": "acceptedTypesCache",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
             {
               "kind": "field",
               "name": "fileUploadInput",
@@ -8451,6 +8660,17 @@
               "attribute": "multiple",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "appendFiles",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When used with `multiple`, keeps previously selected files and appends newly selected files.\n\nBy default, each new selection replaces the previous one (native input behavior).",
+              "attribute": "append-files",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "error",
@@ -8614,6 +8834,16 @@
               "name": "getAllFileElements",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "updateFileItemsSize",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "syncInputFilesFromStore",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "handleDefaultSlotChange",
@@ -8727,6 +8957,10 @@
               "name": "getDescriptionIds",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "handleAcceptChange"
+            },
             {
               "kind": "method",
               "name": "handleSizeChange"
@@ -8873,6 +9107,15 @@
               "description": "`true` if this drop container should accept more than one files at once.",
               "fieldName": "multiple"
             },
+            {
+              "name": "append-files",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When used with `multiple`, keeps previously selected files and appends newly selected files.\n\nBy default, each new selection replaces the previous one (native input behavior).",
+              "fieldName": "appendFiles"
+            },
             {
               "name": "error",
               "type": {
@@ -9062,7 +9305,8 @@
               "name": "labelText",
               "type": {
                 "text": "string"
-              }
+              },
+              "default": "''"
             },
             {
               "kind": "method",
@@ -9080,7 +9324,15 @@
             {
               "kind": "method",
               "name": "handleDefaultSlotChange",
-              "privacy": "private"
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             }
           ],
           "events": [
@@ -9420,6 +9672,18 @@
                 "text": "string"
               }
             },
+            {
+              "kind": "field",
+              "name": "hasMinBound",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "hasMaxBound",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "value",
@@ -10506,11 +10770,23 @@
               "kind": "field",
               "name": "debounceTimerId",
               "type": {
-                "text": "NodeJS.Timeout | null"
+                "text": "ReturnType<typeof setTimeout> | null"
               },
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "optionsByValue",
+              "privacy": "private",
+              "default": "new Map<string, DSAOption>()"
+            },
+            {
+              "kind": "field",
+              "name": "normalizedLabelsByValue",
+              "privacy": "private",
+              "default": "new Map<string, string>()"
+            },
             {
               "kind": "field",
               "name": "value",
@@ -12196,7 +12472,7 @@
               "name": "hasSlotController",
               "privacy": "private",
               "readonly": true,
-              "default": "new HasSlotController( this, 'external-links', 'second-logo', 'site-name', 'baseline', 'search' )"
+              "default": "new HasSlotController( this, 'external-links', 'second-logo', 'site-name', 'baseline', 'search', 'navbar' )"
             },
             {
               "kind": "field",
@@ -14909,7 +15185,7 @@
           "type": {
             "text": "DSAMaskConfig"
           },
-          "default": "{ placeholder: '____ __ __ ___', pattern: `([a-zA-Z]{4})([a-zA-Z]{2})(([2-9a-zA-Z]{1})([0-9a-np-zA-NP-Z]{1}))((([0-9a-wy-zA-WY-Z]{1})([0-9a-zA-Z]{2}))|([xX]{3})|)`, 'help-text': '8 ou 11 charactères', }",
+          "default": "{ placeholder: '____ __ __ ___', pattern: `([a-zA-Z]{4})([a-zA-Z]{2})(([2-9a-zA-Z]{1})([0-9a-np-zA-NP-Z]{1}))((([0-9a-wy-zA-WY-Z]{1})([0-9a-zA-Z]{2}))|([xX]{3})|)`, 'help-text': '8 ou 11 charactères', mask: '', }",
           "description": "Input Mask configuration for BIC/Swift. Pattern compatible the 100 principal banks of France."
         },
         {
@@ -14996,6 +15272,23 @@
               "readonly": true,
               "default": "new LocalizeController(this)"
             },
+            {
+              "kind": "field",
+              "name": "effectiveMask",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "patternRegExp",
+              "type": {
+                "text": "RegExp | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "input",
@@ -15050,7 +15343,17 @@
             },
             {
               "kind": "method",
-              "name": "handleDocumentKeyUp",
+              "name": "updateMaskConfig",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "syncMaskedValue",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleInputValueChange",
               "privacy": "private"
             },
             {
@@ -15075,6 +15378,10 @@
               "kind": "method",
               "name": "handleValueChange"
             },
+            {
+              "kind": "method",
+              "name": "handleMaskConfigChange"
+            },
             {
               "kind": "method",
               "name": "setRangeText",
@@ -15272,6 +15579,58 @@
             }
           ]
         },
+        {
+          "kind": "function",
+          "name": "buildValidityState",
+          "return": {
+            "type": {
+              "text": "ValidityState"
+            }
+          },
+          "parameters": [
+            {
+              "name": "inputValidity",
+              "type": {
+                "text": "ValidityState"
+              }
+            },
+            {
+              "name": "patternMatch",
+              "type": {
+                "text": "boolean | undefined"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "renderMaskOverlay",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "maskedValue",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "fullPlaceholder",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "cssPrefix",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
         {
           "kind": "variable",
           "name": "IBANTestValues",
@@ -15346,6 +15705,22 @@
             "module": "components/input-mask/input-mask.utils.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "buildValidityState",
+          "declaration": {
+            "name": "buildValidityState",
+            "module": "components/input-mask/input-mask.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderMaskOverlay",
+          "declaration": {
+            "name": "renderMaskOverlay",
+            "module": "components/input-mask/input-mask.utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "IBANTestValues",
@@ -15898,6 +16273,17 @@
               "readonly": true,
               "default": "new LocalizeController(this)"
             },
+            {
+              "kind": "field",
+              "name": "phonePattern",
+              "privacy": "private",
+              "default": "new RegExp(defaultPhoneConfig.pattern)"
+            },
+            {
+              "kind": "field",
+              "name": "placeholderLength",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "input",
@@ -15927,7 +16313,8 @@
               "type": {
                 "text": "DSAPhoneConfig"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "default": "defaultPhoneConfig"
             },
             {
               "kind": "field",
@@ -16011,7 +16398,12 @@
             },
             {
               "kind": "method",
-              "name": "handleDocumentKeyUp",
+              "name": "syncMaskedNumber",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleInputValueChange",
               "privacy": "private"
             },
             {
@@ -16060,8 +16452,29 @@
             },
             {
               "kind": "method",
-              "name": "updatePhoneConfig",
-              "privacy": "private"
+              "name": "applyPhoneConfig",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "phonePrefix",
+                  "type": {
+                    "text": "FrenchNumberPrefix"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getPhonePrefixFromValue",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -16312,6 +16725,23 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "timeUnitArraysCache",
+              "type": {
+                "text": "{\n    displayedHours: number[];\n    displayedMinutes: number[];\n    displayedSeconds: number[];\n  } | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "timeUnitArraysCacheKey",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
             {
               "kind": "field",
               "name": "min",
@@ -16802,6 +17232,40 @@
               "readonly": true,
               "default": "new HasSlotController( this, 'prefix', 'summary' )"
             },
+            {
+              "kind": "field",
+              "name": "cachedSummaryText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "cachedSummaryWithBadgeText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "cachedMenuNavigation",
+              "type": {
+                "text": "DSAMenuNavigation | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "defaultSlot",
+              "type": {
+                "text": "HTMLSlotElement"
+              }
+            },
             {
               "kind": "field",
               "name": "summarySlot",
@@ -16908,15 +17372,18 @@
             },
             {
               "kind": "method",
-              "name": "getTextSummary",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "widthBadge",
-                  "default": "false"
-                }
-              ],
-              "description": "Returns a text label based on the contents of the summary slot."
+              "name": "updateSummaryTextCache",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleSummarySlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleBadgeSlotChange",
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -17095,7 +17562,8 @@
               "type": {
                 "text": "string"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "default": "''"
             },
             {
               "kind": "field",
@@ -17522,6 +17990,12 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "handleMutation",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "attr",
@@ -17587,19 +18061,6 @@
               "attribute": "disabled",
               "reflects": true
             },
-            {
-              "kind": "method",
-              "name": "handleMutation",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "mutationList",
-                  "type": {
-                    "text": "MutationRecord[]"
-                  }
-                }
-              ]
-            },
             {
               "kind": "method",
               "name": "startObserver",
@@ -17729,32 +18190,36 @@
           "members": [
             {
               "kind": "field",
-              "name": "navbar",
+              "name": "defaultSlot",
               "type": {
                 "text": "HTMLSlotElement"
               }
             },
             {
               "kind": "field",
-              "name": "defaultSlot",
+              "name": "currentOpenMenu",
               "type": {
-                "text": "HTMLSlotElement"
-              }
+                "text": "DSANavbarMenu | null"
+              },
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "allMenus",
+              "name": "allChildren",
               "type": {
-                "text": "DSANavbarMenu[]"
-              }
+                "text": "(DSANavbarMenu | DSANavbarLink)[]"
+              },
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "currentOpenMenu",
+              "name": "allMenus",
               "type": {
-                "text": "DSANavbarMenu | null"
+                "text": "DSANavbarMenu[]"
               },
-              "default": "null"
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
@@ -17795,12 +18260,12 @@
             },
             {
               "kind": "method",
-              "name": "getAllChildren",
+              "name": "syncChildrenMobileState",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "getAllMenus",
+              "name": "syncMobileVisibility",
               "privacy": "private"
             },
             {
@@ -18081,6 +18546,15 @@
                 "text": "HTMLElement"
               }
             },
+            {
+              "kind": "field",
+              "name": "slotLabelText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
             {
               "kind": "field",
               "name": "open",
@@ -18197,6 +18671,32 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleLabelSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getDesktopLabel",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "hasSlotLabel",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "handleOpenChange"
@@ -18853,9 +19353,30 @@
               "description": "Whether the pagination should be displayed on mobile",
               "attribute": "mobile"
             },
+            {
+              "kind": "field",
+              "name": "itemsPerPageSelect",
+              "type": {
+                "text": "DSASelect | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getPaginationButtonFromEvent",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
-              "name": "handlePageButtonClick",
+              "name": "handleNavigationClick",
               "privacy": "private",
               "parameters": [
                 {
@@ -20121,6 +20642,14 @@
                 "text": "string"
               }
             },
+            {
+              "kind": "field",
+              "name": "indicatorCircumference",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "value",
@@ -20152,6 +20681,11 @@
               "description": "The progress-ring's size.",
               "attribute": "size",
               "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "getIndicatorCircumference",
+              "privacy": "private"
             }
           ],
           "attributes": [
@@ -21529,6 +22063,16 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "method",
+              "name": "getRangeDistance",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "updateSliderBackground",
@@ -23919,6 +24463,15 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "snapValues",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
             {
               "kind": "field",
               "name": "divider",
@@ -23986,6 +24539,10 @@
               "description": "One or more space-separated values at which the divider should snap. Values can be in pixels or percentages, e.g.\n`\"100px 50%\"`.",
               "attribute": "snap"
             },
+            {
+              "kind": "method",
+              "name": "handleSnapChange"
+            },
             {
               "kind": "field",
               "name": "snapThreshold",
@@ -26552,6 +27109,16 @@
               "description": "Should deselect all rows on close",
               "attribute": "deselect-all-on-close"
             },
+            {
+              "kind": "field",
+              "name": "buttonLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Custom label for the close button. Overrides the default localized label.",
+              "attribute": "button-label"
+            },
             {
               "kind": "method",
               "name": "handleClose",
@@ -26582,6 +27149,15 @@
               "default": "false",
               "description": "Should deselect all rows on close",
               "fieldName": "deselectAllOnClose"
+            },
+            {
+              "name": "button-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Custom label for the close button. Overrides the default localized label.",
+              "fieldName": "buttonLabel"
             }
           ],
           "superclass": {
@@ -31190,7 +31766,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'dsa-icon': DSAIcon, 'dsa-checkbox': DSACheckbox, 'dsa-spinner': DSASpinner, }"
+              "default": "{ 'dsa-icon': DSAIcon, 'dsa-spinner': DSASpinner, }"
             },
             {
               "kind": "method",
@@ -31537,7 +32113,7 @@
   ],
   "package": {
     "name": "@ds-autonomie/web-components",
-    "version": "2.19.0",
+    "version": "2.21.0",
     "author": "CNSA",
     "homepage": "https://dsa.service-public-autonomie.fr",
     "license": "MIT"