@ptolemy2002/react-proxy-context 2.0.1 → 2.1.1

package/README.md

@@ -24,6 +24,8 @@ type Dependency<T> = keyof T | (
     <K extends keyof T>(prop: K, current: T[K], prev: T[K], obj: T) => boolean
 ) | null | undefined | false;
 
+type ProxyContext<T> = ContextWithName<ProxyContextValue<T> | undefined>;
+
 type ProxyContextValue<T> = {
     obj: T;
     set: (newObj: T) => T;
@@ -60,14 +62,14 @@ Creates a new instance of the ProxyContext, essentially to be used as the contex
 - `name` (String): The name of the context. This is used for debugging purposes.
 
 #### Returns
-`ContextWithName<ProxyContextValue<T> | undefined>` - The context object that can be used in a provider.
+`ProxyContext<T>` - The context object that can be used in a provider.
 
 ### createProxyContextProvider<T extends object>
 #### Description
 Creates a new proxy context provider component with the specified type. `ProxyContextProvider` is no longer used due to a TypeScript limitation that prevents the context type from being inferred.
 
 #### Parameters
-- `contextClass` (`ContextWithName<ProxyContextValue<T> | undefined>`): The context class that was created using `createProxyContext`.
+- `contextClass` (`ProxyContext<T>`): The context class that was created using `createProxyContext`.
 
 #### Returns
 `React.MemoExoticComponent<FunctionComponent<ProxyContextProviderProps<T> & { renderDeps?: any[] }>>` - The provider component that can be used in the React tree. The resulting component is memoized to prevent unnecessary re-renders, but the `renderDeps` prop can be used to force a re-render when the specified dependencies change (necessary when working with the children prop).
@@ -85,7 +87,7 @@ The following hooks are available in the library:
 A hook that uses the context provided by the `ProxyContextProvider` component. This hook also provides options to choose which properties to listen to and whether to listen to full reassignments. `T` represents the type of the object that is stored in the context.
 
 #### Parameters
-- `contextClass` (`ContextWithName<ProxyContextValue<T> | undefined>`): The context class that was created using `createProxyContext`.
+- `contextClass` (`ProxyContext<T>`): The context class that was created using `createProxyContext`.
 - `deps` (`Dependency<T>[] | null`): An array of dependencies to listen to. If any of these properties on the context change, the hook will re-render. If this is falsy, any mutation will trigger a re-render. You can also specify a function that returns a boolean to determine whether to re-render. If this is null, the hook will re-render on any mutation. By default, this is an empty array.
 - `onChangeProp` (`OnChangePropCallback<T> | undefined`): A function that is called whenever a property of the context is changed. The first parameter is the property that was changed, the second parameter is the current value of the property, and the third parameter is the previous value of the property. This is useful for listening to changes in the provider's parent component.
 - `onChangeReinit` (`OnChangeReinitCallback<T> | undefined`): A function that is called whenever the context is reinitialized. The first parameter is the current value of the context, and the second parameter is the previous value of the context. This is useful for listening to changes in the provider's parent component.
@@ -98,7 +100,6 @@ A hook that uses the context provided by the `ProxyContextProvider` component. T
 These should be installed in order to use the library, as npm does not automatically add peer dependencies to your project.
 - `react^18.3.1`
 - `react-dom^18.3.1`
-- `@ptolemy2002/js-utils^3.0.2`
 - `@ptolemy2002/react-utils^3.0.0`
 - `@ptolemy2002/react-force-rerender^2.0.0`
 - `@ptolemy2002/react-hook-result^2.1.1`

package/dist/main.d.ts

@@ -11,8 +11,9 @@ export type ProxyContextValue<T> = {
     subscribe: (propCallback: OnChangePropCallback<T>, reinitCallback: OnChangeReinitCallback<T>, deps: Dependency<T>[] | null) => string;
     unsubscribe: (id: string) => void;
 };
-export declare function createProxyContext<T>(name: string): ContextWithName<ProxyContextValue<T> | undefined>;
+export declare function createProxyContext<T>(name: string): ProxyContext<T>;
 export type Dependency<T> = keyof T | (<K extends keyof T>(prop: K, current: T[K], prev: T[K], obj: T) => boolean) | null | undefined | false;
+export type ProxyContext<T> = ContextWithName<ProxyContextValue<T> | undefined>;
 export type ProxyContextProviderProps<T> = {
     children: ReactNode;
     value: T;
@@ -20,11 +21,11 @@ export type ProxyContextProviderProps<T> = {
     onChangeReinit?: OnChangeReinitCallback<T>;
     proxyRef?: React.MutableRefObject<T>;
 };
-export declare function createProxyContextProvider<T extends object>(contextClass: ContextWithName<ProxyContextValue<T> | undefined>): import('react').MemoExoticComponent<import('react').FunctionComponent<ProxyContextProviderProps<T> & {
+export declare function createProxyContextProvider<T extends object | null>(contextClass: ProxyContext<T>): import('react').MemoExoticComponent<import('react').FunctionComponent<ProxyContextProviderProps<T> & {
     renderDeps?: any[];
 }>>;
 export type UseProxyContextResult<T> = HookResultData<{
     value: T;
     set: (newObj: T) => T;
 }, readonly [T, (newObj: T) => T]>;
-export declare function useProxyContext<T>(contextClass: ContextWithName<ProxyContextValue<T> | undefined>, deps?: Dependency<T>[] | null, onChangeProp?: OnChangePropCallback<T>, onChangeReinit?: OnChangeReinitCallback<T>, listenReinit?: boolean): UseProxyContextResult<T>;
+export declare function useProxyContext<T>(contextClass: ProxyContext<T>, deps?: Dependency<T>[] | null, onChangeProp?: OnChangePropCallback<T>, onChangeReinit?: OnChangeReinitCallback<T>, listenReinit?: boolean): UseProxyContextResult<T>;

package/dist/main.js

@@ -2,9 +2,8 @@ import Ie, { useEffect as $e, createContext as br, useRef as X, useImperativeHan
 import { nanoid as Rr } from "nanoid";
 import M from "is-callable";
 import We from "@ptolemy2002/react-force-rerender";
-import { isNullOrUndefined as gr } from "@ptolemy2002/js-utils";
-import hr from "@ptolemy2002/react-hook-result";
-import { partialMemo as Er } from "@ptolemy2002/react-utils";
+import gr from "@ptolemy2002/react-hook-result";
+import { partialMemo as hr } from "@ptolemy2002/react-utils";
 var se = { exports: {} }, B = {};
 /**
  * @license React
@@ -16,7 +15,7 @@ var se = { exports: {} }, B = {};
  * LICENSE file in the root directory of this source tree.
  */
 var Fe;
-function _r() {
+function Er() {
   if (Fe) return B;
   Fe = 1;
   var b = Ie, _ = Symbol.for("react.element"), k = Symbol.for("react.fragment"), T = Object.prototype.hasOwnProperty, C = b.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner, p = { key: !0, ref: !0, __self: !0, __source: !0 };
@@ -40,7 +39,7 @@ var J = {};
  * LICENSE file in the root directory of this source tree.
  */
 var Ae;
-function Tr() {
+function _r() {
   return Ae || (Ae = 1, process.env.NODE_ENV !== "production" && function() {
     var b = Ie, _ = Symbol.for("react.element"), k = Symbol.for("react.portal"), T = Symbol.for("react.fragment"), C = Symbol.for("react.strict_mode"), p = Symbol.for("react.profiler"), S = Symbol.for("react.provider"), y = Symbol.for("react.context"), o = Symbol.for("react.forward_ref"), d = Symbol.for("react.suspense"), v = Symbol.for("react.suspense_list"), P = Symbol.for("react.memo"), w = Symbol.for("react.lazy"), D = Symbol.for("react.offscreen"), R = Symbol.iterator, I = "@@iterator";
     function x(e) {
@@ -633,25 +632,25 @@ React keys must be passed directly to JSX without using spread:
     J.Fragment = T, J.jsx = lr, J.jsxs = dr;
   }()), J;
 }
-process.env.NODE_ENV === "production" ? se.exports = _r() : se.exports = Tr();
-var Pr = se.exports;
-function xr(b) {
+process.env.NODE_ENV === "production" ? se.exports = Er() : se.exports = _r();
+var Tr = se.exports;
+function Pr(b) {
   $e(() => {
     b();
   }, []);
 }
-function Cr(b) {
+function xr(b) {
   $e(() => b, []);
 }
-function Ar(b) {
+function Dr(b) {
   if (typeof Proxy > "u") throw new Error("Proxy is not supported in this environment.");
   const _ = br(
     void 0
   );
   return _.name = b, _;
 }
-function Ir(b) {
-  return Er(function({
+function Fr(b) {
+  return hr(function({
     children: k,
     value: T,
     onChangeProp: C,
@@ -673,7 +672,7 @@ function Ir(b) {
     }, []), D = ue((R) => {
       if (R !== o.current) {
         const I = o.current;
-        gr(R) ? o.current = R : o.current = new Proxy(R, {
+        R !== null ? o.current = new Proxy(R, {
           get: function(x, g) {
             const s = Reflect.get(x, g, R);
             return M(s) ? s.bind(o.current) : s;
@@ -684,20 +683,20 @@ function Ir(b) {
               (!W.deps || W.deps.includes(j) && $ !== s || W.deps.some((q) => M(q) && q(j, s, $, R))) && W.propCallback(j, s, $);
             }), M(C) && C(j, s, $), !0;
           }
-        }), Object.values(y.current).forEach((x) => {
+        }) : o.current = R, Object.values(y.current).forEach((x) => {
           x.reinitCallback(o.current, I);
         }), M(p) && p(o.current, I), v();
       }
       return d.current.obj = o.current, o.current;
     }, [C, p]);
-    return o.current === void 0 && (o.current = D(T)), d.current.obj = o.current, d.current.set = D, d.current.subscribe = P, d.current.unsubscribe = w, /* @__PURE__ */ Pr.jsx(b.Provider, { value: d.current, children: k });
+    return o.current === void 0 && (o.current = D(T)), d.current.obj = o.current, d.current.set = D, d.current.subscribe = P, d.current.unsubscribe = w, /* @__PURE__ */ Tr.jsx(b.Provider, { value: d.current, children: k });
   }, ["children", "onChangeProp", "onChangeReinit", "proxyRef"], `${b.name}Provider (Memo)`);
 }
-function $r(b, _ = [], k, T, C = !0) {
+function Ar(b, _ = [], k, T, C = !0) {
   const p = mr(b), S = We(), y = X(null);
   if (p === void 0)
     throw new Error(`No ${b.name} provider found.`);
-  return xr(() => {
+  return Pr(() => {
     y.current = p == null ? void 0 : p.subscribe(
       (o, d, v) => {
         S(), M(k) && k(o, d, v);
@@ -707,15 +706,15 @@ function $r(b, _ = [], k, T, C = !0) {
       },
       _
     );
-  }), Cr(() => {
+  }), xr(() => {
     p.unsubscribe(y.current);
-  }), new hr(
+  }), new gr(
     { value: p.obj, set: p.set },
     ["value", "set"]
   );
 }
 export {
-  Ar as createProxyContext,
-  Ir as createProxyContextProvider,
-  $r as useProxyContext
+  Dr as createProxyContext,
+  Fr as createProxyContextProvider,
+  Ar as useProxyContext
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ptolemy2002/react-proxy-context",
   "private": false,
-  "version": "2.0.1",
+  "version": "2.1.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,7 +21,6 @@
     "release-major": "bash ./scripts/release.sh major"
   },
   "peerDependencies": {
-    "@ptolemy2002/js-utils": "^3.0.2",
     "@ptolemy2002/react-force-rerender": "^2.0.0",
     "@ptolemy2002/react-hook-result": "^2.1.1",
     "@ptolemy2002/react-mount-effects": "^2.0.0",
@@ -33,7 +32,6 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.11.1",
-    "@ptolemy2002/js-utils": "^3.0.2",
     "@ptolemy2002/react-force-rerender": "^2.0.0",
     "@ptolemy2002/react-hook-result": "^2.1.1",
     "@ptolemy2002/react-mount-effects": "^2.0.0",