✨ feat: Add realloc.

Author: make-github-pseudonymous-again

README.md

@@ -4,12 +4,15 @@
 ArrayLike reallocation for JavaScript.
 See [docs](https://array-like.github.io/realloc/index.html).
 
-> :building_construction: Caveat emptor! This is work in progress. Code may be
-> working. Documentation may be present. Coherence may be. Maybe.
+```js
+import {alloc} from '@array-like/alloc';
+import {iota} from '@array-like/fill';
+import {realloc} from '@array-like/realloc':
 
-> :warning: Depending on your environment, the code may require
-> `regeneratorRuntime` to be defined, for instance by importing
-> [regenerator-runtime/runtime](https://www.npmjs.com/package/regenerator-runtime).
+const a = alloc(100);
+iota(a, 0, 100, 0);
+const b = realloc(a, 200); // 0 1 2 .. 98 99 undefined undefined ...
+```
 
 [![License](https://img.shields.io/github/license/array-like/realloc.svg)](https://raw.githubusercontent.com/array-like/realloc/main/LICENSE)
 [![Version](https://img.shields.io/npm/v/@array-like/realloc.svg)](https://www.npmjs.org/package/@array-like/realloc)

doc/manual/usage.md

@@ -1,19 +1,8 @@
 # Usage
 
-> :warning: Depending on your environment, the code may require
-> `regeneratorRuntime` to be defined, for instance by importing
-> [regenerator-runtime/runtime](https://www.npmjs.com/package/regenerator-runtime).
-
-First, require the polyfill at the entry point of your application
-```js
-await import('regenerator-runtime/runtime.js');
-// or
-import 'regenerator-runtime/runtime.js';
-```
-
-Then, import the library where needed
+Import the library where needed
 ```js
-const realloc = await import('@array-like/realloc');
+const {realloc} = await import('@array-like/realloc');
 // or
-import * as realloc from '@array-like/realloc';
+import {realloc} from '@array-like/realloc';
 ```

package.json

@@ -59,8 +59,12 @@
     "release": "np --message ':hatching_chick: release: Bumping to v%s.'",
     "test": "ava"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@array-like/alloc": "^0.0.1",
+    "@array-like/copy": "^0.0.1"
+  },
   "devDependencies": {
+    "@array-like/fill": "^0.0.1",
     "@babel/core": "7.14.8",
     "@babel/preset-env": "7.14.8",
     "@babel/register": "7.14.5",

src/index.js

@@ -1,2 +1 @@
-const answer = 42;
-export default answer;
+export {default as realloc} from './realloc.js';

src/realloc.js

@@ -0,0 +1,19 @@
+import {alloc} from '@array-like/alloc';
+import {copy} from '@array-like/copy';
+
+/**
+ * Realloc.
+ *
+ * @param {ArrayLike} data
+ * @param {number} length
+ * @return {Array}
+ */
+const realloc = (data, length) => {
+	const pt = alloc(length);
+
+	copy(data, 0, Math.min(data.length, length), pt, 0);
+
+	return pt;
+};
+
+export default realloc;

test/src/api.js

@@ -0,0 +1,26 @@
+import test from 'ava';
+import {alloc} from '@array-like/alloc';
+import {iota} from '@array-like/fill';
+
+import {realloc} from '../../src/index.js';
+
+test('realloc', (t) => {
+	const m = 1000;
+	const n = 733;
+
+	const a = alloc(m);
+	let b = alloc(n);
+
+	iota(a, 0, m, 0);
+	iota(b, 0, n, 0);
+
+	b = realloc(b, m);
+	iota(b, n, m, n);
+
+	t.deepEqual(b, a, 'b is a after growing');
+
+	a.splice(n, m - n);
+	b = realloc(b, n);
+
+	t.deepEqual(b, a, 'b is a after shrinking');
+});