ctx-core 5.34.0 → 5.35.1

package/all/be_/index.d.ts

@@ -47,6 +47,15 @@ export declare function ns_id_be_<
 	id:string,
 	val__new:be__val__new_T<val_T, ns_T, ctx_T>
 ):Be<val_T, ns_T, ctx_T>
+export declare function ctx__get<
+	val_T,
+	ns_T extends string = '',
+	ctx_T extends Ctx_wide_T<ns_T> = Ctx_wide_T<ns_T>,
+>(
+	ctx:ctx_T,
+	be_OR_id:Be<val_T>|string|symbol,
+	ns?:ns_T
+):val_T
 export declare function ctx__set<
 	val_T,
 	ns_T extends string = '',

package/all/be_/index.js

@@ -14,21 +14,21 @@ export function be_(val__new, config) {
 	let be = ctx=>{
 		let be_map = ctx.s[be.ns]
 		/* @if DEBUG **
-			// ~ 30 B
-			if (!be_map) throw Error('ctx_no_ns: \'' + be.ns + '\'')
-		/* @endif */
+		 // ~ 30 B
+		 if (!be_map) throw Error('ctx_no_ns: \'' + be.ns + '\'')
+		 /* @endif */
 		// config is not used anymore so reusing to reduce bundle size
 		config = be_map.get(be.id)
 		if (config) return config[0]
 		/* @if DEBUG **
-			// 5-11 B
-			// circular dependency state
-			// if val__new calls this be before returning, 'cir' will be the value of this be
-			// 'cir' is used instead of 'circular' to reduce the payload by a few bytes
-			config = ['cir', ctx, be]
-			be_map.set(be.id, config)
-			config[0] = val__new(ctx, be)
-		/* @endif */
+		 // 5-11 B
+		 // circular dependency state
+		 // if val__new calls this be before returning, 'cir' will be the value of this be
+		 // 'cir' is used instead of 'circular' to reduce the payload by a few bytes
+		 config = ['cir', ctx, be]
+		 be_map.set(be.id, config)
+		 config[0] = val__new(ctx, be)
+		 /* @endif */
 		/* @if !DEBUG */
 		config = [val__new(ctx, be), ctx, be]
 		be_map.set(be.id, config)
@@ -81,6 +81,20 @@ export function ns_id_be_(ns, id, val__new) {
  * @private
  */
 export { be_ as globalThis__be_ }
+/**
+ * @param {Ctx}ctx
+ * @param {Be|string|symbol}be_OR_id
+ * @param {string}[ns]
+ * @returns {unknown}
+ * @private
+ */
+export function ctx__get(
+	ctx,
+	be_OR_id,
+	ns = be_OR_id.ns ?? ''
+) {
+	return ctx.s[ns].get(be_OR_id.id ?? be_OR_id)?.[0]
+}
 /**
  * @param {Ctx}ctx
  * @param {Be|string|symbol}be_OR_id
@@ -141,24 +155,24 @@ export function be__has_(...arg_a) {
 	return Boolean(be_map__find(...arg_a))
 }
 /**
- * @param {Be}be_or_id
+ * @param {Be}be_OR_id
  * @param {Ctx}ctx
  * @param {string}[ns]
  * @returns {Ctx}
  * @private
  */
-export function be_map__find(be_or_id, ctx, ns = be_or_id.ns ?? '') {
-	return ctx.s[ns].has(be_or_id.id ?? be_or_id) ? ctx.s[ns] : _undefined
+export function be_map__find(be_OR_id, ctx, ns = be_OR_id.ns ?? '') {
+	return ctx.s[ns].has(be_OR_id.id ?? be_OR_id) ? ctx.s[ns] : _undefined
 }
 /**
- * @param {Be|string}be_or_id
+ * @param {Be|string}be_OR_id
  * @param {Ctx}ctx
  * @param {string}[ns]
  * @returns {unknown}
  * @private
  */
-export function be__val_(be_or_id, ctx, ns) {
-	return be_map__find(be_or_id, ctx, ns)?.get?.(be_or_id.id ?? be_or_id)?.[0]
+export function be__val_(be_OR_id, ctx, ns) {
+	return be_map__find(be_OR_id, ctx, ns)?.get?.(be_OR_id.id ?? be_OR_id)?.[0]
 }
 /**
  * @param {be__val__new_T}val__new

package/all/index.browser.js

@@ -448,6 +448,7 @@ export * from './waitfor/index.browser.js'
 export * from './waitfor_fibonacci_backoff/index.browser.js'
 export * from './weak_r/index.browser.js'
 export * from './week/index.browser.js'
+export * from './window__ctx__set/index.browser.js'
 export * from './wrap_a/index.browser.js'
 export * from './wrap_a_item/index.browser.js'
 export * from './wrap_aa/index.browser.js'

package/all/index.d.ts

@@ -448,6 +448,7 @@ export * from './waitfor/index.js'
 export * from './waitfor_fibonacci_backoff/index.js'
 export * from './weak_r/index.js'
 export * from './week/index.js'
+export * from './window__ctx__set/index.js'
 export * from './wrap_a/index.js'
 export * from './wrap_a_item/index.js'
 export * from './wrap_aa/index.js'

package/all/index.js

@@ -448,6 +448,7 @@ export * from './waitfor/index.js'
 export * from './waitfor_fibonacci_backoff/index.js'
 export * from './weak_r/index.js'
 export * from './week/index.js'
+export * from './window__ctx__set/index.js'
 export * from './wrap_a/index.js'
 export * from './wrap_a_item/index.js'
 export * from './wrap_aa/index.js'

package/all/window__ctx__set/index.browser.d.ts

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

package/all/window__ctx__set/index.browser.js

@@ -0,0 +1,24 @@
+/// <reference types="ctx-core" />
+import { ctx__get } from '../be_/index.js'
+/**
+ * @param {Ctx_wide_T<''>}ctx
+ */
+export function window__ctx__set(ctx) {
+	window.ctx = ctx
+	/**
+	 * @param {string}key
+	 * @param {string}[ns]
+	 * @returns {unknown}
+	 */
+	window.ctx__get = (key, ns)=>{
+		return ctx__get(window.ctx, key, ns)
+	}
+	/**
+	 * @param {string}key
+	 * @param {string}[ns]
+	 * @returns {unknown}
+	 */
+	window.ctx__get_ = (key, ns)=>{
+		return ctx__get(window.ctx, key, ns)()
+	}
+}

package/all/window__ctx__set/index.d.ts

@@ -0,0 +1,8 @@
+import { type Ctx_wide_T } from '../be_/index.js'
+export declare function window__ctx__set(ctx:Ctx_wide_T<''>):void
+declare global {
+	interface Window {
+		ctx__get<V>(key:string, ns?:string):V
+		ctx__get_<V>(key:string, ns?:string):V
+	}
+}

package/all/window__ctx__set/index.js

@@ -0,0 +1,7 @@
+/// <reference types="ctx-core" />
+/**
+ * @param {Ctx_wide_T<''>}ctx
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function window__ctx__set(ctx) {
+}

package/all/window__ctx__set/index.test.ts

@@ -0,0 +1,43 @@
+import { build } from 'esbuild'
+import { JSDOM } from 'jsdom'
+import { dirname, join } from 'node:path'
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { be_ } from '../be_/index.js'
+import { ctx__new } from '../ctx/index.js'
+import { memo_, type memo_T } from '../rmemo/index.js'
+import { window__ctx__set as browser_window__ctx__set } from './index.browser.js'
+import { window__ctx__set } from './index.js'
+test('window__ctx__set|server', ()=>{
+	const ctx = ctx__new()
+	window__ctx__set(ctx)
+})
+test('window__ctx__set|browser', ()=>{
+	const jsdom = new JSDOM()
+	const { window } = jsdom.window
+	const prev__window = globalThis['window']
+	globalThis['window'] = window as never
+	try {
+		const ctx = ctx__new()
+		const val$ = be_(()=>
+			memo_(()=>1),
+		{ id: 'val' })
+		browser_window__ctx__set(ctx)
+		equal(val$(ctx)(), 1)
+		equal(window.ctx__get<memo_T<number>>('val'), val$(ctx))
+		equal(window.ctx__get<memo_T<number>>('val')(), 1)
+		equal(window.ctx__get_('val'), 1)
+	} finally {
+		globalThis['window'] = prev__window
+	}
+})
+test('browser|build', async ()=>{
+	await build({
+		entryPoints: [join(dirname(new URL(import.meta.url).pathname), 'index.browser.js')],
+		platform: 'browser',
+		bundle: true,
+		format: 'esm',
+		write: false,
+	})
+})
+test.run()

package/dom/index.browser.d.ts

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

package/dom/index.browser.js

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

package/dom/index.d.ts

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

package/dom/index.js

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

package/dom/index.test.ts

@@ -0,0 +1,27 @@
+import { build } from 'esbuild'
+import { readFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+test('browser|loads matching index.browser.js files', async ()=>{
+	const index_js_source = await readFile(
+		join(dirname(new URL(import.meta.url).pathname), 'index.js')
+	).then(buf=>'' + buf)
+	const index_browser_js_source = await readFile(
+		join(dirname(new URL(import.meta.url).pathname), 'index.browser.js')
+	).then(buf=>'' + buf)
+	equal(
+		index_browser_js_source,
+		index_js_source.replaceAll('index.js', 'index.browser.js'))
+})
+test('browser|build', async ()=>{
+	await build({
+		entryPoints: [join(dirname(new URL(import.meta.url).pathname), 'index.browser.js')],
+		platform: 'browser',
+		bundle: true,
+		format: 'esm',
+		write: false,
+	})
+})
+test.run()
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "5.34.0",
+  "version": "5.35.1",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -43,6 +43,7 @@
     "date",
     "debounce",
     "deep_equal",
+    "dom",
     "env",
     "error",
     "event_log",
@@ -152,6 +153,10 @@
       "browser": "./deep_equal/index.browser.js",
       "default": "./deep_equal/index.js"
     },
+    "./dom": {
+      "browser": "./dom/index.browser.js",
+      "default": "./dom/index.js"
+    },
     "./env": {
       "browser": "./env/index.browser.js",
       "default": "./env/index.js"
@@ -290,12 +295,14 @@
     "@arethetypeswrong/cli": "^0.13.6",
     "@ctx-core/preprocess": "^0.1.1",
     "@size-limit/preset-small-lib": "^11.0.2",
+    "@types/jsdom": "^21.1.6",
     "@types/node": "^20.11.10",
     "@types/sinon": "^17.0.3",
     "c8": "^9.1.0",
     "check-dts": "^0.7.2",
     "esbuild": "^0.20.0",
     "esmock": "^2.6.3",
+    "jsdom": "^24.0.0",
     "sinon": "^17.0.1",
     "size-limit": "^11.0.2",
     "tsx": "^4.7.0",