@magic/types 0.1.37 → 0.1.39

package/README.md

@@ -140,6 +140,10 @@ isIterable([]) // true
 isEmail('a@b.c') // true
 // alias isMail, is.email, is.mail
 
+isIp('192.168.1.1') // true
+isIp('::1') // true
+// alias ip, is.ip, ipV4, ipV6, isIPv4, isIPv6
+
 isNull(null) // true
 // alias isNil, is.nil, is.null
 
@@ -402,6 +406,16 @@ update dependencies
 
 - update @magic/test
 
-##### 0.1.38 - unreleased
+##### 0.1.38
+
+- remove recursive dependencies
+- update dependencies
+
+##### 0.1.39
+
+- add isIp and variants to allow ip v4 and v6 checks
+- update dependencies
+
+##### 0.1.40 - unreleased
 
 ...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magic/types",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "author": "Wizards & Witches",
   "homepage": "https://github.com/magic/types",
   "license": "AGPL-3.0",
@@ -8,6 +8,12 @@
   "main": "src/index.js",
   "types": "./types/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "types": "./types/index.d.ts"
+    }
+  },
   "scripts": {
     "start": "t",
     "build": "tsc && npm run format",
@@ -44,9 +50,9 @@
     "@magic-modules/no-spy": "0.0.9",
     "@magic-modules/pre": "0.0.12",
     "@magic-themes/docs": "0.0.15",
-    "@magic/core": "0.0.158",
-    "@magic/format": "0.0.73",
-    "@magic/test": "0.3.12",
+    "@magic/core": "0.0.159",
+    "@magic/format": "0.0.75",
+    "@magic/test": "0.3.23",
     "typescript": "6.0.3"
   },
   "keywords": [
@@ -61,6 +67,10 @@
     }
   ],
   "dependencies": {
-    "@types/node": "25.9.2"
+    "@types/node": "26.1.0"
+  },
+  "allowScripts": {
+    "@swc/core@1.3.41": true,
+    "canvas@3.2.3": true
   }
 }

package/src/deep/different.js

@@ -1,4 +1,4 @@
-import is from '../lib.js'
+import { isUndefined } from '../fns.js'
 
 import equal from './equal.js'
 
@@ -19,8 +19,8 @@ import equal from './equal.js'
  * @returns {boolean | ((c: unknown) => boolean)}
  */
 export const different = (a, b) => {
-  if (is.undefined(b)) {
-    if (is.undefined(a)) {
+  if (isUndefined(b)) {
+    if (isUndefined(a)) {
       return false
     }
 

package/src/deep/equal.js

@@ -1,6 +1,15 @@
 // Written by Substack <3
 
-import is from '../lib.js'
+import {
+  isArray,
+  isBuffer,
+  isDate,
+  isFunction,
+  isNull,
+  isObject,
+  isObjectNative,
+  isUndefined,
+} from '../fns.js'
 
 /**
  * @overload
@@ -25,15 +34,15 @@ export const equal = (a, b, options = {}) => {
   const { strict = false, arrayOrderStrict = false } = options
 
   // curry
-  if (is.undefined(b)) {
-    if (is.undefined(a)) {
+  if (isUndefined(b)) {
+    if (isUndefined(a)) {
       return true
     }
 
     return c => equal(a, c)
   }
 
-  if (is.null(b)) {
+  if (isNull(b)) {
     return a === b
   }
 
@@ -43,11 +52,11 @@ export const equal = (a, b, options = {}) => {
   }
 
   /* functions are handled by their toString value */
-  if (is.function(a) && is.function(b)) {
+  if (isFunction(a) && isFunction(b)) {
     return a.toString() === b.toString()
   }
 
-  if (!is.object(a) || !is.object(b)) {
+  if (!isObject(a) || !isObject(b)) {
     return a === b
   }
 
@@ -62,12 +71,12 @@ export const equal = (a, b, options = {}) => {
   }
 
   // dates
-  if (is.date(a)) {
+  if (isDate(a)) {
     return a.toString() === b.toString()
   }
 
   // buffers
-  if (is.buffer(a) && is.buffer(b)) {
+  if (isBuffer(a) && isBuffer(b)) {
     if (a.length !== b.length) {
       return false
     }
@@ -81,7 +90,7 @@ export const equal = (a, b, options = {}) => {
     return true
   }
 
-  if (is.array(a) && is.array(b)) {
+  if (isArray(a) && isArray(b)) {
     if (!strict && !arrayOrderStrict) {
       a.sort()
       b.sort()
@@ -91,7 +100,7 @@ export const equal = (a, b, options = {}) => {
     return allEqual
   }
 
-  if (is.objectNative(a) && is.objectNative(b)) {
+  if (isObjectNative(a) && isObjectNative(b)) {
     const aObj = a
     const bObj = b
 

package/src/fns.js

@@ -631,3 +631,86 @@ export const isModule = s => Object.prototype.toString.call(s) === '[object Modu
 export const isCase = (s, c = 'up') => (c === 'up' ? isUpperCase(s) : isLowerCase(s))
 isCase.upper = isUpperCase
 isCase.lower = isLowerCase
+
+/**
+ * Check if a value is a valid IPv4 address
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IPv4 address
+ */
+export const isIPv4 = a => {
+  if (!isString(a)) return false
+  const parts = a.split('.')
+  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
+  })
+}
+
+/**
+ * Check if a value is a valid IPv6 address
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IPv6 address
+ */
+export const isIPv6 = a => {
+  if (!isString(a)) {
+    return false
+  }
+
+  const str = a.toLowerCase()
+
+  // Handle IPv4-mapped IPv6 (::ffff:192.168.1.1)
+  if (str.includes('.')) {
+    const lastColon = str.lastIndexOf(':')
+    const ipv4Part = str.slice(lastColon + 1)
+    if (!isIPv4(ipv4Part)) {
+      return false
+    }
+    const beforeIpv4 = str.slice(0, lastColon)
+    // Should be ::ffff: or similar, and rest should be empty or valid hex
+    const colonCount = beforeIpv4.split(':').length - 1
+    return colonCount <= 2 && (beforeIpv4 === '::ffff' || beforeIpv4 === ':' || beforeIpv4 === '')
+  }
+
+  // Handle :: compression
+  const doubleColon = str.indexOf('::')
+  if (doubleColon !== -1) {
+    const parts = str.split('::')
+    if (parts.length !== 2) {
+      return false
+    }
+    const leftParts = parts[0] ? parts[0].split(':') : []
+    const rightParts = parts[1] ? parts[1].split(':') : []
+    const totalGroups = leftParts.length + rightParts.length
+    if (totalGroups > 7) {
+      return false
+    }
+    const emptyParts =
+      leftParts.filter(p => p === '').length + rightParts.filter(p => p === '').length
+    if (emptyParts > 1) {
+      return false
+    }
+    const allValid = [...leftParts, ...rightParts].every(p => p === '' || /^[0-9a-f]{1,4}$/.test(p))
+    return allValid
+  }
+
+  // Full form: 8 groups of 1-4 hex digits
+  const parts = str.split(':')
+  if (parts.length !== 8) {
+    return false
+  }
+  return parts.every(part => /^[0-9a-f]{1,4}$/.test(part))
+}
+
+/**
+ * Check if a value is a valid IP address (v4 or v6)
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IP address
+ */
+export const isIp = a => isIPv4(a) || isIPv6(a)
+isIp.v4 = isIPv4
+isIp.v6 = isIPv6
+
+export const ipV4 = isIPv4
+
+export const ipV6 = isIPv6

package/src/lib.js

@@ -315,6 +315,18 @@ export const is = /** @type {const} */ {
   isLowerCase: fns.isLowerCase,
   lowerCase: fns.isLowerCase,
 
+  isIp: fns.isIp,
+  ip: fns.isIp,
+  isIPv4: fns.isIPv4,
+  ipv4: fns.isIPv4,
+  v4: fns.isIPv4,
+  isIPv6: fns.isIPv6,
+  ipv6: fns.isIPv6,
+  v6: fns.isIPv6,
+
+  ipV4: fns.ipV4,
+  ipV6: fns.ipV6,
+
   same: fns.isSameType,
   sameType: fns.isSameType,
   isSameType: fns.isSameType,

package/types/fns.d.ts

@@ -173,3 +173,12 @@ export const isCase: ((s: unknown, c?: 'up' | 'down') => boolean) & {
   upper: (s: unknown) => boolean
   lower: (s: unknown) => boolean
 }
+export function isIPv4(a: unknown): boolean
+export function isIPv6(a: unknown): boolean
+export function isIp(a: unknown): boolean
+export namespace isIp {
+  export { isIPv4 as v4 }
+  export { isIPv6 as v6 }
+}
+export function ipV4(a: unknown): boolean
+export function ipV6(a: unknown): boolean

package/types/index.d.ts

@@ -495,6 +495,24 @@ export const is: {
   upperCase: (s: unknown) => s is string
   isLowerCase: (s: unknown) => s is string
   lowerCase: (s: unknown) => s is string
+  isIp: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  ip: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  isIPv4: (a: unknown) => boolean
+  ipv4: (a: unknown) => boolean
+  v4: (a: unknown) => boolean
+  isIPv6: (a: unknown) => boolean
+  ipv6: (a: unknown) => boolean
+  v6: (a: unknown) => boolean
+  ipV4: (a: unknown) => boolean
+  ipV6: (a: unknown) => boolean
   same: (a: unknown, b: unknown) => boolean
   sameType: (a: unknown, b: unknown) => boolean
   isSameType: (a: unknown, b: unknown) => boolean

package/types/lib.d.ts

@@ -493,6 +493,24 @@ export const is: {
   upperCase: (s: unknown) => s is string
   isLowerCase: (s: unknown) => s is string
   lowerCase: (s: unknown) => s is string
+  isIp: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  ip: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  isIPv4: (a: unknown) => boolean
+  ipv4: (a: unknown) => boolean
+  v4: (a: unknown) => boolean
+  isIPv6: (a: unknown) => boolean
+  ipv6: (a: unknown) => boolean
+  v6: (a: unknown) => boolean
+  ipV4: (a: unknown) => boolean
+  ipV6: (a: unknown) => boolean
   same: (a: unknown, b: unknown) => boolean
   sameType: (a: unknown, b: unknown) => boolean
   isSameType: (a: unknown, b: unknown) => boolean