bunja 0.0.9 → 0.0.11

package/README.md

@@ -1,6 +1,6 @@
 # Bunja
 
-Bunja is State Lifetime Manager for React. (Minified & gzipped size < 1kB)\
+Bunja is lightweight State Lifetime Manager.\
 Heavily inspired by [Bunshi](https://github.com/saasquatch/bunshi).
 
 > Definition: Bunja (分子 / 분자) - Korean for molecule, member or element.
@@ -36,7 +36,8 @@ If all components in the render tree that refer to the bunja disappear, the bunj
 If you want to trigger effects when the lifetime of a bunja starts and ends, you can use the `bunja.effect` field.
 
 ```ts
-import { bunja, useBunja } from "bunja";
+import { bunja } from "bunja";
+import { useBunja } from "bunja/react";
 
 const countBunja = bunja([], () => {
   const countAtom = atom(0);

package/bunja.ts

@@ -16,19 +16,22 @@ export class Bunja<T> {
   }
   static readonly effect = Symbol("Bunja.effect");
   toString() {
-    return `[${this.debugLabel} Bunja:${this.id}]`;
+    const { id, debugLabel } = this;
+    return `[Bunja:${id}${debugLabel && ` - ${debugLabel}`}]`;
   }
 }
 
 export class Scope<T> {
   public static readonly scopes: Scope<any>[] = [];
   public readonly id: number;
+  public debugLabel: string = "";
   constructor() {
     this.id = Scope.scopes.length;
     Scope.scopes.push(this);
   }
   toString() {
-    return this.id;
+    const { id, debugLabel } = this;
+    return `[Scope:${id}${debugLabel && ` - ${debugLabel}`}]`;
   }
 }
 
@@ -48,11 +51,11 @@ export class BunjaStore {
     const { relatedBunjaInstanceMap } = bunjaInstance; // toposorted
     return {
       value: bunjaInstance.value as T,
-      effect() {
+      mount() {
         relatedBunjaInstanceMap.forEach((related) => related.add());
         bunjaInstance.add();
         scopeInstanceMap.forEach((scope) => scope.add());
-        return () => {
+        return function unmount() {
           // concern: reverse order?
           relatedBunjaInstanceMap.forEach((related) => related.sub());
           bunjaInstance.sub();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunja",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "State Lifetime Manager",
   "main": "bunja.ts",
   "scripts": {},

package/react.ts

@@ -27,7 +27,25 @@ const defaultReadScope: ReadScope = (scope) => {
 
 export function useBunja<T>(bunja: Bunja<T>, readScope = defaultReadScope): T {
   const store = useContext(BunjaStoreContext);
-  const { value, effect } = store.get(bunja, readScope);
-  useEffect(effect, []);
+  const { value, mount } = store.get(bunja, readScope);
+  useEffect(mount, []);
   return value;
 }
+
+export type ScopePair<T> = [Scope<T>, T];
+
+export function inject<const T extends ScopePair<any>[]>(
+  overrideTable: T
+): ReadScope {
+  const map = new Map(overrideTable);
+  return (scope) => {
+    if (map.has(scope)) return map.get(scope);
+    const context = scopeContextMap.get(scope);
+    if (!context) {
+      throw new Error(
+        "Unable to read the scope. Please inject the value explicitly or bind scope to the React context."
+      );
+    }
+    return useContext(context);
+  };
+}