Merge branch 'feat/isbn-formatter' into chore/all-my-stuffs

# Conflicts:
#	package.json
#	pnpm-lock.yaml
#	src/tools/index.ts

Author: sharevb

package.json

@@ -217,6 +217,7 @@
     "ip-cidr": "^4.0.0",
     "is-cidr": "^5.0.3",
     "is-ip": "^5.0.1",
+    "isbn3": "^1.1.44",
     "json5": "^2.2.3",
     "jsonpath": "^1.1.1",
     "jsonar-mod": "^1.9.0",

pnpm-lock.yaml

@@ -202,6 +202,7 @@ import { tool as powerConverter } from './power-converter';
 import { tool as dockerComposeConverter } from './docker-compose-converter';
 import { tool as imageExifReader } from './image-exif-reader';
 import { tool as ipInRange } from './ip-in-range';
+import { tool as isbnValidatorAndParser } from './isbn-validator-and-parser';
 import { tool as yamlViewer } from './yaml-viewer';
 import { tool as barcodeReader } from './barcode-reader';
 import { tool as barcodeGenerator } from './barcode-generator';
@@ -506,6 +507,7 @@ export const toolsByCategory: ToolCategory[] = [
       luhnValidator,
       vatValidator,
       airCodes,
+      isbnValidatorAndParser,
     ],
   },
 ];

src/tools/index.ts

@@ -0,0 +1,12 @@
+import { Books } from '@vicons/tabler';
+import { defineTool } from '../tool';
+
+export const tool = defineTool({
+  name: 'ISBN Validator and Parser',
+  path: '/isbn-validator-and-parser',
+  description: 'Parse, validate, format and get infos for an ISBN',
+  keywords: ['isbn', 'validator', 'parser', 'formatter'],
+  component: () => import('./isbn-validator-and-parser.vue'),
+  icon: Books,
+  createdAt: new Date('2024-01-10'),
+});

src/tools/isbn-validator-and-parser/index.ts

@@ -0,0 +1,101 @@
+<script setup lang="ts">
+import ISBN3 from 'isbn3';
+import type { CKeyValueListItems } from '@/ui/c-key-value-list/c-key-value-list.types';
+
+const rawIsbn = ref('9782021304534');
+
+const isbnInfos = computed<CKeyValueListItems>(() => {
+  const isbn = ISBN3.parse(rawIsbn.value);
+
+  if (isbn == null) {
+    return [];
+  }
+
+  return [
+    {
+      label: 'Is ISBN valid ?',
+      value: isbn.isValid,
+    },
+    {
+      label: 'Country',
+      value: isbn.groupname,
+    },
+    {
+      label: 'ISBN 13',
+      value: isbn.isbn13,
+    },
+    {
+      label: 'ISBN 13 Formatted',
+      value: isbn.isbn13h,
+    },
+    {
+      label: 'ISBN 10',
+      value: isbn.isbn10,
+    },
+    {
+      label: 'ISBN 10 Formatted',
+      value: isbn.isbn10h,
+    },
+  ];
+});
+
+function isbnChecksum(isbn: string) {
+  let check = 0;
+
+  if (isbn.length === 9) {
+    for (let n = 0; n < 9; n += 1) {
+      check += (10 - n) * Number(isbn.charAt(n));
+    }
+    check = (11 - check % 11) % 11;
+    return check === 10 ? 'X' : String(check);
+  }
+  else if (isbn.length === 12) {
+    for (let n = 0; n < 12; n += 2) {
+      check += Number(isbn.charAt(n)) + 3 * Number(isbn.charAt(n + 1));
+    }
+    return String((10 - check % 10) % 10);
+  }
+
+  return null;
+}
+
+const normalizedISBN = computed(() => {
+  let normalized = rawIsbn.value.replace(/[^\dX]/g, '');
+  if (normalized.length >= 13) {
+    normalized = normalized.substring(0, 12);
+  }
+  else if (normalized.length >= 10) {
+    normalized = normalized.substring(0, 9);
+  }
+  const checksum = isbnChecksum(normalized);
+  return ISBN3.parse(`${normalized}${checksum}`)?.isbn13h;
+});
+
+const isbnAuditInfos = computed<{ isValid: boolean; clues: CKeyValueListItems }>(() => {
+  const isbn = ISBN3.audit(rawIsbn.value);
+
+  const isValid = (isbn?.validIsbn ?? false);
+  return {
+    isValid,
+    clues: Array.from((isbn?.clues ?? []),
+      clue => ({ label: `${clue.message} (${clue.groupname})`, value: clue.candidate })),
+  };
+});
+</script>
+
+<template>
+  <div>
+    <c-input-text v-model:value="rawIsbn" placeholder="Enter an ISBN to check for validity..." test-id="isbn-input" />
+    <n-alert v-if="!isbnAuditInfos.isValid" type="error">
+      Invalid ISBN.
+      <input-copyable v-if="normalizedISBN" label="Probably correct" label-position="left" :value="normalizedISBN" disabled="true" />
+    </n-alert>
+
+    <c-card v-if="isbnInfos.length > 0" mt-5 title="ISBN Infos">
+      <c-key-value-list :items="isbnInfos" data-test-id="isbn-info" />
+    </c-card>
+    <c-card v-if="isbnAuditInfos.clues.length > 0" mt-5 title="ISBN Audit Infos">
+      <c-key-value-list :items="isbnAuditInfos" data-test-id="isbn-info" />
+    </c-card>
+  </div>
+</template>