ctx-core 4.16.0 → 4.18.0

package/all/be_/index.test.ts

@@ -27,15 +27,15 @@ test('be_|Map', ()=>{
 	const ctx = ctx__new()
 	let incrementer_num = 0
 	const incrementer = ()=>++incrementer_num
-	const root_ = be_(()=>{
-		console.debug('root_|debug|1')
-		return incrementer()
-	}, { id: 'root_' })
-	const child_ = be_(ctx=>{
-		console.debug('child_|debug|1')
-		return root_(ctx) + incrementer()
-	}, { id: 'child_' })
-	const child1_ = be_(ctx=>root_(ctx) + child_(ctx), { id: 'child1_' })
+	const root_ = be_(()=>
+		incrementer(),
+	{ id: 'root_' })
+	const child_ = be_(ctx=>
+		root_(ctx) + incrementer(),
+	{ id: 'child_' })
+	const child1_ = be_(ctx=>
+		root_(ctx) + child_(ctx),
+	{ id: 'child1_' })
 	equal(root_(ctx), 1)
 	equal(ctx.get('root_'), 1)
 	equal(child_(ctx), 3)

package/all/be_lock_memosig_triple/index.d.ts

@@ -1,13 +1,13 @@
 import type { Be, be_config_T, Ctx } from '../be_/index.js'
-import type { rmemo_val_T, sig_T } from '../rmemo/index.js'
+import type { rmemo_val_T, lock_memosig_T } from '../rmemo/index.js'
 export declare function be_lock_memosig_triple_<
 	val_T,
-	_sig_T extends sig_T<val_T> = sig_T<val_T>,
+	_sig_T extends lock_memosig_T<val_T> = lock_memosig_T<val_T>,
 	ctx_T extends Ctx = Ctx
 >(be:Be<_sig_T, ctx_T>):be_lock_memosig_triple_T<val_T, _sig_T, ctx_T>
 export declare function be_lock_memosig_triple_<
 	val_T,
-	_sig_T extends sig_T<val_T> = sig_T<val_T>,
+	_sig_T extends lock_memosig_T<val_T> = lock_memosig_T<val_T>,
 	ctx_T extends Ctx = Ctx
 >(
 	rmemo__new:(ctx:Ctx, memosig:_sig_T)=>val_T,
@@ -17,7 +17,7 @@ export declare function be_lock_memosig_triple_<
 ):be_lock_memosig_triple_T<val_T, _sig_T, ctx_T>
 export declare function globalThis__be_lock_memosig_triple_<
 	val_T,
-	_sig_T extends sig_T<val_T> = sig_T<val_T>,
+	_sig_T extends lock_memosig_T<val_T> = lock_memosig_T<val_T>,
 	ctx_T extends Ctx = Ctx
 >(
 	rmemo__new:(ctx:Ctx, memosig:_sig_T)=>val_T,
@@ -26,7 +26,7 @@ export declare function globalThis__be_lock_memosig_triple_<
 ):be_lock_memosig_triple_T<val_T, _sig_T, ctx_T>
 export type be_lock_memosig_triple_T<
 	val_T,
-	_sig_T extends sig_T<val_T> = sig_T<val_T>,
+	_sig_T extends lock_memosig_T<val_T> = lock_memosig_T<val_T>,
 	ctx_T extends Ctx = Ctx
 > = [
 	Be<_sig_T>,

package/all/be_lock_memosig_triple/index.js

@@ -7,7 +7,7 @@ import { lock_memosig_ } from '../rmemo/index.js'
 /**
  * @param {Be<sig_T>|be__val__new_T<unknown>}be_OR_val__new
  * @param {rmemo_subscriber_T[]|[...rmemo_subscriber_T[], be_config_T]}subscriber_a_THEN_config
- * @returns {be_sig_triple_T}
+ * @returns {be_lock_memosig_triple_T}
  * @private
  */
 export function be_lock_memosig_triple_(

package/all/index.d.ts

@@ -1,3 +1,13 @@
+export * from './LessThan/index.js'
+export * from './MAX_INT/index.js'
+export * from './MIN_INT/index.js'
+export * from './Map__object/index.js'
+export * from './NumericRange/index.js'
+export * from './NumericUnit/index.js'
+export * from './PHI/index.js'
+export * from './Request/index.js'
+export * from './Response/index.js'
+export * from './Timeout/index.js'
 export * from './a/index.js'
 export * from './a_assign/index.js'
 export * from './a_in_idx_a_map/index.js'
@@ -134,10 +144,10 @@ export * from './format_date_prose/index.js'
 export * from './format_utc_date_prose/index.js'
 export * from './globalThis__prop__ensure/index.js'
 export * from './gte_0_a/index.js'
+export * from './hasOwnProperty_pick/index.js'
 export * from './has_key/index.js'
 export * from './has_multiple/index.js'
 export * from './has_some_key/index.js'
-export * from './hasOwnProperty_pick/index.js'
 export * from './head_arg_a/index.js'
 export * from './headers/index.js'
 export * from './hex__digest/index.js'
@@ -191,7 +201,6 @@ export * from './keys/index.js'
 export * from './last/index.js'
 export * from './left_and/index.js'
 export * from './left_or/index.js'
-export * from './LessThan/index.js'
 export * from './lte_0_a/index.js'
 export * from './m_m_yyyy/index.js'
 export * from './m_yy/index.js'
@@ -199,7 +208,6 @@ export * from './m_yyyy/index.js'
 export * from './many_andand/index.js'
 export * from './many_andand_or/index.js'
 export * from './map/index.js'
-export * from './Map__object/index.js'
 export * from './map_andand/index.js'
 export * from './map_andand_or/index.js'
 export * from './map_andandfn/index.js'
@@ -214,12 +222,10 @@ export * from './matrix__dot/index.js'
 export * from './matrix__dot__scalar/index.js'
 export * from './matrix__normalize/index.js'
 export * from './matrix__validate_length/index.js'
-export * from './MAX_INT/index.js'
 export * from './maybe/index.js'
 export * from './mean/index.js'
 export * from './median/index.js'
 export * from './merge/index.js'
-export * from './MIN_INT/index.js'
 export * from './minute/index.js'
 export * from './minute/index.js'
 export * from './minute_seconds/index.js'
@@ -258,8 +264,6 @@ export * from './number_or_mdash_str/index.js'
 export * from './numerator_or_0_avg/index.js'
 export * from './numerator_or_0_sum/index.js'
 export * from './numeric_range/index.js'
-export * from './NumericRange/index.js'
-export * from './NumericUnit/index.js'
 export * from './o_a_present/index.js'
 export * from './o_a_present/index.js'
 export * from './o_some/index.js'
@@ -283,7 +287,6 @@ export * from './pathname/index.js'
 export * from './percentage_str/index.js'
 export * from './percentage_str_float/index.js'
 export * from './performance__now/index.js'
-export * from './PHI/index.js'
 export * from './pick/index.js'
 export * from './pick_keys/index.js'
 export * from './pick_val_a/index.js'
@@ -309,10 +312,8 @@ export * from './reduce/index.js'
 export * from './reject/index.js'
 export * from './remove/index.js'
 export * from './remove_idx/index.js'
-export * from './Request/index.js'
 export * from './resolver_curry/index.js'
 export * from './resolver_curry/index.js'
-export * from './Response/index.js'
 export * from './response_o/index.js'
 export * from './response_pair/index.js'
 export * from './reverse/index.js'
@@ -351,12 +352,12 @@ export * from './stacktrace/index.js'
 export * from './std/index.js'
 export * from './sub/index.js'
 export * from './tap/index.js'
+export * from './tempfile_path/index.js'
 export * from './tf/index.js'
 export * from './throttle/index.js'
 export * from './tick/index.js'
 export * from './timedout/index.js'
 export * from './timedout/index.js'
-export * from './Timeout/index.js'
 export * from './timeout_promise/index.js'
 export * from './times/index.js'
 export * from './timestamp_ms/index.js'
@@ -379,9 +380,9 @@ export * from './url_basename/index.js'
 export * from './url_segment/index.js'
 export * from './url_segment/index.js'
 export * from './urn_url/index.js'
-export * from './utc_m_yy/index.js'
-export * from './utc_M_yyyy/index.js'
 export * from './utc_MM_yyyy/index.js'
+export * from './utc_M_yyyy/index.js'
+export * from './utc_m_yy/index.js'
 export * from './utc_yyyymmdd/index.js'
 export * from './utc_yyyymmddhhmmss/index.js'
 export * from './uuid/index.js'

package/all/index.js

@@ -1,3 +1,13 @@
+export * from './LessThan/index.js'
+export * from './MAX_INT/index.js'
+export * from './MIN_INT/index.js'
+export * from './Map__object/index.js'
+export * from './NumericRange/index.js'
+export * from './NumericUnit/index.js'
+export * from './PHI/index.js'
+export * from './Request/index.js'
+export * from './Response/index.js'
+export * from './Timeout/index.js'
 export * from './a/index.js'
 export * from './a_assign/index.js'
 export * from './a_in_idx_a_map/index.js'
@@ -134,10 +144,10 @@ export * from './format_date_prose/index.js'
 export * from './format_utc_date_prose/index.js'
 export * from './globalThis__prop__ensure/index.js'
 export * from './gte_0_a/index.js'
+export * from './hasOwnProperty_pick/index.js'
 export * from './has_key/index.js'
 export * from './has_multiple/index.js'
 export * from './has_some_key/index.js'
-export * from './hasOwnProperty_pick/index.js'
 export * from './head_arg_a/index.js'
 export * from './headers/index.js'
 export * from './hex__digest/index.js'
@@ -191,7 +201,6 @@ export * from './keys/index.js'
 export * from './last/index.js'
 export * from './left_and/index.js'
 export * from './left_or/index.js'
-export * from './LessThan/index.js'
 export * from './lte_0_a/index.js'
 export * from './m_m_yyyy/index.js'
 export * from './m_yy/index.js'
@@ -199,7 +208,6 @@ export * from './m_yyyy/index.js'
 export * from './many_andand/index.js'
 export * from './many_andand_or/index.js'
 export * from './map/index.js'
-export * from './Map__object/index.js'
 export * from './map_andand/index.js'
 export * from './map_andand_or/index.js'
 export * from './map_andandfn/index.js'
@@ -214,12 +222,10 @@ export * from './matrix__dot/index.js'
 export * from './matrix__dot__scalar/index.js'
 export * from './matrix__normalize/index.js'
 export * from './matrix__validate_length/index.js'
-export * from './MAX_INT/index.js'
 export * from './maybe/index.js'
 export * from './mean/index.js'
 export * from './median/index.js'
 export * from './merge/index.js'
-export * from './MIN_INT/index.js'
 export * from './minute/index.js'
 export * from './minute/index.js'
 export * from './minute_seconds/index.js'
@@ -258,8 +264,6 @@ export * from './number_or_mdash_str/index.js'
 export * from './numerator_or_0_avg/index.js'
 export * from './numerator_or_0_sum/index.js'
 export * from './numeric_range/index.js'
-export * from './NumericRange/index.js'
-export * from './NumericUnit/index.js'
 export * from './o_a_present/index.js'
 export * from './o_a_present/index.js'
 export * from './o_some/index.js'
@@ -283,7 +287,6 @@ export * from './pathname/index.js'
 export * from './percentage_str/index.js'
 export * from './percentage_str_float/index.js'
 export * from './performance__now/index.js'
-export * from './PHI/index.js'
 export * from './pick/index.js'
 export * from './pick_keys/index.js'
 export * from './pick_val_a/index.js'
@@ -309,10 +312,8 @@ export * from './reduce/index.js'
 export * from './reject/index.js'
 export * from './remove/index.js'
 export * from './remove_idx/index.js'
-export * from './Request/index.js'
 export * from './resolver_curry/index.js'
 export * from './resolver_curry/index.js'
-export * from './Response/index.js'
 export * from './response_o/index.js'
 export * from './response_pair/index.js'
 export * from './reverse/index.js'
@@ -351,12 +352,12 @@ export * from './stacktrace/index.js'
 export * from './std/index.js'
 export * from './sub/index.js'
 export * from './tap/index.js'
+export * from './tempfile_path/index.js'
 export * from './tf/index.js'
 export * from './throttle/index.js'
 export * from './tick/index.js'
 export * from './timedout/index.js'
 export * from './timedout/index.js'
-export * from './Timeout/index.js'
 export * from './timeout_promise/index.js'
 export * from './times/index.js'
 export * from './timestamp_ms/index.js'
@@ -379,9 +380,9 @@ export * from './url_basename/index.js'
 export * from './url_segment/index.js'
 export * from './url_segment/index.js'
 export * from './urn_url/index.js'
-export * from './utc_m_yy/index.js'
-export * from './utc_M_yyyy/index.js'
 export * from './utc_MM_yyyy/index.js'
+export * from './utc_M_yyyy/index.js'
+export * from './utc_m_yy/index.js'
 export * from './utc_yyyymmdd/index.js'
 export * from './utc_yyyymmddhhmmss/index.js'
 export * from './uuid/index.js'

package/all/rmemo/index.d.ts

@@ -16,7 +16,7 @@ export declare function lock_memosig_<val_T>(
 ):sig_T<val_T>
 export declare function on(rmemo:rmemo_T<unknown>):void
 export declare function off(rmemo:rmemo_T<unknown>):void
-export type rmemo_T<val_T> = memo_T<val_T>|sig_T<val_T>
+export type rmemo_T<val_T> = memo_T<val_T>|sig_T<val_T>|lock_memosig_T<val_T>
 export type memo_T<val_T> = (()=>val_T)&{
 	readonly _:val_T
 	readonly val:val_T
@@ -29,6 +29,9 @@ export type sig_T<val_T> = (()=>val_T)&{
 	r?:WeakRef<()=>val_T>
 	memor:WeakRef<()=>val_T>[]
 }
+export type lock_memosig_T<val_T> = sig_T<val_T>&{
+	lock?:0|1
+}
 export type rmemo_val_T<sig_T> = sig_T extends { ():infer val_T }
 	? val_T
 	: unknown

package/all/rmemo/index.js

@@ -88,12 +88,12 @@ export { memo_ as memosig_ }
 export function lock_memosig_(memo_def, ...subscriber_a) {
 	return new Proxy(
 		/** @type {sig_T} */memo_(memo=>
-			memo.c ? memo._ : memo_def(memo),
+			memo.lock ? memo._ : memo_def(memo),
 		...subscriber_a),
 		{
 			set(memo, prop, val) {
 				if (prop === '_') {
-					memo.c = 1
+					memo.lock = 1
 					memo._ = val
 				}
 				return 1
@@ -114,7 +114,6 @@ export function sig_(init_val, ...subscriber_a) {
 	},
 	...subscriber_a)
 }
-// TODO: lock_memosig_
 /**
  * Call the rmemo & enable updates from it's parents.
  * @param {rmemo_T}rmemo

package/all/tempfile_path/index.d.ts

@@ -0,0 +1,5 @@
+export declare function tempfile_path_(
+	dir_path?:string,
+	extension?:string,
+):Promise<string>
+export { tempfile_path_ as tempfile_ }

package/all/tempfile_path/index.js

@@ -0,0 +1,33 @@
+import { crypto_ } from '../crypto/index.js'
+import { url__join } from '../url__join/index.js'
+/**
+ * @param {string}[dir_path]
+ * @param {string}[extension]
+ * @returns {Promise<string>}
+ * @private
+ */
+export async function tempfile_path_(
+	dir_path,
+	extension = ''
+) {
+	if (dir_path == null) {
+		dir_path =
+			typeof window === 'undefined'
+				? await import('fs/promises')
+					.then(fs=>
+						import('os')
+							.then(os=>
+								fs.realpath(os.tmpdir())))
+				: null
+	}
+	const crypto = await crypto_()
+	return url__join([
+		...(dir_path ? [dir_path] : []),
+		`${crypto.randomUUID()}${
+			extension
+				? extension.startsWith('.') ? extension : `.${extension}`
+				: ''
+		}`
+	])
+}
+export { tempfile_path_ as tempfile_ }

package/all/tempfile_path/index.test.ts

@@ -0,0 +1,11 @@
+import { readFile, writeFile } from 'fs/promises'
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { tempfile_path_ } from './index'
+test('tempfile_', async ()=>{
+	const tempfile = await tempfile_path_()
+	await writeFile(tempfile, 'the content')
+	const content = await readFile(tempfile).then(buf=>buf.toString())
+	equal(content, 'the content')
+})
+test.run()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "4.16.0",
+  "version": "4.18.0",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -57,6 +57,7 @@
     "set",
     "sleep",
     "string",
+    "tempfile",
     "time",
     "types",
     "uri",
@@ -98,6 +99,7 @@
     "./set": "./set/index.js",
     "./sleep": "./sleep/index.js",
     "./string": "./string/index.js",
+    "./tempfile": "./tempfile/index.js",
     "./time": "./time/index.js",
     "./types": "./types/index.js",
     "./uri": "./uri/index.js",

package/tempfile/index.d.ts

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

package/tempfile/index.js

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