@gershy/clearing 0.0.23 → 0.0.24

package/cmp/cjs/main.js

@@ -470,8 +470,8 @@ const applyClearing = (() => {
     });
     protoDefs(Promise, {
         $: {
-            [allArr]: Promise.all,
-            [allObj]: (obj) => {
+            [allArr]: arr => Promise.all(arr).then(arr => arr.filter(v => v !== exports.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 => {

package/cmp/mjs/main.js

@@ -461,8 +461,8 @@ const applyClearing = (() => {
     });
     protoDefs(Promise, {
         $: {
-            [allArr]: Promise.all,
-            [allObj]: (obj) => {
+            [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 => {

package/cmp/sideEffects.d.ts

@@ -3,6 +3,7 @@ declare global {
   // Util
   type Fn<A extends any[] = any[], T = any> = (...args: A) => T;
   type Obj<V = any> = { [k: string]: V };
+  type Arr<V = any> = V[];
   
   // Differentiate between "map" and "rec" ("record") - maps have arbitrary keys; recs have fixed keys
   type ObjMode<O extends { [K: string]: any }> = O extends { [K in infer KK]: any } ? (string extends KK ? 'map' : 'rec') : never;
@@ -138,8 +139,8 @@ declare global {
     [assert]: <V = any>(args: V, fn: (args: V) => boolean) => void
   }
   interface Error extends SymbolsProto {
-    [mod]:      (props: { [K: string]: any }) => Error,
-    [fire]:     (props?: { [K: string]: any }) => never,
+    [mod]:      (props:  string | Obj<any> | ((msg: string, err: Error) => Obj<any>)) => Error,
+    [fire]:     (props?: string | Obj<any> | ((msg: string, err: Error) => Obj<any>)) => never,
     [suppress]: () => Error,
     [limn]: (seen?: Map<any, any>) => (Obj<Json> & {
       form: string,
@@ -203,8 +204,9 @@ declare global {
   }
   
   interface PromiseConstructor {
-    [allArr]: PromiseConstructor['all'],
-    [allObj]: <O extends { [K: string]: Promise<any> }>(obj: O) => Promise<{ [K in keyof O]: Exclude<Awaited<O[K]>, Skip> }>,
+    [allArr]: <V extends Promise<any>>(arr: Arr<V>) => Promise<Arr<Exclude<Awaited<V>, Skip>>>,
+    [allObj]: <V extends Promise<any>>(obj: Obj<V>) => Promise<Obj<Exclude<Awaited<V>, Skip>>>,
+    // [allObj]: <O extends { [K: string]: Promise<any> }>(obj: O)   => Promise<{ [K in keyof O]: Exclude<Awaited<O[K]>, Skip> }>,
     [later]: <T=void>() => PromiseLater<T>
   }
   interface Promise<T> {}
@@ -230,9 +232,9 @@ declare global {
     [count]: () => number,
     [empty]: () => boolean,
     [find]: (fn: (val: V, key: K) => any) => ({ found: true, val: V, key: K } | { found: false, val: null, key: null }),
-    [map]: <T>(fn: (val: V, key: K) => Skip | readonly [string, any]) => { [Key: string]: any },
+    [map]: <T>(fn: (val: V, key: K) => Skip | readonly [string, any]) => { [K: string]: any },
     [toArr]: <T>(fn: (val: V, key: K) => T) => Exclude<T, Skip>[],
-    [toObj]: <T>(fn: (val: V, key: K) => Skip | readonly [string, any]) => { [Key: string]: any },
+    [toObj]: <R>(fn: (val: V, key: K) => Skip | readonly [string, R]) => Obj<R>,
     [rem]: (key: K) => void
   }
 

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@gershy/clearing",
-  "version": "0.0.23",
-  "versionCommit": "ccce646c1a4bc2ec3f349a1b02a8498a930c373e",
+  "version": "0.0.24",
   "description": "Adds the features you always wish javascript had!",
   "keywords": [
     "clearing",
@@ -43,5 +42,7 @@
     "git.pub": "npm run test && git add --all && git commit -m \"automated\" && git push",
     "npm.login": "npm login",
     "npm.pub": "npm run test && npm run build && npm publish --access public"
-  }
+  },
+  "peerDependencies": {},
+  "dependencies": {}
 }

package/readme.md

@@ -217,7 +217,7 @@ console.log(obj[mapk]((v, k) => [ k.toUpperCase(), v * 10 ])); // { A: 10, B: 20
 
 ### `Object.prototype[merge]`
 
-Deep merges another object into `this` (mutates in place). Use `clearing.skip` for deletion.
+Deep merges another object into `this` (mutates in place). Use `skip` global for deletion.
 
 ```ts
 
@@ -652,10 +652,20 @@ Error[assert]({ x: 10, y: 5 }, ({ x, y }) => x < y); // throws!
 Modifies an error's message and adds properties. Returns the error for chaining.
 
 ```ts
-throw Error('something failed')[mod]({ code: 'err99', context: { userId: 123 } });
+// Add context to errors:
+throw Error('oops')[mod]({ code: 'err99', context: { userId: 123 } });
 
-// Can also modify the message
-throw Error('base error')[mod]({ message: 'enhanced message', extra: 'data' });
+// Overwrite the error message by passing a string, or supplying "message" or "msg" properties:
+throw Error('oops')[mod]('new message');
+throw Error('oops')[mod]({ msg:     'new message', extra: 'data' });
+throw Error('oops')[mod]({ message: 'new message', extra: 'data' });
+
+// Pass a callback to succinctly reference the original message:
+throw Error('oops')[mod](msg => `Modified message! Original: ${msg}`);
+throw Error('oops')[mod](msg => ({
+  msg: `Modified message! Original: ${msg}`,
+  extra: 'data'
+}));
 ```
 
 ### `Error.prototype[fire]`