@quidgest/ui 0.27.0 → 0.28.0

package/esm/components/QObfuscation/QObfuscation.d.ts

@@ -1,4 +1,3 @@
-import { DEFAULT_ICONS, DEFAULT_TEXTS } from './constants';
 import { QObfuscationProps } from '.';
 import { Component } from 'vue';
 type __VLS_Props = QObfuscationProps;
@@ -13,6 +12,7 @@ declare function __VLS_template(): {
             toggle: () => void;
             revealed: boolean;
             loading: boolean;
+            describedBy?: string;
         }) => unknown;
         reveal?: (props: {
             revealed: boolean;
@@ -29,6 +29,7 @@ declare function __VLS_template(): {
             toggle: () => void;
             revealed: boolean;
             loading: boolean;
+            describedBy?: string;
         }) => unknown;
         reveal?: (props: {
             revealed: boolean;
@@ -57,9 +58,33 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     size: import('..').QFieldSize;
     required: boolean;
     mask: import('./types').QObfuscationMask;
+    icons: {
+        help: {
+            icon: string;
+        };
+    } & {
+        restricted: {
+            icon: string;
+        };
+        show: {
+            icon: string;
+        };
+        hide: {
+            icon: string;
+        };
+        help: {
+            icon: string;
+        };
+    };
+    texts: {
+        showHelp: string;
+    } & {
+        restricted: string;
+        showData: string;
+        hideData: string;
+        showHelp: string;
+    };
     loading: boolean;
-    icons: typeof DEFAULT_ICONS;
-    texts: typeof DEFAULT_TEXTS;
     labelPosition: import('..').QLabelPosition;
     revealable: boolean;
     bulletCount: number;

package/esm/components/QObfuscation/QObfuscation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QObfuscation.vue.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/QObfuscation.vue"],"names":[],"mappings":"AAsFA;AA4RC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAW1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAepC,KAAK,WAAW,GAAG,iBAAiB,CAAC;AAsLtC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAmLT,OAAO,IAA6B;;kBA1VtC,CAAC,KAAK,EAAE;YACjB,sBAAsB,EAAE,SAAS,CAAA;YACjC,MAAM,EAAE,MAAM,IAAI,CAAA;YAClB,QAAQ,EAAE,OAAO,CAAA;YACjB,OAAO,EAAE,OAAO,CAAA;SAChB,KAAK,OAAO;iBACJ,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO;eACjF,MAAM,OAAO;0BACF,MAAM,OAAO;yBACd,MAAM,OAAO;iBACrB,MAAM,OAAO;;kBAVZ,CAAC,KAAK,EAAE;YACjB,sBAAsB,EAAE,SAAS,CAAA;YACjC,MAAM,EAAE,MAAM,IAAI,CAAA;YAClB,QAAQ,EAAE,OAAO,CAAA;YACjB,OAAO,EAAE,OAAO,CAAA;SAChB,KAAK,OAAO;iBACJ,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO;eACjF,MAAM,OAAO;0BACF,MAAM,OAAO;yBACd,MAAM,OAAO;iBACrB,MAAM,OAAO;;;;EAqVvB;AAuBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;6EASnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"QObfuscation.vue.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/QObfuscation.vue"],"names":[],"mappings":"AA4FA;AA8VC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAgBpC,KAAK,WAAW,GAAG,iBAAiB,CAAC;AAoOtC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WA+LT,OAAO,IAA6B;;kBApZtC,CAAC,KAAK,EAAE;YACjB,sBAAsB,EAAE,SAAS,CAAA;YACjC,MAAM,EAAE,MAAM,IAAI,CAAA;YAClB,QAAQ,EAAE,OAAO,CAAA;YACjB,OAAO,EAAE,OAAO,CAAA;YAChB,WAAW,CAAC,EAAE,MAAM,CAAA;SACpB,KAAK,OAAO;iBACJ,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO;eACjF,MAAM,OAAO;0BACF,MAAM,OAAO;yBACd,MAAM,OAAO;iBACrB,MAAM,OAAO;;kBAXZ,CAAC,KAAK,EAAE;YACjB,sBAAsB,EAAE,SAAS,CAAA;YACjC,MAAM,EAAE,MAAM,IAAI,CAAA;YAClB,QAAQ,EAAE,OAAO,CAAA;YACjB,OAAO,EAAE,OAAO,CAAA;YAChB,WAAW,CAAC,EAAE,MAAM,CAAA;SACpB,KAAK,OAAO;iBACJ,CAAC,KAAK,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO;eACjF,MAAM,OAAO;0BACF,MAAM,OAAO;yBACd,MAAM,OAAO;iBACrB,MAAM,OAAO;;;;EA8YvB;AAwBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EASnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/esm/components/QObfuscation/QObfuscation.vue.js

@@ -1,16 +1,18 @@
 import { useId as e } from "../../composables/useId/index.js";
-import { QButton as t } from "../QButton/index.js";
-import { QIcon as n } from "../QIcon/index.js";
-import { QField as r } from "../QField/index.js";
-import { DEFAULT_ICONS as i, DEFAULT_TEXTS as a } from "./constants.js";
-import { Fragment as o, computed as s, createBlock as c, createCommentVNode as l, createElementBlock as u, createElementVNode as d, createSlots as f, createTextVNode as p, createVNode as m, defineComponent as h, h as g, mergeModels as _, mergeProps as v, nextTick as y, normalizeClass as b, onBeforeMount as x, onBeforeUnmount as S, openBlock as C, ref as w, renderSlot as T, toDisplayString as E, toRef as D, unref as O, useModel as k, watch as A, withCtx as j } from "vue";
+import { QIcon as t } from "../QIcon/index.js";
+import { QHelpPopover as n } from "../__internal__/QHelpPopover/index.js";
+import { resolveHelp as r } from "../__internal__/QHelpPopover/resolveHelp.js";
+import { QButton as i } from "../QButton/index.js";
+import { QField as a } from "../QField/index.js";
+import { DEFAULT_ICONS as o, DEFAULT_TEXTS as s } from "./constants.js";
+import { Fragment as c, computed as l, createBlock as u, createCommentVNode as d, createElementBlock as f, createElementVNode as p, createSlots as m, createTextVNode as h, createVNode as g, defineComponent as _, h as v, mergeModels as y, mergeProps as b, nextTick as x, normalizeClass as S, onBeforeMount as C, onBeforeUnmount as w, openBlock as T, ref as E, renderSlot as D, toDisplayString as O, toRef as k, unref as A, useModel as j, watch as M, withCtx as N } from "vue";
 //#region src/components/QObfuscation/QObfuscation.vue?vue&type=script&setup=true&lang.ts
-var M = ["id"], N = ["id"], P = {
+var P = ["id"], F = ["id"], I = {
 	key: 1,
 	class: "q-obfuscation__mask"
-}, F = /*@__PURE__*/ h({
+}, L = /*@__PURE__*/ _({
 	__name: "QObfuscation",
-	props: /*@__PURE__*/ _({
+	props: /*@__PURE__*/ y({
 		id: {},
 		class: {},
 		label: {},
@@ -20,6 +22,10 @@ var M = ["id"], N = ["id"], P = {
 		},
 		for: {},
 		labelPosition: { default: "topleft" },
+		help: {},
+		helpDisplay: {},
+		icons: { default: () => o },
+		texts: { default: () => s },
 		size: { default: "medium" },
 		readonly: { type: Boolean },
 		disabled: { type: Boolean },
@@ -33,9 +39,7 @@ var M = ["id"], N = ["id"], P = {
 			default: !1
 		},
 		mask: { default: "restricted" },
-		bulletCount: { default: 12 },
-		icons: { default: () => i },
-		texts: { default: () => a }
+		bulletCount: { default: 12 }
 	}, {
 		revealed: {
 			type: Boolean,
@@ -43,123 +47,145 @@ var M = ["id"], N = ["id"], P = {
 		},
 		revealedModifiers: {}
 	}),
-	emits: /*@__PURE__*/ _(["reveal", "hide"], ["update:revealed"]),
-	setup(i, { emit: a }) {
-		let _ = i, F = a, I = k(i, "revealed"), L = e(D(_, "id")), R = e(), z = w(0), B = w(!1), V = s(() => _.revealable && I.value && !_.loading), H = s(() => z.value > 0), U = s(() => {
-			if (!(V.value && (!B.value || H.value))) return _.label;
-		}), W = s(() => V.value && B.value && !H.value), G = s(() => _.mask === "bullets" ? "•".repeat(_.bulletCount) : _.texts.restricted), K = s(() => [
+	emits: /*@__PURE__*/ y(["reveal", "hide"], ["update:revealed"]),
+	setup(o, { emit: s }) {
+		let y = o, L = s, R = j(o, "revealed"), z = e(k(y, "id")), B = e(), V = E(0), H = E(!1), U = l(() => y.revealable && R.value && !y.loading), W = l(() => V.value > 0), G = l(() => {
+			if (!(U.value && (!H.value || W.value))) return y.label;
+		}), K = l(() => U.value && H.value && !W.value), q = l(() => r({
+			help: y.help,
+			helpDisplay: y.helpDisplay
+		})), J = l(() => U.value && (!H.value || W.value) && !!q.value.popoverText), Y = l(() => ({
+			help: J.value ? void 0 : y.help,
+			helpDisplay: J.value ? void 0 : y.helpDisplay
+		})), X = l(() => y.mask === "bullets" ? "•".repeat(y.bulletCount) : y.texts.restricted), Z = l(() => [
 			"q-obfuscation",
 			{
-				"q-obfuscation--revealable": _.revealable,
-				"q-obfuscation--revealed": V.value,
-				"q-obfuscation--loading": _.loading
+				"q-obfuscation--revealable": y.revealable,
+				"q-obfuscation--revealed": U.value,
+				"q-obfuscation--loading": y.loading
 			},
-			_.class
+			y.class
 		]);
-		A(V, async (e) => {
+		M(U, async (e) => {
 			if (!e) {
-				B.value = !1;
+				H.value = !1;
 				return;
 			}
-			B.value = !1, await y(), B.value = !0;
+			H.value = !1, await x(), H.value = !0;
 		}, { immediate: !0 });
-		let q = h({
+		let Q = _({
 			name: "QObfuscationHideAction",
 			props: { track: {
 				type: Boolean,
 				default: !0
 			} },
 			setup(e) {
-				return e.track && (x(() => {
-					z.value++;
-				}), S(() => {
-					z.value--;
-				})), () => g(t, {
-					variant: "text",
-					borderless: !0,
-					class: "q-obfuscation__label-action",
-					disabled: _.disabled,
-					title: _.texts.hideData,
-					"aria-label": _.texts.hideData,
-					"aria-expanded": !0,
-					"aria-controls": R.value,
-					"data-testid": "q-obfuscation__hide",
-					onClick: J
-				}, () => g(n, {
-					..._.icons.hide,
-					class: "q-obfuscation__icon"
-				}));
+				return e.track && (C(() => {
+					V.value++;
+				}), w(() => {
+					V.value--;
+				})), () => {
+					let r = v(i, {
+						variant: "ghost",
+						borderless: !0,
+						size: "small",
+						class: "q-obfuscation__label-action",
+						disabled: y.disabled,
+						title: y.texts.hideData,
+						"aria-label": y.texts.hideData,
+						"aria-expanded": !0,
+						"aria-controls": B.value,
+						"data-testid": "q-obfuscation__hide",
+						onClick: $
+					}, () => v(t, {
+						...y.icons.hide,
+						class: "q-obfuscation__icon"
+					}));
+					return !e.track || !J.value || !q.value.popoverText ? r : [r, v(n, {
+						label: y.label,
+						text: q.value.popoverText,
+						icons: y.icons,
+						texts: y.texts
+					})];
+				};
 			}
 		});
-		function J() {
-			!_.revealable || _.loading || (I.value = !I.value, I.value ? F("reveal") : F("hide"));
+		function $() {
+			!y.revealable || y.loading || (R.value = !R.value, R.value ? L("reveal") : L("hide"));
 		}
-		return (e, i) => (C(), c(O(r), {
-			id: O(L),
-			class: b(K.value),
-			for: _.for ?? O(R),
-			label: U.value,
-			"label-position": _.labelPosition,
-			size: _.size,
-			readonly: _.readonly,
-			disabled: _.disabled,
-			required: _.required,
-			invalid: _.invalid
-		}, f({
-			"label.prepend": j(() => [T(e.$slots, "label.prepend")]),
-			"label.append": j(() => [
-				T(e.$slots, "label.append"),
-				l(" Own padlock only when the consumer did not place QObfuscationHideAction "),
-				W.value ? (C(), c(O(q), {
+		return (e, n) => (T(), u(A(a), {
+			id: A(z),
+			class: S(Z.value),
+			for: y.for ?? A(B),
+			label: G.value,
+			"label-position": y.labelPosition,
+			size: y.size,
+			readonly: y.readonly,
+			disabled: y.disabled,
+			required: y.required,
+			invalid: y.invalid,
+			help: Y.value.help,
+			"help-display": Y.value.helpDisplay,
+			icons: y.icons,
+			texts: y.texts
+		}, m({
+			"label.prepend": N(() => [D(e.$slots, "label.prepend")]),
+			"label.append": N(() => [
+				D(e.$slots, "label.append"),
+				d(" Own padlock only when the consumer did not place QObfuscationHideAction "),
+				K.value ? (T(), u(A(Q), {
 					key: 0,
 					track: !1
-				})) : l("v-if", !0)
+				})) : d("v-if", !0)
 			]),
-			control: j(() => [l(" Revealed: slot content; place QObfuscationHideAction on the field label to own it "), V.value ? (C(), u("div", {
+			control: N(({ describedBy: n }) => [d(" Revealed: slot content; place QObfuscationHideAction on the field label to own it "), U.value ? (T(), f("div", {
 				key: 0,
-				id: O(R),
+				id: A(B),
 				class: "q-obfuscation__content"
-			}, [T(e.$slots, "default", {
-				qObfuscationHideAction: O(q),
-				toggle: J,
-				revealed: I.value,
-				loading: _.loading
-			})], 8, M)) : (C(), u(o, { key: 1 }, [l(" Masked / loading: QObfuscation label + control surface "), d("div", {
-				id: O(R),
+			}, [D(e.$slots, "default", {
+				qObfuscationHideAction: A(Q),
+				describedBy: n,
+				toggle: $,
+				revealed: R.value,
+				loading: y.loading
+			})], 8, P)) : (T(), f(c, { key: 1 }, [d(" Masked / loading: QObfuscation label + control surface "), p("div", {
+				id: A(B),
 				class: "q-field__control q-obfuscation__value"
-			}, [_.revealable ? T(e.$slots, "reveal", {
+			}, [y.revealable ? D(e.$slots, "reveal", {
 				key: 0,
-				revealed: I.value,
-				toggle: J,
-				loading: _.loading
-			}, () => [m(O(t), {
+				revealed: R.value,
+				toggle: $,
+				loading: y.loading
+			}, () => [g(A(i), {
 				variant: "text",
 				borderless: "",
 				block: "",
 				class: "q-obfuscation__action",
-				disabled: _.disabled,
-				loading: _.loading,
-				label: _.texts.showData,
+				disabled: y.disabled,
+				loading: y.loading,
+				label: y.texts.showData,
 				"aria-expanded": !1,
-				"aria-controls": O(R),
+				"aria-controls": A(B),
+				"aria-describedby": n,
 				"data-testid": "q-obfuscation__reveal",
-				onClick: J
+				onClick: $
 			}, {
-				default: j(() => [m(O(n), v(_.icons.show, { class: "q-obfuscation__icon" }), null, 16)]),
+				default: N(() => [g(A(t), b(y.icons.show, { class: "q-obfuscation__icon" }), null, 16)]),
 				_: 1
 			}, 8, [
 				"disabled",
 				"loading",
 				"label",
-				"aria-controls"
-			])]) : (C(), u("span", P, [m(O(n), v(_.icons.restricted, {
+				"aria-controls",
+				"aria-describedby"
+			])]) : (T(), f("span", I, [g(A(t), b(y.icons.restricted, {
 				class: "q-obfuscation__icon",
 				"aria-hidden": "true"
-			}), null, 16), T(e.$slots, "mask", {}, () => [p(E(G.value), 1)])]))], 8, N)], 2112))]),
+			}), null, 16), D(e.$slots, "mask", {}, () => [h(O(X.value), 1)])]))], 8, F)], 2112))]),
 			_: 2
 		}, [e.$slots.extras ? {
 			name: "extras",
-			fn: j(() => [T(e.$slots, "extras")]),
+			fn: N(() => [D(e.$slots, "extras")]),
 			key: "0"
 		} : void 0]), 1032, [
 			"id",
@@ -171,9 +197,13 @@ var M = ["id"], N = ["id"], P = {
 			"readonly",
 			"disabled",
 			"required",
-			"invalid"
+			"invalid",
+			"help",
+			"help-display",
+			"icons",
+			"texts"
 		]));
 	}
 });
 //#endregion
-export { F as default };
+export { L as default };

package/esm/components/QObfuscation/constants.d.ts

@@ -8,10 +8,14 @@ export declare const DEFAULT_ICONS: {
     hide: {
         icon: string;
     };
+    help: {
+        icon: string;
+    };
 };
 export declare const DEFAULT_TEXTS: {
     restricted: string;
     showData: string;
     hideData: string;
+    showHelp: string;
 };
 //# sourceMappingURL=constants.d.ts.map

package/esm/components/QObfuscation/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;;;;;;;;;;CAUY,CAAA;AAEtC,eAAO,MAAM,aAAa;;;;CAIQ,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/constants.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAWY,CAAA;AAEtC,eAAO,MAAM,aAAa;;;;;CAKQ,CAAA"}

package/esm/components/QObfuscation/constants.js

@@ -1,12 +1,15 @@
+import { DEFAULT_ICONS as e, DEFAULT_TEXTS as t } from "../QField/constants.js";
 //#region src/components/QObfuscation/constants.ts
-var e = {
+var n = {
+	...e,
 	restricted: { icon: "lock" },
 	show: { icon: "lock" },
 	hide: { icon: "lock-open-variant" }
-}, t = {
+}, r = {
+	...t,
 	restricted: "Restricted",
 	showData: "Show data",
 	hideData: "Hide data"
 };
 //#endregion
-export { e as DEFAULT_ICONS, t as DEFAULT_TEXTS };
+export { n as DEFAULT_ICONS, r as DEFAULT_TEXTS };

package/esm/components/QObfuscation/index.d.ts

@@ -6,7 +6,7 @@ declare const QObfuscation: {
         required?: boolean;
         for?: string;
         labelPosition?: import('..').QLabelPosition;
-    } & {
+    } & import('..').QFieldHelpProps & {
         size?: import('..').QFieldSize;
         readonly?: boolean;
         disabled?: boolean;
@@ -32,9 +32,33 @@ declare const QObfuscation: {
         size: import('..').QFieldSize;
         required: boolean;
         mask: import('./types').QObfuscationMask;
+        icons: {
+            help: {
+                icon: string;
+            };
+        } & {
+            restricted: {
+                icon: string;
+            };
+            show: {
+                icon: string;
+            };
+            hide: {
+                icon: string;
+            };
+            help: {
+                icon: string;
+            };
+        };
+        texts: {
+            showHelp: string;
+        } & {
+            restricted: string;
+            showData: string;
+            hideData: string;
+            showHelp: string;
+        };
         loading: boolean;
-        icons: typeof import('./constants').DEFAULT_ICONS;
-        texts: typeof import('./constants').DEFAULT_TEXTS;
         labelPosition: import('..').QLabelPosition;
         revealable: boolean;
         bulletCount: number;
@@ -52,7 +76,7 @@ declare const QObfuscation: {
         required?: boolean;
         for?: string;
         labelPosition?: import('..').QLabelPosition;
-    } & {
+    } & import('..').QFieldHelpProps & {
         size?: import('..').QFieldSize;
         readonly?: boolean;
         disabled?: boolean;
@@ -73,9 +97,33 @@ declare const QObfuscation: {
         size: import('..').QFieldSize;
         required: boolean;
         mask: import('./types').QObfuscationMask;
+        icons: {
+            help: {
+                icon: string;
+            };
+        } & {
+            restricted: {
+                icon: string;
+            };
+            show: {
+                icon: string;
+            };
+            hide: {
+                icon: string;
+            };
+            help: {
+                icon: string;
+            };
+        };
+        texts: {
+            showHelp: string;
+        } & {
+            restricted: string;
+            showData: string;
+            hideData: string;
+            showHelp: string;
+        };
         loading: boolean;
-        icons: typeof import('./constants').DEFAULT_ICONS;
-        texts: typeof import('./constants').DEFAULT_TEXTS;
         labelPosition: import('..').QLabelPosition;
         revealable: boolean;
         bulletCount: number;
@@ -90,7 +138,7 @@ declare const QObfuscation: {
     required?: boolean;
     for?: string;
     labelPosition?: import('..').QLabelPosition;
-} & {
+} & import('..').QFieldHelpProps & {
     size?: import('..').QFieldSize;
     readonly?: boolean;
     disabled?: boolean;
@@ -116,9 +164,33 @@ declare const QObfuscation: {
     size: import('..').QFieldSize;
     required: boolean;
     mask: import('./types').QObfuscationMask;
+    icons: {
+        help: {
+            icon: string;
+        };
+    } & {
+        restricted: {
+            icon: string;
+        };
+        show: {
+            icon: string;
+        };
+        hide: {
+            icon: string;
+        };
+        help: {
+            icon: string;
+        };
+    };
+    texts: {
+        showHelp: string;
+    } & {
+        restricted: string;
+        showData: string;
+        hideData: string;
+        showHelp: string;
+    };
     loading: boolean;
-    icons: typeof import('./constants').DEFAULT_ICONS;
-    texts: typeof import('./constants').DEFAULT_TEXTS;
     labelPosition: import('..').QLabelPosition;
     revealable: boolean;
     bulletCount: number;
@@ -129,6 +201,7 @@ declare const QObfuscation: {
             toggle: () => void;
             revealed: boolean;
             loading: boolean;
+            describedBy?: string;
         }) => unknown;
         reveal?: (props: {
             revealed: boolean;
@@ -145,6 +218,7 @@ declare const QObfuscation: {
             toggle: () => void;
             revealed: boolean;
             loading: boolean;
+            describedBy?: string;
         }) => unknown;
         reveal?: (props: {
             revealed: boolean;

package/esm/components/QObfuscation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/index.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAiC,CAAA;AAGnD,OAAO,EAAE,YAAY,EAAE,CAAA;AAGvB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/QObfuscation/index.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAOshS,CAAC;;;;;;;;;;;;;;;;;uBAAD,CAAC;;;;;;;;;;;;EAPt/R,CAAA;AAGnD,OAAO,EAAE,YAAY,EAAE,CAAA;AAGvB,cAAc,SAAS,CAAA"}

package/esm/components/QOverflow/QOverflow.vue.js

@@ -1,6 +1,6 @@
 import { useId as e } from "../../composables/useId/index.js";
-import { QButton as t } from "../QButton/index.js";
-import { QIcon as n } from "../QIcon/index.js";
+import { QIcon as t } from "../QIcon/index.js";
+import { QButton as n } from "../QButton/index.js";
 import { DEFAULT_ICONS as r, DEFAULT_TEXTS as i } from "./constants.js";
 import { computed as a, createCommentVNode as o, createElementBlock as s, createElementVNode as c, createVNode as l, defineComponent as u, guardReactiveProps as d, mergeProps as f, nextTick as p, normalizeClass as m, normalizeProps as h, onBeforeUnmount as ee, onMounted as g, openBlock as _, ref as v, renderSlot as y, toRef as te, unref as b, watch as x, withCtx as S } from "vue";
 //#region src/components/QOverflow/QOverflow.vue?vue&type=script&setup=true&lang.ts
@@ -244,15 +244,15 @@ var C = [
 			role: oe.value,
 			"aria-label": I.value
 		}, [
-			F.value ? (_(), s("div", w, [y(e.$slots, "prev", h(d(L.value)), () => [l(b(t), {
+			F.value ? (_(), s("div", w, [y(e.$slots, "prev", h(d(L.value)), () => [l(b(n), {
 				class: "q-overflow__button",
 				variant: "ghost",
 				"data-testid": "q-overflow-prev",
 				disabled: L.value.disabled,
-				"aria-label": u.texts.previousText,
+				"aria-label": u.texts.back,
 				onClick: L.value.onClick
 			}, {
-				default: S(() => [l(b(n), f({ class: "q-overflow__icon" }, ie.value), null, 16)]),
+				default: S(() => [l(b(t), f({ class: "q-overflow__icon" }, ie.value), null, 16)]),
 				_: 1
 			}, 8, [
 				"disabled",
@@ -272,15 +272,15 @@ var C = [
 				ref: O,
 				class: m(ce.value)
 			}, [y(e.$slots, "default")], 2)], 40, ne),
-			F.value ? (_(), s("div", re, [y(e.$slots, "next", h(d(R.value)), () => [l(b(t), {
+			F.value ? (_(), s("div", re, [y(e.$slots, "next", h(d(R.value)), () => [l(b(n), {
 				class: "q-overflow__button",
 				variant: "ghost",
 				"data-testid": "q-overflow-next",
 				disabled: R.value.disabled,
-				"aria-label": u.texts.nextText,
+				"aria-label": u.texts.forward,
 				onClick: R.value.onClick
 			}, {
-				default: S(() => [l(b(n), f({ class: "q-overflow__icon" }, ae.value), null, 16)]),
+				default: S(() => [l(b(t), f({ class: "q-overflow__icon" }, ae.value), null, 16)]),
 				_: 1
 			}, 8, [
 				"disabled",

package/esm/components/QOverflow/constants.d.ts

@@ -13,10 +13,13 @@ export declare const DEFAULT_ICONS: {
         icon: string;
     };
 };
-/** Default accessible strings for navigation controls. */
+/**
+ * Default accessible strings for navigation controls. The keys mirror the icon keys
+ * (`back` and `forward`), so they stay apart from a parent's own `previous` and `next`.
+ */
 export declare const DEFAULT_TEXTS: {
-    previousText: string;
-    nextText: string;
+    back: string;
+    forward: string;
 };
 /**
  * Accessible copy for {@link QOverflow}, including an optional region name.

package/esm/components/QOverflow/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/QOverflow/constants.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAaY,CAAA;AAEtC,0DAA0D;AAC1D,eAAO,MAAM,aAAa;;;CAGQ,CAAA;AAElC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,aAAa,GAAG;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/QOverflow/constants.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAaY,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAGQ,CAAA;AAElC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,aAAa,GAAG;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}

package/esm/components/QOverflow/constants.js

@@ -5,8 +5,8 @@ var e = {
 	up: { icon: "chevron-up" },
 	down: { icon: "chevron-down" }
 }, t = {
-	previousText: "Previous",
-	nextText: "Next"
+	back: "Previous",
+	forward: "Next"
 };
 //#endregion
 export { e as DEFAULT_ICONS, t as DEFAULT_TEXTS };

package/esm/components/QOverlay/QOverlay.d.ts

@@ -21,13 +21,13 @@ declare const __VLS_component: import('vue').DefineComponent<QOverlayProps, {},
     onEnter?: (() => any) | undefined;
     onLeave?: (() => any) | undefined;
 }>, {
-    width: "auto" | "anchor";
     transition: string;
-    placement: import('./types').QOverlayPlacement;
+    width: "auto" | "anchor";
     focusWithinOnActivate: boolean;
     returnFocusOnDeactivate: boolean;
     appearance: import('./types').QOverlayAppearance;
     crossOffset: number;
+    placement: import('./types').QOverlayPlacement;
     attach: string;
     delay: number;
     trigger: import('./types').QOverlayTrigger;