feat(array): ✨ Add snippets related to array (#65)

Author: xeho91

.changeset/cuddly-cats-rush.md

@@ -0,0 +1,15 @@
+---
+"@terminal-nerds/snippets-array": minor
+---
+
+✨ Added a new, initial modules:
+
+-   `compare`
+-   `difference`
+-   `filter`
+-   `intersection`
+-   `random`
+-   `schema`
+-   `shuffle`
+-   `union`
+-   `unique`

README.md

@@ -100,6 +100,7 @@ Reusable pieces of code, which can be **reused** across the projects.
 | ------------------------------- | ------------------------------------------------ |
 | [![snippets badge]][snippets]   | [![snippets version badge]][snippets npm page]   |
 | <!-- PACKAGES -->               | <!-- PACKAGES -->                                |
+| [![array badge]][array]         | [![array version badge]][array npm page]         |
 | [![number badge]][number]       | [![number version badge]][number npm page]       |
 | [![config badge]][config]       | [![config version badge]][config npm page]       |
 | [![extension badge]][extension] | [![extension version badge]][extension npm page] |
@@ -117,6 +118,11 @@ Reusable pieces of code, which can be **reused** across the projects.
 
 <!-- prettier-ignore-start -->
 <!-- PACKAGES LINKS -->
+[array]: ./packages/array/README.md
+[array badge]: https://img.shields.io/static/v1?label=%40terminal-nerds&message=snippets-array&style=flat-square&color=informational
+[array version badge]: https://img.shields.io/npm/v/@terminal-nerds/snippets-array/latest?style=flat-square&logo=npm
+[array npm page]: https://www.npmjs.com/package/@terminal-nerds/snippets-array
+
 [number]: ./packages/number/README.md
 [number badge]: https://img.shields.io/static/v1?label=%40terminal-nerds&message=snippets-number&style=flat-square&color=informational
 [number version badge]: https://img.shields.io/npm/v/@terminal-nerds/snippets-number/latest?style=flat-square&logo=npm

packages/array/.depcheckrc.json

@@ -0,0 +1,3 @@
+{
+	"ignores": ["@terminal-nerds/*-config", "tsup", "vitest"]
+}

packages/array/CHANGELOG.md

@@ -0,0 +1 @@
+# @terminal-nerds/snippets-array<!-- markdownlint-disable line-length list-marker-space no-duplicate-header ul-style ul-indent no-bare-urls -->

packages/array/LICENSE.md

@@ -0,0 +1 @@
+/home/xeho91/Nextcloud/Projects/terminal-nerds/snippets/LICENSE.md

packages/array/README.md

@@ -0,0 +1,223 @@
+# @terminal-nerds/snippets-array
+
+![package version badge]
+[![dependencies badge]][dependencies url]\
+[![install size badge]][install size url]
+
+➡️ **This package wraps all available modules with snippets related to [Array]**
+— part of the [terminal-nerds/snippets] project.
+
+[Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array
+[terminal-nerds/snippets]: https://github.com/terminal-nerds/snippets
+[package version badge]: https://img.shields.io/npm/v/@terminal-nerds/snippets-array/latest?style=for-the-badge&logo=npm
+[dependencies badge]: https://img.shields.io/librariesio/release/npm/@terminal-nerds/snippets-array?style=for-the-badge
+[dependencies url]: https://libraries.io/npm/@terminal-nerds%2snippets-array
+[install size badge]: https://packagephobia.com/badge?p=@terminal-nerds/snippets-array
+[install size url]: https://packagephobia.com/result?p=@terminal-nerds/snippets-array
+
+## Modules included
+
+[![documentation badge]][documentation url]
+
+[documentation badge]: https://img.shields.io/static/v1?color=informational&style=for-the-badge&label=documentation&message=jsdocs.io
+[documentation url]: https://jsdocs.io/package/@terminal-nerds/snippets-array
+
+<!-- prettier-sort-markdown-table -->
+
+| Name                                           | Size                                                          |
+| ---------------------------------------------- | ------------------------------------------------------------- |
+| [`@terminal-nerds/snippets-string/compare`]    | ![compare size gzip badge] ![compare size brotli badge]       |
+| [`@terminal-nerds/snippets-string/difference`] | ![difference size gzip badge] ![difference size brotli badge] |
+| [`@terminal-nerds/snippets-string/filter`]     | ![filter size gzip badge] ![filter size brotli badge]         |
+| [`@terminal-nerds/snippets-string/random`]     | ![random size gzip badge] ![random size brotli badge]         |
+| [`@terminal-nerds/snippets-string/schema`]     | ![schema size gzip badge] ![schema size brotli badge]         |
+| [`@terminal-nerds/snippets-string/shuffle`]    | ![shuffle size gzip badge] ![shuffle size brotli badge]       |
+| [`@terminal-nerds/snippets-string/union`]      | ![union size gzip badge] ![union size brotli badge]           |
+| [`@terminal-nerds/snippets-string/unique`]     | ![unique size gzip badge] ![unique size brotli badge]         |
+
+<!-- prettier-ignore-start -->
+<!-- MODULES LINKS -->
+[`@terminal-nerds/snippets-string/compare`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/compare/compare.ts
+[compare size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/compare/compare.js?label=gzip
+[compare size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/compare/compare.js?label=brotli
+
+[`@terminal-nerds/snippets-string/difference`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/difference/difference.ts
+[difference size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/difference/difference.js?label=gzip
+[difference size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/difference/difference.js?label=brotli
+
+[`@terminal-nerds/snippets-string/filter`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/filter/filter.ts
+[filter size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/filter/filter.js?label=gzip
+[filter size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/filter/filter.js?label=brotli
+
+[`@terminal-nerds/snippets-string/random`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/random/random.ts
+[random size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/random/random.js?label=gzip
+[random size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/random/random.js?label=brotli
+
+[`@terminal-nerds/snippets-string/schema`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/schema/schema.ts
+[schema size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/schema/schema.js?label=gzip
+[schema size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/schema/schema.js?label=brotli
+
+[`@terminal-nerds/snippets-string/shuffle`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/shuffle/shuffle.ts
+[shuffle size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/shuffle/shuffle.js?label=gzip
+[shuffle size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/shuffle/shuffle.js?label=brotli
+
+[`@terminal-nerds/snippets-string/union`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/union/union.ts
+[union size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/union/union.js?label=gzip
+[union size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/union/union.js?label=brotli
+
+[`@terminal-nerds/snippets-string/unique`]: https://github.com/terminal-nerds/snippets/blob/main/packages/string/source/unique/unique.ts
+[unique size gzip badge]: https://badgen.net/badgesize/gzip/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/unique/unique.js?label=gzip
+[unique size brotli badge]: https://badgen.net/badgesize/brotli/file-url/unpkg.com/@terminal-nerds/snippets-string/dist/unique/unique.js?label=brotli
+<!-- prettier-ignore-end -->
+
+---
+
+## Prerequisites & usage
+
+### Optional
+
+[![supported typescript version badge]][typescript]
+
+[typescript]: https://typescriptlang.org/
+[typescript icon]: https://api.iconify.design/logos/typescript-icon.svg
+[supported typescript version badge]: https://img.shields.io/github/package-json/dependency-version/terminal-nerds/snippets/peer/typescript?filename=packages%2Ftypescript%2Fpackage.json&logo=typescript&style=for-the-badge&label=typescript
+
+If you are using ![typescript icon] [TypeScript],
+the latest version, which supports new features _(such as `satisfies`)_, is supported.
+
+### Runtime environments
+
+This package can be used in several runtime environments.
+We aim for cross-runtime compatibility and ensure proper error messages
+if a particular snippet cannot be run in the currently running environment.
+
+#### Browsers
+
+We use [browserslist] to define the minimum browsers versions supported.\
+Take a look at our [shared browserslist configuration] for more details.
+
+[browserslist]: https://github.com/browserslist/browserslist
+[shared browserslist configuration]: https://github.com/terminal-nerds/configs/blob/main/packages/browserslist/source/browsers.ts
+
+**Usage**:
+
+```html
+<script type="module">
+	import { snippet } from "https://cdn.jsdelivr.net/npm/@terminal-nerds/snippets-array";
+</script>
+```
+
+---
+
+#### Bun
+
+We aim to support the latest version of ![bun icon] [bun].
+
+**Usage**:
+
+Firstly, install it:
+
+```sh
+bun add @terminal-nerds/snippets-array
+```
+
+And then in a particular file:
+
+```js
+import { snippet } from "@terminal-nerds/snippets-array";
+```
+
+[bun]: https://bun.sh/
+[bun icon]: https://api.iconify.design/logos/bun.svg
+
+---
+
+#### Deno
+
+We aim to support the latest version of ![deno icon] [Deno].
+
+**Usage**:
+
+```ts
+import { snippet } from "npm:@terminal-nerds/snippets-array";
+```
+
+[deno]: https://deno.land/
+[deno icon]: https://api.iconify.design/logos/deno.svg
+
+---
+
+#### Node.js
+
+[![node.js version support badge]][node.js]
+
+The latest ![node.js icon] [Node.js] LTS _(Long-Term Support)_ version is the minimum one supported.
+
+> **Warning**\
+> **This package is written in [ES Module] _(ESM)_ type.**\
+> So, if you wish to use it in a project with CommonJS (CJS) type, you need to bundle this package or a particular module(s).
+
+**Usage**:
+
+Install it first with the Node.js package manager of your choice. In our example, we use [pnpm].
+
+```sh
+pnpm add @terminal-nerds/snippets-array
+```
+
+And then in a particular file:
+
+```js
+import { snippet } from "@terminal-nerds/snippets-array";
+```
+
+[ES Module]: https://www.freecodecamp.org/news/javascript-es-modules-and-module-bundlers
+[pnpm]: https://pnpm.io
+[node.js]: https://nodejs.org/en/
+[node.js icon]: https://api.iconify.design/logos/nodejs-icon.svg
+[node.js version support badge]: https://img.shields.io/node/v-lts/@terminal-nerds/snippets?style=for-the-badge&logo=nodedotjs
+
+---
+
+## Security
+
+[![workflow security badge]][security policy]
+
+🔐 For more information, please refer to the [Security section] at the root of
+the [terminal-nerds/snippets] monorepo.
+
+[workflow security badge]: https://img.shields.io/github/actions/workflow/status/terminal-nerds/snippets/maintenance.yml?label=Security&logo=github&style=for-the-badge&branch=main
+[security section]: https://github.com/terminal-nerds/snippets#security
+[security policy]: https://github.com/terminal-nerds/snippets/security/policy
+
+---
+
+## License
+
+[![license badge]][license]
+
+⚖️ For more information, please refer to the [License section] at the root of the [terminal-nerds/snippets] monorepo.
+
+[license]: https://github.com/terminal-nerds/snippets/blob/main/LICENSE.md
+[license badge]: https://img.shields.io/github/license/terminal-nerds/snippets?style=for-the-badge
+[license section]: https://github.com/terminal-nerds/snippets#License
+
+### Contributing
+
+[![contributors badge]][contributors url]
+
+🤝 **Contributions of any kind are welcome!**
+
+Please refer to the monorepo _([terminal-nerds/snippets])_ project's [CONTRIBUTING file] for more information
+if you wish to get involved.
+
+[contributing file]: https://github.com/terminal-nerds/snippets/blob/main/.github/CONTRIBUTING.md
+[contributors badge]: https://img.shields.io/github/contributors/terminal-nerds/snippets?style=for-the-badge
+[contributors url]: https://github.com/terminal-nerds/snippets#contributors
+
+### Author
+
+🎉 The idea of this project was initiated by [xeho91]. However, it's the [contributors] who matter the most.
+
+[contributors]: https://github.com/terminal-nerds/snippets/blob/main/README.md#project-contributors
+[xeho91]: https://github.com/xeho91

packages/array/package.json

@@ -0,0 +1,89 @@
+{
+	"$schema": "https://json.schemastore.org/package",
+	"type": "module",
+	"name": "@terminal-nerds/snippets-array",
+	"version": "0.0.0",
+	"description": "@terminal-nerds reusable snippets for arrays.",
+	"keywords": [
+		"snippets",
+		"typescript",
+		"array"
+	],
+	"license": "MIT",
+	"author": {
+		"name": "Mateusz Kadlubowski",
+		"email": "[email protected]",
+		"url": "https://xeho91.com"
+	},
+	"homepage": "https://github.com/terminal-nerds/snippets",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/terminal-nerds/snippets.git",
+		"directory": "packages/array"
+	},
+	"bugs": "https://github.com/terminal-nerds/snippets/issues",
+	"engines": {
+		"node": ">=18"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/main.d.ts",
+			"import": "./dist/main.js",
+			"require": "./dist/main.cjs"
+		},
+		"./*": {
+			"types": "./dist/*/*.d.ts",
+			"import": "./dist/*/*.js",
+			"require": "./dist/*/*.cjs"
+		},
+		"./schema/*": {
+			"types": "./dist/schema/*/*.d.ts",
+			"import": "./dist/schema/*/*.js",
+			"require": "./dist/schema/*/*.cjs"
+		}
+	},
+	"files": [
+		"dist/"
+	],
+	"scripts": {
+		"build": "tsup",
+		"clean": "concurrently \"pnpm:clean:*\" --group --timings",
+		"clean:build": "del \"./dist\"",
+		"clean:cache": "del \"./node_modules/.cache\"",
+		"clean:test": "del \"./coverage\"",
+		"dev:test": "vitest watch --ui",
+		"dev:pkg": "tsup --watch",
+		"fix": "concurrently \"pnpm:fix:*\" --group --timings",
+		"fix:format": "pretty-quick --branch main --pattern \"packages/array/**/*\" --verbose",
+		"fix:js": "pnpm lint:js --fix",
+		"fix:md": "pnpm lint:md --fix",
+		"fix:pkg": "syncpack format ; syncpack fix-mismatches",
+		"lint": "concurrently \"pnpm:lint:*\" --group --timings",
+		"lint:deps": "depcheck",
+		"lint:format": "pnpm fix:format --check",
+		"lint:js": "DEBUG=\"eslint:cli-engine\" eslint . --ext .cjs,.js,.ts,.json,.yml --cache --cache-location \"./node_modules/.cache/eslint\"",
+		"lint:md": "markdownlint . --config \"../../.markdownlint.json\" --dot --ignore \"./LICENSE.md\" --ignore-path \"../../.gitignore\"",
+		"lint:pkg": "syncpack list-mismatches",
+		"lint:types": "tsc --noEmit",
+		"test:unit": "vitest run --dir \"./source\""
+	},
+	"peerDependencies": {
+		"typescript": "4.9.5"
+	},
+	"devDependencies": {
+		"@terminal-nerds/snippets-test": "workspace:*"
+	},
+	"peerDependenciesMeta": {
+		"typescript": {
+			"optional": true
+		}
+	},
+	"dependencies": {
+		"@terminal-nerds/snippets-number": "workspace:*",
+		"@terminal-nerds/snippets-type": "workspace:*",
+		"array-differ": "4.0.0",
+		"array-union": "3.0.1",
+		"fast-deep-equal": "3.1.3",
+		"zod": "3.21.4"
+	}
+}