@maggioli-design-system/magma 2.0.0-alpha.1 → 2.0.0-beta.2

package/dist/collection/components/mds-icon/services/icons-set.service.js

@@ -1,5 +1,10 @@
 import { get, set, del } from "idb-keyval";
 import { MdsIconSet } from "../meta/icon-set";
+// Shared, cross-realm key for the configured SVG base path. Stencil emits several bundled
+// copies of this singleton (lazy chunks, the esm/esm-es5 variants, dist/components, and the
+// public `services` entry); `Symbol.for` returns the same symbol in every copy, so storing
+// the path under it on `globalThis` gives them all one source of truth.
+const SVG_PATH_GLOBAL = Symbol.for('@maggioli-design-system/magma:mdsIconSvgPath');
 class IconsSetController {
     constructor() {
         this._svgPathKey = 'mdsIconSvgPath';
@@ -41,6 +46,20 @@ class IconsSetController {
         };
         this.setUpListener();
     }
+    // Backed by `globalThis` (see SVG_PATH_GLOBAL) rather than an instance field, so that every
+    // bundled copy of this singleton reads/writes the same path and stays in sync regardless of
+    // how the consumer imports the service. No sessionStorage involved.
+    get _svgPath() {
+        var _a;
+        if (typeof globalThis === 'undefined')
+            return '';
+        return (_a = globalThis[SVG_PATH_GLOBAL]) !== null && _a !== void 0 ? _a : '';
+    }
+    set _svgPath(value) {
+        if (typeof globalThis === 'undefined')
+            return;
+        globalThis[SVG_PATH_GLOBAL] = value;
+    }
     addIconSet(name, path, resolveIconName) {
         let resolveFunction = resolveIconName;
         const existingSet = this._iconsSets.get(name);
@@ -111,7 +130,20 @@ class IconsSetController {
                 throw Error('Cant find svgPath, ensure you set it');
             }
             if (!this._svgPath) {
-                this.setSvgPath((_a = window.sessionStorage.getItem(IconsSetService._svgPathKey)) !== null && _a !== void 0 ? _a : '');
+                // Optional, backward-compatible fallback. Some browsers/contexts block or throw
+                // on sessionStorage (incognito, sandboxed iframes, storage partitioning): treat
+                // that as "no path from storage" instead of aborting the fetch, and rely on a
+                // programmatic IconsSetService.setSvgPath() call instead.
+                let storedSvgPath = '';
+                try {
+                    storedSvgPath = (_a = window.sessionStorage.getItem(IconsSetService._svgPathKey)) !== null && _a !== void 0 ? _a : '';
+                }
+                catch (_b) {
+                    /* sessionStorage unavailable — ignore */
+                }
+                if (storedSvgPath) {
+                    this.setSvgPath(storedSvgPath);
+                }
             }
             const src = this._svgPath && !name.startsWith('http') ? this._svgPath.concat(name, '.svg') : name;
             const lsCache = await this.isCacheAvailable(src);

package/dist/collection/components/mds-img/mds-img.js

@@ -65,7 +65,7 @@ export class MdsImg {
             return imageConsumptionData;
         };
         this.autoAltName = () => {
-            if (this.src) {
+            if (this.src !== '') {
                 const index = this.src.lastIndexOf('/') + 1;
                 return this.src.substring(index);
             }
@@ -75,6 +75,9 @@ export class MdsImg {
             setAttributeIfEmpty(this.host, 'aria-label', this.alt);
         };
     }
+    /**
+     * Updates the component's texts to the locale currently set on the host element.
+     */
     async updateLang() {
         this.language = this.t.lang(this.host);
     }
@@ -88,11 +91,11 @@ export class MdsImg {
         var _a;
         this.consumptionMode =
             (_a = localStorage.getItem('mdsPrefConsumption')) !== null && _a !== void 0 ? _a : 'high';
-        if (this.srcsetConsumption) {
+        if (this.srcsetConsumption !== undefined && this.srcsetConsumption !== '') {
             this.srcsetConsumptionData = this.formatConsumptionData(this.srcsetConsumption);
         }
         this.image = this.host.querySelector('img');
-        if (!this.alt) {
+        if (this.alt === '') {
             this.alt = this.autoAltName();
         }
     }
@@ -161,7 +164,8 @@ export class MdsImg {
                         "CrossoriginType": {
                             "location": "import",
                             "path": "./meta/types",
-                            "id": "src/components/mds-img/meta/types.ts::CrossoriginType"
+                            "id": "src/components/mds-img/meta/types.ts::CrossoriginType",
+                            "referenceLocation": "CrossoriginType"
                         }
                     }
                 },
@@ -206,7 +210,8 @@ export class MdsImg {
                         "LoadingType": {
                             "location": "import",
                             "path": "@type/loading",
-                            "id": "src/type/loading.ts::LoadingType"
+                            "id": "src/type/loading.ts::LoadingType",
+                            "referenceLocation": "LoadingType"
                         }
                     }
                 },
@@ -232,7 +237,8 @@ export class MdsImg {
                         "ReferrerpolicyType": {
                             "location": "import",
                             "path": "./meta/types",
-                            "id": "src/components/mds-img/meta/types.ts::ReferrerpolicyType"
+                            "id": "src/components/mds-img/meta/types.ts::ReferrerpolicyType",
+                            "referenceLocation": "ReferrerpolicyType"
                         }
                     }
                 },
@@ -370,7 +376,8 @@ export class MdsImg {
                         "MdsImgEventDetail": {
                             "location": "import",
                             "path": "./meta/event-detail",
-                            "id": "src/components/mds-img/meta/event-detail.ts::MdsImgEventDetail"
+                            "id": "src/components/mds-img/meta/event-detail.ts::MdsImgEventDetail",
+                            "referenceLocation": "MdsImgEventDetail"
                         }
                     }
                 }
@@ -391,7 +398,8 @@ export class MdsImg {
                         "MdsImgEventDetail": {
                             "location": "import",
                             "path": "./meta/event-detail",
-                            "id": "src/components/mds-img/meta/event-detail.ts::MdsImgEventDetail"
+                            "id": "src/components/mds-img/meta/event-detail.ts::MdsImgEventDetail",
+                            "referenceLocation": "MdsImgEventDetail"
                         }
                     }
                 }
@@ -412,7 +420,7 @@ export class MdsImg {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Updates the component's texts to the locale currently set on the host element.",
                     "tags": []
                 }
             }

package/dist/collection/components/mds-input/mds-input.js

@@ -82,7 +82,7 @@ export class MdsInput {
         this.value = '';
         this.countMaxLength = () => {
             var _a, _b, _c;
-            if (!this.maxlength)
+            if (this.maxlength === undefined || this.maxlength === 0 || Number.isNaN(this.maxlength))
                 return;
             if (this.value === undefined)
                 return;
@@ -170,7 +170,7 @@ export class MdsInput {
         };
         this.startRecognition = () => {
             var _a, _b, _c;
-            if (!this.speechButton) {
+            if (this.speechButton == null) {
                 this.speechButton = (_b = (_a = this.el) === null || _a === void 0 ? void 0 : _a.shadowRoot) === null || _b === void 0 ? void 0 : _b.querySelector('.mic-toggle-button');
             }
             const SpeechRecognition = 
@@ -214,6 +214,9 @@ export class MdsInput {
             }
         };
     }
+    /**
+     * Updates the component's texts to the locale currently set on the host element.
+     */
     async updateLang() {
         this.language = this.t.lang(this.el);
         this.t.update();
@@ -239,7 +242,7 @@ export class MdsInput {
         }
         this.internals.setFormValue((_a = this.value) !== null && _a !== void 0 ? _a : null);
         this.maxLengthChanged(this.maxlength);
-        this.isValid = !(this.required && !this.value);
+        this.isValid = !(this.required && this.value === '');
     }
     componentDidLoad() {
         var _a, _b, _c;
@@ -254,13 +257,13 @@ export class MdsInput {
     setValidators() {
         if (this.required)
             this.inputValidation.validator.addValidator(requiredValidor);
-        if (this.max !== '' && Number(this.max))
+        if (this.max !== '' && Number(this.max) !== 0 && !Number.isNaN(Number(this.max)))
             this.inputValidation.validator.addValidator(maxValidator(Number(this.max)));
-        if (this.min !== '' && Number(this.min))
+        if (this.min !== '' && Number(this.min) !== 0 && !Number.isNaN(Number(this.min)))
             this.inputValidation.validator.addValidator(minValidator(Number(this.max)));
-        if (this.maxlength)
+        if (this.maxlength !== undefined && this.maxlength !== 0 && !Number.isNaN(this.maxlength))
             this.inputValidation.validator.addValidator(maxLenghtValidator(this.maxlength));
-        if (this.minlength)
+        if (this.minlength !== undefined && this.minlength !== 0 && !Number.isNaN(this.minlength))
             this.inputValidation.validator.addValidator(minLenghtValidator(this.minlength));
     }
     /**
@@ -293,10 +296,18 @@ export class MdsInput {
         }
         this.countMaxLength();
     }
+    /**
+     * Adds a validator to the input.
+     * @param validator the validator function to add
+     */
     async addValidator(validator) {
         this.inputValidation.validator.addValidator(validator);
         return Promise.resolve();
     }
+    /**
+     * Removes a previously added validator from the input.
+     * @param validator the validator function to remove
+     */
     async removeValidator(validator) {
         this.inputValidation.validator.removeValidator(validator);
     }
@@ -308,6 +319,10 @@ export class MdsInput {
     async hasValidator(validator) {
         return this.inputValidation.validator.hasValidator(validator);
     }
+    /**
+     * Returns the current validation errors, or `null` if the value is valid.
+     * @returns the validation errors, or `null` when valid
+     */
     async getErrors() {
         return Promise.resolve(this.inputValidation.validator.errors);
     }
@@ -355,9 +370,9 @@ export class MdsInput {
     }
     render() {
         var _a, _b, _c;
-        return (h(Host, { key: '63efd28d71e55c73c829a0dd566f62e735bb6736' }, this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: 'c7730f2bb6457570a922004478025712bbe0569c', class: "counter-button counter-button--horizontal counter-button--decrease", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", tone: "text", part: "counter-button-decrease" })), this.type === 'textarea' ? (h("textarea", { class: clsx('input', ((_a = this.icon) !== null && _a !== void 0 ? _a : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoFocus: this.autofocus, disabled: this.disabled, maxLength: this.maxlength, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, tabIndex: this.tabindex, value: this.value })) : (h("input", { class: clsx('input', ((_b = this.icon) !== null && _b !== void 0 ? _b : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoComplete: this.autocomplete, autoFocus: this.autofocus, disabled: this.disabled, max: this.max, maxLength: this.maxlength, min: this.min, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, pattern: this.pattern, list: this.datalistId, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, step: this.step, tabIndex: this.tabindex, type: this.type === 'password' && this.isPasswordVisible ? 'text' : this.type, value: this.value })), this.type === 'number' && this.controlsLayout === 'vertical' && (h("div", { key: 'a11a1cdf049cfdbed17dc25b3d361d61e65fbfa3', class: "counter counter--vertical" }, h("mds-button", { key: '9456eac1d48a91187911f429f321a30a9f303b82', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), variant: "dark", size: "sm", tone: "text", part: "counter-button-increase" }), h("mds-button", { key: 'c29f7bdd570957db6055898dd0af0dd1525d98b0', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", size: "sm", tone: "text", part: "counter-button-decrease" }))), this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: '3d755f49f8464bfe4f6f7ca9e85157db825c3905', class: "counter-button counter-button--horizontal counter-button--increase", variant: "dark", tone: "text", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), part: "counter-button-increase" })), this.type === 'password' && (h("mds-button", { key: '6641194c7b448b1d27f806c52c7cd011c0ae3ad5', class: "password-toggle-button", variant: "dark", tone: "text", icon: this.isPasswordVisible ? miBaselineVisibleOff : miBaselineVisible, onClick: () => (this.isPasswordVisible = !this.isPasswordVisible), tabindex: "0", title: this.isPasswordVisible ? this.t.get('hidePassword') : this.t.get('showPassword'), part: "password-toggle-button" })), this.type === 'password' && !this.isPasswordVisible && ((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) > 0 && (h("div", { key: 'be0a893b00483e43582ebe1cbdf2de78ea9fdd1b', class: "password-mask" }, h("div", { key: '7ac73065205c17a04132d2076e768387f25c9164', class: "password-mask-items", part: "password-mask-items" }, Array.from({ length: this.value.length }).map((_, index) => (h("div", { key: index, class: "password-mask-item", part: "password-mask-item" })))))), this.mic && (h("mds-button", { key: '6fdca5aca12eb56670883c2fa414802f9c6eb32f', class: clsx('mic-toggle-button', this.isRecording && 'mic-toggle-button--recording'), icon: this.speechToTextIcon, onClick: () => this.toggleTextRecognition(), tabindex: "0", title: this.speechToTextLabel, variant: "dark", tone: "text", part: "mic-toggle-button" })), h("mds-input-tip", { key: 'ab202ab518990cb89eeaf6e2aaf0d51f0b701f05', lang: this.language, position: "top", active: this.hasFocus, part: "tip-top" }, this.disabled && h("mds-input-tip-item", { key: '76011dab3a8cf3fb65329be96e53748a86e17246', expanded: true, variant: "disabled" }), this.readonly && h("mds-input-tip-item", { key: '97a9d42fe7b76c4da7cc58c8cbb1135e635004e5', expanded: true, variant: "readonly" }), this.required && (h("mds-input-tip-item", { key: 'ccd9e6849514e7b6b8d556fffd5c0d8d2289ad08', expanded: this.hasFocus, variant: this.isValid ? 'required-success' : 'required' }))), h("mds-input-tip", { key: 'db35b767d1030dfbea345de28279770e9b1e8293', lang: this.language, position: "bottom", active: this.hasFocus, part: "tip-bottom" }, this.tip && (h("mds-input-tip-item", { key: '31d65280cbd8b23e61e485c5afef05c00134d00e', expanded: true, variant: "text" }, this.tip)), this.maxlength && (h("mds-input-tip-item", { key: '3da21c408e5a10820ab5f3ee2ec0513546e58bd7', part: "tip-count", expanded: true, variant: this.countVariant }, this.currentLengthLabel))), this.datalist && (h("datalist", { key: '7aaf629292a7f31c54c260367e5ee3ca66dce889', id: this.datalistId, class: "datalist" }, this.datalist.map((element, i) => {
+        return (h(Host, { key: 'ad6a22b8162d976d62a9991054934c71c218c500' }, this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: '68c91a11f6c37cea5e21c9695522e45213050d45', class: "counter-button counter-button--horizontal counter-button--decrease", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", tone: "text", part: "counter-button-decrease" })), this.type === 'textarea' ? (h("textarea", { class: clsx('input', ((_a = this.icon) !== null && _a !== void 0 ? _a : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoFocus: this.autofocus, disabled: this.disabled, maxLength: this.maxlength, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, tabIndex: this.tabindex, value: this.value })) : (h("input", { class: clsx('input', ((_b = this.icon) !== null && _b !== void 0 ? _b : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoComplete: this.autocomplete, autoFocus: this.autofocus, disabled: this.disabled, max: this.max, maxLength: this.maxlength, min: this.min, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, pattern: this.pattern, list: this.datalistId, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, step: this.step, tabIndex: this.tabindex, type: this.type === 'password' && this.isPasswordVisible ? 'text' : this.type, value: this.value })), this.type === 'number' && this.controlsLayout === 'vertical' && (h("div", { key: 'fd2b20e2a3ed42a61b6728fcadfd305f34c6a446', class: "counter counter--vertical" }, h("mds-button", { key: '48a253a2ca7e4ee58228c0a6df600ef366e984cc', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), variant: "dark", size: "sm", tone: "text", part: "counter-button-increase" }), h("mds-button", { key: '0a6b850aae842b24dc4f7ef8988a75990de136aa', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", size: "sm", tone: "text", part: "counter-button-decrease" }))), this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: 'ea3e0594d7a31601bbe20cc4e38afd4bec6cdff7', class: "counter-button counter-button--horizontal counter-button--increase", variant: "dark", tone: "text", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), part: "counter-button-increase" })), this.type === 'password' && (h("mds-button", { key: 'bf34d6df82fc3e960fbcbc3067d92b433b42accd', class: "password-toggle-button", variant: "dark", tone: "text", icon: this.isPasswordVisible ? miBaselineVisibleOff : miBaselineVisible, onClick: () => (this.isPasswordVisible = !this.isPasswordVisible), tabindex: "0", title: this.isPasswordVisible ? this.t.get('hidePassword') : this.t.get('showPassword'), part: "password-toggle-button" })), this.type === 'password' && !this.isPasswordVisible && ((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) > 0 && (h("div", { key: '99ec0f020348a5de910ab91fd42e1bd4484e4aff', class: "password-mask" }, h("div", { key: '3551407dcbde2547391f940c3a010a7c0855ef85', class: "password-mask-items", part: "password-mask-items" }, Array.from({ length: this.value.length }).map((_, index) => (h("div", { key: index, class: "password-mask-item", part: "password-mask-item" })))))), this.mic && (h("mds-button", { key: '49dbb6cffac109437ac5de7357a1a995d9c9d22f', class: clsx('mic-toggle-button', this.isRecording && 'mic-toggle-button--recording'), icon: this.speechToTextIcon, onClick: () => this.toggleTextRecognition(), tabindex: "0", title: this.speechToTextLabel, variant: "dark", tone: "text", part: "mic-toggle-button" })), h("mds-input-tip", { key: 'a81de1242c891bc7a82d6a213e854af3b7f7e6b6', lang: this.language, position: "top", active: this.hasFocus, part: "tip-top" }, this.disabled && h("mds-input-tip-item", { key: 'b6ec44b88905eded511cf192504853c5e7eaa287', expanded: true, variant: "disabled" }), this.readonly && h("mds-input-tip-item", { key: 'ce523b25baf2300715d12b5bef5c0842d2a19fd9', expanded: true, variant: "readonly" }), this.required && (h("mds-input-tip-item", { key: '7aa2b62701797678d32bdb43f7c0d3c0da47443c', expanded: this.hasFocus, variant: this.isValid ? 'required-success' : 'required' }))), h("mds-input-tip", { key: '17cf961c116164a7266e5541693dc00435b72e16', lang: this.language, position: "bottom", active: this.hasFocus, part: "tip-bottom" }, this.tip && (h("mds-input-tip-item", { key: 'e604b97d70fd47ee4a9681272a1a95f1aafc3a82', expanded: true, variant: "text" }, this.tip)), this.maxlength && (h("mds-input-tip-item", { key: '572470935113d9182e9d96c0ef743d4c30ffbf22', part: "tip-count", expanded: true, variant: this.countVariant }, this.currentLengthLabel))), this.datalist && (h("datalist", { key: '1501e7a01bc73103691be34570420ab8f2601e75', id: this.datalistId, class: "datalist" }, this.datalist.map((element, i) => {
             return h("option", { key: i, value: element });
-        }))), this.icon && !this.await && (h("mds-icon", { key: '237c929482c18f7a52fdf7b9e82c5bce509f73b0', class: clsx('icon', this.variant), name: this.icon })), h("mds-spinner", { key: '33902197107e138f7eed71b59f05d46f077762a3', running: this.await, class: clsx('await', this.variant) })));
+        }))), this.icon && !this.await && (h("mds-icon", { key: '5e3eb451e9d1bbc2d1c2c253c8baa80b5ba8a9ed', class: clsx('icon', this.variant), name: this.icon })), h("mds-spinner", { key: 'f0606534fb2a0b698a28548d48352e5429302d1b', running: this.await, class: clsx('await', this.variant) })));
     }
     static get is() { return "mds-input"; }
     static get encapsulation() { return "shadow"; }
@@ -379,12 +394,13 @@ export class MdsInput {
                 "mutable": false,
                 "complexType": {
                     "original": "AutocompleteType",
-                    "resolved": "\"address\" | \"email\" | \"additional-name\" | \"address-level1\" | \"address-level2\" | \"address-level3\" | \"address-level4\" | \"address-line1\" | \"address-line2\" | \"address-line3\" | \"bday\" | \"bday-day\" | \"bday-month\" | \"bday-year\" | \"cc-additional-name\" | \"cc-csc\" | \"cc-exp\" | \"cc-exp-month\" | \"cc-exp-year\" | \"cc-family-name\" | \"cc-given-name\" | \"cc-name\" | \"cc-number\" | \"cc-type\" | \"country\" | \"country-name\" | \"current-password\" | \"family-name\" | \"given-name\" | \"honorific-prefix\" | \"honorific-suffix\" | \"impp\" | \"language\" | \"name\" | \"new-password\" | \"nickname\" | \"off\" | \"on\" | \"one-time-code\" | \"organization\" | \"organization-title\" | \"photo\" | \"postal-code\" | \"sex\" | \"street-address\" | \"tel\" | \"tel-area-code\" | \"tel-country-code\" | \"tel-extension\" | \"tel-local\" | \"tel-national\" | \"transaction-amount\" | \"transaction-currency\" | \"url\" | \"username\" | undefined",
+                    "resolved": "\"additional-name\" | \"address\" | \"address-level1\" | \"address-level2\" | \"address-level3\" | \"address-level4\" | \"address-line1\" | \"address-line2\" | \"address-line3\" | \"bday\" | \"bday-day\" | \"bday-month\" | \"bday-year\" | \"cc-additional-name\" | \"cc-csc\" | \"cc-exp\" | \"cc-exp-month\" | \"cc-exp-year\" | \"cc-family-name\" | \"cc-given-name\" | \"cc-name\" | \"cc-number\" | \"cc-type\" | \"country\" | \"country-name\" | \"current-password\" | \"email\" | \"family-name\" | \"given-name\" | \"honorific-prefix\" | \"honorific-suffix\" | \"impp\" | \"language\" | \"name\" | \"new-password\" | \"nickname\" | \"off\" | \"on\" | \"one-time-code\" | \"organization\" | \"organization-title\" | \"photo\" | \"postal-code\" | \"sex\" | \"street-address\" | \"tel\" | \"tel-area-code\" | \"tel-country-code\" | \"tel-extension\" | \"tel-local\" | \"tel-national\" | \"transaction-amount\" | \"transaction-currency\" | \"url\" | \"username\" | undefined",
                     "references": {
                         "AutocompleteType": {
                             "location": "import",
                             "path": "@type/autocomplete",
-                            "id": "src/type/autocomplete.ts::AutocompleteType"
+                            "id": "src/type/autocomplete.ts::AutocompleteType",
+                            "referenceLocation": "AutocompleteType"
                         }
                     }
                 },
@@ -450,7 +466,8 @@ export class MdsInput {
                         "InputControlsLayoutType": {
                             "location": "import",
                             "path": "@type/input",
-                            "id": "src/type/input.ts::InputControlsLayoutType"
+                            "id": "src/type/input.ts::InputControlsLayoutType",
+                            "referenceLocation": "InputControlsLayoutType"
                         }
                     }
                 },
@@ -476,7 +493,8 @@ export class MdsInput {
                         "InputControlsIconType": {
                             "location": "import",
                             "path": "@type/input",
-                            "id": "src/type/input.ts::InputControlsIconType"
+                            "id": "src/type/input.ts::InputControlsIconType",
+                            "referenceLocation": "InputControlsIconType"
                         }
                     }
                 },
@@ -750,7 +768,8 @@ export class MdsInput {
                         "ThemeInputVariantType": {
                             "location": "import",
                             "path": "@type/variant",
-                            "id": "src/type/variant.ts::ThemeInputVariantType"
+                            "id": "src/type/variant.ts::ThemeInputVariantType",
+                            "referenceLocation": "ThemeInputVariantType"
                         }
                     }
                 },
@@ -814,7 +833,8 @@ export class MdsInput {
                         "InputTextType": {
                             "location": "import",
                             "path": "@type/input",
-                            "id": "src/type/input.ts::InputTextType"
+                            "id": "src/type/input.ts::InputTextType",
+                            "referenceLocation": "InputTextType"
                         }
                     }
                 },
@@ -840,7 +860,8 @@ export class MdsInput {
                         "TypographyInputType": {
                             "location": "import",
                             "path": "@type/typography",
-                            "id": "src/type/typography.ts::TypographyInputType"
+                            "id": "src/type/typography.ts::TypographyInputType",
+                            "referenceLocation": "TypographyInputType"
                         }
                     }
                 },
@@ -906,7 +927,8 @@ export class MdsInput {
                         "MdsInputEventDetail": {
                             "location": "import",
                             "path": "@type/input",
-                            "id": "src/type/input.ts::MdsInputEventDetail"
+                            "id": "src/type/input.ts::MdsInputEventDetail",
+                            "referenceLocation": "MdsInputEventDetail"
                         }
                     }
                 }
@@ -1007,7 +1029,7 @@ export class MdsInput {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Updates the component's texts to the locale currently set on the host element.",
                     "tags": []
                 }
             },
@@ -1017,7 +1039,7 @@ export class MdsInput {
                     "parameters": [{
                             "name": "validator",
                             "type": "(input: string) => MdsValidationErrors | null",
-                            "docs": ""
+                            "docs": "the validator function to add"
                         }],
                     "references": {
                         "Promise": {
@@ -1027,14 +1049,18 @@ export class MdsInput {
                         "MdsValidatorFn": {
                             "location": "import",
                             "path": "./meta/validators",
-                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn"
+                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn",
+                            "referenceLocation": "MdsValidatorFn"
                         }
                     },
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": []
+                    "text": "Adds a validator to the input.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "validator the validator function to add"
+                        }]
                 }
             },
             "removeValidator": {
@@ -1043,7 +1069,7 @@ export class MdsInput {
                     "parameters": [{
                             "name": "validator",
                             "type": "(input: string) => MdsValidationErrors | null",
-                            "docs": ""
+                            "docs": "the validator function to remove"
                         }],
                     "references": {
                         "Promise": {
@@ -1053,14 +1079,18 @@ export class MdsInput {
                         "MdsValidatorFn": {
                             "location": "import",
                             "path": "./meta/validators",
-                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn"
+                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn",
+                            "referenceLocation": "MdsValidatorFn"
                         }
                     },
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": []
+                    "text": "Removes a previously added validator from the input.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "validator the validator function to remove"
+                        }]
                 }
             },
             "hasValidator": {
@@ -1079,7 +1109,8 @@ export class MdsInput {
                         "MdsValidatorFn": {
                             "location": "import",
                             "path": "./meta/validators",
-                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn"
+                            "id": "src/components/mds-input/meta/validators.ts::MdsValidatorFn",
+                            "referenceLocation": "MdsValidatorFn"
                         }
                     },
                     "return": "Promise<boolean>"
@@ -1107,14 +1138,18 @@ export class MdsInput {
                         "MdsValidationErrors": {
                             "location": "import",
                             "path": "./meta/validators",
-                            "id": "src/components/mds-input/meta/validators.ts::MdsValidationErrors"
+                            "id": "src/components/mds-input/meta/validators.ts::MdsValidationErrors",
+                            "referenceLocation": "MdsValidationErrors"
                         }
                     },
                     "return": "Promise<MdsValidationErrors | null>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": []
+                    "text": "Returns the current validation errors, or `null` if the value is valid.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "the validation errors, or `null` when valid"
+                        }]
                 }
             },
             "setFocus": {