feat(new tool): Currency Converter

Fix part of CorentinTh#571

Author: sharevb

components.d.ts

@@ -64,6 +64,7 @@ declare module '@vue/runtime-core' {
     'CTextCopyable.demo': typeof import('./src/ui/c-text-copyable/c-text-copyable.demo.vue')['default']
     CTooltip: typeof import('./src/ui/c-tooltip/c-tooltip.vue')['default']
     'CTooltip.demo': typeof import('./src/ui/c-tooltip/c-tooltip.demo.vue')['default']
+    CurrencyConverter: typeof import('./src/tools/currency-converter/currency-converter.vue')['default']
     DateTimeConverter: typeof import('./src/tools/date-time-converter/date-time-converter.vue')['default']
     'DemoHome.page': typeof import('./src/ui/demo/demo-home.page.vue')['default']
     DemoWrapper: typeof import('./src/ui/demo/demo-wrapper.vue')['default']
@@ -129,11 +130,12 @@ declare module '@vue/runtime-core' {
     MetaTagGenerator: typeof import('./src/tools/meta-tag-generator/meta-tag-generator.vue')['default']
     MimeTypes: typeof import('./src/tools/mime-types/mime-types.vue')['default']
     NavbarButtons: typeof import('./src/components/NavbarButtons.vue')['default']
-    NCode: typeof import('naive-ui')['NCode']
     NCollapseTransition: typeof import('naive-ui')['NCollapseTransition']
     NConfigProvider: typeof import('naive-ui')['NConfigProvider']
+    NDatePicker: typeof import('naive-ui')['NDatePicker']
+    NDivider: typeof import('naive-ui')['NDivider']
+    NDynamicInput: typeof import('naive-ui')['NDynamicInput']
     NEllipsis: typeof import('naive-ui')['NEllipsis']
-    NForm: typeof import('naive-ui')['NForm']
     NFormItem: typeof import('naive-ui')['NFormItem']
     NH1: typeof import('naive-ui')['NH1']
     NH3: typeof import('naive-ui')['NH3']
@@ -142,9 +144,9 @@ declare module '@vue/runtime-core' {
     NLayout: typeof import('naive-ui')['NLayout']
     NLayoutSider: typeof import('naive-ui')['NLayoutSider']
     NMenu: typeof import('naive-ui')['NMenu']
-    NScrollbar: typeof import('naive-ui')['NScrollbar']
-    NSlider: typeof import('naive-ui')['NSlider']
-    NSwitch: typeof import('naive-ui')['NSwitch']
+    NP: typeof import('naive-ui')['NP']
+    NSelect: typeof import('naive-ui')['NSelect']
+    NTable: typeof import('naive-ui')['NTable']
     NumeronymGenerator: typeof import('./src/tools/numeronym-generator/numeronym-generator.vue')['default']
     OtpCodeGeneratorAndValidator: typeof import('./src/tools/otp-code-generator-and-validator/otp-code-generator-and-validator.vue')['default']
     PasswordStrengthAnalyser: typeof import('./src/tools/password-strength-analyser/password-strength-analyser.vue')['default']

package.json

@@ -55,6 +55,8 @@
     "cron-validator": "^1.3.1",
     "cronstrue": "^2.26.0",
     "crypto-js": "^4.1.1",
+    "currency-codes-ts": "^3.0.0",
+    "currency-exchanger-js": "^1.0.4",
     "date-fns": "^2.29.3",
     "dompurify": "^3.0.6",
     "email-normalizer": "^1.0.0",

pnpm-lock.yaml

@@ -1,7 +1,8 @@
 import { useRouteQuery } from '@vueuse/router';
 import { computed } from 'vue';
+import { useStorage } from '@vueuse/core';
 
-export { useQueryParam };
+export { useQueryParam, useQueryParamOrStorage };
 
 const transformers = {
   number: {
@@ -16,6 +17,12 @@ const transformers = {
     fromQuery: (value: string) => value.toLowerCase() === 'true',
     toQuery: (value: boolean) => (value ? 'true' : 'false'),
   },
+  object: {
+    fromQuery: (value: string) => {
+      return JSON.parse(value);
+    },
+    toQuery: (value: object) => JSON.stringify(value),
+  },
 };
 
 function useQueryParam<T>({ name, defaultValue }: { name: string; defaultValue: T }) {
@@ -33,3 +40,27 @@ function useQueryParam<T>({ name, defaultValue }: { name: string; defaultValue:
     },
   });
 }
+
+function useQueryParamOrStorage<T>({ name, storageName, defaultValue }: { name: string; storageName: string; defaultValue: T }) {
+  const type = typeof defaultValue;
+  const transformer = transformers[type as keyof typeof transformers] ?? transformers.string;
+
+  const storageRef = useStorage(storageName, defaultValue);
+  const proxyDefaultValue = transformer.toQuery(defaultValue as never);
+  const proxy = useRouteQuery(name, proxyDefaultValue);
+
+  const r = ref(defaultValue);
+
+  watch(r,
+    (value) => {
+      proxy.value = transformer.toQuery(value as never);
+      storageRef.value = value as never;
+    },
+    { deep: true });
+
+  r.value = (proxy.value && proxy.value !== proxyDefaultValue
+    ? transformer.fromQuery(proxy.value) as unknown as T
+    : storageRef.value as T) as never;
+
+  return r;
+}

src/composable/queryParams.ts

@@ -0,0 +1,119 @@
+<script setup lang="ts">
+import { code, countries, country } from 'currency-codes-ts';
+import converter from 'currency-exchanger-js';
+import moneysData from './moneys.json';
+import { useQueryParamOrStorage } from '@/composable/queryParams';
+
+const allCurrencies = Object.entries(moneysData).map(([k, v]) => ({ value: k, label: v || k }));
+const otherCurrencies = useQueryParamOrStorage<{ name: string }[]>({ name: 'to', storageName: 'currency-conv:others', defaultValue: [{ name: 'usd' }] });
+const currentCurrency = useQueryParamOrStorage<string>({ name: 'from', storageName: 'currency-conv:cur', defaultValue: 'eur' });
+const amount = ref(1);
+const currentDatetime = ref(Date.now());
+
+const convertedCurrencies = computedAsync<Record<string, number>>(async () => {
+  const currentCurrencyValue = currentCurrency.value;
+  const currentDatetimeValue = currentDatetime.value;
+  const amountValue = amount.value;
+  const otherCurrenciesValues = otherCurrencies.value;
+
+  let result = {};
+  for (const targetCurrency of otherCurrenciesValues) {
+    const value = await converter.convertOnDate(amountValue, currentCurrencyValue, targetCurrency.name, new Date(currentDatetimeValue));
+    result = { ...result, [targetCurrency.name]: value };
+  }
+  return result;
+});
+
+const countryToCurrenciesInput = ref('France');
+const allCountries = countries();
+const countryToCurrenciesOutput = computed(() => country(countryToCurrenciesInput.value));
+
+const currencyToCountriesInput = ref('eur');
+const currencyToCountriesOutput = computed(() => code(currencyToCountriesInput.value));
+</script>
+
+<template>
+  <div>
+    <c-card title="Currency Converter" mb-2>
+      <c-select
+        v-model:value="currentCurrency"
+        label="From"
+        label-position="left"
+        searchable
+        :options="allCurrencies"
+        mb-2
+      />
+      <n-form-item label="Amount:" label-placement="left" mb-2>
+        <n-input-number v-model:value="amount" :min="0" />
+      </n-form-item>
+
+      <n-form-item label="For Date:" label-placement="left" mb-2>
+        <n-date-picker
+          v-model:value="currentDatetime"
+          type="date"
+        />
+      </n-form-item>
+
+      <c-card title="Converted currencies">
+        <n-dynamic-input
+          v-model:value="otherCurrencies"
+          show-sort-button
+          :on-create="() => ({ name: 'eur' })"
+        >
+          <template #default="{ value }">
+            <div flex flex-wrap items-center gap-1>
+              <n-select
+                v-model:value="value.name"
+                filterable
+                placeholder="Please select a currency"
+                :options="allCurrencies"
+                w-full
+              />
+              <input-copyable readonly :value="convertedCurrencies ? convertedCurrencies[value.name] : 0" />
+            </div>
+          </template>
+        </n-dynamic-input>
+      </c-card>
+    </c-card>
+
+    <c-card title="Country to Currencies" mb-2>
+      <c-select
+        v-model:value="countryToCurrenciesInput"
+        label="Country"
+        label-position="left"
+        searchable
+        :options="allCountries"
+      />
+
+      <n-divider />
+
+      <ul>
+        <li v-for="(currency, ix) in countryToCurrenciesOutput" :key="ix">
+          {{ currency.currency }} [{{ currency.code }}/{{ currency.number }} - {{ currency.digits }}digits] (also in: {{ currency.countries?.join(', ') }})
+        </li>
+      </ul>
+    </c-card>
+
+    <c-card title="Currencies to Countries" mb-2>
+      <c-select
+        v-model:value="currencyToCountriesInput"
+        label="Currency"
+        label-position="left"
+        searchable
+        :options="allCurrencies"
+      />
+
+      <n-divider />
+
+      <n-p v-if="currencyToCountriesOutput">
+        {{ currencyToCountriesOutput.currency }} [{{ currencyToCountriesOutput.code }}/{{ currencyToCountriesOutput.number }} - {{ currencyToCountriesOutput.digits }}digits]
+      </n-p>
+
+      <ul v-if="currencyToCountriesOutput">
+        <li v-for="(countryName, ix) in currencyToCountriesOutput.countries" :key="ix">
+          {{ countryName }}
+        </li>
+      </ul>
+    </c-card>
+  </div>
+</template>

src/tools/currency-converter/currency-converter.vue

@@ -0,0 +1,4 @@
+declare module 'currency-exchanger-js'{
+    export function convertOnDate(value: number,fromCurrency: string,toCurrency: string,inputDate: Date): number;
+    export function convert(value: number,fromCurrency: string,toCurrency: string): number;
+}

src/tools/currency-converter/currency-exchanger-js.d.ts

@@ -0,0 +1,12 @@
+import { Currency } from '@vicons/tabler';
+import { defineTool } from '../tool';
+
+export const tool = defineTool({
+  name: 'Currency Converter',
+  path: '/currency-converter',
+  description: 'Convert currency values using ExchangeRate-API',
+  keywords: ['currency', 'converter'],
+  component: () => import('./currency-converter.vue'),
+  icon: Currency,
+  createdAt: new Date('2024-08-15'),
+});