@frosted/array-at 1.0.0

package/README.md

@@ -0,0 +1,28 @@
+# @frosted/array-at
+Ponyfill for Array.prototype.at
+
+## Installation
+```bash
+npm install @frosted/array-at
+```
+
+## Usage
+```js
+const at = require("@frosted/array-at")
+
+console.log(at([1, 2, 3], 1)) // 2
+
+console.log(at([20, 40, 60, 80], -2)) // 60
+
+console.log(at("not array", 2)) // Error: Expects an array
+```
+
+Shimming Array.prototype.at:
+```js
+require("@frosted/array-at/shim")
+
+console.log([1, 2, 3].at()) // [3, 2, 1]
+```
+
+## Tests
+Simply clone the repo and run npm test

package/index.d.ts

@@ -0,0 +1,3 @@
+declare function at<T>(arr: T[], index: number): T
+
+export = at

package/index.js

@@ -0,0 +1,20 @@
+var isNotArray = require("@not-js/not")(require("@is-(unknown)/is-array"))
+var immediateError = require("immediate-error")
+var reverse = require("@frosted/array-reverse")
+var isNegative = require("is-negative")
+var abs = require("lolite.abs")
+var addOne = require("add-one")
+
+function at(array, index) {
+  if (isNotArray(array)) {
+    immediateError("Expects an array")
+  }
+
+  if (isNegative(index)) {
+    return at(reverse(array), abs(addOne(index)))
+  }
+
+  return array[index]
+}
+
+module.exports = at

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@frosted/array-at",
+  "version": "1.0.0",
+  "description": "Get the item at a specified index in an array, allowing for positive and negative integers",
+  "keywords": [
+    "10xly",
+    "made",
+    "is-hundred",
+    "frosted-javascript"
+  ],
+  "homepage": "https://github.com/frosted-javascript/array-at#readme",
+  "bugs": {
+    "url": "https://github.com/frosted-javascript/array-at/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frosted-javascript/array-at.git"
+  },
+  "license": "MIT",
+  "author": "10x'ly Made / Frosted",
+  "type": "commonjs",
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha"
+  },
+  "dependencies": {
+    "@10xly/strict-equals": "^1.0.1",
+    "@frosted/array-reverse": "^1.0.0",
+    "@is-(unknown)/is-array": "^1.0.2",
+    "@not-js/not": "^1.1.1",
+    "add-one": "^1.0.3",
+    "define-properties": "^1.2.1",
+    "immediate-error": "^2.0.0",
+    "is-negative": "^2.1.0",
+    "lolite.abs": "^1.1.17",
+    "ununcurry-this-x": "^1.0.0"
+  },
+  "devDependencies": {
+    "mocha": "^11.7.5"
+  }
+}

package/shim.js

@@ -0,0 +1,12 @@
+var define = require("define-properties")
+var polyfill = require("ununcurry-this-x")(require("."))
+var $ArrayPrototype = require("es-intrinsic-cache")("Array.prototype")
+var isNotEqual = require("@not-js/not")(require("@10xly/strict-equals"))
+
+define(
+  $ArrayPrototype,
+  { at: polyfill },
+  { at: function () { return isNotEqual($ArrayPrototype.at, polyfill) } }
+)
+
+module.exports = polyfill

package/test.js

@@ -0,0 +1,33 @@
+const assert = require("assert")
+const at = require(".")
+
+describe("at()", () => {
+  it("should return the last element when index is -1", () => {
+    const input = [10, 20, 30]
+    assert.strictEqual(at(input, -1), 30)
+  })
+
+  it("should return the second to last element when index is -2", () => {
+    const input = ["apple", "banana", "cherry"]
+    assert.strictEqual(at(input, -2), "banana")
+  })
+
+  it("should return the first element when index is 0", () => {
+    const input = ["first", "second"]
+    assert.strictEqual(at(input, 0), "first")
+  })
+
+  it("should return undefined for out-of-bounds negative index", () => {
+    const input = [1, 2]
+    assert.strictEqual(at(input, -3), undefined)
+  })
+
+  it("should throw for non-array input", () => {
+    assert.throws(() => at(null, 0), /Expects an array/)
+  })
+
+  it("should handle large arrays", () => {
+    const bigArray = Array.from({ length: 15000 }, (_, i) => i)
+    assert.strictEqual(at(bigArray, -1), 14999)
+  })
+})