asheeui 0.6.14 → 0.7.0

package/dist/utils/resolve-token.js

@@ -1,19 +1,16 @@
 "use client";
-function u(n, e, r, t) {
-  return n ?? e ?? r ?? t;
+//#region src/utils/resolve-token.ts
+function e(e, t, n, r) {
+	return e ?? t ?? n ?? r;
 }
-function o(n, e, r) {
-  return n ?? e ?? r;
+function t(e, t, n) {
+	return e ?? t ?? n;
 }
-function i(n, e, r, t = "md") {
-  return n ?? e ?? r ?? t;
+function n(e, t, n, r = "md") {
+	return e ?? t ?? n ?? r;
 }
-function s(n, e, r) {
-  return e[n] ?? e[r] ?? "";
+function r(e, t, n) {
+	return t[e] ?? t[n] ?? "";
 }
-export {
-  o as resolveAnimate,
-  u as resolveCascade,
-  s as resolveClassKey,
-  i as resolveRadiusKey
-};
+//#endregion
+export { t as resolveAnimate, e as resolveCascade, r as resolveClassKey, n as resolveRadiusKey };

package/dist/utils/stacking.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Stacking-context utilities for AsheeUI floating elements.
+ * This file provides the layering standard used by every floating component.
+ *
+ * Floating elements are portaled to `document.body`, which places them in the
+ * root stacking context, so their `z-index` competes with app-level chrome
+ * such as custom navbars. To layer correctly against both AsheeUI's own
+ * components and arbitrary client components, a floating element derives its
+ * `z-index` from the trigger's own stacking context:
+ *
+ *   floating z-index = outermost stacking context z-index of the trigger
+ *                      + the component's layer delta
+ *
+ * The delta only orders AsheeUI's internal layers relative to each other
+ * (dropdown < popover < tooltip). All elevation is carried by the derived
+ * base, so an anchored popup stays above its own container (for example a
+ * navbar) without ever outranking unrelated app chrome.
+ */
+/**
+ * Layer deltas for anchored floating elements (elements bound to a trigger).
+ * Deltas are intentionally small integers so an anchored popup can never
+ * leapfrog unrelated app chrome such as a high `z-index` navbar.
+ */
+export declare const ASHEE_LAYER: {
+    /** Select, MultiSelect, Autocomplete, and the shared SelectMenu. */
+    readonly dropdown: 10;
+    /** DatePicker and other floating panels. */
+    readonly popover: 20;
+    /** Tooltips. */
+    readonly tooltip: 30;
+};
+/**
+ * Fixed rungs for app-level overlays, which are not anchored to a trigger and
+ * should sit above page chrome.
+ */
+export declare const ASHEE_GLOBAL_LAYER: {
+    /** Modal and Drawer. */
+    readonly overlay: 1000;
+    /** Docked surfaces such as the on-screen keyboard. */
+    readonly docked: 1500;
+    /** Toasts. */
+    readonly toast: 2000;
+};
+/**
+ * Determines whether an element establishes a stacking context, using the
+ * conditions documented for CSS stacking contexts.
+ *
+ * @param element - The element to test.
+ * @param computed - Optional precomputed style for the element.
+ * @returns True when the element creates a stacking context.
+ */
+export declare function establishesStackingContext(element: Element, computed?: CSSStyleDeclaration): boolean;
+/**
+ * Resolves the `z-index` of the outermost stacking context that contains the
+ * reference element — the context that governs where the reference's subtree
+ * sits in the root stacking order.
+ *
+ * Walking outward matters: stacking contexts are atomic in their parent, so
+ * only the outermost context ancestor decides the subtree's position.
+ *
+ * @param reference - The trigger element.
+ * @returns The context's `z-index`, or 0 when the reference lives in the
+ * plain root flow.
+ */
+export declare function resolveBaseZIndex(reference: Element | null | undefined): number;
+/**
+ * Resolves the `z-index` a portaled floating element should use so it renders
+ * above its trigger's stacking context without outranking unrelated app
+ * chrome.
+ *
+ * @param reference - The trigger element.
+ * @param layerDelta - The component's layer delta from `ASHEE_LAYER`.
+ * @returns The derived `z-index`.
+ */
+export declare function resolveFloatingZIndex(reference: Element | null | undefined, layerDelta: number): number;
+//# sourceMappingURL=stacking.d.ts.map

package/dist/utils/stacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacking.d.ts","sourceRoot":"","sources":["../../src/utils/stacking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,oEAAoE;;IAEpE,4CAA4C;;IAE5C,gBAAgB;;CAER,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,wBAAwB;;IAExB,sDAAsD;;IAEtD,cAAc;;CAEN,CAAC;AAiBX;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,mBAAsD,GAC/D,OAAO,CAmCT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GACpC,MAAM,CAwBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}

package/dist/utils/stacking.js

@@ -0,0 +1,34 @@
+"use client";
+//#region src/utils/stacking.ts
+var e = {
+	dropdown: 10,
+	popover: 20,
+	tooltip: 30
+}, t = {
+	overlay: 1e3,
+	docked: 1500,
+	toast: 2e3
+};
+function n(e) {
+	if (e.parentElement) return e.parentElement;
+	let t = e.getRootNode();
+	return t instanceof ShadowRoot ? t.host : null;
+}
+function r(e, t = window.getComputedStyle(e)) {
+	return !!(t.position === "fixed" || t.position === "sticky" || (t.position === "absolute" || t.position === "relative") && t.zIndex !== "auto" || t.opacity !== "1" || t.transform !== "none" || t.filter !== "none" || t.getPropertyValue("backdrop-filter") !== "none" || t.getPropertyValue("perspective") !== "none" || t.getPropertyValue("clip-path") !== "none" || t.getPropertyValue("mix-blend-mode") !== "normal" || t.getPropertyValue("isolation") === "isolate" || /transform|opacity|filter/.test(t.getPropertyValue("will-change")) || /layout|paint|strict|content/.test(t.getPropertyValue("contain")));
+}
+function i(e) {
+	if (typeof window > "u" || !e) return 0;
+	let t = 0, i = n(e);
+	for (; i && i !== document.body && i !== document.documentElement;) {
+		let e = window.getComputedStyle(i);
+		if (r(i, e)) {
+			let n = Number.parseInt(e.zIndex, 10);
+			t = Number.isNaN(n) ? 0 : n;
+		}
+		i = n(i);
+	}
+	return Math.max(t, 0);
+}
+//#endregion
+export { t as ASHEE_GLOBAL_LAYER, e as ASHEE_LAYER, r as establishesStackingContext, i as resolveBaseZIndex };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asheeui",
-  "version": "0.6.14",
+  "version": "0.7.0",
   "description": "Accessible and customizable React primitives engineered with Tailwind CSS.",
   "author": "Ashee Softworks <asheesoftworks@gmail.com>",
   "homepage": "https://asheeui.com",
@@ -63,16 +63,17 @@
   },
   "devDependencies": {
     "@floating-ui/react": "^0.27.20",
-    "@types/node": "^26.1.2",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^4.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tsx": "^4.23.12",
-    "typescript": "^5.0.0",
-    "vite": "^6.0.0",
-    "vite-plugin-dts": "^4.0.0"
+    "@types/node": "^26.5.1",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@typescript/typescript6": "^6.0.2",
+    "@vitejs/plugin-react": "^6.1.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.0",
+    "vite-plugin-dts": "^5.1.0"
   },
   "module": "./dist/index.js",
   "license": "MIT",