@cto.af/utils 1.3.0 → 1.3.2

package/lib/index.d.ts

@@ -52,18 +52,26 @@ declare function nameSet<T extends object>(defaults: T): Set<keyof T>;
  * Useful for validating inputs to select.
  *
  * @param sets Sets to check.
+ * @throws If sets are the wrong type.
  */
-declare function assertDisjoint(...sets: Set<string>[]): void;
+declare function assertDisjoint(...sets: (Set<string> | string[] | object)[]): void;
+type Selector<T> = Partial<T> | (keyof T)[] | Set<keyof T>;
 /**
  * Select some properties from an object into multiple other objects.
+ * All unselected fields will be contained in a final object for the
+ * "leftovers", meaning there will always be at least one element in the
+ * result array.  If the first selector is a set of defaults, the type from
+ * that object will be copied to the first element of the result array.
  *
  * @template T Composed options object.
+ * @template U May be a Required<Partial<T>> type.
  * @param obj The source object.
+ * @param defaults Defaults object or field names.
  * @param args Arrays of strings to select into the result
  *   objects.
  * @returns {Partial<Record<keyof T, any>>[]} One object for each of args,
  *   plus an extra one for everything that was left over.
  */
-declare function select<T extends object>(obj: T, ...args: ((keyof T)[] | Set<keyof T>)[]): Partial<T>[];
+declare function select<T extends object, U extends Selector<T>>(obj: T, defaults?: U, ...args: Selector<T>[]): [U extends Partial<T> ? U : Partial<T>, ...Partial<T>[]];
 
-export { type CiOptions, type PromiseWithResolvers, assertDisjoint, errCode, isCI, isErrno, nameSet, promiseWithResolvers, select };
+export { type CiOptions, type PromiseWithResolvers, type Selector, assertDisjoint, errCode, isCI, isErrno, nameSet, promiseWithResolvers, select };

package/lib/index.js

@@ -1 +1 @@
-import u from"assert/strict";function T(e){return e instanceof Error&&Object.prototype.hasOwnProperty.call(e,"code")}function m(e,o){if(!T(e))return!1;switch(typeof o){case"string":return e.code===o;case"number":return e.errno===o}throw new TypeError(`Invalid code: ${JSON.stringify(o)}`)}function v(e){if(e&&"CI"in e)return!!e.CI;let{env:o}=process;return!!(o.CI||o.CONTINUOUS_INTEGRATION||o.BUILD_NUMBER||o.RUN_ID)}var f=()=>{};function y(){let e=f,o=f;return{promise:new Promise((t,s)=>{e=t,o=s}),resolve:e,reject:o}}function d(e){return new Set(Object.keys(e))}function k(...e){let o=new Set;for(let r of e)for(let t of r)u(!o.has(t)),o.add(t)}function O(e,...o){let r=o.map(()=>Object.create(null)),t=Object.create(null);if(r.push(t),!e)return r;let s=o.map(n=>n instanceof Set?n:new Set(n));for(let[n,a]of Object.entries(e)){let i=!1;s.forEach((c,l)=>{!i&&c.has(n)&&(i=!0,r[l][n]=a)}),i||(t[n]=a)}return r}export{k as assertDisjoint,m as errCode,v as isCI,T as isErrno,d as nameSet,y as promiseWithResolvers,O as select};
+import u from"assert/strict";function p(e){return e instanceof Error&&Object.prototype.hasOwnProperty.call(e,"code")}function v(e,t){if(!p(e))return!1;switch(typeof t){case"string":return e.code===t;case"number":return e.errno===t}throw new TypeError(`Invalid code: ${JSON.stringify(t)}`)}function P(e){if(e&&"CI"in e)return!!e.CI;let{env:t}=process;return!!(t.CI||t.CONTINUOUS_INTEGRATION||t.BUILD_NUMBER||t.RUN_ID)}var l=()=>{};function b(){let e=l,t=l;return{promise:new Promise((n,s)=>{e=n,t=s}),resolve:e,reject:t}}function y(e){return new Set(Object.keys(e))}function k(...e){let t=new Set;for(let o of e){let n=null;if(Array.isArray(o))n=o;else if(o instanceof Set)n=o;else if(typeof o=="object"&&o)n=Object.keys(o);else throw new Error("Invalid set");for(let s of n)u(!t.has(s)),t.add(s)}}function m(e,t,...o){t!==void 0&&o.unshift(t);let n=[],s=o.map(r=>{let i=Object.create(null);if(r instanceof Set)return n.push(r),i;if(Array.isArray(r))return n.push(new Set(r)),i;if(!r||typeof r!="object")throw new Error(`Invalid set: ${r}`);return n.push(y(r)),Object.assign(i,r)}),f=Object.create(null);if(s.push(f),!e)return s;for(let[r,i]of Object.entries(e)){let a=!1;n.forEach((c,T)=>{!a&&c.has(r)&&(a=!0,s[T][r]=i)}),a||(f[r]=i)}return s}export{k as assertDisjoint,v as errCode,P as isCI,p as isErrno,y as nameSet,b as promiseWithResolvers,m as select};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cto.af/utils",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "decription": "",
   "main": "lib/index.js",
   "files": [