feat: add WishMap class with extended functionality and event emission

- Implemented WishMap class extending Map with array-like methods.
- Added event emission for set and delete operations.
- Added package.json and tsconfig.json for project setup and TypeScript configuration.

Author: danliyev

.github/workflows/bump-version.yml

@@ -0,0 +1,45 @@
+name: Bump version
+
+on:
+  pull_request:
+    branches: [prod]
+    types: [labeled]
+  workflow_dispatch:
+
+jobs:
+  commit:
+    if: ${{ contains(github.event.label.name, 'major') || contains(github.event.label.name, 'minor') || contains(github.event.label.name, 'patch') }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 22
+      - name: Get semver
+        id: semver
+        run: |
+          semver=""
+
+          if [[ "${{ github.event.label.name }}" == *"patch"* ]]; then
+              semver='patch'
+          elif [[ "${{ github.event.label.name }}" == *"minor"* ]]; then
+              semver='minor'
+          elif [[ "${{ github.event.label.name }}" == *"major"* ]]; then
+              semver='major'
+          fi
+
+          echo semver=$semver >> $GITHUB_OUTPUT
+      - name: Setup Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git remote set-url --push origin https://${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
+      - name: Bump version
+        run: |
+          git checkout -b $GITHUB_HEAD_REF
+          npm version ${{ steps.semver.outputs.semver }} -m "chore: bump version to %s"
+      - name: Push
+        run: |
+          git pull --rebase origin $GITHUB_HEAD_REF
+          git push origin $GITHUB_HEAD_REF --follow-tags

.github/workflows/deploy-docs.yml

@@ -0,0 +1,45 @@
+name: Deploy documentation
+
+on:
+  # Run when a release is published
+  workflow_run:
+    workflows: ['Publish package']
+    types: [completed]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: |
+          npx typedoc src/index.ts --out docs
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/publish-package.yml

@@ -0,0 +1,40 @@
+name: Publish package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  packages: write
+
+jobs:
+  publish-ghp:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://npm.pkg.github.com/
+          scope: '@danliyev'
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-npm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org/
+          scope: '@danliyev'
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -90,6 +90,7 @@ out
 # Nuxt.js build / generate output
 .nuxt
 dist
+docs/
 
 # Gatsby files
 .cache/

.npmignore

@@ -0,0 +1,8 @@
+.github/
+.vscode/
+docs/
+src/
+.gitignore
+.prettierrc
+.prettierignore
+tsconfig.json

.prettierrc

@@ -0,0 +1,16 @@
+{
+    "trailingComma": "none",
+    "tabWidth": 4,
+    "singleQuote": true,
+    "semi": false,
+    "arrowParens": "avoid",
+    "printWidth": 120,
+    "overrides": [
+        {
+            "files": ["*.json", "*.yml"],
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+        "source.organizeImports": "explicit"
+    },
+    "cSpell.words": []
+}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Lacuna
+Copyright (c) 2025 Daniyar Kurmangaliyev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -0,0 +1,47 @@
+# About
+
+An extended `Map` with Array-like methods and event emission.
+
+# Links
+
+[API Docs](https://danliyev.github.io/wishmap)
+
+## Installation
+
+```bash
+npm install wishmap
+```
+
+## Usage
+
+```typescript
+import { WishMap } from 'wishmap'
+
+const map = new WishMap<string, number>()
+
+// Listen to events
+map.events.on('set', (key, value) => {
+    console.log(`Set ${key} = ${value}`)
+})
+
+map.events.on('delete', (key, value) => {
+    console.log(`Deleted ${key} (was ${value})`)
+})
+
+// Use like a regular Map
+map.set('a', 1)
+map.set('b', 2)
+map.set('c', 3)
+
+// Use Array-like methods
+map.filter(v => v > 1) // WishMap { 'b' => 2, 'c' => 3 }
+map.map(v => v * 2) // [2, 4, 6]
+map.find(v => v === 2) // 2
+map.every(v => v > 0) // true
+map.some(v => v > 2) // true
+map.reduce((acc, v) => acc + v, 0) // 6
+```
+
+## License
+
+This project is licensed under the [MIT License](./LICENSE).