@gershy/clearing 0.0.29 → 0.0.31

package/cmp/cjs/main.d.ts

@@ -1,30 +1,3 @@
 import '../sideEffects.js';
-type ClsCheck = {
-    (i: unknown, num: BooleanConstructor): i is boolean;
-    (i: unknown, num: NumberConstructor): i is number;
-    (i: unknown, str: StringConstructor): i is string;
-    (i: unknown, buff: Buffer): i is Buffer;
-    (i: unknown, arr: ArrayConstructor): i is any[];
-    (i: unknown, obj: ObjectConstructor): i is Obj<unknown>;
-    (i: unknown, fn: FunctionConstructor): i is Fn;
-    (i: unknown, fn: SymbolConstructor): i is symbol;
-    <T>(i: unknown, prm: PromiseConstructor): i is Promise<T>;
-    <C extends abstract new (...args: any) => any>(i: unknown, cls: C): i is InstanceType<C>;
-};
-export declare const getClsName: (i: any) => any;
-export declare const getCls: (i: any) => any;
-export declare const isCls: ClsCheck;
-export declare const inCls: ClsCheck;
-export declare const skip: undefined;
-type Then = {
-    <V, R0 = V, R1 = never>(val: Promise<V>, rsv?: (v: V) => R0, rjc?: (e: any) => R1): Promise<R0 | R1>;
-    <V, R0 = V, R1 = never>(val: V, rsv?: (v: V) => R0, rjc?: (e: any) => R1): R0 | R1;
-};
-export declare const then: Then;
-type Safe = {
-    <V, R0 = never>(fn: () => Promise<V>, rjc?: (e: any) => R0): Promise<V | R0>;
-    <V, R0 = never>(fn: () => V, rjc?: (e: any) => R0): Promise<V | R0>;
-};
-export declare const safe: Safe;
 declare const applyClearing: () => void;
 export default applyClearing;

package/cmp/cjs/main.js

@@ -1,67 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safe = exports.then = exports.skip = exports.inCls = exports.isCls = exports.getCls = exports.getClsName = void 0;
-const getClsName = i => {
-    if (i === null)
-        return 'Null';
-    if (i === undefined)
-        return 'Undef';
-    if (i !== i)
-        return 'Nan';
-    return Object.getPrototypeOf(i)?.constructor.name ?? 'Prototypeless';
-};
-exports.getClsName = getClsName;
-const getCls = i => Object.getPrototypeOf(i)?.constructor ?? null;
-exports.getCls = getCls;
-const isCls = (i, C) => {
-    // NaN only matches against the NaN primitive (not the Number Form)
-    if (i !== i)
-        return C !== C;
-    // `null` and `undefined` only match to themselves
-    if (i == null)
-        return i === C;
-    // Otherwise strictly check the constructor
-    return Object.getPrototypeOf(i).constructor === C;
-};
-exports.isCls = isCls;
-const inCls = (i, C) => i instanceof C;
-exports.inCls = inCls;
-exports.skip = undefined;
-const then = (val, rsv = (v => v), rjc = ((e) => { throw e; })) => {
-    // Act on `val` regardless of whether it's a Promise or immediate value; return `rsv(val)`
-    // either immediately or as a Promise
-    if ((0, exports.inCls)(val, Promise))
-        return val.then(rsv).catch(rjc);
-    try {
-        return rsv(val);
-    }
-    catch (err) {
-        return rjc(err);
-    }
-};
-exports.then = then;
-const safe = (fn, rjc = e => { throw e; }) => {
-    // Execute a function which returns a value either synchronously or asynchronously; in both cases
-    // allows errors occurring from function execution to be handled
-    try {
-        return (0, exports.then)(fn(), v => v, rjc);
-    }
-    catch (err) {
-        return rjc(err);
-    }
-};
-exports.safe = safe;
 const applyClearing = (() => {
-    const global = globalThis;
     // Prevent multiple installations...
-    const pfx = '@gershy/clearing';
-    const memSym = Symbol.for(`${pfx}:mem`);
-    if (global[memSym])
+    const global = globalThis;
+    if (global[Symbol.for(`@gershy/clearing:mem`)])
         return;
-    global[memSym] = true;
-    const [enc, dec] = [new TextEncoder(), new TextDecoder()];
+    global[Symbol.for(`@gershy/clearing:mem`)] = true;
+    const getClsName = i => {
+        if (i === null)
+            return 'Null';
+        if (i === undefined)
+            return 'Undef';
+        if (i !== i)
+            return 'Nan';
+        return Object.getPrototypeOf(i)?.constructor.name ?? 'Prototypeless';
+    };
+    const getCls = i => Object.getPrototypeOf(i)?.constructor ?? null;
+    const isCls = (i, C) => {
+        // NaN only matches against the NaN primitive (not the Number Form)
+        if (i !== i)
+            return C !== C;
+        // `null` and `undefined` only match to themselves
+        if (i == null)
+            return i === C;
+        // Otherwise strictly check the constructor
+        return Object.getPrototypeOf(i).constructor === C;
+    };
+    const inCls = (i, C) => i instanceof C;
+    const skip = undefined;
+    const then = (val, rsv = (v => v), rjc = ((e) => { throw e; })) => {
+        // Act on `val` regardless of whether it's a Promise or immediate value; return `rsv(val)`
+        // either immediately or as a Promise
+        if (inCls(val, Promise))
+            return val.then(rsv).catch(rjc);
+        try {
+            return rsv(val);
+        }
+        catch (err) {
+            return rjc(err);
+        }
+    };
+    const safe = (fn, rjc = e => { throw e; }) => {
+        // Execute a function which returns a value either synchronously or asynchronously; in both cases
+        // allows errors occurring from function execution to be handled
+        try {
+            return then(fn(), v => v, rjc);
+        }
+        catch (err) {
+            return rjc(err);
+        }
+    };
     const symNames = [
-        // <SYMBOLS> :: definitions :: /[']([a-zA-Z0-9]+)[']/
+        // <SYMBOLS> :: runtimeNames :: /[']([a-zA-Z0-9]+)[']/
         'add',
         'allArr',
         'allObj',
@@ -73,13 +63,11 @@ const applyClearing = (() => {
         'base64Std',
         'base64Url',
         'baseline',
-        'bind',
         'char',
         'charset',
         'code',
         'count',
         'cut',
-        'dive',
         'empty',
         'find',
         'fire',
@@ -109,27 +97,80 @@ const applyClearing = (() => {
         'toNum',
         'toObj',
         'toStr',
-        'upper'
+        'upper',
+        'walk'
         // </SYMBOLS>
     ];
-    const syms = Object.fromEntries(symNames.map(term => [term, Symbol(`${pfx}:${term}`)]));
-    Object.assign(global, { ...syms });
+    const cl = {
+        getClsName, getCls, isCls, inCls, then, safe, skip,
+        ...Object.fromEntries(symNames.map(term => [term, Symbol(`@gershy/clearing:${term}`)]))
+    };
+    Object.assign(global, { cl, clearing: cl });
+    // <SYMBOLS> :: runtimeRefs :: /^[ ]*const[ ]([a-zA-Z0-9]+)[:]/
+    const add = clearing.add;
+    const allArr = clearing.allArr;
+    const allObj = clearing.allObj;
+    const at = clearing.at;
+    const assert = clearing.assert;
+    const base32 = clearing.base32;
+    const base36 = clearing.base36;
+    const base62 = clearing.base62;
+    const base64Std = clearing.base64Std;
+    const base64Url = clearing.base64Url;
+    const baseline = clearing.baseline;
+    const char = clearing.char;
+    const charset = clearing.charset;
+    const code = clearing.code;
+    const count = clearing.count;
+    const cut = clearing.cut;
+    const empty = clearing.empty;
+    const find = clearing.find;
+    const fire = clearing.fire;
+    const group = clearing.group;
+    const has = clearing.has;
+    const hasHead = clearing.hasHead;
+    const hasTail = clearing.hasTail;
+    const indent = clearing.indent;
+    const int32 = clearing.int32;
+    const int64 = clearing.int64;
+    const isInt = clearing.isInt;
+    const later = clearing.later;
+    const limn = clearing.limn;
+    const lower = clearing.lower;
+    const map = clearing.map;
+    const mapk = clearing.mapk;
+    const merge = clearing.merge;
+    const mod = clearing.mod;
+    const padHead = clearing.padHead;
+    const padTail = clearing.padTail;
+    const rem = clearing.rem;
+    const slash = clearing.slash;
+    const slice = clearing.slice;
+    const suppress = clearing.suppress;
+    const toArr = clearing.toArr;
+    const toBin = clearing.toBin;
+    const toNum = clearing.toNum;
+    const toObj = clearing.toObj;
+    const toStr = clearing.toStr;
+    const upper = clearing.upper;
+    const walk = clearing.walk;
+    // </SYMBOLS>
     const assignSyms = (Cls, def) => {
         const protoVals = [];
-        for (const key of Reflect.ownKeys(def)) {
-            if (!(0, exports.isCls)(key, Symbol))
-                throw Object.assign(Error('invalid proto key'), { Cls, keyClsName: (0, exports.getClsName)(key), key });
-            protoVals.push([key, def[key]]);
-        }
+        for (const key of Reflect.ownKeys(def))
+            if (!isCls(key, Symbol))
+                throw Object.assign(Error('invalid proto key'), { Cls, keyClsName: getClsName(key), key });
+            else
+                protoVals.push([key, def[key]]);
         // Assign class properties
         for (const [sym, value] of protoVals)
             Object.defineProperty(Cls, sym, { enumerable: false, value });
     };
     assignSyms(Object, {});
     assignSyms(Object.prototype, {
-        [at](cmps, def = exports.skip) {
+        [at](cmps, def = skip) {
             let ptr = this;
-            if (!(0, exports.isCls)(cmps, Array))
+            if (!isCls(cmps, Array))
                 cmps = [cmps];
             for (const c of cmps) {
                 if (ptr[has](c))
@@ -151,9 +192,9 @@ const applyClearing = (() => {
             //  });
             //  >> { small: { a: 1, b: 2, c: 3 }, medium: { d: 4, e: 5, f: 6, g: 7 }, big: { h: 8, i: 9, j: 10 } }
             const ret = {};
-            for (const [k, v] of this) {
+            for (const [k, v] of this[walk]()) {
                 const g = fn(v, k);
-                if (g === exports.skip)
+                if (g === skip)
                     continue;
                 if (!ret[has](g))
                     ret[g] = {};
@@ -166,7 +207,7 @@ const applyClearing = (() => {
             const ret = Object.assign({}, this);
             for (const k in ret) {
                 const v = fn(ret[k], k);
-                if (v !== exports.skip)
+                if (v !== skip)
                     ret[k] = v;
                 else
                     delete ret[k];
@@ -177,25 +218,25 @@ const applyClearing = (() => {
             const arr = [];
             for (const k in this) {
                 const r = fn(this[k], k);
-                if (r !== exports.skip)
+                if (r !== skip)
                     arr.push(r);
             }
             return Object.fromEntries(arr);
         },
-        [merge](o) {
-            for (const [k, v] of o) {
+        [merge](obj) {
+            for (const [k, v] of obj[walk]()) {
                 // `skip` can be passed to remove properties
-                if (v === exports.skip) {
+                if (v === skip) {
                     delete this[k];
                     continue;
                 }
                 // Incoming non-Object properties are simple
-                if (!(0, exports.isCls)(v, Object)) {
+                if (!isCls(v, Object)) {
                     this[k] = v;
                     continue;
                 }
                 // `v` is an Object; existing non-Object replaced with `{}`
-                if (!this[has](k) || !(0, exports.isCls)(this[k], Object))
+                if (!this[has](k) || !isCls(this[k], Object))
                     this[k] = {};
                 // And simply recurse!
                 this[k][merge](v);
@@ -211,18 +252,18 @@ const applyClearing = (() => {
         [slice](p) {
             // >> { a: 1, b: 2, c: 3, d: 4 }.slice([ 'b', 'd' ]);
             // { b: 2, d: 4 }
-            return p[toObj](p => this[has](p) ? [p, this[p]] : exports.skip);
+            return p[toObj](p => this[has](p) ? [p, this[p]] : skip);
         },
         [toArr](fn) {
             const ret = [];
             for (const k in this) {
                 const r = fn(this[k], k);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return ret;
         },
-        *[Symbol.iterator]() { for (const k in this)
+        *[walk]() { for (const k in this)
             yield [k, this[k]]; }
     });
     assignSyms(Array, {});
@@ -247,7 +288,7 @@ const applyClearing = (() => {
             const ret = {};
             for (const elem of this) {
                 const g = fn(elem);
-                if (g === exports.skip)
+                if (g === skip)
                     continue;
                 if (!ret[has](g))
                     ret[g] = [];
@@ -261,7 +302,7 @@ const applyClearing = (() => {
             const len = this.length;
             for (let i = 0; i < len; i++) {
                 const r = it(this[i], i);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return ret;
@@ -273,18 +314,19 @@ const applyClearing = (() => {
             const len = this.length;
             for (let i = 0; i < len; i++) {
                 const r = it(this[i], i);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return Object.fromEntries(ret);
         }
     });
+    const [enc, dec] = [new TextEncoder(), new TextDecoder()];
     assignSyms(String, {
         [baseline]: (str, seq = '| ') => {
             return str.split('\n')[map](ln => {
                 const ind = ln.indexOf(seq);
                 if (ind === -1)
-                    return exports.skip;
+                    return skip;
                 return ln.slice(ind + seq.length);
             }).join('\n');
         },
@@ -320,7 +362,7 @@ const applyClearing = (() => {
         [count]() { return this.length; },
         [cut](delim, cuts = 1) {
             // `cuts` defines # of cuts (resulting array length is `num + 1`)
-            const split = this.split(delim, cuts < Infinity ? cuts : exports.skip);
+            const split = this.split(delim, cuts < Infinity ? cuts : skip);
             const numDelimsSplit = split.length - 1;
             const lenConsumed = 0
                 + split.reduce((a, s) => a + s.length, 0)
@@ -336,7 +378,7 @@ const applyClearing = (() => {
             if (!this)
                 return this; // No-op on empty String (otherwise it would transform a 0-line string to a 1-line string)
             let indentStr;
-            if ((0, exports.isCls)(args[0], String)) {
+            if (isCls(args[0], String)) {
                 indentStr = args[0];
             }
             else {
@@ -350,7 +392,7 @@ const applyClearing = (() => {
         [padTail]: String.prototype.padEnd,
         [toBin]() { return enc.encode(this); },
         [toNum](cs = String[base62]) {
-            if ((0, exports.isCls)(cs, String))
+            if (isCls(cs, String))
                 cs = String[charset](cs);
             const base = cs.size;
             if (base === 1n)
@@ -375,7 +417,7 @@ const applyClearing = (() => {
             const ret = [];
             for (let i = 0; i < this; i++) {
                 const r = fn(i);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return Object.fromEntries(ret);
@@ -388,7 +430,7 @@ const applyClearing = (() => {
             //      |       singleChr.repeat(n - 1)
             if (this !== this)
                 throw Error('nan');
-            if ((0, exports.isCls)(cs, String))
+            if (isCls(cs, String))
                 cs = String[charset](cs);
             const base = cs.size;
             if (base === 1n && padLen)
@@ -423,6 +465,11 @@ const applyClearing = (() => {
         [toStr]() { return dec.decode(this); },
         [toNum]() { return (new Uint8Array(this))[toNum](); }
     });
+    assignSyms(SharedArrayBuffer, {});
+    assignSyms(SharedArrayBuffer.prototype, {
+        [toStr]() { return dec.decode(new Uint8Array(this)); },
+        [toNum]() { return (new Uint8Array(this))[toNum](); }
+    });
     assignSyms(Uint8Array, {});
     assignSyms(Uint8Array.prototype, {
         [toStr]() { return dec.decode(this); },
@@ -455,17 +502,17 @@ const applyClearing = (() => {
             seen.set(this, 'cycle(Error)');
             const { message, stack, cause, ...props } = this;
             return {
-                form: (0, exports.getClsName)(this),
+                form: getClsName(this),
                 msg: message,
-                trace: stack?.split('\n').slice(1)[map](v => v.trim() ?? exports.skip) ?? [],
+                trace: (stack ?? '<no stack>').split('\n')[map](v => v.trim() ?? skip),
                 ...props,
                 cause: !cause ? null : cause[limn](seen)
             };
         },
         [mod](props = {} /* { cause, msg, message, ...more } */) {
-            if ((0, exports.isCls)(props, Function))
+            if (isCls(props, Function))
                 props = props(this.message, this);
-            if ((0, exports.isCls)(props, String))
+            if (isCls(props, String))
                 props = { message: props };
             const { cause = null, msg = null, message = msg ?? this.message, ...moreProps } = props;
             // - Assign `cause` to transfer props like fs "code" props, etc. - watch out, `cause` may be
@@ -473,12 +520,12 @@ const applyClearing = (() => {
             // - Assign `moreProps` to transfer any other properties
             // - Add `message` prop
             // - Only add `cause` prop if `cause` is non-null
-            return Object.assign(this, (0, exports.inCls)(cause, Error) ? cause : {}, moreProps, cause ? { message, cause } : { message });
+            return Object.assign(this, inCls(cause, Error) ? cause : {}, moreProps, cause ? { message, cause } : { message });
         },
         [suppress]() {
             this[Symbol.for('@gershy.clearing.err.suppressed')] = true;
             if (this.cause) {
-                const causes = (0, exports.inCls)(this.cause, Error) ? [this.cause] : this.cause;
+                const causes = inCls(this.cause, Error) ? [this.cause] : this.cause;
                 for (const err of causes)
                     err[suppress]();
             }
@@ -486,14 +533,14 @@ const applyClearing = (() => {
         }
     });
     assignSyms(Promise, {
-        [allArr]: arr => Promise.all(arr).then(arr => arr.filter(v => v !== exports.skip)),
+        [allArr]: arr => Promise.all(arr).then(arr => arr.filter(v => v !== skip)),
         [allObj]: obj => {
             // Need to get `keys` immediately, in case `obj` mutates before resolution
             const keys = Object.keys(obj);
             return Promise.all(Object.values(obj)).then(vals => {
                 const ret = {};
                 for (const [i, k] of keys.entries())
-                    if (vals[i] !== exports.skip)
+                    if (vals[i] !== skip)
                         ret[k] = vals[i];
                 return ret;
             });
@@ -519,7 +566,7 @@ const applyClearing = (() => {
             let ind = 0;
             for (const item of this) {
                 const r = fn(item, ind++);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return ret;
@@ -530,7 +577,7 @@ const applyClearing = (() => {
             let ind = 0;
             for (const item of this) {
                 const r = fn(item, ind++);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return ret;
@@ -539,7 +586,7 @@ const applyClearing = (() => {
             const ret = [];
             for (const item of this) {
                 const r = fn(item);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return Object.fromEntries(ret);
@@ -560,7 +607,7 @@ const applyClearing = (() => {
             const ret = [];
             for (const [k, v] of this) {
                 const r = fn(v, k);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return Object.fromEntries(ret);
@@ -570,7 +617,7 @@ const applyClearing = (() => {
             const ret = [];
             for (const [k, v] of this) {
                 const r = fn(v, k);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return ret;
@@ -579,7 +626,7 @@ const applyClearing = (() => {
             const ret = [];
             for (const [k, v] of this) {
                 const r = fn(v, k);
-                if (r !== exports.skip)
+                if (r !== skip)
                     ret.push(r);
             }
             return Object.fromEntries(ret);

package/cmp/mjs/main.d.ts

@@ -1,30 +1,3 @@
 import '../sideEffects.js';
-type ClsCheck = {
-    (i: unknown, num: BooleanConstructor): i is boolean;
-    (i: unknown, num: NumberConstructor): i is number;
-    (i: unknown, str: StringConstructor): i is string;
-    (i: unknown, buff: Buffer): i is Buffer;
-    (i: unknown, arr: ArrayConstructor): i is any[];
-    (i: unknown, obj: ObjectConstructor): i is Obj<unknown>;
-    (i: unknown, fn: FunctionConstructor): i is Fn;
-    (i: unknown, fn: SymbolConstructor): i is symbol;
-    <T>(i: unknown, prm: PromiseConstructor): i is Promise<T>;
-    <C extends abstract new (...args: any) => any>(i: unknown, cls: C): i is InstanceType<C>;
-};
-export declare const getClsName: (i: any) => any;
-export declare const getCls: (i: any) => any;
-export declare const isCls: ClsCheck;
-export declare const inCls: ClsCheck;
-export declare const skip: undefined;
-type Then = {
-    <V, R0 = V, R1 = never>(val: Promise<V>, rsv?: (v: V) => R0, rjc?: (e: any) => R1): Promise<R0 | R1>;
-    <V, R0 = V, R1 = never>(val: V, rsv?: (v: V) => R0, rjc?: (e: any) => R1): R0 | R1;
-};
-export declare const then: Then;
-type Safe = {
-    <V, R0 = never>(fn: () => Promise<V>, rjc?: (e: any) => R0): Promise<V | R0>;
-    <V, R0 = never>(fn: () => V, rjc?: (e: any) => R0): Promise<V | R0>;
-};
-export declare const safe: Safe;
 declare const applyClearing: () => void;
 export default applyClearing;