asheeui 0.6.15 → 1.0.0

package/dist/theme/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/theme/controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAa/C;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,YAAY,EAAE,cAAc,CAAC;IAE7B;;;;OAIG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,cAAM,eAAe;IACnB;;;OAGG;IACH,OAAO,CAAC,SAAS,CAA2B;IAE5C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA2B;IAE/C;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAyB;IAEhD;;OAEG;IACH,OAAO,CAAC,SAAS,CAAuB;IAExC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA+B;;IASjD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,IAAI;IAkC3D;;;;;;OAMG;IACH,UAAU,UAAW,cAAc,KAAG,IAAI,CAExC;IAEF;;;OAGG;IACH,YAAY,QAAO,cAAc,CAAmB;IAEpD;;;;;OAKG;IACH,gBAAgB,QAAO,SAAS,CAAkB;IAElD;;;;OAIG;IACH,QAAQ,cAAe,cAAc,KAAG,IAAI,CAS1C;IAEF;;;;;OAKG;IACH,SAAS,aAAc,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAG5C;IAEF;;;OAGG;IACH,kBAAkB,QAAO,SAAS,MAAM,EAAE,CAAyB;IAEnE;;;;;OAKG;IACH,WAAW,QAAO,IAAI,CAWpB;IAEF;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAMxB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;IAOf;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAKf;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CA+BvB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/theme/controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAa/C;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,YAAY,EAAE,cAAc,CAAC;IAE7B;;;;OAIG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,cAAM,eAAe;IACnB;;;OAGG;IACH,OAAO,CAAC,SAAS,CAA2B;IAE5C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA2B;IAE/C;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAyB;IAEhD;;OAEG;IACH,OAAO,CAAC,SAAS,CAAuB;IAExC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA+B;;IASjD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,IAAI;IAkC3D;;;;;;OAMG;IACH,UAAU,GAAI,OAAO,cAAc,KAAG,IAAI,CAExC;IAEF;;;OAGG;IACH,YAAY,QAAO,cAAc,CAAmB;IAEpD;;;;;OAKG;IACH,gBAAgB,QAAO,SAAS,CAAkB;IAElD;;;;OAIG;IACH,QAAQ,GAAI,WAAW,cAAc,KAAG,IAAI,CAS1C;IAEF;;;;;OAKG;IACH,SAAS,GAAI,UAAU,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAG5C;IAEF;;;OAGG;IACH,kBAAkB,QAAO,SAAS,MAAM,EAAE,CAAyB;IAEnE;;;;;OAKG;IACH,WAAW,QAAO,IAAI,CAWpB;IAEF;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAMxB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;IAOf;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAKf;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CA+BvB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/theme/controller.js

@@ -1,179 +1,66 @@
 "use client";
-var r = Object.defineProperty;
-var d = (n, e, t) => e in n ? r(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var s = (n, e, t) => d(n, typeof e != "symbol" ? e + "" : e, t);
-const o = "ashee-theme", c = "(prefers-color-scheme: dark)", h = "theme-";
-class m {
-  constructor() {
-    /**
-     * The user's selected theme preference, which may be "system"
-     * or a specific theme name.
-     */
-    s(this, "selection", "light");
-    /**
-     * The final resolved theme name after applying the selection
-     * and resolving "system" to either "light" or "dark".
-     */
-    s(this, "resolved", "light");
-    /**
-     * The default theme configured when the controller was initialized.
-     * Used as a fallback when the stored preference is invalid.
-     */
-    s(this, "defaultTheme", "light");
-    /**
-     * The list of available themes in the application.
-     * Used for validation and cycling through themes.
-     */
-    s(this, "availableThemes", []);
-    /**
-     * Set of listener functions that are called when the theme changes.
-     */
-    s(this, "listeners", /* @__PURE__ */ new Set());
-    /**
-     * MediaQueryList for detecting system dark mode preference.
-     * Null when running in a non-browser environment.
-     */
-    s(this, "mediaQuery", null);
-    /**
-     * Seeds the default theme. Kept for backward compatibility - prefer
-     * `configure()`, which also validates the stored selection against the
-     * available theme map.
-     *
-     * @deprecated Use `configure()` instead for complete initialization.
-     */
-    s(this, "setDefault", (e) => {
-      this.configure({ defaultTheme: e, themes: this.availableThemes });
-    });
-    /**
-     * Returns the current theme selection.
-     * @returns The current selected theme, which may be "system" or a specific theme name.
-     */
-    s(this, "getSelection", () => this.selection);
-    /**
-     * Returns the resolved theme name after applying the selection.
-     * If the selection is "system", this will resolve to either "light" or "dark"
-     * based on the system preference.
-     * @returns The resolved theme name.
-     */
-    s(this, "getResolvedTheme", () => this.resolved);
-    /**
-     * Sets the theme selection and persists it to localStorage.
-     * The provided selection is validated and sanitized before applying.
-     * @param selection - The theme to select, either "system" or a theme name.
-     */
-    s(this, "setTheme", (e) => {
-      const t = this.sanitize(e);
-      this.selection = t, typeof window < "u" && window.localStorage.setItem(o, t), this.applySelection(), this.listeners.forEach((i) => {
-        i();
-      });
-    });
-    /**
-     * Subscribes a listener to theme changes.
-     * The listener will be called whenever the theme selection or resolved theme changes.
-     * @param listener - The function to call when the theme changes.
-     * @returns An unsubscribe function that removes the listener.
-     */
-    s(this, "subscribe", (e) => (this.listeners.add(e), () => this.listeners.delete(e)));
-    /**
-     * Returns the list of available theme names.
-     * @returns The list of available themes configured in the controller.
-     */
-    s(this, "getAvailableThemes", () => this.availableThemes);
-    /**
-     * Cycles to the next theme in sequence (including "system" mode by default).
-     * Loops back to the start when reaching the end of the available themes list.
-     * The "system" option is not included in the toggle sequence; only specific
-     * theme names are cycled through.
-     */
-    s(this, "toggleTheme", () => {
-      const e = Array.from(new Set(this.availableThemes)).filter(
-        (l) => l !== "system"
-      ), t = e.indexOf(this.selection), i = t === -1 ? 0 : (t + 1) % e.length;
-      this.setTheme(e[i]);
-    });
-    /**
-     * Handles system dark mode preference changes.
-     * Only re-applies the theme if the current selection is "system",
-     * ensuring the resolved theme stays in sync with system changes.
-     */
-    s(this, "handleSystemChange", () => {
-      this.selection === "system" && (this.applySelection(), this.listeners.forEach((e) => {
-        e();
-      }));
-    });
-    typeof window > "u" || (this.mediaQuery = window.matchMedia(c), this.mediaQuery.addEventListener("change", this.handleSystemChange));
-  }
-  /**
-   * Seeds the controller with the resolved theme config and applies the theme.
-   *
-   * - Uses `localStorage["ashee-theme"]` when it holds a valid selection.
-   * - Falls back to `config.theme.defaultTheme` on first visit.
-   * - Clears stale/invalid values from storage.
-   * - Never writes to storage (only `setTheme` persists user intent).
-   */
-  configure({ defaultTheme: e, themes: t }) {
-    if (this.defaultTheme = e, this.availableThemes = t, typeof window > "u") {
-      console.log(
-        "[Theme] Running in non-browser environment, skipping localStorage operations."
-      );
-      return;
-    }
-    const i = window.localStorage.getItem(o), l = i !== null && this.isValid(i);
-    l || i !== null && (console.log(
-      "[Theme] Invalid stored theme, removing from localStorage."
-    ), window.localStorage.removeItem(o)), this.selection = l ? i : e, this.applySelection(), this.listeners.forEach((a) => {
-      a();
-    });
-  }
-  /**
-   * Validates a theme selection and returns a valid fallback if necessary.
-   * @param selection - The theme selection to sanitize.
-   * @returns A valid theme selection, falling back to the default theme
-   *          if the provided selection is invalid.
-   */
-  sanitize(e) {
-    return this.isValid(e) ? e : this.defaultTheme;
-  }
-  /**
-   * Checks whether a theme selection is valid.
-   * "system" is always valid. Other theme names are valid if they exist
-   * in the available themes list. If no available themes are configured,
-   * any selection is considered valid.
-   * @param selection - The theme selection to validate.
-   * @returns True if the selection is valid, false otherwise.
-   */
-  isValid(e) {
-    return e === "system" ? !0 : this.availableThemes.length > 0 ? this.availableThemes.includes(e) : !0;
-  }
-  /**
-   * Resolves a theme selection to an actual theme name.
-   * If the selection is "system", resolves based on the system preference.
-   * @param selection - The theme selection to resolve.
-   * @returns The resolved theme name.
-   */
-  resolve(e) {
-    var t;
-    return e !== "system" ? e : (t = this.mediaQuery) != null && t.matches ? "dark" : "light";
-  }
-  /**
-   * Applies the current theme selection by updating the DOM.
-   * This method sanitizes the selection, resolves it to a theme name,
-   * and applies the appropriate CSS class to the document root.
-   * It ensures that only valid theme classes are applied and removes
-   * any previously applied theme classes.
-   */
-  applySelection() {
-    const e = this.sanitize(this.selection);
-    let t = this.resolve(e);
-    if (this.availableThemes.length > 0 && !this.availableThemes.includes(t) && (t = this.availableThemes.includes(this.defaultTheme) ? this.defaultTheme : this.availableThemes[0]), this.resolved = t, typeof document > "u") return;
-    const i = document.documentElement, l = `${h}${t}`;
-    for (const a of Array.from(i.classList))
-      a.startsWith(h) && i.classList.remove(a);
-    i.classList.add(l);
-  }
-}
-const f = new m();
-export {
-  o as THEME_STORAGE_KEY,
-  f as themeController
-};
+//#region src/theme/controller.ts
+var e = "ashee-theme", t = "theme-", n = new class {
+	selection = "light";
+	resolved = "light";
+	defaultTheme = "light";
+	availableThemes = [];
+	listeners = /* @__PURE__ */ new Set();
+	mediaQuery = null;
+	constructor() {
+		typeof window > "u" || (this.mediaQuery = window.matchMedia("(prefers-color-scheme: dark)"), this.mediaQuery.addEventListener("change", this.handleSystemChange));
+	}
+	configure({ defaultTheme: t, themes: n }) {
+		if (this.defaultTheme = t, this.availableThemes = n, typeof window > "u") {
+			console.log("[Theme] Running in non-browser environment, skipping localStorage operations.");
+			return;
+		}
+		let r = window.localStorage.getItem(e), i = r !== null && this.isValid(r);
+		i || r !== null && (console.log("[Theme] Invalid stored theme, removing from localStorage."), window.localStorage.removeItem(e)), this.selection = i ? r : t, this.applySelection(), this.listeners.forEach((e) => {
+			e();
+		});
+	}
+	setDefault = (e) => {
+		this.configure({
+			defaultTheme: e,
+			themes: this.availableThemes
+		});
+	};
+	getSelection = () => this.selection;
+	getResolvedTheme = () => this.resolved;
+	setTheme = (t) => {
+		let n = this.sanitize(t);
+		this.selection = n, typeof window < "u" && window.localStorage.setItem(e, n), this.applySelection(), this.listeners.forEach((e) => {
+			e();
+		});
+	};
+	subscribe = (e) => (this.listeners.add(e), () => this.listeners.delete(e));
+	getAvailableThemes = () => this.availableThemes;
+	toggleTheme = () => {
+		let e = Array.from(new Set(this.availableThemes)).filter((e) => e !== "system"), t = e.indexOf(this.selection), n = t === -1 ? 0 : (t + 1) % e.length;
+		this.setTheme(e[n]);
+	};
+	handleSystemChange = () => {
+		this.selection === "system" && (this.applySelection(), this.listeners.forEach((e) => {
+			e();
+		}));
+	};
+	sanitize(e) {
+		return this.isValid(e) ? e : this.defaultTheme;
+	}
+	isValid(e) {
+		return e === "system" ? !0 : this.availableThemes.length > 0 ? this.availableThemes.includes(e) : !0;
+	}
+	resolve(e) {
+		return e === "system" ? this.mediaQuery?.matches ? "dark" : "light" : e;
+	}
+	applySelection() {
+		let e = this.sanitize(this.selection), n = this.resolve(e);
+		if (this.availableThemes.length > 0 && !this.availableThemes.includes(n) && (n = this.availableThemes.includes(this.defaultTheme) ? this.defaultTheme : this.availableThemes[0]), this.resolved = n, typeof document > "u") return;
+		let r = document.documentElement, i = `${t}${n}`;
+		for (let e of Array.from(r.classList)) e.startsWith(t) && r.classList.remove(e);
+		r.classList.add(i);
+	}
+}();
+//#endregion
+export { e as THEME_STORAGE_KEY, n as themeController };

package/dist/theme/useTheme.js

@@ -1,47 +1,16 @@
 "use client";
-import { useSyncExternalStore as t } from "react";
+"use client";
 import { themeController as e } from "./controller.js";
-function r() {
-  const o = t(
-    e.subscribe,
-    e.getSelection,
-    () => "light"
-  ), l = t(
-    e.subscribe,
-    e.getResolvedTheme,
-    () => "light"
-  );
-  return {
-    /**
-     * The user's current theme selection.
-     * This can be either a specific theme name or "system".
-     */
-    theme: o,
-    /**
-     * The resolved theme name after applying the selection.
-     * If the selection is "system", this resolves to either "light" or "dark"
-     * based on the system preference.
-     */
-    resolvedTheme: l,
-    /**
-     * Function to set the theme selection.
-     * This persists the selection to localStorage and applies the theme.
-     * @param selection - The theme to select, either "system" or a theme name.
-     */
-    setTheme: e.setTheme,
-    /**
-     * Function to cycle to the next available theme.
-     * This cycles through all available theme names, excluding "system".
-     * Loops back to the start when reaching the end of the list.
-     */
-    toggleTheme: e.toggleTheme,
-    /**
-     * The list of available theme names in the application.
-     * This does not include "system" as it is not a theme name.
-     */
-    availableThemes: e.getAvailableThemes()
-  };
+import { useSyncExternalStore as t } from "react";
+//#region src/theme/useTheme.ts
+function n() {
+	return {
+		theme: t(e.subscribe, e.getSelection, () => "light"),
+		resolvedTheme: t(e.subscribe, e.getResolvedTheme, () => "light"),
+		setTheme: e.setTheme,
+		toggleTheme: e.toggleTheme,
+		availableThemes: e.getAvailableThemes()
+	};
 }
-export {
-  r as useTheme
-};
+//#endregion
+export { n as useTheme };

package/dist/utils/cn.js

@@ -1,9 +1,9 @@
 "use client";
-import { clsx as t } from "clsx";
-import { twMerge as e } from "tailwind-merge";
-function c(...r) {
-  return e(t(r));
+import { clsx as e } from "clsx";
+import { twMerge as t } from "tailwind-merge";
+//#region src/utils/cn.ts
+function n(...n) {
+	return t(e(n));
 }
-export {
-  c as cn
-};
+//#endregion
+export { n as cn };

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { cn } from './cn';
 export { mergeObject } from './merge-object';
+export { ASHEE_GLOBAL_LAYER, ASHEE_LAYER, establishesStackingContext, resolveBaseZIndex, resolveFloatingZIndex, } from './stacking';
 export type { DeepPartial } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/utils/index.js

@@ -1,3 +1,4 @@
 export * from "./cn.js";
 export * from "./merge-object.js";
 export * from "./resolve-token.js";
+export * from "./stacking.js";

package/dist/utils/merge-object.js

@@ -1,17 +1,16 @@
 "use client";
-function u(e) {
-  return typeof e == "object" && e !== null && !Array.isArray(e);
+//#region src/utils/merge-object.ts
+function e(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function l(e, n) {
-  if (!n)
-    return e;
-  const o = { ...e }, s = e, i = n;
-  for (const t of Object.keys(n)) {
-    const c = i[t], r = s[t];
-    c !== void 0 && (u(r) && u(c) ? o[t] = l(r, c) : o[t] = c);
-  }
-  return o;
+function t(n, r) {
+	if (!r) return n;
+	let i = { ...n }, a = n, o = r;
+	for (let n of Object.keys(r)) {
+		let r = o[n], s = a[n];
+		r !== void 0 && (i[n] = e(s) && e(r) ? t(s, r) : r);
+	}
+	return i;
 }
-export {
-  l as mergeObject
-};
+//#endregion
+export { t as mergeObject };

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: {
+    /** Dropmenu, MultiSelect, Autocomplete, and the shared Menu. */
+    readonly dropdown: 10;
+    /** Calendar 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,gEAAgE;;IAEhE,0CAA0C;;IAE1C,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.15",
+  "version": "1.0.0",
   "description": "Accessible and customizable React primitives engineered with Tailwind CSS.",
   "author": "Ashee Softworks <asheesoftworks@gmail.com>",
   "homepage": "https://asheeui.com",
@@ -49,7 +49,8 @@
     "dist"
   ],
   "sideEffects": [
-    "*.css"
+    "*.css",
+    "**/*-config*"
   ],
   "dependencies": {
     "@floating-ui/react": "^0.27.20",
@@ -63,21 +64,28 @@
   },
   "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"
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@types/node": "^26.5.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@typescript/typescript6": "^6.0.2",
+    "@vitejs/plugin-react": "^6.1.1",
+    "jsdom": "^30.0.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",
+    "vitest": "^5.0.0"
   },
   "module": "./dist/index.js",
   "license": "MIT",
   "scripts": {
-    "build:registry": "tsx src/scripts/build-registry.ts",
-    "build": "vite build"
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }

package/dist/components/date-picker/Calendar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/Calendar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD,UAAU,aAAa;IACrB;;;OAGG;IACH,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,eAAe,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IACtC;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,qDA0QnB,CAAC"}