@modular-component/default/README.md

Sensible defaults for the ModularComponent system

# @modular-component/default

Set of sensible defaults for using `ModularComponent`.

Provides two stages: `with(lifecycle)` for adding a lifecycle hook, and `with(defaultProps)` for
providing default values for props. It also re-exports `with(render)` from `@modular-component/props` for convenience.

It's also possible to import each of them individually through [`@modular-component/with-lifecycle`](https://npmjs.com/package/@modular-component/with-lifecycle)
and <br /> [`@modular-component/with-default-props`](https://npmjs.com/package/@modular-component/with-default-props) respectively.

## Usage

```tsx
import { ModularComponent } from '@modular-component/core'
import { defaultProps, lifecycle, render } from '@modular-component/default'

const MyComponent = ModularComponent()
  .with(defaultProps({
    // Define default props here
  }))
  .with(lifecycle(() => {
    // Write component state & logic here
  }))
  .with(render(({ props, lifecycle }) => (
    // Use generated props and lifecycle in the render phase
  )))
```

## Implementation

`@modular-component/default` simply merge together the records from two other packages. To see the implementation
details, refer to the individual packages:

- [`@modular-component/with-default-props`](https://npmjs.com/package/@modular-component/with-default-props): powerful default props capabilities
- [`@modular-component/with-lifecycle`](https://npmjs.com/package/@modular-component/with-lifecycle): isolate component logic in a dedicated hook