@jackens/nnn 2025.3.5 → 2025.4.29

package/nnn.d.ts

@@ -136,10 +136,6 @@ export declare const isString: (arg: any) => arg is string;
  * ```
  */
 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

@@ -189,12 +189,6 @@ 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 isString(textV) ? textV : isString(textD) ? textD : text;
-};
 // src/nnn/nanolight.ts
 var nanolight = (pattern, highlighters, code) => {
   const result = [];
@@ -250,7 +244,6 @@ export {
   omit,
   nanolightJs,
   nanolight,
-  locale,
   jsOnParse,
   isString,
   isRecord,

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.3.5"
+  "version": "2025.4.29"
 }

package/readme.md

@@ -2,14 +2,6 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.3.5</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.3.5/nnn.js'
-```
-
 ## Exports
 
 - `CNode`: The type of arguments of the `c` helper.
@@ -59,7 +45,6 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.3.5/nnn.js'
 - `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`).
@@ -130,7 +115,7 @@ The `root` parameter provides a hierarchical description of CSS rules.
 
 #### Usage Examples
 
-```js
+```ts
 const actual = c({
   a: {
     color: 'red',
@@ -156,7 +141,7 @@ a{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   a: {
     '.b': {
@@ -184,7 +169,7 @@ a.b{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '@font-face$$1': {
     fontFamily: 'Jackens',
@@ -259,7 +244,7 @@ div.c2{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   a: {
     '.b,.c': {
@@ -282,7 +267,7 @@ a.b.d,a.c.d{
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '.b,.c': {
     margin: 1,
@@ -303,7 +288,7 @@ const expected = `
 expect(actual).to.deep.equal(expected)
 ```
 
-```js
+```ts
 const actual = c({
   '.a,.b': {
     margin: 1,
@@ -350,7 +335,7 @@ Options:
 
 #### Usage Examples
 
-```js
+```ts
 const text = `"aaa
 ""aaa""
 aaa",bbb, "ccc,ccc"
@@ -386,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)
@@ -429,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)
@@ -461,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>')
@@ -479,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)
@@ -493,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' })
 
@@ -513,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
@@ -537,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
@@ -622,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'
 }
 
@@ -667,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
@@ -715,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([
@@ -739,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' })
@@ -755,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' })
@@ -771,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')
@@ -798,7 +753,7 @@ object.
 
 #### Usage Examples
 
-```js
+```ts
 const ref = {}
 
 pro(ref).one.two[3][4] = 1234
@@ -866,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()
 
@@ -880,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
 ```