feat(new tool): Cron Expression Generator

This commit is contained in:
ShareVB committed 2026-07-11 21:55:43 +02:00
1 parent 37cc92faf9
commit b016d34c2d
2 files changed
+276

No files matched your search

@@ -0,0 +1,264 @@
<script setup lang="ts">
function range(start: number, end: number) {
return Array.from({ length: end - start + 1 }, (_, i) => ({
label: String(start + i),
value: start + i,
}));
}
interface Field {
mode: 'every' | 'specific' | 'range' | 'increment';
values: number[];
start: number;
end: number;
step: number;
min: number;
max: number;
}
// CRON FIELDS
function createField(start: number, end: number) {
return ref({
mode: 'every',
values: [],
start,
end,
min: start,
max: end,
step: 1,
} as Field);
}
const seconds = createField(0, 59);
const minutes = createField(0, 59);
const hours = createField(0, 23);
const dayOfMonth = createField(1, 31);
const month = createField(1, 12);
const dayOfWeek = createField(0, 6);
const year = createField(1970, 2099);
const fields: {
field: Ref<Field>;
label: string;
description: string;
options?: { label: string; value: number }[];
}[] = [
{ field: seconds, label: 'Seconds', description: '0-59' },
{ field: minutes, label: 'Minutes', description: '0-59' },
{ field: hours, label: 'Hours', description: '0-23' },
{ field: dayOfMonth, label: 'Day of Month', description: '1-31' },
{
field: month,
label: 'Month',
description: '1-12',
options: [
{ label: 'January', value: 1 },
{ label: 'February', value: 2 },
{ label: 'March', value: 3 },
{ label: 'April', value: 4 },
{ label: 'May', value: 5 },
{ label: 'June', value: 6 },
{ label: 'July', value: 7 },
{ label: 'August', value: 8 },
{ label: 'September', value: 9 },
{ label: 'October', value: 10 },
{ label: 'November', value: 11 },
{ label: 'December', value: 12 },
],
},
{
field: dayOfWeek,
label: 'Day of Week',
options: [
{ label: 'Sunday', value: 0 },
{ label: 'Monday', value: 1 },
{ label: 'Tuesday', value: 2 },
{ label: 'Wednesday', value: 3 },
{ label: 'Thursday', value: 4 },
{ label: 'Friday', value: 5 },
{ label: 'Saturday', value: 6 },
],
description: '0-6 (Sunday=0, Monday=1, ..., Saturday=6)',
},
{ field: year, label: 'Year', description: '1970-...' },
] as const;
const modes = [
{ label: 'Every (*)', value: 'every' },
{ label: 'Specific values', value: 'specific' },
{ label: 'Range', value: 'range' },
{ label: 'Increment', value: 'increment' },
];
function validateField(label: string, field: Field) {
const errs: string[] = [];
if (field.mode === 'specific') {
if (!field.values.length) {
errs.push(`${label}: select at least one value`);
}
}
if (field.mode === 'range') {
if (field.start > field.end) {
errs.push(`${label}: start cannot be greater than end`);
}
if (field.start < field.min || field.end > field.max) {
errs.push(`${label}: start must be within allowed range`);
}
}
if (field.mode === 'increment') {
if (field.step < 1) {
errs.push(`${label}: step must be >= 1`);
}
if (field.start > field.end) {
errs.push(`${label}: start cannot be greater than end`);
}
if (field.start < field.min || field.end > field.max) {
errs.push(`${label}: start must be within allowed range`);
}
}
return errs;
}
const errors = computed(() => {
const list: string[] = [];
list.push(...validateField('Seconds', seconds.value));
list.push(...validateField('Minutes', minutes.value));
list.push(...validateField('Hours', hours.value));
list.push(...validateField('Day of Month', dayOfMonth.value));
list.push(...validateField('Month', month.value));
list.push(...validateField('Day of Week', dayOfWeek.value));
list.push(...validateField('Year', year.value));
// Global rule: DOM and DOW both specific → ambiguous
if (dayOfMonth.value.mode === 'specific' && dayOfWeek.value.mode === 'specific') {
list.push('Day of Month and Day of Week cannot both be specific');
}
return list;
});
const isValid = computed(() => errors.value.length === 0);
function buildField(field: any) {
switch (field.mode) {
case 'every':
return '*';
case 'specific':
return field.values.join(',');
case 'range':
return `${field.start}-${field.end}`;
case 'increment':
return `${field.start}/${field.step}`;
default:
return '*';
}
}
const cron = computed(() => {
return [
buildField(seconds.value),
buildField(minutes.value),
buildField(hours.value),
buildField(dayOfMonth.value),
buildField(month.value),
buildField(dayOfWeek.value),
buildField(year.value),
].join(' ');
});
defineExpose({ cron, isValid, errors });
</script>
<template>
<div>
<NCard title="Generated Cron Expression" size="small" mb-2>
<input-copyable :value="cron" />
<div v-if="!isValid" mt-2>
<NText type="error"> Cron expression is invalid </NText>
</div>
</NCard>
<NAlert v-if="errors.length" type="error" title="Validation Errors" closable mb-2>
<ul>
<li v-for="err in errors" :key="err">
{{ err }}
</li>
</ul>
</NAlert>
<n-tabs type="segment" animated>
<n-tab-pane :name="label" :tab="label" v-for="{ field, label, description, options } in fields" :key="label">
<NFormItem label="Mode:" label-placement="left">
<NSelect v-model:value="field.value.mode" :options="modes" style="width: 200px" mr-2 />
<NText v-if="description" type="secondary" size="small" italic>
{{ description }}
</NText>
</NFormItem>
<!-- Specific values -->
<div v-if="field.value.mode === 'specific'">
<NCheckboxGroup v-if="options" v-model:value="field.value.values">
<NSpace wrap>
<NCheckbox v-for="opt in options" :key="opt.value" :value="opt.value">
{{ opt.label }}
</NCheckbox>
</NSpace>
</NCheckboxGroup>
<NCheckboxGroup v-else v-model:value="field.value.values">
<NSpace wrap>
<NCheckbox
v-for="opt in range(field.value.start, field.value.end)"
:key="opt.value"
:value="opt.value"
style="width: 50px"
>
{{ opt.label }}
</NCheckbox>
</NSpace>
</NCheckboxGroup>
</div>
<!-- Range -->
<div v-if="field.value.mode === 'range'">
<NSpace v-if="options">
<NFormItem label="From:" label-placement="left">
<NSelect v-model:value="field.value.start" :options="options" />
</NFormItem>
<NFormItem label="To:" label-placement="left">
<NSelect v-model:value="field.value.end" :options="options" />
</NFormItem>
</NSpace>
<NSpace v-else>
<NFormItem label="From:" label-placement="left">
<NInputNumber v-model:value="field.value.start" :min="field.value.min" :max="field.value.max" />
</NFormItem>
<NFormItem label="To:" label-placement="left">
<NInputNumber v-model:value="field.value.end" :min="field.value.min" :max="field.value.max" />
</NFormItem>
</NSpace>
</div>
<!-- Increment -->
<div v-if="field.value.mode === 'increment'">
<NSpace>
<NFormItem label="Start at:" label-placement="left" v-if="options">
<NSelect v-model:value="field.value.start" :options="options" />
</NFormItem>
<NFormItem label="Start at:" label-placement="left" v-else>
<NInputNumber v-model:value="field.value.start" :min="field.value.min" :max="field.value.max" />
</NFormItem>
<NFormItem label="every" label-placement="left">
<NInputNumber v-model:value="field.value.step" :min="1" :max="field.value.end" mr-1 />
<NText>{{ label.toLowerCase() }}</NText>
</NFormItem>
</NSpace>
</div>
</n-tab-pane>
</n-tabs>
</div>
</template>
@@ -0,0 +1,12 @@
import { defineTool } from '../tool';
export const tool = defineTool({
name: 'Cron Expression Builder',
path: '/cron-expression-builder',
description: 'Generate Cron expressions from a UI',
keywords: ['cron', 'expression', 'builder'],
component: () => import('./cron-expression-builder.vue'),
icon: defineAsyncComponent(() => import('@vicons/tabler/es/Clock')),
createdAt: new Date('2026-07-11'),
category: 'Default',
});