@ucalgary-design-system/fieldset 1.0.1

package/README.md

@@ -0,0 +1,57 @@
+# Fieldset
+
+This package provides the **Fieldset** web component.
+
+## Installation
+
+Install the component using npm:
+
+```sh
+npm install @ucalgary-design-system/fieldset
+```
+
+## Usage
+
+Import the component into your application:
+
+```ts
+import '@ucalgary-design-system/fieldset';
+```
+
+Use the component in your HTML:
+
+```html
+<ucds-fieldset></ucds-fieldset>
+```
+
+## Development
+
+Build the component:
+
+```sh
+npm run build
+```
+
+Alternatively, build from the monorepo root:
+
+```sh
+npm run build -w @ucalgary-design-system/ucds-fieldset
+``` 
+
+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-fieldset
+``` 
+
+

package/fieldset.css

@@ -0,0 +1 @@
+:root{--ucds-color-palette-brand-red: #d6001c;--ucds-color-palette-brand-gold: #ffcd00;--ucds-color-palette-brand-light-orange: #ffa300;--ucds-color-palette-brand-dark-orange: #ff7b1f;--ucds-color-palette-brand-berry: #9c0534;--ucds-color-palette-brand-rubine: #ce0058;--ucds-color-palette-brand-brown: #6b3529;--ucds-color-palette-brand-teal: #47a67c;--ucds-color-palette-white: #ffffff;--ucds-color-palette-black: #000000;--ucds-color-palette-gray-100: #2d2d2d;--ucds-color-palette-gray-200: #3d3d3d;--ucds-color-palette-gray-250: #4d4d4d;--ucds-color-palette-gray-300: #5d5d5d;--ucds-color-palette-gray-400: #8d8d8d;--ucds-color-palette-gray-500: #adadad;--ucds-color-palette-gray-600: #c0c0c0;--ucds-color-palette-gray-700: #d8d8d8;--ucds-color-palette-gray-800: #e5e5e5;--ucds-color-palette-gray-900: #f4f4f4;--ucds-color-palette-red-100: #3d0910;--ucds-color-palette-red-200: #5c0e18;--ucds-color-palette-red-300: #7a111f;--ucds-color-palette-red-400: #991022;--ucds-color-palette-red-500: #b70b21;--ucds-color-palette-red-600: #d6001c;--ucds-color-palette-red-700: #df3047;--ucds-color-palette-red-800: #ee0e2c;--ucds-color-palette-red-900: #ffadad;--ucds-color-palette-berry-600: #9c0534;--ucds-color-palette-berry-700: #a6192e;--ucds-color-palette-berry-800: #ea7b8a;--ucds-color-palette-berry-900: #f6ebed;--ucds-color-palette-rubine-600: #ce0058;--ucds-color-palette-rubine-800: #ed0a72;--ucds-color-palette-rubine-900: #ffa3c9;--ucds-color-palette-dark-orange-200: #6b3529;--ucds-color-palette-dark-orange-600: #ff671f;--ucds-color-palette-dark-orange-900: #fff2e9;--ucds-color-palette-light-orange-200: #614e00;--ucds-color-palette-light-orange-600: #ffa300;--ucds-color-palette-light-orange-900: #fff6e7;--ucds-color-palette-brown-600: #6c3302;--ucds-color-palette-brown-900: #ca7d68;--ucds-color-surface-page: #ffffff;--ucds-color-surface-primary: #ffffff;--ucds-color-border-neutral: #8d8d8d;--ucds-color-text-primary: #2d2d2d;--ucds-color-text-primary-inverse: #ffffff;--ucds-color-text-secondary: #5d5d5d;--ucds-color-text-error: #df3047;--ucds-color-text-disabled: #e5e5e5;--ucds-color-icon-primary: #2d2d2d;--ucds-color-icon-primary-inverse: #ffffff;--ucds-color-forms-input-background-rest: #ffffff;--ucds-color-forms-input-background-hover: #9c0534;--ucds-color-forms-input-background-active: #9c0534;--ucds-color-forms-input-background-selected: #9c0534;--ucds-color-forms-input-background-disabled: #e5e5e5;--ucds-color-forms-input-background-error: rgb(255 173 173 / 50%);--ucds-color-forms-input-border-rest: #8d8d8d;--ucds-color-forms-input-border-hover: #3d3d3d;--ucds-color-forms-input-border-active: #3d3d3d;--ucds-color-forms-input-border-selected: #9c0534;--ucds-color-forms-input-border-disabled: #e5e5e5;--ucds-color-forms-input-border-error: #df3047;--ucds-color-forms-input-element-disabled: #f4f4f4;--ucds-color-action-rest: #d6001c;--ucds-color-action-hover: #991022;--ucds-color-action-active: #991022;--ucds-color-action-focus: #4d4d4d;--ucds-color-action-visited: #991022;--ucds-color-action-secondary-rest: #2d2d2d;--ucds-color-action-secondary-hover: #4d4d4d;--ucds-color-action-secondary-active: #4d4d4d;--ucds-color-action-secondary-focus: #4d4d4d;--ucds-color-action-inverse-rest: #ffffff;--ucds-color-action-inverse-hover: #e5e5e5;--ucds-color-action-inverse-active: #e5e5e5;--ucds-color-action-inverse-focus: #ffffff;--ucds-color-feedback-error-light: #df3047;--ucds-color-feedback-error-background-light: rgb(255 173 173 / 50%);--ucds-font-base-size: 16px;--ucds-font-base-line-height: 24px;--ucds-font-base-weight-light: 200;--ucds-font-base-weight-normal: 400;--ucds-font-base-weight-medium: 500;--ucds-font-base-weight-semibold: 600;--ucds-font-base-weight-bold: 700;--ucds-font-sans-serif-family: "Proxima Nova", Arial, Helvetica, sans-serif;--ucds-font-serif-family: "Museo Slab", "Proxima Nova", Arial, Helvetica, sans-serif;--ucds-form-element-border-radius: 8px;--ucds-form-element-border-width: 2px;--ucds-form-element-height: 48px;--ucds-form-element-width: 100%;--ucds-form-element-maxwidth: 555px;--ucds-form-element-horizontal-padding: 16px;--ucds-form-component-intra-spacing: 8px;--ucds-form-component-inter-spacing: 16px}

package/index.js

@@ -0,0 +1,380 @@
+import { unsafeCSS as A, nothing as m, html as p } from "lit";
+import { BaseElement as U } from "@ucalgary-design-system/core";
+import { FormLabel as C } from "@ucalgary-design-system/helper-components";
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const x = (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 y = globalThis, _ = y.ShadowRoot && (y.ShadyCSS === void 0 || y.ShadyCSS.nativeShadow) && "adoptedStyleSheets" in Document.prototype && "replace" in CSSStyleSheet.prototype, O = Symbol(), S = /* @__PURE__ */ new WeakMap();
+let T = class {
+  constructor(t, e, s) {
+    if (this._$cssResult$ = !0, s !== O) 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 (_ && t === void 0) {
+      const s = e !== void 0 && e.length === 1;
+      s && (t = S.get(e)), t === void 0 && ((this.o = t = new CSSStyleSheet()).replaceSync(this.cssText), s && S.set(e, t));
+    }
+    return t;
+  }
+  toString() {
+    return this.cssText;
+  }
+};
+const R = (i) => new T(typeof i == "string" ? i : i + "", void 0, O), M = (i, t) => {
+  if (_) i.adoptedStyleSheets = t.map((e) => e instanceof CSSStyleSheet ? e : e.styleSheet);
+  else for (const e of t) {
+    const s = document.createElement("style"), r = y.litNonce;
+    r !== void 0 && s.setAttribute("nonce", r), s.textContent = e.cssText, i.appendChild(s);
+  }
+}, v = _ ? (i) => i : (i) => i instanceof CSSStyleSheet ? ((t) => {
+  let e = "";
+  for (const s of t.cssRules) e += s.cssText;
+  return R(e);
+})(i) : i;
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const { is: z, defineProperty: j, getOwnPropertyDescriptor: q, getOwnPropertyNames: k, getOwnPropertySymbols: L, getPrototypeOf: D } = Object, h = globalThis, w = h.trustedTypes, N = w ? w.emptyScript : "", g = h.reactiveElementPolyfillSupport, f = (i, t) => i, $ = { toAttribute(i, t) {
+  switch (t) {
+    case Boolean:
+      i = i ? N : 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;
+} }, E = (i, t) => !z(i, t), P = { attribute: !0, type: String, converter: $, reflect: !1, hasChanged: E };
+Symbol.metadata ?? (Symbol.metadata = Symbol("metadata")), h.litPropertyMetadata ?? (h.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.elementProperties.set(t, e), !e.noAccessor) {
+      const s = Symbol(), r = this.getPropertyDescriptor(t, s, e);
+      r !== void 0 && j(this.prototype, t, r);
+    }
+  }
+  static getPropertyDescriptor(t, e, s) {
+    const { get: r, set: n } = q(this.prototype, t) ?? { get() {
+      return this[e];
+    }, set(o) {
+      this[e] = o;
+    } };
+    return { get() {
+      return r == null ? void 0 : r.call(this);
+    }, set(o) {
+      const a = r == null ? void 0 : r.call(this);
+      n.call(this, o), this.requestUpdate(t, a, s);
+    }, configurable: !0, enumerable: !0 };
+  }
+  static getPropertyOptions(t) {
+    return this.elementProperties.get(t) ?? P;
+  }
+  static _$Ei() {
+    if (this.hasOwnProperty(f("elementProperties"))) return;
+    const t = D(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, s = [...k(e), ...L(e)];
+      for (const r of s) this.createProperty(r, e[r]);
+    }
+    const t = this[Symbol.metadata];
+    if (t !== null) {
+      const e = litPropertyMetadata.get(t);
+      if (e !== void 0) for (const [s, r] of e) this.elementProperties.set(s, r);
+    }
+    this._$Eh = /* @__PURE__ */ new Map();
+    for (const [e, s] of this.elementProperties) {
+      const r = this._$Eu(e, s);
+      r !== void 0 && this._$Eh.set(r, e);
+    }
+    this.elementStyles = this.finalizeStyles(this.styles);
+  }
+  static finalizeStyles(t) {
+    const e = [];
+    if (Array.isArray(t)) {
+      const s = new Set(t.flat(1 / 0).reverse());
+      for (const r of s) e.unshift(v(r));
+    } else t !== void 0 && e.push(v(t));
+    return e;
+  }
+  static _$Eu(t, e) {
+    const s = e.attribute;
+    return s === !1 ? void 0 : typeof s == "string" ? s : 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 s of e.keys()) this.hasOwnProperty(s) && (t.set(s, this[s]), delete this[s]);
+    t.size > 0 && (this._$Ep = t);
+  }
+  createRenderRoot() {
+    const t = this.shadowRoot ?? this.attachShadow(this.constructor.shadowRootOptions);
+    return M(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 s;
+      return (s = e.hostConnected) == null ? void 0 : s.call(e);
+    });
+  }
+  enableUpdating(t) {
+  }
+  disconnectedCallback() {
+    var t;
+    (t = this._$EO) == null || t.forEach((e) => {
+      var s;
+      return (s = e.hostDisconnected) == null ? void 0 : s.call(e);
+    });
+  }
+  attributeChangedCallback(t, e, s) {
+    this._$AK(t, s);
+  }
+  _$EC(t, e) {
+    var n;
+    const s = this.constructor.elementProperties.get(t), r = this.constructor._$Eu(t, s);
+    if (r !== void 0 && s.reflect === !0) {
+      const o = (((n = s.converter) == null ? void 0 : n.toAttribute) !== void 0 ? s.converter : $).toAttribute(e, s.type);
+      this._$Em = t, o == null ? this.removeAttribute(r) : this.setAttribute(r, o), this._$Em = null;
+    }
+  }
+  _$AK(t, e) {
+    var n;
+    const s = this.constructor, r = s._$Eh.get(t);
+    if (r !== void 0 && this._$Em !== r) {
+      const o = s.getPropertyOptions(r), a = typeof o.converter == "function" ? { fromAttribute: o.converter } : ((n = o.converter) == null ? void 0 : n.fromAttribute) !== void 0 ? o.converter : $;
+      this._$Em = r, this[r] = a.fromAttribute(e, o.type), this._$Em = null;
+    }
+  }
+  requestUpdate(t, e, s) {
+    if (t !== void 0) {
+      if (s ?? (s = this.constructor.getPropertyOptions(t)), !(s.hasChanged ?? E)(this[t], e)) return;
+      this.P(t, e, s);
+    }
+    this.isUpdatePending === !1 && (this._$ES = this._$ET());
+  }
+  P(t, e, s) {
+    this._$AL.has(t) || this._$AL.set(t, e), s.reflect === !0 && this._$Em !== t && (this._$Ej ?? (this._$Ej = /* @__PURE__ */ new Set())).add(t);
+  }
+  async _$ET() {
+    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 s;
+    if (!this.isUpdatePending) return;
+    if (!this.hasUpdated) {
+      if (this.renderRoot ?? (this.renderRoot = this.createRenderRoot()), this._$Ep) {
+        for (const [n, o] of this._$Ep) this[n] = o;
+        this._$Ep = void 0;
+      }
+      const r = this.constructor.elementProperties;
+      if (r.size > 0) for (const [n, o] of r) o.wrapped !== !0 || this._$AL.has(n) || this[n] === void 0 || this.P(n, this[n], o);
+    }
+    let t = !1;
+    const e = this._$AL;
+    try {
+      t = this.shouldUpdate(e), t ? (this.willUpdate(e), (s = this._$EO) == null || s.forEach((r) => {
+        var n;
+        return (n = r.hostUpdate) == null ? void 0 : n.call(r);
+      }), this.update(e)) : this._$EU();
+    } catch (r) {
+      throw t = !1, this._$EU(), r;
+    }
+    t && this._$AE(e);
+  }
+  willUpdate(t) {
+  }
+  _$AE(t) {
+    var e;
+    (e = this._$EO) == null || e.forEach((s) => {
+      var r;
+      return (r = s.hostUpdated) == null ? void 0 : r.call(s);
+    }), this.hasUpdated || (this.hasUpdated = !0, this.firstUpdated(t)), this.updated(t);
+  }
+  _$EU() {
+    this._$AL = /* @__PURE__ */ new Map(), this.isUpdatePending = !1;
+  }
+  get updateComplete() {
+    return this.getUpdateComplete();
+  }
+  getUpdateComplete() {
+    return this._$ES;
+  }
+  shouldUpdate(t) {
+    return !0;
+  }
+  update(t) {
+    this._$Ej && (this._$Ej = this._$Ej.forEach((e) => this._$EC(e, this[e]))), this._$EU();
+  }
+  updated(t) {
+  }
+  firstUpdated(t) {
+  }
+}
+u.elementStyles = [], u.shadowRootOptions = { mode: "open" }, u[f("elementProperties")] = /* @__PURE__ */ new Map(), u[f("finalized")] = /* @__PURE__ */ new Map(), g == null || g({ ReactiveElement: u }), (h.reactiveElementVersions ?? (h.reactiveElementVersions = [])).push("2.0.4");
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const B = { attribute: !0, type: String, converter: $, reflect: !1, hasChanged: E }, F = (i = B, t, e) => {
+  const { kind: s, metadata: r } = e;
+  let n = globalThis.litPropertyMetadata.get(r);
+  if (n === void 0 && globalThis.litPropertyMetadata.set(r, n = /* @__PURE__ */ new Map()), n.set(e.name, i), s === "accessor") {
+    const { name: o } = e;
+    return { set(a) {
+      const b = t.get.call(this);
+      t.set.call(this, a), this.requestUpdate(o, b, i);
+    }, init(a) {
+      return a !== void 0 && this.P(o, void 0, i), a;
+    } };
+  }
+  if (s === "setter") {
+    const { name: o } = e;
+    return function(a) {
+      const b = this[o];
+      t.call(this, a), this.requestUpdate(o, b, i);
+    };
+  }
+  throw Error("Unsupported decorator location: " + s);
+};
+function c(i) {
+  return (t, e) => typeof e == "object" ? F(i, t, e) : ((s, r, n) => {
+    const o = r.hasOwnProperty(n);
+    return r.constructor.createProperty(n, o ? { ...s, wrapped: !0 } : s), o ? Object.getOwnPropertyDescriptor(r, n) : void 0;
+  })(i, t, e);
+}
+const I = ":host{display:block}.form-fieldset{width:var(--ucds-form-element-width);max-width:var(--ucds-form-element-maxwidth);display:flex;flex-direction:column;gap:var(--ucds-form-component-intra-spacing)}.form-fieldset fieldset{border:none;padding:0;margin:0;display:flex;flex-direction:column;gap:var(--ucds-form-component-inter-spacing)}.form-fieldset fieldset legend{font-weight:var(--ucds-font-base-weight-bold);margin-bottom:var(--ucds-form-component-inter-spacing);padding:0}.form-fieldset fieldset legend:disabled{color:var(--ucds-color-text-disabled)}.form-fieldset fieldset:not(:last-child){margin-bottom:var(--ucds-form-component-intra-spacing)}";
+var J = Object.defineProperty, K = Object.getOwnPropertyDescriptor, d = (i, t, e, s) => {
+  for (var r = s > 1 ? void 0 : s ? K(t, e) : t, n = i.length - 1, o; n >= 0; n--)
+    (o = i[n]) && (r = (s ? o(t, e, r) : o(r)) || r);
+  return s && r && J(t, e, r), r;
+};
+let l = class extends U {
+  constructor() {
+    super(...arguments), this.label = "", this.disabled = !1, this.required = !1, this.error = !1;
+  }
+  // Iterate over children (checkboxes/radios) and update disabled/errored states.
+  _updateChildren() {
+    if (this.hasChildNodes())
+      for (const i of this.children)
+        i.disabled = this.disabled, i.errors = this.error, i.error = !1, i.required = !1;
+  }
+  // Catch & handle any updates to the fieldset disabled/errored states.
+  update(i) {
+    super.update(i), (i.has("disabled") || i.has("error")) && this._updateChildren();
+  }
+  // Initialize component and warn if required properties have not been set.
+  firstUpdated(i) {
+    super.firstUpdated(i), this.label || console.error(`${this.localName}: Property 'label' is required and was not set.`);
+  }
+  render() {
+    return p`
+      <div class="form-fieldset">
+        <fieldset ?error=${this.error} ?disabled=${this.disabled}>
+          ${this.label ? p`<legend ?disabled=${this.disabled}>${this.label}${this.required ? p`${C.requiredAsteriskTemplate()}` : m}</legend>` : m}
+          <slot>Please provide at least two &lt;ucds-radio&gt; or &lt;ucds-checkbox&gt; child elements</slot>
+        </fieldset>
+        ${this.error && !this.disabled ? p`<form-error-message text="${this.errorText}"></form-error-message>` : m}
+        ${this.helpText ? p`<form-help-message text="${this.helpText}" ?disabled="${this.disabled}"></form-help-message>` : m}
+      </div>
+    `;
+  }
+};
+l.styles = [
+  U.styles,
+  C.styles,
+  A(I)
+];
+d([
+  c({ type: String })
+], l.prototype, "label", 2);
+d([
+  c({ type: Boolean, reflect: !0 })
+], l.prototype, "disabled", 2);
+d([
+  c({ type: Boolean, reflect: !0 })
+], l.prototype, "required", 2);
+d([
+  c({ type: Boolean, reflect: !0 })
+], l.prototype, "error", 2);
+d([
+  c({ type: String, attribute: "error-text" })
+], l.prototype, "errorText", 2);
+d([
+  c({ type: String, attribute: "help-text" })
+], l.prototype, "helpText", 2);
+l = d([
+  x("ucds-fieldset")
+], l);
+export {
+  l as Fieldset
+};

package/package.json

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