feat(new tool): IPv6 Address Converter

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

Author: sharevb

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

@@ -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/index.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/cidr-tools.d.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/index.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;
+}