# @bluelovers/extend-bases

> A simple library for multiple inheritance in JavaScript.

Latest version **2.0.2** (published 2022-08-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install @bluelovers/extend-bases
pnpm add @bluelovers/extend-bases
yarn add @bluelovers/extend-bases
bun add @bluelovers/extend-bases
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.2 |
| Published | 2022-08-30 |
| First published | 2021-08-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 134.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | aryan.programer@gmail.com |
| Maintainers | bluelovers |
| Keywords | ts, typescript, inheritance, multiple inheritance, multiple-inheritance, class, klass, oop, object oriented, object-oriented, inherits, extend, bases, extends, create-by-yarn-tool, create-by-tsdx |

## Links

- npm: https://www.npmjs.com/package/@bluelovers/extend-bases
- Repository: https://github.com/bluelovers/extend-bases
- Homepage: https://github.com/bluelovers/extend-bases#readme
- Issues: https://github.com/bluelovers/extend-bases/issues
- npm.io page: https://npm.io/package/@bluelovers/extend-bases

## Dependencies (3)

- [reflect.ownkeys](https://npm.io/package/reflect.ownkeys.md) ^1.1.0
- [array.prototype.flatmap](https://npm.io/package/array.prototype.flatmap.md) ^1.3.0
- [class-without-call-parent-constructor](https://npm.io/package/class-without-call-parent-constructor.md) ^2.0.5

## Alternatives

- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads
- [@1selfworld/adchain-sdk-react-native](https://npm.io/package/@1selfworld/adchain-sdk-react-native.md) — 80 weekly downloads

## Recent versions

- 2.0.2 (latest) — 2022-08-30
- 2.0.1 — 2022-08-30
- 1.0.3 — 2021-08-15

## README

# extend-bases: A simple library for multiple inheritance in JavaScript.

This library can be used to achieve multiple inheritance in JavaScript, but it sets itself apart from other libraries for multiple inheritance because it isolates the base classes and prevents the properties and methods from colliding, while still allowing easy access to the properties and methods of the base classes.

## Installation

Simply run:

```
npm add extend-bases
```

Or:

```
yarn add extend-bases
```

To import:

```typescript
import {bases, defineProperties, isInstanceOf} from "extend-bases";
```

Or:

```typescript
const {bases, defineProperties, isInstanceOf} = require("extend-bases");
```

## Getting started

To inherit from multiple bases simply extend from `bases(Class1, Class2, ...)`. In the constructor pass the <b>*instances*</b> of the classes to the `super` constructor.

Then you can access the base properties and methods directly from `this.`, the first class with that property or method will be given precedence. 

To access a particular base use `this.bases[index]`.

Replace all instances of `v instanceof Class` with `isInstanceOf(v, Class)`, it’s just that simple.

## For more details

- Read the [Handy manual](https://github.com/aryan-programmer/extend-bases/wiki/Handy-Manual), it’s very simple & small and gives enough information to get started.
- Then read the [Documentation](https://github.com/aryan-programmer/extend-bases/wiki/Documentation). it’s not too big and easy to go through.
- Then, if you have enough time or are interested, read the tests and source code of the project.

## Implementation details

This library uses Proxies, so sadly no IE11 support, but otherwise this library also imports es-shims for `Reflect.ownKeys`(ES6 but used very often and an es-shim exists for it) and `Array.prototype.flatMap`(ES2019, very new), which were found to be the bottlenecks, for some browsers.

This library uses proxies for easy access in the class instances, and it merges the prototypes of the base classes, but for isolation of base classes it creates a new function wrapping the method call. It’s just best to look at the source code for this.

## TypeScript support

The library is by default written in TypeScript, which you all should be using if you aren’t, for great code completion. The details of the TypeScript definitions are a bit fiddly, so it’s best not to worry about them, they work<small>, or you can just look at the source code</small>.

## Contributing

Feel free to open a pull request, fix bugs, or read the source code. It’s all up to you.

---
_Source: https://npm.io/package/@bluelovers/extend-bases · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._