Collection of handy online tools for developers, with great UX.
TypeScript converterdeveloper-productivitydeveloper-toolsfrontendjavascriptproductivitytooltoolstypescriptvuejswebsite
feat(new tool): ULID generator (#623)
Corentin THOMASSET5c4d775e2d0f
diff --git a/components.d.ts b/components.d.tsindex f51e12cd..1a5ce1a9 100644--- a/components.d.ts+++ b/components.d.ts@@ -25,6 +25,8 @@ declare module '@vue/runtime-core' {CaseConverter: typeof import('./src/tools/case-converter/case-converter.vue')['default']CButton: typeof import('./src/ui/c-button/c-button.vue')['default']'CButton.demo': typeof import('./src/ui/c-button/c-button.demo.vue')['default']+ CButtonsSelect: typeof import('./src/ui/c-buttons-select/c-buttons-select.vue')['default']+ 'CButtonsSelect.demo': typeof import('./src/ui/c-buttons-select/c-buttons-select.demo.vue')['default']CCard: typeof import('./src/ui/c-card/c-card.vue')['default']'CCard.demo': typeof import('./src/ui/c-card/c-card.demo.vue')['default']CDiffEditor: typeof import('./src/ui/c-diff-editor/c-diff-editor.vue')['default']@@ -183,6 +185,7 @@ declare module '@vue/runtime-core' {TomlToYaml: typeof import('./src/tools/toml-to-yaml/toml-to-yaml.vue')['default']'Tool.layout': typeof import('./src/layouts/tool.layout.vue')['default']ToolCard: typeof import('./src/components/ToolCard.vue')['default']+ UlidGenerator: typeof import('./src/tools/ulid-generator/ulid-generator.vue')['default']UrlEncoder: typeof import('./src/tools/url-encoder/url-encoder.vue')['default']UrlParser: typeof import('./src/tools/url-parser/url-parser.vue')['default']UserAgentParser: typeof import('./src/tools/user-agent-parser/user-agent-parser.vue')['default']diff --git a/package.json b/package.jsonindex de225511..d3ec93bf 100644--- a/package.json+++ b/package.json@@ -77,6 +77,7 @@"randombytes": "^2.1.0","sql-formatter": "^13.0.0","ua-parser-js": "^1.0.35",+ "ulid": "^2.3.0","unicode-emoji-json": "^0.4.0","unplugin-auto-import": "^0.16.4","uuid": "^9.0.0",diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 9eae9b35..65579a34 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -134,6 +134,9 @@ dependencies:ua-parser-js:specifier: ^1.0.35version: 1.0.35+ ulid:+ specifier: ^2.3.0+ version: 2.3.0unicode-emoji-json:specifier: ^0.4.0version: 0.4.0@@ -8246,6 +8249,11 @@ packages:resolution: {integrity: sha512-TrY6DsjTQQgyS3E3dBaOXf0TpPD8u9FVrVYmKVegJuFw51n/YB9XPt+U6ydzFG5ZIN7+DIjPbNmXoBj9esYhgQ==}+ resolution: {integrity: sha512-keqHubrlpvT6G2wH0OEfSW4mquYRcbe/J8NMmveoQOjUqmo+hXtO+ORCpWhdbZ7k72UtY61BL7haGxW6enBnjw==}+ hasBin: true+ dev: false+resolution: {integrity: sha512-61pPlCD9h51VoreyJ0BReideM3MDKMKnh6+V9L08331ipq6Q8OFXZYiqP6n/tbHx4s5I9uRhcye6BrbkizkBDw==}dependencies:diff --git a/src/tools/index.ts b/src/tools/index.tsindex aa380745..cc5f42ee 100644--- a/src/tools/index.ts+++ b/src/tools/index.ts@@ -1,6 +1,7 @@import { tool as base64FileConverter } from './base64-file-converter';import { tool as base64StringConverter } from './base64-string-converter';import { tool as basicAuthGenerator } from './basic-auth-generator';+import { tool as ulidGenerator } from './ulid-generator';import { tool as ibanValidatorAndParser } from './iban-validator-and-parser';import { tool as stringObfuscator } from './string-obfuscator';import { tool as textDiff } from './text-diff';@@ -74,7 +75,7 @@ import { tool as xmlFormatter } from './xml-formatter';export const toolsByCategory: ToolCategory[] = [{name: 'Crypto',- components: [tokenGenerator, hashText, bcrypt, uuidGenerator, cypher, bip39, hmacGenerator, rsaKeyPairGenerator, passwordStrengthAnalyser],+ components: [tokenGenerator, hashText, bcrypt, uuidGenerator, ulidGenerator, cypher, bip39, hmacGenerator, rsaKeyPairGenerator, passwordStrengthAnalyser],},{name: 'Converter',diff --git a/src/tools/ulid-generator/index.ts b/src/tools/ulid-generator/index.tsnew file mode 100644index 00000000..6a5408dd--- /dev/null+++ b/src/tools/ulid-generator/index.ts@@ -0,0 +1,12 @@+import { SortDescendingNumbers } from '@vicons/tabler';+import { defineTool } from '../tool';++export const tool = defineTool({+ name: 'ULID generator',+ path: '/ulid-generator',+ description: 'Generate random Universally Unique Lexicographically Sortable Identifier (ULID).',+ keywords: ['ulid', 'generator', 'random', 'id', 'alphanumeric', 'identity', 'token', 'string', 'identifier', 'unique'],+ component: () => import('./ulid-generator.vue'),+ icon: SortDescendingNumbers,+ createdAt: new Date('2023-09-11'),+});diff --git a/src/tools/ulid-generator/ulid-generator.e2e.spec.ts b/src/tools/ulid-generator/ulid-generator.e2e.spec.tsnew file mode 100644index 00000000..34473376--- /dev/null+++ b/src/tools/ulid-generator/ulid-generator.e2e.spec.ts@@ -0,0 +1,23 @@+import { expect, test } from '@playwright/test';++const ULID_REGEX = /[0-9A-Z]{26}/;++test.describe('Tool - ULID generator', () => {+ test.beforeEach(async ({ page }) => {+ await page.goto('/ulid-generator');+ });++ test('Has correct title', async ({ page }) => {+ await expect(page).toHaveTitle('ULID generator - IT Tools');+ });++ test('the refresh button generates a new ulid', async ({ page }) => {+ const ulid = await page.getByTestId('ulids').textContent();+ expect(ulid?.trim()).toMatch(ULID_REGEX);++ await page.getByTestId('refresh').click();+ const newUlid = await page.getByTestId('ulids').textContent();+ expect(ulid?.trim()).not.toBe(newUlid?.trim());+ expect(newUlid?.trim()).toMatch(ULID_REGEX);+ });+});diff --git a/src/tools/ulid-generator/ulid-generator.vue b/src/tools/ulid-generator/ulid-generator.vuenew file mode 100644index 00000000..06e695ef--- /dev/null+++ b/src/tools/ulid-generator/ulid-generator.vue@@ -0,0 +1,46 @@+<script setup lang="ts">+import { ulid } from 'ulid';+import _ from 'lodash';+import { computedRefreshable } from '@/composable/computedRefreshable';+import { useCopy } from '@/composable/copy';++const amount = useStorage('ulid-generator-amount', 1);+const formats = [{ label: 'Raw', value: 'raw' }, { label: 'JSON', value: 'json' }] as const;+const format = useStorage<typeof formats[number]['value']>('ulid-generator-format', formats[0].value);++const [ulids, refreshUlids] = computedRefreshable(() => {+ const ids = _.times(amount.value, () => ulid());++ if (format.value === 'json') {+ return JSON.stringify(ids, null, 2);+ }++ return ids.join('\n');+});++const { copy } = useCopy({ source: ulids, text: 'ULIDs copied to the clipboard' });+</script>++<template>+ <div flex flex-col justify-center gap-2>+ <div flex items-center>+ <label w-75px> Quantity:</label>+ <n-input-number v-model:value="amount" min="1" max="100" flex-1 />+ </div>++ <c-buttons-select v-model:value="format" :options="formats" label="Format: " label-width="75px" />++ <c-card mt-5 flex data-test-id="ulids">+ <pre m-0 m-x-auto>{{ ulids }}</pre>+ </c-card>++ <div flex justify-center gap-2>+ <c-button data-test-id="refresh" @click="refreshUlids()">+ Refresh+ </c-button>+ <c-button @click="copy()">+ Copy+ </c-button>+ </div>+ </div>+</template>diff --git a/src/ui/c-buttons-select/c-buttons-select.demo.vue b/src/ui/c-buttons-select/c-buttons-select.demo.vuenew file mode 100644index 00000000..dea15289--- /dev/null+++ b/src/ui/c-buttons-select/c-buttons-select.demo.vue@@ -0,0 +1,14 @@+<script setup lang="ts">+const optionsA = [+ { label: 'Option A', value: 'a' },+ { label: 'Option B', value: 'b', tooltip: 'This is a tooltip' },+ { label: 'Option C', value: 'c' },+];+const valueA = ref('a');+</script>++<template>+ <c-buttons-select v-model:value="valueA" :options="optionsA" label="Label: " />+ <c-buttons-select v-model:value="valueA" :options="optionsA" label="Label: " label-position="left" mt-2 />+ <c-buttons-select v-model:value="valueA" :options="optionsA" label="Label: " label-position="left" mt-2 />+</template>diff --git a/src/ui/c-buttons-select/c-buttons-select.types.ts b/src/ui/c-buttons-select/c-buttons-select.types.tsnew file mode 100644index 00000000..ccb110d4--- /dev/null+++ b/src/ui/c-buttons-select/c-buttons-select.types.ts@@ -0,0 +1,5 @@+import type { CSelectOption } from '../c-select/c-select.types';++export type CButtonSelectOption<T> = CSelectOption<T> & {+ tooltip?: string+};diff --git a/src/ui/c-buttons-select/c-buttons-select.vue b/src/ui/c-buttons-select/c-buttons-select.vuenew file mode 100644index 00000000..38fff66f--- /dev/null+++ b/src/ui/c-buttons-select/c-buttons-select.vue@@ -0,0 +1,59 @@+<script setup lang="ts" generic="T extends unknown">+import type { CLabelProps } from '../c-label/c-label.types';+import type { CButtonSelectOption } from './c-buttons-select.types';++const props = withDefaults(+ defineProps<{+ options?: CButtonSelectOption<T>[] | string[]+ value?: T+ size?: 'small' | 'medium' | 'large'+ } & CLabelProps >(),+ {+ options: () => [],+ value: undefined,+ labelPosition: 'left',+ size: 'medium',+ },+);++const emits = defineEmits(['update:value']);++const { options: rawOptions, size } = toRefs(props);++const options = computed(() => {+ return rawOptions.value.map((option: string | CButtonSelectOption<T>) => {+ if (typeof option === 'string') {+ return { label: option, value: option };+ }++ return option;+ });+});++const value = useVModel(props, 'value', emits);++function selectOption(option: CButtonSelectOption<T>) {+ // @ts-expect-error vue template generic is a bit flacky thanks to withDefaults+ value.value = option.value;+}+</script>++<template>+ <c-label v-bind="props">+ <div class="flex gap-2">+ <c-tooltip+ v-for="option in options" :key="option.value"+ :tooltip="option.tooltip"+ >+ <c-button+ :test-id="option.value"+ :size="size"+ :type="option.value === value ? 'primary' : 'default'"+ @click="selectOption(option)"+ >+ {{ option.label }}+ </c-button>+ </c-tooltip>+ </div>+ </c-label>+</template>diff --git a/src/ui/c-tooltip/c-tooltip.vue b/src/ui/c-tooltip/c-tooltip.vueindex 24c586b8..095315fb 100644--- a/src/ui/c-tooltip/c-tooltip.vue+++ b/src/ui/c-tooltip/c-tooltip.vue@@ -13,6 +13,7 @@ const isTargetHovered = useElementHover(targetRef);</div><div+ v-if="tooltip || $slots.tooltip"class="absolute bottom-100% left-50% z-10 mb-5px whitespace-nowrap rounded bg-black px-12px py-6px text-sm text-white shadow-lg transition transition transition-duration-0.2s -translate-x-1/2":class="{'op-0 scale-0': isTargetHovered === false,