@progress/kendo-vue-scheduler 9.3.0-develop.5 → 9.3.0-develop.6

package/editors/SchedulerRecurrenceDialog.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { DialogCloseEvent } from '@progress/kendo-vue-dialogs';
+import { NumericTextBoxChangeEvent, RadioGroupChangeEvent } from '@progress/kendo-vue-inputs';
+import { DropDownListChangeEvent } from '@progress/kendo-vue-dropdowns';
+import { DatePickerChangeEvent } from '@progress/kendo-vue-dateinputs';
+import { ZonedDate } from '@progress/kendo-date-math';
+import { RecurrenceRule } from '@progress/kendo-recurrence';
+import { PropType } from 'vue';
+import { Frequency } from '../recurrence/types/Frequency';
+import { WeekDayEntity } from '../recurrence/types/WeekDayEntity';
+import { MonthEntity } from '../recurrence/types/MonthEntity';
+import { OffsetPositionEntity } from '../recurrence/types/OffsetPositionEntity';
+import { EndRule } from '../recurrence/types/EndRule';
+import { RepeatOnRule } from '../recurrence/types/RepeatOnRule';
+interface FrequencyDropDownItem {
+    text: string;
+    value: Frequency;
+}
+interface EndRuleDropDownItem {
+    text: string;
+    value: EndRule;
+}
+/** @hidden */
+export interface SchedulerRecurrenceDialogProps {
+    /** The current recurrence rule string (RRULE). */
+    value: string | null;
+    /** The event start date. */
+    start: Date;
+    /** The scheduler timezone. */
+    timezone: string;
+    /** Fires when the user clicks Save. */
+    onSave?: (rule: string | null) => void;
+    /** Fires when the user clicks Cancel or closes. */
+    onCancel?: () => void;
+    /** Fires when the user clicks Remove recurrence. */
+    onRemoveRecurrence?: () => void;
+    /** Custom template for the recurrence summary text. */
+    recurrenceSummaryTemplate?: any;
+    /** Custom recurrence editor component rendered inside the dialog instead of the built-in form. */
+    recurrenceEditor?: any;
+}
+/** @hidden */
+declare const SchedulerRecurrenceDialog: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    value: {
+        type: PropType<string>;
+        default: any;
+    };
+    start: {
+        type: PropType<Date>;
+        required: true;
+    };
+    timezone: {
+        type: StringConstructor;
+        default: string;
+    };
+    onSave: PropType<(rule: string | null) => void>;
+    onCancel: PropType<() => void>;
+    onRemoveRecurrence: PropType<() => void>;
+    recurrenceSummaryTemplate: PropType<any>;
+    recurrenceEditor: PropType<any>;
+}>, {
+    kendoLocalizationService: {};
+}, {
+    rrule: RecurrenceRule;
+    defaultCount: number;
+    defaultUntil: ZonedDate;
+    startsOn: Date;
+}, {
+    frequency(): Frequency;
+    weekDays(): WeekDayEntity[];
+    extendedWeekDays(): WeekDayEntity[];
+    weekDay(): WeekDayEntity;
+    months(): MonthEntity[];
+    month(): MonthEntity;
+    offsets(): OffsetPositionEntity[];
+    offset(): OffsetPositionEntity;
+    endRule(): EndRule;
+    monthDay(): number;
+    until(): Date | null;
+    repeatOnRule(): RepeatOnRule | undefined;
+    isExistingRecurrence(): boolean;
+    frequencyData(): FrequencyDropDownItem[];
+    endRuleData(): EndRuleDropDownItem[];
+    frequencyDropDownValue(): FrequencyDropDownItem;
+    endRuleDropDownValue(): EndRuleDropDownItem;
+    narrowWeekDays(): {
+        narrow: string;
+        wide: string;
+        value: number;
+    }[];
+    selectedWeekDays(): number[];
+    summary(): string;
+    currentRuleString(): string | null;
+    parsedCurrentRule(): any;
+}, {
+    localizeMessage(baseMassage: string, removePrepend?: boolean): string;
+    renderRecurrenceSummaryTemplate(): import("vue/jsx-runtime").JSX.Element;
+    updateRrule(newRrule: RecurrenceRule): void;
+    handleFrequencyChange(newFreq: string): void;
+    handleIntervalChange(event: NumericTextBoxChangeEvent): void;
+    handleCountChange(event: NumericTextBoxChangeEvent): void;
+    handleUntilChange(event: DatePickerChangeEvent): void;
+    handleWeekDaysChange(newWeekDays: number[]): void;
+    handleWeekDayChange(event: DropDownListChangeEvent): void;
+    handleMonthDayChange(event: NumericTextBoxChangeEvent): void;
+    handleMonthChange(event: DropDownListChangeEvent): void;
+    handleEndRuleDropDownChange(event: DropDownListChangeEvent): void;
+    handleRepeatOnRuleChange(event: RadioGroupChangeEvent): void;
+    handleOffsetChange(event: DropDownListChangeEvent): void;
+    handleFrequencyDropDownChange(event: DropDownListChangeEvent): void;
+    handleWeekDayButtonClick(dayValue: number): void;
+    handleStartsOnChange(event: DatePickerChangeEvent): void;
+    handleSave(): void;
+    handleClose(_e: DialogCloseEvent): void;
+}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    value: {
+        type: PropType<string>;
+        default: any;
+    };
+    start: {
+        type: PropType<Date>;
+        required: true;
+    };
+    timezone: {
+        type: StringConstructor;
+        default: string;
+    };
+    onSave: PropType<(rule: string | null) => void>;
+    onCancel: PropType<() => void>;
+    onRemoveRecurrence: PropType<() => void>;
+    recurrenceSummaryTemplate: PropType<any>;
+    recurrenceEditor: PropType<any>;
+}>> & Readonly<{}>, {
+    value: string;
+    timezone: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export { SchedulerRecurrenceDialog };

package/editors/SchedulerRecurrenceDialog.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("vue"),C=require("@progress/kendo-vue-dialogs"),D=require("@progress/kendo-vue-buttons"),u=require("@progress/kendo-vue-intl"),m=require("@progress/kendo-vue-inputs"),d=require("@progress/kendo-vue-dropdowns"),V=require("@progress/kendo-vue-dateinputs"),g=require("@progress/kendo-vue-labels"),h=require("@progress/kendo-vue-form"),p=require("@progress/kendo-date-math"),k=require("@progress/kendo-recurrence"),n=require("../messages/main.js"),N=require("../hooks/useRecurrenceSummary.js"),l=require("../recurrence/common.js");function c(e){return typeof e=="function"||Object.prototype.toString.call(e)==="[object Object]"&&!r.isVNode(e)}const S=r.defineComponent({name:"KendoSchedulerRecurrenceDialog",props:{value:{type:[String,null],default:null},start:{type:Date,required:!0},timezone:{type:String,default:""},onSave:Function,onCancel:Function,onRemoveRecurrence:Function,recurrenceSummaryTemplate:[Object,Function],recurrenceEditor:[Object,Function]},inject:{kendoLocalizationService:{default:null}},setup(){return{kendoLocalizationService:r.inject("kendoLocalizationService",{})}},data(){var a;const e=l.getRule((a=this.value)!=null?a:"");return{rrule:e.freq?e:{freq:"daily",interval:1},defaultCount:1,defaultUntil:p.ZonedDate.fromUTCDate(this.start),startsOn:new Date(this.start)}},computed:{frequency(){return l.getFrequency(this.rrule)},weekDays(){const e=u.provideIntlService(this);return l.getWeekDays(e)},extendedWeekDays(){const e=u.provideIntlService(this);return l.getExtendedWeekDays(e,this.localizeMessage)},weekDay(){return l.getWeekDay(this.extendedWeekDays,this.rrule,this.startsOn)},months(){const e=u.provideIntlService(this);return l.getMonths(e)},month(){return l.getMonth(this.months,this.rrule)},offsets(){return l.getOffsets(this.localizeMessage)},offset(){return l.getOffset(this.offsets,this.rrule)},endRule(){return l.getEndRule(this.rrule)},monthDay(){return l.getMonthDay(this.rrule,this.startsOn)},until(){return this.rrule.until?p.toLocalDate(this.rrule.until):null},repeatOnRule(){return l.getRepeatOnRule(this.rrule)},isExistingRecurrence(){return!!this.value},frequencyData(){return[{text:this.localizeMessage(n.recurrenceEditorFrequenciesDaily,!0),value:"daily"},{text:this.localizeMessage(n.recurrenceEditorFrequenciesWeekly,!0),value:"weekly"},{text:this.localizeMessage(n.recurrenceEditorFrequenciesMonthly,!0),value:"monthly"},{text:this.localizeMessage(n.recurrenceEditorFrequenciesYearly,!0),value:"yearly"}]},endRuleData(){return[{text:this.localizeMessage(n.recurrenceEditorEndNever,!0),value:"never"},{text:this.localizeMessage(n.recurrenceEditorEndAfter,!0),value:"count"},{text:this.localizeMessage(n.recurrenceEditorEndOn,!0),value:"until"}]},frequencyDropDownValue(){return this.frequencyData.find(e=>e.value===this.frequency)||this.frequencyData[0]},endRuleDropDownValue(){return this.endRuleData.find(e=>e.value===this.endRule)||this.endRuleData[0]},narrowWeekDays(){const e=u.provideIntlService(this),t=e.firstDay(),a=e.dateFormatNames({type:"days",nameType:"narrow"}),i=e.dateFormatNames({type:"days",nameType:"wide"}),o=a.map((y,f)=>({narrow:y,wide:i[f],value:f}));return o.slice(t).concat(o.slice(0,t))},selectedWeekDays(){return(this.rrule.byWeekDay||[]).map(({day:e})=>e)},summary(){if(!this.rrule.freq||this.rrule.freq==="never")return"";const e=u.provideIntlService(this),t=u.provideLocalizationService(this),a=k.serializeRule(this.rrule,this.timezone);return N.getRecurrenceSummary(a,this.startsOn,e,(i,o)=>t.toLanguageString(i,o))},currentRuleString(){return!this.rrule.freq||this.rrule.freq==="never"?null:k.serializeRule(this.rrule,this.timezone)},parsedCurrentRule(){return this.currentRuleString?k.parseRule({recurrenceRule:this.currentRuleString}):null}},methods:{localizeMessage(e,t){const a=u.provideLocalizationService(this),i=t?e:"scheduler.recurrenceEditor"+e;return a.toLanguageString(i,n.messages[i])},renderRecurrenceSummaryTemplate(){const e=this.recurrenceSummaryTemplate;return!e||!this.currentRuleString?null:r.createVNode(e,{recurrenceRule:this.currentRuleString,text:this.summary||"",parsedRule:this.parsedCurrentRule},null)},updateRrule(e){this.rrule={...e}},handleFrequencyChange(e){const t={};t.freq=e,t.interval=1,e==="weekly"&&(t.byWeekDay=[{day:p.ZonedDate.fromLocalDate(this.startsOn,this.timezone).getDay(),offset:0}]),(e==="monthly"||e==="yearly")&&(t.byMonthDay=[this.startsOn.getDate()]),e==="yearly"&&(t.byMonth=[this.startsOn.getMonth()+1]),this.updateRrule(t)},handleIntervalChange(e){var t;this.updateRrule({...this.rrule,interval:(t=e.value)!=null?t:1})},handleCountChange(e){const t=e.value,a=t!=null?t:this.defaultCount;this.updateRrule({...this.rrule,count:a}),t!==null&&(this.defaultCount=a)},handleUntilChange(e){if(!e.value)return;const t=p.ZonedDate.fromLocalDate(e.value,this.timezone);this.updateRrule({...this.rrule,until:t}),this.defaultUntil=t},handleWeekDaysChange(e){this.updateRrule({...this.rrule,byWeekDay:this.weekDays.filter(t=>e.some(a=>a===t.value)).map(t=>({offset:0,day:t.value}))})},handleWeekDayChange(e){const t={...this.rrule},a=e.value;typeof a.value=="string"?(t.byWeekDay=l.weekDayRuleFromString(a.value),t.bySetPosition=[this.offset.value]):(t.bySetPosition=void 0,t.byWeekDay=[{day:a.value,offset:this.offset.value}]),this.updateRrule(t)},handleMonthDayChange(e){var t;this.updateRrule({...this.rrule,byMonthDay:[(t=e.value)!=null?t:1]})},handleMonthChange(e){this.updateRrule({...this.rrule,byMonth:[e.value.value]})},handleEndRuleDropDownChange(e){const t=e.value.value,a={...this.rrule};switch(t){case"never":a.until=void 0,a.count=void 0;break;case"count":a.until=void 0,a.count=this.defaultCount;break;case"until":a.until=this.defaultUntil,a.count=void 0;break}this.updateRrule(a)},handleRepeatOnRuleChange(e){const t={...this.rrule};e.value==="monthday"?(t.byWeekDay=void 0,t.bySetPosition=void 0,t.byMonthDay=[this.monthDay]):e.value==="weekday"&&(t.byMonthDay=void 0,typeof this.weekDay.value=="string"?(t.bySetPosition=[this.offset.value],t.byWeekDay=l.weekDayRuleFromString(this.weekDay.value)):t.byWeekDay=[{day:this.weekDay.value,offset:this.offset.value}]),this.updateRrule(t)},handleOffsetChange(e){const t={...this.rrule},a=e.value;if(t.byWeekDay)switch(t.byWeekDay.length){case 7:case 5:case 2:t.bySetPosition=[a.value];break;case 1:t.byWeekDay[0].offset=a.value;break}this.updateRrule(t)},handleFrequencyDropDownChange(e){const t=e.value.value;this.handleFrequencyChange(t)},handleWeekDayButtonClick(e){const t=this.selectedWeekDays.includes(e)?this.selectedWeekDays.filter(a=>a!==e):[...this.selectedWeekDays,e];this.handleWeekDaysChange(t)},handleStartsOnChange(e){e.value&&(this.startsOn=e.value)},handleSave(){const e=u.provideIntlService(this);this.rrule.freq==="never"||!this.rrule.freq?this.$emit("save",null):(this.rrule.weekStart===void 0&&(this.rrule.weekStart=e.firstDay()),this.$emit("save",k.serializeRule(this.rrule,this.timezone)))},handleClose(e){this.$emit("cancel")}},render(){let e,t,a,i,o;const y=u.provideLocalizationService(this),f=y.toLanguageString(n.editorSave,n.messages[n.editorSave]),R=y.toLanguageString(n.editorCancel,n.messages[n.editorCancel]),b=y.toLanguageString(n.editorRecurrenceDialogTitle,n.messages[n.editorRecurrenceDialogTitle]),w=y.toLanguageString(n.editorRecurrenceRemove,n.messages[n.editorRecurrenceRemove]);return r.createVNode(C.Dialog,{title:b,appendTo:"body",width:540,onClose:this.handleClose},{default:()=>[r.createVNode("div",{class:"k-form k-form-horizontal"},[r.createVNode(h.FieldWrapper,null,{default:()=>[r.createVNode(g.Label,{editorId:"recurrence-interval",class:"k-form-label"},c(e=this.localizeMessage(n.recurrenceEditorRepeat,!0))?e:{default:()=>[e]}),r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[this.frequency!=="never"&&r.createVNode(m.NumericTextBox,{id:"recurrence-interval",min:1,step:1,defaultValue:1,value:this.rrule.interval,onChange:this.handleIntervalChange},null),r.createVNode(d.DropDownList,{dataItems:this.frequencyData,textField:"text",dataItemKey:"value",value:this.frequencyDropDownValue,onChange:this.handleFrequencyDropDownChange},null)])])]}),this.frequency==="weekly"&&r.createVNode(h.FieldWrapper,null,{default:()=>[r.createVNode(g.Label,{class:"k-form-label"},c(t=this.localizeMessage(n.recurrenceEditorWeeklyRepeatOn,!0))?t:{default:()=>[t]}),r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode("div",{class:"k-scheduler-weekday-picker",role:"group","aria-label":this.localizeMessage(n.recurrenceEditorWeeklyRepeatOnDays,!0)},[this.narrowWeekDays.map(s=>r.createVNode(D.Button,{key:s.value,type:"button",themeColor:"primary",fillMode:"flat",rounded:"full",togglable:!0,selected:this.selectedWeekDays.includes(s.value),"aria-label":s.wide,"aria-pressed":this.selectedWeekDays.includes(s.value),onClick:()=>this.handleWeekDayButtonClick(s.value)},{default:()=>[s.narrow]}))])])]}),this.frequency==="monthly"&&r.createVNode(h.FieldWrapper,null,{default:()=>{var s,v;return[r.createVNode(g.Label,{class:"k-form-label"},c(a=this.localizeMessage(n.recurrenceEditorMonthlyRepeatOn,!0))?a:{default:()=>[a]}),r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode(m.RadioGroup,{value:this.repeatOnRule,onChange:this.handleRepeatOnRuleChange,class:"k-reset",dataItems:[{value:"weekday",tabIndex:0,name:"scheduler-recurrence-monthly-weekday",label:" ",content:r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[r.createVNode(d.DropDownList,{textField:"text",dataItemKey:"value",disabled:this.repeatOnRule!=="weekday",dataItems:this.offsets,value:this.offset,onChange:this.handleOffsetChange},null),r.createVNode(d.DropDownList,{disabled:this.repeatOnRule!=="weekday",value:this.weekDay,dataItems:this.extendedWeekDays,onChange:this.handleWeekDayChange,textField:"text",dataItemKey:"value"},null)])},{value:"monthday",tabIndex:0,name:"scheduler-recurrence-monthly-monthday",label:" ",content:r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[r.createVNode(m.NumericTextBox,{min:1,max:31,disabled:this.repeatOnRule!=="monthday",value:(v=(s=this.rrule)==null?void 0:s.byMonthDay)==null?void 0:v[0],onChange:this.handleMonthDayChange,style:{width:"auto"}},null)])}]},null)])]}}),this.frequency==="yearly"&&r.createVNode(h.FieldWrapper,null,{default:()=>[r.createVNode(g.Label,{class:"k-form-label"},c(i=this.localizeMessage(n.recurrenceEditorYearlyRepeatOn,!0))?i:{default:()=>[i]}),r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode(m.RadioGroup,{value:this.repeatOnRule,onChange:this.handleRepeatOnRuleChange,class:"k-reset",dataItems:[{value:"monthday",tabIndex:0,name:"scheduler-recurrence-yearly-monthday",label:" ",content:r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[r.createVNode(d.DropDownList,{disabled:this.repeatOnRule!=="monthday",value:this.month,dataItems:this.months,textField:"text",dataItemKey:"value",onChange:this.handleMonthChange},null),r.createVNode(m.NumericTextBox,{min:1,max:31,disabled:this.repeatOnRule!=="monthday",value:this.monthDay,onChange:this.handleMonthDayChange,style:{width:"auto"}},null)])},{value:"weekday",tabIndex:0,name:"scheduler-recurrence-yearly-weekday",label:" ",content:r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[r.createVNode(d.DropDownList,{textField:"text",dataItemKey:"value",disabled:this.repeatOnRule!=="weekday",dataItems:this.offsets,value:this.offset,onChange:this.handleOffsetChange},null),r.createVNode(d.DropDownList,{textField:"text",dataItemKey:"value",disabled:this.repeatOnRule!=="weekday",value:this.weekDay,dataItems:this.extendedWeekDays,onChange:this.handleWeekDayChange},null),r.createVNode("span",{key:"of-row",class:"k-scheduler-edit-form-row"},[r.createVNode("span",null,[this.localizeMessage(n.recurrenceEditorYearlyOf,!0)]),r.createVNode(d.DropDownList,{textField:"text",dataItemKey:"value",disabled:this.repeatOnRule!=="weekday",value:this.month,dataItems:this.months,onChange:this.handleMonthChange},null)])])}]},null)])]}),this.frequency!=="never"&&r.createVNode(h.FieldWrapper,null,{default:()=>{var s,v;return[r.createVNode(g.Label,{class:"k-form-label"},c(o=this.localizeMessage(n.recurrenceEditorEndLabel,!0))?o:{default:()=>[o]}),r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode("div",{class:"k-scheduler-recurrence-fields"},[r.createVNode(d.DropDownList,{dataItems:this.endRuleData,textField:"text",dataItemKey:"value",value:this.endRuleDropDownValue,onChange:this.handleEndRuleDropDownChange},null),this.endRule==="count"&&r.createVNode(m.NumericTextBox,{min:1,style:{width:"auto"},value:(s=this.rrule.count)!=null?s:this.defaultCount,onChange:this.handleCountChange,format:`0 '${this.localizeMessage(n.recurrenceEditorEndOccurrence,!0)}'`},null),this.endRule==="until"&&r.createVNode(V.DatePicker,{min:this.startsOn,value:(v=this.until)!=null?v:p.toLocalDate(this.defaultUntil),onChange:this.handleUntilChange,style:{width:"auto"}},null)])])]}}),this.frequency!=="never"&&(this.recurrenceSummaryTemplate&&this.currentRuleString?r.createVNode(h.FieldWrapper,null,{default:()=>[r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode("div",{class:"k-form-hint"},[this.renderRecurrenceSummaryTemplate()])])]}):this.summary?r.createVNode(h.FieldWrapper,null,{default:()=>[r.createVNode("div",{class:"k-form-field-wrap"},[r.createVNode("div",{class:"k-form-hint"},[this.summary])])]}):null)]),r.createVNode(C.DialogActionsBar,{layout:"end"},{default:()=>[this.isExistingRecurrence&&this.onRemoveRecurrence&&r.createVNode(D.Button,{fillMode:"flat",themeColor:"primary",onClick:this.onRemoveRecurrence},c(w)?w:{default:()=>[w]}),r.createVNode(D.Button,{onClick:()=>this.$emit("cancel")},c(R)?R:{default:()=>[R]}),r.createVNode(D.Button,{themeColor:"primary",onClick:this.handleSave},c(f)?f:{default:()=>[f]})]})]})}});exports.SchedulerRecurrenceDialog=S;