ctx-core 2.2.1 → 2.3.0

package/all/debounce/index.js

@@ -1,4 +1,4 @@
-import { isPromise } from '../isPromise/index.js'
+import { isPromiseLike } from '../isPromiseLike/index.js'
 /**
  * Returns an async function, that, as long as it continues to be invoked, will not
  * be triggered. The function will be called after it stops being called for
@@ -35,7 +35,7 @@ export function debounce(func, wait, immediate) {
 		async function invoke() {
 			try {
 				const in_rv = func.apply(apply_this, arg_a)
-				resolve(isPromise(in_rv) ? await in_rv : in_rv)
+				resolve(isPromiseLike(in_rv) ? await in_rv : in_rv)
 			} catch (e) {
 				reject(e)
 			}

package/all/index.d.ts

@@ -188,7 +188,8 @@ export * from './isNumber/index.js'
 export * from './isNumber_andor/index.js'
 export * from './isNumber_or/index.js'
 export * from './isObject/index.js'
-export * from './isPromise/index.js'
+export * from './isPrimitive/index.js'
+export * from './isPromiseLike/index.js'
 export * from './item_r_idx/index.js'
 export * from './key_compare/index.js'
 export * from './key_r/index.js'
@@ -222,6 +223,7 @@ export * from './matrix__validate_length/index.js'
 export * from './maybe/index.js'
 export * from './mean/index.js'
 export * from './median/index.js'
+export * from './memo/index.js'
 export * from './merge/index.js'
 export * from './minute/index.js'
 export * from './minute/index.js'
@@ -291,6 +293,7 @@ export * from './prev_idx/index.js'
 export * from './promise/index.js'
 export * from './promise_o/index.js'
 export * from './promise_timeout/index.js'
+export * from './prototype/index.js'
 export * from './prototype_mixin/index.js'
 export * from './push/index.js'
 export * from './quantile/index.js'

package/all/index.js

@@ -188,7 +188,8 @@ export * from './isNumber/index.js'
 export * from './isNumber_andor/index.js'
 export * from './isNumber_or/index.js'
 export * from './isObject/index.js'
-export * from './isPromise/index.js'
+export * from './isPrimitive/index.js'
+export * from './isPromiseLike/index.js'
 export * from './item_r_idx/index.js'
 export * from './key_compare/index.js'
 export * from './key_r/index.js'
@@ -222,6 +223,7 @@ export * from './matrix__validate_length/index.js'
 export * from './maybe/index.js'
 export * from './mean/index.js'
 export * from './median/index.js'
+export * from './memo/index.js'
 export * from './merge/index.js'
 export * from './minute/index.js'
 export * from './minute/index.js'
@@ -291,6 +293,7 @@ export * from './prev_idx/index.js'
 export * from './promise/index.js'
 export * from './promise_o/index.js'
 export * from './promise_timeout/index.js'
+export * from './prototype/index.js'
 export * from './prototype_mixin/index.js'
 export * from './push/index.js'
 export * from './quantile/index.js'

package/all/intersection_set/index.js

@@ -13,7 +13,7 @@ export function intersection_set_(member_a_nowrap_a_nowrap) {
 		const rest_a_nowrap = rest_a_nowrap_a[i]
 		const rest_a = wrap_a_(rest_a_nowrap)
 		const current_set = new Set(rest_a)
-		member_set.forEach((member)=>{
+		member_set.forEach(member=>{
 			if (!current_set.has(member)) member_set.delete(member)
 		})
 	}

package/all/isPrimitive/index.d.ts

@@ -0,0 +1 @@
+export declare function isPrimitive(v:unknown):boolean

package/all/isPrimitive/index.js

@@ -0,0 +1,6 @@
+export function isPrimitive(val) {
+	return (
+		val === null
+		|| (typeof val !== 'object' && typeof val !== 'function')
+	)
+}

package/all/isPrimitive/index.test.ts

@@ -0,0 +1,17 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { isPrimitive } from './index.js'
+test('isPrimitive', ()=>{
+	equal(isPrimitive(1), true)
+	equal(isPrimitive('foo'), true)
+	equal(isPrimitive(null), true)
+	equal(isPrimitive(undefined), true)
+	equal(isPrimitive(true), true)
+	equal(isPrimitive(false), true)
+	equal(isPrimitive(Symbol('foo')), true)
+	equal(isPrimitive({}), false)
+	equal(isPrimitive([]), false)
+	equal(isPrimitive(()=>1), false)
+	equal(isPrimitive(new Date), false)
+})
+test.run()

package/all/isPromiseLike/index.d.ts

@@ -0,0 +1,4 @@
+export declare function isPromiseLike(val:any):boolean
+export {
+	isPromiseLike as isPromise,
+}

package/all/{isPromise → isPromiseLike}/index.js

@@ -2,6 +2,9 @@
  * @param {unknown}val
  * @returns {boolean}
  */
-export function isPromise(val) {
+export function isPromiseLike(val) {
 	return val ? typeof val.then === 'function' : false
 }
+export {
+	isPromiseLike as isPromise,
+}

package/all/memo/index.d.ts

@@ -0,0 +1,6 @@
+export declare function memo_<
+	ret_T,
+	arg_a_T extends Array<unknown>,
+>(fn:(...arg_a:arg_a_T)=>ret_T):((...arg_a:arg_a_T)=>ret_T)&{
+	clear():void
+}

package/all/memo/index.js

@@ -0,0 +1,61 @@
+import { isPrimitive } from '../isPrimitive/index.js'
+import { prototype_ } from '../prototype/index.js'
+let empty_sym, WeakRef_proto
+/**
+ * @param {(...arg_a:any[])=>any}fn
+ * @returns A memo caching arguments & return values. Arguments that are Objects are cached with a WeakRef.
+ * @private
+ */
+export function memo_(fn) {
+	let m = new Map
+	let wm = new WeakMap
+	if (!empty_sym) {
+		empty_sym = Symbol('E')
+		WeakRef_proto = WeakRef.prototype
+	}
+	let memo = (...arg_a)=>{
+		if (!arg_a.length) {
+			if (!m.has(empty_sym)) {
+				m.set(empty_sym, fn())
+			}
+			return m.get(empty_sym)
+		}
+		let arg0 = arg_a[0]
+		let map = isPrimitive(arg0) ? m : wm
+		/** @type {[unknown[], unknown][]} */
+		let cache__arg_a_T_ret__a = map.get(arg0)
+		if (!cache__arg_a_T_ret__a) {
+			cache__arg_a_T_ret__a = []
+			map.set(arg0, cache__arg_a_T_ret__a)
+		}
+		cache__arg_a_T_ret__a:for (let cache__arg_a_T_ret__a__i = cache__arg_a_T_ret__a.length; cache__arg_a_T_ret__a__i--;) {
+			let cache__arg_a_T_ret = cache__arg_a_T_ret__a[cache__arg_a_T_ret__a__i]
+			let cache__arg_a = cache__arg_a_T_ret[0]
+			let { length } = arg_a
+			if (cache__arg_a.length !== length) continue
+			for (let arg_a__i = length; arg_a__i--;) {
+				let cache__arg_val = cache__arg_a[arg_a__i]
+				if (prototype_(cache__arg_val) === WeakRef_proto) {
+					cache__arg_val = cache__arg_val.deref()
+					if (!cache__arg_val) { // cleanup cache__arg_a when arg is GC
+						cache__arg_a_T_ret__a.splice(cache__arg_a_T_ret__a__i, 1)
+						continue cache__arg_a_T_ret__a
+					}
+				}
+				let arg_val = arg_a[arg_a__i]
+				if (arg_val !== cache__arg_val) break
+				if (!arg_a__i) { // arguments match
+					return cache__arg_a_T_ret[1]
+				}
+			}
+		}
+		let ret = fn(...arg_a)
+		cache__arg_a_T_ret__a.push([arg_a.map(arg=>isPrimitive(arg) ? arg : new WeakRef(arg)), ret])
+		return ret
+	}
+	memo.clear = ()=>{
+		m.clear()
+		wm = new WeakMap
+	}
+	return memo
+}

package/all/memo/index.test.ts

@@ -0,0 +1,75 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { memo_ } from './index.js'
+test('memo_|empty', ()=>{
+	let call_count = 0
+	let fn = ()=>{
+		call_count++
+		return 'memo-return'
+	}
+	let memo = memo_(fn)
+	equal(call_count, 0)
+	equal(memo(), 'memo-return')
+	equal(call_count, 1)
+	equal(memo(), 'memo-return')
+	equal(call_count, 1)
+})
+test('memo_|primitive arguments', ()=>{
+	let call_count = 0
+	let fn = (arg0:number, arg1:number)=>{
+		call_count++
+		return arg0 + arg1
+	}
+	let memo = memo_(fn)
+	equal(call_count, 0)
+	equal(memo(1, 2), 3)
+	equal(call_count, 1)
+	equal(memo(1, 2), 3)
+	equal(call_count, 1)
+	equal(memo(1, 3), 4)
+	equal(call_count, 2)
+	memo.clear()
+	equal(memo(1, 2), 3)
+	equal(call_count, 3)
+})
+test('memo_|primitive|with objects', ()=>{
+	let call_count = 0
+	let fn = (arg0:number, arg1:object)=>{
+		call_count++
+		return { ...arg1, arg0 }
+	}
+	let memo = memo_(fn)
+	let arg1 = { arg1: true }
+	let arg1_2 = { arg1_2: true }
+	equal(call_count, 0)
+	equal(memo(1, arg1), { arg1: true, arg0: 1 })
+	equal(call_count, 1)
+	equal(memo(1, arg1), { arg1: true, arg0: 1 })
+	equal(call_count, 1)
+	equal(memo(1, arg1_2), { arg1_2: true, arg0: 1 })
+	equal(call_count, 2)
+	memo.clear()
+	equal(memo(1, arg1), { arg1: true, arg0: 1 })
+	equal(call_count, 3)
+})
+test('memo_|objects|with primitives', ()=>{
+	let call_count = 0
+	let fn = (arg0:object, arg1:number)=>{
+		call_count++
+		return { ...arg0, arg1 }
+	}
+	let memo = memo_(fn)
+	let arg0 = { arg0: true }
+	let arg0_2 = { arg0_2: true }
+	equal(call_count, 0)
+	equal(memo(arg0, 1), { arg0: true, arg1: 1 })
+	equal(call_count, 1)
+	equal(memo(arg0, 1), { arg0: true, arg1: 1 })
+	equal(call_count, 1)
+	equal(memo(arg0_2, 1), { arg0_2: true, arg1: 1 })
+	equal(call_count, 2)
+	memo.clear()
+	equal(memo(arg0, 1), { arg0: true, arg1: 1 })
+	equal(call_count, 3)
+})
+test.run()

package/all/prototype/index.d.ts

@@ -0,0 +1,2 @@
+import type { nullish } from '../nullish/index.js'
+export declare function prototype_(val:Exclude<any, nullish>):Object

package/all/prototype/index.js

@@ -0,0 +1,8 @@
+/**
+ * @param {Object}val
+ * @returns {Object}
+ * @private
+ */
+export function prototype_(val) {
+  return Object.getPrototypeOf(val)
+}

package/all/prototype/index.test.ts

@@ -0,0 +1,14 @@
+import { test } from 'uvu'
+import { is, not } from 'uvu/assert'
+import { prototype_ } from './index.js'
+test('prototype_', ()=>{
+	is(prototype_({}), Object.prototype)
+	is(prototype_(new WeakRef({})), WeakRef.prototype)
+	is(prototype_(1), Number.prototype)
+	is(prototype_(true), Boolean.prototype)
+	is(prototype_(false), Boolean.prototype)
+	not.equal(prototype_(new Date), Boolean.prototype)
+	not.equal(prototype_({}), Boolean.prototype)
+	not.equal(prototype_(1), Boolean.prototype)
+})
+test.run()

package/all/rememo/index.d.ts

@@ -0,0 +1,8 @@
+export declare function rememo_<val_T>(def:()=>val_T):rememo_T<val_T>
+export type rememo_T<val_T> =
+	((rememo:rememo_T<val>)=>val_T)
+	&rememo_o_T<val_T>
+export type rememo_o_T<val_T> = {
+	val:val_T
+	listeners:Set<WeakRef<rememo_T<val_T>>>
+}

package/all/rememo/index.js

@@ -0,0 +1,9 @@
+/** @typedef {import('./index.d.ts').rememo_o_T} */
+/**
+ * @param {(rememo:rememo_T<unknown>)=>unknown}fn
+ * @returns {rememo_T}
+ * @private
+ */
+export function rememo_(fn) {
+	// let
+}

package/function/index.d.ts

@@ -36,7 +36,7 @@ export * from '../all/ifelse/index.js'
 export * from '../all/iife/index.js'
 export * from '../all/invert/index.js'
 export * from '../all/isArray/index.js'
-export * from '../all/isPromise/index.js'
+export * from '../all/isPromiseLike/index.js'
 export * from '../all/left_and/index.js'
 export * from '../all/left_or/index.js'
 export * from '../all/many_andand/index.js'
@@ -45,6 +45,7 @@ export * from '../all/map_apply/index.js'
 export * from '../all/map_call/index.js'
 export * from '../all/map_fn/index.js'
 export * from '../all/maybe/index.js'
+export * from '../all/memo/index.js'
 export * from '../all/neq/index.js'
 export * from '../all/neql/index.js'
 export * from '../all/nf/index.js'

package/function/index.js

@@ -36,7 +36,7 @@ export * from '../all/ifelse/index.js'
 export * from '../all/iife/index.js'
 export * from '../all/invert/index.js'
 export * from '../all/isArray/index.js'
-export * from '../all/isPromise/index.js'
+export * from '../all/isPromiseLike/index.js'
 export * from '../all/left_and/index.js'
 export * from '../all/left_or/index.js'
 export * from '../all/many_andand/index.js'
@@ -45,6 +45,7 @@ export * from '../all/map_apply/index.js'
 export * from '../all/map_call/index.js'
 export * from '../all/map_fn/index.js'
 export * from '../all/maybe/index.js'
+export * from '../all/memo/index.js'
 export * from '../all/neq/index.js'
 export * from '../all/neql/index.js'
 export * from '../all/nf/index.js'

package/index.js

@@ -0,0 +1,2 @@
+console.warn(`import a designated export from ctx-core; import {...} from "ctx-core/all" if you all of ctx-core`)
+export {}

package/object/index.d.ts

@@ -40,6 +40,7 @@ export * from '../all/or_null/index.js'
 export * from '../all/pick/index.js'
 export * from '../all/pick_keys/index.js'
 export * from '../all/pick_val_a/index.js'
+export * from '../all/prototype/index.js'
 export * from '../all/rc_be/index.js'
 export * from '../all/rc_be_/index.js'
 export * from '../all/toString/index.js'

package/object/index.js

@@ -39,6 +39,7 @@ export * from '../all/or_null/index.js'
 export * from '../all/pick/index.js'
 export * from '../all/pick_keys/index.js'
 export * from '../all/pick_val_a/index.js'
+export * from '../all/prototype/index.js'
 export * from '../all/rc_be/index.js'
 export * from '../all/rc_be_/index.js'
 export * from '../all/toString/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -23,6 +23,7 @@
   "type": "module",
   "files": [
     "*.d.ts",
+    "*.js",
     "*.json",
     "all",
     "array",
@@ -52,6 +53,7 @@
     "queue",
     "random",
     "regex",
+    "rememo",
     "set",
     "sleep",
     "string",
@@ -103,6 +105,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.13.1",
+    "@types/node": "^20.9.0",
     "@types/sinon": "^17.0.1",
     "c8": "^8.0.1",
     "check-dts": "^0.7.2",

package/rememo/index.d.ts

@@ -0,0 +1 @@
+export * from '../all/rememo/index.js'

package/rememo/index.js

@@ -0,0 +1 @@
+export * from '../all/rememo/index.js'

package/tsconfig.json

@@ -5,7 +5,10 @@
 		"moduleResolution": "nodenext",
 		"target": "ESNext",
 		"strict": true,
-		"skipLibCheck": true
-	},
-	"exclude": ["node_modules"]
+		"skipLibCheck": true,
+		"lib": ["ESNext"],
+		"types": [
+			"node"
+		]
+	}
 }

package/all/isPromise/index.d.ts

@@ -1 +0,0 @@
-export declare function isPromise(obj:any):boolean