@telesign/boreal-web-components 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/esm/bds-tag.entry.js

@@ -0,0 +1,138 @@
+import { r as registerInstance, c as createEvent, h, F as Fragment, a as Host, g as getElement } from './index-BqJlOB6b.js';
+import { c as createId } from './BaseAttributes-DhSchGPI.js';
+import { v as validatePropValue } from './validateProps-kGnB15Lz.js';
+
+const TAG_COLORS = {
+    GRAY: 'gray',
+    CYAN: 'cyan',
+    TEAL: 'teal',
+    LIME: 'lime',
+    ORANGE: 'orange',
+    COBALT: 'cobalt',
+    ROSE: 'rose',
+    PURPLE: 'purple',
+};
+
+const bdsTagCss = () => `@charset "UTF-8";.bds-tag{display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;vertical-align:middle;gap:var(--boreal-spacing-3xs);padding:var(--boreal-spacing-3xs) var(--boreal-spacing-3xs) var(--boreal-spacing-3xs) var(--boreal-spacing-2xs);border-radius:var(--boreal-radius-m);cursor:default;max-width:100%;min-width:0;font-family:var(--boreal-typography-font-family-primary);font-size:var(--boreal-typography-font-size-xs);font-weight:var(--boreal-typography-font-weight-semibold);line-height:var(--boreal-typography-line-height-xs)}.bds-tag:hover:not(.bds-tag--selected):not(.bds-tag--disabled){-webkit-box-shadow:0 1px 2px 0 rgba(19, 19, 22, 0.15);box-shadow:0 1px 2px 0 rgba(19, 19, 22, 0.15)}.bds-tag:focus:not(.bds-tag--selected){outline:none;-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus);box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus)}.bds-tag--selected{outline:none;-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset;box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset}.bds-tag__icon{font-size:var(--boreal-typography-font-size-md);max-height:var(--boreal-spacing-m)}.bds-tag__icon:empty{display:none}.bds-tag__text{margin-right:var(--boreal-spacing-2xs);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.bds-tag__close-button{display:-ms-flexbox;display:flex;padding:var(--boreal-spacing-3xs);width:var(--boreal-spacing-s);height:var(--boreal-spacing-s);-webkit-box-sizing:content-box;box-sizing:content-box;border-radius:var(--boreal-radius-full);border:0px solid transparent;background-color:transparent;opacity:0.5;cursor:pointer}.bds-tag__close-button:hover{-webkit-box-shadow:0 1px 2px 0 rgba(19, 19, 22, 0.15);box-shadow:0 1px 2px 0 rgba(19, 19, 22, 0.15);background-color:var(--boreal-ui-inverse);opacity:0.5}.bds-tag__close-button:focus{background-color:var(--boreal-ui-inverse);opacity:0.5;outline:none;-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset;box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset}.bds-tag__close-button:active{background-color:var(--boreal-ui-inverse);opacity:0.5;-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset, 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset;box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus), 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset, 0 1px 2px 0 rgba(19, 19, 22, 0.15) inset}.bds-tag--disabled{cursor:not-allowed}.bds-tag--disabled .bds-tag__close-button{pointer-events:none}.bds-tag--gray{background-color:var(--boreal-extended-onyx-light);color:var(--boreal-extended-onyx-dark)}.bds-tag--gray .bds-tag__close-button{color:var(--boreal-extended-onyx-dark)}.bds-tag--gray.bds-tag--disabled{color:var(--boreal-extended-onyx-base);background-color:var(--boreal-extended-onyx-lighter)}.bds-tag--gray.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-onyx-base)}.bds-tag--purple{background-color:var(--boreal-extended-purple-light);color:var(--boreal-extended-purple-dark)}.bds-tag--purple .bds-tag__close-button{color:var(--boreal-extended-purple-dark)}.bds-tag--purple.bds-tag--disabled{color:var(--boreal-extended-purple-light);background-color:var(--boreal-extended-purple-lighter)}.bds-tag--purple.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-purple-light)}.bds-tag--rose{background-color:var(--boreal-extended-rose-light);color:var(--boreal-extended-rose-dark)}.bds-tag--rose .bds-tag__close-button{color:var(--boreal-extended-rose-dark)}.bds-tag--rose.bds-tag--disabled{color:var(--boreal-extended-rose-light);background-color:var(--boreal-extended-rose-lighter)}.bds-tag--rose.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-rose-light)}.bds-tag--lime{background-color:var(--boreal-extended-lime-light);color:var(--boreal-extended-lime-dark)}.bds-tag--lime .bds-tag__close-button{color:var(--boreal-extended-lime-dark)}.bds-tag--lime.bds-tag--disabled{color:var(--boreal-extended-lime-light);background-color:var(--boreal-extended-lime-lighter)}.bds-tag--lime.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-lime-light)}.bds-tag--cobalt{background-color:var(--boreal-extended-cobalt-light);color:var(--boreal-extended-cobalt-dark)}.bds-tag--cobalt .bds-tag__close-button{color:var(--boreal-extended-cobalt-dark)}.bds-tag--cobalt.bds-tag--disabled{color:var(--boreal-extended-cobalt-light);background-color:var(--boreal-extended-cobalt-lighter)}.bds-tag--cobalt.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-cobalt-light)}.bds-tag--orange{background-color:var(--boreal-extended-orange-light);color:var(--boreal-extended-orange-dark)}.bds-tag--orange .bds-tag__close-button{color:var(--boreal-extended-orange-dark)}.bds-tag--orange.bds-tag--disabled{color:var(--boreal-extended-orange-light);background-color:var(--boreal-extended-orange-lighter)}.bds-tag--orange.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-orange-light)}.bds-tag--teal{background-color:var(--boreal-extended-teal-light);color:var(--boreal-extended-teal-dark)}.bds-tag--teal .bds-tag__close-button{color:var(--boreal-extended-teal-dark)}.bds-tag--teal.bds-tag--disabled{color:var(--boreal-extended-teal-light);background-color:var(--boreal-extended-teal-lighter)}.bds-tag--teal.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-teal-light)}.bds-tag--cyan{background-color:var(--boreal-extended-cyan-light);color:var(--boreal-extended-cyan-dark)}.bds-tag--cyan .bds-tag__close-button{color:var(--boreal-extended-cyan-dark)}.bds-tag--cyan.bds-tag--disabled{color:var(--boreal-extended-cyan-light);background-color:var(--boreal-extended-cyan-lighter)}.bds-tag--cyan.bds-tag--disabled .bds-tag__close-button{color:var(--boreal-extended-cyan-light)}`;
+
+const BdsTag = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        this.bdsClose = createEvent(this, "bdsClose");
+        this.bdsSelect = createEvent(this, "bdsSelect");
+        this._id = createId('bds-tag');
+        this.internalSelected = false;
+        /**
+         * Whether the tag is selectable or not.
+         * @default false
+         */
+        this.multiselect = false;
+        /**
+         * Whether the tag is selected or not.
+         * @default false
+         */
+        this.selected = false;
+        /**
+         * Aria label for the close button when visible.
+         */
+        this.closeButtonLabel = 'Close tag';
+        /**
+         * Visual color variant: 'gray', 'cyan', 'cobalt', 'teal', 'lime', 'orange', 'rose', or 'purple'.
+         * @default "gray"
+         */
+        this.color = TAG_COLORS.GRAY;
+        /**
+         * Hides the close button that allows users to dismiss the tag.
+         * @default false
+         */
+        this.readonly = false;
+        /**
+         * Disables interaction with the tag. Reduces opacity and prevents interactions.
+         * @default false
+         */
+        this.disabled = false;
+        this.handleClose = (e) => {
+            if (this.disabled)
+                return;
+            if (e !== undefined) {
+                e.preventDefault();
+                e.stopPropagation();
+            }
+            this.bdsClose.emit({ id: this._id, selected: this.internalSelected, el: this.el });
+        };
+        this.handleKeyDown = (e) => {
+            if (this.disabled)
+                return;
+            const selectionKeys = [' ', 'Enter'];
+            const closeKeys = ['Delete', 'Backspace'];
+            if (!this.readonly && closeKeys.includes(e.key)) {
+                this.handleClose(e);
+                return;
+            }
+            if (selectionKeys.includes(e.key) && e.target === this.el) {
+                e.preventDefault();
+                this.handleSelection();
+            }
+        };
+        this.handleSelection = () => {
+            if (this.disabled)
+                return;
+            if (this.multiselect) {
+                this.internalSelected = !this.internalSelected;
+                this.bdsSelect.emit({ id: this._id, selected: this.internalSelected, el: this.el });
+            }
+        };
+    }
+    componentWillLoad() {
+        this.syncSelectedFromProp(this.selected);
+        this.checkPropValues();
+        this.validateMultiselectRole();
+    }
+    checkPropValues() {
+        validatePropValue(Object.values(TAG_COLORS), TAG_COLORS.GRAY, this.el, 'color');
+    }
+    syncSelectedFromProp(newValue) {
+        this.internalSelected = newValue;
+    }
+    validateMultiselectRole() {
+        if (!this.multiselect)
+            return;
+        const VALID_TAG_PARENTS = '[role="listbox"], [role="group"], bds-tag-group';
+        const el = this.el;
+        if (el.closest(VALID_TAG_PARENTS) === null) {
+            console.warn('[BorealDS Tag] Missing required ARIA parent. Expected role="listbox", role="group", or <bds-tag-group> when multiselect=true.');
+        }
+    }
+    getClasses() {
+        return {
+            'bds-tag': true,
+            [`bds-tag--${this.color}`]: true,
+            'bds-tag--disabled': this.disabled,
+            'bds-tag--selected': this.internalSelected,
+        };
+    }
+    renderTag() {
+        return (h(Fragment, null, h("span", { "aria-hidden": "true", class: "bds-tag__icon" }, h("slot", { name: "icon" })), h("span", { class: "bds-tag__text" }, h("slot", null))));
+    }
+    renderCloseIcon() {
+        return (h("button", { class: "bds-tag__close-button", "aria-label": this.closeButtonLabel, onClick: e => this.handleClose(e), disabled: this.disabled, type: "button" }, h("em", { class: "bds-icon-close", "aria-hidden": "true" })));
+    }
+    render() {
+        const classes = this.getClasses();
+        const hasCloseButton = !this.readonly;
+        const isSelectable = this.multiselect;
+        return (h(Host, { key: '0864f3764aef3354e5b2c7494a5c9c2cb261582f', class: classes, role: isSelectable ? 'option' : undefined, tabIndex: isSelectable && !this.disabled ? 0 : -1, "aria-disabled": this.disabled ? 'true' : undefined, "aria-selected": isSelectable ? `${this.internalSelected}` : undefined, onKeyDown: !this.disabled ? (e) => this.handleKeyDown(e) : undefined, onClick: !this.disabled ? this.handleSelection : undefined, id: this._id }, this.renderTag(), hasCloseButton && this.renderCloseIcon()));
+    }
+    get el() { return getElement(this); }
+    static get watchers() { return {
+        "color": [{
+                "checkPropValues": 0
+            }],
+        "selected": [{
+                "syncSelectedFromProp": 0
+            }]
+    }; }
+};
+BdsTag.style = bdsTagCss();
+
+export { BdsTag as bds_tag };

package/dist/esm/bds-text-field.entry.js

@@ -0,0 +1,361 @@
+import { M as Mixin, r as registerInstance, c as createEvent, h, a as Host, g as getElement } from './index-BqJlOB6b.js';
+import { f as formAssociatedMixin, s as setFormValue, r as runValidators } from './form-associated.mixin-CvK2d92c.js';
+import { c as createId } from './BaseAttributes-DhSchGPI.js';
+import { v as validatePropValue } from './validateProps-kGnB15Lz.js';
+
+/**
+ * Centralized list of `aria-label` values used by interactive elements.
+ * Add new entries to the `ARIA_LABELS` object to keep labels consistent
+ * and prevent typos across the design system.
+ */
+const ARIA_LABELS = {
+    Clear: 'Clear',
+    ShowPassword: 'Show password',
+    HidePassword: 'Hide password',
+};
+
+/**
+ * Centralized list of icon font-class names used by design-system components.
+ * Add new entries to the `ICONS` object to keep class names consistent
+ * and prevent typos across the design system.
+ */
+const ICONS = {
+    Close: 'bds-icon-close',
+    SightOn: 'bds-icon-sight-on',
+    SightOff: 'bds-icon-sight-off',
+};
+
+const TEXT_FIELD_TYPES = {
+    TEXT: 'text',
+    PASSWORD: 'password',
+};
+const TEXT_FIELD_VARIANTS = {
+    OUTLINE: 'outline',
+    PLAIN: 'plain',
+};
+const TEXT_FIELD_VALIDATION_TIMING = {
+    BLUR: 'blur',
+    CHANGE: 'change',
+    INPUT: 'input',
+    SUBMIT: 'submit',
+};
+
+const bdsTextFieldCss = () => `@charset "UTF-8";.bds-text-field__container,.bds-text-field__sublabel,.bds-text-field__actions,.bds-text-field__action,.bds-text-field__footer{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center}.bds-text-field [slot=prefix],.bds-text-field__sublabel{font-size:var(--boreal-typography-font-size-xs);font-weight:var(--boreal-typography-font-weight-semibold);line-height:var(--boreal-typography-line-height-xs)}.bds-text-field{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;gap:var(--boreal-spacing-2xs);width:var(--bds-text-field-width, 100%);font-family:var(--boreal-typography-font-family-primary);color:var(--boreal-text-default)}.bds-text-field__container{padding:var(--boreal-spacing-1xs);padding-left:0;height:var(--boreal-layout-l);border:1px solid var(--boreal-stroke-default-light);border-radius:var(--boreal-radius-xs);background-color:var(--boreal-ui-inverse);-webkit-transition:background-color 0.3s ease, border-color 0.3s ease, -webkit-box-shadow 0.3s ease;transition:background-color 0.3s ease, border-color 0.3s ease, -webkit-box-shadow 0.3s ease;transition:background-color 0.3s ease, border-color 0.3s ease, box-shadow 0.3s ease;transition:background-color 0.3s ease, border-color 0.3s ease, box-shadow 0.3s ease, -webkit-box-shadow 0.3s ease;overflow:hidden}.bds-text-field__sublabel{gap:var(--boreal-spacing-3xs);padding-left:var(--boreal-spacing-xs);white-space:nowrap}.bds-text-field__sublabel em[class^=bds-icon-],.bds-text-field__sublabel em[class*=" bds-icon-"]{width:var(--boreal-icons-m);height:var(--boreal-icons-m);font-size:var(--boreal-typography-font-size-md);line-height:1;-ms-flex-negative:0;flex-shrink:0;display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center}.bds-text-field [slot=prefix]{padding-left:var(--boreal-spacing-xs);overflow:hidden;white-space:nowrap;-ms-flex-negative:0;flex-shrink:0}.bds-text-field__control{min-width:0;width:100%;border:none;outline:none;background:transparent;padding:0;padding-left:var(--boreal-spacing-xs);font-size:var(--boreal-typography-font-size-sm);font-weight:var(--boreal-typography-font-weight-regular);line-height:var(--boreal-typography-line-height-sm)}.bds-text-field__control::-webkit-input-placeholder{color:var(--boreal-text-default-light)}.bds-text-field__control::-moz-placeholder{color:var(--boreal-text-default-light)}.bds-text-field__control:-ms-input-placeholder{color:var(--boreal-text-default-light)}.bds-text-field__control::-ms-input-placeholder{color:var(--boreal-text-default-light)}.bds-text-field__control::placeholder{color:var(--boreal-text-default-light)}.bds-text-field__control:disabled{cursor:not-allowed}.bds-text-field__actions{padding-left:var(--boreal-spacing-xs);gap:var(--boreal-spacing-3xs)}.bds-text-field__action{-ms-flex-pack:center;justify-content:center;background:none;border:none;padding:var(--boreal-spacing-3xs);cursor:pointer;color:var(--boreal-icon-default-light);line-height:1;-webkit-transition:color 0.3s ease, opacity 0.3s ease;transition:color 0.3s ease, opacity 0.3s ease}.bds-text-field__action--clear em[class^=bds-icon-],.bds-text-field__action--clear em[class*=" bds-icon-"]{width:var(--boreal-icons-s);height:var(--boreal-icons-s);font-size:var(--boreal-typography-font-size-xs);line-height:1;-ms-flex-negative:0;flex-shrink:0;display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center}.bds-text-field__action--password em[class^=bds-icon-],.bds-text-field__action--password em[class*=" bds-icon-"]{width:var(--boreal-icons-l);height:var(--boreal-icons-l);font-size:var(--boreal-typography-font-size-lg);line-height:1;-ms-flex-negative:0;flex-shrink:0;display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center}.bds-text-field__action:hover{color:var(--boreal-icon-default-dark)}.bds-text-field__action:focus-visible{-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus);box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus)}.bds-text-field__footer{-ms-flex-pack:justify;justify-content:space-between}.bds-text-field__char-count{-ms-flex-negative:0;flex-shrink:0;font-size:var(--boreal-typography-font-size-xs);font-weight:var(--boreal-typography-font-weight-regular);line-height:var(--boreal-typography-line-height-xs);color:var(--boreal-text-default-light)}.bds-text-field--focused .bds-text-field__container{border-color:var(--boreal-stroke-focus);-webkit-box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus);box-shadow:0 0 0 1px var(--boreal-ui-inverse), 0 0 0 3px var(--boreal-stroke-focus)}.bds-text-field--error .bds-text-field__container{border-color:var(--boreal-stroke-danger-base)}.bds-text-field--disabled{cursor:not-allowed}.bds-text-field--disabled .bds-text-field__container{background-color:var(--boreal-ui-default-lighter);border-color:var(--boreal-stroke-default-light)}.bds-text-field--disabled .bds-text-field__sublabel{color:var(--boreal-text-disabled)}.bds-text-field--disabled .bds-text-field__sublabel em[class^=bds-icon-],.bds-text-field--disabled .bds-text-field__sublabel em[class*=" bds-icon-"]{color:var(--boreal-icon-disabled)}.bds-text-field--disabled .bds-text-field__control{color:var(--boreal-icon-disabled)}.bds-text-field--readonly .bds-text-field__container{background-color:transparent;border:none}.bds-text-field--readonly .bds-text-field__control::-webkit-input-placeholder{color:var(--boreal-text-default-darker)}.bds-text-field--readonly .bds-text-field__control::-moz-placeholder{color:var(--boreal-text-default-darker)}.bds-text-field--readonly .bds-text-field__control:-ms-input-placeholder{color:var(--boreal-text-default-darker)}.bds-text-field--readonly .bds-text-field__control::-ms-input-placeholder{color:var(--boreal-text-default-darker)}.bds-text-field--readonly .bds-text-field__control::placeholder{color:var(--boreal-text-default-darker)}.bds-text-field--plain .bds-text-field__container{border-color:transparent}.bds-text-field--plain.bds-text-field--focused .bds-text-field__container{border-color:var(--boreal-stroke-focus)}.bds-text-field--clear-on-hover .bds-text-field__action--clear{opacity:0;pointer-events:none}.bds-text-field--clear-on-hover:hover .bds-text-field__action--clear{opacity:1;pointer-events:auto}`;
+
+const BdsTextField = class extends Mixin(formAssociatedMixin) {
+    constructor(hostRef) {
+        super();
+        registerInstance(this, hostRef);
+        this.valueChange = createEvent(this, "valueChange");
+        this.bdsInput = createEvent(this, "bdsInput");
+        this.bdsChange = createEvent(this, "bdsChange");
+        this.bdsFocus = createEvent(this, "bdsFocus");
+        this.bdsBlur = createEvent(this, "bdsBlur");
+        this.bdsClear = createEvent(this, "bdsClear");
+        this.bdsValidationChange = createEvent(this, "bdsValidationChange");
+        if (hostRef.$hostElement$["s-ei"]) {
+            this.internals = hostRef.$hostElement$["s-ei"];
+        }
+        else {
+            this.internals = hostRef.$hostElement$.attachInternals();
+            hostRef.$hostElement$["s-ei"] = this.internals;
+        }
+        /** The name submitted with the form. */
+        this.name = '';
+        /** Disables the input. Also toggled by `formDisabledCallback` via the mixin. */
+        this.disabled = false;
+        /** Marks the input as required for form validation. */
+        this.required = false;
+        /** Mirrors `disabled` and the FACE `formDisabledCallback` result. Drives all disabled UI. */
+        this.isDisabled = false;
+        /** The current value of the input. */
+        this.value = '';
+        /** When `true`, applies the error visual state. */
+        this.error = false;
+        /** Message shown below the input when `error` is `true`. Replaces `helperText`. */
+        this.errorMessage = '';
+        /** Additional validators merged with the built-in ones. */
+        this.customValidators = [];
+        /** Controls when built-in validation runs: `'blur'` | `'input'` | `'submit'` | `'change'`. */
+        this.validationTiming = TEXT_FIELD_VALIDATION_TIMING.BLUR;
+        /** The input type. Use `'password'` to enable the visibility toggle. */
+        this.type = TEXT_FIELD_TYPES.TEXT;
+        /** Visual style of the input container. `'outline'` shows a border; `'plain'` hides it at rest. */
+        this.variant = TEXT_FIELD_VARIANTS.OUTLINE;
+        /** Native `placeholder` attribute forwarded to the inner `<input>`. */
+        this.placeholder = '';
+        /** Makes the input read-only. The value is still submitted with the form. */
+        this.readOnly = false;
+        /** Native `autocomplete` attribute forwarded to the inner `<input>`. */
+        this.autocomplete = 'off';
+        /** Regex the value must match to pass `patternMismatch` validation. Also forwarded as the native `pattern` attribute to the inner `<input>`. Empty string disables pattern validation. */
+        this.pattern = '';
+        /** Minimum character count. `0` means no minimum. */
+        this.minLength = 0;
+        /** Maximum character count. `0` means no maximum. */
+        this.maxLength = 0;
+        /** Label text rendered above the input. */
+        this.label = '';
+        /** Sublabel rendered inside the input container, before the text area. */
+        this.sublabel = '';
+        /** Icon font class rendered beside the sublabel inside the container (e.g. `bds-icon-settings`). */
+        this.icon = '';
+        /** Helper text shown below the input when there is no error. */
+        this.helperText = '';
+        /** Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop. */
+        this.info = '';
+        /** Shows a clear button when the input has a value. */
+        this.clearable = false;
+        /** Shows a clear button that is hidden at rest and revealed when the user hovers over the field. */
+        this.clearOnHover = false;
+        /** Maximum character count shown in the footer counter (e.g. `120` → `"45/120"`). Requires `counter`. */
+        this.charCount = 0;
+        /** Enables the character counter in the footer. Requires `charCount` to be set. */
+        this.counter = false;
+        /** Sets a custom width via the `--bds-text-field-width` CSS custom property. */
+        this.customWidth = '';
+        /** Tracks focus state to drive the `bds-text-field--focused` CSS modifier. */
+        this.focused = false;
+        /** Controls whether the password input renders as plain text. */
+        this.showPassword = false;
+        /** `true` after the user has blurred the input at least once. */
+        this.touched = false;
+        /** `true` once the value has been modified by the user. */
+        this.dirty = false;
+        /** Live character count of the current value. */
+        this.currentCharCount = 0;
+        /** `true` when the last triggered validation run returned invalid. Drives the error visual state. */
+        this.validationError = false;
+        /** Error message from the last failed validator. Shown in the footer when `validationError` is `true`. */
+        this.validationMessage = '';
+        this._valueAtFocus = '';
+        this._id = createId('bds-text-field');
+        this.invalidHandler = (e) => {
+            e.preventDefault();
+            this.validationError = true;
+            this.validationMessage = this.internals.validationMessage;
+            this.bdsValidationChange.emit({
+                valid: false,
+                validity: this.internals.validity,
+                value: this.value,
+                touched: this.touched,
+                dirty: this.dirty,
+            });
+        };
+    }
+    /**
+     * Returns `true` if the element's value passes all constraints; `false` otherwise.
+     * Also fires an `invalid` event if constraints are violated.
+     */
+    async checkValidity() {
+        return this.internals.checkValidity();
+    }
+    /**
+     * Returns `true` if the element's value passes all constraints; `false` otherwise.
+     * Shows the browser's native validation UI when constraints are violated.
+     */
+    async reportValidity() {
+        return this.internals.reportValidity();
+    }
+    onDisabledChange(next) {
+        this.isDisabled = next;
+    }
+    checkPropValues() {
+        validatePropValue(Object.values(TEXT_FIELD_TYPES), TEXT_FIELD_TYPES.TEXT, this.el, 'type');
+        validatePropValue(Object.values(TEXT_FIELD_VARIANTS), TEXT_FIELD_VARIANTS.OUTLINE, this.el, 'variant');
+        validatePropValue(Object.values(TEXT_FIELD_VALIDATION_TIMING), TEXT_FIELD_VALIDATION_TIMING.BLUR, this.el, 'validationTiming');
+    }
+    componentWillLoad() {
+        this.checkPropValues();
+        this.isDisabled = this.disabled;
+        this.currentCharCount = this.value.length;
+    }
+    componentDidLoad() {
+        this.el.addEventListener('invalid', this.invalidHandler);
+    }
+    disconnectedCallback() {
+        this.el.removeEventListener('invalid', this.invalidHandler);
+    }
+    onCustomValidatorsChange() {
+        this.updateValidity();
+    }
+    onValueChange(next) {
+        setFormValue(this.internals, next);
+        this.currentCharCount = next.length;
+        this.updateValidity();
+        this.valueChange.emit(next);
+    }
+    formAssociatedCallback() {
+        setFormValue(this.internals, this.value);
+        this.updateValidity();
+    }
+    formResetCallback() {
+        this.value = '';
+        this.touched = false;
+        this.dirty = false;
+        this.currentCharCount = 0;
+        this.validationError = false;
+        this.validationMessage = '';
+        setFormValue(this.internals, null);
+        this.updateValidity();
+    }
+    formStateRestoreCallback(state, _mode) {
+        this.value = typeof state === 'string' ? state : '';
+        setFormValue(this.internals, this.value);
+        this.updateValidity();
+    }
+    updateValidity(emitEvent = false) {
+        const valid = runValidators(this.internals, [...this.validators, ...this.customValidators], this.el);
+        if (emitEvent) {
+            this.validationError = !valid;
+            this.validationMessage = valid ? '' : this.internals.validationMessage;
+            this.bdsValidationChange.emit({
+                valid,
+                validity: this.internals.validity,
+                value: this.value,
+                touched: this.touched,
+                dirty: this.dirty,
+            });
+        }
+    }
+    handleInput(e) {
+        this.value = e.target.value;
+        this.dirty = true;
+        this.bdsInput.emit({ value: this.value, event: e });
+        if (this.validationTiming === TEXT_FIELD_VALIDATION_TIMING.INPUT) {
+            this.updateValidity(true);
+        }
+    }
+    handleChange(e) {
+        this.bdsChange.emit({ value: this.value, event: e });
+        if (this.validationTiming === TEXT_FIELD_VALIDATION_TIMING.CHANGE) {
+            this.updateValidity(true);
+        }
+    }
+    handleFocus(e) {
+        this.focused = true;
+        this._valueAtFocus = this.value;
+        this.bdsFocus.emit({ event: e });
+    }
+    handleBlur(e) {
+        this.focused = false;
+        this.touched = true;
+        this.bdsBlur.emit({ event: e });
+        if (this.validationTiming === TEXT_FIELD_VALIDATION_TIMING.BLUR) {
+            this.updateValidity(true);
+        }
+        else if (this.validationTiming === TEXT_FIELD_VALIDATION_TIMING.CHANGE && this.value !== this._valueAtFocus) {
+            this.updateValidity(true);
+        }
+    }
+    handleShowPassword() {
+        this.showPassword = !this.showPassword;
+    }
+    handleClear() {
+        this.value = '';
+        this.dirty = true;
+        this.validationError = false;
+        this.validationMessage = '';
+        this.bdsClear.emit();
+        this.el.querySelector('input')?.focus();
+    }
+    handleMouseDown(e) {
+        if (this.readOnly) {
+            e.preventDefault();
+        }
+    }
+    get validators() {
+        return [
+            {
+                key: 'valueMissing',
+                isValid: () => !this.required || this.value !== '',
+                message: 'This field is required. Please fill it out.',
+            },
+            {
+                key: 'tooShort',
+                isValid: () => this.minLength === 0 || this.value.length >= this.minLength,
+                message: `Please enter at least ${this.minLength} characters.`,
+            },
+            {
+                key: 'patternMismatch',
+                isValid: () => {
+                    if (this.pattern === '' || this.value === '')
+                        return true;
+                    try {
+                        return new RegExp(this.pattern).test(this.value);
+                    }
+                    catch {
+                        return true;
+                    }
+                },
+                message: 'Please match the requested format.',
+            },
+        ];
+    }
+    get effectiveMaxLength() {
+        if (this.maxLength !== 0)
+            return this.maxLength;
+        if (this.counter && this.charCount > 0)
+            return this.charCount;
+        return undefined;
+    }
+    get classMap() {
+        return {
+            'bds-text-field': true,
+            'bds-text-field--error': this.error || this.validationError,
+            'bds-text-field--disabled': this.isDisabled,
+            'bds-text-field--focused': this.focused,
+            'bds-text-field--readonly': this.readOnly,
+            'bds-text-field--plain': this.variant === TEXT_FIELD_VARIANTS.PLAIN,
+            'bds-text-field--clear-on-hover': this.clearOnHover,
+        };
+    }
+    get hostStyle() {
+        return this.customWidth !== '' ? { '--bds-text-field-width': this.customWidth } : undefined;
+    }
+    get iconClear() {
+        return this.clearable || this.clearOnHover ? ICONS.Close : '';
+    }
+    get showPasswordIcon() {
+        return this.showPassword ? ICONS.SightOn : ICONS.SightOff;
+    }
+    render() {
+        const labelId = `${this._id}-label`;
+        const helperId = `${this._id}-helper`;
+        const showClear = (this.clearable || this.clearOnHover) && this.value !== '' && !this.isDisabled && !this.readOnly;
+        const effectiveError = this.error || this.validationError;
+        const helperContent = this.error && this.errorMessage !== ''
+            ? this.errorMessage
+            : this.validationError && this.validationMessage !== ''
+                ? this.validationMessage
+                : this.helperText;
+        const showFooter = helperContent !== '' || (this.counter && this.charCount > 0);
+        const typographyState = this.isDisabled ? 'disabled' : effectiveError ? 'error' : 'default';
+        return (h(Host, { key: '96b7e057fa7f25e8f7d13b7de0fd17f12de602bb', class: this.classMap, style: this.hostStyle, tabIndex: -1, onFocus: () => !this.readOnly && this.el.querySelector('input')?.focus() }, this.label !== '' && (h("bds-typography", { key: 'e827b43ea347037ff2d404229aaefdd258d2ad22', id: labelId, variant: "label", htmlFor: this._id, required: this.required, tooltipText: this.info !== '' ? this.info : undefined, state: typographyState }, this.label)), h("div", { key: 'f579762db25f65031917874dbb4c2347b5d9f027', class: "bds-text-field__container" }, (this.icon !== '' || this.sublabel !== '') && (h("span", { key: '191d2ccec9baf8b739163eea112dce9a1073f4bd', class: "bds-text-field__sublabel" }, this.icon !== '' && h("em", { key: '1cc1b1b7ece610b2a18ba872c4b7035d2239731b', class: this.icon }), this.sublabel)), h("slot", { key: 'ba7b08573b6ae35c10649125991a2bbed15f31f3', name: "prefix" }), h("input", { key: '6391338c4f636382cf19f888dc810baaf6820c80', id: this._id, class: "bds-text-field__control", "aria-labelledby": this.label !== '' ? labelId : undefined, "aria-describedby": showFooter && helperContent !== '' ? helperId : undefined, "aria-invalid": this.error || this.validationError ? 'true' : undefined, "aria-required": this.required ? 'true' : undefined, type: this.type === TEXT_FIELD_TYPES.PASSWORD && this.showPassword ? TEXT_FIELD_TYPES.TEXT : this.type, value: this.value, disabled: this.isDisabled, readOnly: this.readOnly, tabIndex: this.readOnly ? -1 : undefined, placeholder: this.placeholder, autocomplete: this.autocomplete, pattern: this.pattern !== '' ? this.pattern : undefined, minLength: this.minLength !== 0 ? this.minLength : undefined, maxLength: this.effectiveMaxLength, onMouseDown: (e) => this.handleMouseDown(e), onInput: (e) => this.handleInput(e), onChange: (e) => this.handleChange(e), onFocus: (e) => this.handleFocus(e), onBlur: (e) => this.handleBlur(e) }), (showClear || this.type === TEXT_FIELD_TYPES.PASSWORD) && (h("div", { key: 'e5dc4cab3d536ef09eaeae96ca68a7d4b4e15d92', class: "bds-text-field__actions" }, showClear && (h("button", { key: 'b18d06de000c3ea465be221dcbb77ab49bb3949f', class: "bds-text-field__action bds-text-field__action--clear", type: "button", "aria-label": ARIA_LABELS.Clear, onClick: () => this.handleClear() }, h("em", { key: '0aa5d75c5214b7832a2a2e80a1cd2c42af5bea9a', class: this.iconClear }))), this.type === TEXT_FIELD_TYPES.PASSWORD && (h("button", { key: 'fd97135cca8d32178461bf7109c9b6a7eec543e9', class: "bds-text-field__action bds-text-field__action--password", type: "button", "aria-label": this.showPassword ? ARIA_LABELS.HidePassword : ARIA_LABELS.ShowPassword, onClick: () => this.handleShowPassword() }, h("em", { key: '0de72e7756ad62bbe4fb5f925526071720f358db', class: this.showPasswordIcon })))))), showFooter && (h("div", { key: '9d1c0e8920511650ab6711f2f813c01491d52414', class: "bds-text-field__footer" }, helperContent !== '' && (h("bds-typography", { key: 'f27235a7a38f34b9a9f7bae762c3c6be12acd8b0', id: helperId, variant: "helper", state: typographyState }, helperContent)), this.counter && this.charCount > 0 && (h("span", { key: '3aa43ea8bd6a35963f0983ec8814e0ce19ee71ce', class: "bds-text-field__char-count" }, this.currentCharCount, "/", this.charCount))))));
+    }
+    static get formAssociated() { return true; }
+    get el() { return getElement(this); }
+    static get watchers() { return {
+        "disabled": [{
+                "onDisabledChange": 0
+            }],
+        "type": [{
+                "checkPropValues": 0
+            }],
+        "variant": [{
+                "checkPropValues": 0
+            }],
+        "validationTiming": [{
+                "checkPropValues": 0
+            }],
+        "customValidators": [{
+                "onCustomValidatorsChange": 0
+            }],
+        "value": [{
+                "onValueChange": 0
+            }]
+    }; }
+};
+BdsTextField.style = bdsTextFieldCss();
+
+export { BdsTextField as bds_text_field };