js-dev-tool 1.2.12 → 1.2.15

package/extras/json-minify.d.ts

@@ -13,4 +13,17 @@ export type TScannerFunction = (source: string, offset: number, out: TJsonSource
  * @returns {string}
  * @version 2.0
  */
-export function jsonMinify(source: string): string;
+export function jsonMinify(source: string): string;
+/**
+ * Parse JSON or JSONL text into an array of top-level JSON values.
+ *
+ * - A single top-level value is returned as a one-element array.
+ * - Multiple top-level values separated by whitespace are returned in order.
+ * - Whitespace-only input returns an empty array.
+ *
+ * @template {unknown} T
+ * @param {string} source
+ * @returns {T[]}
+ * @since 2026/04/10 19:51:10
+ */
+export function parseJsonl<T extends unknown>(source: string): T[];

package/extras/json-minify.js

@@ -9,45 +9,30 @@
 /**
  * @file extras/json-minify.js
  * @version 2.3 2026/04/06 16:11:36
+ * @version 2.4 2026/04/08 08:31:11 - expand `sjv` to v25x
  */
-const ccMap = require("./cc-map");
+const { ECC_MAP } = require("ts-cc-map");
 /**
  * @typedef {{ src: string }} TJsonSourceEnvelop
  * @typedef {[ open: number, close: number ]} TBlacketPairCode
  */
 /** @type {TBlacketPairCode} */
-const array = [ ccMap.LEFT_BRACKET, ccMap.RIGHT_BRACKET];
+const array = [ECC_MAP.LEFT_BRACKET, ECC_MAP.RIGHT_BRACKET];
 /** @type {TBlacketPairCode} */
-const object = [ ccMap.LEFT_BRACE, ccMap.RIGHT_BRACE];
+const object = [ECC_MAP.LEFT_BRACE, ECC_MAP.RIGHT_BRACE];
 /**
  * ### (O)thers (M)ap
  *
  * @type {(0 | 1)[]} 
  */
 const om = Array(127).fill(0);
-om[ccMap.DOUBLE_QUOTE] = 1;
-om[ccMap.COMMA] = 1;
-om[ccMap.COLON] = 1;
-om[ccMap.LEFT_BRACKET] = 1;
-om[ccMap.RIGHT_BRACKET] = 1;
-om[ccMap.LEFT_BRACE] = 1;
-om[ccMap.RIGHT_BRACE] = 1;
-/**
- * @typedef {(source: string, offset: number, out: TJsonSourceEnvelop) => number} TScannerFunction
- */
-/**
- * ### (O)thers (M)ap
- *
- * @type {TScannerFunction[]} 
- */
-const scanners = Array(127).fill(0);
-scanners[ccMap.DOUBLE_QUOTE] = (source, offset, out) => {
-  const next = sqs(source, offset);
-  out.src += source.slice(offset, next);
-  return next;
-};
-scanners[ccMap.LEFT_BRACKET] = sjoCode;
-scanners[ccMap.LEFT_BRACE] = sjoCode;
+om[ECC_MAP.DOUBLE_QUOTE] = 1;
+om[ECC_MAP.COMMA] = 1;
+om[ECC_MAP.COLON] = 1;
+om[ECC_MAP.LEFT_BRACKET] = 1;
+om[ECC_MAP.RIGHT_BRACKET] = 1;
+om[ECC_MAP.LEFT_BRACE] = 1;
+om[ECC_MAP.RIGHT_BRACE] = 1;
 /**
  * @param {string} message
  * @param {number} offset
@@ -87,51 +72,23 @@ function v25x(source) {
       }
       out.src += "\n";
     }
-    offset = sjv(source, next, out);
-    count++;
-  }
-  return out.src;
-}
-/**
- * Minify JSON or JSONL text by removing JSON whitespace outside double-quoted strings.
- *
- * - A single top-level value is returned as minified JSON.
- * - Multiple top-level values are returned as minified JSONL separated by `"\n"`.
- *
- * @param {string} source
- * @returns {string}
- * @version 2.0
- */
-function v24x(source) {
-  if (typeof source !== "string") {
-    throw new TypeError("jsonMinify(source): source must be a string");
-  }
-  /** @type {TJsonSourceEnvelop} */
-  const out = { src: "" };
-  const sourceLen = source.length;
-  const scans = scanners;
-  let offset = 0;
-  let count = 0;
-  while (true) {
-    const next = skipWhitespaces(source, offset);
-    if (next >= sourceLen) {
-      break;
-    }
-    if (count > 0) {
-      if (next === offset) {
-        throwJsonSyntaxError("Missing whitespace between top-level JSON values", next);
+    switch (source.charCodeAt(next)) {
+      case ECC_MAP.DOUBLE_QUOTE: {
+        const skiped = sqs(source, next);
+        out.src += source.slice(next, skiped);
+        offset = skiped;
+        break;
+      }
+      case ECC_MAP.LEFT_BRACKET:
+      case ECC_MAP.LEFT_BRACE:
+        offset = sjoCode(source, next, out);
+        break;
+      default: {
+        const skiped = skipOthers(source, next);
+        out.src += source.slice(next, skiped);
+        offset = skiped;
+        break;
       }
-      out.src += "\n";
-    }
-    const scanner = scans[
-      source.charCodeAt(next)
-    ];
-    if (!scanner) {
-      const skiped = skipOthers(source, next);
-      out.src += source.slice(next, skiped);
-      offset = skiped;
-    } else {
-      offset = scanner(source, next, out);
     }
     count++;
   }
@@ -146,9 +103,9 @@ function v24x(source) {
  */
 function sjv(source, offset, out) {
   switch (source.charCodeAt(offset)) {
-    case ccMap.LEFT_BRACE:
-    case ccMap.LEFT_BRACKET: return sjoCode(source, offset, out);
-    case ccMap.DOUBLE_QUOTE: {
+    case ECC_MAP.LEFT_BRACE:
+    case ECC_MAP.LEFT_BRACKET: return sjoCode(source, offset, out);
+    case ECC_MAP.DOUBLE_QUOTE: {
       const next = sqs(source, offset);
       out.src += source.slice(offset, next);
       return next;
@@ -160,6 +117,7 @@ function sjv(source, offset, out) {
     }
   }
 }
+void sjv;
 /**
  * (S)can (J)son (O)bject
  * 
@@ -178,8 +136,8 @@ function sjoCode(source, offset, out) {
   const sourceLen = source.length;
   while (offset < sourceLen) {
     const code = source.charCodeAt(offset++);
-    if (code <= 32 /* ccMap.SPACE */) continue;
-    if (code === 34 /* ccMap.DOUBLE_QUOTE */) {
+    if (code <= 32 /* ECC_MAP.SPACE */) continue;
+    if (code === 34 /* ECC_MAP.DOUBLE_QUOTE */) {
       const next = sqs(source, offset - 1);
       sourceRef += source.slice(offset - 1, next);
       offset = next;
@@ -230,11 +188,11 @@ function sqs(source, offset) {
   let inEscape = false;
   while (next < srcLen) {
     const code = source.charCodeAt(next++);
-    if (code === 92 /* ccMap.BACKSLASH */) {
+    if (code === 92 /* ECC_MAP.BACKSLASH */) {
       inEscape = !inEscape;
     } else if (inEscape) {
       inEscape = false;
-    } else if (code === 34 /* ccMap.DOUBLE_QUOTE */) {
+    } else if (code === 34 /* ECC_MAP.DOUBLE_QUOTE */) {
       return next;
     }
   }
@@ -260,7 +218,70 @@ const skipWhitespaces = (source, offset) => {
   }
   return offset;
 };
-const jsonMinify = process.versions.node.slice(0, 2) <= "24" ? v24x : v25x;
+const jsonMinify = v25x;
+const jparse = JSON.parse;
+/**
+ * Parse JSON or JSONL text into an array of top-level JSON values.
+ *
+ * - A single top-level value is returned as a one-element array.
+ * - Multiple top-level values separated by whitespace are returned in order.
+ * - Whitespace-only input returns an empty array.
+ *
+ * @template {unknown} T
+ * @param {string} source
+ * @returns {T[]}
+ * @since 2026/04/10 19:51:10
+ */
+function parseJsonl(source) {
+  if (typeof source !== "string") {
+    throw new TypeError("parseJsonl(source): source must be a string");
+  }
+  /** @type {TJsonSourceEnvelop} */
+  const out = { src: "" };
+  const sourceLen = source.length;
+  let offset = 0;
+  let count = 0;
+  /** @type {T[]} */
+  const jsons = [];
+  while (true) {
+    const next = skipWhitespaces(source, offset);
+    if (next >= sourceLen) {
+      break;
+    }
+    if (count > 0) {
+      if (next === offset) {
+        throwJsonSyntaxError("Missing whitespace between top-level JSON values", next);
+      }
+      jsons.push(
+        jparse(out.src)
+      );
+      out.src = "";
+    }
+    switch (source.charCodeAt(next)) {
+      case ECC_MAP.DOUBLE_QUOTE: {
+        const skiped = sqs(source, next);
+        out.src += source.slice(next, skiped);
+        offset = skiped;
+        break;
+      }
+      case ECC_MAP.LEFT_BRACKET:
+      case ECC_MAP.LEFT_BRACE:
+        offset = sjoCode(source, next, out);
+        break;
+      default: {
+        const skiped = skipOthers(source, next);
+        out.src += source.slice(next, skiped);
+        offset = skiped;
+        break;
+      }
+    }
+    count++;
+  }
+  count && jsons.push(
+    jparse(out.src)
+  );
+  return jsons;
+}
 module.exports = {
-  jsonMinify,
+  jsonMinify, parseJsonl
 };

package/extras/jsonl.d.ts

@@ -115,9 +115,26 @@ export function readJsonlMapByKey<TRow = any, TOut = TRow>(fileName: string, opt
  */
 export function fastGetIntFieldCheap(line: string, key: string): number | undefined;
 /**
- * Minify JSON or JSONL text by removing JSON whitespace outside strings.
+ * Minify JSON or JSONL text by removing JSON whitespace outside double-quoted strings.
  *
  * - A single top-level value is returned as minified JSON.
  * - Multiple top-level values are returned as minified JSONL separated by `"\n"`.
+ *
+ * @param {string} source
+ * @returns {string}
+ * @version 2.0
+ */
+export function jsonMinify(source: string): string;
+/**
+ * Parse JSON or JSONL text into an array of top-level JSON values.
+ *
+ * - A single top-level value is returned as a one-element array.
+ * - Multiple top-level values separated by whitespace are returned in order.
+ * - Whitespace-only input returns an empty array.
+ *
+ * @template {unknown} T
+ * @param {string} source
+ * @returns {T[]}
+ * @since 2026/04/10 19:51:10
  */
-export function jsonMinify(source: string): string;
+export function parseJsonl<T extends unknown>(source: string): T[];

package/extras/jsonl.js

@@ -11,7 +11,7 @@
  */
 const fs = require("fs");
 const path = require("path");
-const { jsonMinify } = require("./json-minify.js");
+const { jsonMinify, parseJsonl } = require("./json-minify.js");
 /**
  * @import { TJsonlReadOption, TJsonlReadBaseOption } from "./jsonl.js";
  */
@@ -202,5 +202,5 @@ module.exports = {
   readJsonlArray,
   readJsonlMapByKey,
   fastGetIntFieldCheap,
-  jsonMinify,
+  jsonMinify, parseJsonl
 };

package/extras/toggle-jsonl.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+"use strict";
+/**
+ * @file extras/toggle-jsonl.js
+ * @command tgl-jsonl [-un] <jsonl path> <jsonl path>
+ * @command node extras/toggle-jsonl.js
+ */
+const tinArgs = require("tin-args");
+const utils = require("../utils.js");
+const { parseJsonl } = require("./json-minify.js");
+const reset = "\x1b[0m";
+const green = "\x1b[32m";
+const yellow = "\x1b[33m";
+const blue = "\x1b[34m";
+const orange = "\x1b[38;5;208m";
+/**
+ * @typedef TToggleJsonArgs
+ * @prop {true=} un un format jsonl file
+ */
+/** @type {tinArgs.TTinArgsReturnType<TToggleJsonArgs>} */
+const args = tinArgs();
+const files = args.args;
+if (files) {
+  const needFormat = !args.un;
+  for (const file of files) {
+    utils.log(`${blue}[toggle-jsonl]${reset}: convert to ${yellow}${needFormat ? "" : "un-"}formatted jsonl${reset} - ${green}${file}${reset}`);
+    let jsonlSource = "";
+    const source = utils.readText(file);
+    /** @type {Record<string, any>[]} */
+    const jsonArray = parseJsonl(source);
+    if (needFormat) {
+      for (const json of jsonArray) {
+        jsonlSource += utils.formatedStringify(json) + "\n";
+      }
+    } else {
+      for (const json of jsonArray) {
+        jsonlSource += JSON.stringify(json) + "\n";
+      }
+    }
+    utils.writeText(jsonlSource, file);
+  }
+} else {
+  utils.log(
+    `${orange}Please specify the path to the JSONL file to process...${reset}` +
+    `
+
+Usage: ${yellow}tgl-jsonl${reset} [-un] <jsonl path> <jsonl path>
+
+  about: options
+    -un: convert to "un-formatted jsonl", if not spcedified then will be formatted jsonl source
+`
+  );
+}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.12",
+  "version": "1.2.15",
   "bin": {
-    "jstool": "tools.js"
+    "jstool": "tools.js",
+    "tgl-jsonl": "extras/toggle-jsonl.js"
   },
   "types": "./index.d.ts",
   "main": "./index.js",
@@ -76,7 +77,7 @@
     "!regex-test.ts",
     "!extras/npm",
     "!/**/*.png",
-    "!*@*.js",
+    "!*@*.*",
     "!*fragments*",
     "!tool.sh"
   ],
@@ -91,7 +92,8 @@
     "mini-semaphore": "^1.5.4",
     "replace": "^1.2.2",
     "rm-cstyle-cmts": "^3.4.4",
-    "terser": "^5.46.0",
-    "tin-args": "^0.1.4"
+    "terser": "^5.46.1",
+    "tin-args": "^0.1.5",
+    "ts-cc-map": "^1.1.0"
   }
 }