reblendjs v6.0.1

ReblendJS

ReblendJS is a lightweight frontend library that seamlessly integrates the flexibility of React with the efficiency of Web Components. It offers a modular approach to state management and component rendering, ensuring fast and predictable UI updates.

🚀 Features

• ✅ Supports Standard HTML & React Attributes – Write components using familiar syntax.
• ✅ JSX Support – Use for, style (as a string), class (as classNames), and standard attributes.
• ✅ React Component Compatibility – Use React components within ReblendJS.
• ✅ Uses React's Build Tools – No need to change your existing setup.
• ✅ Functional Components Compile to Classes – Optimized for performance.
• ✅ Single Execution for Functional Components – No unnecessary re-renders.
• ✅ Web Component Native Support – Directly renders existing HTMLElement instances without wrappers.
• ✅ Simple API & Easy to Learn – Minimal boilerplate, quick to get started.
• ✅ Built-in Hooks Support – Manage state and side effects seamlessly.
• ✅ Component-Level State Management – Each element holds its own state.
• ✅ No Mixed or Async State Rendering – Eliminates issues with pre/post rendering.
• ✅ Faster Rendering – State is localized within each element, reducing unnecessary updates.

📦 Installation

To quickly set up a new ReblendJS project with TypeScript, use:

npx create-reblend-app --template typescript ./my-app

Alternatively, install ReblendJS manually:

npm install reblendjs

or

yarn add reblendjs

🛠️ Usage

Mounting Components to the DOM

ReblendJS uses mountOn to attach components to the DOM:

import Reblend from 'reblendjs'
import App from './App'

Reblend.mountOn('root', App)

Functional Component Example

ReblendJS recommends using functional components for better performance, as they are efficiently compiled into class components:

import Reblend, { useState } from 'reblendjs'

const Counter = () => {
  const [count, setCount] = useState(0)

  return (
    <div>
      <h1>Counter: {count}</h1>
      <button onClick={() => setCount(count + 1)}>Increment</button>
    </div>
  )
}

Reblend.mountOn('root', Counter)

JSX Support (for, style, class, and Attributes)

ReblendJS fully supports JSX attributes, including:

• ✅ for (instead of htmlFor in React)
• ✅ style (as a string, unlike React's object-based approach)
• ✅ class (as classNames)
• ✅ Standard attributes (id, name, placeholder, etc.)

Example:

const FormExample = () => {
  return (
    <form>
      <label for="name">Name:</label>
      <input id="name" type="text" placeholder="Enter your name" />

      <button class="btn btn-primary" style="background-color: blue; padding: 10px;">
        Submit
      </button>
    </form>
  )
}

Reblend.mountOn('root', FormExample)

🎯 Use Cases

ReblendJS is ideal for:

• Building Web Components – Create reusable elements without React wrappers.
• Optimizing Performance – When React’s Virtual DOM is too heavy.
• Progressive Enhancement – Use ReblendJS alongside native HTML.
• Embedding in Non-React Projects – Works well in vanilla JS applications.

⚖️ ReblendJS vs React

🎨 Example: Modal with Button Interaction Using Bootstrap Components with ReblendJS

Here’s an example of creating a button that toggles a modal:

import { Button } from 'react-bootstrap'
import Reblend, { useState } from 'reblendjs'
import Modal from 'react-bootstrap/Modal'

export function MyVerticallyCenteredModal(props: any) {
  return (
    <Modal {...props} size="lg" aria-labelledby="contained-modal-title-vcenter" centered closeButton>
      <Modal.Header>
        <Modal.Title id="contained-modal-title-vcenter">Modal heading</Modal.Title>
      </Modal.Header>
      <Modal.Body>
        <h4>Centered Modal</h4>
        <p>
          Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam.
          Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
        </p>
      </Modal.Body>
      <Modal.Footer>
        <Button onClick={props.onHide}>Close</Button>
      </Modal.Footer>
    </Modal>
  )
}

const App = () => {
  const [modalShow, setModalShow] = useState(false)

  const toggleModal = () => {
    setModalShow(!modalShow)
  }

  return (
    <div>
      <Button variant="primary" onClick={toggleModal}>
        Toggle Modal
      </Button>
      <MyVerticallyCenteredModal show={modalShow} onHide={toggleModal} />
    </div>
  )
}

Reblend.mountOn('root', App)

🏗️ Contributing

We welcome contributions! Feel free to submit issues or pull requests.

Steps to Contribute:

1. Fork the repository.
2. Create a new branch.
3. Commit your changes.
4. Open a pull request.

📜 License

MIT License.