feat(new tool): IPv6 Address Converter

Equivalent for IPv6 of https://it-tools.tech/ipv4-address-converter
Fix #548

components.d.ts

@@ -115,6 +115,7 @@ declare module '@vue/runtime-core' {
     Ipv4AddressConverter: typeof import('./src/tools/ipv4-address-converter/ipv4-address-converter.vue')['default']
     Ipv4RangeExpander: typeof import('./src/tools/ipv4-range-expander/ipv4-range-expander.vue')['default']
     Ipv4SubnetCalculator: typeof import('./src/tools/ipv4-subnet-calculator/ipv4-subnet-calculator.vue')['default']
+    Ipv6AddressConverter: typeof import('./src/tools/ipv6-address-converter/ipv6-address-converter.vue')['default']
     Ipv6UlaGenerator: typeof import('./src/tools/ipv6-ula-generator/ipv6-ula-generator.vue')['default']
     JsonDiff: typeof import('./src/tools/json-diff/json-diff.vue')['default']
     JsonMinify: typeof import('./src/tools/json-minify/json-minify.vue')['default']

package.json

@@ -48,6 +48,7 @@
     "@vueuse/router": "^10.0.0",
     "bcryptjs": "^2.4.3",
     "change-case": "^4.1.2",
+    "cidr-tools": "^7.0.4",
     "colord": "^2.9.3",
     "composerize-ts": "^0.6.2",
     "country-code-lookup": "^0.1.0",
@@ -62,6 +63,11 @@
     "highlight.js": "^11.7.0",
     "iarna-toml-esm": "^3.0.5",
     "ibantools": "^4.3.3",
+    "ip-address": "^9.0.5",
+    "ip-bigint": "^8.0.2",
+    "ip-cidr": "^4.0.0",
+    "is-cidr": "^5.0.3",
+    "is-ip": "^5.0.1",
     "json5": "^2.2.3",
     "jwt-decode": "^3.1.2",
     "libphonenumber-js": "^1.10.28",

pnpm-lock.yaml

@@ -44,6 +44,9 @@ dependencies:
   change-case:
     specifier: ^4.1.2
     version: 4.1.2
+  cidr-tools:
+    specifier: ^7.0.4
+    version: 7.0.4
   colord:
     specifier: ^2.9.3
     version: 2.9.3
@@ -86,6 +89,21 @@ dependencies:
   ibantools:
     specifier: ^4.3.3
     version: 4.3.3
+  ip-address:
+    specifier: ^9.0.5
+    version: 9.0.5
+  ip-bigint:
+    specifier: ^8.0.2
+    version: 8.0.2
+  ip-cidr:
+    specifier: ^4.0.0
+    version: 4.0.0
+  is-cidr:
+    specifier: ^5.0.3
+    version: 5.0.3
+  is-ip:
+    specifier: ^5.0.1
+    version: 5.0.1
   json5:
     specifier: ^2.2.3
     version: 2.2.3
@@ -3374,7 +3392,7 @@ packages:
     dependencies:
       '@unhead/dom': 0.5.1
       '@unhead/schema': 0.5.1
-      '@vueuse/shared': 10.6.1(vue@3.3.4)
+      '@vueuse/shared': 10.7.2(vue@3.3.4)
       unhead: 0.5.1
       vue: 3.3.4
     transitivePeerDependencies:
@@ -4016,8 +4034,8 @@ packages:
       - vue
     dev: false
 
-  /@vueuse/shared@10.6.1(vue@3.3.4):
+  /@vueuse/shared@10.7.2(vue@3.3.4):
-    resolution: {integrity: sha512-TECVDTIedFlL0NUfHWncf3zF9Gc4VfdxfQc8JFwoVZQmxpONhLxFrlm0eHQeidHj4rdTPL3KXJa0TZCk1wnc5Q==}
+    resolution: {integrity: sha512-qFbXoxS44pi2FkgFjPvF4h7c9oMDutpyBdcJdMYIMg9XyXli2meFMuaKn+UMgsClo//Th6+beeCgqweT/79BVA==}
     dependencies:
       vue-demi: 0.14.6(vue@3.3.4)
     transitivePeerDependencies:
@@ -4486,6 +4504,20 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /cidr-regex@4.0.3:
+    resolution: {integrity: sha512-HOwDIy/rhKeMf6uOzxtv7FAbrz8zPjmVKfSpM+U7/bNBXC5rtOyr758jxcptiSx6ZZn5LOhPJT5WWxPAGDV8dw==}
+    engines: {node: '>=14'}
+    dependencies:
+      ip-regex: 5.0.0
+    dev: false
+
+  /cidr-tools@7.0.4:
+    resolution: {integrity: sha512-bKd6xC01ObuVKvJPGdV9Rz02KFO3mtHwMe/QTlcVuFAmU5n3RN/F3FgppHZaQjM+c/1i9YB9rgKNH/5iVqwCoA==}
+    engines: {node: '>=18'}
+    dependencies:
+      ip-bigint: 8.0.2
+    dev: false
+
   /clean-regexp@1.0.0:
     resolution: {integrity: sha512-GfisEZEJvzKrmGWkvfhgzcz/BllN1USeqD2V6tg14OAOgaCD2Z/PUEuxnAZ/nPvmaHRG7a8y77p1T/IRQ4D1Hw==}
     engines: {node: '>=4'}
@@ -4513,6 +4545,13 @@ packages:
       wrap-ansi: 6.2.0
     dev: false
 
+  /clone-regexp@3.0.0:
+    resolution: {integrity: sha512-ujdnoq2Kxb8s3ItNBtnYeXdm07FcU0u8ARAT1lQ2YdMwQC+cdiXX8KoqMVuglztILivceTtp4ivqGSmEmhBUJw==}
+    engines: {node: '>=12'}
+    dependencies:
+      is-regexp: 3.1.0
+    dev: false
+
   /clone@1.0.4:
     resolution: {integrity: sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==}
     engines: {node: '>=0.8'}
@@ -4617,6 +4656,11 @@ packages:
       upper-case: 2.0.2
     dev: false
 
+  /convert-hrtime@5.0.0:
+    resolution: {integrity: sha512-lOETlkIeYSJWcbbcvjRKGxVMXJR+8+OQb/mTPbA4ObPMytYIsUbuOE0Jzy60hjARYszq1id0j8KgVhC+WGZVTg==}
+    engines: {node: '>=12'}
+    dev: false
+
   /convert-source-map@1.9.0:
     resolution: {integrity: sha512-ASFBup0Mz1uyiIjANan1jzLQami9z1PoYSZCiiYW2FczPbenXc45FZdBZLzOT+r6+iciuEModtmCti+hjaAk0A==}
     dev: true
@@ -5761,6 +5805,11 @@ packages:
     resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
     dev: true
 
+  /function-timeout@0.1.1:
+    resolution: {integrity: sha512-0NVVC0TaP7dSTvn1yMiy6d6Q8gifzbvQafO46RtLG/kHJUBNd+pVRGOBoK44wNBvtSPUJRfdVvkFdD3p0xvyZg==}
+    engines: {node: '>=14.16'}
+    dev: false
+
   /function.prototype.name@1.1.6:
     resolution: {integrity: sha512-Z5kx79swU5P27WEayXM1tBi5Ze/lbIyiNgU3qyXUOf9b2rgXYyF9Dy9Cx+IQv/Lc8WCG6L82zwUPpSS9hGehIg==}
     engines: {node: '>= 0.4'}
@@ -6195,6 +6244,19 @@ packages:
       sprintf-js: 1.1.2
     dev: false
 
+  /ip-address@9.0.5:
+    resolution: {integrity: sha512-zHtQzGojZXTwZTHQqra+ETKd4Sn3vgi7uBmlPoXVWZqYvuKmtI0l/VZTjqGmJY9x88GGOaZ9+G9ES8hC4T4X8g==}
+    engines: {node: '>= 12'}
+    dependencies:
+      jsbn: 1.1.0
+      sprintf-js: 1.1.3
+    dev: false
+
+  /ip-bigint@8.0.2:
+    resolution: {integrity: sha512-UMKHGx7+4O2mD/6jnpNtt4UMA0tRQ3XAiNVYlbLssFU1LegKqKwPqbqtLVW7lQU/c6rCWI1hcxxs4TP96Xa+rQ==}
+    engines: {node: '>=18'}
+    dev: false
+
   /ip-cidr@3.1.0:
     resolution: {integrity: sha512-HUCn4snshEX1P8cja/IyU3qk8FVDW8T5zZcegDFbu4w7NojmAhk5NcOgj3M8+0fmumo1afJTPDtJlzsxLdOjtg==}
     engines: {node: '>=10.0.0'}
@@ -6203,6 +6265,18 @@ packages:
       jsbn: 1.1.0
     dev: false
 
+  /ip-cidr@4.0.0:
+    resolution: {integrity: sha512-i1Jhb9sqm2+PuOHTfya3ekAUi+dadhgcEz+4FKKY1hXemocP4Xf7io8Xflc74/i2ejxe/5fp4z8z3BAsfAZ8sw==}
+    engines: {node: '>=16.14.0'}
+    dependencies:
+      ip-address: 9.0.5
+    dev: false
+
+  /ip-regex@5.0.0:
+    resolution: {integrity: sha512-fOCG6lhoKKakwv+C6KdsOnGvgXnmgfmp0myi3bcNwj3qfwPAxRKWEuFhvEFF7ceYIz6+1jRZ+yguLFAmUNPEfw==}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+    dev: false
+
   /is-alphabetical@1.0.4:
     resolution: {integrity: sha512-DwzsA04LQ10FHTZuL0/grVDk4rFoVH1pjAToYwBrHSxcrBIGQuXrQMtD5U1b0U2XVgKZCTLLP8u2Qxqhy3l2Vg==}
     dev: true
@@ -6258,6 +6332,13 @@ packages:
     engines: {node: '>= 0.4'}
     dev: true
 
+  /is-cidr@5.0.3:
+    resolution: {integrity: sha512-lKkM0tmz07dAxNsr8Ii9MGreExa9ZR34N9j8mTG5op824kcwBqinZPowNjcVWWc7j+jR8XAMMItOmBkniN0jOA==}
+    engines: {node: '>=14'}
+    dependencies:
+      cidr-regex: 4.0.3
+    dev: false
+
   /is-core-module@2.13.0:
     resolution: {integrity: sha512-Z7dk6Qo8pOCp3l4tsX2C5ZVas4V+UxwQodwZhLopL91TX8UyyHEXafPcyoeeWuLrwzHcr3igO78wNLwHJHsMCQ==}
     dependencies:
@@ -6323,6 +6404,14 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /is-ip@5.0.1:
+    resolution: {integrity: sha512-FCsGHdlrOnZQcp0+XT5a+pYowf33itBalCl+7ovNXC/7o5BhIpG14M3OrpPPdBSIQJCm+0M5+9mO7S9VVTTCFw==}
+    engines: {node: '>=14.16'}
+    dependencies:
+      ip-regex: 5.0.0
+      super-regex: 0.2.0
+    dev: false
+
   /is-lower-case@1.1.3:
     resolution: {integrity: sha512-+5A1e/WJpLLXZEDlgz4G//WYSHyQBD32qa4Jd3Lw06qQlv3fJHnp3YIHjTQSGzHMgzmVKz2ZP3rBxTHkPw/lxA==}
     dependencies:
@@ -6388,6 +6477,11 @@ packages:
     engines: {node: '>=0.10.0'}
     dev: true
 
+  /is-regexp@3.1.0:
+    resolution: {integrity: sha512-rbku49cWloU5bSMI+zaRaXdQHXnthP6DZ/vLnfdSKyL4zUzuWnomtOEiZZOd+ioQ+avFo/qau3KPTc7Fjy1uPA==}
+    engines: {node: '>=12'}
+    dev: false
+
   /is-shared-array-buffer@1.0.2:
     resolution: {integrity: sha512-sqN2UDu1/0y6uvXyStCOzyhAjCSlHceFoMKJW8W9EU9cvic/QdsZ0kEU93HEy3IUEFZIiH/3w+AH/UQbPHNdhA==}
     dependencies:
@@ -8225,6 +8319,10 @@ packages:
     resolution: {integrity: sha512-VE0SOVEHCk7Qc8ulkWw3ntAzXuqf7S2lvwQaDLRnUeIEaKNQJzV6BwmLKhOqT61aGhfUMrXeaBk+oDGCzvhcug==}
     dev: false
 
+  /sprintf-js@1.1.3:
+    resolution: {integrity: sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==}
+    dev: false
+
   /sql-formatter@13.0.0:
     resolution: {integrity: sha512-V21cVvge4rhn9Fa7K/fTKcmPM+x1yee6Vhq8ZwgaWh3VPBqApgsaoFB5kLAhiqRo5AmSaRyLU7LIdgnNwH01/w==}
     hasBin: true
@@ -8355,6 +8453,15 @@ packages:
     dependencies:
       acorn: 8.11.2
 
+  /super-regex@0.2.0:
+    resolution: {integrity: sha512-WZzIx3rC1CvbMDloLsVw0lkZVKJWbrkJ0k1ghKFmcnPrW1+jWbgTkTEWVtD9lMdmI4jZEz40+naBxl1dCUhXXw==}
+    engines: {node: '>=14.16'}
+    dependencies:
+      clone-regexp: 3.0.0
+      function-timeout: 0.1.1
+      time-span: 5.1.0
+    dev: false
+
   /supports-color@5.5.0:
     resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
     engines: {node: '>=4'}
@@ -8447,6 +8554,13 @@ packages:
     resolution: {integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==}
     dev: true
 
+  /time-span@5.1.0:
+    resolution: {integrity: sha512-75voc/9G4rDIJleOo4jPvN4/YC4GRZrY8yy1uU4lwrB3XEQbWve8zXoO5No4eFrGcTAMYyoY67p8jRQdtA1HbA==}
+    engines: {node: '>=12'}
+    dependencies:
+      convert-hrtime: 5.0.0
+    dev: false
+
   /tiny-emitter@2.1.0:
     resolution: {integrity: sha512-NB6Dk1A9xgQPMoGqC5CVXn123gWyte215ONT5Pp5a0yt4nlEoO1ZWeCwpncaekPHXO60i47ihFnZPiRPjRMq4Q==}
     dev: false

src/tools/index.ts

@@ -77,6 +77,7 @@ import { tool as uuidGenerator } from './uuid-generator';
 import { tool as macAddressLookup } from './mac-address-lookup';
 import { tool as xmlFormatter } from './xml-formatter';
 import { tool as yamlViewer } from './yaml-viewer';
+import { tool as ipv6AddressConverter } from './ipv6-address-converter';
 
 export const toolsByCategory: ToolCategory[] = [
   {
@@ -147,7 +148,15 @@ export const toolsByCategory: ToolCategory[] = [
   },
   {
     name: 'Network',
-    components: [ipv4SubnetCalculator, ipv4AddressConverter, ipv4RangeExpander, macAddressLookup, macAddressGenerator, ipv6UlaGenerator],
+    components: [
+      ipv4SubnetCalculator,
+      ipv4AddressConverter,
+      ipv6AddressConverter,
+      ipv4RangeExpander,
+      macAddressLookup,
+      macAddressGenerator,
+      ipv6UlaGenerator,
+    ],
   },
   {
     name: 'Math',

src/tools/ipv6-address-converter/cidr-tools.d.ts

@@ -0,0 +1,42 @@
+declare module 'cidr-tools' {
+  type IPv4Address = string;
+  type IPv4CIDR = string;
+  type IPv6Address = string;
+  type IPv6CIDR = string;
+  
+  type Network = IPv4Address | IPv4CIDR | IPv6Address | IPv6CIDR;
+  type Networks = Network | Network[];
+  
+  type Parsed = {
+    cidr: string;
+    version: number;
+    prefix: string;
+    start: bigint;
+    end: bigint;
+    single: boolean;
+  };
+  
+  type NormalizeOpts = {
+    compress?: boolean;
+    hexify?: boolean;
+  };
+  
+  export function merge(networks: Networks): Network[];
+  export function exclude(baseNetworks: Networks, excludeNetworks: Networks): Network[];
+  export function expand(networks: Networks): Network[];
+  export function overlap(networksA: Networks, networksB: Networks): boolean;
+  export function normalize(cidr: Networks, opts?: NormalizeOpts): Networks;
+  export function contains(networksA: Networks, networksB: Networks): boolean;
+  export function parse(network: Network): Parsed;
+  
+  declare const _default: {
+    merge: typeof merge;
+    exclude: typeof exclude;
+    expand: typeof expand;
+    overlap: typeof overlap;
+    normalize: typeof normalize;
+    contains: typeof contains;
+    parse: typeof parse;
+  };
+  export default _default;
+}

src/tools/ipv6-address-converter/index.ts

@@ -0,0 +1,12 @@
+import { Binary } from '@vicons/tabler';
+import { defineTool } from '../tool';
+
+export const tool = defineTool({
+  name: 'Ipv6 address converter',
+  path: '/ipv6-address-converter',
+  description: 'Convert an ip address into decimal, binary, hexadecimal and get infos',
+  keywords: ['ipv6', 'address', 'converter', 'decimal', 'hexadecimal', 'binary', 'ipv4'],
+  component: () => import('./ipv6-address-converter.vue'),
+  icon: Binary,
+  createdAt: new Date('2024-01-10'),
+});

src/tools/ipv6-address-converter/ip-bigint.d.ts

@@ -0,0 +1,17 @@
+declare module 'ip-bigint' {
+  type IPInfo = {
+    number: bigint; 
+    version: number;
+    ipv4mapped?: boolean;
+    scopeid?:string;
+  };
+  type StringifyOptions = { 
+    compress?:boolean;
+    hexify?:boolean;
+  };
+  
+  export function normalizeIp(ip: string, options: StringifyOptions = {compress = true, hexify = false} = {})
+  export function stringifyIp(ip: IPInfo, options: StringifyOptions = {compress = true, hexify = false}): string;
+  export function ipVersion(ip: string): number;
+  export function parseIp(ip): IPInfo;
+}

src/tools/ipv6-address-converter/ipv6-address-converter.vue

@@ -0,0 +1,71 @@
+<script setup lang="ts">
+import { isIPv6 } from 'is-ip';
+import { parse } from 'cidr-tools';
+import { stringifyIp } from 'ip-bigint';
+import { convertBase } from '../integer-base-converter/integer-base-converter.model';
+import { useValidation } from '@/composable/validation';
+
+const rawIpAddress = useStorage('ipv6-converter:ip', '2001:db8:0:85a3::ac1f:8001');
+
+const convertedSections = computed(() => {
+  try {
+    const parsedIPv6 = parse(rawIpAddress.value);
+    const ipInDecimal = parsedIPv6.start;
+
+    return [
+      {
+        label: 'Decimal: ',
+        value: String(ipInDecimal),
+      },
+      {
+        label: 'Hexadecimal: ',
+        value: convertBase({ fromBase: 10, toBase: 16, value: String(ipInDecimal) }).toUpperCase(),
+      },
+      {
+        label: 'Binary: ',
+        value: convertBase({ fromBase: 10, toBase: 2, value: String(ipInDecimal) }),
+      },
+      {
+        label: 'CIDR: ',
+        value: parsedIPv6.cidr,
+      },
+      {
+        label: 'Ipv6 (short): ',
+        value: stringifyIp({ number: ipInDecimal, version: 6 }, { compress: true }),
+      },
+      {
+        label: 'Ipv6 (long): ',
+        value: stringifyIp({ number: ipInDecimal, version: 6 }, { compress: false }),
+      },
+    ];
+  }
+  catch (e) {
+    return [];
+  }
+});
+
+const { attrs: validationAttrs } = useValidation({
+  source: rawIpAddress,
+  rules: [{ message: 'Invalid ipv6 address', validator: ip => isIPv6(ip) }],
+});
+</script>
+
+<template>
+  <div>
+    <c-input-text v-model:value="rawIpAddress" label="The ipv6 address:" placeholder="The ipv6 address..." />
+
+    <n-divider />
+
+    <input-copyable
+      v-for="{ label, value } of convertedSections"
+      :key="label"
+      :label="label"
+      label-position="left"
+      label-width="100px"
+      label-align="right"
+      mb-2
+      :value="validationAttrs.validationStatus === 'error' ? '' : value"
+      placeholder="Set a correct ipv6 address"
+    />
+  </div>
+</template>

src/tools/ipv6-address-converter/is-ip.d.ts

@@ -0,0 +1,63 @@
+declare module 'is-ip' {
+  
+  /**
+  Check if `string` is IPv6 or IPv4.
+  
+  @example
+  ```
+  import {isIP} from 'is-ip';
+  
+  isIP('1:2:3:4:5:6:7:8');
+  //=> true
+  
+  isIP('192.168.0.1');
+  //=> true
+  ```
+  */
+  export function isIP(string: string): boolean; // eslint-disable-line @typescript-eslint/naming-convention
+  
+  /**
+  Check if `string` is IPv6.
+  
+  @example
+  ```
+  import {isIPv6} from 'is-ip';
+  
+  isIPv6('1:2:3:4:5:6:7:8');
+  //=> true
+  ```
+  */
+  export function isIPv6(string: string): boolean; // eslint-disable-line @typescript-eslint/naming-convention
+  
+  /**
+  Check if `string` is IPv4.
+  
+  @example
+  ```
+  import {isIPv4} from 'is-ip';
+  
+  isIPv4('192.168.0.1');
+  //=> true
+  ```
+  */
+  export function isIPv4(string: string): boolean; // eslint-disable-line @typescript-eslint/naming-convention
+  
+  /**
+  @returns `6` if `string` is IPv6, `4` if `string` is IPv4, or `undefined` if `string` is neither.
+  
+  @example
+  ```
+  import {ipVersion} from 'is-ip';
+  
+  ipVersion('1:2:3:4:5:6:7:8');
+  //=> 6
+  
+  ipVersion('192.168.0.1');
+  //=> 4
+  
+  ipVersion('abc');
+  //=> undefined
+  ```
+  */
+  export function ipVersion(string: string): 6 | 4 | undefined;
+}