utilitas 1992.4.21 → 1992.4.23

package/index.mjs

@@ -5,6 +5,7 @@ import * as uuid from 'uuid';
 // features
 import _ from './lib/horizon.mjs'
 import * as bot from './lib/bot.mjs';
+import * as boxes from './lib/boxes.mjs';
 import * as cache from './lib/cache.mjs';
 import * as callosum from './lib/callosum.mjs';
 import * as dbio from './lib/dbio.mjs';
@@ -32,15 +33,15 @@ export {
     // dependencies
     fileType, math, uuid,
     // features
-    bot, cache, callosum, color, dbio, email, encryption, event, hal, manifest,
-    network, sentinel, shekel, shell, shot, sms, speech, storage, tape, uoid,
-    utilitas,
+    bot, boxes, cache, callosum, color, dbio, email, encryption, event, hal,
+    manifest, network, sentinel, shekel, shell, shot, sms, speech, storage,
+    tape, uoid, utilitas,
 };
 
 if (utilitas.inBrowser() && !globalThis.utilitas) {
     globalThis.utilitas = {
-        color, encryption, event, manifest, math, shekel, shot, storage, uoid,
-        utilitas, uuid,
+        boxes, color, encryption, event, manifest, math, shekel, shot, storage,
+        uoid, utilitas, uuid,
     };
     // top-level await workaround
     (async () => {

package/lib/boxes.mjs

@@ -0,0 +1,102 @@
+// Based on: https://github.com/sindresorhus/cli-boxes
+// Repackaged to ESM by: @Leask
+
+const single = {
+    "topLeft": "┌",
+    "top": "─",
+    "topRight": "┐",
+    "right": "│",
+    "bottomRight": "┘",
+    "bottom": "─",
+    "bottomLeft": "└",
+    "left": "│"
+};
+
+const double = {
+    "topLeft": "╔",
+    "top": "═",
+    "topRight": "╗",
+    "right": "║",
+    "bottomRight": "╝",
+    "bottom": "═",
+    "bottomLeft": "╚",
+    "left": "║"
+};
+
+const round = {
+    "topLeft": "╭",
+    "top": "─",
+    "topRight": "╮",
+    "right": "│",
+    "bottomRight": "╯",
+    "bottom": "─",
+    "bottomLeft": "╰",
+    "left": "│"
+};
+
+const bold = {
+    "topLeft": "┏",
+    "top": "━",
+    "topRight": "┓",
+    "right": "┃",
+    "bottomRight": "┛",
+    "bottom": "━",
+    "bottomLeft": "┗",
+    "left": "┃"
+};
+
+const singleDouble = {
+    "topLeft": "╓",
+    "top": "─",
+    "topRight": "╖",
+    "right": "║",
+    "bottomRight": "╜",
+    "bottom": "─",
+    "bottomLeft": "╙",
+    "left": "║"
+};
+
+const doubleSingle = {
+    "topLeft": "╒",
+    "top": "═",
+    "topRight": "╕",
+    "right": "│",
+    "bottomRight": "╛",
+    "bottom": "═",
+    "bottomLeft": "╘",
+    "left": "│"
+};
+
+const classic = {
+    "topLeft": "+",
+    "top": "-",
+    "topRight": "+",
+    "right": "|",
+    "bottomRight": "+",
+    "bottom": "-",
+    "bottomLeft": "+",
+    "left": "|"
+};
+
+const arrow = {
+    "topLeft": "↘",
+    "top": "↓",
+    "topRight": "↙",
+    "right": "←",
+    "bottomRight": "↖",
+    "bottom": "↑",
+    "bottomLeft": "↗",
+    "left": "→"
+};
+
+export default round;
+export {
+    single,
+    double,
+    round,
+    bold,
+    singleDouble,
+    doubleSingle,
+    classic,
+    arrow,
+};

package/lib/manifest.mjs

@@ -1,7 +1,7 @@
 const manifest = {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1992.4.21",
+    "version": "1992.4.23",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",
@@ -23,8 +23,8 @@ const manifest = {
     "devDependencies": {
         "@google-cloud/speech": "^5.4.0",
         "@google-cloud/text-to-speech": "^4.2.1",
-        "@sentry/node": "^7.43.0",
-        "@waylaidwanderer/chatgpt-api": "^1.30.0",
+        "@sentry/node": "^7.45.0",
+        "@waylaidwanderer/chatgpt-api": "^1.32.8",
         "browserify-fs": "^1.0.0",
         "buffer": "^6.0.3",
         "fast-geoip": "^1.1.88",
@@ -37,7 +37,7 @@ const manifest = {
         "ping": "^0.4.4",
         "telegraf": "^4.12.2",
         "telesignsdk": "^2.2.3",
-        "twilio": "^4.8.0",
+        "twilio": "^4.9.0",
         "url": "github:Leask/node-url",
         "webpack-cli": "^5.0.1"
     }

package/lib/utilitas.mjs

@@ -3,6 +3,7 @@ import { basename as _basename, dirname, join, sep } from 'path';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'util';
 import { validate as verifyUuid } from 'uuid';
+import * as boxes from './boxes.mjs';
 import color from './color.mjs';
 
 const call = (f, ...a) => promisify(Array.isArray(f) ? f[0].bind(f[1]) : f)(...a);
@@ -38,6 +39,7 @@ const resolve = async (resp) => resp instanceof Promise ? await resp : resp;
 const assembleApiUrl = (hst, path, args) => assembleUrl(`${hst}/${path}`, args);
 const encode = (any, isBuf, e) => (isBuf ? any : Buffer.from(any)).toString(e);
 const shiftTime = (dif, base) => new Date((base ?? new Date()).getTime() + dif);
+const ensureLines = (any, op) => Array.isArray(any) ? any : lineSplit(any, op);
 const modules = {};
 
 const __ = (url, r) => {
@@ -309,8 +311,13 @@ const log = (content, filename, options) => {
     return console.info.apply(null, args);
 };
 
+const locate = async (rootPack) => {
+    await assertPath(rootPack, 'F', 'R');
+    return globalThis._manifest = rootPack;
+};
+
 const which = async (any) => { // @todo: need more precise way to detect by @Leask
-    if (!Object.isObject(any)) {
+    if (!Object.isObject(any = any || globalThis._manifest)) {
         any = any || import.meta.url;
         any = any.startsWith('file://') ? fileURLToPath(any) : any;
         if (!any?.endsWith?.('.json')) {
@@ -451,7 +458,7 @@ const lineSplit = (string, options) => {
 
 const renderCode = (code, options) => {
     let i = 0;
-    const arrCode = Array.isArray(code) ? code : lineSplit(code);
+    const arrCode = ensureLines(code);
     const bits = String(arrCode.length).length;
     const s = options?.separator ?? '|';
     const resp = arrCode.map(
@@ -461,7 +468,7 @@ const renderCode = (code, options) => {
 };
 
 const renderText = (text, options) => {
-    const [arrText, code, result] = [lineSplit(text), [], []];
+    const [arrText, code, result] = [ensureLines(text), [], []];
     arrText.map(line => {
         const codeBlock = /^```/.test(line);
         if (codeBlock && !code.length) { // start code block
@@ -479,7 +486,42 @@ const renderText = (text, options) => {
             result.push(line);
         }
     });
-    return result.join('\n');
+    return options?.asArray ? result : result.join('\n');
+};
+
+const renderBox = (content, options) => {
+    const [minWidth, defWidth, maxWidth, output, style] = [
+        10, 80, process?.stdout?.columns || 1024, [],
+        boxes[options?.style || 'round']
+    ];
+    let [width, title] = [~~options?.width, options?.title || ''];
+    assert((content = toString(content)).length, 'Content must not be empty.');
+    assert(style, `Style must be one of ${Object.keys(boxes).join(', ')}.`);
+    assert(
+        !width || (width >= minWidth && width <= maxWidth),
+        `Width must be between $ and ${maxWidth}.`
+    );
+    const innWidth = (width || (width = defWidth)) - 2;
+    const cntWidth = innWidth - 2;
+    const pushContent = cnt => output.push(
+        [style.left, cnt.padEnd(cntWidth, ' '), style.right].join(' ')
+    );
+    title.length > cntWidth && (title = `${title.slice(0, cntWidth - 3)}...`);
+    title.length && (title = ` ${title} `);
+    output.push(style.topLeft + title + style.top.repeat(
+        innWidth - title.length
+    ) + style.topRight);
+    title.length && pushContent(' ');
+    ensureLines(content).map(line => {
+        while (line.length) {
+            pushContent(line.slice(0, cntWidth));
+            line = line.slice(cntWidth);
+        }
+    });
+    output.push(
+        style.bottomLeft + style.bottom.repeat(innWidth) + style.bottomRight
+    );
+    return options?.asArray ? output : output.join('\n');
 };
 
 const range = (from, to, options) => {
@@ -641,6 +683,7 @@ export {
     ensureArray,
     ensureDate,
     ensureInt,
+    ensureLines,
     ensureString,
     exclude,
     extError,
@@ -671,6 +714,7 @@ export {
     isSet,
     isUndefined,
     lineSplit,
+    locate,
     log,
     makeStringByLength,
     mapKeys,
@@ -685,6 +729,7 @@ export {
     prettyJson,
     purgeEmoji,
     range,
+    renderBox,
     renderCode,
     renderText,
     resolve,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1992.4.21",
+    "version": "1992.4.23",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",
@@ -34,8 +34,8 @@
     "devDependencies": {
         "@google-cloud/speech": "^5.4.0",
         "@google-cloud/text-to-speech": "^4.2.1",
-        "@sentry/node": "^7.43.0",
-        "@waylaidwanderer/chatgpt-api": "^1.30.0",
+        "@sentry/node": "^7.45.0",
+        "@waylaidwanderer/chatgpt-api": "^1.32.8",
         "browserify-fs": "^1.0.0",
         "buffer": "^6.0.3",
         "fast-geoip": "^1.1.88",
@@ -48,7 +48,7 @@
         "ping": "^0.4.4",
         "telegraf": "^4.12.2",
         "telesignsdk": "^2.2.3",
-        "twilio": "^4.8.0",
+        "twilio": "^4.9.0",
         "url": "github:Leask/node-url",
         "webpack-cli": "^5.0.1"
     }