[](https://GitHub.com/teniryte/ooi/graphs/commit-activity) [](https://img.shields.io/badge/maintainer-teniryte-blue) [](https://ooi.sencort.com/) [](http://commonmark.org) [](https://code.visualstudio.com/) [](https://github.com/teniryte/ooi/blob/master/LICENSE) [](https://gpvc.arturio.dev/teniryte) [](https://GitHub.com/teniryte/ooi/graphs/contributors/) [](https://GitHub.com/teniryte/ooi/issues/)
[](https://GitHub.com/teniryte/ooi/network/) [](https://GitHub.com/teniryte/ooi/stargazers/) [](https://GitHub.com/teniryte/ooi/watchers/) [](https://github.com/teniryte?tab=followers)
[](https://github.com/teniryte/ooi)
## **OOI**
**JavaScript Utility & Tools Library**
## [**🚀 Open Full Documentation**](https://ooi.sencort.com/)
[**🔸 Home**](https://ooi.sencort.com/index.html) [**🔸 Report Bug**](https://github.com/teniryte/ooi) [**🔸 Request Feature**](https://github.com/teniryte/ooi/issues)
## ⏹️ Table of Contents ▲
- [⏹️ Features](#features)
- [⏹️ Installation](#installation)
- [⏹️ Import ooi-modules by `.ooi` text file](#import)
- [⏹️ Documentation](#documentation)
- [⏹️ CLI](#cli)
- [⏹️ Testing](#testing)
## ⏹️ Features▲
- [**Common JavaScript Utilities**](https://ooi.sencort.com/list.html#tags-common). **ooi** provides some useful functions and classes to make some specific operations more reusable. Working with objects, arrays, collections, convertation, events, formatting, meta-data and types.
- [**Node.js Tools**](https://ooi.sencort.com/list.html#tags-node). Some useful methods to simplify certain node.js operations.
- [**DOM Utilities & Tools**](https://ooi.sencort.com/list.html#tags-dom). Get, create and modify DOM elements, working with DOM-events and so on.
- [**Polyfills**](https://ooi.sencort.com/list.html#tags-polyfills). Contains some useful polyfills.
## ⏹️ Installation ▲
**Installation as local package:**
```sh
npm i --save ooi;
```
**Using the Hole Library:**
```javascript
import ooi from 'ooi';
let arr = [1, 2, 3];
ooi.append(arr, 4, 5, 6);
[1, 2, 3, 4, 5, 6].forEach(num => {
console.log(num);
});
console.log(arr);
```
## ⏹️ Import ooi-modules by `.ooi` text file ▲
**File `util.ooi`:**
```txt
each
extend
flatten
class-meta
plural
isArray: $isarray
sse: ./util/sse.js
```
**Install plugin `esbuild-import-plugin`:**
```sh
npm i --save esbuild-import-plugin;
```
**Plug it:**
```js
const importPlugin = require('esbuild-import-plugin');
esbuild
.build({
entryPoints: ['./src/index.js'],
bundle: true,
outfile: './dist/app/app.js',
loader: {
'.js': 'jsx'
},
sourcemap: true,
target: ['chrome58', 'firefox57', 'safari11', 'edge16'],
define: {
'process.env.NODE_ENV': '"development"'
},
plugins: [
// Here!
importPlugin
]
})
.then(() => console.log('Builded!'))
.catch(err => console.log(err));
```
**Now you can import file `util.ooi` from esbuild module:**
```js
import util from './util.ooi';
util.each([1, 2, 3], (n, i) => console.log(n, i));
```
## ⏹️ Documentation ▲
### 🎟️ [**Explore Full Utils List**](https://ooi.sencort.com/list.html)
**Sections**:
- [Arrays](https://ooi.sencort.com/list.html#section-arrays)
- [Collections](https://ooi.sencort.com/list.html#section-collections)
- [Convert](https://ooi.sencort.com/list.html#section-convert)
- [Events](https://ooi.sencort.com/list.html#section-events)
- [Format](https://ooi.sencort.com/list.html#section-format)
- [Meta](https://ooi.sencort.com/list.html#section-meta)
- [Objects](https://ooi.sencort.com/list.html#section-objects)
- [Util](https://ooi.sencort.com/list.html#section-util)
## ⏹️ CLI ▲
**Install ooi as CLI:**
```sh
sudo npm install --global ooi;
```
**Compile library for client:**
```sh
ooi compile
-s objects collections
-t fn objects
-min
-o assets/js/lib/ooi.min.js;
```
**Pack ooi as JS-module:**
```sh
cli pack
-s objects collections
-t fn objects
-o src/lib/ooi.js
```
## ⏹️ Testing ▲
**Test all utilities:**
```sh
npm test;
```
### DevPackages
- `esbuild-styla-plugin`;
- `esbuild-xyaml-plugin`;
- `ooi`;
- `styla`;