From 127fcafc96d8774b05734973ad7d5077b3a1b9c9 Mon Sep 17 00:00:00 2001
From: Zefir Kirilov <contact@zefir.pro>
Date: Tue, 31 Mar 2026 08:54:17 +0300
Subject: [PATCH 1/3] created separate script to run tests with coverage

---
 .github/workflows/ci.yml                              |  4 ++--
 .../runConfigurations/{test.xml => test_coverage.xml} | 11 +++--------
 package.json                                          |  3 ++-
 3 files changed, 7 insertions(+), 11 deletions(-)
 rename .idea/runConfigurations/{test.xml => test_coverage.xml} (62%)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index bc76422..3a97a27 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -76,7 +76,7 @@ jobs:
         run: tar -xzf cldn-ip-0.0.0-dev.tgz --strip-components=1 -C . --overwrite
 
       - name: Test
-        run: npm run test
+        run: npm run test:coverage
 
   test-deno:
     name: Test on Deno
@@ -98,7 +98,7 @@ jobs:
         run: deno fmt --check
 
       - name: Test
-        run: deno task test
+        run: deno task test:coverage
 
   publish:
     name: Publish
diff --git a/.idea/runConfigurations/test.xml b/.idea/runConfigurations/test_coverage.xml
similarity index 62%
rename from .idea/runConfigurations/test.xml
rename to .idea/runConfigurations/test_coverage.xml
index 41b0eea..b6d237a 100644
--- a/.idea/runConfigurations/test.xml
+++ b/.idea/runConfigurations/test_coverage.xml
@@ -1,17 +1,12 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration
-    default="false"
-    name="test"
-    type="js.build_tools.npm"
-    nameIsGenerated="true"
-  >
+  <configuration default="false" name="test:coverage" type="js.build_tools.npm" nameIsGenerated="true">
     <package-json value="$PROJECT_DIR$/package.json" />
     <command value="run" />
     <scripts>
-      <script value="test" />
+      <script value="test:coverage" />
     </scripts>
     <node-interpreter value="project" />
     <envs />
     <method v="2" />
   </configuration>
-</component>
+</component>
\ No newline at end of file
diff --git a/package.json b/package.json
index db77c0b..36bfb52 100644
--- a/package.json
+++ b/package.json
@@ -13,7 +13,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "test": "vitest run --coverage",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "docs:gen": "typedoc && rm -rf docs/api && mv api docs/api",
     "predocs:dev": "npm run docs:gen",
     "docs:dev": "vitepress dev docs",

From a140fff47068230351123f6575c0130214da96d1 Mon Sep 17 00:00:00 2001
From: Zefir Kirilov <contact@zefir.pro>
Date: Tue, 31 Mar 2026 08:54:33 +0300
Subject: [PATCH 2/3] added bun tests

---
 .github/workflows/ci.yml                  | 19 +++++++++++++++++++
 .idea/runConfigurations/test_coverage.xml |  9 +++++++--
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3a97a27..93ad874 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -100,11 +100,30 @@ jobs:
       - name: Test
         run: deno task test:coverage
 
+  test-bun:
+    name: Test on Bun
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Run tests
+        run: bun run test
+
   publish:
     name: Publish
     needs:
       - test
       - test-deno
+      - test-bun
     if: github.event_name == 'release'
     runs-on: ubuntu-latest
     permissions:
diff --git a/.idea/runConfigurations/test_coverage.xml b/.idea/runConfigurations/test_coverage.xml
index b6d237a..75c6af6 100644
--- a/.idea/runConfigurations/test_coverage.xml
+++ b/.idea/runConfigurations/test_coverage.xml
@@ -1,5 +1,10 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="test:coverage" type="js.build_tools.npm" nameIsGenerated="true">
+  <configuration
+    default="false"
+    name="test:coverage"
+    type="js.build_tools.npm"
+    nameIsGenerated="true"
+  >
     <package-json value="$PROJECT_DIR$/package.json" />
     <command value="run" />
     <scripts>
@@ -9,4 +14,4 @@
     <envs />
     <method v="2" />
   </configuration>
-</component>
\ No newline at end of file
+</component>

From 1e1290af2921a99b0d4d3385a0b7938687a35ff4 Mon Sep 17 00:00:00 2001
From: Zefir Kirilov <contact@zefir.pro>
Date: Tue, 31 Mar 2026 09:45:58 +0300
Subject: [PATCH 3/3] compacted the usage section together and added info for
 Bun

---
 README.md | 29 +++++++++++------------------
 1 file changed, 11 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index e1cb501..1db9dec 100644
--- a/README.md
+++ b/README.md
@@ -15,29 +15,22 @@ arithmetic on IP addresses and subnets.
 
 ## Usage
 
-### Node.js
+### Installation
 
-Install from NPM:
+Install the package using your preferred environment:
 
 ```sh
+# Node.js
 npm install @cldn/ip
-```
-
-Import and use:
-
-```ts
-import { IPv4, IPv6, Subnet } from "@cldn/ip";
-```
-
-### Deno
-
-Add from JSR:
 
-```sh
+# Deno
 deno add jsr:@cldn/ip
+
+# Bun
+bun install @cldn/ip
 ```
 
-Import and use:
+### Import
 
 ```ts
 import { IPv4, IPv6, Subnet } from "@cldn/ip";
@@ -46,10 +39,10 @@ import { IPv4, IPv6, Subnet } from "@cldn/ip";
 ### Browsers
 
 For browser usage, it is recommended to use a bundler like
-[Vite](https://vitejs.dev/), or [Webpack](https://webpack.js.org/). If you are
-using a bundler, follow the same usage as for Node.js.
+[Vite](https://vitejs.dev/) or [Webpack](https://webpack.js.org/). If using a
+bundler, import as above.
 
-Alternatively, you can import the library as a
+Alternatively, load as a
 [JavaScript module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
 from [ESM>CDN](https://esm.sh/):