@jackens/nnn 2025.11.4 → 2025.11.5

package/nnn.d.ts

@@ -24,7 +24,7 @@ export declare const c: (root: CRoot, splitter?: string) => string;
  * - Each entry in `specs` is a tuple of:
  *   - `max_width`: maximum number of cells in a row (viewport width breakpoint).
  *   - `width` (optional, default: `1`): number of cells occupied by the element.
- *   - `height` (optional): number of cells in height occupied by the element.
+ *   - `height` (optional, default: `1`): number of cells in height occupied by the element.
  */
 export declare const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px: number, ...specs: [number, number?, number?][]) => void;
 /** A tiny CSV parsing helper. */

package/nnn.js

@@ -61,6 +61,7 @@ var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
   for (let [max_width, width, height] of specs) {
     const node = max_width === 1 ? main : pro(root)[`@media(min-width:${cell_width_px * max_width}px)`][selector];
     width ??= 1;
+    height ??= 1;
     let gcd = 100 * width;
     let tmp = max_width;
     while (tmp) {
@@ -68,11 +69,8 @@ var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
     }
     const w_100_per_gcd = 100 * width / gcd;
     node.width = max_width === gcd ? `${w_100_per_gcd}%` : `calc(${w_100_per_gcd}% / ${max_width / gcd})`;
-    if (height != null) {
-      node.height = `${cell_height_px * height}px`;
-    }
+    node.height = `${cell_height_px * height}px`;
   }
-  console.log(root);
 };
 var csv_parse = (csv, separator = ",") => {
   const main_pattern = /\n|(?<!")("(?:[^"]|"")*")(?!")/g;

package/package.json

@@ -38,5 +38,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.11.4"
+  "version": "2025.11.5"
 }

package/readme.md

@@ -676,8 +676,6 @@ JavaScript syntax highlighting helper (built on `nanolight`).
 ```ts
 const code_js = "const answer_to_life_the_universe_and_everything = { 42: 42 }['42'] /* 42 */"
 
-console.log(nanolight_js(code_js))
-
 expect(nanolight_js(code_js)).to.deep.equal([
   ['span', { class: 'keyword' }, 'const'],
   ' ',
@@ -805,7 +803,54 @@ A responsive‑web‑design helper that generates CSS rules for a grid layout.
 - Each entry in `specs` is a tuple of:
   - `max_width`: maximum number of cells in a row (viewport width breakpoint).
   - `width` (optional, default: `1`): number of cells occupied by the element.
-  - `height` (optional): number of cells in height occupied by the element.
+  - `height` (optional, default: `1`): number of cells in height occupied by the element.
+
+#### Usage Examples
+
+```ts
+const css: CRoot = {
+  body: {
+    margin: 0
+  },
+  '.r6': {
+    border: 'solid red 1px',
+    '.no-border': {
+      border: 'none'
+    }
+  }
+}
+
+rwd(css, '.r6', 200, 50, [6], [3], [1, 1, 2])
+
+expect(css).to.deep.equal({
+  body: {
+    margin: 0
+  },
+  '.r6': {
+    border: 'solid red 1px',
+    '.no-border': {
+      border: 'none'
+    },
+    boxSizing: 'border-box',
+    display: 'block',
+    float: 'left',
+    width: '100%',
+    height: '100px'
+  },
+  '@media(min-width:600px)': {
+    '.r6': {
+      width: 'calc(100% / 3)',
+      height: '50px'
+    }
+  },
+  '@media(min-width:1200px)': {
+    '.r6': {
+      width: 'calc(50% / 3)',
+      height: '50px'
+    }
+  }
+})
+```
 
 ### s
 
@@ -848,6 +893,51 @@ Generates a UUID v1 (time-based) identifier.
 
 - Optional `node` must match `/^[0-9a-f]*$/`; it is trimmed to the last 12 characters and left-padded with zeros.
 
+#### Usage Examples
+
+```ts
+for (let i = 1; i <= 22136; ++i) {
+  const uuid = uuid_v1()
+
+  if (i === 1) {
+    expect(uuid.split('-')[3]).to.deep.equal('8001')
+  }
+
+  if (i === 4095) {
+    expect(uuid.split('-')[3]).to.deep.equal('8fff')
+  }
+
+  if (i === 4096) {
+    expect(uuid.split('-')[3]).to.deep.equal('9000')
+  }
+
+  if (i === 9029) {
+    expect(uuid.split('-')[3]).to.deep.equal('a345')
+  }
+
+  if (i === 13398) {
+    expect(uuid.split('-')[3]).to.deep.equal('b456')
+  }
+
+  if (i === 16384) {
+    expect(uuid.split('-')[3]).to.deep.equal('8000')
+  }
+
+  if (i === 17767) {
+    expect(uuid.split('-')[3]).to.deep.equal('8567')
+  }
+}
+```
+
+```ts
+expect(uuid_v1(new Date(), '000123456789abc').split('-')[4]).to.deep.equal('123456789abc')
+expect(uuid_v1(new Date(), '123456789').split('-')[4]).to.deep.equal('000123456789')
+```
+
+```ts
+expect(uuid_v1(new Date(323325000000)).startsWith('c1399400-9a71-11bd')).to.be.true
+```
+
 ## License
 
 The MIT License (MIT)