@jackens/nnn 2025.2.4 → 2025.4.29

package/nnn.d.ts

@@ -105,19 +105,21 @@ export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SV
  */
 export declare const hasOwn: (ref: unknown, key: unknown) => boolean;
 /**
- * A helper that checks if the given argument is of a certain type.
- */
-export declare const is: {
-    (type: ArrayConstructor, arg: unknown): arg is Partial<Array<unknown>>;
-    (type: BigIntConstructor, arg: unknown): arg is bigint;
-    (type: BooleanConstructor, arg: unknown): arg is boolean;
-    (type: NumberConstructor, arg: unknown): arg is number;
-    (type: ObjectConstructor, arg: unknown): arg is Partial<Record<PropertyKey, unknown>>;
-    (type: StringConstructor, arg: unknown): arg is string;
-    (type: SymbolConstructor, arg: unknown): arg is symbol;
-    (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>;
-};
+ * A helper that checks if the given argument is of type `any[]`.
+ */
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * A helper that checks if the given argument is of type `number`.
+ */
+export declare const isNumber: (arg: any) => arg is number;
+/**
+ * A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
+ */
+export declare const isRecord: (arg: any) => arg is Partial<Record<PropertyKey, unknown>>;
+/**
+ * A helper that checks if the given argument is of type `string`.
+ */
+export declare const isString: (arg: any) => arg is string;
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
@@ -134,10 +136,6 @@ 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`).
  */

package/nnn.js

@@ -1,5 +1,8 @@
 // src/nnn/is.ts
-var is = (type, arg) => arg?.constructor === type;
+var isArray = Array.isArray;
+var isNumber = (arg) => typeof arg === "number";
+var isRecord = (arg) => typeof arg === "object" && arg != null && !isArray(arg);
+var isString = (arg) => typeof arg === "string";
 
 // src/nnn/c.ts
 var _c = (node, prefix, result, split) => {
@@ -9,7 +12,7 @@ var _c = (node, prefix, result, split) => {
     if (style0 == null || prefix0 == null) {
       continue;
     }
-    if (is(Array, style0)) {
+    if (isArray(style0)) {
       result.push(prefix0, prefix0 !== "" ? "{" : "", style0.join(";"), prefix0 !== "" ? "}" : "");
     } else {
       const todo = [];
@@ -17,7 +20,7 @@ var _c = (node, prefix, result, split) => {
       let attributesPushed = false;
       for (const key in style0) {
         const value = style0[key];
-        if (is(String, value) || is(Number, value)) {
+        if (isString(value) || isNumber(value)) {
           if (!attributesPushed) {
             attributesPushed = true;
             attributes = [];
@@ -77,21 +80,19 @@ var NS = {
 var _h = (namespaceURI) => {
   const createElement = namespaceURI == null ? (tag) => document.createElement(tag) : (tag) => document.createElementNS(namespaceURI, tag);
   const h = (tagOrNode, ...args) => {
-    const node = is(String, tagOrNode) ? createElement(tagOrNode) : tagOrNode;
+    const node = isString(tagOrNode) ? createElement(tagOrNode) : tagOrNode;
     args.forEach((arg) => {
       let child = null;
       if (arg instanceof Node) {
         child = arg;
-      } else if (is(String, arg) || is(Number, arg)) {
-        child = document.createTextNode(arg);
-      } else if (is(Array, arg)) {
+      } else if (isArray(arg)) {
         child = h(...arg);
-      } else if (arg != null) {
+      } else if (isRecord(arg)) {
         for (const name in arg) {
           const value = arg[name];
           if (name[0] === "$") {
             const name1 = name.slice(1);
-            if (is(Object, value)) {
+            if (isRecord(value)) {
               node[name1] = node[name1] ?? {};
               Object.assign(node[name1], value);
             } else {
@@ -108,7 +109,7 @@ var _h = (namespaceURI) => {
                 } else if (value === false) {
                   node.removeAttributeNS(ns, basename);
                 } else {
-                  node.setAttributeNS(ns, basename, is(String, value) ? value : "" + value);
+                  node.setAttributeNS(ns, basename, value);
                 }
               }
             } else {
@@ -117,11 +118,13 @@ var _h = (namespaceURI) => {
               } else if (value === false) {
                 node.removeAttribute(name);
               } else {
-                node.setAttribute(name, is(String, value) ? value : "" + value);
+                node.setAttribute(name, "" + value);
               }
             }
           }
         }
+      } else if (arg != null) {
+        child = document.createTextNode(arg);
       }
       if (child != null) {
         node.appendChild(child);
@@ -170,7 +173,7 @@ var fixTypography = (node) => {
 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)) {
+  if (isRecord(value)) {
     let isSecondKey = false;
     for (key in value) {
       if (isSecondKey) {
@@ -180,18 +183,12 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
     }
     const handler = handlers[key];
     const params = value[key];
-    if (handler instanceof Function && is(Array, params)) {
+    if (handler instanceof Function && isArray(params)) {
       return handler(...params);
     }
   }
   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 = [];
@@ -247,9 +244,11 @@ export {
   omit,
   nanolightJs,
   nanolight,
-  locale,
   jsOnParse,
-  is,
+  isString,
+  isRecord,
+  isNumber,
+  isArray,
   hasOwn,
   h,
   fixTypography,

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "Jackens",
   "description": "Jackens’ JavaScript helpers.",
-  "homepage": "https://jackens.github.io/nnn/doc/",
+  "homepage": "https://jackens.github.io/doc/",
   "keywords": [
     "c",
     "CSS-in-JS",
@@ -15,17 +15,18 @@
     "HyperScript",
     "in",
     "is",
+    "isArray",
+    "isNumber",
+    "isRecord",
+    "isString",
     "JS-to-CSS",
     "JSON",
     "jsOnParse",
-    "locale",
-    "localization",
     "nanolight",
     "nnn",
     "omit",
     "pick",
     "SVG",
-    "translation",
     "typography",
     "uuid",
     "uuid1",
@@ -36,5 +37,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.2.4"
+  "version": "2025.4.29"
 }

package/readme.md

@@ -2,14 +2,6 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.2.4</code></sub>
-
-* [Documentation](https://jackens.github.io/nnn/doc/)
-* [Tests](https://jackens.github.io/nnn/test/)
-* [Chessboard Demo](https://jackens.github.io/nnn/chessboard/)
-* [Gantt Chart Demo](https://jackens.github.io/nnn/gantt/)
-* [Responsive Web Design Demo](https://jackens.github.io/nnn/rwd/)
-
 ## Installation
 
 ```sh
@@ -34,12 +26,6 @@ or
 import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 ```
 
-or
-
-```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.4/nnn.js'
-```
-
 ## Exports
 
 - `CNode`: The type of arguments of the `c` helper.
@@ -54,9 +40,11 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.4/nnn.js'
 - `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`).
 - `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.
+- `isArray`: A helper that checks if the given argument is of type `any[]`.
+- `isNumber`: A helper that checks if the given argument is of type `number`.
+- `isRecord`: A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
+- `isString`: A helper that checks if the given argument is of type `string`.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
-- `locale`: Language translations helper.
 - `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
 - `nanolightJs`: A helper for highlighting JavaScript (see also `nanolight`).
 - `omit`: A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
@@ -127,7 +115,7 @@ The `root` parameter provides a hierarchical description of CSS rules.
 
 #### Usage Examples
 
-```js
+```ts
 const actual = c({
   a: {
     color: 'red',
@@ -153,7 +141,7 @@ a{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   a: {
     '.b': {
@@ -181,7 +169,7 @@ a.b{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '@font-face$$1': {
     fontFamily: 'Jackens',
@@ -256,7 +244,7 @@ div.c2{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   a: {
     '.b,.c': {
@@ -279,7 +267,7 @@ a.b.d,a.c.d{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '.b,.c': {
     margin: 1,
@@ -300,7 +288,7 @@ const expected = `
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '.a,.b': {
     margin: 1,
@@ -347,7 +335,7 @@ Options:
 
 #### Usage Examples
 
-```js
+```ts
 const text = `"aaa
 ""aaa""
 aaa",bbb, "ccc,ccc"
@@ -383,14 +371,14 @@ A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings
 
 #### Usage Examples
 
-```js
-const /** @type {EscapeMap} */ escapeMap = new Map([
+```ts
+const escapeMap: EscapeMap = new Map([
   [undefined, () => 'NULL'],
-  [Array, (/** @type {Partial<Array<unknown>>} */ values) => escapeValues(escapeMap, values).join(', ')],
-  [Boolean, (/** @type {boolean} */ value) => `b'${+value}'`],
-  [Date, (/** @type {Date} */ value) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
-  [Number, (/** @type {number} */ value) => `${value}`],
-  [String, (/** @type {string} */ value) => `'${value.replace(/'/g, "''")}'`]
+  [Array, (values: Partial<Array<unknown>>) => escapeValues(escapeMap, values).join(', ')],
+  [Boolean, (value: boolean) => `b'${+value}'`],
+  [Date, (value: Date) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
+  [Number, (value: number) => `${value}`],
+  [String, (value: string) => `'${value.replace(/'/g, "''")}'`]
 ])
 
 const sql = escape.bind(null, escapeMap)
@@ -426,7 +414,7 @@ A helper that implements typographic corrections specific to Polish typography.
 
 #### Usage Examples
 
-```js
+```ts
 const p = h('p', 'Pchnąć w tę łódź jeża lub ośm skrzyń fig (zob. https://pl.wikipedia.org/wiki/Pangram).')
 
 fixTypography(p)
@@ -458,7 +446,7 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 
 #### Usage Examples
 
-```js
+```ts
 const b = h('b')
 
 expect(b.outerHTML).to.deep.equal('<b></b>')
@@ -476,12 +464,12 @@ expect(i.outerHTML).to.deep.equal('<i class="some class">text</i>')
 expect(b.outerHTML).to.deep.equal('<b><i class="some class">text</i></b>')
 ```
 
-```js
+```ts
 expect(h('span', 'text').outerHTML).to.deep.equal('<span>text</span>')
 expect(h('span', { $innerText: 'text' }).outerHTML).to.deep.equal('<span>text</span>')
 ```
 
-```js
+```ts
 expect(h('div', { style: 'margin:0;padding:0' }).outerHTML)
   .to.deep.equal('<div style="margin:0;padding:0"></div>')
 expect(h('div', { $style: 'margin:0;padding:0' }).outerHTML)
@@ -490,7 +478,7 @@ expect(h('div', { $style: { margin: 0, padding: 0 } }).outerHTML)
   .to.deep.equal('<div style="margin: 0px; padding: 0px;"></div>')
 ```
 
-```js
+```ts
 const input1 = h('input', { value: 42 })
 const input2 = h('input', { $value: '42' })
 
@@ -510,7 +498,7 @@ expect(checkbox1.outerHTML).to.deep.equal('<input type="checkbox" checked="">')
 expect(checkbox2.outerHTML).to.deep.equal('<input type="checkbox">')
 ```
 
-```js
+```ts
 const div = h('div')
 
 expect(div.key).to.be.undefined
@@ -534,7 +522,7 @@ A replacement for the `in` operator (not to be confused with the `for-in` loop)
 
 #### Usage Examples
 
-```js
+```ts
 const obj = { 42: null, null: 'k,e,y', 'k,e,y': 42 }
 
 expect(42 in obj).to.be.true
@@ -565,86 +553,38 @@ expect(() => 'key' in undefined).to.throw
 expect(hasOwn(undefined, 'key')).to.be.false
 ```
 
-### is
+### isArray
 
 ```ts
-const is: {
-    (type: ArrayConstructor, arg: unknown): arg is Partial<Array<unknown>>;
-    (type: BigIntConstructor, arg: unknown): arg is bigint;
-    (type: BooleanConstructor, arg: unknown): arg is boolean;
-    (type: NumberConstructor, arg: unknown): arg is number;
-    (type: ObjectConstructor, arg: unknown): arg is Partial<Record<PropertyKey, unknown>>;
-    (type: StringConstructor, arg: unknown): arg is string;
-    (type: SymbolConstructor, arg: unknown): arg is symbol;
-    (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>;
-};
+const isArray: (arg: any) => arg is any[];
 ```
 
-A helper that checks if the given argument is of a certain type.
+A helper that checks if the given argument is of type `any[]`.
 
-#### Usage Examples
+### isNumber
 
-```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
-expect(is(Date, new Date(42))).to.be.true
-expect(is(Set, new Set(['42', 42]))).to.be.true
-expect(is(Map, new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]))).to.be.true
+```ts
+const isNumber: (arg: any) => arg is number;
 ```
 
-```js
-const iz = (/** @type {unknown} */ type, /** @type {unknown} */ arg) =>
-  ({}).toString.call(arg).slice(8, -1) === type?.name
-
-class FooBar { }
-
-expect(is(FooBar, new FooBar())).to.be.true
-expect(iz(FooBar, new FooBar())).to.be.false
-
-expect(is(Object, new FooBar())).to.be.false
-expect(iz(Object, new FooBar())).to.be.true
-
-const fakeFooBar = {}
-
-fakeFooBar[Symbol.toStringTag] = FooBar.name
+A helper that checks if the given argument is of type `number`.
 
-expect(is(FooBar, fakeFooBar)).to.be.false
-expect(iz(FooBar, fakeFooBar)).to.be.true
+### isRecord
 
-expect(is(Object, fakeFooBar)).to.be.true
-expect(iz(Object, fakeFooBar)).to.be.false
+```ts
+const isRecord: (arg: any) => arg is Partial<Record<PropertyKey, unknown>>;
 ```
 
-```js
-const num = 42
-const str = '42'
-
-expect(is(Number, num)).to.be.true
+A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
 
-try {
-  num.constructor = str.constructor
-} catch { /* empty */ }
+### isString
 
-expect(is(Number, num)).to.be.true
+```ts
+const isString: (arg: any) => arg is string;
 ```
 
+A helper that checks if the given argument is of type `string`.
+
 ### jsOnParse
 
 ```ts
@@ -667,9 +607,9 @@ handlers['«handlerName»'](...«params»)
 
 #### Usage Examples
 
-```js
+```ts
 const handlers = {
-  $hello: (/** @type {string} */ name) => `Hello ${name}!`,
+  $hello: (name: string) => `Hello ${name}!`,
   $foo: () => 'bar'
 }
 
@@ -712,36 +652,6 @@ const expected = [
 expect(actual).to.deep.equal(expected)
 ```
 
-### locale
-
-```ts
-const locale: (map: Partial<Record<PropertyKey, Partial<Record<PropertyKey, string>>>>, defaultVersion: string) => (text: string, version?: string) => string;
-```
-
-Language translations helper.
-
-#### Usage Examples
-
-```js
-const _ = locale({
-  default: { Password: 'Hasło' },
-  button: { Login: 'Zaloguj' }
-}, 'default')
-
-expect(_('Login')).to.deep.equal('Login')
-expect(_('Password')).to.deep.equal('Hasło')
-
-expect(_('Undefined text')).to.deep.equal('Undefined text')
-
-expect(_('Login', 'button')).to.deep.equal('Zaloguj')
-
-expect(_('Password', 'undefined_version')).to.deep.equal('Hasło')
-expect(_('Undefined text', 'undefined_version')).to.deep.equal('Undefined text')
-
-expect(_('toString')).to.deep.equal('toString')
-expect(_('toString', 'undefined_version')).to.deep.equal('toString')
-```
-
 ### nanolight
 
 ```ts
@@ -760,7 +670,7 @@ A helper for highlighting JavaScript (see also `nanolight`).
 
 #### Usage Examples
 
-```js
+```ts
 const codeJs = 'const answerToLifeTheUniverseAndEverything = 42'
 
 expect(nanolightJs(codeJs)).to.deep.equal([
@@ -784,7 +694,7 @@ A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
 
 #### Usage Examples
 
-```js
+```ts
 const obj = { a: 42, b: '42', c: 17 }
 
 expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
@@ -800,7 +710,7 @@ A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
 
 #### Usage Examples
 
-```js
+```ts
 const obj = { a: 42, b: '42', c: 17 }
 
 expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
@@ -816,7 +726,7 @@ A helper for choosing the correct singular and plural.
 
 #### Usage Examples
 
-```js
+```ts
 const auto = plUral.bind(null, 'auto', 'auta', 'aut')
 
 expect(auto(0)).to.deep.equal('aut')
@@ -843,7 +753,7 @@ object.
 
 #### Usage Examples
 
-```js
+```ts
 const ref = {}
 
 pro(ref).one.two[3][4] = 1234
@@ -911,7 +821,7 @@ A helper that generates a UUID v1 identifier (with a creation timestamp).
 
 #### Usage Examples
 
-```js
+```ts
 for (let i = 1; i <= 22136; ++i) {
   const uuid = uuid1()
 
@@ -925,12 +835,12 @@ for (let i = 1; i <= 22136; ++i) {
 }
 ```
 
-```js
+```ts
 expect(uuid1(new Date(), '000123456789abc').split('-')[4]).to.deep.equal('123456789abc')
 expect(uuid1(new Date(), '123456789').split('-')[4]).to.deep.equal('000123456789')
 ```
 
-```js
+```ts
 expect(uuid1(new Date(323325000000)).startsWith('c1399400-9a71-11bd')).to.be.true
 ```