@vonage/vivid 5.1.0 → 5.3.0

package/bundled/mixins.js

@@ -1,102 +1,108 @@
-import { d as k, h as d, V as _, a as y, H as $, D as F, O as f, o as x } from "./vivid-element.js";
-import { i as I, I as D } from "./definition2.js";
-import { v as w } from "./definition12.js";
-import { c as C } from "./class-names.js";
-import { w as u } from "./when.js";
-import { L as S } from "./localized.js";
-import { s as T } from "./slotted.js";
-const H = ":host{display:contents}.message{display:flex;contain:inline-size;font:var(--vvd-typography-base-condensed);gap:4px;grid-column:1/-1}.message.none-message{display:none}.message.helper-message{color:var(--_low-ink-color)}.message.error-message,.message.success-message{color:var(--vvd-color-canvas-text)}slot{display:inline}.icon{font-size:16px}.error-message .icon{color:var(--vvd-color-alert-500)}.success-message .icon{color:var(--vvd-color-success-500)}.announcement{display:contents}";
-var B = Object.defineProperty, U = (e, t, s, o) => {
-  for (var n = void 0, r = e.length - 1, a; r >= 0; r--)
-    (a = e[r]) && (n = a(t, s, n) || n);
-  return n && B(t, s, n), n;
+import { n as k } from "./normalize.js";
+import { d as _, h as d, V as $, a as y, M as F, H as I, o as f } from "./vivid-element.js";
+import { i as w, I as D } from "./definition2.js";
+import { v as C } from "./definition13.js";
+import { w as m } from "./when.js";
+import { c as B } from "./class-names.js";
+import { L as H } from "./localized.js";
+import { s as x } from "./slotted.js";
+const S = ":host{display:contents}.message{display:flex;contain:inline-size;font:var(--vvd-typography-base-condensed);gap:4px;grid-column:1/-1}.message.none-message{display:none}.message.helper-message{color:var(--_low-ink-color)}.message.error-message,.message.success-message{color:var(--vvd-color-canvas-text)}slot{display:inline}.icon{font-size:16px}.error-message .icon{color:var(--vvd-color-alert-500)}.success-message .icon{color:var(--vvd-color-success-500)}.announcement{display:contents}";
+var M = Object.defineProperty, O = (t, e, o, s) => {
+  for (var n = void 0, r = t.length - 1, a; r >= 0; r--)
+    (a = t[r]) && (n = a(e, o, n) || n);
+  return n && M(e, o, n), n;
 };
-class l extends S(_) {
+class l extends H($) {
   constructor() {
     super(...arguments), this.type = "none";
   }
 }
-U([
+O([
   y
 ], l.prototype, "type");
-function m(e, t, s) {
-  const o = e.tagFor(D);
-  return d`<${o} class="icon" name="${t}" label="${(n) => n.locale.feedbackMessage[s]}"></${o}>`;
+function u(t, e, o) {
+  const s = t.tagFor(D);
+  return d`<${s} class="icon" name="${e}" label="${(n) => n.locale.feedbackMessage[o]}"></${s}>`;
 }
-function V(e) {
-  const t = {
+function U(t) {
+  const e = {
     none: "",
     helper: "",
-    error: m(e, "info-line", "errorIconText"),
-    success: m(e, "check-circle-line", "successIconText")
+    error: u(t, "info-line", "errorIconText"),
+    success: u(t, "check-circle-line", "successIconText")
   };
-  return d`${(s) => t[s.type]}`;
+  return d`${(o) => e[o.type]}`;
 }
-const g = (e) => e === "error", M = (e) => {
-  const t = d`<div
-		class="${(s) => C("message", `${s.type}-message`)}"
+const g = (t) => t === "error", L = (t) => {
+  const e = d`<div
+		class="${(o) => B("message", `${o.type}-message`)}"
 	>
-		${V(e)}<slot></slot>
+		${U(t)}<slot></slot>
 	</div>`;
-  return d`${u((s) => !g(s.type), t)}
+  return d`${m((o) => !g(o.type), e)}
 		<span class="announcement" role="status" aria-live="polite">
-			${u((s) => g(s.type), t)}
+			${m((o) => g(o.type), e)}
 		</span>`;
-}, Z = k(
+}, ee = _(
   "feedback-message",
   l,
-  M,
-  [I, w],
+  L,
+  [w, C],
   {
-    styles: H
+    styles: S
   }
 );
 class P {
-  constructor(t, s) {
-    this.source = null, this.templateBindingObserver = f.binding(
-      t,
+  constructor(e) {
+    this.source = null, this.templateBindingObserver = e.templateBinding.createObserver(
       this,
-      s
+      e
     );
   }
-  bind(t, s) {
-    this.source = t, this.context = s, this.insertionPoint || (this.insertionPoint = document.createComment(""), t.appendChild(this.insertionPoint)), this.handleChange();
-  }
-  unbind() {
-    this.source = null, this.view.unbind(), this.templateBindingObserver.disconnect();
+  bind(e) {
+    this.source = e.source, this.context = e.context, this.controller = e, this.insertionPoint || (this.insertionPoint = document.createComment(""), this.source.appendChild(this.insertionPoint)), this.templateBindingObserver.bind(e), this.handleChange(this.source, this.templateBindingObserver);
   }
+  // unbind(): void {
+  // 	this.source = null;
+  // 	if (this.view) {
+  // 		this.view.unbind();
+  // 	}
+  // 	// The observer will be automatically cleaned up when the behavior is destroyed
+  // }
   /**
    * Handles change of the template itself.
    */
-  handleChange() {
-    this.instantiateTemplate(
-      this.templateBindingObserver.observe(this.source, this.context)
-    );
+  handleChange(e, o) {
+    if (o === this.templateBindingObserver) {
+      const s = this.templateBindingObserver.bind(this.controller);
+      this.instantiateTemplate(s);
+    }
   }
-  instantiateTemplate(t) {
-    this.view && this.view.dispose(), this.view = t.create(), this.view.bind(this.source, this.context), this.view.insertBefore(this.insertionPoint);
+  instantiateTemplate(e) {
+    this.view && this.view.dispose(), this.view = e.create(), this.view.bind(this.source, this.context), this.view.insertBefore(this.insertionPoint);
   }
 }
-class L extends $ {
-  constructor(t) {
-    super(), this.templateBinding = t, this.createPlaceholder = F.createBlockPlaceholder, this.isTemplateBindingVolatile = f.isVolatileBinding(t);
+class T {
+  constructor(e) {
+    this.targetNodeId = "", this.templateBinding = e, this.dataBinding = e;
+  }
+  createHTML(e) {
+    return F.comment(e(this));
   }
   createBehavior() {
-    return new P(
-      this.templateBinding,
-      this.isTemplateBindingVolatile
-    );
+    return new P(this);
   }
 }
-function O(e) {
-  const t = typeof e == "function" ? e : () => e;
-  return new L(t);
+I.define(T);
+function R(t) {
+  const e = k(t);
+  return new T(e);
 }
 const i = [];
-for (let e = 0; e < 256; ++e)
-  i.push((e + 256).toString(16).slice(1));
-function R(e, t = 0) {
-  return (i[e[t + 0]] + i[e[t + 1]] + i[e[t + 2]] + i[e[t + 3]] + "-" + i[e[t + 4]] + i[e[t + 5]] + "-" + i[e[t + 6]] + i[e[t + 7]] + "-" + i[e[t + 8]] + i[e[t + 9]] + "-" + i[e[t + 10]] + i[e[t + 11]] + i[e[t + 12]] + i[e[t + 13]] + i[e[t + 14]] + i[e[t + 15]]).toLowerCase();
+for (let t = 0; t < 256; ++t)
+  i.push((t + 256).toString(16).slice(1));
+function V(t, e = 0) {
+  return (i[t[e + 0]] + i[t[e + 1]] + i[t[e + 2]] + i[t[e + 3]] + "-" + i[t[e + 4]] + i[t[e + 5]] + "-" + i[t[e + 6]] + i[t[e + 7]] + "-" + i[t[e + 8]] + i[t[e + 9]] + "-" + i[t[e + 10]] + i[t[e + 11]] + i[t[e + 12]] + i[t[e + 13]] + i[t[e + 14]] + i[t[e + 15]]).toLowerCase();
 }
 let p;
 const E = new Uint8Array(16);
@@ -109,23 +115,23 @@ function W() {
   return p(E);
 }
 const j = typeof crypto < "u" && crypto.randomUUID && crypto.randomUUID.bind(crypto), b = { randomUUID: j };
-function z(e, t, s) {
-  if (b.randomUUID && !e)
+function z(t, e, o) {
+  if (b.randomUUID && !t)
     return b.randomUUID();
-  e = e || {};
-  const o = e.random ?? e.rng?.() ?? W();
-  if (o.length < 16)
+  t = t || {};
+  const s = t.random ?? t.rng?.() ?? W();
+  if (s.length < 16)
     throw new Error("Random bytes length must be >= 16");
-  return o[6] = o[6] & 15 | 64, o[8] = o[8] & 63 | 128, R(o);
+  return s[6] = s[6] & 15 | 64, s[8] = s[8] & 63 | 128, V(s);
 }
 const v = () => z();
-var A = Object.defineProperty, h = (e, t, s, o) => {
-  for (var n = void 0, r = e.length - 1, a; r >= 0; r--)
-    (a = e[r]) && (n = a(t, s, n) || n);
-  return n && A(t, s, n), n;
+var A = Object.defineProperty, h = (t, e, o, s) => {
+  for (var n = void 0, r = t.length - 1, a; r >= 0; r--)
+    (a = t[r]) && (n = a(e, o, n) || n);
+  return n && A(e, o, n), n;
 };
-const N = (e) => {
-  class t extends e {
+const N = (t) => {
+  class e extends t {
     /**
      * Ids of the feedback content that the control should use for aria-describedby.
      *
@@ -138,8 +144,8 @@ const N = (e) => {
      * @internal
      */
     _internalFeedback() {
-      const o = this._helperTextSlottedContent?.length ? "" : this.helperText, n = this.errorValidationMessage, r = this.successText;
-      return r ? { type: "success", message: r } : n ? { type: "error", message: n } : o ? { type: "helper", message: o } : { type: "none", message: "" };
+      const s = this._helperTextSlottedContent?.length ? "" : this.helperText, n = this.errorValidationMessage, r = this.successText;
+      return r ? { type: "success", message: r } : n ? { type: "error", message: n } : s ? { type: "helper", message: s } : { type: "none", message: "" };
     }
     /**
      * @internal
@@ -150,8 +156,8 @@ const N = (e) => {
     /**
      * @internal
      */
-    _getFeedbackTemplate(o) {
-      const n = o.tagFor(l);
+    _getFeedbackTemplate(s) {
+      const n = s.tagFor(l);
       return d`
 				<${n} id="feedback" :type="${(r) => r._internalFeedback().type}">
 					${(r) => r._internalFeedback().message}
@@ -160,28 +166,28 @@ const N = (e) => {
 					id="slotted-helper-text-feedback"
 					:type="${(r) => r._slottedHelperTextFeedbackType()}"
 				>
-					<slot name="helper-text" ${T("_helperTextSlottedContent")}></slot>
+					<slot name="helper-text" ${x("_helperTextSlottedContent")}></slot>
 				</${n}>
 			`;
     }
   }
   return h([
     y({ attribute: "helper-text" })
-  ], t.prototype, "helperText"), h([
-    x
-  ], t.prototype, "_helperTextSlottedContent"), t;
-}, ee = (e) => {
-  const t = () => `vvd-feedback-${v()}`, s = () => `vvd-slotted-feedback-${v()}`;
-  class o extends N(e) {
+  ], e.prototype, "helperText"), h([
+    f
+  ], e.prototype, "_helperTextSlottedContent"), e;
+}, te = (t) => {
+  const e = () => `vvd-feedback-${v()}`, o = () => `vvd-slotted-feedback-${v()}`;
+  class s extends N(t) {
     constructor() {
-      super(...arguments), this._slottedHelperTextIds = [], this._feedbackId = t();
+      super(...arguments), this._slottedHelperTextIds = [], this._feedbackId = e();
     }
     /**
      * @internal
      */
     _helperTextSlottedContentChanged(r, a) {
       for (const c of a)
-        c.id || (c.id = s());
+        c.id || (c.id = o());
       this._slottedHelperTextIds = a.map((c) => c.id);
     }
     /**
@@ -197,7 +203,7 @@ const N = (e) => {
       const a = r.tagFor(l);
       return d`
 				<slot name="_feedback"></slot>
-				${O(d`<${a}
+				${R(d`<${a}
 					slot="_feedback"
 					id="${(c) => c._feedbackId}"
 					:type="${(c) => c._internalFeedback().type}"
@@ -207,20 +213,20 @@ const N = (e) => {
 				<${a} :type="${(c) => c._slottedHelperTextFeedbackType()}">
 					<slot
 						name="helper-text"
-						${T("_helperTextSlottedContent")}
+						${x("_helperTextSlottedContent")}
 					></slot>
 				</${a}>
 			`;
     }
   }
   return h([
-    x
-  ], o.prototype, "_slottedHelperTextIds"), o;
+    f
+  ], s.prototype, "_slottedHelperTextIds"), s;
 };
 export {
   N as W,
-  ee as a,
-  Z as f,
+  te as a,
+  ee as f,
   v as g,
-  O as r
+  R as r
 };

package/bundled/normalize.cjs

@@ -0,0 +1 @@
+"use strict";const i=require("./vivid-element.cjs");function e(n){return i.isFunction(n)?i.oneWay(n):n instanceof i.Binding?n:i.oneTime(()=>n)}exports.normalizeBinding=e;

package/bundled/normalize.js

@@ -0,0 +1,7 @@
+import { g as i, u as o, f as s, B as r } from "./vivid-element.js";
+function a(n) {
+  return s(n) ? i(n) : n instanceof r ? n : o(() => n);
+}
+export {
+  a as n
+};

package/bundled/picker-field.template.cjs

@@ -1,6 +1,6 @@
-"use strict";const b=require("./index.cjs"),_=require("./mixins.cjs"),v=require("./form-associated.cjs"),r=require("./vivid-element.cjs"),g=require("./with-error-text.cjs"),$=require("./form-element.cjs"),m=require("./localized.cjs"),k=require("./definition9.cjs"),x=require("./definition13.cjs"),F=require("./definition3.cjs"),p=require("./ref.cjs"),E=require("./slotted.cjs"),h=require("./class-names.cjs"),f=new WeakSet,y=o=>{f.add(o)},C=o=>{class t extends o{_trappedFocus(a,i){if(!f.has(a)&&a.key==="Tab"){const l=i(),s=l[0],e=l[l.length-1];if(a.shiftKey){if(this.shadowRoot.activeElement===s)return e.focus(),!0}else if(this.shadowRoot.activeElement===e)return s.focus(),!0}return!1}}return t},O=":host{display:inline-block}.base{display:inline-block;inline-size:100%}.control{inline-size:100%}.dialog{display:inline-flex;flex-direction:column}.dialog--padded{padding:12px;gap:12px}.dialog .footer{display:flex;align-items:center;justify-content:flex-end;padding:8px;gap:8px}.dialog .footer--with-separator{border-top:1px solid var(--vvd-color-neutral-200)}";var T=Object.defineProperty,u=(o,t,n,a)=>{for(var i=void 0,l=o.length-1,s;l>=0;l--)(s=o[l])&&(i=s(t,n,i)||i);return i&&T(t,n,i),i};class c extends _.WithFeedback(g.WithErrorText($.FormElement(C(m.Localized(v.FormAssociated(r.VividElement)))))){constructor(){super(),this.readOnly=!1,this.#e=()=>{this.$emit("focus",void 0,{bubbles:!1})},this.#t=()=>{this.$emit("blur",void 0,{bubbles:!1})},this.proxy=document.createElement("input"),this.#o={handleChange:()=>{this._updatePresentationValue()}},this._popupOpen=!1,this.#s=t=>{if(!this._popupOpen)return;const n=t.composedPath();[this._dialogEl,this._pickerButtonEl].some(i=>n.includes(i))||this._closePopup(!1)},this._presentationValue="",this.value=""}readOnlyChanged(){this.proxy instanceof HTMLInputElement&&(this.proxy.readOnly=this.readOnly,this.validate())}connectedCallback(){super.connectedCallback(),document.addEventListener("click",this.#s),this.addEventListener("focusin",this.#e),this.addEventListener("focusout",this.#t),this.#l()}disconnectedCallback(){super.disconnectedCallback(),document.removeEventListener("click",this.#s),this.removeEventListener("focusin",this.#e),this.removeEventListener("focusout",this.#t),this.#n()}#e;#t;validate(){this.proxy&&this.proxy.setCustomValidity(this._getCustomValidationError()??""),super.validate(this._textFieldEl?.querySelector("input")??void 0)}#o;#i;#l(){this.#i=r.Observable.binding(()=>this.locale,this.#o),this.#i.observe(this,r.defaultExecutionContext)}#n(){this.#i.disconnect()}#s;#a(){this.readOnly||(this._popupOpen=!0)}_closePopup(t=!0){this._popupOpen=!1,t&&this._textFieldEl.focus()}_onBaseKeyDown(t){return this._popupOpen&&b.handleEscapeKeyAndStopPropogation(t)?(this._closePopup(),!1):!this._trappedFocus(t,()=>this._focusableElsWithinDialog())}_presentationValueChanged(){this.dirtyValue=!0,this.validate()}_onTextFieldInput(t){const n=t.currentTarget;this._presentationValue=n.value}_onPickerButtonClick(){this._popupOpen?this._closePopup():this.#a()}_onOkClick(){this._closePopup()}_onClearClick(){this.$emit("clear-click")}}u([r.attr({attribute:"readonly",mode:"boolean"})],c.prototype,"readOnly");u([r.observable],c.prototype,"_popupOpen");u([r.observable],c.prototype,"_presentationValue");const P=(o,t,{withSeparator:n,padded:a})=>{const i=o.tagFor(k.Popup),l=o.tagFor(x.TextField),s=o.tagFor(F.Button);return r.html`
+"use strict";const _=require("./index.cjs"),v=require("./mixins.cjs"),g=require("./form-associated.cjs"),r=require("./vivid-element.cjs"),$=require("./with-contextual-help.cjs"),x=require("./with-error-text.cjs"),m=require("./form-element.cjs"),k=require("./localized.cjs"),F=require("./definition9.cjs"),E=require("./definition10.cjs"),y=require("./definition3.cjs"),p=require("./ref.cjs"),h=require("./slotted.cjs"),f=require("./class-names.cjs"),b=new WeakSet,C=l=>{b.add(l)},O=l=>{class t extends l{_trappedFocus(a,i){if(!b.has(a)&&a.key==="Tab"){const s=i(),o=s[0],e=s[s.length-1];if(a.shiftKey){if(this.shadowRoot.activeElement===o)return e.focus(),!0}else if(this.shadowRoot.activeElement===e)return o.focus(),!0}return!1}}return t},T=":host{display:inline-block}.base{display:inline-block;inline-size:100%}.control{inline-size:100%}.dialog{display:inline-flex;flex-direction:column}.dialog--padded{padding:12px;gap:12px}.dialog .footer{display:flex;align-items:center;justify-content:flex-end;padding:8px;gap:8px}.dialog .footer--with-separator{border-top:1px solid var(--vvd-color-neutral-200)}";var P=Object.defineProperty,u=(l,t,n,a)=>{for(var i=void 0,s=l.length-1,o;s>=0;s--)(o=l[s])&&(i=o(t,n,i)||i);return i&&P(t,n,i),i};class c extends $.WithContextualHelp(v.WithFeedback(x.WithErrorText(m.FormElement(O(k.Localized(g.FormAssociated(r.VividElement))))))){constructor(){super(),this.readOnly=!1,this.#e=()=>{this.$emit("focus",void 0,{bubbles:!1})},this.#t=()=>{this.$emit("blur",void 0,{bubbles:!1})},this.proxy=document.createElement("input"),this.#l={handleChange:()=>{this._updatePresentationValue()}},this._popupOpen=!1,this.#o=t=>{if(!this._popupOpen)return;const n=t.composedPath();[this._dialogEl,this._pickerButtonEl].some(i=>n.includes(i))||this._closePopup(!1)},this._presentationValue="",this.value=""}readOnlyChanged(){this.proxy instanceof HTMLInputElement&&(this.proxy.readOnly=this.readOnly,this.validate())}connectedCallback(){super.connectedCallback(),document.addEventListener("click",this.#o),this.addEventListener("focusin",this.#e),this.addEventListener("focusout",this.#t),this.#s()}disconnectedCallback(){super.disconnectedCallback(),document.removeEventListener("click",this.#o),this.removeEventListener("focusin",this.#e),this.removeEventListener("focusout",this.#t),this.#n()}#e;#t;validate(){this.proxy&&this.proxy.setCustomValidity(this._getCustomValidationError()??""),super.validate(this._textFieldEl?.querySelector("input")??void 0)}#l;#i;#s(){this.#i=r.Observable.binding(()=>this.locale,this.#l),this.#i.observe(this,r.ExecutionContext.default)}#n(){this.#i.dispose()}#o;#a(){this.readOnly||(this._popupOpen=!0)}_closePopup(t=!0){this._popupOpen=!1,t&&this._textFieldEl.focus()}_onBaseKeyDown(t){return this._popupOpen&&_.handleEscapeKeyAndStopPropogation(t)?(this._closePopup(),!1):!this._trappedFocus(t,()=>this._focusableElsWithinDialog())}_presentationValueChanged(){this.dirtyValue=!0,this.validate()}_onTextFieldInput(t){const n=t.currentTarget;this._presentationValue=n.value}_onPickerButtonClick(){this._popupOpen?this._closePopup():this.#a()}_onOkClick(){this._closePopup()}_onClearClick(){this.$emit("clear-click")}}u([r.attr({attribute:"readonly",mode:"boolean"})],c.prototype,"readOnly");u([r.observable],c.prototype,"_popupOpen");u([r.observable],c.prototype,"_presentationValue");const q=(l,t,{withSeparator:n,padded:a})=>{const i=l.tagFor(F.Popup),s=l.tagFor(E.TextField),o=l.tagFor(y.Button);return r.html`
 		<div class='base' @keydown='${(e,{event:d})=>e._onBaseKeyDown(d)}'>
-			<${l} id='text-field'
+			<${s} id='text-field'
 				${p.ref("_textFieldEl")}
 				class='control'
 				label='${e=>e.label}'
@@ -17,9 +17,14 @@
 				<slot
 					slot='${e=>e._helperTextSlottedContent?.length?"helper-text":void 0}'
 					name='helper-text'
-					${E.slotted("_helperTextSlottedContent")}
+					${h.slotted("_helperTextSlottedContent")}
 				></slot>
-				<${s}
+				<slot
+					slot='${e=>e._contextualHelpSlottedContent?.length?"contextual-help":void 0}'
+					name='contextual-help'
+					${h.slotted("_contextualHelpSlottedContent")}
+				></slot>
+				<${o}
 					id='picker-button'
 					${p.ref("_pickerButtonEl")}
 					slot='action-items'
@@ -29,34 +34,34 @@
 					?disabled='${e=>e.disabled||e.readOnly}'
 					aria-label='${e=>e._pickerButtonLabel}'
 					@click='${e=>e._onPickerButtonClick()}'
-				></${s}>
-			</${l}>
+				></${o}>
+			</${s}>
 			<${i}
 				?open='${e=>e._popupOpen}'
 				:anchor='${e=>e._textFieldEl}'
 				offset='${e=>e._helperTextSlottedContent?.length||e.helperText||e.errorValidationMessage?8:null}'
 				placement='bottom-start'
 				class='popup'>
-				<div class="${()=>h.classNames("dialog",["dialog--padded",a])}" role='dialog' ${p.ref("_dialogEl")} aria-modal='true' aria-label='${e=>e._dialogLabel}'>
+				<div class="${()=>f.classNames("dialog",["dialog--padded",a])}" role='dialog' ${p.ref("_dialogEl")} aria-modal='true' aria-label='${e=>e._dialogLabel}'>
 					${()=>t}
-					<div class="${()=>h.classNames("footer",["footer--with-separator",n])}">
-						<${s}
+					<div class="${()=>f.classNames("footer",["footer--with-separator",n])}">
+						<${o}
 							id='clear-button'
 							tabindex='3'
 							class='vwc-button'
 							size='condensed'
 							label='${e=>e.locale.pickerField.clearLabel}'
 							@click='${e=>e._onClearClick()}'
-						></${s}>
-						<${s}
+						></${o}>
+						<${o}
 							tabindex='3'
 							class='vwc-button'
 							size='condensed'
 							appearance='filled'
 							label='${e=>e.locale.pickerField.okLabel}'
 							@click='${e=>e._onOkClick()}'
-						></${s}>
+						></${o}>
 					</div>
 				</div>
 			</${i}>
-		</div>`};exports.PickerField=c;exports.PickerFieldTemplate=P;exports.ignoreEventInFocusTraps=y;exports.pickerFieldStyles=O;
+		</div>`};exports.PickerField=c;exports.PickerFieldTemplate=q;exports.ignoreEventInFocusTraps=C;exports.pickerFieldStyles=T;

package/bundled/picker-field.template.js

@@ -1,26 +1,27 @@
-import { h as m } from "./index.js";
-import { W as b } from "./mixins.js";
-import { F as _ } from "./form-associated.js";
-import { V as g, O as v, b as $, a as k, o as h, h as x } from "./vivid-element.js";
-import { W as F } from "./with-error-text.js";
-import { F as y } from "./form-element.js";
-import { L as E } from "./localized.js";
-import { P as C } from "./definition9.js";
-import { T as O } from "./definition13.js";
-import { B as T } from "./definition3.js";
+import { h as b } from "./index.js";
+import { W as _ } from "./mixins.js";
+import { F as g } from "./form-associated.js";
+import { V as v, O as $, E as x, a as k, o as f, h as F } from "./vivid-element.js";
+import { W as y } from "./with-contextual-help.js";
+import { W as C } from "./with-error-text.js";
+import { F as E } from "./form-element.js";
+import { L as O } from "./localized.js";
+import { P as T } from "./definition9.js";
+import { T as P } from "./definition10.js";
+import { B as L } from "./definition3.js";
 import { r as p } from "./ref.js";
-import { s as P } from "./slotted.js";
-import { c as u } from "./class-names.js";
-const f = /* @__PURE__ */ new WeakSet(), q = (s) => {
-  f.add(s);
-}, L = (s) => {
+import { s as u } from "./slotted.js";
+import { c as h } from "./class-names.js";
+const m = /* @__PURE__ */ new WeakSet(), G = (s) => {
+  m.add(s);
+}, V = (s) => {
   class t extends s {
     /**
      * @returns Whether focus was trapped.
      * @internal
      */
     _trappedFocus(n, o) {
-      if (!f.has(n) && n.key === "Tab") {
+      if (!m.has(n) && n.key === "Tab") {
         const l = o(), i = l[0], e = l[l.length - 1];
         if (n.shiftKey) {
           if (this.shadowRoot.activeElement === i)
@@ -32,15 +33,17 @@ const f = /* @__PURE__ */ new WeakSet(), q = (s) => {
     }
   }
   return t;
-}, N = ":host{display:inline-block}.base{display:inline-block;inline-size:100%}.control{inline-size:100%}.dialog{display:inline-flex;flex-direction:column}.dialog--padded{padding:12px;gap:12px}.dialog .footer{display:flex;align-items:center;justify-content:flex-end;padding:8px;gap:8px}.dialog .footer--with-separator{border-top:1px solid var(--vvd-color-neutral-200)}";
-var V = Object.defineProperty, d = (s, t, a, n) => {
+}, J = ":host{display:inline-block}.base{display:inline-block;inline-size:100%}.control{inline-size:100%}.dialog{display:inline-flex;flex-direction:column}.dialog--padded{padding:12px;gap:12px}.dialog .footer{display:flex;align-items:center;justify-content:flex-end;padding:8px;gap:8px}.dialog .footer--with-separator{border-top:1px solid var(--vvd-color-neutral-200)}";
+var w = Object.defineProperty, d = (s, t, a, n) => {
   for (var o = void 0, l = s.length - 1, i; l >= 0; l--)
     (i = s[l]) && (o = i(t, a, o) || o);
-  return o && V(t, a, o), o;
+  return o && w(t, a, o), o;
 };
-class c extends b(
-  F(
-    y(L(E(_(g))))
+class c extends y(
+  _(
+    C(
+      E(V(O(g(v))))
+    )
   )
 ) {
   // --- Core ---
@@ -89,13 +92,13 @@ class c extends b(
   #s;
   #o;
   #l() {
-    this.#o = v.binding(
+    this.#o = $.binding(
       () => this.locale,
       this.#s
-    ), this.#o.observe(this, $);
+    ), this.#o.observe(this, x.default);
   }
   #a() {
-    this.#o.disconnect();
+    this.#o.dispose();
   }
   #i;
   #n() {
@@ -112,7 +115,7 @@ class c extends b(
    * @internal
    */
   _onBaseKeyDown(t) {
-    return this._popupOpen && m(t) ? (this._closePopup(), !1) : !this._trappedFocus(t, () => this._focusableElsWithinDialog());
+    return this._popupOpen && b(t) ? (this._closePopup(), !1) : !this._trappedFocus(t, () => this._focusableElsWithinDialog());
   }
   /**
    * @internal
@@ -151,14 +154,14 @@ d([
   k({ attribute: "readonly", mode: "boolean" })
 ], c.prototype, "readOnly");
 d([
-  h
+  f
 ], c.prototype, "_popupOpen");
 d([
-  h
+  f
 ], c.prototype, "_presentationValue");
-const G = (s, t, { withSeparator: a, padded: n }) => {
-  const o = s.tagFor(C), l = s.tagFor(O), i = s.tagFor(T);
-  return x`
+const Q = (s, t, { withSeparator: a, padded: n }) => {
+  const o = s.tagFor(T), l = s.tagFor(P), i = s.tagFor(L);
+  return F`
 		<div class='base' @keydown='${(e, { event: r }) => e._onBaseKeyDown(r)}'>
 			<${l} id='text-field'
 				${p("_textFieldEl")}
@@ -177,7 +180,12 @@ const G = (s, t, { withSeparator: a, padded: n }) => {
 				<slot
 					slot='${(e) => e._helperTextSlottedContent?.length ? "helper-text" : void 0}'
 					name='helper-text'
-					${P("_helperTextSlottedContent")}
+					${u("_helperTextSlottedContent")}
+				></slot>
+				<slot
+					slot='${(e) => e._contextualHelpSlottedContent?.length ? "contextual-help" : void 0}'
+					name='contextual-help'
+					${u("_contextualHelpSlottedContent")}
 				></slot>
 				<${i}
 					id='picker-button'
@@ -197,14 +205,14 @@ const G = (s, t, { withSeparator: a, padded: n }) => {
 				offset='${(e) => e._helperTextSlottedContent?.length || e.helperText || e.errorValidationMessage ? 8 : null}'
 				placement='bottom-start'
 				class='popup'>
-				<div class="${() => u("dialog", [
+				<div class="${() => h("dialog", [
     "dialog--padded",
     n
   ])}" role='dialog' ${p(
     "_dialogEl"
   )} aria-modal='true' aria-label='${(e) => e._dialogLabel}'>
 					${() => t}
-					<div class="${() => u("footer", ["footer--with-separator", a])}">
+					<div class="${() => h("footer", ["footer--with-separator", a])}">
 						<${i}
 							id='clear-button'
 							tabindex='3'
@@ -228,7 +236,7 @@ const G = (s, t, { withSeparator: a, padded: n }) => {
 };
 export {
   c as P,
-  G as a,
-  q as i,
-  N as p
+  Q as a,
+  G as i,
+  J as p
 };

package/bundled/ref.cjs

@@ -1 +1 @@
-"use strict";const i=require("./vivid-element.cjs");class s{constructor(e,r){this.target=e,this.propertyName=r}bind(e){e[this.propertyName]=this.target}unbind(){}}function n(t){return new i.AttachedBehaviorHTMLDirective("fast-ref",s,t)}exports.ref=n;
+"use strict";const i=require("./vivid-element.cjs");class s extends i.StatelessAttachedAttributeDirective{bind(t){t.source[this.options]=t.targets[this.targetNodeId]}}i.HTMLDirective.define(s);const r=e=>new s(e);exports.ref=r;

package/bundled/ref.js

@@ -1,32 +1,15 @@
-import { A as i } from "./vivid-element.js";
-class a {
+import { S as i, H as r } from "./vivid-element.js";
+class s extends i {
   /**
-   * Creates an instance of RefBehavior.
-   * @param target - The element to reference.
-   * @param propertyName - The name of the property to assign the reference to.
-   */
-  constructor(t, e) {
-    this.target = t, this.propertyName = e;
-  }
-  /**
-   * Bind this behavior to the source.
-   * @param source - The source to bind to.
-   * @param context - The execution context that the binding is operating within.
+   * Bind this behavior.
+   * @param controller - The view controller that manages the lifecycle of this behavior.
    */
   bind(t) {
-    t[this.propertyName] = this.target;
+    t.source[this.options] = t.targets[this.targetNodeId];
   }
-  /**
-   * Unbinds this behavior from the source.
-   * @param source - The source to unbind from.
-   */
-  /* eslint-disable-next-line @typescript-eslint/no-empty-function */
-  unbind() {
-  }
-}
-function s(r) {
-  return new i("fast-ref", a, r);
 }
+r.define(s);
+const c = (e) => new s(e);
 export {
-  s as r
+  c as r
 };