ctx-core 4.9.1 → 4.10.0

package/all/rmemo/index.d.ts

@@ -11,6 +11,8 @@ export declare function memosig_<val_T>(
 	...subscriber_a:rmemo_subscriber_T<val_T>[]
 ):sig_T<val_T>
 // TODO: lock_memosig_
+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 memo_T<val_T> = (()=>val_T)&{
 	readonly _:val_T

package/all/rmemo/index.js

@@ -94,3 +94,23 @@ 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
+ */
+export function on(rmemo) {
+	if (rmemo.r?.d) {
+		rmemo.r.deref = rmemo.r.d
+	}
+	rmemo.f()
+}
+/**
+ * Disable updates from the rmemo's parents.
+ * @param {rmemo_T}rmemo
+ */
+export function off(rmemo) {
+	if (rmemo.r) {
+		rmemo.r.d ||= rmemo.r.deref
+		rmemo.r.deref = ()=>{}
+	}
+}

package/all/rmemo/index.test.ts

@@ -4,7 +4,7 @@ import { deepStrictEqual } from 'node:assert'
 import { test } from 'uvu'
 import { equal } from 'uvu/assert'
 import { sleep } from '../sleep/index.js'
-import { memo_, type memo_T, memosig_, sig_ } from './index.js'
+import { memo_, type memo_T, memosig_, off, on, sig_ } from './index.js'
 test('memo_|static value', ()=>{
 	let count = 0
 	const memo = memo_(()=>{
@@ -410,4 +410,30 @@ test('computes initial value when argument is undefined', ()=>{
 	equal(one$(), undefined)
 	equal(two$(), false)
 })
+test('.on + .off', ()=>{
+	const base$ = sig_(1)
+	let count = 0
+	const memo$ = memo_(()=>{
+		count++
+		return base$() + 10
+	})
+	equal(memo$(), 11)
+	equal(count, 1)
+	base$._ = 2
+	equal(memo$(), 12)
+	equal(count, 2)
+	off(memo$)
+	base$._ = 3
+	equal(memo$(), 12)
+	equal(count, 2)
+	on(memo$)
+	equal(memo$(), 13)
+	equal(count, 3)
+	off(memo$)
+	on(memo$)
+	equal(count, 4)
+	base$._ = 4
+	equal(memo$(), 14)
+	equal(count, 5)
+})
 test.run()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "4.9.1",
+  "version": "4.10.0",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -105,7 +105,7 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.13.2",
+    "@arethetypeswrong/cli": "^0.13.3",
     "@size-limit/preset-small-lib": "^11.0.0",
     "@types/node": "^20.10.3",
     "@types/sinon": "^17.0.2",
@@ -150,14 +150,14 @@
       "import": {
         "./rmemo": "{ memo_ }"
       },
-      "limit": "338 B"
+      "limit": "340 B"
     },
     {
       "name": "memo_ sig_",
       "import": {
         "./rmemo": "{ sig_, memo_ }"
       },
-      "limit": "354 B"
+      "limit": "355 B"
     },
     {
       "name": "memo_ sig_ be_ ctx_",
@@ -171,7 +171,7 @@
       "import": {
         "./rmemo": "{ sig_, memo_, be_, ctx_, be_memo_pair_, be_sig_triple_ }"
       },
-      "limit": "602 B"
+      "limit": "600 B"
     }
   ],
   "scripts": {