# sculp-js > Typescript utils function library for modern javascript Latest version **1.20.0** (published 2026-09-20) · MIT license · 0 weekly downloads ## Install ```sh npm install sculp-js pnpm add sculp-js yarn add sculp-js bun add sculp-js ``` ## Health **Score 75/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.20.0 | | Published | 2026-09-20 | | First published | 2023-10-15 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 390.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 2 | | Author | chandq | | Maintainers | deqiaochen | | Keywords | sculp, sculp-js, modules, es6, util, typescript utils, javascript utils | ## Links - npm: https://www.npmjs.com/package/sculp-js - Repository: https://github.com/chandq/sculp-js - Homepage: https://chandq.github.io/sculp-js/ - Issues: https://github.com/chandq/sculp-js/issues - npm.io page: https://npm.io/package/sculp-js ## Alternatives - [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads - [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads - [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads - [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads - [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads ## Recent versions - 1.20.0 (latest) — 2026-09-20 - 1.13.3-beta.0 (beta) — 2025-10-11 - 1.11.1-alpha.3 (alpha) — 2025-07-19 - 1.19.14 — 2026-07-14 - 1.19.13 — 2026-06-22 - 1.19.12 — 2026-06-20 - 1.19.6 — 2026-04-09 - 1.19.5 — 2026-04-09 - 1.19.4 — 2026-04-08 - 1.19.3 — 2026-04-06 - 1.19.2 — 2026-04-06 - 1.19.1 — 2026-03-23 - 1.19.0 — 2026-03-21 - 1.18.3 — 2026-03-16 - 1.18.2 — 2026-03-14 - … 51 more at https://npm.io/package/sculp-js/versions ## README
# sculp-js **A Modern JavaScript Utility Library for Web** [![Node.js CI](https://github.com/chandq/sculp-js/actions/workflows/release.yml/badge.svg)](https://github.com/chandq/sculp-js/actions/workflows/release.yml) [![sculp-js](https://img.shields.io/github/package-json/v/chandq/sculp-js?style=flat-square)](https://www.npmjs.com/package/sculp-js) [![license:MIT](https://img.shields.io/npm/l/vue.svg?sanitize=true)](https://github.com/chandq/sculp-js/blob/main/LICENSE) [![codecov](https://codecov.io/gh/chandq/sculp-js/graph/badge.svg?token=VZ6TERPGI9)](https://codecov.io/gh/chandq/sculp-js)

> A lightweight utility library written in TypeScript with zero dependencies, supporting ESM, CJS, and UMD formats. **[API Documentation](https://chandq.github.io/sculp-js/)** • **[Getting Started](#usage)** • **[Features](#features)** ## ✨ Features - **Type-Safe**: Full TypeScript support with comprehensive type definitions - **Zero Dependencies**: Pure native implementation, no external libraries - **Tree Shaking**: Supports selective imports for smaller bundle sizes - **Multi-Format**: ESM, CJS, and UMD builds available - **Web Focused**: Optimized for modern web environments ### Core Utilities
Type Checking - `isString`, `isNumber`, `isBoolean`, `isFunction`, `isObject`, `isArray` - `isDate`, `isRegExp`, `isUndefined`, `isNull`, `isError`, `isNaN` - `isPrimitive`, `isSymbol`, `isBigInt`, `isPlainObject` - `isEmpty`, `isNodeList`, `isValidDate`, `typeIs`
Data Structures - **Array**: `arrayEach`, `arrayEachAsync`, `arrayInsertBefore`, `arrayRemove` - **Tree**: `forEachDeep`, `mapDeep`, `findDeep`, `filterDeep`, `getPathById`, `flatTree`, `fuzzySearchTree` - **Object**: `objectAssign`, `objectGet`, `objectHas`, `cloneDeep`, `objectPick`, `objectOmit`
Web APIs - **DOM**: `addClass`, `hasClass`, `removeClass`, `getStyle`, `setStyle` - **File**: `chooseLocalFile`, `compressImg` - **Clipboard**: `copyText`, `fallbackCopyText` - **Download**: `downloadBlob`, `downloadURL`, `downloadData` - **Watermark**: `genCanvasWM`
Encoding & Validation - **Encode/Decode**: `weBtoa`, `weAtob`, `b64encode`, `b64decode` - **Validation**: `isEmail`, `isPhone`, `isUrl`, `isIDNO`, `isIPv4`, `isIPv6`
Additional Utils - **Date**: `formatDate`, `calculateDate`, `dateToStart`, `dateToEnd` - **String**: `stringCamelCase`, `stringKebabCase`, `parseQueryParams`, `stringEscapeHTML` - **Math**: `add`, `subtract`, `multiply`, `divide`, `numberAbbr` - **Functional**: `debounce`, `throttle`, `once`, `wait`
## 🚀 Installation ### npm ```bash npm install sculp-js ``` ### CDN ```html ``` ## 💡 Usage ```js import { forEachDeep, cloneDeep } from 'sculp-js'; // Deep traversal of tree structures const tree = [ { id: 1, name: 'Parent 1', children: [ { id: 11, name: 'Child 1' }, { id: 12, name: 'Child 2', children: [{ id: 121, name: 'Grandchild 1' }] } ] }, { id: 2, name: 'Parent 2' } ]; const names = []; forEachDeep(tree, item => { names.push(item.name); }); // names = ['Parent 1', 'Child 1', 'Child 2', 'Grandchild 1', 'Parent 2'] // Deep cloning of objects const original = { a: 1, b: { c: 2 } }; const cloned = cloneDeep(original); ``` ## 📦 Module Formats ### Named Imports (Recommended) ```js // ES Modules - Named imports (tree-shaking friendly) import { cloneDeep, forEachDeep } from 'sculp-js'; // CommonJS - Named imports const { cloneDeep, forEachDeep } = require('sculp-js'); ``` ### Default Import (Full Library) ```js // ES Modules - Default import import sculp from 'sculp-js'; const { cloneDeep, forEachDeep } = sculp; // CommonJS - Default import const sculp = require('sculp-js'); const { cloneDeep, forEachDeep } = sculp; ``` ### Module-Specific Imports Import specific modules for better tree-shaking and smaller bundle sizes: ```js // ES Modules - Import specific modules import array from 'sculp-js/array'; import string from 'sculp-js/string'; import type from 'sculp-js/type'; import date from 'sculp-js/date'; import object from 'sculp-js/object'; import math from 'sculp-js/math'; import validator from 'sculp-js/validator'; // ... and more // CommonJS - Import specific modules const array = require('sculp-js/array'); const string = require('sculp-js/string'); const type = require('sculp-js/type'); // Usage examples import array from 'sculp-js/array'; array.arrayEach([1, 2, 3], val => console.log(val)); import string from 'sculp-js/string'; const camelCase = string.stringCamelCase('hello-world'); // 'helloWorld' import validator from 'sculp-js/validator'; if (validator.isEmail('test@example.com')) { console.log('Valid email'); } ``` ### Available Modules All modules support both named and default exports: - `sculp-js/array` - Array utilities - `sculp-js/string` - String manipulation - `sculp-js/type` - Type checking - `sculp-js/date` - Date formatting - `sculp-js/object` - Object utilities - `sculp-js/math` - Math operations - `sculp-js/number` - Number formatting - `sculp-js/url` - URL parsing - `sculp-js/qs` - Query string parsing - `sculp-js/path` - Path utilities - `sculp-js/async` - Async utilities - `sculp-js/func` - Function utilities - `sculp-js/random` - Random generators - `sculp-js/validator` - Validation functions - `sculp-js/tree` - Tree operations - `sculp-js/base64` - Base64 encoding - `sculp-js/unique` - Unique ID generators - `sculp-js/variable` - Variable utilities - `sculp-js/clipboard` - Clipboard operations - `sculp-js/cookie` - Cookie management - `sculp-js/dom` - DOM utilities - `sculp-js/download` - Download helpers - `sculp-js/file` - File utilities - `sculp-js/watermark` - Watermark generation - `sculp-js/tooltip` - Tooltip utilities - `sculp-js/cloneDeep` - Deep cloning - `sculp-js/isEqual` - Deep equality - `sculp-js/unicodeToolkit` - Unicode utilities ## 📄 License MIT License © 2023-present, [chandq](https://github.com/chandq) ## 🤝 Community - [Contributing Guide](./CONTRIBUTING.md) - [Code of Conduct](./CODE_OF_CONDUCT.md) - [Security Policy](./SECURITY.md) - [Report an Issue](https://github.com/chandq/sculp-js/issues) --- _Source: https://npm.io/package/sculp-js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._