# Pull Request Template ## Description This PR introduces a custom, lightweight natural-language date parser (dependency-free except for date-fns) to power snooze actions via the command bar (e.g., “Remind me tomorrow at 6am”). It also adds support for multi-language searches. <details> <summary>Supported Formats</summary> ## Snooze Date Parser — Supported Input Formats ## 1. Durations Specify an amount of time from now. ### Basic - `5 minutes` · `2 hours` · `3 days` · `1 week` · `6 months` · `ten year` - `in 2 hours` · `in 30 minutes` · `in a week` · `in a month` - `5 minutes from now` · `a week from now` · `two weeks from now` ### Half / fractional - `half hour` · `half day` · `half week` · `half month` - `in half a day` · `in half an hour` · `in half a week` - `one and a half hours` · `in one and a half hours` - `1.5 hours` · `2.5 days` ### Compound - `1 hour and 30 minutes` · `2 hours and 15 minutes` - `2 days at 3pm` · `1 week at 9am` ### Shorthand (no spaces) - `2h` · `30m` · `1h30m` · `2h15m` - `1h30minutes` · `2hr15min` · `1hour30min` ### Informal quantities - `couple hours` · `a couple of days` · `in a couple hours` - `a few minutes` · `in a few hours` · `in a few days` - `fortnight` · `in a fortnight` _(= 2 weeks)_ ### Trailing "later" - `2 days later` · `a week later` · `month later` ### Prefix words (`after` / `within`) - `after 2 hours` · `after 3 days` · `after ten year` - `within a week` · `within 2 hours` ### Recognised word-numbers `a` (1) · `an` (1) · `one` – `twenty` · `thirty` · `forty` · `fifty` · `sixty` · `ninety` · `half` (0.5) · `couple` (2) · `few` (3) --- ## 2. Relative Days - `today` · `tonight` · `tomorrow` - `tomorrow morning` · `tomorrow afternoon` · `tomorrow evening` · `tomorrow night` - `tomorrow at 3pm` · `tomorrow 9` · `tonight at 8` · `tonight at 10pm` - `tomorrow same time` · `same time tomorrow` - `day after tomorrow` · `the day after tomorrow` · `day after tomorrow at 2pm` - `later today` · `later this afternoon` · `later this evening` --- ## 3. Weekdays - `monday` · `friday` · `wed` · `thu` - `friday at 3pm` · `monday 9am` · `wednesday 14:30` - `monday morning` · `friday afternoon` · `wednesday evening` - `monday morning 6` · `friday evening 7` - `this friday` · `upcoming monday` · `coming friday` - `same time friday` · `same time wednesday` --- ## 4. "Next" Patterns - `next hour` · `next week` · `next month` · `next year` - `next week at 2pm` · `next month at 9am` - `next monday` · `next friday` · `next friday at 3pm` - `next monday morning` · `next friday evening` - `monday of next week` · `next week monday` - `next january` · `next december` - `next business day` · `next working day` --- ## 5. Time of Day - `morning` · `afternoon` · `evening` · `night` · `noon` · `midnight` - `this morning` · `this afternoon` · `this evening` - `early morning` · `late evening` · `late night` - `morning at 8am` · `evening 6pm` · `afternoon 2pm` - `eod` · `end of day` · `end of the day` --- ## 6. Standalone Time - **12-hour:** `3pm` · `9am` · `at 3pm` · `at 9:30am` - **24-hour:** `14:30` · `at 14:30` --- ## 7. Named Dates (Month + Day) - `jan 15` · `january 15` · `march 20` · `dec 25` - `jan 1st` · `march 3rd` · `april 2nd` · `december 31st` - `15 march` · `25 dec` _(reversed order)_ - `jan 15 2025` · `dec 25 2025` · `march 20 next year` - `jan 15 at 2pm` · `march 5 at 2pm` - `december 2025` · `january 2024` _(month + year only)_ --- ## 8. Month + Ordinal Patterns Target a specific week or day within a month. ### Week of month - `april first week` · `july 2nd week` · `feb 3rd week` - `first week of april` · `2nd week of july` ### Day of month - `april first day` · `march second day` · `march 5th day` - `third day of march` · `5th day of jan at 2pm` ### Supported ordinals - **Digit:** `1st` `2nd` `3rd` `4th` `5th` … (up to 31 for days, 5 for weeks) - **Word:** `first` `second` `third` `fourth` `fifth` `sixth` `seventh` `eighth` `ninth` `tenth` --- ## 9. Formal / Numeric Dates - **ISO:** `2025-01-15` - **Slash (M/D/Y):** `01/15/2025` - **Dash (D-M-Y):** `15-01-2025` - **Dot (D.M.Y):** `15.01.2025` - Any of the above **+ time:** `2025-01-15 at 3pm` --- ## 10. Special Phrases - `this weekend` · `weekend` · `next weekend` - `end of week` · `end of month` - `end of next week` · `end of next month` - `beginning of next week` · `start of next week` - `beginning of next month` --- ## 11. Noise / Filler Stripping The parser silently removes conversational prefixes so all of these work exactly the same as the bare expression: ``` snooze for 2 hours → 2 hours remind me tomorrow → tomorrow please snooze until friday → friday can you set a reminder for next week → next week schedule this for jan 15 → jan 15 postpone to next monday → next monday defer for 2 days → 2 days delay it by 1 hour → 1 hour ``` ### Recognised filler verbs / prefixes `snooze` · `remind` · `remind me` · `set a reminder` · `add a reminder` · `schedule` · `postpone` · `defer` · `delay` · `push` ### Recognised prepositions (stripped) `on` · `to` · `for` · `at` · `until` · `till` · `by` · `from` · `after` · `within` ### Typo corrections `tommorow` / `tommorrow` → `tomorrow` · `nxt` → `next` --- ## 12. Multi-Language Support The parser supports localised input via translations in `snooze.json`. ### Translatable token categories - **Units:** minute, hour, day, week, month, year _(singular + plural)_ - **Relative days:** tomorrow, day after tomorrow, next week / month, this / next weekend - **Time of day:** morning, afternoon, evening, night, noon, midnight - **Word numbers:** one through ten, twelve, fifteen, twenty, thirty - **Ordinals:** first through fifth - **Structural words:** at, in, of, after, week, day, from now, next year - **Meridiem:** am, pm ### Auto-detected from locale Weekday names and month names are resolved automatically via `Intl.DateTimeFormat` for the user's locale — no manual translation needed. </details> ## Type of change - [x] New feature (non-breaking change which adds functionality) ## How Has This Been Tested? **Screenshots** <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/c690d328-a0df-41d2-b531-2b4e6ce6b5fd" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/fa881acc-4fed-4ba3-9166-58bd953bcb26" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/4d9a224b-641c-409c-a7ce-3dec2b5355e2" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/465b9835-d82c-4bc7-a2ae-94976ada2d3b" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/839fe8fc-8943-4b66-83ca-5c61c95f24d8" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/3a9a54f2-7669-40f2-b098-a3f5c183526d" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/7791ab2b-c763-49a9-90a0-e91b0d8f0a26" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/4689390c-0e7f-48ae-acc7-d8e28695452f" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/d0aa5217-d0e1-4f41-b663-72888d028a3a" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/4fa9ff5b-a874-43d5-812f-6abe1a95a5ac" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/2c8199a6-f872-46af-986f-bdf8597248f5" /> <img width="974" height="530" alt="image" src="https://github.com/user-attachments/assets/5bd9effc-7518-4f96-b2f2-7c547f32f500" /> ## Checklist: - [x] My code follows the style guidelines of this project - [x] I have performed a self-review of my code - [x] I have commented on my code, particularly in hard-to-understand areas - [ ] I have made corresponding changes to the documentation - [x] My changes generate no new warnings - [x] I have added tests that prove my fix is effective or that my feature works - [x] New and existing unit tests pass locally with my changes - [ ] Any dependent changes have been merged and published in downstream modules
325 lines
8.2 KiB
Vue
325 lines
8.2 KiB
Vue
<script>
|
|
import { getUnixTime } from 'date-fns';
|
|
import { findSnoozeTime } from 'dashboard/helper/snoozeHelpers';
|
|
import { emitter } from 'shared/helpers/mitt';
|
|
import wootConstants from 'dashboard/constants/globals';
|
|
import {
|
|
CMD_BULK_ACTION_SNOOZE_CONVERSATION,
|
|
CMD_BULK_ACTION_REOPEN_CONVERSATION,
|
|
CMD_BULK_ACTION_RESOLVE_CONVERSATION,
|
|
} from 'dashboard/helper/commandbar/events';
|
|
|
|
import NextButton from 'dashboard/components-next/button/Button.vue';
|
|
import AgentSelector from './AgentSelector.vue';
|
|
import UpdateActions from './UpdateActions.vue';
|
|
import LabelActions from './LabelActions.vue';
|
|
import TeamActions from './TeamActions.vue';
|
|
import CustomSnoozeModal from 'dashboard/components/CustomSnoozeModal.vue';
|
|
export default {
|
|
components: {
|
|
AgentSelector,
|
|
UpdateActions,
|
|
LabelActions,
|
|
TeamActions,
|
|
CustomSnoozeModal,
|
|
NextButton,
|
|
},
|
|
props: {
|
|
conversations: {
|
|
type: Array,
|
|
default: () => [],
|
|
},
|
|
allConversationsSelected: {
|
|
type: Boolean,
|
|
default: false,
|
|
},
|
|
selectedInboxes: {
|
|
type: Array,
|
|
default: () => [],
|
|
},
|
|
showOpenAction: {
|
|
type: Boolean,
|
|
default: false,
|
|
},
|
|
showResolvedAction: {
|
|
type: Boolean,
|
|
default: false,
|
|
},
|
|
showSnoozedAction: {
|
|
type: Boolean,
|
|
default: false,
|
|
},
|
|
},
|
|
emits: [
|
|
'selectAllConversations',
|
|
'assignAgent',
|
|
'updateConversations',
|
|
'assignLabels',
|
|
'assignTeam',
|
|
'resolveConversations',
|
|
],
|
|
data() {
|
|
return {
|
|
showAgentsList: false,
|
|
showUpdateActions: false,
|
|
showLabelActions: false,
|
|
showTeamsList: false,
|
|
popoverPositions: {},
|
|
showCustomTimeSnoozeModal: false,
|
|
};
|
|
},
|
|
mounted() {
|
|
emitter.on(
|
|
CMD_BULK_ACTION_SNOOZE_CONVERSATION,
|
|
this.onCmdSnoozeConversation
|
|
);
|
|
emitter.on(
|
|
CMD_BULK_ACTION_REOPEN_CONVERSATION,
|
|
this.onCmdReopenConversation
|
|
);
|
|
emitter.on(
|
|
CMD_BULK_ACTION_RESOLVE_CONVERSATION,
|
|
this.onCmdResolveConversation
|
|
);
|
|
},
|
|
unmounted() {
|
|
emitter.off(
|
|
CMD_BULK_ACTION_SNOOZE_CONVERSATION,
|
|
this.onCmdSnoozeConversation
|
|
);
|
|
emitter.off(
|
|
CMD_BULK_ACTION_REOPEN_CONVERSATION,
|
|
this.onCmdReopenConversation
|
|
);
|
|
emitter.off(
|
|
CMD_BULK_ACTION_RESOLVE_CONVERSATION,
|
|
this.onCmdResolveConversation
|
|
);
|
|
},
|
|
methods: {
|
|
onCmdSnoozeConversation(snoozeType) {
|
|
if (snoozeType === wootConstants.SNOOZE_OPTIONS.UNTIL_CUSTOM_TIME) {
|
|
this.showCustomTimeSnoozeModal = true;
|
|
} else if (typeof snoozeType === 'number') {
|
|
this.updateConversations('snoozed', snoozeType);
|
|
} else {
|
|
this.updateConversations('snoozed', findSnoozeTime(snoozeType) || null);
|
|
}
|
|
},
|
|
onCmdReopenConversation() {
|
|
this.updateConversations('open', null);
|
|
},
|
|
onCmdResolveConversation() {
|
|
this.updateConversations('resolved', null);
|
|
},
|
|
customSnoozeTime(customSnoozedTime) {
|
|
this.showCustomTimeSnoozeModal = false;
|
|
if (customSnoozedTime) {
|
|
this.updateConversations('snoozed', getUnixTime(customSnoozedTime));
|
|
}
|
|
},
|
|
hideCustomSnoozeModal() {
|
|
this.showCustomTimeSnoozeModal = false;
|
|
},
|
|
selectAll(e) {
|
|
this.$emit('selectAllConversations', e.target.checked);
|
|
},
|
|
submit(agent) {
|
|
this.$emit('assignAgent', agent);
|
|
},
|
|
updateConversations(status, snoozedUntil) {
|
|
this.$emit('updateConversations', status, snoozedUntil);
|
|
},
|
|
assignLabels(labels) {
|
|
this.$emit('assignLabels', labels);
|
|
},
|
|
assignTeam(team) {
|
|
this.$emit('assignTeam', team);
|
|
},
|
|
resolveConversations() {
|
|
this.$emit('resolveConversations');
|
|
},
|
|
toggleUpdateActions() {
|
|
this.showUpdateActions = !this.showUpdateActions;
|
|
},
|
|
toggleLabelActions() {
|
|
this.showLabelActions = !this.showLabelActions;
|
|
},
|
|
toggleAgentList() {
|
|
this.showAgentsList = !this.showAgentsList;
|
|
},
|
|
toggleTeamsList() {
|
|
this.showTeamsList = !this.showTeamsList;
|
|
},
|
|
},
|
|
};
|
|
</script>
|
|
|
|
<template>
|
|
<div class="bulk-action__container">
|
|
<div class="flex items-center justify-between">
|
|
<label class="flex items-center justify-between bulk-action__panel">
|
|
<input
|
|
type="checkbox"
|
|
class="checkbox"
|
|
:checked="allConversationsSelected"
|
|
:indeterminate.prop="!allConversationsSelected"
|
|
@change="selectAll($event)"
|
|
/>
|
|
<span>
|
|
{{
|
|
$t('BULK_ACTION.CONVERSATIONS_SELECTED', {
|
|
conversationCount: conversations.length,
|
|
})
|
|
}}
|
|
</span>
|
|
</label>
|
|
<div class="flex items-center gap-1 bulk-action__actions">
|
|
<NextButton
|
|
v-tooltip="$t('BULK_ACTION.LABELS.ASSIGN_LABELS')"
|
|
icon="i-lucide-tags"
|
|
slate
|
|
xs
|
|
faded
|
|
@click="toggleLabelActions"
|
|
/>
|
|
<NextButton
|
|
v-tooltip="$t('BULK_ACTION.UPDATE.CHANGE_STATUS')"
|
|
icon="i-lucide-repeat"
|
|
slate
|
|
xs
|
|
faded
|
|
@click="toggleUpdateActions"
|
|
/>
|
|
<NextButton
|
|
v-tooltip="$t('BULK_ACTION.ASSIGN_AGENT_TOOLTIP')"
|
|
icon="i-lucide-user-round-plus"
|
|
slate
|
|
xs
|
|
faded
|
|
@click="toggleAgentList"
|
|
/>
|
|
<NextButton
|
|
v-tooltip="$t('BULK_ACTION.ASSIGN_TEAM_TOOLTIP')"
|
|
icon="i-lucide-users-round"
|
|
slate
|
|
xs
|
|
faded
|
|
@click="toggleTeamsList"
|
|
/>
|
|
</div>
|
|
<transition name="popover-animation">
|
|
<LabelActions
|
|
v-if="showLabelActions"
|
|
class="label-actions-box"
|
|
@assign="assignLabels"
|
|
@close="showLabelActions = false"
|
|
/>
|
|
</transition>
|
|
<transition name="popover-animation">
|
|
<UpdateActions
|
|
v-if="showUpdateActions"
|
|
class="update-actions-box"
|
|
:selected-inboxes="selectedInboxes"
|
|
:conversation-count="conversations.length"
|
|
:show-resolve="!showResolvedAction"
|
|
:show-reopen="!showOpenAction"
|
|
:show-snooze="!showSnoozedAction"
|
|
@update="updateConversations"
|
|
@close="showUpdateActions = false"
|
|
/>
|
|
</transition>
|
|
<transition name="popover-animation">
|
|
<AgentSelector
|
|
v-if="showAgentsList"
|
|
class="agent-actions-box"
|
|
:selected-inboxes="selectedInboxes"
|
|
:conversation-count="conversations.length"
|
|
@select="submit"
|
|
@close="showAgentsList = false"
|
|
/>
|
|
</transition>
|
|
<transition name="popover-animation">
|
|
<TeamActions
|
|
v-if="showTeamsList"
|
|
class="team-actions-box"
|
|
@assign-team="assignTeam"
|
|
@close="showTeamsList = false"
|
|
/>
|
|
</transition>
|
|
</div>
|
|
<div v-if="allConversationsSelected" class="bulk-action__alert">
|
|
{{ $t('BULK_ACTION.ALL_CONVERSATIONS_SELECTED_ALERT') }}
|
|
</div>
|
|
<woot-modal
|
|
v-model:show="showCustomTimeSnoozeModal"
|
|
:on-close="hideCustomSnoozeModal"
|
|
>
|
|
<CustomSnoozeModal
|
|
@close="hideCustomSnoozeModal"
|
|
@choose-time="customSnoozeTime"
|
|
/>
|
|
</woot-modal>
|
|
</div>
|
|
</template>
|
|
|
|
<style scoped lang="scss">
|
|
.bulk-action__container {
|
|
@apply p-3 relative border-b border-solid border-n-strong dark:border-n-weak;
|
|
}
|
|
|
|
.bulk-action__panel {
|
|
@apply cursor-pointer;
|
|
|
|
span {
|
|
@apply text-xs my-0 mx-1;
|
|
}
|
|
|
|
input[type='checkbox'] {
|
|
@apply cursor-pointer m-0;
|
|
}
|
|
}
|
|
|
|
.bulk-action__alert {
|
|
@apply bg-n-amber-3 text-n-amber-12 rounded text-xs mt-2 py-1 px-2 border border-solid border-n-amber-5;
|
|
}
|
|
|
|
.popover-animation-enter-active,
|
|
.popover-animation-leave-active {
|
|
transition: transform ease-out 0.1s;
|
|
}
|
|
|
|
.popover-animation-enter {
|
|
transform: scale(0.95);
|
|
@apply opacity-0;
|
|
}
|
|
|
|
.popover-animation-enter-to {
|
|
transform: scale(1);
|
|
@apply opacity-100;
|
|
}
|
|
|
|
.popover-animation-leave {
|
|
transform: scale(1);
|
|
@apply opacity-100;
|
|
}
|
|
|
|
.popover-animation-leave-to {
|
|
transform: scale(0.95);
|
|
@apply opacity-0;
|
|
}
|
|
|
|
.label-actions-box {
|
|
--triangle-position: 5.3125rem;
|
|
}
|
|
.update-actions-box {
|
|
--triangle-position: 3.5rem;
|
|
}
|
|
.agent-actions-box {
|
|
--triangle-position: 1.75rem;
|
|
}
|
|
.team-actions-box {
|
|
--triangle-position: 0.125rem;
|
|
}
|
|
</style>
|