# s-array

> Array library for S.js

Latest version **0.4.10** (published 2018-07-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install s-array
pnpm add s-array
yarn add s-array
bun add s-array
```

## Health

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

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

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.4.10 |
| Published | 2018-07-28 |
| First published | 2017-03-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 88.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 35 |
| Author | Adam Haile |
| Maintainers | adamhaile |
| Keywords | S.js, reactive, array, sequence |

## Links

- npm: https://www.npmjs.com/package/s-array
- Repository: https://github.com/adamhaile/S-array
- Homepage: https://github.com/adamhaile/S-array#readme
- Issues: https://github.com/adamhaile/S-array/issues
- npm.io page: https://npm.io/package/s-array

## Recent versions

- 0.4.10 (latest) — 2018-07-28
- 0.4.9 — 2017-11-14
- 0.4.8 — 2017-11-13
- 0.4.7 — 2017-05-26
- 0.4.6 — 2017-05-15
- 0.4.5 — 2017-05-04
- 0.4.4 — 2017-05-04
- 0.4.3 — 2017-04-28
- 0.4.2 — 2017-03-20
- 0.4.1 — 2017-03-15
- 0.4.0 — 2017-03-15

## README

# SArray

Convenient array signals for [S.js](https://github.com/adamhaile/S).

SArray adds utility methods to S signals carrying arrays.  These utility methods parallel the standard ES3/5/6 array methods.

```javascript
// transformations without SArray
var arr      = S.data([1, 2, 3]),
    mapped   = S(() => arr().map(x => x * 2)),
    filtered = S(() => arr().filter(x => x > 2)); 

// transformations with SArray
var arr      = SArray([1, 2, 3]),
    mapped   = arr.map(x => x * 2), // arr() now has array methods
    filtered = arr.filter(x => x > 2);

// mutations without SArray
var tmp = S.sample(arr).slice(0);
tmp.push(4);
arr(tmp);

// mutations with SArray
arr.push(4);

// SArray methods also return SArrays
var mappedAndFiltered = arr.map(x => x * 2).filter(x => x > 2);

// Any array-carrying signal can be 'lifted' to create an SArray
var plain = S.data([1, 2, 3]),
    arr = SArray.lift(plain),
    mapped = arr.map(x => x * 2); // etc

// When an array signal changes, map() will re-use prior computations
// for new items that === the old.
var rands = arr.map(() => Math.random().toFixed(2));
rands(); // ["0.83", "0.75", "0.77"]
arr.push(4);
rands(); // ["0.83", "0.75", "0.77", "0.25"] unchanged values reused
```

For a full list of methods and thier signatures, consult [index.d.ts](index.d.ts).

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