@openui5/sap.ui.unified 1.148.0 → 1.149.0

package/src/sap/ui/unified/RecurringCalendarAppointment.js

@@ -0,0 +1,222 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides control sap.ui.unified.RecurringCalendarAppointment.
+sap.ui.define([
+	'./CalendarAppointment',
+	'./calendar/RecurrenceUtils',
+	'./library',
+	"sap/ui/core/date/UI5Date",
+	"./WeeklyRecurrenceRule",
+	"./MonthlyRecurrenceRule",
+	"./YearlyRecurrenceRule"
+],
+	function(
+		CalendarAppointment,
+		RecurrenceUtils,
+		library,
+		UI5Date,
+		WeeklyRecurrenceRule,
+		MonthlyRecurrenceRule,
+		YearlyRecurrenceRule
+	) {
+	"use strict";
+
+	/**
+	 * Constructor for a new <code>RecurringCalendarAppointment</code>.
+	 *
+	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new control
+	 *
+	 * @class
+	 * An appointment for use in a <code>PlanningCalendar</code> or similar. The rendering must be done in the Row collecting the appointments.
+	 * (Because there are different visualizations possible.)
+	 *
+	 * Applications could inherit from this element to add own fields.
+	 * @extends sap.ui.unified.CalendarAppointment
+	 * @version 1.149.0
+	 *
+	 * @constructor
+	 * @public
+	 * @ui5-experimental-since 1.149
+	 * @alias sap.ui.unified.RecurringCalendarAppointment
+	 */
+	const RecurringCalendarAppointment = CalendarAppointment.extend("sap.ui.unified.RecurringCalendarAppointment", /** @lends sap.ui.unified.RecurringCalendarAppointment.prototype */ { metadata : {
+		library : "sap.ui.unified",
+		properties : {
+			/**
+			 * The recurrence type (Daily, Weekly, Monthly, Yearly).
+			 */
+			recurrenceType: {type: "sap.ui.unified.RecurrenceType", group: "Misc"},
+
+			/**
+			 * End date of the recurrence. Must be a UI5Date or JavaScript Date object.
+			 */
+			recurrenceEndDate: {type: "object", group: "Data"},
+
+			/**
+			 * Recurrence interval. E.g. 1 = every day/week/month/year, 2 = every second, etc.
+			 */
+			recurrencePattern: {type: "int", group: "Behavior", defaultValue: 1}
+		},
+		defaultAggregation: "recurrenceRule",
+		aggregations: {
+			/**
+			 * Advanced recurrence rule configuration.
+			 * @see sap.ui.unified.RecurrenceRule
+			 */
+			recurrenceRule: {type: "sap.ui.unified.RecurrenceRule", multiple: false}
+		}
+	}});
+
+	RecurringCalendarAppointment.prototype.setRecurrenceRule = function(oRule) {
+		RecurrenceUtils.invalidateCache.call(this);
+		if (oRule && oRule.getMetadata().getName() === "sap.ui.unified.RecurrenceRule") {
+			const RecurrenceType = library.RecurrenceType;
+			switch (oRule.getRecurrenceType()) {
+				case RecurrenceType.Weekly:
+					oRule = new WeeklyRecurrenceRule({days: oRule.getDays()});
+					break;
+				case RecurrenceType.Monthly:
+					oRule = new MonthlyRecurrenceRule({
+						type: oRule.getType(), dayOfMonth: oRule.getDayOfMonth(),
+						weekOfMonth: oRule.getWeekOfMonth(), dayOfWeek: oRule.getDayOfWeek()
+					});
+					break;
+				case RecurrenceType.Yearly: {
+					const mSettings = {
+						type: oRule.getType(), dayOfMonth: oRule.getDayOfMonth(),
+						weekOfMonth: oRule.getWeekOfMonth(), dayOfWeek: oRule.getDayOfWeek()
+					};
+					if (oRule.getMonth() >= 0) {
+						mSettings.month = oRule.getMonth();
+					}
+					oRule = new YearlyRecurrenceRule(mSettings);
+					break;
+				}
+				default:
+					break;
+			}
+		}
+		return this.setAggregation("recurrenceRule", oRule);
+	};
+
+	RecurringCalendarAppointment.prototype.getDuration = function () {
+		return Math.abs(this.getStartDate().getTime() - this.getEndDate().getTime());
+	};
+
+	RecurringCalendarAppointment.prototype.getStartAndEndDate = function(oDate) {
+		const oStartDate = UI5Date.getInstance(oDate.getFullYear(), oDate.getMonth(), oDate.getDate(),
+			this.getStartDate().getHours(), this.getStartDate().getMinutes());
+		const oEndDate = UI5Date.getInstance(oStartDate.getTime() + this.getDuration());
+		return {startDate: oStartDate, endDate: oEndDate};
+	};
+
+	/**
+	 * Creates <code>CalendarAppointment</code> clones for each occurrence of this recurring appointment within the given date range.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oRangeStart Start of the visible range (inclusive)
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oRangeEnd End of the visible range (inclusive)
+	 * @returns {sap.ui.unified.CalendarAppointment[]} Array of cloned appointments, one per occurrence
+	 * @public
+	 */
+	RecurringCalendarAppointment.prototype.createOccurrenceClones = function(oRangeStart, oRangeEnd) {
+		const oAppStartDate = this.getStartDate();
+		const iDuration = this.getDuration();
+		const aOccurrences = RecurrenceUtils.getOccurrencesInRange.call(this, oRangeStart, oRangeEnd);
+
+		return aOccurrences.map((oOccurrenceDate) => {
+			const oOccurrenceStart = UI5Date.getInstance(oOccurrenceDate);
+			oOccurrenceStart.setHours(oAppStartDate.getHours(), oAppStartDate.getMinutes(), oAppStartDate.getSeconds());
+			const oOccurrenceEnd = UI5Date.getInstance(oOccurrenceStart.getTime() + iDuration);
+
+			return new CalendarAppointment({
+				startDate: oOccurrenceStart,
+				endDate: oOccurrenceEnd,
+				title: this.getTitle(),
+				text: this.getText(),
+				type: this.getType(),
+				selected: this.getSelected(),
+				tentative: this.getTentative(),
+				icon: this.getIcon()
+			});
+		});
+	};
+
+	RecurringCalendarAppointment.prototype.hasAppointmentAtDate = function(oDate) {
+		return RecurrenceUtils.hasOccurrenceOnDate.call(this, oDate);
+	};
+
+	RecurringCalendarAppointment.prototype.isRecurring = function() {
+		return !!this.getRecurrenceType();
+	};
+
+	RecurringCalendarAppointment.prototype.setRecurrenceType = function(sValue) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrenceType", sValue);
+	};
+
+	RecurringCalendarAppointment.prototype.setRecurrencePattern = function(iValue) {
+		if (iValue < 1) {
+			throw new Error("recurrencePattern must be >= 1");
+		}
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrencePattern", iValue);
+	};
+
+	RecurringCalendarAppointment.prototype.setStartDate = function(oDate) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("startDate", oDate);
+	};
+
+	RecurringCalendarAppointment.prototype.setEndDate = function(oDate) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("endDate", oDate);
+	};
+
+	RecurringCalendarAppointment.prototype.setRecurrenceEndDate = function(oDate) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrenceEndDate", oDate);
+	};
+
+	RecurringCalendarAppointment.prototype.hasOccurrenceOnDateCached = function(oDate) {
+		return RecurrenceUtils.hasOccurrenceOnDateCached.call(this, oDate);
+	};
+
+	/**
+	 * Returns all occurrence dates within the given date range.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oStartDate - Start date of range (inclusive)
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oEndDate - End date of range (inclusive)
+	 * @returns {Date[]} Array of occurrence dates (UI5Date instances)
+	 * @public
+	 */
+	RecurringCalendarAppointment.prototype.getOccurrencesInRange = function(oStartDate, oEndDate) {
+		return RecurrenceUtils.getOccurrencesInRange.call(this, oStartDate, oEndDate);
+	};
+
+	/**
+	 * Gets cached occurrences for a date range.
+	 * Returns cached result if available, or null if not cached.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oStartDate - Start date of range
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oEndDate - End date of range
+	 * @returns {Date[]|null} Cached occurrence dates or null
+	 * @private
+	 */
+	RecurringCalendarAppointment.prototype.getCachedOccurrences = function(oStartDate, oEndDate) {
+		return RecurrenceUtils.getCachedOccurrences.call(this, oStartDate, oEndDate);
+	};
+
+	/**
+	 * Sets cached occurrences for a date range.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oStartDate - Start date of range
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oEndDate - End date of range
+	 * @param {Date[]} aOccurrences - Array of occurrence dates to cache
+	 * @private
+	 */
+	RecurringCalendarAppointment.prototype.setCachedOccurrences = function(oStartDate, oEndDate, aOccurrences) {
+		RecurrenceUtils.setCachedOccurrences.call(this, oStartDate, oEndDate, aOccurrences);
+	};
+
+	return RecurringCalendarAppointment;
+});

package/src/sap/ui/unified/RecurringNonWorkingPeriod.js

@@ -6,10 +6,20 @@
 
 // Provides control sap.ui.unified.RecurringNonWorkingPeriod.
 sap.ui.define([
-	"./NonWorkingPeriod"
+	"./NonWorkingPeriod",
+	"./calendar/RecurrenceUtils",
+	"./library",
+	"./WeeklyRecurrenceRule",
+	"./MonthlyRecurrenceRule",
+	"./YearlyRecurrenceRule"
 ],
 	function(
-		NonWorkingPeriod
+		NonWorkingPeriod,
+		RecurrenceUtils,
+		library,
+		WeeklyRecurrenceRule,
+		MonthlyRecurrenceRule,
+		YearlyRecurrenceRule
 	) {
 	"use strict";
 
@@ -24,14 +34,14 @@ sap.ui.define([
 	 *
 	 * Applications can inherit from this element to add own fields.
 	 * @extends sap.ui.unified.NonWorkingPeriod
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public
 	 * @ui5-experimental-since 1.127.0
 	 * @alias sap.ui.unified.RecurringNonWorkingPeriod
 	 */
-	var RecurringNonWorkingPeriod = NonWorkingPeriod.extend("sap.ui.unified.RecurringNonWorkingPeriod", /** @lends sap.ui.unified.RecurringNonWorkingPeriod.prototype */ { metadata : {
+	const RecurringNonWorkingPeriod = NonWorkingPeriod.extend("sap.ui.unified.RecurringNonWorkingPeriod", /** @lends sap.ui.unified.RecurringNonWorkingPeriod.prototype */ { metadata : {
 
 		library : "sap.ui.unified",
 		properties : {
@@ -51,17 +61,113 @@ sap.ui.define([
 			 * If the recurrencePattern is set to 3, this would imply the calendar item is recurring once for every three days.
 			 */
 			recurrencePattern: {type : "int", group : "Behavior", defaultValue : 1}
+		},
+		aggregations: {
+			/**
+			 * Advanced recurrence rule configuration.
+			 * @see sap.ui.unified.RecurrenceRule
+			 */
+			recurrenceRule: {type: "sap.ui.unified.RecurrenceRule", multiple: false}
 		}
 	}});
 
+	RecurringNonWorkingPeriod.prototype.setRecurrenceRule = function(oRule) {
+		RecurrenceUtils.invalidateCache.call(this);
+		if (oRule && oRule.getMetadata().getName() === "sap.ui.unified.RecurrenceRule") {
+			const RecurrenceType = library.RecurrenceType;
+			switch (oRule.getRecurrenceType()) {
+				case RecurrenceType.Weekly:
+					oRule = new WeeklyRecurrenceRule({days: oRule.getDays()});
+					break;
+				case RecurrenceType.Monthly:
+					oRule = new MonthlyRecurrenceRule({
+						type: oRule.getType(), dayOfMonth: oRule.getDayOfMonth(),
+						weekOfMonth: oRule.getWeekOfMonth(), dayOfWeek: oRule.getDayOfWeek()
+					});
+					break;
+				case RecurrenceType.Yearly: {
+					const mSettings = {
+						type: oRule.getType(), dayOfMonth: oRule.getDayOfMonth(),
+						weekOfMonth: oRule.getWeekOfMonth(), dayOfWeek: oRule.getDayOfWeek()
+					};
+					if (oRule.getMonth() >= 0) {
+						mSettings.month = oRule.getMonth();
+					}
+					oRule = new YearlyRecurrenceRule(mSettings);
+					break;
+				}
+				default:
+					break;
+			}
+		}
+		return this.setAggregation("recurrenceRule", oRule);
+	};
+
 	/**
 	 * Determines whether the current instance has recurrence or not.
 	 * @return {boolean} The result is <code>true</code> when the instance has recurrence.
 	 * @private
 	 */
 	RecurringNonWorkingPeriod.prototype.isRecurring = function () {
-		return true;
+		return !!this.getRecurrenceType();
+	};
+
+	/**
+	 * Checks if a given date (without time) is a non-working day.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oDate - Date to check
+	 * @returns {boolean} True if the date is non-working
+	 * @public
+	 */
+	RecurringNonWorkingPeriod.prototype.hasNonWorkingAtDate = function(oDate) {
+		// Delegate to RecurrenceUtils
+		const hasOccurrenceOnDate = RecurrenceUtils.hasOccurrenceOnDate.bind(this);
+		return hasOccurrenceOnDate(oDate);
+	};
+
+	RecurringNonWorkingPeriod.prototype.setRecurrenceType = function(sValue) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrenceType", sValue);
+	};
+
+	RecurringNonWorkingPeriod.prototype.setRecurrencePattern = function(iValue) {
+		if (iValue < 1) {
+			throw new Error("recurrencePattern must be >= 1");
+		}
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrencePattern", iValue);
+	};
+
+	RecurringNonWorkingPeriod.prototype.setRecurrenceEndDate = function(oDate) {
+		RecurrenceUtils.invalidateCache.call(this);
+		return this.setProperty("recurrenceEndDate", oDate);
+	};
+
+	RecurringNonWorkingPeriod.prototype.hasOccurrenceOnDateCached = function(oDate) {
+		return RecurrenceUtils.hasOccurrenceOnDateCached.call(this, oDate);
+	};
+
+	/**
+	 * Gets cached non-working periods for a date range.
+	 * Returns cached result if available, or null if not cached.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oStartDate - Start date of range
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oEndDate - End date of range
+	 * @returns {sap.ui.unified.NonWorkingPeriod[]|null} Cached non-working periods or null
+	 * @public
+	 */
+	RecurringNonWorkingPeriod.prototype.getCachedOccurrences = function(oStartDate, oEndDate) {
+		return RecurrenceUtils.getCachedOccurrences.call(this, oStartDate, oEndDate);
+	};
+
+	/**
+	 * Sets cached non-working periods for a date range.
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oStartDate - Start date of range
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oEndDate - End date of range
+	 * @param {sap.ui.unified.NonWorkingPeriod[]} aPeriods - Array of non-working periods to cache
+	 * @public
+	 */
+	RecurringNonWorkingPeriod.prototype.setCachedOccurrences = function(oStartDate, oEndDate, aPeriods) {
+		RecurrenceUtils.setCachedOccurrences.call(this, oStartDate, oEndDate, aPeriods);
 	};
 
 	return RecurringNonWorkingPeriod;
-});
+});

package/src/sap/ui/unified/Shell.js

@@ -25,7 +25,7 @@ sap.ui.define(['./ShellHeader', './ShellLayout', './library', './ShellRenderer']
 	 * @extends sap.ui.unified.ShellLayout
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/ShellHeadItem.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/ShellHeadUserItem.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/ShellLayout.js

@@ -56,7 +56,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/ShellOverlay.js

@@ -46,7 +46,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/SplitContainer.js

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/TimeRange.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @class
 	 * Time range for use in <code>NonWorkingPeriod</code>
 	 * @extends sap.ui.core.Element
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/WeeklyRecurrenceRule.js

@@ -0,0 +1,39 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides control sap.ui.unified.WeeklyRecurrenceRule.
+sap.ui.define([
+	"./RecurrenceRule"
+], function(RecurrenceRule) {
+	"use strict";
+
+	/**
+	 * Constructor for a new <code>WeeklyRecurrenceRule</code>.
+	 *
+	 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new element
+	 *
+	 * @class
+	 * Concrete recurrence rule for <code>Weekly</code> recurrence.
+	 * Created internally by the parent when a {@link sap.ui.unified.RecurrenceRule} DTO
+	 * with <code>recurrenceType</code> set to <code>Weekly</code> is provided.
+	 *
+	 * @extends sap.ui.unified.RecurrenceRule
+	 * @version 1.149.0
+	 *
+	 * @constructor
+	 * @private
+	 * @ui5-experimental-since 1.149
+	 * @alias sap.ui.unified.WeeklyRecurrenceRule
+	 */
+	const WeeklyRecurrenceRule = RecurrenceRule.extend("sap.ui.unified.WeeklyRecurrenceRule", {
+		metadata: {
+			library: "sap.ui.unified"
+		}
+	});
+
+	return WeeklyRecurrenceRule;
+});

package/src/sap/ui/unified/YearlyRecurrenceRule.js

@@ -0,0 +1,53 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides control sap.ui.unified.YearlyRecurrenceRule.
+sap.ui.define([
+	"./MonthlyRecurrenceRule"
+], function(MonthlyRecurrenceRule) {
+	"use strict";
+
+	/**
+	 * Constructor for a new <code>YearlyRecurrenceRule</code>.
+	 *
+	 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new element
+	 *
+	 * @class
+	 * Concrete recurrence rule for <code>Yearly</code> recurrence.
+	 * Extends {@link sap.ui.unified.MonthlyRecurrenceRule} with a <code>month</code> property.
+	 * Created internally by the parent when a {@link sap.ui.unified.RecurrenceRule} DTO
+	 * with <code>recurrenceType</code> set to <code>Yearly</code> is provided.
+	 *
+	 * @extends sap.ui.unified.MonthlyRecurrenceRule
+	 * @version 1.149.0
+	 *
+	 * @constructor
+	 * @private
+	 * @ui5-experimental-since 1.149
+	 * @alias sap.ui.unified.YearlyRecurrenceRule
+	 */
+	const YearlyRecurrenceRule = MonthlyRecurrenceRule.extend("sap.ui.unified.YearlyRecurrenceRule", {
+		metadata: {
+			library: "sap.ui.unified"
+		}
+	});
+
+	/**
+	 * Sets the month with validation.
+	 * @param {int} iMonth - Month (0-11)
+	 * @returns {this}
+	 * @private
+	 */
+	YearlyRecurrenceRule.prototype.setMonth = function(iMonth) {
+		if (iMonth < -1 || iMonth > 11) {
+			throw new Error("month must be between 0 and 11");
+		}
+		return this.setProperty("month", iMonth);
+	};
+
+	return YearlyRecurrenceRule;
+});

package/src/sap/ui/unified/calendar/DatesRow.js

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * If used inside the calendar the properties and aggregation are directly taken from the parent
 	 * (To not duplicate and sync DateRanges and so on...)
 	 * @extends sap.ui.unified.calendar.Month
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/unified/calendar/Header.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> This is used inside the calendar. Not for standalone usage
 	 * @extends sap.ui.core.Control
-	 * @version 1.148.0
+	 * @version 1.149.0
 	 *
 	 * @constructor
 	 * @public
@@ -201,7 +201,19 @@ sap.ui.define([
 			 * Holds a reference to the currently shown picker. Possible values: month, monthPicker, yearPicker and yearRangePicker.
 			 * @private
 			 */
-			_currentPicker : {type : "string", group : "Appearance", visibility: "hidden"}
+			_currentPicker : {type : "string", group : "Appearance", visibility: "hidden"},
+
+			/**
+			 * Alignment of the left content area. Possible values: "Start", "Center", "End".
+			 * @private
+			 */
+			_alignLeft : {type : "string", defaultValue : "Center", visibility: "hidden"},
+
+			/**
+			 * Alignment of the right content area. Possible values: "Start", "Center", "End".
+			 * @private
+			 */
+			_alignRight : {type : "string", defaultValue : "Center", visibility: "hidden"}
 
 		},
 		events : {