@ds-autonomie/web-components 1.5.0 → 1.6.0

package/dist/vscode.html-custom-data.json

@@ -15,6 +15,18 @@
           "description": "The summary to show in the header. If you need to display HTML, use the `summary` slot instead.",
           "values": []
         },
+        {
+          "name": "header-level",
+          "description": "Optional aria-level of the accordion header",
+          "values": [
+            { "name": "1" },
+            { "name": "2" },
+            { "name": "3" },
+            { "name": "4" },
+            { "name": "5" },
+            { "name": "6" }
+          ]
+        },
         {
           "name": "disabled",
           "description": "Disables the accordion so it can't be toggled.",
@@ -569,7 +581,7 @@
     },
     {
       "name": "dsa-combobox",
-      "description": "Comboboxes allow you to type a value directly or select a value from a menu of predefined options. Values are filtered by checking the presence of the search term.\n\n\n---\n\n\n\n\n### **Events:**\n - **dsa-change** - Emitted when the control's value changes.\n- **dsa-input** - Emitted when the control receives input.\n- **dsa-focus** - Emitted when the control gains focus.\n- **dsa-blur** - Emitted when the control loses focus.\n- **dsa-show** - Emitted when the combobox's menu opens.\n- **dsa-after-show** - Emitted after the combobox's menu opens and all animations are complete.\n- **dsa-hide** - Emitted when the combobox's menu closes.\n- **dsa-after-hide** - Emitted after the combobox's menu closes and all animations are complete.\n- **dsa-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **dsa-load** - Emitted when the remote options have loaded.\n- **dsa-error** - Emitted when the remote options fail to load due to an error.\n\n### **Methods:**\n - **show()** - Shows the listbox.\n- **hide()** - Hides the listbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The listbox options. Must be `<dsa-option>` elements. Alternatively, you can use the `items` property.\n- **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **tooltip** - The tooltip slot allows additional information to be passed along the label",
+      "description": "Comboboxes allow you to type a value directly or select a value from a menu of predefined options. Values are filtered by checking the presence of the search term.\n\n\n---\n\n\n\n\n### **Events:**\n - **dsa-change** - Emitted when the control's value changes.\n- **dsa-input** - Emitted when the control receives input. Debounced according to `debounce-timeout` value.\n- **dsa-focus** - Emitted when the control gains focus.\n- **dsa-blur** - Emitted when the control loses focus.\n- **dsa-show** - Emitted when the combobox's menu opens.\n- **dsa-after-show** - Emitted after the combobox's menu opens and all animations are complete.\n- **dsa-hide** - Emitted when the combobox's menu closes.\n- **dsa-after-hide** - Emitted after the combobox's menu closes and all animations are complete.\n- **dsa-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **dsa-load** - Emitted when the remote options have loaded.\n- **dsa-error** - Emitted when the remote options fail to load due to an error.\n\n### **Methods:**\n - **show()** - Shows the listbox.\n- **hide()** - Hides the listbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The listbox options. Must be `<dsa-option>` elements. Alternatively, you can use the `items` property.\n- **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **tooltip** - The tooltip slot allows additional information to be passed along the label",
       "attributes": [
         {
           "name": "name",
@@ -685,8 +697,18 @@
         },
         {
           "name": "debounce-timeout",
-          "description": "Delay between when a user types into an input. It is only used when `onSearch` attribute is defined.",
+          "description": "Delay between when a user types into an input. It affects the `dsa-input` event.",
           "values": []
+        },
+        {
+          "name": "fetching-state",
+          "description": "When using asynchronous option loading, allows to specify the fetching state",
+          "values": [
+            { "name": "" },
+            { "name": "loading" },
+            { "name": "error" },
+            { "name": "success" }
+          ]
         }
       ],
       "references": []
@@ -734,6 +756,78 @@
       ],
       "references": []
     },
+    {
+      "name": "dsa-download-card",
+      "description": "Download cards allow user to download a document.\n\n\n---\n\n\n\n\n### **Events:**\n - **dsa-blur** - Emitted when the card loses focus.\n- **dsa-focus** - Emitted when the card gains focus.\n\n### **Slots:**\n - _default_ - The card's label.\n- **image** - An optional image to render at the start of the card..",
+      "attributes": [
+        {
+          "name": "href",
+          "description": "The href of the document",
+          "values": []
+        },
+        {
+          "name": "description",
+          "description": "Optional description of the file",
+          "values": []
+        },
+        {
+          "name": "format",
+          "description": "The document format",
+          "values": []
+        },
+        {
+          "name": "documentsize",
+          "description": "The document size",
+          "values": []
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "dsa-download-link",
+      "description": "Download links allow user to download a document.\n\n\n---\n\n\n\n\n### **Events:**\n - **dsa-blur** - Emitted when the link loses focus.\n- **dsa-focus** - Emitted when the link gains focus.\n\n### **Slots:**\n - _default_ - The link's label.",
+      "attributes": [
+        {
+          "name": "href",
+          "description": "The href of the document",
+          "values": []
+        },
+        {
+          "name": "format",
+          "description": "The document format",
+          "values": []
+        },
+        {
+          "name": "documentsize",
+          "description": "The document size",
+          "values": []
+        },
+        {
+          "name": "variant",
+          "description": "The link's theme variant.",
+          "values": [
+            { "name": "base" },
+            { "name": "layer" },
+            { "name": "contrasted" },
+            { "name": "floating" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The link's size.",
+          "values": [
+            { "name": "" },
+            { "name": "2xsmall" },
+            { "name": "xsmall" },
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" },
+            { "name": "xlarge" }
+          ]
+        }
+      ],
+      "references": []
+    },
     {
       "name": "dsa-drawer",
       "description": "Drawers slide in from a container to expose additional options and information.\n\n\n---\n\n\n\n\n### **Events:**\n - **dsa-show** - Emitted when the drawer opens.\n- **dsa-after-show** - Emitted after the drawer opens and all animations are complete.\n- **dsa-hide** - Emitted when the drawer closes.\n- **dsa-after-hide** - Emitted after the drawer closes and all animations are complete.\n- **dsa-initial-focus** - Emitted when the drawer opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **dsa-request-close** - Emitted when the user attempts to close the drawer by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the drawer open. Avoid using this unless closing the drawer will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the drawer.\n- **hide()** - Hides the drawer\n\n### **Slots:**\n - _default_ - The drawer's main content.\n- **label** - The drawer's label. Alternatively, you can use the `label` attribute.\n- **header-actions** - Optional actions to add to the header. Works best with `<dsa-icon-button>`.\n- **footer** - The drawer's footer, usually one or more buttons representing various options.",
@@ -822,6 +916,18 @@
       ],
       "references": []
     },
+    {
+      "name": "dsa-error-message-panel",
+      "description": "Error Message Panel can be used to display an error message when a problem has occured on the site\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The error-message-panel's title.\n- **error-code** - An optional error code element.\n- **description** - An optional error description element.\n- **actions** - An optional action element.",
+      "attributes": [
+        {
+          "name": "error-code",
+          "description": "Display the error code. If you need to display HTML, use the `error-code` slot instead.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
     {
       "name": "dsa-error-text",
       "description": "Error Text can be used to display an error message under an input or a fieldset\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The error-text's main content.",
@@ -2182,7 +2288,7 @@
     },
     {
       "name": "dsa-skip-link-item",
-      "description": "Skip link item define an hyperlink within a [skip-link](/components/skip-link)\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The skip-link-item's label",
+      "description": "Skip link item define an hyperlink within a [skip-link](/components/skip-link)\n\n\n---\n\n\n\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the anchor.\n- **blur()** - Removes focus from the anchor.\n\n### **Slots:**\n - _default_ - The skip-link-item's label",
       "attributes": [
         {
           "name": "href",

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/web-types",
   "name": "@ds-autonomie/web-components",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description-markup": "markdown",
   "framework-config": {
     "enable-when": {
@@ -29,7 +29,7 @@
                 }
               },
               {
-                "name": "header",
+                "name": "headerButton",
                 "value": {
                   "type": "HTMLElement"
                 }
@@ -54,6 +54,13 @@
                   "type": "string"
                 }
               },
+              {
+                "name": "headerLevel",
+                "description": "Optional aria-level of the accordion header",
+                "value": {
+                  "type": "1 | 2 | 3 | 4 | 5 | 6"
+                }
+              },
               {
                 "name": "disabled",
                 "description": "Disables the accordion so it can't be toggled.",
@@ -125,6 +132,13 @@
                 "type": "string"
               }
             },
+            {
+              "name": "header-level",
+              "description": "Optional aria-level of the accordion header",
+              "value": {
+                "type": "1 | 2 | 3 | 4 | 5 | 6"
+              }
+            },
             {
               "name": "disabled",
               "description": "Disables the accordion so it can't be toggled.",
@@ -2052,12 +2066,6 @@
                   "type": "boolean"
                 }
               },
-              {
-                "name": "fetchingState",
-                "value": {
-                  "type": "'loading' | 'error' | 'success'"
-                }
-              },
               {
                 "name": "displayLabel",
                 "value": {
@@ -2088,6 +2096,12 @@
                   "type": "DSAOption[]"
                 }
               },
+              {
+                "name": "debounceTimerId",
+                "value": {
+                  "type": "NodeJS.Timeout | null"
+                }
+              },
               {
                 "name": "name",
                 "description": "The name of the combobox, submitted as a name/value pair with form data.",
@@ -2242,17 +2256,17 @@
                 }
               },
               {
-                "name": "onSearch",
-                "description": "This function searches for a list of remote options based on the inputed text.",
+                "name": "debounceTimeout",
+                "description": "Delay between when a user types into an input. It affects the `dsa-input` event.",
                 "value": {
-                  "type": "| ((\n        value: string,\n        selectedOptions: string[]\n      ) => DSAOption[] | Promise<DSAOption[]>)\n    | undefined"
+                  "type": "number"
                 }
               },
               {
-                "name": "debounceTimeout",
-                "description": "Delay between when a user types into an input. It is only used when `onSearch` attribute is defined.",
+                "name": "fetchingState",
+                "description": "When using asynchronous option loading, allows to specify the fetching state",
                 "value": {
-                  "type": "number"
+                  "type": "| 'loading'\n    | 'error'\n    | 'success'"
                 }
               },
               {
@@ -2290,14 +2304,6 @@
                 "name": "handleInput",
                 "value": {}
               },
-              {
-                "name": "filterRemoteOptions",
-                "value": {}
-              },
-              {
-                "name": "asyncFetchOptions",
-                "value": {}
-              },
               {
                 "name": "handleClearClick",
                 "value": {}
@@ -2326,10 +2332,6 @@
                 "name": "getAllOptions",
                 "value": {}
               },
-              {
-                "name": "getRemoteOptions",
-                "value": {}
-              },
               {
                 "name": "clearSelectedOptions",
                 "value": {}
@@ -2455,7 +2457,7 @@
               },
               {
                 "name": "dsa-input",
-                "description": "Emitted when the control receives input."
+                "description": "Emitted when the control receives input. Debounced according to `debounce-timeout` value."
               },
               {
                 "name": "dsa-focus",
@@ -2638,10 +2640,17 @@
             },
             {
               "name": "debounce-timeout",
-              "description": "Delay between when a user types into an input. It is only used when `onSearch` attribute is defined.",
+              "description": "Delay between when a user types into an input. It affects the `dsa-input` event.",
               "value": {
                 "type": "number"
               }
+            },
+            {
+              "name": "fetching-state",
+              "description": "When using asynchronous option loading, allows to specify the fetching state",
+              "value": {
+                "type": "| 'loading'\n    | 'error'\n    | 'success'"
+              }
             }
           ]
         },
@@ -2830,6 +2839,188 @@
             }
           ]
         },
+        {
+          "name": "dsa-download-card",
+          "description": "",
+          "js": {
+            "properties": [
+              {
+                "name": "href",
+                "description": "The href of the document",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "description",
+                "description": "Optional description of the file",
+                "value": {
+                  "type": "string | undefined"
+                }
+              },
+              {
+                "name": "format",
+                "description": "The document format",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "documentSize",
+                "description": "The document size",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "handleFocus",
+                "value": {}
+              },
+              {
+                "name": "handleBlur",
+                "value": {}
+              }
+            ],
+            "events": [
+              {
+                "name": "dsa-blur",
+                "description": "Emitted when the card loses focus."
+              },
+              {
+                "name": "dsa-focus",
+                "description": "Emitted when the card gains focus."
+              }
+            ]
+          },
+          "attributes": [
+            {
+              "name": "href",
+              "description": "The href of the document",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "description",
+              "description": "Optional description of the file",
+              "value": {
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "format",
+              "description": "The document format",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "documentsize",
+              "description": "The document size",
+              "value": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        {
+          "name": "dsa-download-link",
+          "description": "",
+          "js": {
+            "properties": [
+              {
+                "name": "href",
+                "description": "The href of the document",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "format",
+                "description": "The document format",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "documentSize",
+                "description": "The document size",
+                "value": {
+                  "type": "string"
+                }
+              },
+              {
+                "name": "variant",
+                "description": "The link's theme variant.",
+                "value": {
+                  "type": "'base' | 'layer' | 'contrasted' | 'floating'"
+                }
+              },
+              {
+                "name": "size",
+                "description": "The link's size.",
+                "value": {
+                  "type": "| '2xsmall'\n    | 'xsmall'\n    | 'small'\n    | 'medium'\n    | 'large'\n    | 'xlarge'"
+                }
+              },
+              {
+                "name": "handleFocus",
+                "value": {}
+              },
+              {
+                "name": "handleBlur",
+                "value": {}
+              }
+            ],
+            "events": [
+              {
+                "name": "dsa-blur",
+                "description": "Emitted when the link loses focus."
+              },
+              {
+                "name": "dsa-focus",
+                "description": "Emitted when the link gains focus."
+              }
+            ]
+          },
+          "attributes": [
+            {
+              "name": "href",
+              "description": "The href of the document",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "format",
+              "description": "The document format",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "documentsize",
+              "description": "The document size",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "variant",
+              "description": "The link's theme variant.",
+              "value": {
+                "type": "'base' | 'layer' | 'contrasted' | 'floating'"
+              }
+            },
+            {
+              "name": "size",
+              "description": "The link's size.",
+              "value": {
+                "type": "| '2xsmall'\n    | 'xsmall'\n    | 'small'\n    | 'medium'\n    | 'large'\n    | 'xlarge'"
+              }
+            }
+          ]
+        },
         {
           "name": "dsa-drawer",
           "description": "",
@@ -3228,6 +3419,39 @@
             }
           ]
         },
+        {
+          "name": "dsa-error-message-panel",
+          "description": "",
+          "js": {
+            "properties": [
+              {
+                "name": "localize",
+                "value": {}
+              },
+              {
+                "name": "hasSlotController",
+                "value": {}
+              },
+              {
+                "name": "errorCode",
+                "description": "Display the error code. If you need to display HTML, use the `error-code` slot instead.",
+                "value": {
+                  "type": "string"
+                }
+              }
+            ],
+            "events": []
+          },
+          "attributes": [
+            {
+              "name": "error-code",
+              "description": "Display the error code. If you need to display HTML, use the `error-code` slot instead.",
+              "value": {
+                "type": "string"
+              }
+            }
+          ]
+        },
         {
           "name": "dsa-error-text",
           "description": "",
@@ -8014,6 +8238,12 @@
           "description": "",
           "js": {
             "properties": [
+              {
+                "name": "anchor",
+                "value": {
+                  "type": "HTMLAnchorElement"
+                }
+              },
               {
                 "name": "href",
                 "description": "Specifies the URL of the page or the section the link goes to.",
@@ -8028,6 +8258,16 @@
               {
                 "name": "handleBlur",
                 "value": {}
+              },
+              {
+                "name": "focus",
+                "description": "Sets focus on the anchor.",
+                "value": {}
+              },
+              {
+                "name": "blur",
+                "description": "Removes focus from the anchor.",
+                "value": {}
               }
             ],
             "events": []
@@ -8056,6 +8296,10 @@
               {
                 "name": "getAllLinks",
                 "value": {}
+              },
+              {
+                "name": "handleDefaultSlotChange",
+                "value": {}
               }
             ],
             "events": []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ds-autonomie/web-components",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "author": "CNSA",
   "license": "MIT",
   "customElements": "dist/custom-elements.json",
@@ -45,7 +45,7 @@
     "lit": "2.8.0"
   },
   "peerDependencies": {
-    "@ds-autonomie/assets": "1.1.1"
+    "@ds-autonomie/assets": "1.2.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "0.8.4",

package/dist/chunks/chunk.HRBNFVC5.js

@@ -1,16 +0,0 @@
-// src/utilities/debounce.ts
-function debounce(fn, time) {
-  let timerId = void 0;
-  return function debounceFn(search, selectedOptions) {
-    if (timerId !== void 0) {
-      clearTimeout(timerId);
-    }
-    return new Promise((resolve) => {
-      timerId = setTimeout(() => resolve(fn(search, selectedOptions)), time);
-    });
-  };
-}
-
-export {
-  debounce
-};

package/dist/utilities/debounce.d.ts

@@ -1 +0,0 @@
-export declare function debounce<T>(fn: (search: string, selectedOptions: string[]) => T | Promise<T>, time: number): (search: string, selectedOptions: string[]) => Promise<T>;

package/dist/utilities/debounce.js

@@ -1,7 +0,0 @@
-import {
-  debounce
-} from "../chunks/chunk.HRBNFVC5.js";
-import "../chunks/chunk.6M63UXML.js";
-export {
-  debounce
-};