@quidgest/ui 0.17.8 → 0.18.0

package/esm/composables/useSafeTriangle/index.d.ts

@@ -0,0 +1,31 @@
+import { Placement } from '../overlay';
+import { Ref } from 'vue';
+type UseSafeTriangleOptions = {
+    enabled: Ref<boolean>;
+    placement: Ref<Placement>;
+    getParentRect: () => DOMRect | null;
+    getContentRect: () => DOMRect | null;
+    getContentRoot: () => HTMLElement | null;
+    shouldSuppressLeave: () => boolean;
+    onLeave: () => void;
+    /** Called when the pointer enters the open submenu (or a deeper nested menu). */
+    onEnterContent?: (clientX: number, clientY: number) => void;
+};
+/**
+ * Tracks pointer movement and exposes safe triangle geometry for nested submenus.
+ */
+export declare function useSafeTriangle(options: UseSafeTriangleOptions): {
+    visible: Ref<boolean, boolean>;
+    top: Ref<number, number>;
+    left: Ref<number, number>;
+    width: Ref<number, number>;
+    height: Ref<number, number>;
+    path: Ref<string, string>;
+    refresh: (clientX?: number, clientY?: number) => void;
+    getLastPointer: () => {
+        x: number;
+        y: number;
+    };
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/esm/composables/useSafeTriangle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useSafeTriangle/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAW3C,OAAO,EAA+B,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAE3D,KAAK,sBAAsB,GAAG;IAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACzB,aAAa,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;IACnC,cAAc,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;IACpC,cAAc,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACxC,mBAAmB,EAAE,MAAM,OAAO,CAAA;IAClC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iFAAiF;IACjF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3D,CAAA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB;;;;;;;wBA4HnC,MAAM,YAAY,MAAM;;;;;EA0DnD"}

package/esm/composables/useSafeTriangle/index.js

@@ -0,0 +1,87 @@
+import { getSafeTriangleGeometry as e, isPointInRect as t, isPointerInsideMenuTree as n, isPointerMovingTowardSubmenu as r, resolveSafeTrianglePlacement as i } from "../../utils/safeTriangle.js";
+import { onBeforeUnmount as a, ref as o, watch as s } from "vue";
+//#region src/composables/useSafeTriangle/index.ts
+function c(c) {
+	let l = o(!1), u = o(0), d = o(0), f = o(0), p = o(0), m = o(""), h = !1, g = {
+		x: 0,
+		y: 0
+	}, _ = null, v = !1;
+	function y(e, t) {
+		return i(c.placement.value, e, t);
+	}
+	function b(t, n, r, i) {
+		if (!i) {
+			l.value = !1;
+			return;
+		}
+		let a = e(y(r, i), i, t, n);
+		if (!a) {
+			l.value = !1;
+			return;
+		}
+		l.value = !0, u.value = a.top, d.value = a.left, f.value = a.width, p.value = a.height, m.value = a.path;
+	}
+	function x(e, r) {
+		let i = c.getContentRect(), a = c.getContentRoot();
+		return i !== null && t(e, r, i) || a !== null && n(e, r, a);
+	}
+	function S(e, n) {
+		let i = c.getParentRect(), a = c.getContentRect(), o = c.getContentRoot();
+		if (x(e, n)) {
+			l.value = !1, v || c.onEnterContent?.(e, n), v = !0;
+			return;
+		}
+		if (v = !1, i && t(e, n, i)) {
+			_ = {
+				x: e,
+				y: n
+			}, b(e, n, i, a);
+			return;
+		}
+		if (!a || !_) {
+			l.value = !1;
+			return;
+		}
+		if (!r(e, n, i, a, y(i, a), _, o)) {
+			l.value = !1, c.shouldSuppressLeave() || c.onLeave();
+			return;
+		}
+		b(_.x, _.y, i, a);
+	}
+	function C(e) {
+		g = {
+			x: e.clientX,
+			y: e.clientY
+		}, c.enabled.value && S(e.clientX, e.clientY);
+	}
+	function w(e, t) {
+		e !== void 0 && t !== void 0 && (g = {
+			x: e,
+			y: t
+		}), c.enabled.value && S(g.x, g.y);
+	}
+	function T() {
+		h || (h = !0, document.addEventListener("pointermove", C, !0));
+	}
+	function E() {
+		h && (h = !1, document.removeEventListener("pointermove", C, !0), l.value = !1, v = !1, _ = null);
+	}
+	return s(c.enabled, (e) => {
+		if (e) {
+			v = !1;
+			let e = c.getParentRect();
+			_ = e && t(g.x, g.y, e) ? { ...g } : null, T(), w();
+		} else E();
+	}, { immediate: !0 }), a(E), {
+		visible: l,
+		top: u,
+		left: d,
+		width: f,
+		height: p,
+		path: m,
+		refresh: w,
+		getLastPointer: () => ({ ...g })
+	};
+}
+//#endregion
+export { c as useSafeTriangle };

package/esm/index.d.ts

@@ -48,6 +48,7 @@ declare module '@vue/runtime-core' {
 		QListItem: typeof import('@quidgest/ui/components')['QListItem']
 		QListItemGroup: typeof import('@quidgest/ui/components')['QListItemGroup']
 		QMeter: typeof import('@quidgest/ui/components')['QMeter']
+		QObfuscation: typeof import('@quidgest/ui/components')['QObfuscation']
 		QOverlay: typeof import('@quidgest/ui/components')['QOverlay']
 		QPasswordField: typeof import('@quidgest/ui/components')['QPasswordField']
 		QPopover: typeof import('@quidgest/ui/components')['QPopover']
@@ -62,6 +63,8 @@ declare module '@vue/runtime-core' {
 		QSkeletonLoader: typeof import('@quidgest/ui/components')['QSkeletonLoader']
 		QSpinnerLoader: typeof import('@quidgest/ui/components')['QSpinnerLoader']
 		QSwitch: typeof import('@quidgest/ui/components')['QSwitch']
+		QTabs: typeof import('@quidgest/ui/components')['QTabs']
+		QTab: typeof import('@quidgest/ui/components')['QTab']
 		QTextArea: typeof import('@quidgest/ui/components')['QTextArea']
 		QTextField: typeof import('@quidgest/ui/components')['QTextField']
 		DEFAULT_TEXTS: typeof import('@quidgest/ui/components')['DEFAULT_TEXTS']

package/esm/utils/date.d.ts

@@ -2,7 +2,7 @@
  * Converts a date format pattern to an input mask pattern.
  * Supports numeric, textual, weekday, meridiem, milliseconds and quoted literal tokens.
  * @param format Date format pattern (e.g. `dd/MM/yyyy HH:mm`).
- * @returns Mask string consumed by `useInputMask`.
+ * @returns Mask string.
  * @example
  * convertDatePatternToMask('dd/MM/yyyy') => '##/##/####'
  * convertDatePatternToMask('HH:mm:ss') => '##:##:##'
@@ -193,4 +193,39 @@ export declare function getFirstDayOfMonth(date: Date): Date;
  * @returns New date set to the last day of that month.
  */
 export declare function getLastDayOfMonth(date: Date): Date;
+/**
+ * Advances the value cursor past a format literal when it is present in the input.
+ * @param value Date formatted string.
+ * @param cursor The position of the cursor in value.
+ * @param token A string that represents part of the date format (ex. 'yyyy', 'MM', 'dd').
+ * @returns Updated cursor, or `null` when the literal is not yet in the value.
+ */
+export declare function advancePastFormatLiteral(value: string, cursor: number, token: string): number | null;
+/**
+ * Get the string value of the part of the datetime within it's range of possible valid values
+ * and padded to the specified number of digits.
+ * @param token A string that represents part of the date format (ex. 'yyyy', 'MM', 'dd').
+ * @param digits A string of digit characters that represents part of a datetime value (year, month, day etc.)
+ * @param value The actual numeric value of a part of a datetime (year, month, day etc.)
+ * @returns Normalized string value of the part of the datetime.
+ */
+export declare function normalizeNumericToken(token: string, digits: string, value: number): string;
+/**
+ * Get the string value of the datetime where the day is guaranteed to be within it's range of valid values.
+ * @param value Date formatted string.
+ * @param tokens Strings that represent parts of the date format (ex. 'yyyy', 'MM', 'dd').
+ * @returns String value of the datetime with the day clamped to it's maximum possible value.
+ */
+export declare function clampDayByMonthYear(value: string, tokens: string[]): string;
+/**
+ * Clamps fully-typed numeric segments to valid ranges for the provided format.
+ * @param value Masked user input.
+ * @param format Date/time format pattern.
+ * @param options Options
+ * @param options.padMaxDigits Whether to pad each segment to it's maximum digits
+ * @returns Input with out-of-range numeric segments normalized.
+ */
+export declare function clampNumericSegments(value: string, format: string, options?: {
+    padMaxDigits: boolean;
+}): string;
 //# sourceMappingURL=date.d.ts.map

package/esm/utils/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"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"}

package/esm/utils/date.js

@@ -476,5 +476,94 @@ function T(e) {
 function E(e) {
 	return new Date(e.getFullYear(), e.getMonth() + 1, 0);
 }
+function D(e, t, n) {
+	if (n.startsWith("'")) {
+		let r = n.slice(1, -1).replace(/''/g, "'");
+		return e.slice(t).startsWith(r) ? t + r.length : null;
+	}
+	if (n === "a") {
+		let n = e.slice(t), r = n.match(/^\s*(AM|PM)/i);
+		return r ? t + r[0].length : n.startsWith(" ") ? t + 1 : null;
+	}
+	return t >= e.length || e[t] !== n ? null : t + 1;
+}
+function O(e, t, n) {
+	let r = n;
+	return (e === "MM" || e === "M") && (r = Math.min(12, Math.max(1, n))), (e === "dd" || e === "d") && (r = Math.min(31, Math.max(1, n))), (e === "HH" || e === "H") && (r = Math.min(23, Math.max(0, n))), (e === "hh" || e === "h") && (r = Math.min(12, Math.max(1, n))), (e === "mm" || e === "m" || e === "ss" || e === "s") && (r = Math.min(59, Math.max(0, n))), t.length > 1 ? a(r, t.length) : r === 0 && (e === "hh" || e === "h" || e === "MM" || e === "M" || e === "dd" || e === "d") ? "1" : String(r);
+}
+function k(e, t) {
+	let n = null, r = null, i = -1, o = 0, s = null, c = 0;
+	for (let a of t) {
+		if (a.startsWith("'")) {
+			let t = D(e, c, a);
+			if (t === null) break;
+			c = t;
+			continue;
+		}
+		let t = a === "yyyy" ? 4 : a === "yy" || [
+			"MM",
+			"dd",
+			"M",
+			"d"
+		].includes(a) ? 2 : 0;
+		if (t === 0) {
+			let t = D(e, c, a);
+			if (t === null) break;
+			c = t;
+			continue;
+		}
+		let l = e.slice(c).match(/^\d+/)?.[0]?.slice(0, t) ?? "";
+		if (!l) continue;
+		let u = c + l.length;
+		if (!(l.length === t || u < e.length && !/\d/.test(e[u]))) continue;
+		let d = Number.parseInt(l, 10);
+		Number.isNaN(d) || ((a === "MM" || a === "M") && (n = Math.min(12, Math.max(1, d))), a === "yyyy" && (r = d), a === "yy" && (r = d < 50 ? 2e3 + d : 1900 + d), (a === "dd" || a === "d") && (i = c, o = l.length, s = Math.max(1, d)), c = u);
+	}
+	if (i < 0 || s === null || n === null || r === null) return e;
+	let l = h(n - 1, r);
+	if (s <= l) return e;
+	let u = o > 1 ? a(l, o) : String(l);
+	return `${e.slice(0, i)}${u}${e.slice(i + o)}`;
+}
+function A(e, t, n) {
+	let r = t.match(/yyyy|yy|MMMM|MMM|MM|M|dd|d|EEEE|EEE|HH|H|hh|h|mm|m|ss|s|SSS|S|a|'(?:''|[^'])*'|./g) ?? [], i = e, o = 0;
+	for (let e of r) {
+		if (e.startsWith("'")) {
+			let t = D(i, o, e);
+			if (t === null) break;
+			o = t;
+			continue;
+		}
+		let t = e === "yyyy" ? 4 : e === "yy" ? 2 : e === "SSS" ? 3 : e === "S" ? 1 : [
+			"MM",
+			"dd",
+			"HH",
+			"hh",
+			"mm",
+			"ss",
+			"M",
+			"d",
+			"H",
+			"h",
+			"m",
+			"s"
+		].includes(e) ? 2 : 0;
+		if (t === 0) {
+			let t = D(i, o, e);
+			if (t === null) break;
+			o = t;
+			continue;
+		}
+		let r = i.slice(o).match(/^\d+/)?.[0]?.slice(0, t) ?? "";
+		if (!r) continue;
+		let s = o + r.length;
+		if (!(r.length === t || s < i.length && !/\d/.test(i[s]))) continue;
+		let c = Number.parseInt(r, 10);
+		if (Number.isNaN(c)) continue;
+		let l = O(e, n?.padMaxDigits ? a(r, t) : r, c);
+		i = `${i.slice(0, o)}${l}${i.slice(s)}`, o += l.length;
+	}
+	return k(i, r);
+}
 //#endregion
-export { C as addDays, w as addMonths, d as completePartialDateInput, e as convertDatePatternToMask, y as formatDate, n as formatUsesSeconds, t as formatUsesTime, h as getDaysInMonth, S as getEndOfDay, T as getFirstDayOfMonth, g as getFirstDayOfWeek, E as getLastDayOfMonth, x as getStartOfDay, f as inputIncludesTimePortion, v as isBetween, m as isLeapYear, _ as isSameDay, i as isTimeOnlyFormat, a as padNumber, b as parseDate, p as parseDateWithCompletion, s as parseIsoDate, r as uses12HourFormat };
+export { C as addDays, w as addMonths, D as advancePastFormatLiteral, k as clampDayByMonthYear, A as clampNumericSegments, d as completePartialDateInput, e as convertDatePatternToMask, y as formatDate, n as formatUsesSeconds, t as formatUsesTime, h as getDaysInMonth, S as getEndOfDay, T as getFirstDayOfMonth, g as getFirstDayOfWeek, E as getLastDayOfMonth, x as getStartOfDay, f as inputIncludesTimePortion, v as isBetween, m as isLeapYear, _ as isSameDay, i as isTimeOnlyFormat, O as normalizeNumericToken, a as padNumber, b as parseDate, p as parseDateWithCompletion, s as parseIsoDate, r as uses12HourFormat };

package/esm/utils/index.d.ts

@@ -16,4 +16,5 @@
  */
 export * from './color';
 export * from './date';
+export * from './mask';
 //# sourceMappingURL=index.d.ts.map

package/esm/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA"}

package/esm/utils/index.js

@@ -4,45 +4,51 @@ import { isValidHex as o, parseColor as s, tryParseRgb as c } from "./color/pars
 import { getComplementaryColor as l, getContrastingColor as u } from "./color/contrast.js";
 import { darken as d, lighten as f } from "./color/manipulate.js";
 import { mergeColorSchemes as p } from "./color/merge.js";
-import { addDays as m, addMonths as h, completePartialDateInput as g, convertDatePatternToMask as _, formatDate as v, formatUsesSeconds as y, formatUsesTime as b, getDaysInMonth as x, getEndOfDay as S, getFirstDayOfMonth as C, getFirstDayOfWeek as w, getLastDayOfMonth as T, getStartOfDay as E, inputIncludesTimePortion as D, isBetween as O, isLeapYear as k, isSameDay as A, isTimeOnlyFormat as j, padNumber as M, parseDate as N, parseDateWithCompletion as P, parseIsoDate as F, uses12HourFormat as I } from "./date.js";
+import { addDays as m, addMonths as h, advancePastFormatLiteral as g, clampDayByMonthYear as _, clampNumericSegments as v, completePartialDateInput as y, convertDatePatternToMask as b, formatDate as x, formatUsesSeconds as S, formatUsesTime as C, getDaysInMonth as w, getEndOfDay as T, getFirstDayOfMonth as E, getFirstDayOfWeek as D, getLastDayOfMonth as O, getStartOfDay as k, inputIncludesTimePortion as A, isBetween as j, isLeapYear as M, isSameDay as N, isTimeOnlyFormat as P, normalizeNumericToken as F, padNumber as I, parseDate as L, parseDateWithCompletion as R, parseIsoDate as z, uses12HourFormat as B } from "./date.js";
+import { applyMask as V } from "./mask.js";
 //#region src/utils/index.ts
-var L = /* @__PURE__ */ e({
+var H = /* @__PURE__ */ e({
 	addDays: () => m,
 	addMonths: () => h,
-	completePartialDateInput: () => g,
-	convertDatePatternToMask: () => _,
+	advancePastFormatLiteral: () => g,
+	applyMask: () => V,
+	clampDayByMonthYear: () => _,
+	clampNumericSegments: () => v,
+	completePartialDateInput: () => y,
+	convertDatePatternToMask: () => b,
 	darken: () => d,
-	formatDate: () => v,
-	formatUsesSeconds: () => y,
-	formatUsesTime: () => b,
+	formatDate: () => x,
+	formatUsesSeconds: () => S,
+	formatUsesTime: () => C,
 	getComplementaryColor: () => l,
 	getContrastingColor: () => u,
-	getDaysInMonth: () => x,
-	getEndOfDay: () => S,
-	getFirstDayOfMonth: () => C,
-	getFirstDayOfWeek: () => w,
-	getLastDayOfMonth: () => T,
-	getStartOfDay: () => E,
+	getDaysInMonth: () => w,
+	getEndOfDay: () => T,
+	getFirstDayOfMonth: () => E,
+	getFirstDayOfWeek: () => D,
+	getLastDayOfMonth: () => O,
+	getStartOfDay: () => k,
 	hslToRgb: () => t,
 	hueToRgb: () => n,
-	inputIncludesTimePortion: () => D,
-	isBetween: () => O,
-	isLeapYear: () => k,
-	isSameDay: () => A,
-	isTimeOnlyFormat: () => j,
+	inputIncludesTimePortion: () => A,
+	isBetween: () => j,
+	isLeapYear: () => M,
+	isSameDay: () => N,
+	isTimeOnlyFormat: () => P,
 	isValidHex: () => o,
 	lighten: () => f,
 	mergeColorSchemes: () => p,
-	padNumber: () => M,
+	normalizeNumericToken: () => F,
+	padNumber: () => I,
 	parseColor: () => s,
-	parseDate: () => N,
-	parseDateWithCompletion: () => P,
-	parseIsoDate: () => F,
+	parseDate: () => L,
+	parseDateWithCompletion: () => R,
+	parseIsoDate: () => z,
 	rgbToHex: () => r,
 	rgbToHsl: () => i,
 	rgbToVariableString: () => a,
 	tryParseRgb: () => c,
-	uses12HourFormat: () => I
+	uses12HourFormat: () => B
 });
 //#endregion
-export { m as addDays, h as addMonths, g as completePartialDateInput, _ as convertDatePatternToMask, d as darken, v as formatDate, y as formatUsesSeconds, b as formatUsesTime, l as getComplementaryColor, u as getContrastingColor, x as getDaysInMonth, S as getEndOfDay, C as getFirstDayOfMonth, w as getFirstDayOfWeek, T as getLastDayOfMonth, E as getStartOfDay, t as hslToRgb, n as hueToRgb, D as inputIncludesTimePortion, O as isBetween, k as isLeapYear, A as isSameDay, j as isTimeOnlyFormat, o as isValidHex, f as lighten, p as mergeColorSchemes, M as padNumber, s as parseColor, N as parseDate, P as parseDateWithCompletion, F as parseIsoDate, r as rgbToHex, i as rgbToHsl, a as rgbToVariableString, c as tryParseRgb, I as uses12HourFormat, L as utils_exports };
+export { m as addDays, h as addMonths, g as advancePastFormatLiteral, V as applyMask, _ as clampDayByMonthYear, v as clampNumericSegments, y as completePartialDateInput, b as convertDatePatternToMask, d as darken, x as formatDate, S as formatUsesSeconds, C as formatUsesTime, l as getComplementaryColor, u as getContrastingColor, w as getDaysInMonth, T as getEndOfDay, E as getFirstDayOfMonth, D as getFirstDayOfWeek, O as getLastDayOfMonth, k as getStartOfDay, t as hslToRgb, n as hueToRgb, A as inputIncludesTimePortion, j as isBetween, M as isLeapYear, N as isSameDay, P as isTimeOnlyFormat, o as isValidHex, f as lighten, p as mergeColorSchemes, F as normalizeNumericToken, I as padNumber, s as parseColor, L as parseDate, R as parseDateWithCompletion, z as parseIsoDate, r as rgbToHex, i as rgbToHsl, a as rgbToVariableString, c as tryParseRgb, B as uses12HourFormat, H as utils_exports };

package/esm/utils/mask.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Applies a mask pattern to an input value.
+ * The mask supports:
+ * - `#` / `n`: single numeric digit
+ * - `A`: single alphabetic character, normalized to uppercase
+ * - `a`: single alphabetic character, normalized to lowercase
+ * - `p`: meridiem token (`AM` or `PM` only)
+ * - `W`: variable-width alphabetic segment
+ * - any other character: fixed separator/literal
+ * @param value Raw user input.
+ * @param maskPattern Mask to apply.
+ * @returns Masked value normalized to the provided pattern.
+ * @example
+ * applyMask('1234567', '##/##/####') => '12/34/567'
+ */
+export declare function applyMask(value: string, maskPattern: string): string;
+//# sourceMappingURL=mask.d.ts.map

package/esm/utils/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../src/utils/mask.ts"],"names":[],"mappings":"AA0MA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAsGpE"}

package/esm/utils/mask.js

@@ -0,0 +1,154 @@
+//#region src/utils/mask.ts
+function e(e) {
+	return /[\p{L}\s.'-]/u.test(e);
+}
+function t(e, t) {
+	let n = t;
+	for (; n < e.length;) {
+		let t = e[n];
+		if (t === "!") {
+			n += 2;
+			continue;
+		}
+		if (t === "#" || t === "n" || t === "A" || t === "a" || t === "W" || t === "p") return n;
+		n += 1;
+	}
+	return -1;
+}
+function n(e, t) {
+	let n = t;
+	for (; n < e.length && e[n] === " ";) n += 1;
+	let r = "", i = n;
+	for (; i < e.length && /[A-Za-z]/.test(e[i] ?? "");) {
+		let t = (e[i] ?? "").toUpperCase();
+		if (r.length === 0) {
+			if (t === "A" || t === "P") {
+				r = `${t}M`, i += 1, i < e.length && (e[i] ?? "").toUpperCase() === "M" && (i += 1);
+				break;
+			}
+		} else if (r.length === 1 && t === "M") {
+			r += "M", i += 1;
+			break;
+		}
+		i += 1;
+	}
+	for (; i < e.length && /[A-Za-z]/.test(e[i] ?? "");) i += 1;
+	return {
+		consumed: i - t,
+		text: r
+	};
+}
+function r(t, n) {
+	let r = 0, i = 0;
+	for (; i < n.length;) {
+		let a = n[i];
+		if (a === "p") return r;
+		if (a === "!") {
+			let e = n[i + 1];
+			e && t[r] === e && (r += 1), i += 2;
+			continue;
+		}
+		if (a === "#" || a === "n") {
+			if (/\d/.test(t[r] ?? "")) {
+				r += 1, i += 1;
+				continue;
+			}
+			return -1;
+		}
+		if (a === "A" || a === "a") {
+			if (e(t[r] ?? "")) {
+				r += 1, i += 1;
+				continue;
+			}
+			return -1;
+		}
+		if (a === "W") {
+			let a = n[i + 1];
+			if (e(t[r] ?? "") && t[r] !== a) {
+				r += 1;
+				continue;
+			}
+			i += 1;
+			continue;
+		}
+		if (t[r] === a) {
+			r += 1, i += 1;
+			continue;
+		}
+		if (a === " " && n[i + 1] === "p") {
+			let e = t[r];
+			if ((e === void 0 || e === " " || /[A-Za-z]/.test(e)) && (i += 1, n[i] === "p")) return r;
+		}
+		return -1;
+	}
+	return -1;
+}
+function i(e, t, i) {
+	let a = r(e, t);
+	return a < 0 || i <= a ? "" : n(e.slice(0, i), a).text;
+}
+function a(e, t) {
+	let n = t.toUpperCase();
+	if (n === "AM" || n === "PM") return !1;
+	let r = e.toUpperCase();
+	return t ? n.length === 1 && (n === "A" || n === "P") ? r === "M" : !1 : r === "A" || r === "P";
+}
+function o(t, n) {
+	return n === "#" || n === "n" ? /\d/.test(t) : n === "p" ? a(t, "") : n === "A" || n === "a" || n === "W" ? e(t) : t === n;
+}
+function s(e, n, r, s, c) {
+	let l = t(n, r);
+	if (l < 0) return !1;
+	let u = n[l];
+	return !u || u === "!" ? !1 : u === "p" ? a(e, s !== void 0 && c !== void 0 ? i(s, n, c) : "") : o(e, u);
+}
+function c(t, r) {
+	let i = "", a = 0, o = 0;
+	for (; o < r.length && a < t.length;) {
+		let c = r[o], l = t[a];
+		if (c === "!") {
+			let e = r[o + 1];
+			if (!e) break;
+			l === e ? (i += e, a++) : i += e, o += 2;
+			continue;
+		}
+		if (c === "#") if (/\d/.test(l)) i += l, a++;
+		else {
+			a++;
+			continue;
+		}
+		else if (c === "n") /\d/.test(l) && (i += l, a++);
+		else if (c === "A" || c === "a") if (e(l)) i += c === "A" ? l.toUpperCase() : l.toLowerCase(), a++;
+		else {
+			a++;
+			continue;
+		}
+		else if (c === "p") {
+			let e = n(t, a);
+			if (e.consumed === 0) break;
+			a += e.consumed, e.text && (i += e.text), o++;
+			continue;
+		} else if (c === "W") {
+			let n = r[o + 1], s = !1;
+			for (; a < t.length;) {
+				let r = t[a];
+				if (n && r === n && s) break;
+				if (e(r)) {
+					i += r, a++, s = !0;
+					continue;
+				}
+				if (n && r === n) break;
+				a++;
+			}
+		} else if (l === c) i += c, a++;
+		else if (/\d/.test(l)) i += c;
+		else if (s(l, r, o + 1, t, a)) {
+			i += c, o++;
+			continue;
+		} else a++;
+		o++;
+	}
+	return i;
+}
+//#endregion
+export { c as applyMask };

package/esm/utils/safeTriangle.d.ts

@@ -0,0 +1,68 @@
+import { Placement } from '../composables/overlay';
+export type SafeTriangleGeometry = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    path: string;
+};
+export type SafeTriangleVertices = {
+    a: {
+        x: number;
+        y: number;
+    };
+    b: {
+        x: number;
+        y: number;
+    };
+    c: {
+        x: number;
+        y: number;
+    };
+};
+export type Point = {
+    x: number;
+    y: number;
+};
+/**
+ * Returns whether a point lies inside an axis-aligned rectangle.
+ */
+export declare function isPointInRect(x: number, y: number, rect: DOMRect): boolean;
+/**
+ * Returns whether a point lies inside the triangle defined by three vertices.
+ */
+export declare function isPointInTriangle(x: number, y: number, a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}, c: {
+    x: number;
+    y: number;
+}): boolean;
+/**
+ * Picks left/right safe-triangle placement from where the submenu actually sits
+ * relative to its parent (handles overlay flip).
+ */
+export declare function resolveSafeTrianglePlacement(preferred: Placement, parentRect: DOMRect | null, contentRect: DOMRect | null): Placement;
+/**
+ * Builds safe triangle vertices for a submenu placement.
+ */
+export declare function getSafeTriangleVertices(placement: Placement, contentRect: DOMRect, cursorX: number, cursorY: number): SafeTriangleVertices | null;
+/**
+ * Builds SVG geometry for the safe triangle overlay.
+ */
+export declare function getSafeTriangleGeometry(placement: Placement, contentRect: DOMRect, cursorX: number, cursorY: number): SafeTriangleGeometry | null;
+/**
+ * Returns whether the pointer is inside any submenu body nested under a menu panel.
+ */
+export declare function isPointerInsideMenuTree(x: number, y: number, contentRoot: HTMLElement | null): boolean;
+/**
+ * Returns whether the pointer can traverse toward an open submenu.
+ *
+ * @param apex - Frozen pointer position from the parent menu (exit / last in-parent point).
+ *   Leave detection uses the triangle from this apex to the submenu edge — not the current cursor.
+ */
+export declare function isPointerMovingTowardSubmenu(clientX: number, clientY: number, parentRect: DOMRect | null, contentRect: DOMRect | null, placement: Placement, apex: Point | null, contentRoot?: HTMLElement | null): boolean;
+//# sourceMappingURL=safeTriangle.d.ts.map

package/esm/utils/safeTriangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeTriangle.d.ts","sourceRoot":"","sources":["../../src/utils/safeTriangle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACT,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,OAAO,GAAG,IAAI,EAC1B,WAAW,EAAE,OAAO,GAAG,IAAI,GACzB,SAAS,CASX;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACb,oBAAoB,GAAG,IAAI,CAmB7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACb,oBAAoB,GAAG,IAAI,CA0C7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,WAAW,EAAE,WAAW,GAAG,IAAI,GAC7B,OAAO,CAMT;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAAG,IAAI,EAC1B,WAAW,EAAE,OAAO,GAAG,IAAI,EAC3B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,KAAK,GAAG,IAAI,EAClB,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC9B,OAAO,CAYT"}