{
    "title": "Input Data",
    "description": "A date/time range picker filter widget using Flatpickr calendar. Use this widget to allow users to select date ranges for filtering dashboard data. Supports single date selection (configure only startKey or endKey) or date range selection (configure both). The selected timestamps are stored as URL parameters and can be referenced by other widgets' data queries. Ideal for time-series dashboards, historical data analysis, and report generation with customizable time windows.",
    "type": "object",
    "properties": {
        "label": {
            "title": "Label",
            "description": "The text label displayed on the calendar input field. Use descriptive text like 'Select Date Range' or 'Filter Period' to guide users.",
            "order": 1,
            "dataDrivenDisabled": true,
            "type": "string"
        },
        "startKey": {
            "title": "Time Range Start Key",
            "order": 2,
            "dataDrivenDisabled": true,
            "description": "The URL parameter key for the start timestamp (e.g., 'startTime', 'from'). Other widgets can reference this parameter in their data filter configurations to filter data from this date. Leave empty for single-date mode using only endKey.",
            "type": "string"
        },
        "endKey": {
            "title": "Time Range End Key",
            "order": 3,
            "dataDrivenDisabled": true,
            "description": "The URL parameter key for the end timestamp (e.g., 'endTime', 'to'). Other widgets can reference this parameter in their data filter configurations to filter data until this date. Leave empty for single-date mode using only startKey.",
            "type": "string"
        },
        "numMonths": {
            "title": "Number of Months to Display",
            "order": 4,
            "dataDrivenDisabled": true,
            "description": "How many calendar months to show simultaneously in the picker (1-3). Use 2 for date range selection to easily see start and end months. Use 1 for compact layouts or single date selection.",
            "type": "number"
        }
    }
}