react-chain-of-responsibility 0.4.0-main.f9aeacf → 0.4.0-main.fc9324d

package/dist/react-chain-of-responsibility.preview.js

@@ -34,12 +34,12 @@ __export(index_preview_exports, {
 });
 module.exports = __toCommonJS(index_preview_exports);
 
-// src/createChainOfResponsibilityAsRenderCallback.tsx
+// src/preview/createChainOfResponsibilityAsRenderCallback.tsx
 var import_handler_chain = require("handler-chain");
-var import_react2 = __toESM(require("react"));
+var import_react = __toESM(require("react"));
 var import_valibot = require("valibot");
 
-// src/private/arePropsEqual.ts
+// src/preview/private/arePropsEqual.ts
 function arePropsEqual(x, y) {
   if (Object.is(x, y)) {
     return true;
@@ -58,31 +58,21 @@ function arePropsEqual(x, y) {
   return true;
 }
 
-// src/private/useMemoValueWithEquality.ts
-var import_react = require("react");
-var NOT_INITIALIZED = Symbol();
-function useMemoValueWithEquality(factory, equalityFn) {
-  const prevRef = (0, import_react.useRef)(NOT_INITIALIZED);
-  const next = factory();
-  const current = prevRef.current !== NOT_INITIALIZED && equalityFn(prevRef.current, next) ? prevRef.current : next;
-  (0, import_react.useEffect)(() => {
-    prevRef.current = current;
-  });
-  return current;
-}
-
-// src/createChainOfResponsibilityAsRenderCallback.tsx
+// src/preview/createChainOfResponsibilityAsRenderCallback.tsx
 var DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();
 var componentHandlerResultSchema = (0, import_valibot.custom)(
   (value) => (0, import_valibot.safeParse)((0, import_valibot.object)({ render: (0, import_valibot.function_)() }), value).success && !!value && typeof value === "object" && DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,
   "react-chain-of-responsibility: middleware must return value constructed by reactComponent()"
 );
+function createComponentHandlerResult(render) {
+  return Object.freeze({ [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0, render });
+}
 function createChainOfResponsibility(options = {}) {
   options = Object.freeze({ ...options });
-  const BuildContext = (0, import_react2.createContext)(
+  const BuildContext = (0, import_react.createContext)(
     Object.freeze({ enhancer: (next) => (request) => next(request) })
   );
-  const RenderContext = (0, import_react2.createContext)(
+  const RenderContext = (0, import_react.createContext)(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     new Proxy({}, {
       get() {
@@ -93,36 +83,33 @@ function createChainOfResponsibility(options = {}) {
     })
   );
   function reactComponent(component, bindProps) {
-    return Object.freeze({
-      [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0,
-      render: (overridingProps) => /* @__PURE__ */ import_react2.default.createElement(
-        ComponentWithProps,
-        {
-          bindProps,
-          component,
-          overridingProps
-        }
-      )
-    });
+    return createComponentHandlerResult((overridingProps) => /* @__PURE__ */ import_react.default.createElement(
+      ComponentWithProps,
+      {
+        bindProps,
+        component,
+        overridingProps
+      }
+    ));
   }
-  const ComponentWithProps = (0, import_react2.memo)(function ComponentWithProps2({
+  const ComponentWithProps = (0, import_react.memo)(function ComponentWithProps2({
     bindProps,
     component: Component,
     overridingProps
   }) {
     const { allowOverrideProps } = options;
-    const { renderCallbackProps } = (0, import_react2.useContext)(RenderContext);
+    const { originalProps: renderCallbackProps } = (0, import_react.useContext)(RenderContext);
     if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {
       console.warn('react-chain-of-responsibility: "allowOverrideProps" must be set to true to override props');
     }
     const props = Object.freeze(
       allowOverrideProps ? { ...renderCallbackProps, ...overridingProps } : { ...renderCallbackProps }
     );
-    return /* @__PURE__ */ import_react2.default.createElement(Component, { ...props, ...typeof bindProps === "function" ? bindProps(props) : bindProps });
+    return /* @__PURE__ */ import_react.default.createElement(Component, { ...props, ...typeof bindProps === "function" ? bindProps(props) : bindProps });
   });
   const useBuildRenderCallback = () => {
-    const { enhancer } = (0, import_react2.useContext)(BuildContext);
-    return (0, import_react2.useCallback)(
+    const { enhancer } = (0, import_react.useContext)(BuildContext);
+    return (0, import_react.useCallback)(
       (request, buildOptions = {}) => {
         const result = (
           // Put the "fallbackComponent" as the last one in the chain.
@@ -135,34 +122,26 @@ function createChainOfResponsibility(options = {}) {
               );
               return;
             }
-            return Object.freeze({
-              // Convert fallback component as renderer.
-              [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0,
-              render: () => (
-                // Currently, there are no ways to set `bindProps` to `fallbackComponent`.
-                // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.
-                /* @__PURE__ */ import_react2.default.createElement(ComponentWithProps, { component: fallbackComponent })
-              )
-            });
+            return reactComponent(fallbackComponent);
           })(request)
         );
-        return result && ((props) => {
-          const renderCallbackProps = useMemoValueWithEquality(() => props, arePropsEqual);
-          const context = (0, import_react2.useMemo)(
-            () => Object.freeze({ renderCallbackProps }),
-            [renderCallbackProps]
-          );
-          return /* @__PURE__ */ import_react2.default.createElement(RenderContext.Provider, { value: context }, result.render());
-        });
+        return result && ((originalProps) => (
+          // This is render function, we cannot call any hooks here.
+          /* @__PURE__ */ import_react.default.createElement(BuildRenderCallback, { originalProps, render: result.render })
+        ));
       },
       [enhancer]
     );
   };
+  function BuildRenderCallback({ originalProps, render }) {
+    const context = (0, import_react.useMemo)(() => Object.freeze({ originalProps }), [originalProps]);
+    return /* @__PURE__ */ import_react.default.createElement(RenderContext.Provider, { value: context }, render());
+  }
   function ChainOfResponsibilityProvider({ children, init, middleware }) {
     if (!Array.isArray(middleware) || middleware.some((middleware2) => typeof middleware2 !== "function")) {
       throw new Error('react-chain-of-responsibility: "middleware" prop must be an array of functions');
     }
-    const fortifiedMiddleware = (0, import_react2.useMemo)(
+    const fortifiedMiddleware = (0, import_react.useMemo)(
       () => Object.freeze(
         middleware.map((fn) => (init2) => {
           const enhancer2 = fn(init2);
@@ -186,8 +165,8 @@ function createChainOfResponsibility(options = {}) {
       ),
       [middleware]
     );
-    const { enhancer: parentEnhancer } = (0, import_react2.useContext)(BuildContext);
-    const enhancer = (0, import_react2.useMemo)(
+    const { enhancer: parentEnhancer } = (0, import_react.useContext)(BuildContext);
+    const enhancer = (0, import_react.useMemo)(
       () => (
         // We are reversing because it is easier to read:
         // - With reverse, [a, b, c] will become a(b(c(fn)))
@@ -198,17 +177,17 @@ function createChainOfResponsibility(options = {}) {
       ),
       [init, fortifiedMiddleware, parentEnhancer]
     );
-    const contextValue = (0, import_react2.useMemo)(() => Object.freeze({ enhancer }), [enhancer]);
-    return /* @__PURE__ */ import_react2.default.createElement(BuildContext.Provider, { value: contextValue }, children);
+    const contextValue = (0, import_react.useMemo)(() => Object.freeze({ enhancer }), [enhancer]);
+    return /* @__PURE__ */ import_react.default.createElement(BuildContext.Provider, { value: contextValue }, children);
   }
   function ChainOfResponsibilityProxy({ fallbackComponent, request, ...props }) {
     const result = useBuildRenderCallback()(request, { fallbackComponent })?.(props);
-    return result ? /* @__PURE__ */ import_react2.default.createElement(import_react2.Fragment, null, result) : null;
+    return result ? /* @__PURE__ */ import_react.default.createElement(import_react.Fragment, null, result) : null;
   }
-  const MemoizedChainOfResponsibilityProvider = (0, import_react2.memo)(ChainOfResponsibilityProvider);
+  const MemoizedChainOfResponsibilityProvider = (0, import_react.memo)(ChainOfResponsibilityProvider);
   return Object.freeze({
     Provider: MemoizedChainOfResponsibilityProvider,
-    Proxy: (0, import_react2.memo)(ChainOfResponsibilityProxy),
+    Proxy: ChainOfResponsibilityProxy,
     reactComponent,
     useBuildRenderCallback
     // TODO: Consider adding back `asMiddleware`.

package/dist/react-chain-of-responsibility.preview.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.preview.ts","../src/createChainOfResponsibilityAsRenderCallback.tsx","../src/private/arePropsEqual.ts","../src/private/useMemoValueWithEquality.ts"],"sourcesContent":["export {\n  default as createChainOfResponsibility,\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n} from './createChainOfResponsibilityAsRenderCallback.tsx';\n","import { applyMiddleware } from 'handler-chain';\nimport React, {\n  createContext,\n  Fragment,\n  memo,\n  useCallback,\n  useContext,\n  useMemo,\n  type ComponentType,\n  type PropsWithChildren,\n  type ReactNode\n} from 'react';\nimport { custom, function_, object, parse, safeParse } from 'valibot';\n\nimport arePropsEqual from './private/arePropsEqual.ts';\nimport useMemoValueWithEquality from './private/useMemoValueWithEquality.ts';\n\n// TODO: Related to https://github.com/microsoft/TypeScript/issues/17002.\n//       typescript@5.2.2 has a bug, Array.isArray() is a type predicate but only works with mutable array, not readonly array.\ndeclare global {\n  interface ArrayConstructor {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    isArray(arg: any): arg is readonly any[];\n  }\n}\n\ntype BaseProps = object;\n\ntype CreateChainOfResponsibilityOptions = {\n  /**\n   * Allows one component to pass different set of props to its downstream component. Default is false.\n   *\n   * It is recommended to keep this settings as default to prevent newly added component from unexpectedly changing behavior of downstream components.\n   */\n  readonly allowOverrideProps?: boolean | undefined;\n\n  /**\n   * Allows a middleware to pass another request object when calling its next middleware. Default is false.\n   *\n   * It is recommended to keep this settings as default ot prevent newly added middleware from unexpectedly changing behavior of downstream middleware.\n   *\n   * To prevent upstream middleware from modifying the request, the request object should be set to be immutable through `Object.freeze`.\n   */\n  readonly passModifiedRequest?: boolean | undefined;\n};\n\ntype ChainOfResponsibility<Request, Props extends BaseProps, Init> = {\n  readonly Provider: ComponentType<ProviderProps<Request, Props, Init>> & InferenceHelper<Request, Props, Init>;\n  readonly Proxy: ComponentType<ProxyProps<Request, Props>>;\n  readonly reactComponent: ReactComponentHandlerResult<Props>;\n  readonly useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props>;\n};\n\n// TODO: Maybe this one should be local.\n//       Verify that reactComponent() from an instance of CoR should throw error when used in another instance of CoR.\nconst DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();\n\ntype ComponentRenderer<Props> = (props: Props) => ReactNode;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst componentHandlerResultSchema = custom<ComponentHandlerResult<any>>(\n  value =>\n    safeParse(object({ render: function_() }), value).success &&\n    !!value &&\n    typeof value === 'object' &&\n    DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,\n  'react-chain-of-responsibility: middleware must return value constructed by reactComponent()'\n);\n\ninterface ComponentHandlerResult<Props extends BaseProps> {\n  readonly [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined;\n  readonly render: (overridingProps?: Partial<Props> | undefined) => ReactNode;\n}\n\ntype ComponentHandler<Request, Props extends BaseProps> = (\n  request: Request\n) => ComponentHandlerResult<Props> | undefined;\n\ntype ComponentEnhancer<Request, Props extends BaseProps> = (\n  next: ComponentHandler<Request, Props>\n) => ComponentHandler<Request, Props>;\n\ntype ComponentMiddleware<Request, Props extends BaseProps, Init = undefined> = (\n  init: Init\n) => ComponentEnhancer<Request, Props>;\n\ntype ReactComponentHandlerResult<Props extends object> = <P extends Props>(\n  component: ComponentType<P>,\n  bindProps?:\n    | (Partial<Props> & Omit<P, keyof Props>)\n    | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n    | undefined\n) => ComponentHandlerResult<Props>;\n\ntype UseBuildRenderCallbackOptions<Props> = {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n};\n\ninterface UseBuildRenderCallback<Request, Props extends BaseProps> {\n  (request: Request, options?: undefined | UseBuildRenderCallbackOptions<Props>): ComponentRenderer<Props> | undefined;\n}\n\ntype BuildContextType<Request, Props extends BaseProps> = {\n  readonly enhancer: ComponentEnhancer<Request, Props>;\n};\n\ntype RenderContextType<Props> = {\n  readonly renderCallbackProps: Props;\n};\n\ntype ProviderProps<Request, Props extends BaseProps, Init> = PropsWithChildren<{\n  readonly middleware: readonly ComponentMiddleware<Request, Props, Init>[];\n}> &\n  (Init extends never | void\n    ? { readonly init?: undefined }\n    : Init extends undefined | void\n      ? { readonly init?: Init }\n      : { readonly init: Init });\n\ntype ProxyProps<Request, Props extends BaseProps> = Props & {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n  readonly request: Request;\n};\n\ntype InferenceHelper<Request, Props extends BaseProps, Init> = {\n  readonly '~types': {\n    readonly init: Init;\n    readonly middleware: ComponentMiddleware<Request, Props, Init>;\n    readonly props: Props;\n    readonly proxyProps: ProxyProps<Request, Props>;\n    readonly providerProps: ProviderProps<Request, Props, Init>;\n    readonly request: Request;\n  };\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferInit<T extends InferenceHelper<any, any, any>> = T['~types']['init'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferMiddleware<T extends InferenceHelper<any, any, any>> = T['~types']['middleware'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProps<T extends InferenceHelper<any, any, any>> = T['~types']['props'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProxyProps<T extends InferenceHelper<any, any, any>> = T['~types']['proxyProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProviderProps<T extends InferenceHelper<any, any, any>> = T['~types']['providerProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferRequest<T extends InferenceHelper<any, any, any>> = T['~types']['request'];\n\nfunction createChainOfResponsibility<\n  Request = void,\n  Props extends BaseProps = { readonly children?: never },\n  Init = void\n>(options: CreateChainOfResponsibilityOptions = {}): ChainOfResponsibility<Request, Props, Init> {\n  // Freeze options to prevent accidental change.\n  options = Object.freeze({ ...options });\n\n  const BuildContext = createContext<BuildContextType<Request, Props>>(\n    Object.freeze({ enhancer: next => request => next(request) })\n  );\n\n  const RenderContext = createContext<RenderContextType<Props>>(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new Proxy({} as any, {\n      get() {\n        // The following is assertion, there is no way to hit this line.\n        /* istanbul ignore next */\n        throw new Error(\n          'react-chain-of-responsibility: this hook cannot be used outside of <Proxy> and useBuildRenderCallback()'\n        );\n      }\n    })\n  );\n\n  function reactComponent<P extends Props>(\n    component: ComponentType<P>,\n    bindProps?:\n      | (Partial<Props> & Omit<P, keyof Props>)\n      | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n      | undefined\n  ): ComponentHandlerResult<Props> {\n    return Object.freeze({\n      [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined,\n      render: (overridingProps?: Partial<Props> | undefined) => (\n        <ComponentWithProps\n          bindProps={bindProps}\n          component={component as ComponentType<Props>}\n          overridingProps={overridingProps}\n        />\n      )\n    });\n  }\n\n  const ComponentWithProps = memo(function ComponentWithProps({\n    bindProps,\n    component: Component,\n    overridingProps\n  }: {\n    readonly bindProps?: Partial<Props> | ((props: Props) => Partial<Props>) | undefined;\n    readonly component: ComponentType<Props>;\n    readonly overridingProps?: Partial<Props> | undefined;\n  }) {\n    const { allowOverrideProps } = options;\n    const { renderCallbackProps } = useContext(RenderContext);\n\n    if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {\n      console.warn('react-chain-of-responsibility: \"allowOverrideProps\" must be set to true to override props');\n    }\n\n    const props = Object.freeze(\n      allowOverrideProps ? { ...renderCallbackProps, ...overridingProps } : { ...renderCallbackProps }\n    );\n\n    return <Component {...props} {...(typeof bindProps === 'function' ? bindProps(props) : bindProps)} />;\n  });\n\n  const useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props> = () => {\n    const { enhancer } = useContext(BuildContext);\n\n    return useCallback(\n      (request, buildOptions = {}) => {\n        const result =\n          // Put the \"fallbackComponent\" as the last one in the chain.\n          enhancer(() => {\n            const { fallbackComponent } = buildOptions;\n\n            if (!fallbackComponent) {\n              console.warn(\n                'react-chain-of-responsibility: the request has fall through all middleware, set \"fallbackComponent\" as a catchall',\n                request\n              );\n\n              // For clarity, we are returning `undefined` instead of `() => undefined`.\n              return;\n            }\n\n            return Object.freeze({\n              // Convert fallback component as renderer.\n              [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined,\n              render: () => (\n                // Currently, there are no ways to set `bindProps` to `fallbackComponent`.\n                // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.\n                <ComponentWithProps component={fallbackComponent} />\n              )\n            });\n          })(request);\n\n        return (\n          result &&\n          ((props: Props) => {\n            const renderCallbackProps = useMemoValueWithEquality<Props>(() => props, arePropsEqual);\n\n            const context = useMemo<RenderContextType<Props>>(\n              () => Object.freeze({ renderCallbackProps }),\n              [renderCallbackProps]\n            );\n\n            return <RenderContext.Provider value={context}>{result.render()}</RenderContext.Provider>;\n          })\n        );\n      },\n      [enhancer]\n    );\n  };\n\n  function ChainOfResponsibilityProvider({ children, init, middleware }: ProviderProps<Request, Props, Init>) {\n    if (!Array.isArray(middleware) || middleware.some(middleware => typeof middleware !== 'function')) {\n      throw new Error('react-chain-of-responsibility: \"middleware\" prop must be an array of functions');\n    }\n\n    // Remap the middleware, so all inputs/outputs are validated.\n    const fortifiedMiddleware = useMemo(\n      () =>\n        Object.freeze(\n          middleware.map<ComponentMiddleware<Request, Props, Init>>(fn => (init: Init) => {\n            const enhancer = fn(init);\n\n            return next => originalRequest => {\n              // False positive: although we did not re-assign the variable from true, it was initialized as undefined.\n              // eslint-disable-next-line prefer-const\n              let hasReturned: boolean;\n\n              const returnValue = enhancer(nextRequest => {\n                if (hasReturned) {\n                  throw new Error(\n                    'react-chain-of-responsibility: next() cannot be called after the function had returned synchronously'\n                  );\n                }\n\n                // We do not allow passing void/undefined to next() because it would be confusing whether to keep the original request or pass an undefined.\n                !options.passModifiedRequest &&\n                  !Object.is(nextRequest, originalRequest) &&\n                  console.warn(\n                    'react-chain-of-responsibility: next() must be called with the original request, otherwise, set \"options.passModifiedRequest\" to true to pass a different request object downstream'\n                  );\n\n                return next(options.passModifiedRequest ? nextRequest : originalRequest);\n              })(originalRequest);\n\n              hasReturned = true;\n\n              // Make sure the return value is built using our helper function for forward-compatibility reason.\n              return returnValue && parse(componentHandlerResultSchema, returnValue);\n            };\n          })\n        ),\n      [middleware]\n    );\n\n    const { enhancer: parentEnhancer } = useContext(BuildContext);\n\n    const enhancer = useMemo<ComponentEnhancer<Request, Props>>(\n      () =>\n        // We are reversing because it is easier to read:\n        // - With reverse, [a, b, c] will become a(b(c(fn)))\n        // - Without reverse, [a, b, c] will become c(b(a(fn)))\n        applyMiddleware<ComponentHandlerResult<Props> | undefined, Request, Init>(\n          ...[...fortifiedMiddleware, ...[() => parentEnhancer]]\n        )(init as Init),\n      [init, fortifiedMiddleware, parentEnhancer]\n    );\n\n    const contextValue = useMemo<BuildContextType<Request, Props>>(() => Object.freeze({ enhancer }), [enhancer]);\n\n    return <BuildContext.Provider value={contextValue}>{children}</BuildContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProxy({ fallbackComponent, request, ...props }: ProxyProps<Request, Props>) {\n    const result = useBuildRenderCallback()(request, { fallbackComponent })?.(props as Props);\n\n    return result ? <Fragment>{result}</Fragment> : null;\n  }\n\n  const MemoizedChainOfResponsibilityProvider =\n    memo<ProviderProps<Request, Props, Init>>(ChainOfResponsibilityProvider);\n\n  return Object.freeze({\n    Provider: MemoizedChainOfResponsibilityProvider as typeof MemoizedChainOfResponsibilityProvider &\n      InferenceHelper<Request, Props, Init>,\n    Proxy: memo<ProxyProps<Request, Props>>(ChainOfResponsibilityProxy),\n    reactComponent,\n    useBuildRenderCallback\n\n    // TODO: Consider adding back `asMiddleware`.\n  });\n}\n\nexport default createChainOfResponsibility;\nexport {\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport default function arePropsEqual<T extends Record<string, any>>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n\n  const mapOfX = new Map(Object.entries(x));\n  const mapOfY = new Map(Object.entries(y));\n\n  if (mapOfX.size !== mapOfY.size) {\n    return false;\n  }\n\n  const keys = new Set([...mapOfX.keys(), ...mapOfY.keys()]);\n\n  for (const key of keys) {\n    if (!Object.is(mapOfX.get(key), mapOfY.get(key))) {\n      return false;\n    }\n  }\n\n  return true;\n}\n","import { useEffect, useRef } from 'react';\n\nconst NOT_INITIALIZED = Symbol();\n\nexport default function useMemoValueWithEquality<T>(factory: () => T, equalityFn: (x: T, y: T) => boolean): T {\n  const prevRef = useRef<T | typeof NOT_INITIALIZED>(NOT_INITIALIZED);\n  const next: T = factory();\n  const current: T = prevRef.current !== NOT_INITIALIZED && equalityFn(prevRef.current, next) ? prevRef.current : next;\n\n  useEffect(() => {\n    prevRef.current = current;\n  });\n\n  return current;\n}\n"],"mappings":"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","names":["import_react","React","ComponentWithProps","middleware","init","enhancer"]}
+{"version":3,"sources":["../src/index.preview.ts","../src/preview/createChainOfResponsibilityAsRenderCallback.tsx","../src/preview/private/arePropsEqual.ts"],"sourcesContent":["export {\n  default as createChainOfResponsibility,\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n} from './preview/createChainOfResponsibilityAsRenderCallback.tsx';\n","import { applyMiddleware } from 'handler-chain';\nimport React, {\n  createContext,\n  Fragment,\n  memo,\n  useCallback,\n  useContext,\n  useMemo,\n  type ComponentType,\n  type PropsWithChildren,\n  type ReactNode\n} from 'react';\nimport { custom, function_, object, parse, safeParse } from 'valibot';\n\nimport arePropsEqual from './private/arePropsEqual.ts';\n\n// TODO: Related to https://github.com/microsoft/TypeScript/issues/17002.\n//       typescript@5.2.2 has a bug, Array.isArray() is a type predicate but only works with mutable array, not readonly array.\ndeclare global {\n  interface ArrayConstructor {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    isArray(arg: any): arg is readonly any[];\n  }\n}\n\ntype BaseProps = object;\n\ntype CreateChainOfResponsibilityOptions = {\n  /**\n   * Allows one component to pass different set of props to its downstream component. Default is false.\n   *\n   * It is recommended to keep this settings as default to prevent newly added component from unexpectedly changing behavior of downstream components.\n   */\n  readonly allowOverrideProps?: boolean | undefined;\n\n  /**\n   * Allows a middleware to pass another request object when calling its next middleware. Default is false.\n   *\n   * It is recommended to keep this settings as default ot prevent newly added middleware from unexpectedly changing behavior of downstream middleware.\n   *\n   * To prevent upstream middleware from modifying the request, the request object should be set to be immutable through `Object.freeze`.\n   */\n  readonly passModifiedRequest?: boolean | undefined;\n};\n\ntype ChainOfResponsibility<Request, Props extends BaseProps, Init> = {\n  readonly Provider: ComponentType<ProviderProps<Request, Props, Init>> & InferenceHelper<Request, Props, Init>;\n  readonly Proxy: ComponentType<ProxyProps<Request, Props>>;\n  readonly reactComponent: ReactComponentHandlerResult<Props>;\n  readonly useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props>;\n};\n\n// TODO: Maybe this one should be local.\n//       Verify that reactComponent() from an instance of CoR should throw error when used in another instance of CoR.\nconst DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();\n\ntype ComponentRenderer<Props> = (props: Props) => ReactNode;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst componentHandlerResultSchema = custom<ComponentHandlerResult<any>>(\n  value =>\n    safeParse(object({ render: function_() }), value).success &&\n    !!value &&\n    typeof value === 'object' &&\n    DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,\n  'react-chain-of-responsibility: middleware must return value constructed by reactComponent()'\n);\n\ninterface ComponentHandlerResult<Props extends BaseProps> {\n  readonly [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined;\n  readonly render: (overridingProps?: Partial<Props> | undefined) => ReactNode;\n}\n\ntype ComponentHandler<Request, Props extends BaseProps> = (\n  request: Request\n) => ComponentHandlerResult<Props> | undefined;\n\ntype ComponentEnhancer<Request, Props extends BaseProps> = (\n  next: ComponentHandler<Request, Props>\n) => ComponentHandler<Request, Props>;\n\ntype ComponentMiddleware<Request, Props extends BaseProps, Init = undefined> = (\n  init: Init\n) => ComponentEnhancer<Request, Props>;\n\ntype ReactComponentHandlerResult<Props extends object> = <P extends Props>(\n  component: ComponentType<P>,\n  bindProps?:\n    | (Partial<Props> & Omit<P, keyof Props>)\n    | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n    | undefined\n) => ComponentHandlerResult<Props>;\n\ntype UseBuildRenderCallbackOptions<Props> = {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n};\n\ninterface UseBuildRenderCallback<Request, Props extends BaseProps> {\n  (request: Request, options?: undefined | UseBuildRenderCallbackOptions<Props>): ComponentRenderer<Props> | undefined;\n}\n\ntype BuildContextType<Request, Props extends BaseProps> = {\n  readonly enhancer: ComponentEnhancer<Request, Props>;\n};\n\ntype RenderContextType<Props> = {\n  readonly originalProps: Props;\n};\n\ntype ProviderProps<Request, Props extends BaseProps, Init> = PropsWithChildren<{\n  readonly middleware: readonly ComponentMiddleware<Request, Props, Init>[];\n}> &\n  (Init extends never | void\n    ? { readonly init?: undefined }\n    : Init extends undefined | void\n      ? { readonly init?: Init }\n      : { readonly init: Init });\n\ntype ProxyProps<Request, Props extends BaseProps> = Props & {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n  readonly request: Request;\n};\n\ntype InferenceHelper<Request, Props extends BaseProps, Init> = {\n  readonly '~types': {\n    readonly init: Init;\n    readonly middleware: ComponentMiddleware<Request, Props, Init>;\n    readonly props: Props;\n    readonly proxyProps: ProxyProps<Request, Props>;\n    readonly providerProps: ProviderProps<Request, Props, Init>;\n    readonly request: Request;\n  };\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferInit<T extends InferenceHelper<any, any, any>> = T['~types']['init'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferMiddleware<T extends InferenceHelper<any, any, any>> = T['~types']['middleware'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProps<T extends InferenceHelper<any, any, any>> = T['~types']['props'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProxyProps<T extends InferenceHelper<any, any, any>> = T['~types']['proxyProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProviderProps<T extends InferenceHelper<any, any, any>> = T['~types']['providerProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferRequest<T extends InferenceHelper<any, any, any>> = T['~types']['request'];\n\nfunction createComponentHandlerResult<Props extends BaseProps>(\n  render: (overridingProps?: Partial<Props> | undefined) => ReactNode\n): ComponentHandlerResult<Props> {\n  return Object.freeze({ [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined, render });\n}\n\nfunction createChainOfResponsibility<\n  Request = void,\n  Props extends BaseProps = { readonly children?: never },\n  Init = void\n>(options: CreateChainOfResponsibilityOptions = {}): ChainOfResponsibility<Request, Props, Init> {\n  // Freeze options to prevent accidental change.\n  options = Object.freeze({ ...options });\n\n  const BuildContext = createContext<BuildContextType<Request, Props>>(\n    Object.freeze({ enhancer: next => request => next(request) })\n  );\n\n  const RenderContext = createContext<RenderContextType<Props>>(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new Proxy({} as any, {\n      get() {\n        // The following is assertion, there is no way to hit this line.\n        /* istanbul ignore next */\n        throw new Error(\n          'react-chain-of-responsibility: this hook cannot be used outside of <Proxy> and useBuildRenderCallback()'\n        );\n      }\n    })\n  );\n\n  function reactComponent<P extends Props>(\n    component: ComponentType<P>,\n    // For `bindProps` of type function, do not do side-effect in it, it may not be always called in all scenarios.\n    bindProps?:\n      | (Partial<Props> & Omit<P, keyof Props>)\n      | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n      | undefined\n  ): ComponentHandlerResult<Props> {\n    return createComponentHandlerResult((overridingProps?: Partial<Props> | undefined) => (\n      <ComponentWithProps\n        bindProps={bindProps}\n        component={component as ComponentType<Props>}\n        overridingProps={overridingProps}\n      />\n    ));\n  }\n\n  const ComponentWithProps = memo(function ComponentWithProps({\n    bindProps,\n    component: Component,\n    overridingProps\n  }: {\n    readonly bindProps?: Partial<Props> | ((props: Props) => Partial<Props>) | undefined;\n    readonly component: ComponentType<Props>;\n    readonly overridingProps?: Partial<Props> | undefined;\n  }) {\n    const { allowOverrideProps } = options;\n    const { originalProps: renderCallbackProps } = useContext(RenderContext);\n\n    if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {\n      console.warn('react-chain-of-responsibility: \"allowOverrideProps\" must be set to true to override props');\n    }\n\n    const props = Object.freeze(\n      allowOverrideProps ? { ...renderCallbackProps, ...overridingProps } : { ...renderCallbackProps }\n    );\n\n    return <Component {...props} {...(typeof bindProps === 'function' ? bindProps(props) : bindProps)} />;\n  });\n\n  const useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props> = () => {\n    const { enhancer } = useContext(BuildContext);\n\n    return useCallback(\n      (request, buildOptions = {}) => {\n        const result =\n          // Put the \"fallbackComponent\" as the last one in the chain.\n          enhancer(() => {\n            const { fallbackComponent } = buildOptions;\n\n            if (!fallbackComponent) {\n              console.warn(\n                'react-chain-of-responsibility: the request has fall through all middleware, set \"fallbackComponent\" as a catchall',\n                request\n              );\n\n              // For clarity, we are returning `undefined` instead of `() => undefined`.\n              return;\n            }\n\n            // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.\n            return reactComponent(fallbackComponent);\n          })(request);\n\n        return (\n          result &&\n          ((originalProps: Props) => (\n            // This is render function, we cannot call any hooks here.\n            <BuildRenderCallback originalProps={originalProps} render={result.render} />\n          ))\n        );\n      },\n      [enhancer]\n    );\n  };\n\n  type BuildRenderCallbackProps = {\n    readonly originalProps: Props;\n    readonly render: () => ReactNode;\n  };\n\n  // Do not memoize <BuildRenderCallback>.\n  // `bindProps` may have side effect and we want to be re-rendered to capture the side-effect.\n  // To prevent wasted render, web devs should memoize it themselves.\n  function BuildRenderCallback({ originalProps, render }: BuildRenderCallbackProps) {\n    const context = useMemo<RenderContextType<Props>>(() => Object.freeze({ originalProps }), [originalProps]);\n\n    return <RenderContext.Provider value={context}>{render()}</RenderContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProvider({ children, init, middleware }: ProviderProps<Request, Props, Init>) {\n    if (!Array.isArray(middleware) || middleware.some(middleware => typeof middleware !== 'function')) {\n      throw new Error('react-chain-of-responsibility: \"middleware\" prop must be an array of functions');\n    }\n\n    // Remap the middleware, so all inputs/outputs are validated.\n    const fortifiedMiddleware = useMemo(\n      () =>\n        Object.freeze(\n          middleware.map<ComponentMiddleware<Request, Props, Init>>(fn => (init: Init) => {\n            const enhancer = fn(init);\n\n            return next => originalRequest => {\n              // False positive: although we did not re-assign the variable from true, it was initialized as undefined.\n              // eslint-disable-next-line prefer-const\n              let hasReturned: boolean;\n\n              const returnValue = enhancer(nextRequest => {\n                if (hasReturned) {\n                  throw new Error(\n                    'react-chain-of-responsibility: next() cannot be called after the function had returned synchronously'\n                  );\n                }\n\n                // We do not allow passing void/undefined to next() because it would be confusing whether to keep the original request or pass an undefined.\n                !options.passModifiedRequest &&\n                  !Object.is(nextRequest, originalRequest) &&\n                  console.warn(\n                    'react-chain-of-responsibility: next() must be called with the original request, otherwise, set \"options.passModifiedRequest\" to true to pass a different request object downstream'\n                  );\n\n                return next(options.passModifiedRequest ? nextRequest : originalRequest);\n              })(originalRequest);\n\n              hasReturned = true;\n\n              // Make sure the return value is built using our helper function for forward-compatibility reason.\n              return returnValue && parse(componentHandlerResultSchema, returnValue);\n            };\n          })\n        ),\n      [middleware]\n    );\n\n    const { enhancer: parentEnhancer } = useContext(BuildContext);\n\n    const enhancer = useMemo<ComponentEnhancer<Request, Props>>(\n      () =>\n        // We are reversing because it is easier to read:\n        // - With reverse, [a, b, c] will become a(b(c(fn)))\n        // - Without reverse, [a, b, c] will become c(b(a(fn)))\n        applyMiddleware<ComponentHandlerResult<Props> | undefined, Request, Init>(\n          ...[...fortifiedMiddleware, ...[() => parentEnhancer]]\n        )(init as Init),\n      [init, fortifiedMiddleware, parentEnhancer]\n    );\n\n    const contextValue = useMemo<BuildContextType<Request, Props>>(() => Object.freeze({ enhancer }), [enhancer]);\n\n    return <BuildContext.Provider value={contextValue}>{children}</BuildContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProxy({ fallbackComponent, request, ...props }: ProxyProps<Request, Props>) {\n    const result = useBuildRenderCallback()(request, { fallbackComponent })?.(props as Props);\n\n    return result ? <Fragment>{result}</Fragment> : null;\n  }\n\n  const MemoizedChainOfResponsibilityProvider =\n    memo<ProviderProps<Request, Props, Init>>(ChainOfResponsibilityProvider);\n\n  return Object.freeze({\n    Provider: MemoizedChainOfResponsibilityProvider as typeof MemoizedChainOfResponsibilityProvider &\n      InferenceHelper<Request, Props, Init>,\n    Proxy: ChainOfResponsibilityProxy,\n    reactComponent,\n    useBuildRenderCallback\n\n    // TODO: Consider adding back `asMiddleware`.\n  });\n}\n\nexport default createChainOfResponsibility;\nexport {\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport default function arePropsEqual<T extends Record<string, any>>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n\n  const mapOfX = new Map(Object.entries(x));\n  const mapOfY = new Map(Object.entries(y));\n\n  if (mapOfX.size !== mapOfY.size) {\n    return false;\n  }\n\n  const keys = new Set([...mapOfX.keys(), ...mapOfY.keys()]);\n\n  for (const key of keys) {\n    if (!Object.is(mapOfX.get(key), mapOfY.get(key))) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"mappings":"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","names":["React","ComponentWithProps","middleware","init","enhancer"]}

package/dist/react-chain-of-responsibility.preview.mjs

@@ -1,4 +1,4 @@
-// src/createChainOfResponsibilityAsRenderCallback.tsx
+// src/preview/createChainOfResponsibilityAsRenderCallback.tsx
 import { applyMiddleware } from "handler-chain";
 import React, {
   createContext,
@@ -10,7 +10,7 @@ import React, {
 } from "react";
 import { custom, function_, object, parse, safeParse } from "valibot";
 
-// src/private/arePropsEqual.ts
+// src/preview/private/arePropsEqual.ts
 function arePropsEqual(x, y) {
   if (Object.is(x, y)) {
     return true;
@@ -29,25 +29,15 @@ function arePropsEqual(x, y) {
   return true;
 }
 
-// src/private/useMemoValueWithEquality.ts
-import { useEffect, useRef } from "react";
-var NOT_INITIALIZED = Symbol();
-function useMemoValueWithEquality(factory, equalityFn) {
-  const prevRef = useRef(NOT_INITIALIZED);
-  const next = factory();
-  const current = prevRef.current !== NOT_INITIALIZED && equalityFn(prevRef.current, next) ? prevRef.current : next;
-  useEffect(() => {
-    prevRef.current = current;
-  });
-  return current;
-}
-
-// src/createChainOfResponsibilityAsRenderCallback.tsx
+// src/preview/createChainOfResponsibilityAsRenderCallback.tsx
 var DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();
 var componentHandlerResultSchema = custom(
   (value) => safeParse(object({ render: function_() }), value).success && !!value && typeof value === "object" && DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,
   "react-chain-of-responsibility: middleware must return value constructed by reactComponent()"
 );
+function createComponentHandlerResult(render) {
+  return Object.freeze({ [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0, render });
+}
 function createChainOfResponsibility(options = {}) {
   options = Object.freeze({ ...options });
   const BuildContext = createContext(
@@ -64,17 +54,14 @@ function createChainOfResponsibility(options = {}) {
     })
   );
   function reactComponent(component, bindProps) {
-    return Object.freeze({
-      [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0,
-      render: (overridingProps) => /* @__PURE__ */ React.createElement(
-        ComponentWithProps,
-        {
-          bindProps,
-          component,
-          overridingProps
-        }
-      )
-    });
+    return createComponentHandlerResult((overridingProps) => /* @__PURE__ */ React.createElement(
+      ComponentWithProps,
+      {
+        bindProps,
+        component,
+        overridingProps
+      }
+    ));
   }
   const ComponentWithProps = memo(function ComponentWithProps2({
     bindProps,
@@ -82,7 +69,7 @@ function createChainOfResponsibility(options = {}) {
     overridingProps
   }) {
     const { allowOverrideProps } = options;
-    const { renderCallbackProps } = useContext(RenderContext);
+    const { originalProps: renderCallbackProps } = useContext(RenderContext);
     if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {
       console.warn('react-chain-of-responsibility: "allowOverrideProps" must be set to true to override props');
     }
@@ -106,29 +93,21 @@ function createChainOfResponsibility(options = {}) {
               );
               return;
             }
-            return Object.freeze({
-              // Convert fallback component as renderer.
-              [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: void 0,
-              render: () => (
-                // Currently, there are no ways to set `bindProps` to `fallbackComponent`.
-                // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.
-                /* @__PURE__ */ React.createElement(ComponentWithProps, { component: fallbackComponent })
-              )
-            });
+            return reactComponent(fallbackComponent);
           })(request)
         );
-        return result && ((props) => {
-          const renderCallbackProps = useMemoValueWithEquality(() => props, arePropsEqual);
-          const context = useMemo(
-            () => Object.freeze({ renderCallbackProps }),
-            [renderCallbackProps]
-          );
-          return /* @__PURE__ */ React.createElement(RenderContext.Provider, { value: context }, result.render());
-        });
+        return result && ((originalProps) => (
+          // This is render function, we cannot call any hooks here.
+          /* @__PURE__ */ React.createElement(BuildRenderCallback, { originalProps, render: result.render })
+        ));
       },
       [enhancer]
     );
   };
+  function BuildRenderCallback({ originalProps, render }) {
+    const context = useMemo(() => Object.freeze({ originalProps }), [originalProps]);
+    return /* @__PURE__ */ React.createElement(RenderContext.Provider, { value: context }, render());
+  }
   function ChainOfResponsibilityProvider({ children, init, middleware }) {
     if (!Array.isArray(middleware) || middleware.some((middleware2) => typeof middleware2 !== "function")) {
       throw new Error('react-chain-of-responsibility: "middleware" prop must be an array of functions');
@@ -179,7 +158,7 @@ function createChainOfResponsibility(options = {}) {
   const MemoizedChainOfResponsibilityProvider = memo(ChainOfResponsibilityProvider);
   return Object.freeze({
     Provider: MemoizedChainOfResponsibilityProvider,
-    Proxy: memo(ChainOfResponsibilityProxy),
+    Proxy: ChainOfResponsibilityProxy,
     reactComponent,
     useBuildRenderCallback
     // TODO: Consider adding back `asMiddleware`.

package/dist/react-chain-of-responsibility.preview.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/createChainOfResponsibilityAsRenderCallback.tsx","../src/private/arePropsEqual.ts","../src/private/useMemoValueWithEquality.ts"],"sourcesContent":["import { applyMiddleware } from 'handler-chain';\nimport React, {\n  createContext,\n  Fragment,\n  memo,\n  useCallback,\n  useContext,\n  useMemo,\n  type ComponentType,\n  type PropsWithChildren,\n  type ReactNode\n} from 'react';\nimport { custom, function_, object, parse, safeParse } from 'valibot';\n\nimport arePropsEqual from './private/arePropsEqual.ts';\nimport useMemoValueWithEquality from './private/useMemoValueWithEquality.ts';\n\n// TODO: Related to https://github.com/microsoft/TypeScript/issues/17002.\n//       typescript@5.2.2 has a bug, Array.isArray() is a type predicate but only works with mutable array, not readonly array.\ndeclare global {\n  interface ArrayConstructor {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    isArray(arg: any): arg is readonly any[];\n  }\n}\n\ntype BaseProps = object;\n\ntype CreateChainOfResponsibilityOptions = {\n  /**\n   * Allows one component to pass different set of props to its downstream component. Default is false.\n   *\n   * It is recommended to keep this settings as default to prevent newly added component from unexpectedly changing behavior of downstream components.\n   */\n  readonly allowOverrideProps?: boolean | undefined;\n\n  /**\n   * Allows a middleware to pass another request object when calling its next middleware. Default is false.\n   *\n   * It is recommended to keep this settings as default ot prevent newly added middleware from unexpectedly changing behavior of downstream middleware.\n   *\n   * To prevent upstream middleware from modifying the request, the request object should be set to be immutable through `Object.freeze`.\n   */\n  readonly passModifiedRequest?: boolean | undefined;\n};\n\ntype ChainOfResponsibility<Request, Props extends BaseProps, Init> = {\n  readonly Provider: ComponentType<ProviderProps<Request, Props, Init>> & InferenceHelper<Request, Props, Init>;\n  readonly Proxy: ComponentType<ProxyProps<Request, Props>>;\n  readonly reactComponent: ReactComponentHandlerResult<Props>;\n  readonly useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props>;\n};\n\n// TODO: Maybe this one should be local.\n//       Verify that reactComponent() from an instance of CoR should throw error when used in another instance of CoR.\nconst DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();\n\ntype ComponentRenderer<Props> = (props: Props) => ReactNode;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst componentHandlerResultSchema = custom<ComponentHandlerResult<any>>(\n  value =>\n    safeParse(object({ render: function_() }), value).success &&\n    !!value &&\n    typeof value === 'object' &&\n    DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,\n  'react-chain-of-responsibility: middleware must return value constructed by reactComponent()'\n);\n\ninterface ComponentHandlerResult<Props extends BaseProps> {\n  readonly [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined;\n  readonly render: (overridingProps?: Partial<Props> | undefined) => ReactNode;\n}\n\ntype ComponentHandler<Request, Props extends BaseProps> = (\n  request: Request\n) => ComponentHandlerResult<Props> | undefined;\n\ntype ComponentEnhancer<Request, Props extends BaseProps> = (\n  next: ComponentHandler<Request, Props>\n) => ComponentHandler<Request, Props>;\n\ntype ComponentMiddleware<Request, Props extends BaseProps, Init = undefined> = (\n  init: Init\n) => ComponentEnhancer<Request, Props>;\n\ntype ReactComponentHandlerResult<Props extends object> = <P extends Props>(\n  component: ComponentType<P>,\n  bindProps?:\n    | (Partial<Props> & Omit<P, keyof Props>)\n    | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n    | undefined\n) => ComponentHandlerResult<Props>;\n\ntype UseBuildRenderCallbackOptions<Props> = {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n};\n\ninterface UseBuildRenderCallback<Request, Props extends BaseProps> {\n  (request: Request, options?: undefined | UseBuildRenderCallbackOptions<Props>): ComponentRenderer<Props> | undefined;\n}\n\ntype BuildContextType<Request, Props extends BaseProps> = {\n  readonly enhancer: ComponentEnhancer<Request, Props>;\n};\n\ntype RenderContextType<Props> = {\n  readonly renderCallbackProps: Props;\n};\n\ntype ProviderProps<Request, Props extends BaseProps, Init> = PropsWithChildren<{\n  readonly middleware: readonly ComponentMiddleware<Request, Props, Init>[];\n}> &\n  (Init extends never | void\n    ? { readonly init?: undefined }\n    : Init extends undefined | void\n      ? { readonly init?: Init }\n      : { readonly init: Init });\n\ntype ProxyProps<Request, Props extends BaseProps> = Props & {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n  readonly request: Request;\n};\n\ntype InferenceHelper<Request, Props extends BaseProps, Init> = {\n  readonly '~types': {\n    readonly init: Init;\n    readonly middleware: ComponentMiddleware<Request, Props, Init>;\n    readonly props: Props;\n    readonly proxyProps: ProxyProps<Request, Props>;\n    readonly providerProps: ProviderProps<Request, Props, Init>;\n    readonly request: Request;\n  };\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferInit<T extends InferenceHelper<any, any, any>> = T['~types']['init'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferMiddleware<T extends InferenceHelper<any, any, any>> = T['~types']['middleware'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProps<T extends InferenceHelper<any, any, any>> = T['~types']['props'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProxyProps<T extends InferenceHelper<any, any, any>> = T['~types']['proxyProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProviderProps<T extends InferenceHelper<any, any, any>> = T['~types']['providerProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferRequest<T extends InferenceHelper<any, any, any>> = T['~types']['request'];\n\nfunction createChainOfResponsibility<\n  Request = void,\n  Props extends BaseProps = { readonly children?: never },\n  Init = void\n>(options: CreateChainOfResponsibilityOptions = {}): ChainOfResponsibility<Request, Props, Init> {\n  // Freeze options to prevent accidental change.\n  options = Object.freeze({ ...options });\n\n  const BuildContext = createContext<BuildContextType<Request, Props>>(\n    Object.freeze({ enhancer: next => request => next(request) })\n  );\n\n  const RenderContext = createContext<RenderContextType<Props>>(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new Proxy({} as any, {\n      get() {\n        // The following is assertion, there is no way to hit this line.\n        /* istanbul ignore next */\n        throw new Error(\n          'react-chain-of-responsibility: this hook cannot be used outside of <Proxy> and useBuildRenderCallback()'\n        );\n      }\n    })\n  );\n\n  function reactComponent<P extends Props>(\n    component: ComponentType<P>,\n    bindProps?:\n      | (Partial<Props> & Omit<P, keyof Props>)\n      | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n      | undefined\n  ): ComponentHandlerResult<Props> {\n    return Object.freeze({\n      [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined,\n      render: (overridingProps?: Partial<Props> | undefined) => (\n        <ComponentWithProps\n          bindProps={bindProps}\n          component={component as ComponentType<Props>}\n          overridingProps={overridingProps}\n        />\n      )\n    });\n  }\n\n  const ComponentWithProps = memo(function ComponentWithProps({\n    bindProps,\n    component: Component,\n    overridingProps\n  }: {\n    readonly bindProps?: Partial<Props> | ((props: Props) => Partial<Props>) | undefined;\n    readonly component: ComponentType<Props>;\n    readonly overridingProps?: Partial<Props> | undefined;\n  }) {\n    const { allowOverrideProps } = options;\n    const { renderCallbackProps } = useContext(RenderContext);\n\n    if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {\n      console.warn('react-chain-of-responsibility: \"allowOverrideProps\" must be set to true to override props');\n    }\n\n    const props = Object.freeze(\n      allowOverrideProps ? { ...renderCallbackProps, ...overridingProps } : { ...renderCallbackProps }\n    );\n\n    return <Component {...props} {...(typeof bindProps === 'function' ? bindProps(props) : bindProps)} />;\n  });\n\n  const useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props> = () => {\n    const { enhancer } = useContext(BuildContext);\n\n    return useCallback(\n      (request, buildOptions = {}) => {\n        const result =\n          // Put the \"fallbackComponent\" as the last one in the chain.\n          enhancer(() => {\n            const { fallbackComponent } = buildOptions;\n\n            if (!fallbackComponent) {\n              console.warn(\n                'react-chain-of-responsibility: the request has fall through all middleware, set \"fallbackComponent\" as a catchall',\n                request\n              );\n\n              // For clarity, we are returning `undefined` instead of `() => undefined`.\n              return;\n            }\n\n            return Object.freeze({\n              // Convert fallback component as renderer.\n              [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined,\n              render: () => (\n                // Currently, there are no ways to set `bindProps` to `fallbackComponent`.\n                // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.\n                <ComponentWithProps component={fallbackComponent} />\n              )\n            });\n          })(request);\n\n        return (\n          result &&\n          ((props: Props) => {\n            const renderCallbackProps = useMemoValueWithEquality<Props>(() => props, arePropsEqual);\n\n            const context = useMemo<RenderContextType<Props>>(\n              () => Object.freeze({ renderCallbackProps }),\n              [renderCallbackProps]\n            );\n\n            return <RenderContext.Provider value={context}>{result.render()}</RenderContext.Provider>;\n          })\n        );\n      },\n      [enhancer]\n    );\n  };\n\n  function ChainOfResponsibilityProvider({ children, init, middleware }: ProviderProps<Request, Props, Init>) {\n    if (!Array.isArray(middleware) || middleware.some(middleware => typeof middleware !== 'function')) {\n      throw new Error('react-chain-of-responsibility: \"middleware\" prop must be an array of functions');\n    }\n\n    // Remap the middleware, so all inputs/outputs are validated.\n    const fortifiedMiddleware = useMemo(\n      () =>\n        Object.freeze(\n          middleware.map<ComponentMiddleware<Request, Props, Init>>(fn => (init: Init) => {\n            const enhancer = fn(init);\n\n            return next => originalRequest => {\n              // False positive: although we did not re-assign the variable from true, it was initialized as undefined.\n              // eslint-disable-next-line prefer-const\n              let hasReturned: boolean;\n\n              const returnValue = enhancer(nextRequest => {\n                if (hasReturned) {\n                  throw new Error(\n                    'react-chain-of-responsibility: next() cannot be called after the function had returned synchronously'\n                  );\n                }\n\n                // We do not allow passing void/undefined to next() because it would be confusing whether to keep the original request or pass an undefined.\n                !options.passModifiedRequest &&\n                  !Object.is(nextRequest, originalRequest) &&\n                  console.warn(\n                    'react-chain-of-responsibility: next() must be called with the original request, otherwise, set \"options.passModifiedRequest\" to true to pass a different request object downstream'\n                  );\n\n                return next(options.passModifiedRequest ? nextRequest : originalRequest);\n              })(originalRequest);\n\n              hasReturned = true;\n\n              // Make sure the return value is built using our helper function for forward-compatibility reason.\n              return returnValue && parse(componentHandlerResultSchema, returnValue);\n            };\n          })\n        ),\n      [middleware]\n    );\n\n    const { enhancer: parentEnhancer } = useContext(BuildContext);\n\n    const enhancer = useMemo<ComponentEnhancer<Request, Props>>(\n      () =>\n        // We are reversing because it is easier to read:\n        // - With reverse, [a, b, c] will become a(b(c(fn)))\n        // - Without reverse, [a, b, c] will become c(b(a(fn)))\n        applyMiddleware<ComponentHandlerResult<Props> | undefined, Request, Init>(\n          ...[...fortifiedMiddleware, ...[() => parentEnhancer]]\n        )(init as Init),\n      [init, fortifiedMiddleware, parentEnhancer]\n    );\n\n    const contextValue = useMemo<BuildContextType<Request, Props>>(() => Object.freeze({ enhancer }), [enhancer]);\n\n    return <BuildContext.Provider value={contextValue}>{children}</BuildContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProxy({ fallbackComponent, request, ...props }: ProxyProps<Request, Props>) {\n    const result = useBuildRenderCallback()(request, { fallbackComponent })?.(props as Props);\n\n    return result ? <Fragment>{result}</Fragment> : null;\n  }\n\n  const MemoizedChainOfResponsibilityProvider =\n    memo<ProviderProps<Request, Props, Init>>(ChainOfResponsibilityProvider);\n\n  return Object.freeze({\n    Provider: MemoizedChainOfResponsibilityProvider as typeof MemoizedChainOfResponsibilityProvider &\n      InferenceHelper<Request, Props, Init>,\n    Proxy: memo<ProxyProps<Request, Props>>(ChainOfResponsibilityProxy),\n    reactComponent,\n    useBuildRenderCallback\n\n    // TODO: Consider adding back `asMiddleware`.\n  });\n}\n\nexport default createChainOfResponsibility;\nexport {\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport default function arePropsEqual<T extends Record<string, any>>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n\n  const mapOfX = new Map(Object.entries(x));\n  const mapOfY = new Map(Object.entries(y));\n\n  if (mapOfX.size !== mapOfY.size) {\n    return false;\n  }\n\n  const keys = new Set([...mapOfX.keys(), ...mapOfY.keys()]);\n\n  for (const key of keys) {\n    if (!Object.is(mapOfX.get(key), mapOfY.get(key))) {\n      return false;\n    }\n  }\n\n  return true;\n}\n","import { useEffect, useRef } from 'react';\n\nconst NOT_INITIALIZED = Symbol();\n\nexport default function useMemoValueWithEquality<T>(factory: () => T, equalityFn: (x: T, y: T) => boolean): T {\n  const prevRef = useRef<T | typeof NOT_INITIALIZED>(NOT_INITIALIZED);\n  const next: T = factory();\n  const current: T = prevRef.current !== NOT_INITIALIZED && equalityFn(prevRef.current, next) ? prevRef.current : next;\n\n  useEffect(() => {\n    prevRef.current = current;\n  });\n\n  return current;\n}\n"],"mappings":"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","names":["ComponentWithProps","middleware","init","enhancer"]}
+{"version":3,"sources":["../src/preview/createChainOfResponsibilityAsRenderCallback.tsx","../src/preview/private/arePropsEqual.ts"],"sourcesContent":["import { applyMiddleware } from 'handler-chain';\nimport React, {\n  createContext,\n  Fragment,\n  memo,\n  useCallback,\n  useContext,\n  useMemo,\n  type ComponentType,\n  type PropsWithChildren,\n  type ReactNode\n} from 'react';\nimport { custom, function_, object, parse, safeParse } from 'valibot';\n\nimport arePropsEqual from './private/arePropsEqual.ts';\n\n// TODO: Related to https://github.com/microsoft/TypeScript/issues/17002.\n//       typescript@5.2.2 has a bug, Array.isArray() is a type predicate but only works with mutable array, not readonly array.\ndeclare global {\n  interface ArrayConstructor {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    isArray(arg: any): arg is readonly any[];\n  }\n}\n\ntype BaseProps = object;\n\ntype CreateChainOfResponsibilityOptions = {\n  /**\n   * Allows one component to pass different set of props to its downstream component. Default is false.\n   *\n   * It is recommended to keep this settings as default to prevent newly added component from unexpectedly changing behavior of downstream components.\n   */\n  readonly allowOverrideProps?: boolean | undefined;\n\n  /**\n   * Allows a middleware to pass another request object when calling its next middleware. Default is false.\n   *\n   * It is recommended to keep this settings as default ot prevent newly added middleware from unexpectedly changing behavior of downstream middleware.\n   *\n   * To prevent upstream middleware from modifying the request, the request object should be set to be immutable through `Object.freeze`.\n   */\n  readonly passModifiedRequest?: boolean | undefined;\n};\n\ntype ChainOfResponsibility<Request, Props extends BaseProps, Init> = {\n  readonly Provider: ComponentType<ProviderProps<Request, Props, Init>> & InferenceHelper<Request, Props, Init>;\n  readonly Proxy: ComponentType<ProxyProps<Request, Props>>;\n  readonly reactComponent: ReactComponentHandlerResult<Props>;\n  readonly useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props>;\n};\n\n// TODO: Maybe this one should be local.\n//       Verify that reactComponent() from an instance of CoR should throw error when used in another instance of CoR.\nconst DO_NOT_CREATE_THIS_OBJECT_YOURSELF = Symbol();\n\ntype ComponentRenderer<Props> = (props: Props) => ReactNode;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst componentHandlerResultSchema = custom<ComponentHandlerResult<any>>(\n  value =>\n    safeParse(object({ render: function_() }), value).success &&\n    !!value &&\n    typeof value === 'object' &&\n    DO_NOT_CREATE_THIS_OBJECT_YOURSELF in value,\n  'react-chain-of-responsibility: middleware must return value constructed by reactComponent()'\n);\n\ninterface ComponentHandlerResult<Props extends BaseProps> {\n  readonly [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined;\n  readonly render: (overridingProps?: Partial<Props> | undefined) => ReactNode;\n}\n\ntype ComponentHandler<Request, Props extends BaseProps> = (\n  request: Request\n) => ComponentHandlerResult<Props> | undefined;\n\ntype ComponentEnhancer<Request, Props extends BaseProps> = (\n  next: ComponentHandler<Request, Props>\n) => ComponentHandler<Request, Props>;\n\ntype ComponentMiddleware<Request, Props extends BaseProps, Init = undefined> = (\n  init: Init\n) => ComponentEnhancer<Request, Props>;\n\ntype ReactComponentHandlerResult<Props extends object> = <P extends Props>(\n  component: ComponentType<P>,\n  bindProps?:\n    | (Partial<Props> & Omit<P, keyof Props>)\n    | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n    | undefined\n) => ComponentHandlerResult<Props>;\n\ntype UseBuildRenderCallbackOptions<Props> = {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n};\n\ninterface UseBuildRenderCallback<Request, Props extends BaseProps> {\n  (request: Request, options?: undefined | UseBuildRenderCallbackOptions<Props>): ComponentRenderer<Props> | undefined;\n}\n\ntype BuildContextType<Request, Props extends BaseProps> = {\n  readonly enhancer: ComponentEnhancer<Request, Props>;\n};\n\ntype RenderContextType<Props> = {\n  readonly originalProps: Props;\n};\n\ntype ProviderProps<Request, Props extends BaseProps, Init> = PropsWithChildren<{\n  readonly middleware: readonly ComponentMiddleware<Request, Props, Init>[];\n}> &\n  (Init extends never | void\n    ? { readonly init?: undefined }\n    : Init extends undefined | void\n      ? { readonly init?: Init }\n      : { readonly init: Init });\n\ntype ProxyProps<Request, Props extends BaseProps> = Props & {\n  readonly fallbackComponent?: ComponentType<Props> | undefined;\n  readonly request: Request;\n};\n\ntype InferenceHelper<Request, Props extends BaseProps, Init> = {\n  readonly '~types': {\n    readonly init: Init;\n    readonly middleware: ComponentMiddleware<Request, Props, Init>;\n    readonly props: Props;\n    readonly proxyProps: ProxyProps<Request, Props>;\n    readonly providerProps: ProviderProps<Request, Props, Init>;\n    readonly request: Request;\n  };\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferInit<T extends InferenceHelper<any, any, any>> = T['~types']['init'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferMiddleware<T extends InferenceHelper<any, any, any>> = T['~types']['middleware'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProps<T extends InferenceHelper<any, any, any>> = T['~types']['props'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProxyProps<T extends InferenceHelper<any, any, any>> = T['~types']['proxyProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferProviderProps<T extends InferenceHelper<any, any, any>> = T['~types']['providerProps'];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InferRequest<T extends InferenceHelper<any, any, any>> = T['~types']['request'];\n\nfunction createComponentHandlerResult<Props extends BaseProps>(\n  render: (overridingProps?: Partial<Props> | undefined) => ReactNode\n): ComponentHandlerResult<Props> {\n  return Object.freeze({ [DO_NOT_CREATE_THIS_OBJECT_YOURSELF]: undefined, render });\n}\n\nfunction createChainOfResponsibility<\n  Request = void,\n  Props extends BaseProps = { readonly children?: never },\n  Init = void\n>(options: CreateChainOfResponsibilityOptions = {}): ChainOfResponsibility<Request, Props, Init> {\n  // Freeze options to prevent accidental change.\n  options = Object.freeze({ ...options });\n\n  const BuildContext = createContext<BuildContextType<Request, Props>>(\n    Object.freeze({ enhancer: next => request => next(request) })\n  );\n\n  const RenderContext = createContext<RenderContextType<Props>>(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new Proxy({} as any, {\n      get() {\n        // The following is assertion, there is no way to hit this line.\n        /* istanbul ignore next */\n        throw new Error(\n          'react-chain-of-responsibility: this hook cannot be used outside of <Proxy> and useBuildRenderCallback()'\n        );\n      }\n    })\n  );\n\n  function reactComponent<P extends Props>(\n    component: ComponentType<P>,\n    // For `bindProps` of type function, do not do side-effect in it, it may not be always called in all scenarios.\n    bindProps?:\n      | (Partial<Props> & Omit<P, keyof Props>)\n      | ((props: Props) => Partial<Props> & Omit<P, keyof Props>)\n      | undefined\n  ): ComponentHandlerResult<Props> {\n    return createComponentHandlerResult((overridingProps?: Partial<Props> | undefined) => (\n      <ComponentWithProps\n        bindProps={bindProps}\n        component={component as ComponentType<Props>}\n        overridingProps={overridingProps}\n      />\n    ));\n  }\n\n  const ComponentWithProps = memo(function ComponentWithProps({\n    bindProps,\n    component: Component,\n    overridingProps\n  }: {\n    readonly bindProps?: Partial<Props> | ((props: Props) => Partial<Props>) | undefined;\n    readonly component: ComponentType<Props>;\n    readonly overridingProps?: Partial<Props> | undefined;\n  }) {\n    const { allowOverrideProps } = options;\n    const { originalProps: renderCallbackProps } = useContext(RenderContext);\n\n    if (overridingProps && !arePropsEqual(overridingProps, renderCallbackProps) && !allowOverrideProps) {\n      console.warn('react-chain-of-responsibility: \"allowOverrideProps\" must be set to true to override props');\n    }\n\n    const props = Object.freeze(\n      allowOverrideProps ? { ...renderCallbackProps, ...overridingProps } : { ...renderCallbackProps }\n    );\n\n    return <Component {...props} {...(typeof bindProps === 'function' ? bindProps(props) : bindProps)} />;\n  });\n\n  const useBuildRenderCallback: () => UseBuildRenderCallback<Request, Props> = () => {\n    const { enhancer } = useContext(BuildContext);\n\n    return useCallback(\n      (request, buildOptions = {}) => {\n        const result =\n          // Put the \"fallbackComponent\" as the last one in the chain.\n          enhancer(() => {\n            const { fallbackComponent } = buildOptions;\n\n            if (!fallbackComponent) {\n              console.warn(\n                'react-chain-of-responsibility: the request has fall through all middleware, set \"fallbackComponent\" as a catchall',\n                request\n              );\n\n              // For clarity, we are returning `undefined` instead of `() => undefined`.\n              return;\n            }\n\n            // `fallbackComponent` do not need `overridingProps` because it is the last one in the chain, it would not have the next() function.\n            return reactComponent(fallbackComponent);\n          })(request);\n\n        return (\n          result &&\n          ((originalProps: Props) => (\n            // This is render function, we cannot call any hooks here.\n            <BuildRenderCallback originalProps={originalProps} render={result.render} />\n          ))\n        );\n      },\n      [enhancer]\n    );\n  };\n\n  type BuildRenderCallbackProps = {\n    readonly originalProps: Props;\n    readonly render: () => ReactNode;\n  };\n\n  // Do not memoize <BuildRenderCallback>.\n  // `bindProps` may have side effect and we want to be re-rendered to capture the side-effect.\n  // To prevent wasted render, web devs should memoize it themselves.\n  function BuildRenderCallback({ originalProps, render }: BuildRenderCallbackProps) {\n    const context = useMemo<RenderContextType<Props>>(() => Object.freeze({ originalProps }), [originalProps]);\n\n    return <RenderContext.Provider value={context}>{render()}</RenderContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProvider({ children, init, middleware }: ProviderProps<Request, Props, Init>) {\n    if (!Array.isArray(middleware) || middleware.some(middleware => typeof middleware !== 'function')) {\n      throw new Error('react-chain-of-responsibility: \"middleware\" prop must be an array of functions');\n    }\n\n    // Remap the middleware, so all inputs/outputs are validated.\n    const fortifiedMiddleware = useMemo(\n      () =>\n        Object.freeze(\n          middleware.map<ComponentMiddleware<Request, Props, Init>>(fn => (init: Init) => {\n            const enhancer = fn(init);\n\n            return next => originalRequest => {\n              // False positive: although we did not re-assign the variable from true, it was initialized as undefined.\n              // eslint-disable-next-line prefer-const\n              let hasReturned: boolean;\n\n              const returnValue = enhancer(nextRequest => {\n                if (hasReturned) {\n                  throw new Error(\n                    'react-chain-of-responsibility: next() cannot be called after the function had returned synchronously'\n                  );\n                }\n\n                // We do not allow passing void/undefined to next() because it would be confusing whether to keep the original request or pass an undefined.\n                !options.passModifiedRequest &&\n                  !Object.is(nextRequest, originalRequest) &&\n                  console.warn(\n                    'react-chain-of-responsibility: next() must be called with the original request, otherwise, set \"options.passModifiedRequest\" to true to pass a different request object downstream'\n                  );\n\n                return next(options.passModifiedRequest ? nextRequest : originalRequest);\n              })(originalRequest);\n\n              hasReturned = true;\n\n              // Make sure the return value is built using our helper function for forward-compatibility reason.\n              return returnValue && parse(componentHandlerResultSchema, returnValue);\n            };\n          })\n        ),\n      [middleware]\n    );\n\n    const { enhancer: parentEnhancer } = useContext(BuildContext);\n\n    const enhancer = useMemo<ComponentEnhancer<Request, Props>>(\n      () =>\n        // We are reversing because it is easier to read:\n        // - With reverse, [a, b, c] will become a(b(c(fn)))\n        // - Without reverse, [a, b, c] will become c(b(a(fn)))\n        applyMiddleware<ComponentHandlerResult<Props> | undefined, Request, Init>(\n          ...[...fortifiedMiddleware, ...[() => parentEnhancer]]\n        )(init as Init),\n      [init, fortifiedMiddleware, parentEnhancer]\n    );\n\n    const contextValue = useMemo<BuildContextType<Request, Props>>(() => Object.freeze({ enhancer }), [enhancer]);\n\n    return <BuildContext.Provider value={contextValue}>{children}</BuildContext.Provider>;\n  }\n\n  function ChainOfResponsibilityProxy({ fallbackComponent, request, ...props }: ProxyProps<Request, Props>) {\n    const result = useBuildRenderCallback()(request, { fallbackComponent })?.(props as Props);\n\n    return result ? <Fragment>{result}</Fragment> : null;\n  }\n\n  const MemoizedChainOfResponsibilityProvider =\n    memo<ProviderProps<Request, Props, Init>>(ChainOfResponsibilityProvider);\n\n  return Object.freeze({\n    Provider: MemoizedChainOfResponsibilityProvider as typeof MemoizedChainOfResponsibilityProvider &\n      InferenceHelper<Request, Props, Init>,\n    Proxy: ChainOfResponsibilityProxy,\n    reactComponent,\n    useBuildRenderCallback\n\n    // TODO: Consider adding back `asMiddleware`.\n  });\n}\n\nexport default createChainOfResponsibility;\nexport {\n  type ChainOfResponsibility,\n  type ComponentEnhancer,\n  type ComponentHandler,\n  type ComponentHandlerResult,\n  type ComponentMiddleware,\n  type ComponentRenderer,\n  type CreateChainOfResponsibilityOptions,\n  type InferenceHelper,\n  type InferInit,\n  type InferMiddleware,\n  type InferProps,\n  type InferProviderProps,\n  type InferProxyProps,\n  type InferRequest,\n  type ProviderProps,\n  type ProxyProps,\n  type ReactComponentHandlerResult,\n  type UseBuildRenderCallback,\n  type UseBuildRenderCallbackOptions\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport default function arePropsEqual<T extends Record<string, any>>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n\n  const mapOfX = new Map(Object.entries(x));\n  const mapOfY = new Map(Object.entries(y));\n\n  if (mapOfX.size !== mapOfY.size) {\n    return false;\n  }\n\n  const keys = new Set([...mapOfX.keys(), ...mapOfY.keys()]);\n\n  for (const key of keys) {\n    if (!Object.is(mapOfX.get(key), mapOfY.get(key))) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"mappings":"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","names":["ComponentWithProps","middleware","init","enhancer"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-chain-of-responsibility",
-  "version": "0.4.0-main.f9aeacf",
+  "version": "0.4.0-main.fc9324d",
   "description": "Using chain of responsibility design pattern for compositing and customizing React component.",
   "files": [
     "./dist/"
@@ -50,6 +50,7 @@
     "precommit:typescript:production": "tsc --noEmit --project ./src/tsconfig.precommit.production.json",
     "precommit:typescript:test": "tsc --noEmit --project ./src/tsconfig.precommit.test.json",
     "prepack": "cp ../../CHANGELOG.md . && cp ../../LICENSE . && cp ../../README.md .",
+    "start": "npm run build -- --onSuccess \"touch ../pages/package.json\" --watch",
     "switch": "cat package.json | jq --arg SWITCH_NAME $SWITCH_NAME -r '(.[\"switch:\" + $SWITCH_NAME] // {}) as $TEMPLATE | .devDependencies += ($TEMPLATE.devDependencies // {}) | .dependencies += ($TEMPLATE.dependencies // {})' | tee ./package.json.tmp && mv ./package.json.tmp ./package.json",
     "test": "jest"
   },
@@ -73,9 +74,10 @@
       "@testing-library/react": "^12",
       "@types/react": "^16",
       "@types/react-dom": "^16",
-      "react": "16.8.0",
-      "react-dom": "16.8.0",
-      "react-test-renderer": "16.8.0"
+      "@types/react-test-renderer": "^16",
+      "react": "16.8.6",
+      "react-dom": "16.8.6",
+      "react-test-renderer": "16.8.6"
     }
   },
   "switch:react-17": {
@@ -83,6 +85,7 @@
       "@testing-library/react": "^12",
       "@types/react": "^17",
       "@types/react-dom": "^17",
+      "@types/react-test-renderer": "^17",
       "react": "17.0.0",
       "react-dom": "17.0.0",
       "react-test-renderer": "17.0.0"
@@ -90,17 +93,34 @@
   },
   "switch:react-18": {
     "devDependencies": {
+      "@testing-library/react": "^16",
       "@types/react": "^18",
       "@types/react-dom": "^18",
+      "@types/react-test-renderer": "^18",
       "react": "18.0.0",
       "react-dom": "18.0.0",
       "react-test-renderer": "18.0.0"
     }
   },
   "pinDependencies": {
+    "@testduet/given-when-then": [
+      "main"
+    ],
+    "@testduet/wait-for": [
+      "main"
+    ],
     "@types/react": [
       "18"
     ],
+    "@types/react-dom": [
+      "18"
+    ],
+    "@types/react-test-renderer": [
+      "18"
+    ],
+    "escape-string-regexp": [
+      "4"
+    ],
     "react": [
       "18"
     ],
@@ -112,23 +132,26 @@
     ]
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.27.2",
+    "@babel/preset-env": "^7.28.0",
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
-    "@fluentui/react": "^8.123.0",
+    "@fluentui/react": "^8.123.1",
     "@testduet/given-when-then": "^0.1.0-main.334801c",
+    "@testduet/wait-for": "^0.1.1-main.3a4f261",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@tsconfig/recommended": "^1.0.10",
     "@tsconfig/strictest": "^2.0.5",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.0.3",
+    "@types/node": "^24.0.15",
     "@types/react": "^18.3.23",
-    "esbuild": "^0.25.5",
+    "@types/react-dom": "^18.3.7",
+    "@types/react-test-renderer": "^18.3.1",
+    "esbuild": "^0.25.8",
     "escape-string-regexp": "^4.0.0",
-    "jest": "^30.0.2",
-    "jest-environment-jsdom": "^30.0.2",
-    "prettier": "^3.5.3",
+    "jest": "^30.0.4",
+    "jest-environment-jsdom": "^30.0.4",
+    "prettier": "^3.6.2",
     "publint": "^0.3.12",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
@@ -139,11 +162,11 @@
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
-    "react": ">=16.8.0"
+    "react": ">=16.8.6"
   },
   "dependencies": {
     "handler-chain": "^0.1.0",
-    "react-chain-of-responsibility": "^0.4.0-main.f9aeacf",
+    "react-chain-of-responsibility": "^0.4.0-main.fc9324d",
     "valibot": "^1.1.0"
   }
 }