react-fast-hoc

React Fast HOC

Lightweight and type-safe High-Order Components (HOCs) library for React, leveraging high-order types from "hotscript" and JavaScript Proxies for zero VDOM overhead and blazing-fast performance.

Table of Contents

• Installation
• Usage
  • transformProps
  • createHoc
  • createTransformProps
• API Reference
• Examples
• License

Installation

Install the react-fast-hoc package:

# hotscript is a peer dependency

npm i react-fast-hoc && npm i -D hotscript
# or
yarn add react-fast-hoc && yarn add -D hotscript
# or
pnpm i react-fast-hoc && pnpm i -D hotscript

Or with ni:

ni react-fast-hoc && ni -D hotscript

Usage

transformProps

Directly create a new component with transformed props.

import { transformProps } from "react-fast-hoc";

const EnhancedComponent = transformProps(
  MyComponent,
  (props) => {
    // Transform props here
    return { ...props, transformedProp: "Transformed Value" };
  },
  "WithTransformedProps"
);

createHoc

Create a new HOC with a custom props transformer and optional display name prefix.

import { createHoc } from "react-fast-hoc";

const withCustomLogic = createHoc({
  namePrefix: "WithCustomLogic",
  propsTransformer: (props) => {
    // Apply custom logic here
    return { ...props, customProp: "Custom Value" };
  },
  resultTransformer: null,
  nameRewrite: null,
});

const EnhancedComponent = withCustomLogic(MyComponent);

createTransformProps

Create a new HOC that transforms the props passed to the wrapped component.

import { createTransformProps } from "react-fast-hoc";

const withTransformedProps = createTransformProps((props) => {
  // Transform props here
  return { ...props, transformedProp: "Transformed Value" };
}, "WithTransformedProps");

const EnhancedComponent = withTransformedProps(MyComponent);

You can use wrapIntoProxy to create more customizable hocs

API Reference

Detailed API documentation can be found in the API.md file.

Examples

You can find example usage of react-fast-hoc in the examples folder.

License

React Fast HOC is MIT licensed.