@mcp-b/web-components 0.2.0

package/dist/text-area-Czixaz-_.js

@@ -0,0 +1,556 @@
+import { t as __decorate } from "./decorate-DcF3lt7P.js";
+import { css, html } from "lit";
+import { property, query, state } from "lit/decorators.js";
+import hostStyles from "@mcp-b/wc-support/styles/host.styles";
+import { SigveloFormControlElement } from "@mcp-b/wc-support/base/sigvelo-element";
+import { classMap } from "lit/directives/class-map.js";
+import { ifDefined } from "lit/directives/if-defined.js";
+import { SigveloBlurEvent, SigveloChangeEvent, SigveloFocusEvent, SigveloInputEvent } from "@mcp-b/wc-support/events/form";
+import { live } from "lit/directives/live.js";
+import formControlStyles from "@mcp-b/wc-support/styles/form-control.styles";
+//#region src/components/text-area/text-area.styles.ts
+var text_area_styles_default = css`
+  /* Normal */
+  #visual-box.normal {
+    padding-inline: 0;
+
+    #text-box {
+      padding-inline: 0.75em;
+    }
+  }
+
+  /* Filled */
+  #visual-box.filled {
+    padding-inline: 0;
+
+    #text-box {
+      padding-inline: 0.75em;
+    }
+  }
+
+  /* Sizes */
+  #visual-box.xs #text-box {
+    padding-block: 0.2em;
+  }
+
+  #visual-box.sm #text-box {
+    padding-block: 0.35em;
+  }
+
+  #visual-box.md #text-box {
+    padding-block: 0.7em;
+  }
+
+  #visual-box.lg #text-box {
+    padding-block: 0.5em;
+  }
+
+  #visual-box.xl #text-box {
+    padding-block: 0.55em;
+  }
+
+  /* Resizing */
+  #visual-box.resize-none #text-box,
+  #visual-box.resize-auto #text-box {
+    resize: none;
+  }
+
+  #visual-box.resize-vertical #text-box {
+    resize: vertical;
+  }
+`;
+//#endregion
+//#region src/components/text-area/text-area.ts
+/**
+* <sigvelo-text-area>
+*
+* @summary Allows users to edit multi-line, plain text content.
+* @tag sigvelo-text-area
+* @documentation https://design-system.sigvelo.com/docs/components/text-area
+* @status stable
+* @since 1.0
+*
+* @slot label - The text area's label. For plain-text labels, you can use the `label` attribute instead.
+* @slot description - The text area's description. For plain-text descriptions, you can use the `description`
+*  attribute instead.
+*
+* @event sigvelo-blur - Emitted when the text area loses focus. This event does not bubble.
+* @event sigvelo-change - Emitted when the user commits changes to the text area's value.
+* @event sigvelo-focus - Emitted when the text area receives focus. This event does not bubble.
+* @event sigvelo-input - Emitted when the text area receives input.
+*
+* @csspart label - The element that contains the text area's label.
+* @csspart description - The element that contains the text area's description.
+* @csspart visual-box - The element that wraps the internal text box.
+* @csspart text-box - The internal text box, a `<textarea>` element.
+*
+* @cssstate disabled - Applied when the text area is disabled.
+* @cssstate blank - Applied when the text area has a blank value.
+* @cssstate focused - Applied when the text area has focus.
+* @cssstate user-valid - Applied when the text area is valid and the user has sufficiently interacted with it.
+* @cssstate user-invalid - Applied when the text area is invalid and the user has sufficiently interacted with it.
+*
+* @example Default
+* ```html
+* <sigvelo-text-area name="feedback" label="Feedback"></sigvelo-text-area>
+* ```
+*
+* @example Labels and descriptions
+* You can use the `label` and `description` attributes to provide plain text labels and descriptions for the text area. If you want to provide HTML, use the `label` and `description` slots instead.
+*
+* ```html
+* <sigvelo-text-area name="feedback" label="Feedback">
+*   <span slot="description">
+*     For more information, <a href="https://example.com/" target="_blank">visit our website</a>.
+*   </span>
+* </sigvelo-text-area>
+* ```
+*
+* @example Providing an initial value
+* Use the `value` attribute to provide an initial value for the text area.
+*
+* ```html
+* <sigvelo-text-area name="feedback" label="Feedback" value="This is the greatest and best song in the world."></sigvelo-text-area>
+* ```
+*
+* @example Adding a placeholder
+* Use the `placeholder` attribute to show a placeholder in the text area when it's empty.
+*
+* ```html
+* <sigvelo-text-area
+*   name="bio"
+*   label="Biography"
+*   placeholder="Tell us about yourself"
+* ></sigvelo-text-area>
+* ```
+*
+* @example Changing the number of rows
+* Use the `rows` attribute to set the default number of text rows.
+*
+* ```html
+* <sigvelo-text-area label="One row" rows="1"></sigvelo-text-area><br>
+* <sigvelo-text-area label="Five rows" rows="5"></sigvelo-text-area>
+* ```
+*
+* @example Resizing to fit content
+* Text areas can grow with their content by setting the `resize` property to `auto`. The minimum number of rows shown is determine by the `rows` attribute.
+*
+* ```html
+* <sigvelo-text-area label="Resizing to fit" resize="auto" rows="4"></sigvelo-text-area>
+* ```
+*
+* @example Filled and unstyled text areas
+* Set the `variant` attribute to `normal`, `filled`, or `unstyled` to change the text area's variant.
+*
+* ```html
+* <sigvelo-text-area variant="normal" label="Normal text field" placeholder="Enter some text"></sigvelo-text-area><br>
+* <sigvelo-text-area variant="filled" label="Filled" placeholder="Enter some text"></sigvelo-text-area><br>
+* <sigvelo-text-area variant="unstyled" label="Unstyled" placeholder="Enter some text"></sigvelo-text-area>
+* ```
+*
+* @example Changing the size
+* Use the `size` attribute to change the text area's size.
+*
+* ```html
+* <sigvelo-text-area size="xs" label="Extra small"></sigvelo-text-area><br>
+* <sigvelo-text-area size="sm" label="Small"></sigvelo-text-area><br>
+* <sigvelo-text-area size="md" label="Medium"></sigvelo-text-area><br>
+* <sigvelo-text-area size="lg" label="Large"></sigvelo-text-area><br>
+* <sigvelo-text-area size="xl" label="Extra large"></sigvelo-text-area>
+* ```
+*
+* @example Disabling
+* Use the `disabled` attribute to disable the text area.
+*
+* ```html
+* <sigvelo-text-area label="Disabled" disabled></sigvelo-text-area>
+* ```
+*
+* @example Showing labels on the side
+* With the `sigvelo-side-label` utility, you can show labels on the side instead of on top of the text area. You can control the width of the label by setting the `--label-width` custom property.
+*
+* ```html
+* <sigvelo-text-area
+*   class="sigvelo-side-label"
+*   style="--label-width: 8ch;"
+*   name="name"
+*   label="Feedback"
+*   description="Let us know what you think"
+* ></sigvelo-text-area>
+* ```
+*
+* @example Validation
+* A number of attributes can be used to enable validation using the Constraint Validation API. These include `required`, `minlength`, and `maxlength`. They work exactly like their native counterparts.
+*
+* ```html
+* <form action="about:blank" method="get" target="_blank">
+*   <sigvelo-text-area name="required" label="Required" required></sigvelo-text-area><br>
+*   <sigvelo-text-area name="minlength" label="Minimum length (enter at least five characters)" required minlength="5"></sigvelo-text-area><br>
+*   <sigvelo-text-area name="maxlength" label="Maximum length (enter no more than five characters)" required maxlength="5"></sigvelo-text-area><br>
+*   <sigvelo-button type="submit" color="primary">Submit</sigvelo-button>
+*   <sigvelo-button type="reset">Reset</sigvelo-button>
+* </form>
+* ```
+*
+* @example Using custom validation
+* Use the `setCustomValidity()` method to make the text area invalid and show a custom error message on submit. This will override all other validation parameters. To clear the error, remove the attribute or set it to an empty string.
+*
+* ```html
+* <form action="about:blank" method="get" target="_blank" id="text-area__custom-validation">
+*   <sigvelo-text-area
+*     name="feedback"
+*     label="Feedback"
+*     description="This field will be invalid until custom validation is removed"
+*   ></sigvelo-text-area>
+*   <br>
+*   <sigvelo-button type="submit" color="primary">Submit</sigvelo-button>
+* </form>
+*
+* <script type="module">
+*   import { allDefined } from '/dist/sigvelo.js';
+*
+*   await allDefined();
+*
+*   const form = document.getElementById('text-area__custom-validation');
+*   const textArea = form.querySelector('sigvelo-text-area');
+*
+*   textArea.setCustomValidity('Not so fast, bubba!');
+* <\/script>
+* ```
+*
+* @example Styling validation
+* You can style valid and invalid text area using the `:valid` and `:invalid` pseudo classes.
+*
+* ```html
+* <form action="about:blank" method="get" target="_blank" class="text-area__validation-pseudo">
+*   <sigvelo-text-area
+*     name="feedback"
+*     label="Feedback"
+*     description="This field is required"
+*     required
+*   ></sigvelo-text-area>
+*   <br>
+*   <sigvelo-button type="submit" color="primary">Submit</sigvelo-button>
+*   <sigvelo-button type="reset">Reset</sigvelo-button>
+* </form>
+*
+* <style>
+*   .text-area__validation-pseudo {
+*     sigvelo-text-area:valid {
+*       outline: solid 2px var(--sigvelo-color-success-border);
+*       outline-offset: .5rem;
+*     }
+*
+*     sigvelo-text-area:invalid {
+*       outline: solid 2px var(--sigvelo-color-danger-border);
+*       outline-offset: .5rem;
+*     }
+*   }
+* </style>
+* ```
+*
+* However, these selectors will match even before the user has had a chance to fill out the form. More often than not, you'll want to use the `user-valid` and `user-invalid` custom states instead. This way, validation styles are only shown _after_ the user interacts with the form control or when the form is submitted.
+*
+* ```html
+* <form action="about:blank" method="get" target="_blank" class="text-area__validation-custom">
+*   <sigvelo-text-area
+*     name="feedback"
+*     label="Feedback"
+*     description="This field is required"
+*     required
+*   ></sigvelo-text-area>
+*   <br>
+*   <sigvelo-button type="submit" color="primary">Submit</sigvelo-button>
+*   <sigvelo-button type="reset">Reset</sigvelo-button>
+* </form>
+*
+* <style>
+*   .text-area__validation-custom {
+*     sigvelo-text-area:state(user-valid) {
+*       outline: solid 2px var(--sigvelo-color-success-border);
+*       outline-offset: .5rem;
+*     }
+*
+*     sigvelo-text-area:state(user-invalid) {
+*       outline: solid 2px var(--sigvelo-color-danger-border);
+*       outline-offset: .5rem;
+*     }
+*   }
+* </style>
+* ```
+*/
+var SigveloTextArea = class extends SigveloFormControlElement {
+	constructor(..._args) {
+		super(..._args);
+		this.textAreaAutoSizer = document.createElement("textarea");
+		this.isInvalid = false;
+		this.hadUserInteraction = false;
+		this.wasSubmitted = false;
+		this.value = "";
+		this.disabled = false;
+		this.readonly = false;
+		this.resize = "vertical";
+		this.rows = 3;
+		this.variant = "normal";
+		this.size = "md";
+		this.required = false;
+	}
+	static {
+		this.formAssociated = true;
+	}
+	static {
+		this.observeSlots = true;
+	}
+	static {
+		this.styles = [
+			hostStyles,
+			formControlStyles,
+			text_area_styles_default
+		];
+	}
+	get focusableAnchor() {
+		return this.textBox;
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		this.addEventListener("invalid", this.handleHostInvalid);
+		this.resizeObserver = new ResizeObserver(() => this.updateHeight());
+		this.updateComplete.then(() => {
+			this.updateHeight();
+			this.resizeObserver.observe(this.textBox);
+		});
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		this.removeEventListener("invalid", this.handleHostInvalid);
+		if (this.textBox) this.resizeObserver.unobserve(this.textBox);
+	}
+	updated(changedProperties) {
+		this.updateValidity();
+		if (changedProperties.has("value")) {
+			this.customStates.set("blank", this.value === "");
+			this.internals.setFormValue(this.value);
+		}
+		if (changedProperties.has("disabled")) this.customStates.set("disabled", this.disabled);
+		if (changedProperties.has("value") || changedProperties.has("rows")) this.updateHeight();
+		if (this.hadUserInteraction || this.wasSubmitted) {
+			this.customStates.set("user-invalid", this.isInvalid);
+			this.customStates.set("user-valid", !this.isInvalid);
+		} else {
+			this.customStates.set("user-invalid", false);
+			this.customStates.set("user-valid", false);
+		}
+	}
+	/** @internal Called when a containing fieldset is disabled. */
+	formDisabledCallback(isDisabled) {
+		this.disabled = isDisabled;
+	}
+	/** @internal Called when the form is reset. */
+	formResetCallback() {
+		this.isInvalid = false;
+		this.hadUserInteraction = false;
+		this.wasSubmitted = false;
+		this.value = this.getAttribute("value") ?? "";
+	}
+	handleBlur() {
+		this.customStates.set("focused", false);
+		this.dispatchEvent(new SigveloBlurEvent());
+	}
+	handleChange() {
+		this.hadUserInteraction = true;
+		this.dispatchEvent(new SigveloChangeEvent());
+		this.dispatchEvent(new Event("change", {
+			bubbles: true,
+			composed: true
+		}));
+	}
+	handleFocus() {
+		this.customStates.set("focused", true);
+		this.dispatchEvent(new SigveloFocusEvent());
+	}
+	handleHostInvalid() {
+		this.wasSubmitted = true;
+	}
+	async handleInput() {
+		this.value = this.textBox.value;
+		await this.updateComplete;
+		this.dispatchEvent(new SigveloInputEvent());
+	}
+	/** Updates the height of the text area based on its content and settings. */
+	updateHeight() {
+		if (this.resize === "auto") {
+			this.textAreaAutoSizer.id = this.textBox.id;
+			this.textAreaAutoSizer.inert = true;
+			this.textAreaAutoSizer.value = this.value;
+			this.textAreaAutoSizer.rows = this.rows;
+			this.textAreaAutoSizer.style.position = "absolute";
+			this.textAreaAutoSizer.style.top = "0";
+			this.textAreaAutoSizer.style.left = "0";
+			this.textAreaAutoSizer.style.width = "100%";
+			this.textAreaAutoSizer.style.height = "auto";
+			this.textAreaAutoSizer.style.minHeight = "auto";
+			this.textAreaAutoSizer.style.pointerEvents = "none";
+			this.textAreaAutoSizer.style.opacity = "0";
+			this.textBox.insertAdjacentElement("afterend", this.textAreaAutoSizer);
+			const emptyAutoSizer = this.textAreaAutoSizer.cloneNode();
+			emptyAutoSizer.value = "";
+			emptyAutoSizer.rows = this.rows;
+			this.textBox.insertAdjacentElement("afterend", emptyAutoSizer);
+			const minHeight = emptyAutoSizer.scrollHeight;
+			emptyAutoSizer.remove();
+			const contentHeight = this.textAreaAutoSizer.scrollHeight;
+			this.textBox.style.height = `${Math.max(contentHeight, minHeight)}px`;
+			this.textAreaAutoSizer.remove();
+			this.textAreaAutoSizer.id = "";
+		}
+	}
+	/** Sets the form control's validity */
+	async updateValidity() {
+		await this.updateComplete;
+		const hasCustomValidity = this.getCustomValidity().length > 0;
+		const validationMessage = hasCustomValidity ? this.getCustomValidity() : this.textBox.validationMessage;
+		const flags = {
+			badInput: this.textBox.validity.badInput,
+			customError: hasCustomValidity,
+			patternMismatch: this.textBox.validity.patternMismatch,
+			rangeOverflow: this.textBox.validity.rangeOverflow,
+			rangeUnderflow: this.textBox.validity.rangeUnderflow,
+			stepMismatch: this.textBox.validity.stepMismatch,
+			tooLong: this.textBox.validity.tooLong,
+			tooShort: this.textBox.validity.tooShort,
+			typeMismatch: this.textBox.validity.typeMismatch,
+			valueMissing: this.textBox.validity.valueMissing
+		};
+		this.isInvalid = hasCustomValidity ? true : !this.textBox.validity.valid;
+		this.internals.setValidity(flags, validationMessage, this.focusableAnchor);
+	}
+	/** Sets focus to the text area. */
+	focus() {
+		this.textBox.focus();
+	}
+	/** Removes focus from the text area. */
+	blur() {
+		this.textBox.blur();
+	}
+	/** Selects all text in the text area. */
+	select() {
+		this.textBox.select();
+	}
+	/** Sets the start and end positions of the current text selection in the text area. */
+	setSelectionRange(start, end, direction = "none") {
+		this.textBox.setSelectionRange(start, end, direction);
+	}
+	/** Replaces a range of text in the text area with a new string. */
+	setRangeText(replacement, start, end, selectMode) {
+		this.textBox.setRangeText(replacement, start ?? this.textBox.selectionStart, end ?? this.textBox.selectionEnd, selectMode);
+		this.value = this.textBox.value;
+	}
+	render() {
+		const hasLabel = this.label || this.slotsWithContent.has("label");
+		const hasDescription = this.description || this.slotsWithContent.has("description");
+		return html`
+      <label id="label" part="label" for="text-box" class=${classMap({ vh: !hasLabel })}>
+        <slot name="label">${this.label}</slot>
+      </label>
+
+      <div id="description" part="description" class=${classMap({ vh: !hasDescription })}>
+        <slot name="description">${this.description}</slot>
+      </div>
+
+      <div
+        id="visual-box"
+        part="visual-box"
+        class=${classMap({
+			normal: this.variant === "normal",
+			filled: this.variant === "filled",
+			unstyled: this.variant === "unstyled",
+			xs: this.size === "xs",
+			sm: this.size === "sm",
+			md: this.size === "md",
+			lg: this.size === "lg",
+			xl: this.size === "xl",
+			"resize-vertical": this.resize === "vertical",
+			"resize-auto": this.resize === "auto",
+			"resize-none": this.resize === "none",
+			disabled: this.disabled
+		})}
+      >
+        <textarea
+          id="text-box"
+          part="text-box"
+          ?autofocus=${this.autofocus}
+          ?disabled=${this.disabled}
+          ?readonly=${this.readonly}
+          ?required=${this.required}
+          placeholder=${ifDefined(this.placeholder)}
+          minlength=${ifDefined(this.minLength)}
+          maxlength=${ifDefined(this.maxLength)}
+          .value=${live(this.value)}
+          rows=${this.rows}
+          autocapitalize=${ifDefined(this.autocapitalize)}
+          autocomplete=${ifDefined(this.autocomplete)}
+          autocorrect=${ifDefined(this.autocorrect)}
+          spellcheck=${ifDefined(this.spellcheck)}
+          enterkeyhint=${ifDefined(this.enterkeyhint)}
+          inputmode=${ifDefined(this.inputmode)}
+          aria-describedby="description"
+          aria-invalid=${this.isInvalid ? "true" : "false"}
+          @change=${this.handleChange}
+          @input=${this.handleInput}
+          @focus=${this.handleFocus}
+          @blur=${this.handleBlur}
+        ></textarea>
+      </div>
+    `;
+	}
+};
+__decorate([query("textarea")], SigveloTextArea.prototype, "textBox", void 0);
+__decorate([state()], SigveloTextArea.prototype, "isInvalid", void 0);
+__decorate([state()], SigveloTextArea.prototype, "hadUserInteraction", void 0);
+__decorate([state()], SigveloTextArea.prototype, "wasSubmitted", void 0);
+__decorate([property()], SigveloTextArea.prototype, "label", void 0);
+__decorate([property()], SigveloTextArea.prototype, "description", void 0);
+__decorate([property({ reflect: true })], SigveloTextArea.prototype, "name", void 0);
+__decorate([property()], SigveloTextArea.prototype, "value", void 0);
+__decorate([property()], SigveloTextArea.prototype, "placeholder", void 0);
+__decorate([property({
+	type: Boolean,
+	reflect: true
+})], SigveloTextArea.prototype, "disabled", void 0);
+__decorate([property({
+	type: Boolean,
+	reflect: true
+})], SigveloTextArea.prototype, "readonly", void 0);
+__decorate([property()], SigveloTextArea.prototype, "resize", void 0);
+__decorate([property({ type: Number })], SigveloTextArea.prototype, "rows", void 0);
+__decorate([property({ reflect: true })], SigveloTextArea.prototype, "variant", void 0);
+__decorate([property({ reflect: true })], SigveloTextArea.prototype, "size", void 0);
+__decorate([property()], SigveloTextArea.prototype, "form", void 0);
+__decorate([property({
+	type: Boolean,
+	reflect: true
+})], SigveloTextArea.prototype, "required", void 0);
+__decorate([property({
+	attribute: "minlength",
+	type: Number
+})], SigveloTextArea.prototype, "minLength", void 0);
+__decorate([property({
+	attribute: "maxlength",
+	type: Number
+})], SigveloTextArea.prototype, "maxLength", void 0);
+__decorate([property()], SigveloTextArea.prototype, "autocapitalize", void 0);
+__decorate([property()], SigveloTextArea.prototype, "autocomplete", void 0);
+__decorate([property({ type: Boolean })], SigveloTextArea.prototype, "autocorrect", void 0);
+__decorate([property({ type: Boolean })], SigveloTextArea.prototype, "autofocus", void 0);
+__decorate([property()], SigveloTextArea.prototype, "enterkeyhint", void 0);
+__decorate([property()], SigveloTextArea.prototype, "inputmode", void 0);
+__decorate([property({
+	type: Boolean,
+	converter: {
+		fromAttribute: (value) => !(!value || value === "false"),
+		toAttribute: (value) => value ? "true" : "false"
+	}
+})], SigveloTextArea.prototype, "spellcheck", void 0);
+customElements.define("sigvelo-text-area", SigveloTextArea);
+//#endregion
+export { SigveloTextArea as t };