@spec build_aggregated_vcalendar(
  [String.t()],
  %{optional(String.t()) => String.t()},
  String.t() | nil
) :: String.t()

Build complete VCALENDAR with all components and VTIMEZONEs.

Creates a fully-formed VCALENDAR object containing:

• Standard VCALENDAR headers (VERSION, PRODID)
• Optional X-WR-CALNAME for calendar display name (Apple/Mozilla extension)
• All VTIMEZONE components (deduplicated by timezone ID)
• All calendar components (VEVENT, VTODO, etc.)

parameters

Parameters

• components - List of calendar component strings (VEVENT, VTODO, etc.)
• vtimezones - Map of timezone ID to VTIMEZONE component strings
• displayname - Optional calendar display name (default: nil)

returns

Returns

A complete VCALENDAR string with proper CRLF line endings.

examples

Examples

iex> components = ["BEGIN:VEVENT\nUID:123\n...\nEND:VEVENT"]
iex> vtimezones = %{"America/New_York" => "BEGIN:VTIMEZONE\n...\nEND:VTIMEZONE"}
iex> build_aggregated_vcalendar(components, vtimezones, "My Calendar")
"BEGIN:VCALENDAR\r\n..."

@spec create_vcalendar(String.t(), String.t()) :: String.t()

Creates a VCALENDAR object.

@spec create_vevent(
  String.t(),
  DateTime.t(),
  DateTime.t(),
  String.t(),
  String.t(),
  String.t()
) :: String.t()

Creates a new VEVENT object.

@spec create_vtodo(
  String.t(),
  Date.t() | DateTime.t() | String.t(),
  DateTime.t() | String.t(),
  Keyword.t()
) :: String.t()

Creates a new VTODO object.