SETUP 1. Drag the "Smart Date Input" element onto your page and size it like a normal input.
2. (Optional) Set a Placeholder, an Initial value, and toggle "Forward only" in the element's property editor.
3. In a workflow or data field, reference the element's "parsed_date" state to use the resolved date.

SUPPORTED PHRASES
Relative days: today, tomorrow, yesterday, day after tomorrow
Offsets: in N days, in N weeks, in N months, N days ago, N weeks ago
Business days: next business day, in N business days
Weekdays: monday ... sunday, with optional "this", "next", or "last" (e.g. next friday, last monday)
Periods: end of month, end of week, next month, last month, next year, last year
Times: optionally add a time, e.g. "tomorrow at 3pm" or "next friday 09:30"

PROPERTIES
- Placeholder: the greyed-out hint text shown in the empty input.
- Initial value: a phrase parsed automatically when the element loads.
- Forward only: when enabled, ambiguous past weekdays are pushed to the upcoming week.

EXPOSED STATES
- parsed_date (date): the resolved date value. This is the main output.
- is_valid (yes/no): whether the current text was successfully parsed.
- parsed_text (text): a friendly, human-readable version of the date.
- iso_string (text): the date as an ISO 8601 string, useful for APIs.
- matched_pattern (text): which rule matched, helpful for debugging.

EVENTS
- Date parsed: fires whenever a valid date is recognized. Use it to run a workflow with the new value.
- Parse failed: fires when the text cannot be understood. Use it to show a hint or clear a field.

TIP
Parsing runs as the user types. Bind "is_valid" to a conditional to show validation feedback in your own UI.