/**
 * CalendarAPI.bbj
 * @author ndecker
 *
 * The <code>CalendarAPI</code> is a BBj Custom Class that facilitates creating calendar objects, accessing constants, and is used in combination with the <code>BBjCalendarWidget</code>.
 *
 * For the full copyright and license information, please see the LICENSE.txt files distributed with this source code in the appropriate lib directory.
 *
 * @see <a href = 'https://fullcalendar.io' target = '_blank'>FullCalendar</a> for further information on the underlying JavaScript-based calendar.
 *
 * @since BBj 21.00
*/
package BBjCalendarWidget;
import java.time.OffsetDateTime;
import java.util.HashSet;
import java.util.HashMap;
import java.util.TreeMap;
import java.util.Date;
import java.io.File;
import java.util.Vector;
import java.text.SimpleDateFormat;
import javax.script.ScriptEngineManager;
import javax.script.ScriptEngine;
import com.google.gson.Gson;
import com.google.gson.JsonParser;
import com.google.gson.JsonObject;
import com.google.gson.JsonArray;
import com.google.gson.JsonPrimitive;
import com.google.gson.JsonElement;
import com.google.gson.GsonBuilder;
/**
 * The <code>CalendarAPI</code> is a BBj Custom Class that facilitates creating calendar objects, accessing constants, and is used in combination with the <code>BBjCalendarWidget</code>.
 *
 * @since BBj 21.00
*/
public class CalendarAPI {
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the <code>BBjCalendarWidget</code> is ready.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarReadyEvent.html' target = '_blank'>CalendarReadyEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_READY() { }
/**
 * <p>
 * <b>Note</b>: This <b>only</b> fires when the type of view changes, not when the user changes the view from one subtype to another. For example,
 * the event <b>will</b> be triggered when the user switches from the <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code> to the
 * <code>CalendarAPI.CALENDAR_VIEW_LIST_MONTH()</code> view. But it <b>won't</b> be triggerd when the user changes from
 * <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code> to <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_WEEK()</code> since both views are
 * the same type (dayGrid) and just the subtype (week vs. month) changes.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarViewChangeEvent.html' target = '_blank'>CalendarViewChangeEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_VIEW_CHANGE() { }
/**
 * If you set a callback for this event, then add several entries to the calendar, your callback routine may be flooded because
 * the event will fire for every event that you add.
 * <p>
 * When responding to this event, the <code>BBjAPI().getLastEvent()</code> call will return a <code>CalendarEntriesSetEvent</code> object.
 * You can call the <code>CalendarEntriesSetEvent::getEntries()</code> method to return a BBjVector of <code>CalendarEntry</code> objects
 * that corresponds to all the known entries in the calendar at that instant in time.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntriesSetEvent.html' target = '_blank'>CalendarEntriesSetEvent</a></code> object.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/index.htm#gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>.
*/
public static BBjNumber ON_CALENDAR_ENTRIES_SET() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has clicked on a calendar's event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryClickEvent.html' target = '_blank'>CalendarEntryClickEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_CLICK() { }
/**
 * <p>
 * <b>Note</b>: If you set a callback for this event, then add several events to the calendar, your callback routine may be flooded.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryAddEvent.html' target = '_blank'>CalendarEntryAddEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_ADD() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar's event data has changed in any way.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryChangeEvent.html' target = '_blank'>CalendarEntryChangeEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_CHANGE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar's event data has changed in any way.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryRemoveEvent.html' target = '_blank'>CalendarEntryRemoveEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_REMOVE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user moved the mouse into the bounds of a calendar event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryMouseEnterEvent.html' target = '_blank'>CalendarEntryMouseEnterEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_MOUSE_ENTER() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user moved the mouse out of the bounds of a calendar event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryMouseLeaveEvent.html' target = '_blank'>CalendarEntryMouseLeaveEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_MOUSE_LEAVE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has started resizing an event by dragging one of its edges.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryEvent.html' target = '_blank'>CalendarEntryEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_RESIZE_START() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has stopped resizing an event. This event will be triggered after the user resizes an event by dragging one of its
 * edges, even if the event doesn't change in duration. It is also triggered <b>before</b> the <code>ON_CALENDAR_ENTRY_RESIZE()</code> event is triggered.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryEvent.html' target = '_blank'>CalendarEntryEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_RESIZE_STOP() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has stopped resizing an event by dragging one of its edges and the event now has a different duration.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryResizeEvent.html' target = '_blank'>CalendarEntryResizeEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_RESIZE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has started dragging an entry. In other words, the user has started to reposition the entire entry in the calendar
 * as opposed to resizing the entry by dragging one of its edges.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryEvent.html' target = '_blank'>CalendarEntryEvent</a></code> object.
 * Note that both the <code>ON_CALENDAR_ENTRY_DRAG_START()</code> and <code>ON_CALENDAR_ENTRY_DRAG_STOP()</code> events result in a <code>CalendarEntryEvent</code> object, but
 * the native HTML element object associated with the event will be empty.
*/
public static BBjNumber ON_CALENDAR_ENTRY_DRAG_START() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has stopped dragging an entry. In other words, the user has repositioned the entire entry in the calendar
 * as opposed to resizing the entry by dragging one of its edges. This event is triggered after the user drags an entry, even if the entry doesn't
 * change its date/time. It is triggered <b>before</b> the entry's information has been modified (if moved to a new date/time) and before the
 * <code>ON_CALENDAR_ENTRY_DROP</code> callback is triggered. Because the event occurs before the entry has been modified, the entry will be
 * the same as the <code>ON_CALENDAR_ENTRY_DRAG_START</code> event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryEvent.html' target = '_blank'>CalendarEntryEvent</a></code> object.
 * Note that both the <code>ON_CALENDAR_ENTRY_DRAG_START()</code> and <code>ON_CALENDAR_ENTRY_DRAG_STOP()</code> events result in a <code>CalendarEntryEvent</code> object, but
 * the native HTML element object associated with the event will be empty.
*/
public static BBjNumber ON_CALENDAR_ENTRY_DRAG_STOP() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code>
 * method that signals that the user has finished dragging and dropping the entry to a different day/time. In other words, the user has repositioned the entire entry in the calendar
 * as opposed to resizing the entry by dragging one of its edges.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryDropEvent.html' target = '_blank'>CalendarEntryDropEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_DROP() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar has received an external draggable element with event data from another source or another calendar.
 * <p>
 * <b>Note</b>: This event has not yet been implemented.
*/
public static BBjNumber ON_CALENDAR_ENTRY_RECEIVE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user is about to drop one of the calendar events on to another calendar.
 * <p>
 * <b>Note</b>: This event has not yet been implemented.
*/
public static BBjNumber ON_CALENDAR_ENTRY_LEAVE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user dropped an external draggable element or an event from another calendar onto this calendar.
 * <p>
 * <b>Note</b>: This event has not yet been implemented.
*/
public static BBjNumber ON_CALENDAR_DROP() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar's date range has changed in any way.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarDatesSetEvent.html' target = '_blank'>CalendarDatesSetEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_DATES_SET() { }
/**
 * <p>
 * Note that ON_CALENDAR_DATE_CLICK event is not fired when the user clicks a day heading in a list view.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarDateClickEvent.html' target = '_blank'>CalendarDateClickEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_DATE_CLICK() { }
/**
 * <p>
 * <b>Note</b>: You must configure the calendar to enable user selections via the <code>CalendarOptions:setEnableSelectable()</code> method
 * if you intend to set a callback for the <code>BBjCalendarWidget:ON_CALENDAR_SELECT</code> or <code>BBjCalendarWidget:ON_CALENDAR_UNSELECT</code> events.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarSelectEvent.html' target = '_blank'>CalendarSelectEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_SELECT() { }
/**
 * <p>
 * <b>Note</b>: You must configure the calendar to enable user selections via the <code>CalendarOptions:setEnableSelectable()</code> method
 * if you intend to set a callback for the <code>BBjCalendarWidget:ON_CALENDAR_SELECT</code> or <code>BBjCalendarWidget:ON_CALENDAR_UNSELECT</code> events.
 * <p>
 * A selection might be cleared for a number of reasons:
 * <ul>
 * <li>The user clicks away from the current selection (doesn't happen when EnableUnselectAuto is false).</li>
 * <li>The user makes a new selection. The unselect callback will be fired before the new selection occurs.</li>
 * <li>The user moves forward or backward in the current view, or switches to a new view.</li>
 * <li>The unselect method is called through the API.</li>
 * </ul>
 * <p>
 * The <code>CalendarOptions::setEnableUnselectAuto()</code> impacts what causes the <code>BBjCalendarWidget.ON_CALENDAR_UNSELECT</code> event to be fired.
 * If automatic unselection is enabled, then the unselection event will typically be fired after the user releases their selection mouse button.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarUnselectEvent.html' target = '_blank'>CalendarUnselectEvent</a></code>.
*/
public static BBjNumber ON_CALENDAR_UNSELECT() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that fetching a <code>CalendarEntrySource</code> succeeded.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code>??? - TBD</code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_SOURCE_SUCCESS() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that fetching a <code>CalendarEntrySource</code> failed.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code>??? - TBD</code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_SOURCE_FAILURE() { }
/**
 * @return A BBjString with the dayGridWeek calendar view style.
*/
public static BBjString CALENDAR_VIEW_DAY_GRID_WEEK() { }
/**
 * @return A BBjString with the dayGridMonth calendar view style.
*/
public static BBjString CALENDAR_VIEW_DAY_GRID_MONTH() { }
/**
 * @return A BBjString with the timeGridDay calendar view style.
*/
public static BBjString CALENDAR_VIEW_TIME_GRID_DAY() { }
/**
 * @return A BBjString with the timeGridWeek calendar view style.
*/
public static BBjString CALENDAR_VIEW_TIME_GRID_WEEK() { }
/**
 * @return A BBjString with the listDay calendar view style.
*/
public static BBjString CALENDAR_VIEW_LIST_DAY() { }
/**
 * @return A BBjString with the listWeek calendar view style.
*/
public static BBjString CALENDAR_VIEW_LIST_WEEK() { }
/**
 * @return A BBjString with the listMonth calendar view style.
*/
public static BBjString CALENDAR_VIEW_LIST_MONTH() { }
/**
 * @return A BBjString with the listYear calendar view style.
*/
public static BBjString CALENDAR_VIEW_LIST_YEAR() { }
/** A constant value that's used with the <code>CalendarOptions::setButtonText()</code> method that uniquely identifies the 'today' toolbar button . */

public static BBjString CALENDAR_TOOLBAR_BUTTON_TODAY() { }
/** A constant value that's used with the <code>CalendarOptions::setButtonText()</code> method that uniquely identifies the 'month' toolbar button . */

public static BBjString CALENDAR_TOOLBAR_BUTTON_MONTH() { }
/** A constant value that's used with the <code>CalendarOptions::setButtonText()</code> method that uniquely identifies the 'week' toolbar button . */

public static BBjString CALENDAR_TOOLBAR_BUTTON_WEEK() { }
/** A constant value that's used with the <code>CalendarOptions::setButtonText()</code> method that uniquely identifies the 'day' toolbar button . */

public static BBjString CALENDAR_TOOLBAR_BUTTON_DAY() { }
/** A constant value that's used with the <code>CalendarOptions::setButtonText()</code> method that uniquely identifies the 'list' toolbar button . */

public static BBjString CALENDAR_TOOLBAR_BUTTON_LIST() { }
/** A constant value that's used with the <code>setPosition()</code> method that indicates that the toolbar should be above the calendar. */

public static BBjString CALENDAR_TOOLBAR_POSITION_TOP() { }
/** A constant value that's used with the <code>setPosition()</code> method that indicates that the toolbar should be below the calendar. */

public static BBjString CALENDAR_TOOLBAR_POSITION_BOTTOM() { }
/** A constant value for the toolbar's title object that contains the current month/week/day. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_TITLE() { }
/** A constant value for the toolbar's today button object that moves the calendar to the current month/week/day. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_TODAY() { }
/** A constant value for the toolbar's previous button object that's used for moving the calendar back one month/week/day. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_PREV() { }
/** A constant value for the toolbar's next button object that's used for moving the calendar forward one month/week/day. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_NEXT() { }
/** A constant value for the toolbar's previous year button object that's used for moving the calendar back one year. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_PREV_YEAR() { }
/** A constant value for the toolbar's next year button object that's used for moving the calendar forward one year. */

public static BBjString CALENDAR_TOOLBAR_OBJECT_NEXT_YEAR() { }
/** A constant value that's used with the <code>CalendarToolbarSection</code> constructor that indicates the starting, or left, section of the toolbar to be defined. */

public static BBjString CALENDAR_TOOLBAR_ALIGNMENT_START() { }
/** A constant value that's used with the <code>CalendarToolbarSection</code> constructor that indicates the center section of the toolbar to be defined. */

public static BBjString CALENDAR_TOOLBAR_ALIGNMENT_CENTER() { }
/** A constant value that's used with the <code>CalendarToolbarSection</code> constructor that indicates the ending, or right, section of the toolbar to be defined. */

public static BBjString CALENDAR_TOOLBAR_ALIGNMENT_END() { }
/**
 * <p>
 * When in daygrid view, it renders the entry as a solid rectangle if it is all-day or multi-day.
 * If it's a timed entry, it renders the entry as a colored a dot. When in other views, the entry will render normally.
 * @return A BBjString with the 'auto' display style which is the default.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_AUTO() { }
/**
 * <p>
 * When in daygrid view, it renders the entry as a solid rectangle.
 * When in other views, the entry will render normally.
 * @return A BBjString with the 'auto' display style which is the default.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_BLOCK() { }
/**
 * <p>
 * When in daygrid view, it renders the entry as a colored dot.
 * When in other views, the entry will render normally.
 * @return A BBjString with the 'auto' display style which is the default.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_LIST_ITEM() { }
/**
 * <p>
 * This modifies the background of the entry's date/time frame in the calendar.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_BACKGROUND() { }
/**
 * <p>
 * This inversely modifies the background of the entry's date/time frame in the calendar.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_INVERSE_BACKGROUND() { }
/**
 * <p>
 * This hides the entry on the calendar.
*/
public static BBjString CALENDAR_ENTRY_DISPLAY_NONE() { }
/**
 * Creates a <code>BBjCalendarWidget</code> given a BBjWindow where the widget takes up the full size of the window.
 *
 * @param wnd! The BBjWindow that will contain the calendar.
*/
public static BBjCalendarWidget createBBjCalendarWidget(BBjWindow wnd!) { }
/**
 * Creates a <code>BBjCalendarWidget</code> given a BBjWindow where the widget takes up the full size of the window.
 *
 * @param wnd! The BBjWindow that will contain the calendar.
 * @param debug! A BBjNumber acting as a boolean that indicates whether the widget should be placed in debug mode or not.
*/
public static BBjCalendarWidget createBBjCalendarWidget(BBjWindow wnd!, BBjNumber debug!) { }
/**
 * Creates a <code>BBjCalendarWidget</code> given a BBjWindow and control ID, and the calendar's size and position.
 *
 * @param wnd! The BBjWindow that will contain the calendar.
 * @param id The unique control ID that will be used for the widget, usually wnd!.getAvailableControlID().
 * @param x The x-position of the widget.
 * @param y The y-position of the widget.
 * @param w The width of the widget.
 * @param h The height of the widget.
*/
public static BBjCalendarWidget createBBjCalendarWidget(BBjWindow wnd!, BBjNumber id!, BBjNumber x!, BBjNumber y!, BBjNumber w!, BBjNumber h!) { }
/**
 * Creates a <code>BBjCalendarWidget</code> given a BBjWindow and control ID, the calendar's size and position, and a <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> object.
 *
 * @param wnd! The BBjWindow that will contain the calendar.
 * @param id The unique control ID that will be used for the widget, usually wnd!.getAvailableControlID().
 * @param x The x-position of the widget.
 * @param y The y-position of the widget.
 * @param w The width of the widget.
 * @param h The height of the widget.
 * @param options! The initial configuration for the calendar, which is determined by passing in an existing <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> object or null() for defaults.
*/
public static BBjCalendarWidget createBBjCalendarWidget(BBjWindow wnd!, BBjNumber id!, BBjNumber x!, BBjNumber y!, BBjNumber w!, BBjNumber h!, CalendarOptions options!) { }
/**
 * Creates a <code>BBjCalendarWidget</code> given a BBjWindow and control ID, size and position information, a calendar configuration, initial HTML template for the calendar, and a debug flag.
 * <p>
 * If you choose to provide your own HTML template, you may want to base it off of the default index.html file that can be found in the BBjCalendarWidget's <code>lib/basis</code> directory.
 *
 * @param wnd! The BBjWindow that will contain the calendar.
 * @param id The unique control ID that will be used for the widget, usually wnd!.getAvailableControlID().
 * @param x The x-position of the widget.
 * @param y The y-position of the widget.
 * @param w The width of the widget.
 * @param h The height of the widget.
 * @param options! The initial configuration for the calendar, which is determined by passing in an existing <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> object or null() for defaults.
 * @param template! The client's HTML template to use in order to build the calendar. You probably won't ever have to specify this, but it's possible if you wish to override the default HTML for the widget's BBjHtmlView. Specifying null() or an empty string causes the plug-in to use the default template.
 * @param debug! A BBjNumber acting as a boolean that indicates whether the widget should be placed in debug mode or not.
*/
public static BBjCalendarWidget createBBjCalendarWidget(BBjWindow wnd!, BBjNumber id!, BBjNumber x!, BBjNumber y!, BBjNumber w!, BBjNumber h!, CalendarOptions options!, BBjString template!, BBjNumber debug!) { }
/**
 * Creates a <code>CalendarView</code> object given a view type. The provided view type should be one of the constants such as <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code>, <code>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</code>, etc.
 *
 * @param BBjString type! One of the view type constants such as <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code>, <code>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</code>, etc.
 *
 * @return CalendarView A CalendarView object.
*/
public static CalendarView createCalendarView(BBjString type!) { }
/**
 * Creates a <code>CalendarView</code> given a JsonObject representation of the view object.
 *
 * @param JsonObject json! A JsonObject representation of the <code>CalendarView</code>.
 *
 * @return CalendarView A CalendarView object.
*/
public static CalendarView createCalendarView(JsonObject json!) { }
/**
 * Creates an instance of the <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> class with default values.
*/
public static CalendarOptions createCalendarOptions() { }
/**
 * Creates a <code>CalendarToolbar</code> using the default toolbar position of <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code>.
 *
 * @return CalendarToolbar A <code>CalendarToolbar</code> object.
*/
public static CalendarToolbar createCalendarToolbar() { }
/**
 * Creates a <code>CalendarToolbar</code> given the desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code>.
 *
 * @param BBjString position! The desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code>.
 *
 * @return CalendarToolbar A <code>CalendarToolbar</code> object.
*/
public static CalendarToolbar createCalendarToolbar(BBjString position!) { }
/**
 * Creates a <code>CalendarToolbar</code> given the desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code>.
 *
 * @param BBjString position! The desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code>.
 * @param CalendarToolbarSection startSection! A previously-defined <code>CalendarToolbarSection</code> object for the start position in the toolbar.
 * @param CalendarToolbarSection centerSection! A previously-defined <code>CalendarToolbarSection</code> object for the center position in the toolbar.
 * @param CalendarToolbarSection endSection! A previously-defined <code>CalendarToolbarSection</code> object for the end position in the toolbar.
 *
 * @return CalendarToolbar A <code>CalendarToolbar</code> object.
*/
public static CalendarToolbar createCalendarToolbar(BBjString position!, CalendarToolbarSection startSection!, CalendarToolbarSection centerSection!, CalendarToolbarSection endSection!) { }
/**
 * Creates a <code>CalendarToolbar</code> given the desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or
 * <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code> along with comma-delimited string representations of the start, center, and end sections.
 *
 * @param BBjString position! The desired toolbar position, e.g. <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_TOP()</code> or <code>CalendarAPI.CALENDAR_TOOLBAR_POSITION_BOTTOM()</code>.
 * @param BBjString startSection! A comma-delimited string representation of the start section of the toolbar.
 * @param BBjString centerSection! A comma-delimited string representation of the center section of the toolbar.
 * @param BBjString endSection! A comma-delimited string representation of the end section of the toolbar.
 *
 * @return CalendarToolbar A <code>CalendarToolbar</code> object.
*/
public static CalendarToolbar createCalendarToolbar(BBjString position!, BBjString startSection!, BBjString centerSection!, BBjString endSection!) { }
/**
 * Creates a <code>CalendarToolbarSection</code>. There are three possible alignments, or positions, for the section that include:
 * <ul>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_START()</code> - The left-most section of the toolbar.</li>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_CENTER()</code> - The center section of the toolbar.</li>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_END()</code> - The right-most section of the toolbar.</li>
 * </ul>
 *
 * @param BBjString alignment! The component's alignment which may be one of the following string values: "start", "center", or "end".
*/
public static CalendarToolbarSection createCalendarToolbarSection(BBjString alignment!) { }
/**
 * Creates a <code>CalendarToolbarSection</code> that takes an alignment and a set of options that would normally be set via the setObjects() method.
 * There are three possible alignments, or positions, for the section that include:
 * <ul>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_START()</code> - The left-most section of the toolbar.</li>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_CENTER()</code> - The center section of the toolbar.</li>
 * <li><code>CalendarAPI.CALENDAR_TOOLBAR_ALIGNMENT_END()</code> - The right-most section of the toolbar.</li>
 * </ul>
 *
 * @param BBjString alignment! The component's alignment which may be one of the following string values: "start", "center", or "end".
 * @param BBjString objects! A comma-separated list of objects to include in the section, like <code>CalendarAPI.CALENDAR_TOOLBAR_OBJECT_*</code>.
*/
public static CalendarToolbarSection createCalendarToolbarSection(BBjString alignment!, BBjString objects!) { }
/**
 * Creates a <code>CalendarEntry</code> given a JsonObject representation of the <code>CalendarEntry</code> object.
*/
public static CalendarEntry createCalendarEntry(JsonObject json!) { }
/**
 * Creates a <code>CalendarEntry</code> given an entry title and starting date/time string.
 *
 * @param BBjString title! The entry's title.
 * @param BBjString start! The entry's starting date/time in an ISO 8601 date/time format.
 *
 * @see <a href = 'https://www.w3.org/TR/NOTE-datetime' target = '_blank'>Date and Time Formats</a> for information on ISO 8601 date/time formats.
*/
public static CalendarEntry createCalendarEntry(BBjString title!, BBjString start!) { }
/**
 * Creates a <code>CalendarEntry</code> given an entry title, starting date/time string, and ending date/time string.
 *
 * @param BBjString title! The entry's title.
 * @param BBjString start! The entry's starting date/time in an ISO 8601 date/time format.
 * @param BBjString end! The entry's ending date/time in an ISO 8601 date/time format.
 *
 * @see <a href = 'https://www.w3.org/TR/NOTE-datetime' target = '_blank'>Date and Time Formats</a> for information on ISO 8601 date/time formats.
*/
public static CalendarEntry createCalendarEntry(BBjString title!, BBjString start!, BBjString end!) { }
/**
 * Creates a <code>CalendarEntrySource</code> with default values.
*/
public static CalendarEntrySource createCalendarEntrySource() { }
/**
 * Creates a <code>CalendarEntrySource</code> given a unique ID that identifes the entry source
 * for later use, such as with the <code>BBjCalendarWidget::getEntrySourceById()</code> method,
 * and a URL to access the feed.
 *
 * @param BBjString id! A string that identifies the source so that it can be uniquely identified and used in other method calls.
 * @param BBjString url! A BBjString filled with the URL for the entry source.
*/
public static CalendarEntrySource createCalendarEntrySource(BBjString id!, BBjString url!) { }
/**
 * Creates a <code>CalendarEntrySource</code> given a unique ID that identifes the entry source
 * for later use, such as with the <code>BBjCalendarWidget::getEntrySourceById()</code> method, along with the URL and
 * colors for the source's entries.
 * <p>
 * <b>Note</b>: Colors may be specified as any valid CSS color, so <code>"red"</code>, <code>"rgb(255, 0, 0)"</code>, <code>"#ff0000"</code>, <code>"#f00"</code>, <code>"hsl(0, 100%, 50%)"</code>, and all the versions of those formats that include an alpha channel are valid ways of specifying the color red.
 * <p>
 * <b>Note</b>: You may pass in a <code>null()</code> or empty string for any of the colors as a way to indicate that the default entry color should be used for this source.
 *
 * @param BBjString id! A string that identifies the source so that it can be uniquely identified and used in other method calls. If null(), it will be auto-generated and you can retrieve the id by calling the <code>getId()</code> method on the source.
 * @param BBjString url! A BBjString filled with the URL for the entry source.
 * @param BBjString backgroundColor! The background color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString borderColor! The border color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString textColor! The text color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
*/
public static CalendarEntrySource createCalendarEntrySource(BBjString id!, BBjString url!, BBjString backgroundColor!, BBjString borderColor!, BBjString textColor!) { }
/**
 * Contructs a <code>CalendarEntrySourceGoogle</code> object for the provided Google Calendar ID.
 *
 * @param BBjString calendarId! The "Calendar ID" string from the settings page for that specific public Google calendar, e.g. "abcd1234@group.calendar.google.com". This ID is specific to the desired Google calendar and is different from the source's ID.
 *
 * @see <a href = 'https://fullcalendar.io/docs/google-calendar' target = '_blank'>https://fullcalendar.io/docs/google-calendar</a> for information on FullCalendar integration with Google calendars
 * @see <a href = 'https://console.developers.google.com/' target = '_blank'>Google Developer Console</a> for information on creating Goolge developer API keys
*/
public static CalendarEntrySourceGoogle createCalendarEntrySourceGoogle(BBjString id!, BBjString calendarId!) { }
/**
 * Creates a <code>CalendarEntrySourceGoogle</code> object for the provided Google Calendar ID specifying a color scheme for the source's entries.
 * <p>
 * <b>Note</b>: In order to access public Google calendars programmatically, you need to
 * sign up for a developer's account and generate an API key. See the <code>CalendarOptions::setGoogleCalendarApiKey()</code>
 * method for documentation links and setting the API key.
 * <p>
 * <b>Note</b>: Colors may be specified as any valid CSS color, so <code>"red"</code>, <code>"rgb(255, 0, 0)"</code>, <code>"#ff0000"</code>, <code>"#f00"</code>, <code>"hsl(0, 100%, 50%)"</code>, and all the versions of those formats that include an alpha channel are valid ways of specifying the color red.
 * <p>
 * <b>Note</b>: You may pass in a <code>null()</code> or empty string for any of the colors as a way to indicate that the default entry color should be used for this source.
 *
 * @param BBjString id! A string that identifies the source so that it can be uniquely identified and used in other method calls. If null(), it will be auto-generated and you can retrieve the id by calling the <code>getId()</code> method on the source.
 * @param BBjString calendarId! The "Calendar ID" string from the settings page for the specific public Google calendar, e.g. "abcd1234@group.calendar.google.com".
 * @param BBjString backgroundColor! The background color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString borderColor! The border color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString textColor! The text color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 *
 * @see <a href = 'https://fullcalendar.io/docs/google-calendar' target = '_blank'>https://fullcalendar.io/docs/google-calendar</a> for information on FullCalendar integration with Google calendars
 * @see <a href = 'https://console.developers.google.com/' target = '_blank'>Google Developer Console</a> for information on creating Goolge developer API keys
*/
public static CalendarEntrySourceGoogle createCalendarEntrySourceGoogle(BBjString id!, BBjString calendarId!, BBjString backgroundColor!, BBjString borderColor!, BBjString textColor!) { }
/**
 * Creates a <code>CalendarEntrySourceiCalendar</code> for an iCalendar feed given a unique ID that identifes the entry source
 * for later use, such as with the <code>BBjCalendarWidget::getEntrySourceById()</code> method,
 * and a URL to access the feed.
 *
 * @param BBjString id! A string that identifies the source so that it can be uniquely identified and used in other method calls. If null(), it will be auto-generated and you can retrieve the id by calling the <code>getId()</code> method on the source.
 * @param BBjString url! A BBjString filled with the URL for the iCalendar feed.
 *
 * @see <a href = 'https://fullcalendar.io/docs/google-calendar' target = '_blank'>https://fullcalendar.io/docs/google-calendar</a> for information on FullCalendar integration with Google calendars
 * @see <a href = 'https://icalendar.org/' target = '_blank'>https://icalendar.org/</a> for information on the iCalendar specification
*/
public static CalendarEntrySourceiCalendar createCalendarEntrySourceiCalendar(BBjString id!, BBjString url!) { }
/**
 * Creates a <code>CalendarEntrySourceiCalendar</code> for an iCalendar feed given a unique ID that identifes the entry source
 * for later use, such as with the <code>BBjCalendarWidget::getEntrySourceById()</code> method,
 * a URL to access the feed, and a color scheme for the source's entries.
 *
 * <p>
 * <b>Note</b>: Colors may be specified as any valid CSS color, so <code>"red"</code>, <code>"rgb(255, 0, 0)"</code>, <code>"#ff0000"</code>, <code>"#f00"</code>, <code>"hsl(0, 100%, 50%)"</code>, and all the versions of those formats that include an alpha channel are valid ways of specifying the color red.
 * <p>
 * <b>Note</b>: You may pass in a <code>null()</code> or empty string for any of the colors as a way to indicate that the default entry color should be used for this source.
 *
 * @param BBjString id! A string that identifies the source so that it can be uniquely identified and used in other method calls. If null(), it will be auto-generated and you can retrieve the id by calling the <code>getId()</code> method on the source.
 * @param BBjString url! A BBjString filled with the URL for the iCalendar feed.
 * @param BBjString backgroundColor! The background color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString borderColor! The border color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 * @param BBjString textColor! The text color for the source's entries, or <code>null()</code> or an empty string to indicate that the default entry color should be used.
 *
 * @see <a href = 'https://fullcalendar.io/docs/google-calendar' target = '_blank'>https://fullcalendar.io/docs/google-calendar</a> for information on FullCalendar integration with Google calendars
 * @see <a href = 'https://icalendar.org/' target = '_blank'>https://icalendar.org/</a> for information on the iCalendar specification
*/
public static CalendarEntrySourceiCalendar createCalendarEntrySourceiCalendar(BBjString id!, BBjString url!, BBjString backgroundColor!, BBjString borderColor!, BBjString textColor!) { }
/**
 * Returns a BBjVector filled with all possible calendar view type constants such as <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code>, <code>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</code>, etc.
 *
 * @return BBjVector A BBjVector filled with all possible calendar view type constants such as <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</code>, <code>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</code>, etc.
*/
public static BBjVector getAllViewTypes() { }
/**
 * Returns a formatted, or pretty-printed version of the supplied JSON object sorted alphabetically by key.
 *
 * @param JsonObject json! The JSON object to be formatted.
 * @return BBjString A BBjString that is a string representation of the supplied JSON object after it has been formatted, or an empty string if the provided JsonObject was null().
*/
public static BBjString getJsonObjectAsFormattedString(JsonObject json!) { }
/**
 * Returns a JSON array version of the supplied BBjVector.
 *
 * @param BBjVector vector! The BBjVector to be converted to a JSON array.
 * @return JsonArray A JSON array version of the supplied BBjVector.
*/
public static JsonArray getBBjVectorAsJsonArray(BBjVector vector!) { }
/**
 * Returns a BBjVector version of the supplied JSON array.
 *
 * @param JsonArray array! The JSON array to be converted to a BBjVector.
 * @return BBjVector A BBjVector version of the supplied JSON array.
*/
public static BBjVector getJsonArrayAsBBjVector(JsonArray array!) { }
/**
 * <b>DEPRECATED</b> Returns a formatted date string if the provided date string can be parsed into a valid date, or null() if the date string is invalid.
 *
 * @param BBjString dateString! A string that contains a date representation.
 *
 * @return BBjString A formatted date representation of the provided date string, or null() if the date string cannot be parsed into an ISO formatted date.
 *
 * @deprecated Deprecated in BBj 22.00 because Java <a href = 'https://openjdk.java.net/jeps/372' target = '_blank'>removed</a> the Nashorn JavaScript engine in Java 15. Therefore, this static method has moved to the BBjCalendarWidget class because the BBjHtmlView control used by the BBjCalendarWidget can execute JavaScript in a non-static context. Please use the <code><a href = 'BBjCalendarWidget.html#getValidDateString' target = '_blank'>BBjCalendarWidget::getValidDateString()</a></code> method instead.
*/
public static BBjString getValidDateString(BBjString dateString!) { }
/**
 * <b>DEPRECATED</b> Returns a formatted time string if the provided time string can be parsed into a valid time, or null() if the time string is invalid.
 *
 * @param BBjString timeString! A string that contains a time representation.
 *
 * @return BBjString A formatted time representation of the provided time string, or null() if the time string cannot be parsed into an ISO formatted time.
 *
 * @deprecated Deprecated in BBj 22.00 because Java <a href = 'https://openjdk.java.net/jeps/372' target = '_blank'>removed</a> the Nashorn JavaScript engine in Java 15. Therefore, this static method has moved to the BBjCalendarWidget class because the BBjHtmlView control used by the BBjCalendarWidget can execute JavaScript in a non-static context. Please use the <code><a href = 'BBjCalendarWidget.html#getValidTimeString' target = '_blank'>BBjCalendarWidget::getValidTimeString()</a></code> method instead.
*/
public static BBjString getValidTimeString(BBjString timeString!) { }
/**
 * <b>DEPRECATED</b> Returns an ISO 8601 formatted date/time string if the provided date/time string can be parsed into a valid date, or null() if the date string is invalid.
 *
 * @param BBjString dateTimeString! A string that contains a date/time representation.
 *
 * @return BBjString An ISO 8601 formatted date representation of the provided date string, or null() if the date string cannot be parsed into an ISO formatted date/time string.
 *
 * @deprecated Deprecated in BBj 22.00 because Java <a href = 'https://openjdk.java.net/jeps/372' target = '_blank'>removed</a> the Nashorn JavaScript engine in Java 15. Therefore, this static method has moved to the BBjCalendarWidget class because the BBjHtmlView control used by the BBjCalendarWidget can execute JavaScript in a non-static context. Please use the <code><a href = 'BBjCalendarWidget.html#getValidDateTimeString' target = '_blank'>BBjCalendarWidget::getValidDateTimeString()</a></code> method instead.
*/
public static BBjString getValidDateTimeString(BBjString dateTimeString!) { }
/**
 * <b>DEPRECATED</b> Returns the difference between the client's local time and UTC in minutes. For example, if your time zone is
 * UTC+10, then -600 will be returned because UTC is 600 minutes behind the local time zone. Another way to view
 * it is that the return value is the number of minutes that should be added to the local time in order to find
 * UTC. Note that daylight savings time prevents this value from being a constant.
 *
 * @return BBjNumber The number of minutes needed to add to the local time to result in UTC.
 *
 * @deprecated Deprecated in BBj 22.00 because Java <a href = 'https://openjdk.java.net/jeps/372' target = '_blank'>removed</a> the Nashorn JavaScript engine in Java 15. Therefore, this static method has moved to the BBjCalendarWidget class because the BBjHtmlView control used by the BBjCalendarWidget can execute JavaScript in a non-static context. Please use the <code><a href = 'BBjCalendarWidget.html#getLocalTimeZoneOffsetFromUtc' target = '_blank'>BBjCalendarWidget::getLocalTimeZoneOffsetFromUtc()</a></code> method instead.
*/
public static BBjNumber getLocalTimeZoneOffsetFromUtc() { }
}