@wssto2/vue-core 0.4.13 → 0.4.15

package/dist/control-CX9BG2UB.js

@@ -0,0 +1,320 @@
+import { inject as q, ref as z, computed as r, onBeforeUnmount as A, defineComponent as C, useSlots as F, openBlock as l, createBlock as L, resolveDynamicComponent as T, unref as t, normalizeClass as b, withCtx as _, createElementBlock as s, renderSlot as v, createCommentVNode as n, createElementVNode as x, createTextVNode as h, toDisplayString as f, createVNode as V, useAttrs as G, useId as K, mergeProps as j, createSlots as P, mergeDefaults as M } from "vue";
+import { useI18n as O } from "vue-i18n";
+import { _ as I } from "./Icon.vue_vue_type_script_lang-D7oC-d-S.js";
+import { RouterLink as U } from "vue-router";
+import { c as Y, a as J } from "./controlSurface-t7OEFESJ.js";
+import { u as Q } from "./mediaQuery-CygcXmFW.js";
+const W = {
+  label: void 0,
+  labelHidden: !1,
+  hint: void 0,
+  error: void 0,
+  required: !1,
+  editable: !0,
+  disabled: !1,
+  lockedReason: void 0,
+  presentation: "control",
+  name: void 0
+}, X = Symbol("vue-core.formGroup"), Z = Symbol("vue-core.formRowIndent"), ee = Symbol("vue-core.formEditable"), B = () => q(X, null), te = () => q(Z, 0);
+function oe(i) {
+  const e = B(), d = q(ee, z(!0)), c = Q(), k = r(() => !!e && !!i.disabled && (c.value || i.presentation === "value")), m = r(() => (i.editable ?? !0) && d.value && !k.value), o = r(() => !!e && !!i.disabled && m.value);
+  if (e) {
+    const u = e.registerLocked(r(() => !!i.disabled && d.value && i.presentation !== "value"));
+    A(u);
+  }
+  return { editable: m, locked: o };
+}
+const le = ["label", "labelHidden", "hint", "error", "required", "editable", "disabled", "lockedReason", "presentation", "name"];
+function qe(i) {
+  return Object.fromEntries(le.map((e) => [e, i[e]]));
+}
+const ae = {
+  key: 0,
+  class: "flex shrink-0 items-center"
+}, re = { class: "row-body min-h-row min-w-0 flex-1 border-t border-border-separator py-2 pr-row-inset" }, se = {
+  key: 0,
+  class: "text-content-destructive",
+  "aria-hidden": "true"
+}, ne = ["id"], ie = {
+  key: 0,
+  class: "break-words text-body text-content-strong"
+}, de = ["id"], ue = /* @__PURE__ */ C({
+  __name: "FormRow",
+  props: {
+    label: { default: void 0 },
+    labelHidden: { type: Boolean, default: !1 },
+    for: { default: void 0 },
+    sub: { default: void 0 },
+    subId: { default: void 0 },
+    required: { type: Boolean, default: !1 },
+    layout: { default: "entry" },
+    value: { default: void 0 },
+    to: { default: void 0 },
+    error: { default: void 0 },
+    errorId: { default: void 0 },
+    indent: { default: 0 },
+    labelLines: { default: void 0 },
+    labelAlign: { default: "center" }
+  },
+  setup(i) {
+    const e = i, d = F(), c = te(), k = r(() => c + e.indent), m = ["pl-row-inset", "pl-[calc(var(--app-row-inset)+1.25rem)]", "pl-[calc(var(--app-row-inset)+2.5rem)]"], o = { 1: "line-clamp-1", 2: "line-clamp-2", 3: "line-clamp-3" }, u = r(() => e.labelHidden && (e.layout === "entry" || e.layout === "value") ? "stacked" : e.layout), S = r(() => {
+      switch (u.value) {
+        case "entry":
+          return "grid grid-cols-[var(--form-label-width,11rem)_minmax(0,1fr)] items-center gap-x-4 compact:grid-cols-[minmax(0,auto)_minmax(40%,1fr)]";
+        case "value":
+          return "grid grid-cols-[minmax(min-content,1fr)_minmax(0,auto)] items-center gap-x-4";
+        case "setting":
+          return "flex items-center gap-4";
+        default:
+          return "flex flex-col gap-1";
+      }
+    }), p = r(() => e.labelHidden ? "sr-only" : u.value === "stacked" ? "text-footnote text-content-muted" : e.layout === "value" ? "text-body text-content-muted" : "text-body text-content-strong"), w = r(() => e.value !== void 0 && e.value !== null && e.value !== "");
+    return (y, g) => (l(), L(T(e.to ? t(U) : "div"), {
+      to: e.to,
+      "data-test": "form-row",
+      "data-layout": u.value,
+      "data-field-error": e.error ? "true" : void 0,
+      class: b(["form-row flex min-w-0 items-stretch gap-3 transition-colors duration-motion-fast first:rounded-t-group last:rounded-b-group focus-within:bg-tint-soft/50 [&:first-child>.row-body]:border-t-0", [m[Math.min(k.value, 2)], e.to ? "hover:bg-fill focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-border-focus" : ""]])
+    }, {
+      default: _(() => [
+        d.leading ? (l(), s("div", ae, [
+          v(y.$slots, "leading")
+        ])) : n("", !0),
+        x("div", re, [
+          x("div", {
+            class: b(["min-w-0", S.value])
+          }, [
+            e.label || e.sub || d.sub ? (l(), s("div", {
+              key: 0,
+              class: b([e.labelHidden && !e.sub && !d.sub ? "contents" : u.value === "setting" ? "min-w-min flex-1" : "min-w-0", e.labelAlign === "top" ? "self-start pt-1" : ""])
+            }, [
+              x("div", {
+                class: b(d["label-trailing"] ? "flex items-center justify-between gap-3" : "")
+              }, [
+                (l(), L(T(e.for ? "label" : "span"), {
+                  for: e.for,
+                  class: b(["break-words", [p.value, e.labelHidden ? "" : e.labelLines ? o[e.labelLines] : "block"]])
+                }, {
+                  default: _(() => [
+                    h(f(e.label), 1),
+                    e.required ? (l(), s("span", se, " *")) : n("", !0)
+                  ]),
+                  _: 1
+                }, 8, ["for", "class"])),
+                v(y.$slots, "label-trailing")
+              ], 2),
+              e.sub || d.sub ? (l(), s("small", {
+                key: 0,
+                id: e.subId,
+                class: "mt-0.5 block text-footnote text-content-muted"
+              }, [
+                v(y.$slots, "sub", {}, () => [
+                  h(f(e.sub), 1)
+                ])
+              ], 8, ne)) : n("", !0)
+            ], 2)) : n("", !0),
+            x("div", {
+              class: b(["flex min-w-0 items-center gap-2", u.value === "value" ? "justify-end text-right" : u.value === "setting" ? "flex-wrap justify-end text-right" : u.value === "entry" ? "compact:justify-end" : ""])
+            }, [
+              v(y.$slots, "default", {}, () => [
+                w.value ? (l(), s("span", ie, f(e.value), 1)) : n("", !0)
+              ]),
+              v(y.$slots, "trailing"),
+              e.to ? (l(), L(t(I), {
+                key: 0,
+                name: "arrowRightSLine",
+                size: 18,
+                class: "shrink-0 text-content-disabled"
+              })) : n("", !0)
+            ], 2)
+          ], 2),
+          e.error ? (l(), s("p", {
+            key: 0,
+            id: e.errorId,
+            class: "mt-1 flex items-start gap-1.5 text-footnote text-content-destructive",
+            role: "alert"
+          }, [
+            V(t(I), {
+              name: "alertTriangle",
+              size: 14,
+              class: "mt-px shrink-0"
+            }),
+            h(" " + f(e.error), 1)
+          ], 8, de)) : n("", !0)
+        ])
+      ]),
+      _: 3
+    }, 8, ["to", "data-layout", "data-field-error", "class"]));
+  }
+}), ce = ["title"], fe = {
+  key: 0,
+  class: "mr-1"
+}, ve = {
+  key: 1,
+  class: "ml-1 text-content-muted"
+}, me = {
+  key: 3,
+  class: "block text-body text-content-disabled"
+}, be = {
+  key: 0,
+  class: "sr-only"
+}, ye = ["data-field-error"], pe = ["for"], ge = {
+  key: 0,
+  class: "text-content-destructive",
+  "aria-hidden": "true"
+}, xe = ["id"], he = ["id"], Be = /* @__PURE__ */ C({
+  __name: "Field",
+  props: /* @__PURE__ */ M({
+    label: {},
+    labelHidden: { type: Boolean },
+    hint: {},
+    error: {},
+    required: { type: Boolean },
+    editable: { type: Boolean },
+    disabled: { type: Boolean },
+    lockedReason: {},
+    presentation: {},
+    name: {},
+    value: { type: [String, Number, Boolean, null] },
+    prefix: {},
+    suffix: {},
+    valueStyle: {},
+    rowLayout: {},
+    rowLabelAlign: {}
+  }, { ...W, value: void 0, prefix: void 0, suffix: void 0, valueStyle: void 0, rowLayout: "entry", rowLabelAlign: "center" }),
+  setup(i) {
+    const e = i, { t: d } = O(), c = F(), k = G(), m = B(), { editable: o, locked: u } = oe(e), S = K(), p = r(() => e.name ?? S), w = r(() => `${p.value}-hint`), y = r(() => `${p.value}-error`);
+    if (m?.registerField) {
+      const a = k["data-field-key"], N = m.registerField(typeof a == "string" ? a : void 0, r(() => e.disabled));
+      A(N);
+    }
+    const g = r(() => {
+      const a = e.value;
+      return a == null ? !1 : typeof a == "string" ? a.length > 0 : typeof a == "number" ? !Number.isNaN(a) : !0;
+    }), R = r(() => typeof e.value == "boolean" ? e.value ? d("core.form.yes") : d("core.form.no") : e.value), D = r(() => !!m && !o.value && m.hideEmpty.value && !g.value && !c.readonly), E = r(() => [e.hint && o.value ? w.value : null, e.error ? y.value : null].filter(Boolean).join(" ") || void 0), $ = r(() => {
+      const a = o.value ? e.rowLayout : e.rowLayout === "stacked" ? "stacked" : "value";
+      return e.labelHidden && (a === "entry" || a === "value") ? "stacked" : a;
+    }), H = r(
+      () => o.value && !u.value && e.required ? { "data-field-required": "true", "data-field-filled": g.value ? "true" : void 0 } : {}
+    );
+    return (a, N) => t(m) && !D.value ? (l(), L(ue, j({ key: 0 }, H.value, {
+      label: e.label,
+      "label-hidden": e.labelHidden,
+      for: t(o) ? p.value : void 0,
+      sub: t(o) ? e.hint : void 0,
+      "sub-id": w.value,
+      required: t(o) && !t(u) && e.required,
+      layout: $.value,
+      "label-align": $.value === "entry" ? e.rowLabelAlign : void 0,
+      error: t(o) ? e.error : void 0,
+      "error-id": y.value,
+      "data-field-locked": t(u) ? "true" : void 0
+    }), P({
+      default: _(() => [
+        x("div", {
+          class: "relative w-full min-w-0",
+          title: t(u) ? e.lockedReason : void 0
+        }, [
+          x("div", {
+            class: b(t(o) ? $.value === "setting" ? "flex min-w-0 flex-col items-end" : $.value === "stacked" ? "flex min-w-0 flex-col items-stretch" : "flex min-w-0 flex-col items-start compact:items-end" : "")
+          }, [
+            t(o) ? v(a.$slots, "default", {
+              id: p.value,
+              describedby: E.value,
+              invalid: !!e.error,
+              required: e.required,
+              disabled: e.disabled
+            }, void 0, void 0, 0) : t(c).readonly ? v(a.$slots, "readonly", {}, void 0, void 0, 1) : g.value ? (l(), s("span", {
+              key: 2,
+              class: b(["block break-words text-body text-content-strong", e.valueStyle === "mono" ? "font-mono" : e.valueStyle === "numeric" ? "tabular-nums" : ""])
+            }, [
+              e.prefix ? (l(), s("span", fe, f(e.prefix), 1)) : n("", !0),
+              h(f(R.value), 1),
+              e.suffix ? (l(), s("span", ve, f(e.suffix), 1)) : n("", !0)
+            ], 2)) : (l(), s("span", me, f(t(d)("core.state.no_value")), 1))
+          ], 2)
+        ], 8, ce),
+        t(u) && e.lockedReason ? (l(), s("span", be, f(e.lockedReason), 1)) : n("", !0)
+      ]),
+      _: 2
+    }, [
+      t(o) && t(c).trailing ? {
+        name: "trailing",
+        fn: _(() => [
+          v(a.$slots, "trailing")
+        ]),
+        key: "0"
+      } : void 0,
+      t(o) && t(c).labelTrailing ? {
+        name: "label-trailing",
+        fn: _(() => [
+          v(a.$slots, "labelTrailing")
+        ]),
+        key: "1"
+      } : void 0
+    ]), 1040, ["label", "label-hidden", "for", "sub", "sub-id", "required", "layout", "label-align", "error", "error-id", "data-field-locked"])) : t(m) ? n("", !0) : (l(), s("div", j({ key: 1 }, H.value, {
+      "data-field-error": e.error ? "true" : void 0,
+      class: "flex min-w-0 flex-col gap-1"
+    }), [
+      e.label || t(o) && t(c).labelTrailing ? (l(), s("div", {
+        key: 0,
+        class: b(e.labelHidden && !(t(o) && t(c).labelTrailing) ? "contents" : "flex items-center justify-between gap-3")
+      }, [
+        e.label ? (l(), s("label", {
+          key: 0,
+          for: t(o) ? p.value : void 0,
+          class: b(e.labelHidden ? "sr-only" : "text-footnote font-medium text-content-muted")
+        }, [
+          h(f(e.label), 1),
+          t(o) && e.required ? (l(), s("span", ge, " *")) : n("", !0)
+        ], 10, pe)) : n("", !0),
+        t(o) ? v(a.$slots, "labelTrailing", {}, void 0, void 0, 1) : n("", !0)
+      ], 2)) : n("", !0),
+      t(o) ? v(a.$slots, "default", {
+        id: p.value,
+        describedby: E.value,
+        invalid: !!e.error,
+        required: e.required,
+        disabled: e.disabled
+      }, void 0, void 0, 1) : t(c).readonly ? v(a.$slots, "readonly", {}, void 0, void 0, 2) : (l(), s("span", {
+        key: 3,
+        class: b(["text-body", g.value ? "text-content-strong" : "text-content-disabled"])
+      }, f(g.value ? `${e.prefix ?? ""}${R.value}${e.suffix ?? ""}` : t(d)("core.state.no_value")), 3)),
+      e.hint && t(o) ? (l(), s("p", {
+        key: 4,
+        id: w.value,
+        class: "text-footnote text-content-muted"
+      }, f(e.hint), 9, xe)) : n("", !0),
+      e.error ? (l(), s("p", {
+        key: 5,
+        id: y.value,
+        role: "alert",
+        class: "flex items-start gap-1.5 text-footnote text-content-destructive"
+      }, [
+        V(t(I), {
+          name: "alertTriangle",
+          size: 14,
+          class: "mt-px shrink-0"
+        }),
+        h(" " + f(e.error), 1)
+      ], 8, he)) : n("", !0)
+    ], 16, ye));
+  }
+}), ke = "rounded-control transition-[background-color,box-shadow,opacity] duration-motion-fast ease-motion-standard";
+function Re(i, e) {
+  const d = !!B();
+  return r(() => d ? Y({ kind: i, state: e() }) : [ke, ...J(i, e()).map(([c]) => c)].join(" "));
+}
+export {
+  Be as _,
+  B as a,
+  W as b,
+  Re as c,
+  ee as d,
+  ue as e,
+  qe as f,
+  X as g,
+  Z as h,
+  te as i,
+  oe as u
+};

package/dist/describeError-B-NMa--w.js

@@ -0,0 +1,53 @@
+import { hasInjectionContext as t, inject as i } from "vue";
+import { useI18n as u } from "vue-i18n";
+import { a } from "./error-CD7x0Jrz.js";
+const d = Symbol("vue-core.describeError"), f = Symbol("vue-core.describeFieldError");
+function h() {
+  return t() ? i(f, null) : null;
+}
+function l() {
+  return t() ? i(d, null) : null;
+}
+function p({ t: r, te: c }) {
+  return (e, { fallback: s } = {}) => {
+    const o = s ?? r("core.errors.unexpected");
+    if (!a(e)) return o;
+    if (e.code) {
+      for (const n of [`errors.${e.code}`, `core.errors.${e.code}`])
+        if (c(n)) return r(n, { ...e.params });
+      if (e.message) return e.message;
+    }
+    switch (e.kind) {
+      case "unauthorized":
+        return r("core.errors.unauthenticated");
+      case "forbidden":
+        return r("core.errors.forbidden");
+      case "notFound":
+        return r("core.errors.not_found");
+      case "conflict":
+        return r("core.errors.conflict");
+      case "network":
+        return r("core.errors.offline");
+      case "aborted":
+        return r("core.errors.cancelled");
+      case "server":
+      case "malformed":
+        return o;
+      case "validation":
+        if (Object.keys(e.fields).length > 0) return r("core.errors.check_fields");
+        break;
+    }
+    return e.status === 429 ? r("core.errors.rate_limited") : s ?? (e.message || r("core.errors.unexpected"));
+  };
+}
+function y() {
+  const { t: r, te: c } = u(), e = l(), s = p({ t: (o, n) => r(o, n ?? {}), te: (o) => c(o) });
+  return e ? (o, n) => e(o) ?? s(o, n) : s;
+}
+export {
+  l as a,
+  d as b,
+  f as c,
+  h as d,
+  y as u
+};

package/dist/fieldMessages-DV6sESpn.js

@@ -0,0 +1,25 @@
+import { useI18n as f } from "vue-i18n";
+import { a as c } from "./error-CD7x0Jrz.js";
+import { u as m } from "./format-B8mJm946.js";
+import { u as l } from "./describeError-B-NMa--w.js";
+function E() {
+  const { t: i, te: u } = f(), a = m(), d = l(), s = (e) => [`errors.${e}`, `core.errors.${e}`].find((t) => u(t));
+  function n(e, t) {
+    if (c(e) && e.code) {
+      const r = s(e.code), o = typeof e.params?.locked_until == "string" ? new Date(e.params.locked_until) : null;
+      if (r && o && !Number.isNaN(o.getTime())) return i(r, { ...e.params, locked_until: a.time(o) });
+    }
+    return d(e, t === void 0 ? void 0 : { fallback: t });
+  }
+  return {
+    sentence: n,
+    describeFieldError: (e) => {
+      const t = s(e);
+      return t === void 0 ? e : i(t);
+    },
+    failureMessage: (e, t) => c(t) && t.code && (e === "failed" || e === "forbidden" || e === "conflict") ? n(t) : void 0
+  };
+}
+export {
+  E as u
+};

package/dist/form/DateField.vue.d.ts

@@ -38,6 +38,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/DateTimeField.vue.d.ts

@@ -38,6 +38,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/Field.vue.d.ts

@@ -50,6 +50,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     value: string | number | boolean | null;
     prefix: string;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/FileField.vue.d.ts

@@ -34,6 +34,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     required: boolean;
     presentation: "control" | "value";
     variant: "button" | "dropzone";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/FormErrors.vue.d.ts

@@ -8,7 +8,7 @@ import type { Form } from "./useForm";
  *   <FormErrors :form="form" :label="fieldLabel" />
  *
  * A field counts as shown while an element carries `data-field-key="<name>"` (`form.bind()` sets it; `fieldKey(path)` does for a field wired by hand,
- * such as one inside a list), or carries the name of something that contains it.
+ * such as one inside a list), or carries the name of something that contains it. `useHiddenFieldErrors` is the same list for your own use.
  */
 type __VLS_Props = {
     form: Pick<Form<object>, "failure" | "errors">;

package/dist/form/FormRow.vue.d.ts

@@ -12,6 +12,8 @@ import { type FormRowLayout } from "./field";
  */
 type __VLS_Props = {
     label?: string;
+    /** The label is read by screen readers but not drawn; the row lays out as if it had none. */
+    labelHidden?: boolean;
     /** The id of the control the label names (editable rows). */
     for?: string;
     /** A secondary line under the label. */
@@ -50,6 +52,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     required: boolean;
     value: string | number | null;
     for: string;
+    labelHidden: boolean;
     subId: string;
     layout: FormRowLayout;
     errorId: string;

package/dist/form/I18nField.vue.d.ts

@@ -39,6 +39,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     required: boolean;
     presentation: "control" | "value";
     rows: number;
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/MoneyField.vue.d.ts

@@ -29,6 +29,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     required: boolean;
     width: Exclude<ControlWidth, "content">;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/MonthYearField.vue.d.ts

@@ -29,6 +29,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/NumberField.vue.d.ts

@@ -11,6 +11,7 @@ import { type FieldProps } from "./field";
  * is always a decimal mark, never a group mark.
  *
  * Typing "1,5" mid-edit is never rewritten under the cursor: the text is the user's until the field loses focus.
+ * `:max-digits="5"` takes at most five digits (a postal code): typing a sixth does nothing, pasting a longer number keeps its first five.
  * Limits (`min`, `max`) are the validator's job; the field only keeps what cannot be a number out.
  */
 type __VLS_Props = FieldProps & {
@@ -19,6 +20,8 @@ type __VLS_Props = FieldProps & {
     negative?: boolean;
     /** Separates thousands ("1.234.567"); off for years, coordinates and codes. */
     grouping?: boolean;
+    /** The most digits the field takes, fraction digits included (the sign, separators and decimal mark are not counted): a postal code is `:max-digits="5"`. Further digits are not accepted, as `maxlength` does for text; a pasted longer number keeps its first digits. */
+    maxDigits?: number;
     placeholder?: string;
     prefix?: string;
     suffix?: string;
@@ -44,6 +47,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     width: Exclude<ControlWidth, "content">;
     prefix: string;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
@@ -51,5 +55,6 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     decimals: number;
     negative: boolean;
     grouping: boolean;
+    maxDigits: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/form/PhotoField.vue.d.ts

@@ -24,6 +24,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/SelectField.vue.d.ts

@@ -1,24 +1,23 @@
 import { type FieldProps } from "./field";
 import type { SelectOption } from "./options";
 import { type OptionsSource } from "./useOptions";
-declare const _default: <Value extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const _default: <Value extends string | number, Clearable extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
-        readonly "onUpdate:modelValue"?: ((value: Value | null) => any) | undefined;
+        readonly "onUpdate:modelValue"?: ((value: Clearable extends true ? Value | null : Value) => any) | undefined;
     } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & (FieldProps & {
         options: OptionsSource<Value>;
         /** The option of the current value when the caller already has it (a saved record's model): its label shows before the options arrive, or when they do not contain it. */
         selected?: SelectOption<Value> | null;
         placeholder?: string;
-        clearable?: boolean;
+        clearable?: Clearable;
+        modelValue?: Value | null;
         /** Shows the search box from this many options. */
         searchFrom?: number;
-    } & {
-        modelValue?: Value | null;
     }) & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
     slots: {};
-    emit: (evt: "update:modelValue", value: Value | null) => void;
+    emit: (evt: "update:modelValue", value: Clearable extends true ? Value | null : Value) => void;
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/form/SwitchField.vue.d.ts

@@ -29,6 +29,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps,
     required: boolean;
     size: "sm" | "md" | "lg";
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/TextField.vue.d.ts

@@ -68,6 +68,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     width: Exclude<ControlWidth, "content">;
     prefix: string;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/TextareaField.vue.d.ts

@@ -33,6 +33,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     presentation: "control" | "value";
     rows: number;
     stacked: boolean;
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/TimeField.vue.d.ts

@@ -31,6 +31,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/field.d.ts

@@ -2,6 +2,8 @@ import { type ComputedRef, type InjectionKey, type Ref } from "vue";
 /** What every field takes besides its value. A field is one labelled row: the label, the control, a hint, the error. */
 export interface FieldProps {
     label?: string;
+    /** The label stays the control's accessible name (and the read-mode row's) but is not drawn: for a field whose group header already says it. */
+    labelHidden?: boolean;
     /** A sentence under the label (under the control outside a group) that says what to enter. */
     hint?: string;
     /** The message to show; `form.bind()` supplies it. */
@@ -22,6 +24,7 @@ export interface FieldProps {
 /** Defaults of `FieldProps` for `withDefaults(defineProps<FieldProps & …>(), { ...fieldDefaults, … })`. */
 export declare const fieldDefaults: {
     label: undefined;
+    labelHidden: boolean;
     hint: undefined;
     error: undefined;
     required: boolean;

package/dist/form/index.d.ts

@@ -61,6 +61,8 @@ export { useGroupSheet } from "./useGroupSheet";
 export type { GroupSheetForm, GroupSheetOptions, GroupSheetState } from "./useGroupSheet";
 export { default as EditorPage } from "./EditorPage.vue";
 export { useSectionStates } from "./sectionStates";
+export { useHiddenFieldErrors } from "./useHiddenFieldErrors";
+export type { HiddenFieldError } from "./useHiddenFieldErrors";
 export { useSaveChrome } from "./useSaveChrome";
 export type { SaveChromeOptions } from "./useSaveChrome";
 export { default as CommandDialog } from "./CommandDialog.vue";