@rtorcato/js-common 2.8.2 → 4.0.0

package/AGENTS.md

@@ -0,0 +1,114 @@
+<!-- Generated from skills/js-common/SKILL.md by scripts/sync-agents.mjs — do not edit by hand; run `pnpm sync:agents`. -->
+
+# Using @rtorcato/js-common
+
+`@rtorcato/js-common` is a tree-shakeable, ESM-only utility library for Node.js >= 22 (TypeScript-first, JSDoc on every public API). One subpath export per concern — 44 of them. The package root is intentionally empty.
+
+## Rules
+
+1. **Import from the subpath, never the package root.** The root export has no runtime code at all, so a root import gets you nothing.
+
+   ```ts
+   // ✅ do
+   import { slugify } from '@rtorcato/js-common/strings'
+   // ❌ don't — the root export is empty by design
+   import { slugify } from '@rtorcato/js-common'
+   ```
+
+2. **Every export name has exactly one home.** No name is exported from two modules, so the module → exports table below is the only lookup you need. These pairs still read alike — check which one you want:
+
+   | Looks like | Actually |
+   |---|---|
+   | `functions.once` vs `events.onceEvent` | `once(fn)` memoises a call; `onceEvent(target, type)` awaits a DOM event |
+   | `logger` vs `logging` | `logger` is one configured pino instance; `logging` is `console` helpers with no runtime deps |
+   | `try.tryCatch` vs `errors.tryWithFallback` | Result object vs swallow-and-fall-back — see rule 3 |
+   | `date.formatDate` vs `datetime.formatDateTimeLocal` | a UTC calendar day vs a local instant |
+
+   Where two modules used to ship the same name, the loser was deleted rather than aliased — [MODULE-BOUNDARIES.md](https://github.com/rtorcato/js-common/blob/main/MODULE-BOUNDARIES.md) records which side won and why.
+
+3. **Three different error idioms — don't mix them up.**
+
+   ```ts
+   // Result object — preferred for new code
+   import { tryCatch } from '@rtorcato/js-common/try'
+   const { data, error } = await tryCatch(() => fetchData())
+
+   // Go-style tuple: [error, data] — error FIRST
+   import { to } from '@rtorcato/js-common/promises'
+   const [err, value] = await to(fetchData())
+
+   // Swallows the error and returns a fallback — only when the fallback is genuinely safe
+   import { tryWithFallback } from '@rtorcato/js-common/errors'
+   const rows = await tryWithFallback(() => fetchRows(), [])
+   ```
+
+   `tryCatch` in `errors` was renamed to `tryWithFallback` in 2.0; `tryCatch` now means the Result helper in `try`.
+
+4. **Node-only modules.** `crypto`, `security`, and `file` import `node:crypto` / `node:fs`; `logger` uses pino. Don't ship these to a browser bundle. `events` is the opposite — it wraps DOM `EventTarget` and is browser-only. `os`, `process`, `node`, and `system` probe for `process` / `window` and degrade rather than throw.
+
+5. **`./types` is types-only.** It has a `types` field and no `import` field on purpose — use it for `import type { Prettify, Merge } from '@rtorcato/js-common/types'` only.
+
+6. **Some helpers need a peer input you must supply.** `convertCurrency(amount, rate)` takes the rate — the library does no FX lookup. `checkEnv(schema)` needs a Zod object schema and throws with the list of missing keys.
+
+## Module → exports
+
+Import from `@rtorcato/js-common/<module>`.
+
+| Module | Exports |
+|---|---|
+| abortController | createAbortController, abortPromise, withAbort, abortAfter |
+| arrays | unique, chunk, compact, shuffle |
+| boolean | toBoolean |
+| colors | randomColor, matchingTextColor, hexToRgb, rgbToHex, isValidHex, darken, lighten |
+| console | disableConsole, clearConsole |
+| crypto | hashString, randomHex, hmacHash, base64Encode, base64Decode |
+| currency | getCurrencySymbol, getCurrencyName, getCurrencyLocale, formatPrice, formatPriceCompact, parsePrice, parseCurrencyString, convertCurrency, isValidCurrencyCode, isValidCurrency |
+| date | today, parseDate, formatDate, daysBetween, diffInHours, diffInMinutes, isLeapYear, addDays, subDays, addMonths, getDayOfWeek, startOfDay, endOfDay, isWeekend, isSameDay, isToday, formatRelative |
+| datetime | nowIso, parseIsoDateTime, formatDateTimeLocal, getTimezoneOffset, toUtcDate, unixTimestamp, unixMillis, getIsoWeek, getIsoWeekInfo |
+| emails | isValidEmail, normalizeEmail, maskEmail, getEmailDomain, isFreeEmailProvider |
+| env | getENV, isDev, isProd, isTest, getNodeEnv, checkEnv, RootApiEnvSchema |
+| errors | createCustomError, isErrorName, getErrorMessage, assert, tryWithFallback |
+| events | on, emit, onceEvent, preventDefault, stopPropagation |
+| fetch | fetchWithTimeout, postJson, getJson, fetchText, handleApiError |
+| file | readFileAsString, writeFileAsString, fileExists, deleteFile, getFileExtension |
+| functions | once, debounce, throttle, compose, pipe |
+| geometry | distance2D, midpoint2D, angle2D, pointInRect, rectsOverlap, polygonArea |
+| html | escapeHtml, unescapeHtml, stripHtmlTags, textToHtml, containsHtml |
+| i18n | detectLanguage, formatNumber, formatDateI18n, t |
+| json | safeJsonParse, safeJsonStringify, isValidJson |
+| logger | logger (pino instance — pretty in dev, JSON in prod) |
+| logging | logWithTimestamp, info, warn, error, captureConsole, ConsoleLevel |
+| maps | invertMap, mapValues, mergeMaps, objectToMap, mapToObject |
+| mime-types | lookup, types, extensions, mimeTypes |
+| node | nodeVersionCheck, getNodeMajorVersion, isNode, requireOptional |
+| numbers | clamp, roundTo, formatPercent, between, sum, average, mod |
+| objects | isPlainObject, deepMerge, omit, pick |
+| os | getOsPlatform, getOsRelease, getOsArch, getHomeDir, getTmpDir |
+| process | getProcessId, getProcessUptime, getCwd, getProcessPlatform, exitProcess, isCI |
+| promises | to, withTimeout |
+| random | randomInt, randomFloat, randomBool, randomElement, randomString |
+| regex | escapeRegExp, testRegex, matchAll, replaceAllRegex, splitByRegex |
+| security | stripScriptish, isStrongPassword, generateSecureToken |
+| sleep | sleep, sleepSync, sleepRandom, sleepWithAbort |
+| strings | titleCase, capitalize, camelCase, kebabCase, snakeCase, truncate, reverse, slugify, words, wordCount, pluralize, ordinalize, isBlank, mask, template |
+| system | isMacOs, isWindows, isLinux, isIOS, isAndroid, getPlatform, isTouchDevice |
+| time | nowTime, nowTimeShort, parseTime, formatTime, secondsBetween, pad2 |
+| try | tryCatch, isSuccess, Result, Success, Failure |
+| types | Prettify, Merge (types only) |
+| url | isValidUrl, getQueryParams, setQueryParam, removeQueryParam, joinUrl, getHostname |
+| uuid | getUUIDv7, getShortUUID, toShortUUID, fromShortUUID, isUUID, isUUIDv4, isNilUUID, getUUIDVersion, getNilUUID, uuidToBytes, bytesToUUID |
+| validation | isDefined, isString, isNumber, isBoolean, isArray, isObject, isEmail, isUrl |
+
+## CLI
+
+The package also ships a binary for shell use:
+
+```bash
+npx @rtorcato/js-common@latest date today
+npx @rtorcato/js-common@latest math sum 1 2 3
+npx @rtorcato/js-common@latest text capitalize "hello world"
+```
+
+See [CLI.md](https://github.com/rtorcato/js-common/blob/main/CLI.md) for the full command list.
+
+For full signatures and examples, see <https://rtorcato.github.io/js-common/>.

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+# Changelog — frozen at 2.8.2
+
+**This file stops at 2.8.2 and will not be updated again. It is not the place to
+look for what shipped.**
+
+[**GitHub Releases**](https://github.com/rtorcato/js-common/releases) is the
+canonical record, and the [changelog page on the docs
+site](https://rtorcato.github.io/js-common/docs/changelog) is built from it.
+
+Why: `@semantic-release/git` is dropped from this repo's plugin list because the
+`code-scanning-main` ruleset rejects the release commit with `GH013` — a commit
+created seconds earlier can never have CodeQL results (see
+[#153](https://github.com/rtorcato/js-common/issues/153) and
+[#211](https://github.com/rtorcato/js-common/issues/211)). Nothing commits this
+file back to `main`, so it holds whatever the last release with that plugin
+wrote. The same applies to the `version` field in `package.json`.
+
+Kept in the repo rather than deleted because GitHub Releases only go back to
+v1.2.0 — the hand-written `1.0.0` section at the bottom is the only record of
+that release, which is also why this file carries two formats.
+
+---
+
 ## [2.8.2](https://github.com/rtorcato/js-common/compare/v2.8.1...v2.8.2) (2026-07-23)
 
 

package/CONTRIBUTORS.md

@@ -31,6 +31,11 @@ We welcome contributions from everyone! Here's how you can help:
 8. Push to your branch (`git push origin feature/amazing-feature`)
 9. Open a Pull Request
 
+Adding a helper? Check [MODULE-BOUNDARIES.md](MODULE-BOUNDARIES.md) first. It
+records which module owns what, and the rule that no name is exported from two
+modules — module paths are frozen, so a helper in the wrong place is expensive
+to move later.
+
 ### 📝 Documentation
 - Improve README.md, code comments, or JSDoc
 - Add examples for existing functions

package/README.md

@@ -1,8 +1,16 @@
 # js-common
 
-![js-common banner](./banner.png)
-
+<p align="center">
+  <picture>
+    <source media="(max-width: 600px)" srcset="./brand/banner-mobile.png">
+    <img src="./brand/banner.png" alt="js-common — Tree-shakeable TypeScript utilities: tiny bundles, full type safety, CLI included." width="100%">
+  </picture>
+</p>
+
+[![CI](https://github.com/rtorcato/js-common/actions/workflows/ci.yml/badge.svg)](https://github.com/rtorcato/js-common/actions/workflows/ci.yml)
 [![npm version](https://badge.fury.io/js/%40rtorcato%2Fjs-common.svg)](https://badge.fury.io/js/%40rtorcato%2Fjs-common)
+[![npm downloads](https://img.shields.io/npm/dm/@rtorcato/js-common.svg)](https://www.npmjs.com/package/@rtorcato/js-common)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/@rtorcato/js-common)](https://bundlephobia.com/package/@rtorcato/js-common)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
@@ -18,8 +26,8 @@ A comprehensive set of common JavaScript and TypeScript utilities for Node.js pr
 - **Tree-shakeable** — import only what you need via subpath exports
 - **TypeScript** — full type definitions, JSDoc on every public API
 - **CLI included** — optional binary for use in scripts and terminals
-- **Modular** — one module per concern, 46 subpaths
-- **Minimal runtime deps** — only `date-fns`, `date-fns-tz`, `luxon`, `pino`, `uuid`, `short-uuid`, `zod`. CLI packages (`chalk`, `commander`, `figlet`, …) are `optionalDependencies` and only needed for the CLI.
+- **Modular** — one module per concern, 42 subpaths
+- **Minimal runtime deps** — only `pino`, `uuid`, `short-uuid`, `zod`. CLI packages (`chalk`, `commander`, `figlet`, …) are `optionalDependencies` and only needed for the CLI.
 
 ## Installation
 
@@ -27,11 +35,43 @@ A comprehensive set of common JavaScript and TypeScript utilities for Node.js pr
 npm install @rtorcato/js-common
 ```
 
-## Migrating from 1.x to 2.x
+Pre-release builds are published to the `beta` dist-tag, so they never reach a plain `npm install`:
+
+```bash
+npm install @rtorcato/js-common@beta
+```
+
+## Use with AI
+
+An agent skill lives in [`skills/js-common`](./skills/js-common/SKILL.md) — it teaches an AI coding agent the subpath-import rules, which same-named helper belongs to which module, the three error idioms, which modules are Node-only, and the full module → exports map.
+
+**Claude Code** — this repo is its own plugin marketplace:
+
+```
+/plugin marketplace add rtorcato/js-common
+/plugin install js-common@js-common
+```
+
+**Cursor, Copilot, Codex and other tools** — read [`AGENTS.md`](./AGENTS.md), the cross-tool convention file. It carries the same guidance and also ships in the npm tarball, so tools that scan `node_modules` find it at `node_modules/@rtorcato/js-common/AGENTS.md`.
+
+**Any tool the [`skills`](https://www.npmjs.com/package/skills) CLI supports:**
+
+```bash
+npx skills add https://github.com/rtorcato/js-common --skill js-common
+```
+
+`AGENTS.md` is generated from `SKILL.md` by `pnpm sync:agents`; CI fails if they drift. Edit `SKILL.md`, never `AGENTS.md`.
+
+## Migrating
+
+**3.x → 4.x** — everything the runtime already does was removed. `./sets` and `./interval` are gone as modules, and the pass-through wrappers inside surviving modules went with them: `promises.all`/`allSettled`/`race`/`delay`, `boolean.and`/`or`/`not`/`xor`, `strings.padStart`/`padEnd`/`replaceString`, `arrays.first`/`last`/`flatten`/`groupBy`, `numbers.isInteger`/`isFiniteNumber`/`min`/`max`, `objects.deepClone`, `json.deepCloneJson` and `uuid.getUUID`. Nothing moved to another module — the replacement is a JavaScript built-in in every case, which the Node 22 floor guarantees. Two are **not** drop-ins: `Object.groupBy` returns a null-prototype object with optional values, and `structuredClone` keeps `Date`s where the JSON round trip flattened them. The full before/after table is in the [migration guide](https://rtorcato.github.io/js-common/docs/guides/migration).
 
-The only breaking change in 2.0 is a rename in the `errors` module:
+**2.x → 3.x** — every helper now has exactly one home. `./formatting` and `./math` are gone, and where two modules shipped the same name the loser was deleted rather than aliased, so you get a build error naming the fix. One helper was also renamed rather than moved: `sanitizeString` is now `stripScriptish`, because the old name promised sanitising it never did — it removes `<script>` blocks and inline `on*` handlers and nothing else. The full before/after map is in the [migration guide](https://rtorcato.github.io/js-common/docs/guides/migration); the reasoning is in [MODULE-BOUNDARIES.md](MODULE-BOUNDARIES.md).
+
+**1.x → 2.x** — the only breaking change in 2.0 is a rename in the `errors` module:
 
 ```ts
+// boundary-check: ignore — quotes the pre-2.0 API on purpose
 // 1.x — swallow errors and fall back to a default value
 import { tryCatch } from '@rtorcato/js-common/errors'
 const data = await tryCatch(() => fetchData(), [])
@@ -76,16 +116,16 @@ See [CLI.md](./CLI.md) for complete CLI documentation.
 ```typescript
 // Import specific modules (recommended for tree-shaking)
 import { formatDate, today, daysBetween } from '@rtorcato/js-common/date'
-import { validateEmail, isValidEmail } from '@rtorcato/js-common/emails'
-import { generateUUID, isValidUUID } from '@rtorcato/js-common/uuid'
+import { isValidEmail, normalizeEmail } from '@rtorcato/js-common/emails'
+import { getUUIDv7, isUUID } from '@rtorcato/js-common/uuid'
 import { sum, average, roundTo } from '@rtorcato/js-common/numbers'
-import { capitalize, toTitleCase } from '@rtorcato/js-common/formatting'
+import { capitalize, titleCase } from '@rtorcato/js-common/strings'
 
 // Example usage
 console.log(today()) // "2026-05-29"
 console.log(sum([1, 2, 3, 4, 5])) // 15
 console.log(capitalize('hello world')) // "Hello world"
-console.log(generateUUID()) // "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+console.log(getUUIDv7()) // "018e5e2c-7c0a-7000-8000-0e02b2c3d479"
 ```
 
 ### Bundle Size Impact
@@ -94,51 +134,51 @@ Each module is shipped as its own subpath export so bundlers only include what y
 
 ## Available Modules
 
+Which module a helper belongs to — and why no helper is exported from two of
+them — is recorded in [MODULE-BOUNDARIES.md](MODULE-BOUNDARIES.md). These paths
+are frozen as of that record.
+
 ### Date & Time
 ```typescript
 import { today, formatDate, daysBetween, isLeapYear } from '@rtorcato/js-common/date'
 import { nowIso, formatDateTimeLocal, unixTimestamp } from '@rtorcato/js-common/datetime'
 import { nowTime, parseTime, secondsBetween } from '@rtorcato/js-common/time'
-import { runInterval, clearIntervalById } from '@rtorcato/js-common/interval'
 ```
 
-### Numbers & Math
+### Numbers
 ```typescript
-import { sum, average, roundTo, clamp, getRandomInt } from '@rtorcato/js-common/numbers'
-import { add, subtract, multiply, divide } from '@rtorcato/js-common/math'
+import { sum, average, roundTo, clamp, formatPercent } from '@rtorcato/js-common/numbers'
 import { randomInt, randomFloat, randomBool, randomElement } from '@rtorcato/js-common/random'
 ```
 
 ### Text & Strings
 ```typescript
-import { capitalize, toTitleCase, padZero } from '@rtorcato/js-common/formatting'
-import { slugify, truncate, removeEmojis } from '@rtorcato/js-common/strings'
+import { slugify, truncate, capitalize, titleCase, pluralize } from '@rtorcato/js-common/strings'
 import { escapeHtml, unescapeHtml, stripHtmlTags } from '@rtorcato/js-common/html'
 import { escapeRegExp, matchAll, replaceAllRegex } from '@rtorcato/js-common/regex'
-import { detectLanguage, formatNumber, t, pluralize } from '@rtorcato/js-common/i18n'
+import { detectLanguage, formatNumber, formatDateI18n, t } from '@rtorcato/js-common/i18n'
 ```
 
 ### Security & Validation
 ```typescript
 import { isStrongPassword, generateSecureToken } from '@rtorcato/js-common/security'
-import { isValidEmail, validateEmail } from '@rtorcato/js-common/emails'
+import { isValidEmail, maskEmail } from '@rtorcato/js-common/emails'
 import { isValidUrl } from '@rtorcato/js-common/url'
-import { isString, isNumber, isArray, isObject } from '@rtorcato/js-common/validation'
-import { toBoolean, isBoolean, xor } from '@rtorcato/js-common/boolean'
+import { isString, isNumber, isBoolean, isArray, isObject } from '@rtorcato/js-common/validation'
+import { toBoolean } from '@rtorcato/js-common/boolean'
 ```
 
 ### Data Structures
 ```typescript
-import { flatten, unique, chunk, groupBy } from '@rtorcato/js-common/arrays'
-import { deepMerge, pick, omit, deepClone } from '@rtorcato/js-common/objects'
+import { unique, chunk, compact, shuffle } from '@rtorcato/js-common/arrays'
+import { deepMerge, pick, omit, isPlainObject } from '@rtorcato/js-common/objects'
 import { safeJsonParse, safeJsonStringify } from '@rtorcato/js-common/json'
 import { invertMap, mapValues, objectToMap, mapToObject } from '@rtorcato/js-common/maps'
-import { union, intersection, difference, isSubset } from '@rtorcato/js-common/sets'
 ```
 
 ### Async & Control Flow
 ```typescript
-import { delay, timeout, retry } from '@rtorcato/js-common/promises'
+import { to, withTimeout } from '@rtorcato/js-common/promises'
 import { debounce, throttle, once } from '@rtorcato/js-common/functions'
 import { sleep } from '@rtorcato/js-common/sleep'
 import { tryCatch } from '@rtorcato/js-common/try'
@@ -166,7 +206,7 @@ import { info, warn, error, captureConsole } from '@rtorcato/js-common/logging'
 - `colors` — color manipulation and conversion
 - `crypto` — cryptographic helpers
 - `currency` — currency formatting and conversion
-- `events` — event emitter utilities
+- `events` — DOM event helpers (`on`, `emit`, `onceEvent`)
 - `fetch` — HTTP request helpers
 - `file` — file system helpers
 - `geometry` — 2D geometry calculations
@@ -212,7 +252,7 @@ pnpm run benchmark
 The full documentation site lives in [`apps/docs`](./apps/docs) and is built with [Docusaurus](https://docusaurus.io/). It auto-deploys to GitHub Pages on every push to `main` that touches `apps/docs/**`.
 
 ```bash
-# Run the docs locally (http://localhost:4321/js-common)
+# Run the docs locally (http://localhost:3000/js-common/)
 pnpm --filter @rtorcato/js-common-docs dev
 
 # Build the static site
@@ -221,6 +261,10 @@ pnpm --filter @rtorcato/js-common-docs build
 
 Live site: <https://rtorcato.github.io/js-common/>
 
+## Roadmap
+
+Direction and progress are tracked entirely on GitHub — see the [milestones](https://github.com/rtorcato/js-common/milestones) for the stages (shipped 2.x modules, the beta npm preview, the v1.0 stable API) and the [open issues](https://github.com/rtorcato/js-common/issues) for day-to-day work.
+
 ## Contributing
 
 Contributions are welcome! Please read [CONTRIBUTORS.md](./CONTRIBUTORS.md) for guidelines.
@@ -231,6 +275,11 @@ Contributions are welcome! Please read [CONTRIBUTORS.md](./CONTRIBUTORS.md) for
 4. Run the test suite: `pnpm test`
 5. Submit a pull request
 
+## Related packages
+
+- [@rtorcato/browser-common](https://github.com/rtorcato/browser-common) — Browser Web API wrappers (clipboard, observers, storage, etc.)
+- [@rtorcato/repo-tooling](https://github.com/rtorcato/repo-tooling) — Project scaffolding for TypeScript libraries (Biome, Vitest, Husky, semantic-release)
+
 ## License
 
 MIT © [Richard Torcato](https://github.com/rtorcato)

package/dist/abortController/index.d.ts

@@ -1,5 +1,14 @@
 /**
  * Creates a new AbortController and returns its controller and signal.
+ *
+ * @example
+ * ```typescript
+ * const { controller, signal } = createAbortController()
+ * signal.aborted // false
+ * controller.abort()
+ * signal.aborted // true
+ * ```
+ *
  * @returns {{ controller: AbortController, signal: AbortSignal }}
  */
 export declare function createAbortController(): {
@@ -8,12 +17,33 @@ export declare function createAbortController(): {
 };
 /**
  * Returns a promise that rejects when the given AbortSignal is aborted.
+ *
+ * @example
+ * ```typescript
+ * const { controller, signal } = createAbortController()
+ * const pending = abortPromise(signal)
+ * controller.abort()
+ * await pending.catch((err) => err.name) // 'AbortError'
+ * ```
+ *
  * @param signal The AbortSignal to listen to.
  * @returns {Promise<never>}
  */
 export declare function abortPromise(signal: AbortSignal): Promise<never>;
 /**
  * Wraps a promise and rejects it if the signal is aborted.
+ *
+ * @example
+ * ```typescript
+ * const { controller, signal } = createAbortController()
+ * const slow = new Promise<string>((resolve) => setTimeout(() => resolve('done'), 50))
+ *
+ * await withAbort(slow, signal) // 'done'
+ *
+ * controller.abort()
+ * await withAbort(slow, signal).catch((err) => err.name) // 'AbortError'
+ * ```
+ *
  * @param promise The promise to wrap.
  * @param signal The AbortSignal.
  * @returns {Promise<T>}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abortController/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB;;;EAGpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAchE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAEjG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abortController/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB;;;EAGpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAchE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAEjG"}

package/dist/arrays/arrays.test-d.js

@@ -1 +1 @@
-import{a as n,b as a,c as t,e as u,h as s}from"../chunks/chunk-5IA77ERW.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as o,expectTypeOf as e,it as r}from"vitest";o("arrays \u2014 types",()=>{r("first/last preserve element type and add undefined",()=>{e(n([1,2,3])).toEqualTypeOf(),e(n(["a","b"])).toEqualTypeOf(),e(a([{id:1}])).toEqualTypeOf()}),r("unique preserves element type",()=>{e(t([1,2,3])).toEqualTypeOf(),e(t(["a"])).toEqualTypeOf()}),r("chunk returns array of arrays of the element type",()=>{e(u([1,2,3],2)).toEqualTypeOf(),e(u(["a","b"],1)).toEqualTypeOf()}),r("groupBy preserves element type in the grouped arrays",()=>{let i=s([{kind:"a",n:1}],p=>p.kind);e(i).toEqualTypeOf()})});
+import{a as r,b as t}from"../chunks/chunk-UQBVI52L.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as a,expectTypeOf as e,it as u}from"vitest";a("arrays \u2014 types",()=>{u("unique preserves element type",()=>{e(r([1,2,3])).toEqualTypeOf(),e(r(["a"])).toEqualTypeOf()}),u("chunk returns array of arrays of the element type",()=>{e(t([1,2,3],2)).toEqualTypeOf(),e(t(["a","b"],1)).toEqualTypeOf()})});

package/dist/arrays/index.d.ts

@@ -1,33 +1,3 @@
-/**
- * Returns the first element of an array, or undefined if the array is empty.
- *
- * @example
- * ```typescript
- * first([1, 2, 3]) // 1
- * first([]) // undefined
- * first(['a', 'b']) // 'a'
- * ```
- *
- * @param arr The array to get the first element from
- * @returns The first element or undefined if array is empty
- * @category Array Utilities
- */
-export declare function first<T>(arr: T[]): T | undefined;
-/**
- * Returns the last element of an array, or undefined if the array is empty.
- *
- * @example
- * ```typescript
- * last([1, 2, 3]) // 3
- * last([]) // undefined
- * last(['a', 'b']) // 'b'
- * ```
- *
- * @param arr The array to get the last element from
- * @returns The last element or undefined if array is empty
- * @category Array Utilities
- */
-export declare function last<T>(arr: T[]): T | undefined;
 /**
  * Removes duplicate values from an array while preserving order.
  * Uses Set for O(n) performance with primitive values.
@@ -44,21 +14,6 @@ export declare function last<T>(arr: T[]): T | undefined;
  * @category Array Utilities
  */
 export declare function unique<T>(arr: T[]): T[];
-/**
- * Flattens an array one level deep.
- *
- * @example
- * ```typescript
- * flatten([[1, 2], [3, 4]]) // [1, 2, 3, 4]
- * flatten([1, [2, 3], 4]) // [1, 2, 3, 4]
- * flatten([[1, [2]], [3]]) // [1, [2], 3] (only one level deep)
- * ```
- *
- * @param arr The array to flatten
- * @returns A new flattened array
- * @category Array Utilities
- */
-export declare function flatten<T>(arr: readonly (T | T[])[]): T[];
 /**
  * Chunks an array into smaller arrays of a specified size.
  * The last chunk may be smaller if the array length is not evenly divisible.
@@ -113,22 +68,4 @@ export declare function compact<T>(arr: T[]): T[];
  * @category Array Utilities
  */
 export declare function shuffle<T>(arr: T[]): T[];
-/**
- * Groups array elements by a key derived from each element.
- *
- * @example
- * ```typescript
- * groupBy([1, 2, 3, 4], n => n % 2 === 0 ? 'even' : 'odd')
- * // { odd: [1, 3], even: [2, 4] }
- *
- * groupBy([{ type: 'a' }, { type: 'b' }, { type: 'a' }], x => x.type)
- * // { a: [{ type: 'a' }, { type: 'a' }], b: [{ type: 'b' }] }
- * ```
- *
- * @param arr The array to group
- * @param fn Function that returns the group key for each element
- * @returns An object mapping keys to arrays of elements
- * @category Array Utilities
- */
-export declare function groupBy<T>(arr: T[], fn: (item: T) => string | number): Record<string | number, T[]>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arrays/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAE/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAOtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAExC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACxB,GAAG,EAAE,CAAC,EAAE,EACR,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAC9B,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAO9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arrays/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAOtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAExC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxC"}

package/dist/arrays/index.js

@@ -1 +1 @@
-import{a,b,c,d,e,f,g,h}from"../chunks/chunk-5IA77ERW.js";import"../chunks/chunk-ANN5UYCF.js";export{e as chunk,f as compact,a as first,d as flatten,h as groupBy,b as last,g as shuffle,c as unique};
+import{a,b,c,d}from"../chunks/chunk-UQBVI52L.js";import"../chunks/chunk-ANN5UYCF.js";export{b as chunk,c as compact,d as shuffle,a as unique};

package/dist/boolean/index.d.ts

@@ -1,41 +1,18 @@
 /**
  * Converts a value to a boolean.
  * Accepts 'true', '1', 1 as true; 'false', '0', 0 as false.
+ *
+ * @example
+ * ```typescript
+ * toBoolean('true') // true
+ * toBoolean('0') // false
+ * toBoolean(1) // true
+ * toBoolean(2) // false
+ * toBoolean(null) // false
+ * ```
+ *
  * @param value The value to convert.
  * @returns The boolean representation.
  */
 export declare function toBoolean(value: unknown): boolean;
-/**
- * Checks if a value is a boolean.
- * @param value The value to check.
- * @returns True if the value is a boolean, false otherwise.
- */
-export declare function isBoolean(value: unknown): value is boolean;
-/**
- * Returns the logical exclusive OR (XOR) of two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if exactly one of a or b is true.
- */
-export declare function xor(a: boolean, b: boolean): boolean;
-/**
- * Logical AND for two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if both a and b are true.
- */
-export declare function and(a: boolean, b: boolean): boolean;
-/**
- * Logical OR for two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if either a or b is true.
- */
-export declare function or(a: boolean, b: boolean): boolean;
-/**
- * Logical NOT for a boolean.
- * @param a The boolean to negate.
- * @returns The negated boolean.
- */
-export declare function not(a: boolean): boolean;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWjD;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWjD"}

package/dist/boolean/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function e(o){if(typeof o=="boolean")return o;if(typeof o=="string"){let n=o.trim().toLowerCase();if(n==="true"||n==="1")return!0;if(n==="false"||n==="0")return!1}return typeof o=="number"?o===1:!!o}function r(o){return typeof o=="boolean"}function t(o,n){return!!(o?!n:n)}function a(o,n){return o&&n}function f(o,n){return o||n}function u(o){return!o}export{a as and,r as isBoolean,u as not,f as or,e as toBoolean,t as xor};
+import"../chunks/chunk-ANN5UYCF.js";function r(o){if(typeof o=="boolean")return o;if(typeof o=="string"){let n=o.trim().toLowerCase();if(n==="true"||n==="1")return!0;if(n==="false"||n==="0")return!1}return typeof o=="number"?o===1:!!o}export{r as toBoolean};

package/dist/chunks/chunk-AVPQVYSA.js

@@ -0,0 +1 @@
+async function i(r){try{return[null,await r]}catch(e){return[e,void 0]}}function u(r,e,n=new Error("Timeout")){return Promise.race([r,new Promise((o,t)=>setTimeout(()=>t(n),e))])}export{i as a,u as b};