@magic/types 0.1.40 → 0.1.41

package/README.md

@@ -3,24 +3,9 @@
 typechecking utilities
 
 [![NPM version][npm-image]][npm-url]
-[![Linux Build Status][travis-image]][travis-url]
-[![Windows Build Status][appveyor-image]][appveyor-url]
-[![Coverage Status][coveralls-image]][coveralls-url]
-[![Greenkeeper badge][greenkeeper-image]][greenkeeper-url]
-[![Known Vulnerabilities][snyk-image]][snyk-url]
 
 [npm-image]: https://img.shields.io/npm/v/@magic/types.svg
 [npm-url]: https://www.npmjs.com/package/@magic/types
-[travis-image]: https://img.shields.io/travis/com/magic/types/master
-[travis-url]: https://travis-ci.com/magic/types
-[appveyor-image]: https://img.shields.io/appveyor/ci/magic/types/master.svg
-[appveyor-url]: https://ci.appveyor.com/project/magic/types/branch/master
-[coveralls-image]: https://coveralls.io/repos/github/magic/types/badge.svg
-[coveralls-url]: https://coveralls.io/github/magic/types
-[greenkeeper-image]: https://badges.greenkeeper.io/magic/types.svg
-[greenkeeper-url]: https://badges.greenkeeper.io/magic/types.svg
-[snyk-image]: https://snyk.io/test/github/magic/types/badge.svg
-[snyk-url]: https://snyk.io/test/github/magic/types
 
 ##### install
 
@@ -533,6 +518,18 @@ update dependencies
 - update docs
 - update dependencies
 
-##### 0.1.41 - unreleased
+##### 0.1.41
 
-...
+- isArray accepts type predicates and narrows the element type: `isArray(arr, isString, isNumber)` → `e is (string | number)[]`, falling back to `unknown[]` without predicates
+- change isArray return type from `unknown[]` to `any[]` in generated types
+- add `scripts/add-node-reference.mjs` and run it after tsc in the build so `Buffer` resolves in the generated `.d.ts` files
+- move `@types/node` from dependencies to devDependencies
+- add `oxlint.config.ts` and lint fixes (curly braces, unused `@ts-expect-error` removals)
+- use bundler module resolution in tsconfig, disable strict, add separate `tsconfig.test.json` for fixtures
+- update dependencies (@magic/core, @magic/format, @magic/lint, @magic/test, @swc/core)
+- update docs
+- update dependencies
+
+##### 0.1.42 - unreleased
+
+- ...

package/package.json

@@ -1,13 +1,35 @@
 {
   "name": "@magic/types",
-  "version": "0.1.40",
-  "author": "Wizards & Witches",
+  "version": "0.1.41",
+  "description": "typechecking library",
+  "keywords": [
+    "magic",
+    "typechecking",
+    "types"
+  ],
   "homepage": "https://github.com/magic/types",
+  "bugs": {
+    "url": "https://github.com/magic/types/issues"
+  },
   "license": "AGPL-3.0",
-  "description": "typechecking library",
+  "author": "Wizards & Witches",
+  "contributors": [
+    {
+      "name": "jascha ehrenreich",
+      "github": "jaeh"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/magic/types.git"
+  },
+  "files": [
+    "src",
+    "types"
+  ],
+  "type": "module",
   "main": "src/index.js",
   "types": "./types/index.d.ts",
-  "type": "module",
   "exports": {
     ".": {
       "import": "./src/index.js",
@@ -16,7 +38,7 @@
   },
   "scripts": {
     "start": "t",
-    "build": "tsc && npm run format",
+    "build": "tsc && node scripts/add-node-reference.mjs && npm run format",
     "prepublishOnly": "npm run test && npm run build",
     "build:docs": "NODE_ENV=production magic build",
     "prod": "NODE_ENV=production magic build serve",
@@ -27,51 +49,30 @@
     "format": "f -w --exclude docs",
     "format:check": "f --exclude docs",
     "calls": "calls",
-    "lint": "tsc --noEmit",
-    "lint:test": "tsc --noEmit -p tsconfig.test.json"
+    "tsc": "tsc --noEmit",
+    "tsc:test": "tsc --noEmit -p tsconfig.test.json",
+    "lint": "lint",
+    "check": "npm run tsc && npm run tsc:test && npm run lint"
   },
-  "engines": {
-    "node": ">=18"
-  },
-  "engineStrict": true,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/magic/types.git"
-  },
-  "bugs": {
-    "url": "https://github.com/magic/types/issues"
-  },
-  "files": [
-    "src",
-    "types"
-  ],
   "devDependencies": {
     "@magic-modules/git-badges": "0.0.12",
     "@magic-modules/light-switch": "0.0.12",
     "@magic-modules/no-spy": "0.0.9",
     "@magic-modules/pre": "0.0.12",
     "@magic-themes/docs": "0.0.15",
-    "@magic/core": "0.0.160",
-    "@magic/format": "0.0.75",
-    "@magic/test": "0.3.32",
+    "@magic/core": "0.0.161",
+    "@magic/format": "0.0.79",
+    "@magic/lint": "0.0.5",
+    "@magic/test": "0.3.55",
+    "@types/node": "26.6.6",
     "typescript": "npm:@typescript/typescript6"
   },
-  "keywords": [
-    "magic",
-    "types",
-    "typechecking"
-  ],
-  "contributors": [
-    {
-      "name": "jascha ehrenreich",
-      "github": "jaeh"
-    }
-  ],
-  "dependencies": {
-    "@types/node": "26.6.3"
+  "engines": {
+    "node": ">=18"
   },
+  "engineStrict": true,
   "allowScripts": {
     "canvas@3.2.3": true,
-    "@swc/core@1.15.46": true
+    "@swc/core@1.15.47": true
   }
 }

package/src/fns.js

@@ -1,9 +1,21 @@
+/// <reference types="node" />
 /**
  * Check if a value is an Array
- * @param {unknown} e - value to test
- * @returns {e is unknown[]} - true if value is an array
+ * @type {<P extends readonly ((e: unknown) => e is unknown)[]>(e: unknown, ...predicates: P) => e is P extends readonly [] ? unknown[] : (P[number] extends (e: unknown) => e is infer U ? U : never)[]}
  */
-export const isArray = e => Array.isArray(e)
+export const isArray = (e, ...predicates) => {
+  if (!Array.isArray(e)) {
+    return false
+  }
+
+  // If no predicates provided, just check if it's an array
+  if (predicates.length === 0) {
+    return true
+  }
+
+  // Each element must pass at least one predicate
+  return e.every(element => predicates.some(predicate => predicate(element)))
+}
 
 /**
  * Check if a value is a boolean
@@ -432,16 +444,26 @@ export const isArguments = e => Object.prototype.toString.call(e) === '[object A
  * @returns {boolean}
  */
 export const isUUID = e => {
-  if (!isDefined(e)) return false
-  if (!isString(e)) return false
+  if (!isDefined(e)) {
+    return false
+  }
+  if (!isString(e)) {
+    return false
+  }
 
   const split = e.split('-')
-  if (!isLengthEqual(split, 5)) return false
+  if (!isLengthEqual(split, 5)) {
+    return false
+  }
 
   const lengths = [8, 4, 4, 4, 12]
-  if (lengths.some((l, i) => split[i].length !== l)) return false
+  if (lengths.some((l, i) => split[i].length !== l)) {
+    return false
+  }
 
-  if (Object.values(e).some(s => s > 'f')) return false
+  if (Object.values(e).some(s => s > 'f')) {
+    return false
+  }
 
   return true
 }
@@ -638,9 +660,13 @@ isCase.lower = isLowerCase
  * @returns {boolean} - true if value is an IPv4 address
  */
 export const isIPv4 = a => {
-  if (!isString(a)) return false
+  if (!isString(a)) {
+    return false
+  }
   const parts = a.split('.')
-  if (parts.length !== 4) return false
+  if (parts.length !== 4) {
+    return false
+  }
   return parts.every(part => {
     const num = Number(part)
     return /^(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/.test(part) && String(num) === part

package/src/lib.js

@@ -373,7 +373,9 @@ const addNotFunctions = (obj, target) => {
   const skipKeys = new Set(['length', 'name', 'prototype', 'caller', 'callee', 'arguments'])
 
   for (const [key, value] of Object.entries(obj)) {
-    if (key === 'not' || skipKeys.has(key)) continue
+    if (key === 'not' || skipKeys.has(key)) {
+      continue
+    }
     if (fns.isFunction(value)) {
       target[key] = negate(value)
       // Handle function sub-properties (e.g., isCase.upper, isIp.v4)

package/types/fns.d.ts

@@ -1,4 +1,14 @@
-export function isArray(e: unknown): e is unknown[]
+/// <reference types="node" />
+/**
+ * Check if a value is an Array
+ * @type {<P extends readonly ((e: unknown) => e is unknown)[]>(e: unknown, ...predicates: P) => e is P extends readonly [] ? unknown[] : (P[number] extends (e: unknown) => e is infer U ? U : never)[]}
+ */
+export const isArray: <P extends readonly ((e: unknown) => e is unknown)[]>(
+  e: unknown,
+  ...predicates: P
+) => e is P extends readonly []
+  ? unknown[]
+  : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
 export function isBoolean(e: unknown): e is boolean
 export function isDefined(e: unknown): e is NonNullable<unknown>
 export function isUndefined(e: unknown): e is undefined

package/types/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 export * from './fns.js'
 export * as deep from './deep/index.js'
 export const is: {
@@ -237,10 +238,30 @@ export const is: {
   not: import('./lib.js').NotNamespace
   isNeq: (e: unknown, ...types: string[]) => boolean
   neq: (e: unknown, ...types: string[]) => boolean
-  isArray: (e: unknown) => e is unknown[]
-  isArr: (e: unknown) => e is unknown[]
-  array: (e: unknown) => e is unknown[]
-  arr: (e: unknown) => e is unknown[]
+  isArray: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  isArr: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  array: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  arr: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
   isBoolean: (e: unknown) => e is boolean
   isBool: (e: unknown) => e is boolean
   boolean: (e: unknown) => e is boolean

package/types/lib.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 export const is: {
   isDeepEqual: {
     /**
@@ -235,10 +236,30 @@ export const is: {
   not: NotNamespace
   isNeq: (e: unknown, ...types: string[]) => boolean
   neq: (e: unknown, ...types: string[]) => boolean
-  isArray: (e: unknown) => e is unknown[]
-  isArr: (e: unknown) => e is unknown[]
-  array: (e: unknown) => e is unknown[]
-  arr: (e: unknown) => e is unknown[]
+  isArray: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  isArr: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  array: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
+  arr: <P extends readonly ((e: unknown) => e is unknown)[]>(
+    e: unknown,
+    ...predicates: P
+  ) => e is P extends readonly []
+    ? unknown[]
+    : (P[number] extends ((e: unknown) => e is infer U) ? U : never)[]
   isBoolean: (e: unknown) => e is boolean
   isBool: (e: unknown) => e is boolean
   boolean: (e: unknown) => e is boolean