@ucalgary-design-system/text-area 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @ucalgary-design-system/text-area
+
+## 1.0.1
+
+### Patch Changes
+
+- 178cd3b: Full development of text area component
+- Updated dependencies [66ac9d0]
+- Updated dependencies [51904ca]
+  - @ucalgary-design-system/core@1.0.6

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 University of Calgary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# TextArea
+
+This package provides the **TextArea** web component.
+
+## Installation
+
+Install the component using npm:
+
+```sh
+npm install @ucalgary-design-system/text-area
+```
+
+## Usage
+
+Import the component into your application:
+
+```ts
+import "@ucalgary-design-system/text-area";
+```
+
+Use the component in your HTML:
+
+```html
+<ucds-text-area></ucds-text-area>
+```
+
+> 💡 Our components automatically load global design tokens when first used. You don’t need to import them manually!
+
+## Development
+
+Build the component:
+
+```sh
+npm run build
+```
+
+Alternatively, build from the monorepo root:
+
+```sh
+npm run build -w @ucalgary-design-system/ucds-text-area
+``` 
+
+Run storybook from the monorepo root.
+
+## Testing
+
+Run the test from this package:
+
+```sh
+npm run test
+```
+
+Alternatively, run the tests from the monorepo root:
+
+```sh
+npm run test -w @ucalgary-design-system/ucds-text-area
+``` 
+
+

package/index.js

@@ -0,0 +1,410 @@
+import { BaseElement as U, injectGlobalTokens as O } from "@ucalgary-design-system/core";
+import { unsafeCSS as A, nothing as m, html as y } from "lit";
+import "@ucalgary-design-system/helper-components";
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const T = (i) => (t, e) => {
+  e !== void 0 ? e.addInitializer(() => {
+    customElements.define(i, t);
+  }) : customElements.define(i, t);
+};
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const b = globalThis, g = b.ShadowRoot && (b.ShadyCSS === void 0 || b.ShadyCSS.nativeShadow) && "adoptedStyleSheets" in Document.prototype && "replace" in CSSStyleSheet.prototype, C = Symbol(), S = /* @__PURE__ */ new WeakMap();
+let k = class {
+  constructor(t, e, r) {
+    if (this._$cssResult$ = !0, r !== C) throw Error("CSSResult is not constructable. Use `unsafeCSS` or `css` instead.");
+    this.cssText = t, this.t = e;
+  }
+  get styleSheet() {
+    let t = this.o;
+    const e = this.t;
+    if (g && t === void 0) {
+      const r = e !== void 0 && e.length === 1;
+      r && (t = S.get(e)), t === void 0 && ((this.o = t = new CSSStyleSheet()).replaceSync(this.cssText), r && S.set(e, t));
+    }
+    return t;
+  }
+  toString() {
+    return this.cssText;
+  }
+};
+const M = (i) => new k(typeof i == "string" ? i : i + "", void 0, C), R = (i, t) => {
+  if (g) i.adoptedStyleSheets = t.map((e) => e instanceof CSSStyleSheet ? e : e.styleSheet);
+  else for (const e of t) {
+    const r = document.createElement("style"), s = b.litNonce;
+    s !== void 0 && r.setAttribute("nonce", s), r.textContent = e.cssText, i.appendChild(r);
+  }
+}, x = g ? (i) => i : (i) => i instanceof CSSStyleSheet ? ((t) => {
+  let e = "";
+  for (const r of t.cssRules) e += r.cssText;
+  return M(e);
+})(i) : i;
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const { is: q, defineProperty: z, getOwnPropertyDescriptor: j, getOwnPropertyNames: D, getOwnPropertySymbols: I, getPrototypeOf: L } = Object, c = globalThis, w = c.trustedTypes, B = w ? w.emptyScript : "", v = c.reactiveElementPolyfillSupport, f = (i, t) => i, $ = { toAttribute(i, t) {
+  switch (t) {
+    case Boolean:
+      i = i ? B : null;
+      break;
+    case Object:
+    case Array:
+      i = i == null ? i : JSON.stringify(i);
+  }
+  return i;
+}, fromAttribute(i, t) {
+  let e = i;
+  switch (t) {
+    case Boolean:
+      e = i !== null;
+      break;
+    case Number:
+      e = i === null ? null : Number(i);
+      break;
+    case Object:
+    case Array:
+      try {
+        e = JSON.parse(i);
+      } catch {
+        e = null;
+      }
+  }
+  return e;
+} }, _ = (i, t) => !q(i, t), P = { attribute: !0, type: String, converter: $, reflect: !1, useDefault: !1, hasChanged: _ };
+Symbol.metadata ?? (Symbol.metadata = Symbol("metadata")), c.litPropertyMetadata ?? (c.litPropertyMetadata = /* @__PURE__ */ new WeakMap());
+class u extends HTMLElement {
+  static addInitializer(t) {
+    this._$Ei(), (this.l ?? (this.l = [])).push(t);
+  }
+  static get observedAttributes() {
+    return this.finalize(), this._$Eh && [...this._$Eh.keys()];
+  }
+  static createProperty(t, e = P) {
+    if (e.state && (e.attribute = !1), this._$Ei(), this.prototype.hasOwnProperty(t) && ((e = Object.create(e)).wrapped = !0), this.elementProperties.set(t, e), !e.noAccessor) {
+      const r = Symbol(), s = this.getPropertyDescriptor(t, r, e);
+      s !== void 0 && z(this.prototype, t, s);
+    }
+  }
+  static getPropertyDescriptor(t, e, r) {
+    const { get: s, set: o } = j(this.prototype, t) ?? { get() {
+      return this[e];
+    }, set(a) {
+      this[e] = a;
+    } };
+    return { get: s, set(a) {
+      const n = s == null ? void 0 : s.call(this);
+      o == null || o.call(this, a), this.requestUpdate(t, n, r);
+    }, configurable: !0, enumerable: !0 };
+  }
+  static getPropertyOptions(t) {
+    return this.elementProperties.get(t) ?? P;
+  }
+  static _$Ei() {
+    if (this.hasOwnProperty(f("elementProperties"))) return;
+    const t = L(this);
+    t.finalize(), t.l !== void 0 && (this.l = [...t.l]), this.elementProperties = new Map(t.elementProperties);
+  }
+  static finalize() {
+    if (this.hasOwnProperty(f("finalized"))) return;
+    if (this.finalized = !0, this._$Ei(), this.hasOwnProperty(f("properties"))) {
+      const e = this.properties, r = [...D(e), ...I(e)];
+      for (const s of r) this.createProperty(s, e[s]);
+    }
+    const t = this[Symbol.metadata];
+    if (t !== null) {
+      const e = litPropertyMetadata.get(t);
+      if (e !== void 0) for (const [r, s] of e) this.elementProperties.set(r, s);
+    }
+    this._$Eh = /* @__PURE__ */ new Map();
+    for (const [e, r] of this.elementProperties) {
+      const s = this._$Eu(e, r);
+      s !== void 0 && this._$Eh.set(s, e);
+    }
+    this.elementStyles = this.finalizeStyles(this.styles);
+  }
+  static finalizeStyles(t) {
+    const e = [];
+    if (Array.isArray(t)) {
+      const r = new Set(t.flat(1 / 0).reverse());
+      for (const s of r) e.unshift(x(s));
+    } else t !== void 0 && e.push(x(t));
+    return e;
+  }
+  static _$Eu(t, e) {
+    const r = e.attribute;
+    return r === !1 ? void 0 : typeof r == "string" ? r : typeof t == "string" ? t.toLowerCase() : void 0;
+  }
+  constructor() {
+    super(), this._$Ep = void 0, this.isUpdatePending = !1, this.hasUpdated = !1, this._$Em = null, this._$Ev();
+  }
+  _$Ev() {
+    var t;
+    this._$ES = new Promise((e) => this.enableUpdating = e), this._$AL = /* @__PURE__ */ new Map(), this._$E_(), this.requestUpdate(), (t = this.constructor.l) == null || t.forEach((e) => e(this));
+  }
+  addController(t) {
+    var e;
+    (this._$EO ?? (this._$EO = /* @__PURE__ */ new Set())).add(t), this.renderRoot !== void 0 && this.isConnected && ((e = t.hostConnected) == null || e.call(t));
+  }
+  removeController(t) {
+    var e;
+    (e = this._$EO) == null || e.delete(t);
+  }
+  _$E_() {
+    const t = /* @__PURE__ */ new Map(), e = this.constructor.elementProperties;
+    for (const r of e.keys()) this.hasOwnProperty(r) && (t.set(r, this[r]), delete this[r]);
+    t.size > 0 && (this._$Ep = t);
+  }
+  createRenderRoot() {
+    const t = this.shadowRoot ?? this.attachShadow(this.constructor.shadowRootOptions);
+    return R(t, this.constructor.elementStyles), t;
+  }
+  connectedCallback() {
+    var t;
+    this.renderRoot ?? (this.renderRoot = this.createRenderRoot()), this.enableUpdating(!0), (t = this._$EO) == null || t.forEach((e) => {
+      var r;
+      return (r = e.hostConnected) == null ? void 0 : r.call(e);
+    });
+  }
+  enableUpdating(t) {
+  }
+  disconnectedCallback() {
+    var t;
+    (t = this._$EO) == null || t.forEach((e) => {
+      var r;
+      return (r = e.hostDisconnected) == null ? void 0 : r.call(e);
+    });
+  }
+  attributeChangedCallback(t, e, r) {
+    this._$AK(t, r);
+  }
+  _$ET(t, e) {
+    var o;
+    const r = this.constructor.elementProperties.get(t), s = this.constructor._$Eu(t, r);
+    if (s !== void 0 && r.reflect === !0) {
+      const a = (((o = r.converter) == null ? void 0 : o.toAttribute) !== void 0 ? r.converter : $).toAttribute(e, r.type);
+      this._$Em = t, a == null ? this.removeAttribute(s) : this.setAttribute(s, a), this._$Em = null;
+    }
+  }
+  _$AK(t, e) {
+    var o, a;
+    const r = this.constructor, s = r._$Eh.get(t);
+    if (s !== void 0 && this._$Em !== s) {
+      const n = r.getPropertyOptions(s), d = typeof n.converter == "function" ? { fromAttribute: n.converter } : ((o = n.converter) == null ? void 0 : o.fromAttribute) !== void 0 ? n.converter : $;
+      this._$Em = s;
+      const E = d.fromAttribute(e, n.type);
+      this[s] = E ?? ((a = this._$Ej) == null ? void 0 : a.get(s)) ?? E, this._$Em = null;
+    }
+  }
+  requestUpdate(t, e, r) {
+    var s;
+    if (t !== void 0) {
+      const o = this.constructor, a = this[t];
+      if (r ?? (r = o.getPropertyOptions(t)), !((r.hasChanged ?? _)(a, e) || r.useDefault && r.reflect && a === ((s = this._$Ej) == null ? void 0 : s.get(t)) && !this.hasAttribute(o._$Eu(t, r)))) return;
+      this.C(t, e, r);
+    }
+    this.isUpdatePending === !1 && (this._$ES = this._$EP());
+  }
+  C(t, e, { useDefault: r, reflect: s, wrapped: o }, a) {
+    r && !(this._$Ej ?? (this._$Ej = /* @__PURE__ */ new Map())).has(t) && (this._$Ej.set(t, a ?? e ?? this[t]), o !== !0 || a !== void 0) || (this._$AL.has(t) || (this.hasUpdated || r || (e = void 0), this._$AL.set(t, e)), s === !0 && this._$Em !== t && (this._$Eq ?? (this._$Eq = /* @__PURE__ */ new Set())).add(t));
+  }
+  async _$EP() {
+    this.isUpdatePending = !0;
+    try {
+      await this._$ES;
+    } catch (e) {
+      Promise.reject(e);
+    }
+    const t = this.scheduleUpdate();
+    return t != null && await t, !this.isUpdatePending;
+  }
+  scheduleUpdate() {
+    return this.performUpdate();
+  }
+  performUpdate() {
+    var r;
+    if (!this.isUpdatePending) return;
+    if (!this.hasUpdated) {
+      if (this.renderRoot ?? (this.renderRoot = this.createRenderRoot()), this._$Ep) {
+        for (const [o, a] of this._$Ep) this[o] = a;
+        this._$Ep = void 0;
+      }
+      const s = this.constructor.elementProperties;
+      if (s.size > 0) for (const [o, a] of s) {
+        const { wrapped: n } = a, d = this[o];
+        n !== !0 || this._$AL.has(o) || d === void 0 || this.C(o, void 0, a, d);
+      }
+    }
+    let t = !1;
+    const e = this._$AL;
+    try {
+      t = this.shouldUpdate(e), t ? (this.willUpdate(e), (r = this._$EO) == null || r.forEach((s) => {
+        var o;
+        return (o = s.hostUpdate) == null ? void 0 : o.call(s);
+      }), this.update(e)) : this._$EM();
+    } catch (s) {
+      throw t = !1, this._$EM(), s;
+    }
+    t && this._$AE(e);
+  }
+  willUpdate(t) {
+  }
+  _$AE(t) {
+    var e;
+    (e = this._$EO) == null || e.forEach((r) => {
+      var s;
+      return (s = r.hostUpdated) == null ? void 0 : s.call(r);
+    }), this.hasUpdated || (this.hasUpdated = !0, this.firstUpdated(t)), this.updated(t);
+  }
+  _$EM() {
+    this._$AL = /* @__PURE__ */ new Map(), this.isUpdatePending = !1;
+  }
+  get updateComplete() {
+    return this.getUpdateComplete();
+  }
+  getUpdateComplete() {
+    return this._$ES;
+  }
+  shouldUpdate(t) {
+    return !0;
+  }
+  update(t) {
+    this._$Eq && (this._$Eq = this._$Eq.forEach((e) => this._$ET(e, this[e]))), this._$EM();
+  }
+  updated(t) {
+  }
+  firstUpdated(t) {
+  }
+}
+u.elementStyles = [], u.shadowRootOptions = { mode: "open" }, u[f("elementProperties")] = /* @__PURE__ */ new Map(), u[f("finalized")] = /* @__PURE__ */ new Map(), v == null || v({ ReactiveElement: u }), (c.reactiveElementVersions ?? (c.reactiveElementVersions = [])).push("2.1.1");
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const N = { attribute: !0, type: String, converter: $, reflect: !1, hasChanged: _ }, V = (i = N, t, e) => {
+  const { kind: r, metadata: s } = e;
+  let o = globalThis.litPropertyMetadata.get(s);
+  if (o === void 0 && globalThis.litPropertyMetadata.set(s, o = /* @__PURE__ */ new Map()), r === "setter" && ((i = Object.create(i)).wrapped = !0), o.set(e.name, i), r === "accessor") {
+    const { name: a } = e;
+    return { set(n) {
+      const d = t.get.call(this);
+      t.set.call(this, n), this.requestUpdate(a, d, i);
+    }, init(n) {
+      return n !== void 0 && this.C(a, void 0, i, n), n;
+    } };
+  }
+  if (r === "setter") {
+    const { name: a } = e;
+    return function(n) {
+      const d = this[a];
+      t.call(this, n), this.requestUpdate(a, d, i);
+    };
+  }
+  throw Error("Unsupported decorator location: " + r);
+};
+function p(i) {
+  return (t, e) => typeof e == "object" ? V(i, t, e) : ((r, s, o) => {
+    const a = s.hasOwnProperty(o);
+    return s.constructor.createProperty(o, r), a ? Object.getOwnPropertyDescriptor(s, o) : void 0;
+  })(i, t, e);
+}
+const J = ":host{display:block}.text-area{display:flex;flex-direction:column;gap:var(--ucds-form-component-intra-spacing);align-items:start;max-width:var(--ucds-form-element-maxwidth)}.text-area textarea{display:block;min-width:115px;width:var(--ucds-form-element-width);height:96px;padding:16px var(--ucds-form-element-horizontal-padding);line-height:16px;color:var(--ucds-color-text-primary);background-color:var(--ucds-color-forms-input-background-rest);border:var(--ucds-form-element-border-width) solid var(--ucds-color-forms-input-border-rest);border-radius:var(--ucds-form-element-border-radius);transition:border-color .5s ease;resize:none}.text-area textarea:hover{border-color:var(--ucds-color-forms-input-border-hover)}.text-area textarea:focus{outline:var(--ucds-color-action-focus) 2px solid;outline-offset:2px}.text-area textarea::-moz-placeholder{font-style:italic;color:var(--ucds-color-text-secondary);line-height:16px}.text-area textarea::placeholder{font-style:italic;color:var(--ucds-color-text-secondary);line-height:16px}.text-area.error textarea{background-color:var(--ucds-color-feedback-error-background-light);border-color:var(--ucds-color-feedback-error-light)}.text-area.error textarea:hover{border-color:var(--ucds-color-forms-input-border-hover)}.text-area.disabled textarea{color:var(--ucds-color-text-disabled);background-color:transparent;border-color:var(--ucds-color-forms-input-border-disabled)}.text-area.disabled textarea::-moz-placeholder{color:var(--ucds-color-text-disabled)}.text-area.disabled textarea::placeholder{color:var(--ucds-color-text-disabled)}";
+var K = Object.defineProperty, W = Object.getOwnPropertyDescriptor, h = (i, t, e, r) => {
+  for (var s = r > 1 ? void 0 : r ? W(t, e) : t, o = i.length - 1, a; o >= 0; o--)
+    (a = i[o]) && (s = (r ? a(t, e, s) : a(s)) || s);
+  return r && s && K(t, e, s), s;
+};
+let l = class extends U {
+  constructor() {
+    super(), this.label = "", this.helpText = "", this.errorText = "", this.inputId = "", this.error = !1, this.disabled = !1, this.required = !1, this._value = "", this.internals = this.attachInternals();
+  }
+  updated(i) {
+    i.has("label") && !this.label && console.error("Property 'label' is required and was not set for text-area.");
+  }
+  get value() {
+    return this._value;
+  }
+  set value(i) {
+    const t = this._value;
+    i !== t && (this._value = i, this.requestUpdate("value", t), this.internals.setFormValue(this._value));
+  }
+  handleInput(i) {
+    const t = i.target;
+    this.value = t.value;
+  }
+  formResetCallback() {
+    this.value = "";
+  }
+  formStateRestoreCallback(i) {
+    this.value = i;
+  }
+  checkValidity() {
+    return this.internals.checkValidity();
+  }
+  reportValidity() {
+    return this.internals.reportValidity();
+  }
+  render() {
+    return y`
+      <div class="text-area ${this.disabled ? "disabled" : ""} ${this.required ? "required" : ""} ${this.error ? "error" : ""}">
+        ${this.label ? y`<form-label for="${this.inputId}" text="${this.label}" ?required="${this.required}" ?disabled="${this.disabled}"></form-label>` : m}
+        <textarea 
+          id="${this.inputId}" 
+          name="${this.inputId}" 
+          .value="${this.value}" 
+          ?disabled=${this.disabled} 
+          ?required=${this.required} 
+          placeholder="${this.placeholder ?? m}" 
+          @input=${this.handleInput}>
+        </textarea>${this.error && this.errorText ? y`
+        <form-error-message text="${this.errorText}" ?disabled="${this.disabled}"></form-error-message>` : m}${this.helpText ? y`
+        <form-help-message text="${this.helpText}" ?disabled="${this.disabled}"></form-help-message>` : m}
+      </div>
+    `;
+  }
+};
+l.styles = [
+  U.styles,
+  A(J)
+];
+l.formAssociated = !0;
+h([
+  p({ type: String })
+], l.prototype, "label", 2);
+h([
+  p({ type: String, attribute: "help-text" })
+], l.prototype, "helpText", 2);
+h([
+  p({ type: String, attribute: "error-text" })
+], l.prototype, "errorText", 2);
+h([
+  p({ type: String, attribute: "input-id" })
+], l.prototype, "inputId", 2);
+h([
+  p({ type: String, reflect: !0 })
+], l.prototype, "placeholder", 2);
+h([
+  p({ type: Boolean, reflect: !0 })
+], l.prototype, "error", 2);
+h([
+  p({ type: Boolean, reflect: !0 })
+], l.prototype, "disabled", 2);
+h([
+  p({ type: Boolean, reflect: !0 })
+], l.prototype, "required", 2);
+l = h([
+  T("ucds-text-area")
+], l);
+O();
+export {
+  l as TextArea
+};

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@ucalgary-design-system/text-area",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "index.js",
+  "module": "index.js",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.js"
+    }
+  },
+  "peerDependencies": {
+    "@ucalgary-design-system/core": "^1.0.6",
+    "@ucalgary-design-system/tokens": "^1.0.0",
+    "@ucalgary-design-system/helper-components": "^1.0.2",
+    "lit": "^3.2.1"
+  },
+  "description": "A web component for TextArea",
+  "publishConfig": {
+    "access": "public"
+  }
+}