@quidgest/ui 0.17.9 → 0.19.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/esm/components/index.js

@@ -30,25 +30,26 @@ import { QDivider as F } from "./QDivider/index.js";
 import { QDropdownMenu as te } from "./QDropdownMenu/index.js";
 import { QFileUpload as I } from "./QFileUpload/index.js";
 import { QCol as L, QContainer as R, QRow as z, QSpacer as B } from "./QGrid/index.js";
-import { QGroupBox as V } from "./QGroupBox/index.js";
-import { QInputGroup as H } from "./QInputGroup/index.js";
-import { QLineLoader as U } from "./QLineLoader/index.js";
-import { QMeter as W } from "./QMeter/index.js";
-import { QObfuscation as G } from "./QObfuscation/index.js";
-import { QPasswordField as K } from "./QPasswordField/index.js";
-import { QPopover as q } from "./QPopover/index.js";
-import { QPropertyList as J, QPropertyListGroup as Y, QPropertyListPanel as X, QPropertyListRow as Z } from "./QPropertyList/index.js";
-import { QRadioButton as Q, QRadioGroup as $ } from "./QRadioGroup/index.js";
+import { QInputGroup as V } from "./QInputGroup/index.js";
+import { QLineLoader as H } from "./QLineLoader/index.js";
+import { QMeter as U } from "./QMeter/index.js";
+import { QObfuscation as W } from "./QObfuscation/index.js";
+import { QPasswordField as G } from "./QPasswordField/index.js";
+import { QPopover as K } from "./QPopover/index.js";
+import { QPropertyList as q, QPropertyListGroup as J, QPropertyListPanel as Y, QPropertyListRow as X } from "./QPropertyList/index.js";
+import { QRadioButton as Z, QRadioGroup as Q } from "./QRadioGroup/index.js";
+import { QSection as $ } from "./QSection/index.js";
 import { QSelect as ne } from "./QSelect/index.js";
 import { QToggle as re } from "./QToggle/index.js";
-import { QSidebar as ie } from "./QSidebar/index.js";
-import { QTextArea as ae } from "./QTextArea/index.js";
-import { QThemeProvider as oe } from "./QThemeProvider/index.js";
-import { QToast as se, QToaster as ce } from "./QToast/index.js";
-import { QToggleGroup as le, QToggleGroupItem as ue } from "./QToggleGroup/index.js";
-import { QTooltip as de } from "./QTooltip/index.js";
+import { QSidebar as ie, QSidebarItem as ae } from "./QSidebar/index.js";
+import { QTab as oe, QTabs as se } from "./QTabs/index.js";
+import { QTextArea as ce } from "./QTextArea/index.js";
+import { QThemeProvider as le } from "./QThemeProvider/index.js";
+import { QToast as ue, QToaster as de } from "./QToast/index.js";
+import { QToggleGroup as fe, QToggleGroupItem as pe } from "./QToggleGroup/index.js";
+import { QTooltip as me } from "./QTooltip/index.js";
 //#region src/components/index.ts
-var fe = /* @__PURE__ */ ee({
+var he = /* @__PURE__ */ ee({
 	DEFAULT_TEXTS: () => b,
 	QAccordion: () => c,
 	QAccordionItem: () => l,
@@ -76,44 +77,47 @@ var fe = /* @__PURE__ */ ee({
 	QField: () => y,
 	QFileUpload: () => I,
 	QFocusWrap: () => D,
-	QGroupBox: () => V,
 	QIcon: () => r,
 	QIconFont: () => i,
 	QIconImg: () => a,
 	QIconSvg: () => o,
-	QInputGroup: () => H,
+	QInputGroup: () => V,
 	QLabel: () => g,
-	QLineLoader: () => U,
+	QLineLoader: () => H,
 	QList: () => C,
 	QListItem: () => w,
 	QListItemGroup: () => T,
-	QMeter: () => W,
-	QObfuscation: () => G,
+	QMeter: () => U,
+	QObfuscation: () => W,
 	QOverlay: () => O,
-	QPasswordField: () => K,
-	QPopover: () => q,
-	QPropertyList: () => J,
-	QPropertyListGroup: () => Y,
-	QPropertyListPanel: () => X,
-	QPropertyListRow: () => Z,
-	QRadioButton: () => Q,
-	QRadioGroup: () => $,
+	QPasswordField: () => G,
+	QPopover: () => K,
+	QPropertyList: () => q,
+	QPropertyListGroup: () => J,
+	QPropertyListPanel: () => Y,
+	QPropertyListRow: () => X,
+	QRadioButton: () => Z,
+	QRadioGroup: () => Q,
 	QRow: () => z,
+	QSection: () => $,
 	QSelect: () => ne,
 	QSidebar: () => ie,
+	QSidebarItem: () => ae,
 	QSkeletonLoader: () => m,
 	QSpacer: () => B,
 	QSpinnerLoader: () => e,
 	QSwitch: () => A,
-	QTextArea: () => ae,
+	QTab: () => oe,
+	QTabs: () => se,
+	QTextArea: () => ce,
 	QTextField: () => x,
-	QThemeProvider: () => oe,
-	QToast: () => se,
-	QToaster: () => ce,
+	QThemeProvider: () => le,
+	QToast: () => ue,
+	QToaster: () => de,
 	QToggle: () => re,
-	QToggleGroup: () => le,
-	QToggleGroupItem: () => ue,
-	QTooltip: () => de
+	QToggleGroup: () => fe,
+	QToggleGroupItem: () => pe,
+	QTooltip: () => me
 });
 //#endregion
-export { b as DEFAULT_TEXTS, c as QAccordion, l as QAccordionItem, u as QAvatar, f as QBadge, p as QBadgeIndicator, t as QButton, d as QButtonGroup, n as QCard, h as QCarousel, _ as QCheckbox, v as QCheckboxLabel, L as QCol, s as QCollapsible, S as QColorPicker, k as QCombobox, R as QContainer, j as QDateTimePicker, M as QDefaultsProvider, N as QDialog, P as QDialogProvider, E as QDismissibleLayer, F as QDivider, te as QDropdownMenu, y as QField, I as QFileUpload, D as QFocusWrap, V as QGroupBox, r as QIcon, i as QIconFont, a as QIconImg, o as QIconSvg, H as QInputGroup, g as QLabel, U as QLineLoader, C as QList, w as QListItem, T as QListItemGroup, W as QMeter, G as QObfuscation, O as QOverlay, K as QPasswordField, q as QPopover, J as QPropertyList, Y as QPropertyListGroup, X as QPropertyListPanel, Z as QPropertyListRow, Q as QRadioButton, $ as QRadioGroup, z as QRow, ne as QSelect, ie as QSidebar, m as QSkeletonLoader, B as QSpacer, e as QSpinnerLoader, A as QSwitch, ae as QTextArea, x as QTextField, oe as QThemeProvider, se as QToast, ce as QToaster, re as QToggle, le as QToggleGroup, ue as QToggleGroupItem, de as QTooltip, fe as components_exports };
+export { b as DEFAULT_TEXTS, c as QAccordion, l as QAccordionItem, u as QAvatar, f as QBadge, p as QBadgeIndicator, t as QButton, d as QButtonGroup, n as QCard, h as QCarousel, _ as QCheckbox, v as QCheckboxLabel, L as QCol, s as QCollapsible, S as QColorPicker, k as QCombobox, R as QContainer, j as QDateTimePicker, M as QDefaultsProvider, N as QDialog, P as QDialogProvider, E as QDismissibleLayer, F as QDivider, te as QDropdownMenu, y as QField, I as QFileUpload, D as QFocusWrap, r as QIcon, i as QIconFont, a as QIconImg, o as QIconSvg, V as QInputGroup, g as QLabel, H as QLineLoader, C as QList, w as QListItem, T as QListItemGroup, U as QMeter, W as QObfuscation, O as QOverlay, G as QPasswordField, K as QPopover, q as QPropertyList, J as QPropertyListGroup, Y as QPropertyListPanel, X as QPropertyListRow, Z as QRadioButton, Q as QRadioGroup, z as QRow, $ as QSection, ne as QSelect, ie as QSidebar, ae as QSidebarItem, m as QSkeletonLoader, B as QSpacer, e as QSpinnerLoader, A as QSwitch, oe as QTab, se as QTabs, ce as QTextArea, x as QTextField, le as QThemeProvider, ue as QToast, de as QToaster, re as QToggle, fe as QToggleGroup, pe as QToggleGroupItem, me as QTooltip, he as components_exports };

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

@@ -36,7 +36,6 @@ declare module '@vue/runtime-core' {
 		QContainer: typeof import('@quidgest/ui/components')['QContainer']
 		QRow: typeof import('@quidgest/ui/components')['QRow']
 		QSpacer: typeof import('@quidgest/ui/components')['QSpacer']
-		QGroupBox: typeof import('@quidgest/ui/components')['QGroupBox']
 		QIcon: typeof import('@quidgest/ui/components')['QIcon']
 		QIconFont: typeof import('@quidgest/ui/components')['QIconFont']
 		QIconImg: typeof import('@quidgest/ui/components')['QIconImg']
@@ -58,11 +57,15 @@ declare module '@vue/runtime-core' {
 		QPropertyListPanel: typeof import('@quidgest/ui/components')['QPropertyListPanel']
 		QRadioButton: typeof import('@quidgest/ui/components')['QRadioButton']
 		QRadioGroup: typeof import('@quidgest/ui/components')['QRadioGroup']
+		QSection: typeof import('@quidgest/ui/components')['QSection']
 		QSelect: typeof import('@quidgest/ui/components')['QSelect']
 		QSidebar: typeof import('@quidgest/ui/components')['QSidebar']
+		QSidebarItem: typeof import('@quidgest/ui/components')['QSidebarItem']
 		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":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAE1E;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAMzD;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0GvF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAwDjF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACvB,IAAI,GAAG,IAAI,CAQb;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAM3D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAE7E;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACxD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;CAC5D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IACpE;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;CACxE,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA6E3F;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAwQjG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAI9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAI5C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAiBf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuB1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CA6D3E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,GACjC,MAAM,CAwER"}

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"}