@zc-ui/hooks 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ZC UI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("vue"),t=require("@zc-ui/utils");function n(n,i,a,o={}){let{capture:s=!1,passive:c=!1,immediate:l=!1}=o;if(!t.isClient)return()=>{};let u=null,d=e=>{let t={capture:s};c&&(t.passive=c),e.addEventListener(i,a,t),u=()=>e.removeEventListener(i,a,t)},f=()=>{if(!t.isClient)return;let e=r(n)?n.value:n;e&&d(e)},p=(0,e.getCurrentInstance)();return l?(f(),r(n)&&p&&(0,e.onMounted)(f)):p?(0,e.onMounted)(f):console.warn("[zc-ui] useEventListener: called outside of a component setup function without `immediate: true`. The listener will not be attached."),p&&(0,e.onBeforeUnmount)(()=>{u&&u()}),()=>{u&&u()}}function r(e){return typeof e==`object`&&!!e&&`__v_isRef`in e}function i(e,t,i={}){let{ignore:o=[],event:s=`click`}=i;n(document,s,n=>{let i=r(e)?e.value:e;if(!i)return;let s=n.composedPath?n.composedPath():[],c=n.target||s[0];if(!a(i,c)){for(let e of o)if(e&&a(e,c))return;t(n)}})}function a(e,t){return t&&`contains`in e?e.contains(t):!1}function o(n){let r=(0,e.ref)(0),i=(0,e.ref)(0);if(!t.isClient)return{width:r,height:i};let a=null,o=e=>{let t=e.getBoundingClientRect();r.value=t.width,i.value=t.height};return(0,e.onMounted)(()=>{let e=n.value;e&&(o(e),`ResizeObserver`in window&&(a=new ResizeObserver(e=>{for(let t of e){let{width:e,height:n}=t.contentRect;r.value=e,i.value=n}}),a.observe(e)))}),(0,e.onBeforeUnmount)(()=>{a&&(a.disconnect(),a=null)}),{width:r,height:i}}var s=1300,c=(0,e.ref)(s);function l(){return{currentZIndex:(0,e.computed)(()=>c.value),nextZIndex:()=>++c.value,resetZIndex:()=>{c.value=s}}}function u(){return s}var d=0;function f(e=`zc`){return{id:`${e}-${(0,t.guid)()}-${++d}`}}function p(t={}){let{returnFocusOnRelease:n=!0}=t,r=(0,e.ref)(!1),i=null,a=null,o=[`a[href]`,`button:not([disabled])`,`input:not([disabled])`,`textarea:not([disabled])`,`select:not([disabled])`,`[tabindex]:not([tabindex="-1"])`,`[contenteditable="true"]`].join(`, `);function s(){return i?Array.from(i.querySelectorAll(o)).filter(e=>e.offsetParent!==null||e.getClientRects().length>0||e===document.activeElement):[]}function c(e){if(e.key!==`Tab`||!r.value||!i)return;let t=s();if(t.length===0){e.preventDefault();return}let n=t[0],a=t[t.length-1];e.shiftKey?(document.activeElement===n||!i.contains(document.activeElement))&&(e.preventDefault(),a.focus()):(document.activeElement===a||!i.contains(document.activeElement))&&(e.preventDefault(),n.focus())}function l(t){let n=`value`in t?t.value:t;n&&(a=document.activeElement,i=n,r.value=!0,document.addEventListener(`keydown`,c),(0,e.nextTick)(()=>{let e=s();e.length>0?e[0].focus():(n.setAttribute(`tabindex`,`-1`),n.focus())}))}function u(){r.value&&(document.removeEventListener(`keydown`,c),r.value=!1,i=null,n&&a&&(a.focus(),a=null))}return(0,e.onBeforeUnmount)(()=>{u()}),{active:r,activate:l,release:u}}function m(){let t=(0,e.getCurrentInstance)();return(0,e.computed)(()=>{var e;return(e=t==null?void 0:t.appContext.config.globalProperties.$router)==null?null:e})}function h(t=!1){let n=(0,e.ref)(t);return{value:n,toggle:()=>{n.value=!n.value},set:e=>{n.value=e}}}function g(e){let t=()=>`zc-${e}`;return{b:t,e:e=>e?`${t()}__${e}`:``,m:e=>e?`${t()}--${e}`:``,em:(e,n)=>e&&n?`${t()}__${e}--${n}`:``,bm:e=>e?`${t()} ${t()}--${e}`:t(),is:(e,t=!0)=>t?`is-${e}`:``}}exports.getBaseZIndex=u,exports.useClickOutside=i,exports.useEventListener=n,exports.useFocusTrap=p,exports.useId=f,exports.useNamespace=g,exports.useOptionalRouter=m,exports.useSize=o,exports.useToggle=h,exports.useZIndex=l;

package/dist/index.mjs

@@ -0,0 +1,167 @@
+import { computed as e, getCurrentInstance as t, nextTick as n, onBeforeUnmount as r, onMounted as i, ref as a } from "vue";
+import { guid as o, isClient as s } from "@zc-ui/utils";
+//#region src/useEventListener.ts
+function c(e, n, a, o = {}) {
+	let { capture: c = !1, passive: u = !1, immediate: d = !1 } = o;
+	if (!s) return () => {};
+	let f = null, p = (e) => {
+		let t = { capture: c };
+		u && (t.passive = u), e.addEventListener(n, a, t), f = () => e.removeEventListener(n, a, t);
+	}, m = () => {
+		if (!s) return;
+		let t = l(e) ? e.value : e;
+		t && p(t);
+	}, h = t();
+	return d ? (m(), l(e) && h && i(m)) : h ? i(m) : console.warn("[zc-ui] useEventListener: called outside of a component setup function without `immediate: true`. The listener will not be attached."), h && r(() => {
+		f && f();
+	}), () => {
+		f && f();
+	};
+}
+function l(e) {
+	return typeof e == "object" && !!e && "__v_isRef" in e;
+}
+//#endregion
+//#region src/useClickOutside.ts
+function u(e, t, n = {}) {
+	let { ignore: r = [], event: i = "click" } = n;
+	c(document, i, (n) => {
+		let i = l(e) ? e.value : e;
+		if (!i) return;
+		let a = n.composedPath ? n.composedPath() : [], o = n.target || a[0];
+		if (!d(i, o)) {
+			for (let e of r) if (e && d(e, o)) return;
+			t(n);
+		}
+	});
+}
+function d(e, t) {
+	return t && "contains" in e ? e.contains(t) : !1;
+}
+//#endregion
+//#region src/useSize.ts
+function f(e) {
+	let t = a(0), n = a(0);
+	if (!s) return {
+		width: t,
+		height: n
+	};
+	let o = null, c = (e) => {
+		let r = e.getBoundingClientRect();
+		t.value = r.width, n.value = r.height;
+	};
+	return i(() => {
+		let r = e.value;
+		r && (c(r), "ResizeObserver" in window && (o = new ResizeObserver((e) => {
+			for (let r of e) {
+				let { width: e, height: i } = r.contentRect;
+				t.value = e, n.value = i;
+			}
+		}), o.observe(r)));
+	}), r(() => {
+		o && (o.disconnect(), o = null);
+	}), {
+		width: t,
+		height: n
+	};
+}
+//#endregion
+//#region src/useZIndex.ts
+var p = 1300, m = a(p);
+function h() {
+	return {
+		currentZIndex: e(() => m.value),
+		nextZIndex: () => ++m.value,
+		resetZIndex: () => {
+			m.value = p;
+		}
+	};
+}
+function g() {
+	return p;
+}
+//#endregion
+//#region src/useId.ts
+var _ = 0;
+function v(e = "zc") {
+	return { id: `${e}-${o()}-${++_}` };
+}
+//#endregion
+//#region src/useFocusTrap.ts
+function y(e = {}) {
+	let { returnFocusOnRelease: t = !0 } = e, i = a(!1), o = null, s = null, c = [
+		"a[href]",
+		"button:not([disabled])",
+		"input:not([disabled])",
+		"textarea:not([disabled])",
+		"select:not([disabled])",
+		"[tabindex]:not([tabindex=\"-1\"])",
+		"[contenteditable=\"true\"]"
+	].join(", ");
+	function l() {
+		return o ? Array.from(o.querySelectorAll(c)).filter((e) => e.offsetParent !== null || e.getClientRects().length > 0 || e === document.activeElement) : [];
+	}
+	function u(e) {
+		if (e.key !== "Tab" || !i.value || !o) return;
+		let t = l();
+		if (t.length === 0) {
+			e.preventDefault();
+			return;
+		}
+		let n = t[0], r = t[t.length - 1];
+		e.shiftKey ? (document.activeElement === n || !o.contains(document.activeElement)) && (e.preventDefault(), r.focus()) : (document.activeElement === r || !o.contains(document.activeElement)) && (e.preventDefault(), n.focus());
+	}
+	function d(e) {
+		let t = "value" in e ? e.value : e;
+		t && (s = document.activeElement, o = t, i.value = !0, document.addEventListener("keydown", u), n(() => {
+			let e = l();
+			e.length > 0 ? e[0].focus() : (t.setAttribute("tabindex", "-1"), t.focus());
+		}));
+	}
+	function f() {
+		i.value && (document.removeEventListener("keydown", u), i.value = !1, o = null, t && s && (s.focus(), s = null));
+	}
+	return r(() => {
+		f();
+	}), {
+		active: i,
+		activate: d,
+		release: f
+	};
+}
+//#endregion
+//#region src/useOptionalRouter.ts
+function b() {
+	let n = t();
+	return e(() => {
+		var e;
+		return (e = n == null ? void 0 : n.appContext.config.globalProperties.$router) == null ? null : e;
+	});
+}
+//#endregion
+//#region src/index.ts
+function x(e = !1) {
+	let t = a(e);
+	return {
+		value: t,
+		toggle: () => {
+			t.value = !t.value;
+		},
+		set: (e) => {
+			t.value = e;
+		}
+	};
+}
+function S(e) {
+	let t = () => `zc-${e}`;
+	return {
+		b: t,
+		e: (e) => e ? `${t()}__${e}` : "",
+		m: (e) => e ? `${t()}--${e}` : "",
+		em: (e, n) => e && n ? `${t()}__${e}--${n}` : "",
+		bm: (e) => e ? `${t()} ${t()}--${e}` : t(),
+		is: (e, t = !0) => t ? `is-${e}` : ""
+	};
+}
+//#endregion
+export { g as getBaseZIndex, u as useClickOutside, c as useEventListener, y as useFocusTrap, v as useId, S as useNamespace, b as useOptionalRouter, f as useSize, x as useToggle, h as useZIndex };

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+import { Ref } from 'vue';
+export { useEventListener, type EventTargetLike, type UseEventListenerOptions, } from './useEventListener';
+export { useClickOutside, type ClickOutsideOptions } from './useClickOutside';
+export { useSize, type ElementSize, type UseSizeReturn } from './useSize';
+export { useZIndex, getBaseZIndex } from './useZIndex';
+export { useId } from './useId';
+export { useFocusTrap, type FocusTrapOptions } from './useFocusTrap';
+export { useOptionalRouter } from './useOptionalRouter';
+/**
+ * useToggle - A simple boolean toggle composable.
+ *
+ * @example
+ * const { value, toggle, set } = useToggle(false)
+ * toggle() // value becomes true
+ * set(false) // value is now false
+ */
+export declare function useToggle(initialValue?: boolean): {
+    value: Ref<boolean>;
+    toggle: () => void;
+    set: (val: boolean) => void;
+};
+/**
+ * useNamespace - BEM class name generator for ZC UI components.
+ *
+ * Follows the convention: zc-{block}__{element}--{modifier}
+ *
+ * @example
+ * const ns = useNamespace('button')
+ * ns.b()              // 'zc-button'
+ * ns.e('icon')        // 'zc-button__icon'
+ * ns.m('primary')     // 'zc-button--primary'
+ * ns.em('icon','left') // 'zc-button__icon--left'
+ * ns.is('disabled')   // 'is-disabled'
+ * ns.is('loading', true) // 'is-loading'
+ */
+export declare function useNamespace(block: string): {
+    b: () => string;
+    e: (el: string) => string;
+    m: (mod: string) => string;
+    em: (el: string, mod: string) => string;
+    bm: (mod: string) => string;
+    is: (name: string, state?: boolean) => string;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAGnC,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AACzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAMvD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,YAAY,UAAQ,GAAG;IAC/C,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5B,CASA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM;;YAOzB,MAAM;aAGL,MAAM;aAGN,MAAM,OAAO,MAAM;cAGlB,MAAM;eAGL,MAAM;EAGzB"}

package/dist/types/useClickOutside.d.ts

@@ -0,0 +1,25 @@
+import { EventTargetLike } from './useEventListener';
+export type { EventTargetLike, UseEventListenerOptions } from './useEventListener';
+/**
+ * Options for useClickOutside.
+ */
+export interface ClickOutsideOptions {
+    /** Additional elements that should NOT trigger the outside-click. */
+    ignore?: Array<EventTargetLike | null | undefined>;
+    /** Event type to listen for. Default: 'click' */
+    event?: string;
+}
+/**
+ * useClickOutside - Invoke a handler when the user clicks outside
+ * the referenced element(s).
+ *
+ * @example
+ * const targetRef = ref<HTMLElement | null>(null)
+ * useClickOutside(targetRef, () => {
+ *   console.log('Clicked outside!')
+ * })
+ */
+export declare function useClickOutside(target: EventTargetLike | {
+    value: EventTargetLike | null | undefined;
+}, handler: (e: MouseEvent) => void, options?: ClickOutsideOptions): void;
+//# sourceMappingURL=useClickOutside.d.ts.map

package/dist/types/useClickOutside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../src/useClickOutside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAExF,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAElF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,MAAM,CAAC,EAAE,KAAK,CAAC,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAClD,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EACvE,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,EAChC,OAAO,GAAE,mBAAwB,GAChC,IAAI,CA0BN"}

package/dist/types/useEventListener.d.ts

@@ -0,0 +1,31 @@
+import { Ref } from 'vue';
+/**
+ * Type alias for any event target that supports addEventListener.
+ */
+export type EventTargetLike = HTMLElement | Window | Document;
+/**
+ * Options for useEventListener.
+ */
+export interface UseEventListenerOptions {
+    /** Whether to use capture phase */
+    capture?: boolean;
+    /** Whether to use passive listener */
+    passive?: boolean;
+    /** Register listener immediately (skip onMounted). Default: false */
+    immediate?: boolean;
+}
+/**
+ * useEventListener - Register an event listener on a target and
+ * automatically clean up on component unmount.
+ *
+ * Supports reactive Ref<HTMLElement | null> targets, static targets,
+ * and SSR-safe operation (no-op when window is undefined).
+ *
+ * @example
+ * useEventListener(window, 'resize', () => console.log('resized'))
+ * useEventListener(buttonRef, 'click', handler)
+ */
+export declare function useEventListener(target: EventTargetLike | Ref<EventTargetLike | null | undefined>, event: string, handler: EventListener, options?: UseEventListenerOptions): () => void;
+/** Type guard: check if value is a Vue Ref — exported for reuse by other composables */
+export declare function isRefTarget(val: unknown): val is Ref<unknown>;
+//# sourceMappingURL=useEventListener.d.ts.map

package/dist/types/useEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventListener.d.ts","sourceRoot":"","sources":["../../src/useEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,GAAG,GAAG,CAAC,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,EACjE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,uBAA4B,GACpC,MAAM,IAAI,CAoDZ;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAE7D"}

package/dist/types/useFocusTrap.d.ts

@@ -0,0 +1,24 @@
+import { Ref } from 'vue';
+export interface FocusTrapOptions {
+    /** Whether to return focus to the previously focused element on release */
+    returnFocusOnRelease?: boolean;
+}
+/**
+ * useFocusTrap — traps keyboard focus within a container element.
+ *
+ * When `active` is true, Tab/Shift+Tab cycles only through focusable elements
+ * inside the container. On release, focus is optionally restored to the element
+ * that was focused before activation.
+ *
+ * @example
+ * const trap = useFocusTrap()
+ * trap.activate(el)
+ * // later...
+ * trap.release()
+ */
+export declare function useFocusTrap(options?: FocusTrapOptions): {
+    active: Ref<boolean, boolean>;
+    activate: (el: HTMLElement | Ref<HTMLElement | undefined>) => void;
+    release: () => void;
+};
+//# sourceMappingURL=useFocusTrap.d.ts.map

package/dist/types/useFocusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/useFocusTrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAA6B,MAAM,KAAK,CAAA;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB;;mBAmDnC,WAAW,GAAG,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;;EA6CjE"}

package/dist/types/useId.d.ts

@@ -0,0 +1,13 @@
+/**
+ * useId - Generate a stable unique ID for use in the DOM.
+ * The ID is generated once at setup time and persists across re-renders,
+ * making it ideal for ARIA associations and label/input pairings.
+ *
+ * @example
+ * const { id } = useId('input')
+ * // id === 'input-xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx-0'
+ */
+export declare function useId(prefix?: string): {
+    id: string;
+};
+//# sourceMappingURL=useId.d.ts.map

package/dist/types/useId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useId.d.ts","sourceRoot":"","sources":["../../src/useId.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,MAAM,SAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAGnD"}

package/dist/types/useOptionalRouter.d.ts

@@ -0,0 +1,14 @@
+import { ComputedRef } from 'vue';
+/**
+ * useOptionalRouter - Safely access the Vue Router instance.
+ *
+ * Encapsulates the `getCurrentInstance()` pattern in a composable so
+ * individual components don't use it directly. Returns null when
+ * vue-router is not installed.
+ *
+ * @example
+ * const router = useOptionalRouter()
+ * router.value?.push('/home')
+ */
+export declare function useOptionalRouter(): ComputedRef<any | null>;
+//# sourceMappingURL=useOptionalRouter.d.ts.map

package/dist/types/useOptionalRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOptionalRouter.d.ts","sourceRoot":"","sources":["../../src/useOptionalRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,WAAW,EAAE,MAAM,KAAK,CAAA;AAEpE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC,CAG3D"}

package/dist/types/useSize.d.ts

@@ -0,0 +1,19 @@
+import { Ref } from 'vue';
+export interface ElementSize {
+    width: number;
+    height: number;
+}
+export interface UseSizeReturn {
+    width: Ref<number>;
+    height: Ref<number>;
+}
+/**
+ * useSize - Track the width and height of a DOM element reactively.
+ * Uses ResizeObserver under the hood and cleans up automatically.
+ *
+ * @example
+ * const elRef = ref<HTMLElement | null>(null)
+ * const { width, height } = useSize(elRef)
+ */
+export declare function useSize(target: Ref<HTMLElement | null | undefined>): UseSizeReturn;
+//# sourceMappingURL=useSize.d.ts.map

package/dist/types/useSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSize.d.ts","sourceRoot":"","sources":["../../src/useSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAG/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,aAAa,CA2ClF"}

package/dist/types/useZIndex.d.ts

@@ -0,0 +1,22 @@
+/**
+ * useZIndex - Manage z-index values for popup/dropdown/modal layers.
+ * Each call to `nextZIndex()` returns a monotonically increasing value,
+ * ensuring newly opened layers always appear above previously opened ones.
+ *
+ * @example
+ * const { currentZIndex, nextZIndex } = useZIndex()
+ *
+ * const dropdownStyle = computed(() => ({
+ *   zIndex: nextZIndex()
+ * }))
+ */
+export declare function useZIndex(): {
+    currentZIndex: import('vue').ComputedRef<number>;
+    nextZIndex: () => number;
+    resetZIndex: () => void;
+};
+/**
+ * Get the current base z-index constant.
+ */
+export declare function getBaseZIndex(): number;
+//# sourceMappingURL=useZIndex.d.ts.map

package/dist/types/useZIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useZIndex.d.ts","sourceRoot":"","sources":["../../src/useZIndex.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS;;sBAMA,MAAM;uBAQL,IAAI;EAS7B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@zc-ui/hooks",
+  "version": "0.0.1",
+  "description": "ZC UI Vue 3 composables / hooks",
+  "license": "MIT",
+  "author": "ZC UI Team",
+  "homepage": "https://zc-ui.github.io/zc-ui",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zc-ui/zc-ui.git",
+    "directory": "packages/hooks"
+  },
+  "bugs": {
+    "url": "https://github.com/zc-ui/zc-ui/issues"
+  },
+  "keywords": [
+    "vue",
+    "vue3",
+    "hooks",
+    "composables",
+    "zc-ui"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "dependencies": {
+    "@zc-ui/utils": "0.0.1"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json"
+  }
+}