@jackens/nnn 2024.10.4 → 2025.2.1

package/nnn.d.ts

@@ -4,12 +4,10 @@
 export type CNode = {
     [attributeOrSelector: string]: string | number | CNode | undefined;
 };
-
 /**
  * The type of arguments of the `c` helper.
  */
 export type CRoot = Partial<Record<PropertyKey, CNode>>;
-
 /**
  * A simple JS-to-CSS (aka CSS-in-JS) helper.
  *
@@ -22,7 +20,6 @@ export type CRoot = Partial<Record<PropertyKey, CNode>>;
  * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
  */
 export declare const c: (root: CRoot, splitter?: string) => string;
-
 /**
  * A tiny helper for CSV parsing.
  *
@@ -43,37 +40,30 @@ export declare const csvParse: {
         separator: string;
     }>): Partial<Array<Partial<Record<PropertyKey, string>>>> | Partial<Array<Partial<Array<string>>>>;
 };
-
 /**
  * The type of arguments of the `escapeValues` and `escape` helpers.
  */
 export type EscapeMap = Map<unknown, (value?: unknown) => string>;
-
 /**
  * A generic helper for escaping `values` by given `escapeMap`.
  */
 export declare const escapeValues: (escapeMap: EscapeMap, values: Partial<Array<unknown>>) => Partial<Array<string>>;
-
 /**
  * A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
  */
 export declare const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: Partial<Array<unknown>>) => string;
-
 /**
  * A helper that implements typographic corrections specific to Polish typography.
  */
 export declare const fixTypography: (node: Node) => void;
-
 /**
  * The type of arguments of the `h` and `s` helpers.
  */
 export type HArgs1 = Partial<Record<PropertyKey, unknown>> | null | undefined | Node | string | number | HArgs;
-
 /**
  * The type of arguments of the `h` and `s` helpers.
  */
 export type HArgs = [string | Node, ...HArgs1[]];
-
 /**
  * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
  *
@@ -90,7 +80,6 @@ export declare const h: {
     <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
     (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
-
 /**
  * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
  *
@@ -107,17 +96,14 @@ export declare const s: {
     <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
     (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
-
 /**
  * A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
  */
 export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SVGSVGElement;
-
 /**
  * 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;
-
 /**
  * A helper that checks if the given argument is of a certain type.
  */
@@ -132,7 +118,6 @@ export declare const is: {
     (type: undefined, arg: unknown): arg is undefined | null;
     <T extends abstract new (...args: Partial<Array<any>>) => unknown>(type: T, arg: unknown): arg is InstanceType<T>;
 };
-
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
@@ -149,50 +134,41 @@ export declare const is: {
  * ```
  */
 export declare const jsOnParse: (handlers: Partial<Record<PropertyKey, Function>>, text: string) => any;
-
 /**
  * Language translations helper.
  */
 export declare const locale: (map: Partial<Record<PropertyKey, Partial<Record<PropertyKey, string>>>>, defaultVersion: string) => (text: string, version?: string) => string;
-
 /**
  * A generic helper for syntax highlighting (see also `nanolightJs`).
  */
 export declare const nanolight: (pattern: RegExp, highlighters: Partial<Array<(chunk: string, index: number) => HArgs1>>, code: string) => HArgs1[];
-
 /**
  * A helper for highlighting JavaScript (see also `nanolight`).
  */
 export declare const nanolightJs: (code: string) => HArgs1[];
-
 /**
  * A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
  */
 export declare const pick: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Pick<T, K[number]>;
-
 /**
  * A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
  */
 export declare const omit: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Omit<T, K[number]>;
-
 /**
  * A helper for choosing the correct singular and plural.
  */
 export declare const plUral: (singular: string, plural2: string, plural5: string, value: number) => string;
-
 /**
  * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty
  * object.
  */
 export declare const pro: (ref: unknown) => any;
-
 /**
  * A helper that provides information about the given `refs`.
  *
  * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
  */
 export declare const refsInfo: (...refs: Partial<Array<unknown>>) => Partial<Array<[string, string, Partial<Array<string>>]>>;
-
 /**
  * A helper that generates a UUID v1 identifier (with a creation timestamp).
  *

package/nnn.js

@@ -53,7 +53,6 @@ var c = (root, splitter = "$$") => {
   }
   return chunks.join("");
 };
-
 // src/nnn/csvParse.ts
 var _csvParseHeaderFalse = (text, separator) => {
   const regExp = new RegExp(`${separator}|(?<!")\\s*"((?:[^"]|"")*)"\\s*(?!")`, "g");
@@ -68,11 +67,9 @@ var _csvParseHeaderTrue = (text, separator) => {
   }, {}));
 };
 var csvParse = (text, { header = true, separator = "," } = {}) => header ? _csvParseHeaderTrue(text, separator) : _csvParseHeaderFalse(text, separator);
-
 // src/nnn/escape.ts
 var escapeValues = (escapeMap, values) => values.map((value) => (escapeMap.get(value?.constructor) ?? escapeMap.get(undefined))?.(value) ?? "");
 var escape = (escapeMap, template, ...values) => String.raw(template, ...escapeValues(escapeMap, values));
-
 // src/nnn/h.ts
 var NS = {
   xlink: "http://www.w3.org/1999/xlink"
@@ -158,7 +155,7 @@ var fixTypography = (node) => {
         let previousNode = node0;
         nodeValue.split(/(\s|\(|„)([aiouwz—]\s)/gi).forEach((chunk, i) => {
           i %= 3;
-          const currentNode = i === 2 ? h("span", { style: "white-space:nowrap" }, chunk) : i === 1 ? document.createTextNode(chunk) : document.createTextNode(chunk.replace(/(\/(?=[^/\s])|\.(?=[^\s]))/g, "$1\u200B"));
+          const currentNode = i === 2 ? h("span", { style: "white-space:nowrap" }, chunk) : i === 1 ? document.createTextNode(chunk) : document.createTextNode(chunk.replace(/(\/(?=[^/\s])|\.(?=[^\s]))/g, "$1​"));
           if (node0.parentNode != null) {
             node0.parentNode.insertBefore(currentNode, previousNode.nextSibling);
           }
@@ -169,10 +166,8 @@ var fixTypography = (node) => {
     }
   }
 };
-
 // src/nnn/has.ts
-var has = (key, ref) => (is(String, key) || is(Number, key) || is(Symbol, key)) && Object.hasOwnProperty.call(ref ?? Object, key);
-
+var has = (key, ref) => ref != null && Object.hasOwnProperty.call(ref, key);
 // src/nnn/jsOnParse.ts
 var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is(Object, value)) {
@@ -191,14 +186,12 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
   }
   return value;
 });
-
 // src/nnn/locale.ts
 var locale = (map, defaultVersion) => (text, version = defaultVersion) => {
   const textV = map?.[version]?.[text];
   const textD = map?.[defaultVersion]?.[text];
   return is(String, textV) ? textV : is(String, textD) ? textD : text;
 };
-
 // src/nnn/nanolight.ts
 var nanolight = (pattern, highlighters, code) => {
   const result = [];
@@ -210,7 +203,6 @@ var nanolight = (pattern, highlighters, code) => {
   });
   return result;
 };
-
 // src/nnn/nanolightJs.ts
 var nanolightJs = nanolight.bind(0, /('.*?'|".*?"|`[\s\S]*?`)|(\/\/.*?\n|\/\*[\s\S]*?\*\/)|(any|bigint|break|boolean|case|catch|class|const|continue|debugger|default|delete|do|else|eval|export|extends|false|finally|for|from|function|goto|if|import|in|instanceof|is|keyof|let|NaN|new|number|null|package|return|string|super|switch|symbol|this|throw|true|try|type|typeof|undefined|unknown|var|void|while|with|yield)(?!\w)|([<>=.?:&|!^~*/%+-])|(0x[\dabcdef_]+|0o[01234567_]+|0b[01_]+|\d[\d_]*(?:\.[\d_]+)?(?:e[+-]?[\d_]+)?)|([$\w]+)(?=\()|([$\wąćęłńóśżźĄĆĘŁŃÓŚŻŹ]+)/, [
   (chunk) => chunk,
@@ -222,25 +214,21 @@ var nanolightJs = nanolight.bind(0, /('.*?'|".*?"|`[\s\S]*?`)|(\/\/.*?\n|\/\*[\s
   (chunk) => ["span", { class: "function" }, chunk],
   (chunk) => ["span", { class: "literal" }, chunk]
 ]);
-
 // src/nnn/pick.ts
 var pick = (obj, keys) => Object.fromEntries(Object.entries(obj).filter(([key]) => keys.includes(key)));
 var omit = (obj, keys) => Object.fromEntries(Object.entries(obj).filter(([key]) => !keys.includes(key)));
-
 // src/nnn/plUral.ts
 var plUral = (singular, plural2, plural5, value) => {
   const absValue = Math.abs(value);
   const absValueMod10 = absValue % 10;
   return value === 1 ? singular : (absValueMod10 === 2 || absValueMod10 === 3 || absValueMod10 === 4) && absValue !== 12 && absValue !== 13 && absValue !== 14 ? plural2 : plural5;
 };
-
 // src/nnn/pro.ts
 var pro = (ref) => new Proxy(ref, {
   get(target, key) {
     return pro(target[key] = target[key] ?? {});
   }
 });
-
 // src/nnn/refsInfo.ts
 var refsInfo = (...refs) => {
   const fns = new Set;
@@ -259,7 +247,6 @@ var refsInfo = (...refs) => {
     Object.getOwnPropertyNames(fn.prototype ?? Object.create(null)).sort()
   ]).sort((a, b) => -(a[0] < b[0]));
 };
-
 // src/nnn/uuid1.ts
 var ZEROS = "0".repeat(16);
 var counter = 0;

package/package.json

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

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.10.4</code></sub>
+<sub>Version: <code class="version">2025.2.1</code></sub>
 
 * [Documentation](https://jackens.github.io/nnn/doc/)
 * [Tests](https://jackens.github.io/nnn/test/)
@@ -28,16 +28,16 @@ npm i @jackens/nnn
 import { «something» } from '@jackens/nnn'
 ```
 
-or:
+or
 
 ```js
 import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 ```
 
-or:
+or
 
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.10.4/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
 ```
 
 ## Exports
@@ -536,16 +536,19 @@ A replacement for the `in` operator (not to be confused with the `for-in` loop)
 #### Usage Examples
 
 ```js
-const obj = { key: 'K', null: 'N' }
+const obj = { 'k,e,y': 42, null: 42 }
+
+expect('k,e,y' in obj).to.be.true
+expect(has('k,e,y', obj)).to.be.true
 
-expect('key' in obj).to.be.true
-expect(has('key', obj)).to.be.true
+expect(['k', 'e', 'y'] in obj).to.be.true
+expect(has(['k', 'e', 'y'], obj)).to.be.true
 
 expect('null' in obj).to.be.true
 expect(has('null', obj)).to.be.true
 
 expect(null in obj).to.be.true
-expect(has(null, obj)).to.be.false
+expect(has(null, obj)).to.be.true
 
 expect('toString' in obj).to.be.true
 expect(has('toString', obj)).to.be.false
@@ -587,17 +590,19 @@ A helper that checks if the given argument is of a certain type.
 ```js
 expect(is(Number, 42)).to.be.true
 expect(is(Number, Number(42))).to.be.true
-
 expect(is(Number, new Number(42))).to.be.true
 expect(is(Number, NaN)).to.be.true
+
 expect(is(String, '42')).to.be.true
 expect(is(String, String('42'))).to.be.true
-
 expect(is(String, new String('42'))).to.be.true
+
 expect(is(Symbol, Symbol('42'))).to.be.true
 expect(is(Symbol, Object(Symbol('42')))).to.be.true
+
 expect(is(undefined, undefined)).to.be.true
 expect(is(undefined, null)).to.be.true
+
 expect(is(Object, {})).to.be.true
 expect(is(Array, [])).to.be.true
 expect(is(RegExp, /42/)).to.be.true