@zc-ui/utils 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`});var e=typeof window<`u`&&typeof document<`u`;function t(e,t){return e.classList.contains(t)}function n(e,t){e.classList.add(...t.trim().split(/\s+/))}function r(e,t){e.classList.remove(...t.trim().split(/\s+/))}function i(e,t){e.classList.toggle(t)}function a(e,t,n,r){return e.addEventListener(t,n,r),()=>e.removeEventListener(t,n,r)}function o(e,t,n,r){e.removeEventListener(t,n,r)}function s(e,t,n,r){let i=a=>{n(a),e.removeEventListener(t,i,r)};return e.addEventListener(t,i,r),()=>e.removeEventListener(t,i,r)}function c(e,t=document){return t.querySelector(e)}function l(e,t=document){return Array.from(t.querySelectorAll(e))}function u(e,t){return e.matches(t)}function d(e,t){return e.closest(t)}function f(e,t){return e.contains(t)}function p(e,t){let n=e;return n.install=r=>{let i=t||e.name;i&&r.component(i,n)},n}function m(e){return{install(t){for(let[n,r]of Object.entries(e))t.component(n,r)}}}function h(e,t=2){return e.toFixed(t)}function g(e,t=2){return String(e).padStart(t,`0`)}function _(e){return e!=null}function v(e){return typeof e==`string`}function y(e){return typeof e==`number`&&!isNaN(e)}function b(e){return typeof e==`boolean`}function x(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function S(e){return typeof e==`function`}function C(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function w(){var t;return e&&(t=crypto)!=null&&t.randomUUID?crypto.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e===`x`?t:t&3|8).toString(16)})}function T(e=`zc`){return`${e}-${Math.random().toString(36).slice(2,9)}`}function E(e,t,n){return Math.min(Math.max(e,t),n)}function D(e){return e==null?!0:v(e)||Array.isArray(e)?e.length===0:x(e)?Object.keys(e).length===0:!1}function O(...e){let t={};for(let n of e)if(n)for(let e of Object.keys(n)){let r=n[e],i=t[e];Array.isArray(r)?t[e]=[...r]:x(r)?t[e]=x(i)?O(i,r):{...r}:t[e]=r}return t}exports.addClass=n,exports.clamp=E,exports.closest=d,exports.contains=f,exports.deepMerge=O,exports.getType=C,exports.guid=w,exports.hasClass=t,exports.isBoolean=b,exports.isClient=e,exports.isDefined=_,exports.isEmpty=D,exports.isFunction=S,exports.isNumber=y,exports.isObject=x,exports.isString=v,exports.matches=u,exports.off=o,exports.on=a,exports.once=s,exports.padZero=g,exports.querySelector=c,exports.querySelectorAll=l,exports.removeClass=r,exports.toFixed=h,exports.toggleClass=i,exports.uniqueId=T,exports.withInstall=p,exports.withInstallAll=m;

package/dist/index.mjs

@@ -0,0 +1,112 @@
+//#region src/dom.ts
+var e = typeof window < "u" && typeof document < "u";
+function t(e, t) {
+	return e.classList.contains(t);
+}
+function n(e, t) {
+	e.classList.add(...t.trim().split(/\s+/));
+}
+function r(e, t) {
+	e.classList.remove(...t.trim().split(/\s+/));
+}
+function i(e, t) {
+	e.classList.toggle(t);
+}
+function a(e, t, n, r) {
+	return e.addEventListener(t, n, r), () => e.removeEventListener(t, n, r);
+}
+function o(e, t, n, r) {
+	e.removeEventListener(t, n, r);
+}
+function s(e, t, n, r) {
+	let i = (a) => {
+		n(a), e.removeEventListener(t, i, r);
+	};
+	return e.addEventListener(t, i, r), () => e.removeEventListener(t, i, r);
+}
+function c(e, t = document) {
+	return t.querySelector(e);
+}
+function l(e, t = document) {
+	return Array.from(t.querySelectorAll(e));
+}
+function u(e, t) {
+	return e.matches(t);
+}
+function d(e, t) {
+	return e.closest(t);
+}
+function f(e, t) {
+	return e.contains(t);
+}
+//#endregion
+//#region src/install.ts
+function p(e, t) {
+	let n = e;
+	return n.install = (r) => {
+		let i = t || e.name;
+		i && r.component(i, n);
+	}, n;
+}
+function m(e) {
+	return { install(t) {
+		for (let [n, r] of Object.entries(e)) t.component(n, r);
+	} };
+}
+//#endregion
+//#region src/format.ts
+function h(e, t = 2) {
+	return e.toFixed(t);
+}
+function g(e, t = 2) {
+	return String(e).padStart(t, "0");
+}
+//#endregion
+//#region src/index.ts
+function _(e) {
+	return e != null;
+}
+function v(e) {
+	return typeof e == "string";
+}
+function y(e) {
+	return typeof e == "number" && !isNaN(e);
+}
+function b(e) {
+	return typeof e == "boolean";
+}
+function x(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function S(e) {
+	return typeof e == "function";
+}
+function C(e) {
+	return e === null ? "null" : Array.isArray(e) ? "array" : typeof e;
+}
+function w() {
+	var t;
+	return e && (t = crypto) != null && t.randomUUID ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {
+		let t = Math.random() * 16 | 0;
+		return (e === "x" ? t : t & 3 | 8).toString(16);
+	});
+}
+function T(e = "zc") {
+	return `${e}-${Math.random().toString(36).slice(2, 9)}`;
+}
+function E(e, t, n) {
+	return Math.min(Math.max(e, t), n);
+}
+function D(e) {
+	return e == null ? !0 : v(e) || Array.isArray(e) ? e.length === 0 : x(e) ? Object.keys(e).length === 0 : !1;
+}
+function O(...e) {
+	let t = {};
+	for (let n of e) if (n) for (let e of Object.keys(n)) {
+		let r = n[e], i = t[e];
+		Array.isArray(r) ? t[e] = [...r] : x(r) ? t[e] = x(i) ? O(i, r) : { ...r } : t[e] = r;
+	}
+	return t;
+}
+//#endregion
+export { n as addClass, E as clamp, d as closest, f as contains, O as deepMerge, C as getType, w as guid, t as hasClass, b as isBoolean, e as isClient, _ as isDefined, D as isEmpty, S as isFunction, y as isNumber, x as isObject, v as isString, u as matches, o as off, a as on, s as once, g as padZero, c as querySelector, l as querySelectorAll, r as removeClass, h as toFixed, i as toggleClass, T as uniqueId, p as withInstall, m as withInstallAll };

package/dist/types/dom.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DOM utility functions
+ */
+/**
+ * Check if running in a browser environment.
+ * Both `window` and `document` must be available to avoid false positives
+ * in environments like Electron renderer without DOM access.
+ */
+export declare const isClient: boolean;
+/**
+ * Check if element has a CSS class.
+ */
+export declare function hasClass(el: HTMLElement, cls: string): boolean;
+/**
+ * Add a CSS class (or multiple space-separated classes) to element.
+ */
+export declare function addClass(el: HTMLElement, cls: string): void;
+/**
+ * Remove a CSS class (or multiple space-separated classes) from element.
+ */
+export declare function removeClass(el: HTMLElement, cls: string): void;
+/**
+ * Toggle a CSS class on element.
+ */
+export declare function toggleClass(el: HTMLElement, cls: string): void;
+/**
+ * Type alias for an event target that supports addEventListener.
+ */
+export type EventTargetLike = HTMLElement | Window | Document;
+/**
+ * Listener options that can be boolean or AddEventListenerOptions.
+ */
+export type ListenerOptions = boolean | AddEventListenerOptions;
+/**
+ * Add an event listener with optional options.
+ * Returns a cleanup function that removes the listener.
+ *
+ * @example
+ * const off = on(document, 'click', handler)
+ * off() // remove listener
+ */
+export declare function on(target: EventTargetLike, event: string, handler: EventListenerOrEventListenerObject, options?: ListenerOptions): () => void;
+/**
+ * Remove an event listener.
+ */
+export declare function off(target: EventTargetLike, event: string, handler: EventListenerOrEventListenerObject, options?: ListenerOptions): void;
+/**
+ * Add a one-time event listener that auto-removes after first trigger.
+ *
+ * @example
+ * once(element, 'transitionend', handler)
+ */
+export declare function once(target: EventTargetLike, event: string, handler: EventListener, options?: ListenerOptions): () => void;
+/**
+ * Query a single element by selector (shorthand for querySelector).
+ */
+export declare function querySelector<T extends HTMLElement = HTMLElement>(selector: string, parent?: ParentNode): T | null;
+/**
+ * Query all matching elements by selector.
+ */
+export declare function querySelectorAll<T extends HTMLElement = HTMLElement>(selector: string, parent?: ParentNode): T[];
+/**
+ * Check if an element matches a CSS selector.
+ */
+export declare function matches(el: HTMLElement, selector: string): boolean;
+/**
+ * Get the closest ancestor matching a selector, or null.
+ */
+export declare function closest(el: HTMLElement, selector: string): HTMLElement | null;
+/**
+ * Check if an element contains another element (or is the same).
+ */
+export declare function contains(parent: Node, child: Node): boolean;
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SAAmE,CAAA;AAExF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9D;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,uBAAuB,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAChB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kCAAkC,EAC3C,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,IAAI,CAGZ;AAED;;GAEG;AACH,wBAAgB,GAAG,CACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kCAAkC,EAC3C,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAClB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,IAAI,CAOZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,UAAqB,GAC5B,CAAC,GAAG,IAAI,CAEV;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAClE,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,UAAqB,GAC5B,CAAC,EAAE,CAEL;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAE3D"}

package/dist/types/format.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Formatting utility functions
+ */
+/**
+ * Format a number to a fixed number of decimal places
+ */
+export declare function toFixed(val: number, decimals?: number): string;
+/**
+ * Pad a number with leading zeros
+ */
+export declare function padZero(val: number | string, length?: number): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAEhE"}

package/dist/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Check if value is defined (not null and not undefined).
+ */
+export declare function isDefined<T>(val: T | undefined | null): val is T;
+/**
+ * Check if value is a string.
+ */
+export declare function isString(val: unknown): val is string;
+/**
+ * Check if value is a number.
+ */
+export declare function isNumber(val: unknown): val is number;
+/**
+ * Check if value is a boolean.
+ */
+export declare function isBoolean(val: unknown): val is boolean;
+/**
+ * Check if value is an object (not null, not array).
+ */
+export declare function isObject(val: unknown): val is Record<string, unknown>;
+/**
+ * Check if value is a function.
+ */
+export declare function isFunction(val: unknown): val is (...args: unknown[]) => unknown;
+/**
+ * Get the runtime type of a value as a lowercase string.
+ * Returns precise type names: 'null', 'array', 'date', 'regexp', 'promise', etc.
+ *
+ * @example
+ * getType(null)       // 'null'
+ * getType([])         // 'array'
+ * getType(new Date()) // 'date'
+ * getType(123)        // 'number'
+ */
+export declare function getType(val: unknown): string;
+/**
+ * Generate a RFC-4122 v4 compliant unique ID (GUID).
+ * Falls back to a Math.random-based ID in non-crypto environments.
+ *
+ * @example
+ * guid() // 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
+ */
+export declare function guid(): string;
+/**
+ * Generate a short unique ID with optional prefix.
+ * Suitable for DOM element IDs and internal references.
+ *
+ * @example
+ * uniqueId()       // 'zc-j3kf9x2'
+ * uniqueId('el')   // 'el-j3kf9x2'
+ */
+export declare function uniqueId(prefix?: string): string;
+/**
+ * Clamp a number between min and max.
+ */
+export declare function clamp(val: number, min: number, max: number): number;
+/**
+ * Check if value is an empty string, null, undefined, empty array, or empty object.
+ */
+export declare function isEmpty(val: unknown): boolean;
+/**
+ * Deep-merge two or more objects. Later sources take precedence.
+ */
+export declare function deepMerge(...sources: Array<Record<string, unknown> | undefined | null>): Record<string, unknown>;
+export * from './dom';
+export * from './install';
+export * from './format';
+//# 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":"AASA;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,GAAG,IAAI,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAE/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAI5C;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAU7B;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAO,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GAC5D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAGD,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/dist/types/install.d.ts

@@ -0,0 +1,28 @@
+import { Plugin, Component } from 'vue';
+/**
+ * Augment a Vue component with an `install` method so it can be registered
+ * via `app.use(Component)` or used individually with tree-shaking.
+ *
+ * The returned component is typed as the original component intersected with
+ * `Plugin`, ensuring both the component itself and the `install` method are
+ * accessible.
+ *
+ * @example
+ * import Button from './button.vue'
+ * export const ZcButton = withInstall(Button, 'ZcButton')
+ *
+ * // In app entry:
+ * app.use(ZcButton) // registers <ZcButton> globally
+ *
+ * // Or import individually:
+ * import { ZcButton } from '@zc-ui/components'
+ */
+export declare function withInstall<T extends Component>(component: T, name?: string): T & Plugin;
+/**
+ * Create a single plugin that installs multiple components at once.
+ *
+ * @example
+ * export default withInstallAll({ ZcButton, ZcInput })
+ */
+export declare function withInstallAll(components: Record<string, Component & Plugin>): Plugin;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,MAAM,CAWxF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG,MAAM,CAQrF"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@zc-ui/utils",
+  "version": "0.0.1",
+  "description": "ZC UI common utilities",
+  "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/utils"
+  },
+  "bugs": {
+    "url": "https://github.com/zc-ui/zc-ui/issues"
+  },
+  "keywords": [
+    "vue",
+    "ui",
+    "utils",
+    "utilities",
+    "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"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "vue": "^3.4.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json"
+  }
+}