react-usectx 1.0.8 → 1.1.0

package/README.md

@@ -71,6 +71,14 @@ When any of the provided functions—useCtx, updateCtx, or getCtx—are invoked,
 
 This mechanism enables global state sharing across components. For example, calling getCtx("example-1") in one component will return the same state reference when called with "example-1" in any other component within the same document. This allows for seamless state synchronization across different parts of your application without the need for explicit context providers.
 
+### initialState
+
+```js
+useCtx(myContextID, { name: "John" });
+```
+
+The value you want the state to be initially. It can be a value of any type.
+
 ## Example
 
 ```js

package/context.js

@@ -2,14 +2,19 @@
 import { useSyncExternalStore } from "react";
 import { CreateContext } from "./create-context";
 const cache = {};
-const getInstance = (name) => {
+const getInstance = (name, initialState) => {
     if (!cache[name]) {
-        cache[name] = new CreateContext();
+        cache[name] = new CreateContext(initialState);
+    }
+    else {
+        if (typeof initialState !== "undefined") {
+            cache[name].commit(initialState);
+        }
     }
     return cache[name];
 };
-export function updateCtx(name) {
-    const ctx = getInstance(name);
+export function updateCtx(name, initialState) {
+    const ctx = getInstance(name, initialState);
     return ctx.commit.bind(ctx);
 }
 export function getCtx(name) {
@@ -20,11 +25,11 @@ export function getCtx(name) {
     };
     return useSyncExternalStore(subscription, context.getState.bind(context), context.getState.bind(context));
 }
-export function useCtx(name) {
-    return [getCtx(name), updateCtx(name)];
+export function useCtx(name, initialState) {
+    return [getCtx(name), updateCtx(name, initialState)];
 }
 const reducerCache = {};
-export function useReducer(name, modiFier, useCache = true) {
+export function useReducer(name, modiFier, useCache = false) {
     if (!reducerCache[name]) {
         reducerCache[name] = new WeakMap();
     }

package/create-context.js

@@ -1,4 +1,9 @@
 export class CreateContext {
+    constructor(initialState) {
+        if (initialState !== undefined) {
+            this.setState(initialState);
+        }
+    }
     #eventHandlers = [];
     #state = null;
     subscribe(handler) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-usectx",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "main": "index.js",
   "type": "module",
   "repository": {

package/src/context.ts

@@ -2,20 +2,28 @@
 
 import { ReactNode, useSyncExternalStore } from "react";
 import { CreateContext } from "./create-context";
+import { state } from "./types";
 
 type cache = { [key: string]: InstanceType<typeof CreateContext> };
 
 const cache: cache = {};
 
-const getInstance = (name: string): InstanceType<typeof CreateContext> => {
+const getInstance = (
+  name: string,
+  initialState?: state
+): InstanceType<typeof CreateContext> => {
   if (!cache[name]) {
-    cache[name] = new CreateContext();
+    cache[name] = new CreateContext(initialState);
+  } else {
+    if (typeof initialState !== "undefined") {
+      cache[name].commit(initialState);
+    }
   }
   return cache[name];
 };
 
-export function updateCtx(name: string): Function {
-  const ctx = getInstance(name);
+export function updateCtx(name: string, initialState?: state): Function {
+  const ctx = getInstance(name, initialState);
   return ctx.commit.bind(ctx);
 }
 
@@ -32,8 +40,11 @@ export function getCtx<Snapshot>(name: string): Snapshot {
   );
 }
 
-export function useCtx(name: string): [ReactNode, Function] {
-  return [getCtx(name), updateCtx(name)];
+export function useCtx(
+  name: string,
+  initialState?: state
+): [ReactNode, Function] {
+  return [getCtx(name), updateCtx(name, initialState)];
 }
 
 const reducerCache: { [key: string]: WeakMap<any, any> } = {};
@@ -41,7 +52,7 @@ const reducerCache: { [key: string]: WeakMap<any, any> } = {};
 export function useReducer<Snapshot>(
   name: string,
   modiFier: (data: any) => Snapshot,
-  useCache: boolean = true
+  useCache: boolean = false
 ): Snapshot {
   if (!reducerCache[name]) {
     reducerCache[name] = new WeakMap();

package/src/create-context.ts

@@ -1,14 +1,12 @@
-type eventHandlers = Array<Function>;
-
-type state =
-  | { [key: string]: any }
-  | Array<any>
-  | string
-  | number
-  | boolean
-  | null;
+import { eventHandlers, state } from "./types";
 
 export class CreateContext {
+  constructor(initialState?: state) {
+    if (initialState !== undefined) {
+      this.setState(initialState);
+    }
+  }
+
   #eventHandlers: eventHandlers = [];
 
   #state: state = null;

package/src/types.ts

@@ -0,0 +1,9 @@
+export type eventHandlers = Array<Function>;
+
+export type state =
+  | { [key: string]: any }
+  | Array<any>
+  | string
+  | number
+  | boolean
+  | null;