@jackens/nnn 2025.2.1 → 2025.2.2

package/nnn.d.ts

@@ -103,7 +103,7 @@ export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SV
 /**
  * A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
  */
-export declare const has: (key: unknown, ref: unknown) => boolean;
+export declare const hasOwn: (ref: unknown, key: unknown) => boolean;
 /**
  * A helper that checks if the given argument is of a certain type.
  */

package/nnn.js

@@ -166,8 +166,8 @@ var fixTypography = (node) => {
     }
   }
 };
-// src/nnn/has.ts
-var has = (key, ref) => ref != null && Object.hasOwnProperty.call(ref, key);
+// src/nnn/hasOwn.ts
+var hasOwn = (ref, key) => ref != null && Object.hasOwn(ref, key);
 // src/nnn/jsOnParse.ts
 var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is(Object, value)) {
@@ -272,7 +272,7 @@ export {
   locale,
   jsOnParse,
   is,
-  has,
+  hasOwn,
   h,
   fixTypography,
   escapeValues,

package/package.json

@@ -36,5 +36,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.2.1"
+  "version": "2025.2.2"
 }

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.2.1</code></sub>
+<sub>Version: <code class="version">2025.2.2</code></sub>
 
 * [Documentation](https://jackens.github.io/nnn/doc/)
 * [Tests](https://jackens.github.io/nnn/test/)
@@ -37,7 +37,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 or
 
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.2/nnn.js'
 ```
 
 ## Exports
@@ -53,7 +53,7 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
 - `escapeValues`: A generic helper for escaping `values` by given `escapeMap`.
 - `fixTypography`: A helper that implements typographic corrections specific to Polish typography.
 - `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
-- `has`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
+- `hasOwn`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
 - `is`: A helper that checks if the given argument is of a certain type.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
@@ -525,10 +525,10 @@ h(div, { $key: { two: 2 } })
 expect(div.key).to.deep.equal({ one: 1, two: 2 })
 ```
 
-### has
+### hasOwn
 
 ```ts
-const has: (key: unknown, ref: unknown) => boolean;
+const hasOwn: (ref: unknown, key: unknown) => boolean;
 ```
 
 A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
@@ -536,35 +536,34 @@ A replacement for the `in` operator (not to be confused with the `for-in` loop)
 #### Usage Examples
 
 ```js
-const obj = { 'k,e,y': 42, null: 42 }
+const obj = { 42: null, null: 'k,e,y', 'k,e,y': 42 }
 
-expect('k,e,y' in obj).to.be.true
-expect(has('k,e,y', obj)).to.be.true
+expect(42 in obj).to.be.true
+expect(hasOwn(obj, 42)).to.be.true
 
-expect(['k', 'e', 'y'] in obj).to.be.true
-expect(has(['k', 'e', 'y'], obj)).to.be.true
+expect('42' in obj).to.be.true
+expect(hasOwn(obj, '42')).to.be.true
 
 expect('null' in obj).to.be.true
-expect(has('null', obj)).to.be.true
+expect(hasOwn(obj, 'null')).to.be.true
 
 expect(null in obj).to.be.true
-expect(has(null, obj)).to.be.true
+expect(hasOwn(obj, null)).to.be.true
 
-expect('toString' in obj).to.be.true
-expect(has('toString', obj)).to.be.false
-```
+expect('k,e,y' in obj).to.be.true
+expect(hasOwn(obj, 'k,e,y')).to.be.true
 
-```js
-let typeError
+expect(['k', 'e', 'y'] in obj).to.be.true
+expect(hasOwn(obj, ['k', 'e', 'y'])).to.be.true
 
-try {
-  'key' in null
-} catch (error) {
-  typeError = error
-}
+expect('toString' in obj).to.be.true
+expect(hasOwn(obj, 'toString')).to.be.false
+
+expect(() => 'key' in null).to.throw
+expect(hasOwn(null, 'key')).to.be.false
 
-expect(typeError instanceof TypeError) // Cannot use 'in' operator to search for 'key' in null
-expect(has('key', null)).to.be.false
+expect(() => 'key' in undefined).to.throw
+expect(hasOwn(undefined, 'key')).to.be.false
 ```
 
 ### is