{"id":21327008,"url":"https://github.com/coderosh/vector","last_synced_at":"2025-10-27T11:10:09.075Z","repository":{"id":57103136,"uuid":"378843811","full_name":"coderosh/vector","owner":"coderosh","description":"2D and 3D Vector classes for game development and physics simulations","archived":false,"fork":false,"pushed_at":"2021-10-30T09:37:45.000Z","size":85,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-06T05:05:32.303Z","etag":null,"topics":["vector","vector-js","vector-math"],"latest_commit_sha":null,"homepage":"https://coderosh.github.io/vector/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coderosh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-21T07:27:55.000Z","updated_at":"2023-03-08T23:25:12.000Z","dependencies_parsed_at":"2022-08-20T23:20:54.250Z","dependency_job_id":null,"html_url":"https://github.com/coderosh/vector","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderosh%2Fvector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderosh%2Fvector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderosh%2Fvector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderosh%2Fvector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coderosh","download_url":"https://codeload.github.com/coderosh/vector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225802615,"owners_count":17526452,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["vector","vector-js","vector-math"],"created_at":"2024-11-21T21:12:48.650Z","updated_at":"2025-10-27T11:10:04.030Z","avatar_url":"https://github.com/coderosh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vector\n\n2D and 3D Vector classes for game development and physics simulations.\n\n\u003ca href=\"https://www.npmjs.com/package/@coderosh/vector\"\u003e\u003cimg alt=\"NPM\" src=\"https://img.shields.io/npm/v/@coderosh/vector\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/coderosh/vector\"\u003e\u003cimg alt=\"MIT\" src=\"https://img.shields.io/badge/license-MIT-blue.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg alt=\"CI\" src=\"https://img.shields.io/github/workflow/status/coderosh/vector/CI\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/coderosh/vector\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\" alt=\"PRs welcome!\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/coderosh/vector\"\u003e\u003cimg src=\"https://img.shields.io/badge/types-typescript-blue.svg\" alt=\"Typescript\" /\u003e\u003c/a\u003e\n\n## Installation\n\nInstall via npm\n\n```sh\nnpm install @coderosh/vector\n```\n\nOr via yarn\n\n```sh\nyarn add @coderosh/vector\n```\n\n## Usage\n\n```js\nimport { Vector2D, Vector3D } from '@coderosh/vector'\n\n/* 3D Vector */\nnew Vector3D(1, 4, 1)\n\n/* 2D Vector */\nnew Vector2D(1, 3)\n```\n\n## Available methods\n\n- [add](#add) - 2D and 3D\n- [sub](#sub) - 2D and 3D\n- [scale](#scale) - 2D and 3D\n- [lerp](#lerp) - 2D and 3D\n- [slerp](#slerp) - 3D only\n- [nlerp](#nlerp) - 2D and 3D\n- [lenSqr](#lenSqr) - 2D and 3D\n- [len](#len) - 2D and 3D\n- [dist](#dist) - 2D and 3D\n- [normalize](#normalize) - 2D and 3D\n- [equals](#equals) - 2D and 3D\n- [copy](#copy) - 2D and 3D\n- [dot](#dot) - 2D and 3D\n- [cross](#cross) - 3D only\n\n## Documentation\n\n### add\n\nAdds two vectors\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.add(4, 5, 6)\nvec3d.add(new Vector3D(4, 5, 6))\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.add(4, 5)\nvec2d.add(new Vector2D(4, 5))\n```\n\n### sub\n\nSubstracts two vectors\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.sub(4, 5, 6)\nvec3d.sub(new Vector3D(4, 5, 6))\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.sub(4, 5)\nvec2d.sub(new Vector2D(4, 5))\n```\n\n### scale\n\nMultiply a vector by a scalar factor\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.scale(2)\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.scale(2)\n```\n\n### lenSqr\n\nSquare of length of vector\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.lenSqr()\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.lenSqr()\n```\n\n### len\n\nLength of vector\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.len()\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.len()\n```\n\n### normalize\n\nNormalize the vector\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.normalize()\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.normalize()\n```\n\n### dist\n\nCalculate distance between two vectors\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.dist(5, 2, 3)\nvec3d.dist(new Vector3D(5, 2, 3))\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.dist(5, 2)\nvec2d.dist(new Vector2D(5, 2))\n```\n\n### equals\n\nCheck if two vectors have same coordinates\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.equals(1, 2, 3)\nvec3d.equals(new Vector3D(1, 2, 3))\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.equals(1, 2)\nvec2d.equals(new Vector2D(1, 2))\n```\n\n### dot\n\nReturns dot product of two vectors\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.dot(1, 1, 2)\nvec3d.dot(new Vector3D(1, 1, 2))\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.dot(4, 2)\nvec2d.dot(new Vector2D(4, 2))\n```\n\n### cross\n\nReturns cross product of two vectors\n\n```js\nconst vec = new Vector3D(1, 2, 3)\nvec.cross(1, 2, 4)\nvec.cross(new Vector3D(1, 2, 4))\n```\n\n### lerp\n\nLinear interpolate vectors\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.lerp(1, 1, 2, 0.1)\nvec3d.lerp(new Vector3D(1, 1, 2), 0.1)\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.lerp(4, 2, 0.1)\nvec2d.lerp(new Vector2D(4, 2), 0.1)\n```\n\n### slerp\n\nSpherical linear interpolate vectors\n\n```js\nconst vec = new Vector3D(1, 0, 0)\nvec.slerp(new Vector3D(0, 1, 0), 0.5)\nvec.slerp(0, 1, 0, 0.5)\n```\n\n### nlerp\n\nLinear interpolate vectors and normalize\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nvec3d.nlerp(1, 1, 2, 0.1)\nvec3d.nlerp(new Vector3D(1, 1, 2), 0.1)\n\nconst vec2d = new Vector2D(1, 2)\nvec2d.nlerp(4, 2, 0.1)\nvec2d.nlerp(new Vector2D(4, 2), 0.1)\n```\n\n### copy\n\n```js\nconst vec3d = new Vector3D(1, 2, 3)\nconst newVec3d = vec3d.copy()\nconst newVec3d_ = new Vector(vec3d)\n\nconst vec2d = new Vector3D(1, 2, 3)\nconst newVec2d = vec2d.copy()\nconst newVec2d_ = new Vector(vec2d)\n```\n\n## LICENSE\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderosh%2Fvector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoderosh%2Fvector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderosh%2Fvector/lists"}