🌱 initial: First draft.

Author: make-github-pseudonymous-again

README.md

@@ -4,12 +4,12 @@
 32-bit signed integer arithmetic and logic operators for JavaScript.
 See [docs](https://arithmetic-type.github.io/int32/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 {div32, mul32} from '@arithmetic-type/int32';
 
-> :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).
+div32(5, -2); // -2
+mul32(-123456, -123456); // -1938485248
+```
 
 [![License](https://img.shields.io/github/license/arithmetic-type/int32.svg)](https://raw.githubusercontent.com/arithmetic-type/int32/main/LICENSE)
 [![Version](https://img.shields.io/npm/v/@arithmetic-type/int32.svg)](https://www.npmjs.org/package/@arithmetic-type/int32)

doc/manual/usage.md

@@ -1,17 +1,6 @@
 # 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 int32 = await import('@arithmetic-type/int32');
 // or

package.json

@@ -205,6 +205,8 @@
       "unicorn"
     ],
     "rules": {
+      "no-bitwise": "off",
+      "unicorn/prefer-math-trunc": "off",
       "unicorn/prefer-node-protocol": "off",
       "unicorn/filename-case": [
         "error",

src/arithmetic/add32.js

@@ -0,0 +1,2 @@
+const add32 = (a, b) => (a + b) | 0;
+export default add32;

src/arithmetic/div32.js

@@ -0,0 +1,4 @@
+// NOTE This emulates hardware signed integer division. For the mathematical
+// definition I guess we would need another function.
+const div32 = (a, b) => (a / b) | 0;
+export default div32;

src/arithmetic/mul32.js

@@ -0,0 +1,2 @@
+const mul32 = (a, b) => Math.imul(a, b);
+export default mul32;

src/arithmetic/neg32.js

@@ -0,0 +1,3 @@
+const neg32 = (x) => -x | 0;
+
+export default neg32;

src/arithmetic/sub32.js

@@ -0,0 +1,2 @@
+const sub32 = (a, b) => (a - b) | 0;
+export default sub32;

src/coerce/int32.js

@@ -0,0 +1,3 @@
+const int32 = (x) => x | 0;
+
+export default int32;

src/index.js

@@ -1,2 +1,16 @@
-const answer = 42;
-export default answer;
+export {default as add32} from './arithmetic/add32.js';
+export {default as div32} from './arithmetic/div32.js';
+export {default as mul32} from './arithmetic/mul32.js';
+export {default as neg32} from './arithmetic/neg32.js';
+export {default as sub32} from './arithmetic/sub32.js';
+export {default as int32} from './coerce/int32.js';
+export {default as max} from './limits/max.js';
+export {default as min} from './limits/min.js';
+export {default as and32} from './logic/and32.js';
+export {default as not32} from './logic/not32.js';
+export {default as or32} from './logic/or32.js';
+export {default as xor32} from './logic/xor32.js';
+export {default as decreasing} from './order/decreasing.js';
+export {default as increasing} from './order/increasing.js';
+export {default as shl32} from './shift/shl32.js';
+export {default as shr32} from './shift/shr32.js';