icalendar 2.10.1 → 2.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b9f7e30ef6614ad4175a9d282d1b03b57f140f98a2962b4e0268aa015f8f942
-  data.tar.gz: 7ebabfddd0f3d8e8e05e1ef82d2389007c1419c727c5404d2ec2c1c09565a8bb
+  metadata.gz: ad06e861392ab70f0e800ac4f2a6b81f019aaf3548a35e513f02bcc975968b86
+  data.tar.gz: 16562bdeae817fc8afd4e0b6de7090a42c0b095cb56640d5b9183cfb3a07bb74
 SHA512:
-  metadata.gz: 8d3221e4e5bd2120014ae11fe80a8e0a3b36af37b10aadd18f3bc6022e296efa47ea27d09572900bb6d6419fff64054caa6709e6b14e5182d32a188d0130b7f0
-  data.tar.gz: 5d7d996d53a12543de0830fdb8214e2ae39df4c19c649e81cd95ceb8d30d61f1f178b7a9a4f4e37adb591609eeac7e89d930cf5ffc24951c9cbfcb0b815c2a03
+  metadata.gz: 927cd1536b413039b75f4c2a100ca169bb17897c10754b4806762d341aaa4b7800fc93e7bc81566681a678a853fefc0d54fad5fdd0316c10f0245f91864d2faf
+  data.tar.gz: 5d9c09347062a5dd73ad23cd75905c5508b8a72ce0447241ee282fa6bbcc7d259e4a26309fc90af718f14f14b18ca78403bc849898b42147c5368ae6edb21d13

data/.github/workflows/main.yml

@@ -15,11 +15,13 @@ jobs:
     runs-on: ubuntu-latest
 
     strategy:
+      fail-fast: false
       matrix:
         ruby:
-          - 3.0.6
-          - 3.1.4
-          - 3.2.2
+          - 3.1
+          - 3.2
+          - 3.3
+          - 3.4
 
     steps:
     - uses: actions/checkout@v4

data/CHANGELOG.md

@@ -0,0 +1,231 @@
+## Unreleased
+
+## 2.12.2 - 2026-03-21
+- Fix a potential property injection issue through escaping control characters in URI values - Wes Ring
+
+## 2.12.1 - 2025-10-19
+- Fix a problem with invalid ics generation for calendars with custom properties that include a `tzid` parameter.
+
+## 2.12.0 - 2025-09-26
+- Support timezone lookup by Windows names - Ronak Gothi
+
+## 2.11.2 - 2025-06-21
+- Deal with more bad value parameter values by falling back to the property default type
+
+## 2.11.1 - 2025-06-06
+ - Gracefully deal with malformed ics files that use spaces in the value parameter instead of hyphens
+
+## 2.11.0 - 2025-04-12
+ - Require gems for ruby 3.4 that used to be in stdlib - Go Sueyoshi
+ - Refactor how timezone offsets are calculated - Pat Allan
+    - 'tzid' param is always returned as an array when accessing `ical_params` directly, rather than matching whatever the input parsed. ICS output remains unchanged
+
+## 2.10.3 - 2024-09-21
+ - Override Icalendar::Value.== so that value objects can be compared to each other.
+ - Correctly load activesupport before activesupport/time
+ - Load ostruct to address deprecation warning - aki77
+
+## 2.10.2 - 2024-07-21
+ - Raise Icalendar::Parser::ParseError on bad .ics file input instead of RuntimeError - Micah Geisel
+ - Remove Ruby 3.0 from the test matrix - still should work for now with ice_cube < 0.17.0
+ - Add Ruby 3.3 to the test matrix
+ - Move from old History.txt file to modern CHANGELOG.md - Guillaume Briday
+
+## 2.10.1 - 2023-12-01
+ - Parsing now handles VTIMEZONE blocks defined after their TZID is used in events and other components
+
+## 2.10.0 - 2023-11-01
+ - Add changelog metadata to gemspec - Juri Hahn
+ - Attempt to rescue timezone info when given a nonstandard tzid with no VTIMEZONE
+ - Move Values classes that shouldn't be directly used into Helpers module
+
+## 2.9.0 - 2023-08-11
+ - Always include the VALUE of Event URLs for improved compatibility - Sean Kelley
+ - Improved parse performance - Thomas Cannon
+ - Add helper methods for other Calendar method verbs
+ - bugfix: Require stringio before use in Parser - vwyu
+
+## 2.8.0 - 2022-07-10
+ - Fix compatibility with ActiveSupport 7 - Pat Allan
+ - Set default action of "DISPLAY" on alarms - Rikson
+ - Add license information to gemspec - Robert Reiz
+ - Support RFC7986 properties - Daniele Frisanco
+
+## 2.7.1 - 2021-03-14
+ - Recover from bad line-wrapping code that splits in the middle of Unicode code points
+ - Add a verbose option to the Parser to quiet some of the chattier log entries
+
+## 2.7.0 - 2020-09-12
+ - Handle custom component names, with and without X- prefix
+ - Fix Component lookup to avoid namespace collisions
+
+## 2.6.1 - 2019-12-07
+ - Improve performance when generating large ICS files - Alex Balhatchet
+
+## 2.6.0 - 2019-11-26
+ - Improve performance for calculating timezone offsets - Justin Howard
+ - Make it possible to de/serialize with Marshal - Pawel Niewiadomski
+ - Avoid FrozenError when running with frozen_string_literal
+ - Update minimum Ruby version to supported versions
+
+## 2.5.3 - 2019-03-04
+ - Improve parsing performance - nehresma
+ - Support tzinfo 2.0 - Misty De Meo
+
+## 2.5.2 - 2018-12-08
+ - Remove usage of the global TimezoneStore instance, in favor of a local variable in the parser
+ - Deprecate TimezoneStore class methods
+
+## 2.5.1 - 2018-10-30
+ - Fix usage without ActiveSupport installed.
+
+## 2.5.0 - 2018-09-10
+ - Set timezone information from VTIMEZONE components in cases that ActiveSupport can't figure it out (or isn't installed)
+ - Prevent rewinding the Parser IO input during parsing - Niels Laukens
+ - Update tested/supported ruby versions & documentation updates.
+
+## 2.4.1 - 2016-09-03
+ - Fix parsing multiple calendars or components in same file - Patrick Schnetger
+ - Fix multi-byte folding bug - Niels Laukens
+ - Fix typos across the code - Martin Edenhofer & yuuji.yaginuma
+
+## 2.4.0 - 2016-07-04
+ - Enable parsing individual ICalendar components - Patrick Schnetger
+ - many bug fixes. Thanks to Quan Sun, Garry Shutler, Ryan Bigg, Patrick Schnetger and others
+ - README/documentation updates. Thanks to JonMidhir and Hendrik Sollich
+
+## 2.3.0 - 2015-04-26
+ - fix value parameter for properties with multiple values
+ - fix error when assigning Icalendar::Values::Array to a component
+ - Fall back to Icalendar::Values::Date if Icalendar::Values::DateTime is not given a properly formatted value
+ - Downcase the keys in ical_params to ensure we aren't assigning both tzid and TZID
+
+## 2.2.2 - 2014-12-27
+ - add a `has_#{component}?` method for testing if component exists - John Hope
+ - add documentation & tests for organizer attribute - Ben Walding
+
+## 2.2.1 - 2014-12-03
+ - Prevent crashes when using ActiveSupport::TimeWithZone in multi-property DateTime fields - Danny (tdg5)
+ - Ensure TimeWithZone is loaded before using, not just ActiveSupport - Jeremy Evans
+ - Improve error message on unparseable DateTimes - Garry Shutler
+
+## 2.2.0 - 2014-09-23
+ - Default to non-strict parsing
+ - Enable sorting events by dtstart - Mark Rickert
+ - Better tolerate malformed lines in parser - Garry Shutler
+ - Deduplicate timezone code - Jan Vlnas
+ - Eliminate warnings - rochefort
+
+## 2.1.2 - 2014-09-10
+ - Fix timezone abbreviation generation - Jan Vlnas
+ - Fix timezone repeat rules for end of month
+
+## 2.1.1 - 2014-07-23
+ - Quiet TimeWithZone support logging
+ - Use SecureRandom.uuid - antoinelyset
+
+## 2.1.0 - 2014-06-17
+ - Enable parsing all custom properties, not just X- prefixed ones
+   Requires non-strict parsing
+ - Fixed bugs when using non-MRI ruby interpreters
+ - Fix bug copying OpenStruct-backed value types
+
+## 2.0.1 - 2014-04-27
+ - Re-add support for ruby 1.9.2
+
+## 2.0.0 - 2014-04-22
+ - Add Icalendar.logger class & logging in Parser
+ - Support tzinfo ~> 0.3 and ~> 1.1
+
+## 2.0.0.beta.2 - 2014-04-11
+ - Add uid & acknowledged fields from valarm extensions
+ - Swallow NoMethodError on non-strict parsers
+ - Expose a parse_property method on Icalendar::Parser
+
+## 2.0.0.beta.1 - 2014-03-30
+ - Rewrite for easier development going forward.
+
+## 1.5.2 - 2014-02-22
+ - Output timezone components first
+ - Fix undefined local variable or method 'e' - Jason Stirk
+
+## 1.5.1 - 2014-02-27
+ - Check for dtend existence before setting timezone - Jonas Grau
+ - Clean up and refactor components - Kasper Timm Hansen
+
+## 1.5.0 - 2013-12-06
+ - Support for custom x- properties - Jake Craige
+
+## 1.4.5 - 2013-11-14
+ - Fix Geo accessor methods - bouzuya
+ - Add ical_multiline_property :related_to for Alarm
+ - Allow using multi setters to append single values
+
+## 1.4.4 - 2013-11-05
+ - Allow user to handle TZInfo::AmbiguousTime error - David Bradford
+ - Better handling of multiple exdate and rdate values
+
+## 1.4.3 - 2013-09-18
+ - Fix concatenation of multiple BYWEEK or BYMONTH recurrence rules
+
+## 1.4.2 - 2013-09-11
+ - Double Quote parameter values that contain forbidden characters
+ - Update Component#respond_to? to match Ruby 2.0 - Keith Marcum
+
+## 1.4.1 - 2013-06-25
+ - Don't escape semicolon in GEO property - temirov
+ - Allow access to various parts of RRule class
+
+## 1.4.0 - 2013-05-21
+ - Implement ACKNOWLEDGED property for VALARM - tsuzuki08
+ - Output VERSION property as first line after BEGIN:VCALENDAR
+ - Check for unbounded timezone transitions in tzinfo
+
+## 1.3.0 - 2013-03-31
+ - Lenient parsing mode ignores unknown properties - David Grandinetti
+ - VTIMEZONE positive offsets properly have "+" prepended (Fixed issue
+#18) - Benjamin Jorgensen (sorry for misspelling your last name)
+
+## 1.2.4 - 2013-03-26
+ - Proxy component values now frozen in Ruby 2.0 (Fixed issue #17)
+ - Clean up gemspec for cleaner installing via bundler/git
+
+## 1.2.3 - 2013-03-09
+ - Call `super` from Component#method_missing
+ - Clean up warnings in test suite
+ - Add Gemfile for installing development dependencies
+
+## 1.2.2 - 2013-02-16
+ - added TZURL property to Timezone component - spacepixels
+ - correct days in RRule ("[TU,WE]" -> "TU,WE") - Christoph Finkensiep
+
+## 1.2.1 - 2012-11-12
+ - Adds uid property to alarms to support iCloud - Jeroen Jacobs
+ - Fix up testing docs - Eric Carty-Fickes
+ - Fix parsing property params that have : in them - Sean Dague
+ - Clean up warnings in test suite - Sean Dague
+
+## 1.2.0 - 2012-08-30
+* Fix calendar handling for dates < 1000 - Ryan Ahearn
+* Updated license to GPL/BSD/Ruby at users option
+
+## 1.1.6 - 2011-03-10
+* Fix todo handling (thanks to Frank Schwarz)
+* clean up a number of warnings during test runs
+
+## 1.1.5 - 2010-06-21
+* Fix for windows line endings (thanks to Rowan Collins)
+
+## 1.1.4 - 2010-04-23
+* Fix for RRULE escaping
+* Fix tests so they run under 1.8.7 in multiple environments
+* Readme fix
+
+## 1.1.3 - 2010-03-15
+* Revert component sorting behavior that I was trying to make
+the tests run more consistantly on different platforms.
+* Added new test for multiple events in a calendar which caught that break.
+
+## 1.1.2 - 2010-03-10
+
+* Convert project to newgem to make for easier publishing

data/README.md

@@ -1,7 +1,7 @@
 iCalendar -- Internet calendaring, Ruby style
 ===
 
-[![Build Status](https://travis-ci.com/icalendar/icalendar.svg?branch=master)](https://travis-ci.com/icalendar/icalendar)
+[![Ruby](https://github.com/icalendar/icalendar/actions/workflows/main.yml/badge.svg)](https://github.com/icalendar/icalendar/actions/workflows/main.yml)
 [![Code Climate](https://codeclimate.com/github/icalendar/icalendar.png)](https://codeclimate.com/github/icalendar/icalendar)
 
 <http://github.com/icalendar/icalendar>

data/icalendar.gemspec

@@ -21,7 +21,7 @@ ActiveSupport is required for TimeWithZone support, but not required for general
   EOM
 
   s.metadata = {
-    'changelog_uri' => 'https://github.com/icalendar/icalendar/blob/main/History.txt'
+    'changelog_uri' => 'https://github.com/icalendar/icalendar/blob/main/CHANGELOG.md'
   }
 
   s.files = `git ls-files`.split "\n"
@@ -31,7 +31,10 @@ ActiveSupport is required for TimeWithZone support, but not required for general
 
   s.required_ruby_version = '>= 2.4.0'
 
+  s.add_dependency 'base64'
   s.add_dependency 'ice_cube', '~> 0.16'
+  s.add_dependency 'logger'
+  s.add_dependency 'ostruct'
 
   s.add_development_dependency 'rake', '~> 13.0'
   s.add_development_dependency 'bundler', '~> 2.0'

data/lib/icalendar/downcased_hash.rb

@@ -3,32 +3,65 @@
 require 'delegate'
 
 module Icalendar
-  class DowncasedHash < ::SimpleDelegator
+  class DowncasedHash
 
     def initialize(base)
-      super Hash.new
+      @obj = Hash.new
       base.each do |key, value|
         self[key] = value
       end
     end
 
     def []=(key, value)
-      __getobj__[key.to_s.downcase] = value
+      obj[key.to_s.downcase] = value
     end
 
     def [](key)
-      __getobj__[key.to_s.downcase]
+      obj[key.to_s.downcase]
     end
 
     def has_key?(key)
-      __getobj__.has_key? key.to_s.downcase
+      obj.has_key? key.to_s.downcase
     end
     alias_method :include?, :has_key?
     alias_method :member?, :has_key?
 
     def delete(key, &block)
-      __getobj__.delete key.to_s.downcase, &block
+      obj.delete key.to_s.downcase, &block
     end
+
+    def merge(*other_hashes)
+      Icalendar::DowncasedHash.new(obj).merge!(*other_hashes)
+    end
+
+    def merge!(*other_hashes)
+      other_hashes.each do |hash|
+        hash.each do |key, value|
+          self[key] = value
+        end
+      end
+      self
+    end
+
+    def empty?
+      obj.empty?
+    end
+
+    def each(&block)
+      obj.each &block
+    end
+
+    def map(&block)
+      obj.map &block
+    end
+
+    def ==(other)
+      obj == Icalendar::DowncasedHash(other).obj
+    end
+
+    protected
+
+    attr_reader :obj
   end
 
   def self.DowncasedHash(base)

data/lib/icalendar/offset/active_support_exact.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Icalendar
+  class Offset
+    class ActiveSupportExact < Icalendar::Offset
+      def valid?
+        support_classes_defined? && tz
+      end
+
+      def normalized_value
+        Icalendar.logger.debug("Plan a - parsing #{value}/#{tzid} as ActiveSupport::TimeWithZone")
+        # plan a - use ActiveSupport::TimeWithZone
+        Icalendar::Values::Helpers::ActiveSupportTimeWithZoneAdapter.new(nil, tz, value)
+      end
+
+      private
+
+      def tz
+        @tz ||= ActiveSupport::TimeZone[tzid]
+      end
+    end
+  end
+end

data/lib/icalendar/offset/active_support_partial.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Icalendar
+  class Offset
+    class ActiveSupportPartial < Offset
+      def valid?
+        support_classes_defined? && tz
+      end
+
+      def normalized_value
+        # plan c - try to find an ActiveSupport::TimeWithZone based on the first word of the tzid
+        Icalendar.logger.debug("Plan c - parsing #{value}/#{tz.tzinfo.name} as ActiveSupport::TimeWithZone")
+        Icalendar::Values::Helpers::ActiveSupportTimeWithZoneAdapter.new(nil, tz, value)
+      end
+
+      def normalized_tzid
+        [tz.tzinfo.name]
+      end
+
+      private
+
+      def tz
+        @tz ||= ActiveSupport::TimeZone[tzid.split.first]
+      end
+    end
+  end
+end

data/lib/icalendar/offset/null.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Icalendar
+  class Offset
+    class Null < Offset
+      def valid?
+        true
+      end
+
+      def normalized_value
+        # plan d - just ignore the tzid
+        Icalendar.logger.info("Ignoring timezone #{tzid} for time #{value}")
+        nil
+      end
+    end
+  end
+end

data/lib/icalendar/offset/time_zone_store.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Icalendar
+  class Offset
+    class TimeZoneStore < Offset
+      def valid?
+        timezone_store && tz_info
+      end
+
+      def normalized_value
+        # plan b - use definition from provided `VTIMEZONE`
+        offset = tz_info.offset_for_local(value).to_s
+
+        Icalendar.logger.debug("Plan b - parsing #{value} with offset: #{offset}")
+        if value.respond_to?(:change)
+          value.change offset: offset
+        else
+          ::Time.new value.year, value.month, value.day, value.hour, value.min, value.sec, offset
+        end
+      end
+
+      private
+
+      def tz_info
+        @tz_info ||= timezone_store.retrieve(tzid)
+      end
+    end
+  end
+end

data/lib/icalendar/offset/windows_to_iana.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# This module contains mappings from Windows timezone identifiers to Olson timezone identifiers.
+#
+# The data is taken from the unicode consortium [0], the proposal and rationale
+# for this mapping is also available at the unicode consortium [1].
+#
+# [0] https://www.unicode.org/cldr/cldr-aux/charts/29/supplemental/zone_tzid.html
+# [1] https://cldr.unicode.org/development/development-process/design-proposals/extended-windows-olson-zid-mapping
+
+module Icalendar
+  class Offset
+    class WindowsToIana < Offset
+      WINDOWS_TO_IANA = {
+        'AUS Central Standard Time' => 'Australia/Darwin',
+        'AUS Eastern Standard Time' => 'Australia/Sydney',
+        'Afghanistan Standard Time' => 'Asia/Kabul',
+        'Alaskan Standard Time' => 'America/Anchorage',
+        'Arab Standard Time' => 'Asia/Riyadh',
+        'Arabian Standard Time' => 'Asia/Dubai',
+        'Arabic Standard Time' => 'Asia/Baghdad',
+        'Argentina Standard Time' => 'America/Argentina/Buenos_Aires',
+        'Atlantic Standard Time' => 'America/Halifax',
+        'Azerbaijan Standard Time' => 'Asia/Baku',
+        'Azores Standard Time' => 'Atlantic/Azores',
+        'Bahia Standard Time' => 'America/Bahia',
+        'Bangladesh Standard Time' => 'Asia/Dhaka',
+        'Belarus Standard Time' => 'Europe/Minsk',
+        'Canada Central Standard Time' => 'America/Regina',
+        'Cape Verde Standard Time' => 'Atlantic/Cape_Verde',
+        'Caucasus Standard Time' => 'Asia/Yerevan',
+        'Cen. Australia Standard Time' => 'Australia/Adelaide',
+        'Central America Standard Time' => 'America/Guatemala',
+        'Central Asia Standard Time' => 'Asia/Almaty',
+        'Central Brazilian Standard Time' => 'America/Cuiaba',
+        'Central Europe Standard Time' => 'Europe/Budapest',
+        'Central European Standard Time' => 'Europe/Warsaw',
+        'Central Pacific Standard Time' => 'Pacific/Guadalcanal',
+        'Central Standard Time' => 'America/Chicago',
+        'Central Standard Time (Mexico)' => 'America/Mexico_City',
+        'China Standard Time' => 'Asia/Shanghai',
+        'Dateline Standard Time' => 'Etc/GMT+12',
+        'E. Africa Standard Time' => 'Africa/Nairobi',
+        'E. Australia Standard Time' => 'Australia/Brisbane',
+        'E. Europe Standard Time' => 'Europe/Chisinau',
+        'E. South America Standard Time' => 'America/Sao_Paulo',
+        'Eastern Standard Time' => 'America/New_York',
+        'Eastern Standard Time (Mexico)' => 'America/Cancun',
+        'Egypt Standard Time' => 'Africa/Cairo',
+        'Ekaterinburg Standard Time' => 'Asia/Yekaterinburg',
+        'FLE Standard Time' => 'Europe/Kyiv',
+        'Fiji Standard Time' => 'Pacific/Fiji',
+        'GMT Standard Time' => 'Europe/London',
+        'GTB Standard Time' => 'Europe/Bucharest',
+        'Georgian Standard Time' => 'Asia/Tbilisi',
+        'Greenland Standard Time' => 'America/Nuuk',
+        'Greenwich Standard Time' => 'Atlantic/Reykjavik',
+        'Hawaiian Standard Time' => 'Pacific/Honolulu',
+        'India Standard Time' => 'Asia/Kolkata',
+        'Iran Standard Time' => 'Asia/Tehran',
+        'Israel Standard Time' => 'Asia/Jerusalem',
+        'Jordan Standard Time' => 'Asia/Amman',
+        'Kaliningrad Standard Time' => 'Europe/Kaliningrad',
+        'Korea Standard Time' => 'Asia/Seoul',
+        'Libya Standard Time' => 'Africa/Tripoli',
+        'Line Islands Standard Time' => 'Pacific/Kiritimati',
+        'Magadan Standard Time' => 'Asia/Magadan',
+        'Mauritius Standard Time' => 'Indian/Mauritius',
+        'Middle East Standard Time' => 'Asia/Beirut',
+        'Montevideo Standard Time' => 'America/Montevideo',
+        'Morocco Standard Time' => 'Africa/Casablanca',
+        'Mountain Standard Time' => 'America/Denver',
+        'Mountain Standard Time (Mexico)' => 'America/Chihuahua',
+        'Myanmar Standard Time' => 'Asia/Yangon',
+        'N. Central Asia Standard Time' => 'Asia/Novosibirsk',
+        'Namibia Standard Time' => 'Africa/Windhoek',
+        'Nepal Standard Time' => 'Asia/Kathmandu',
+        'New Zealand Standard Time' => 'Pacific/Auckland',
+        'Newfoundland Standard Time' => 'America/St_Johns',
+        'North Asia East Standard Time' => 'Asia/Irkutsk',
+        'North Asia Standard Time' => 'Asia/Krasnoyarsk',
+        'North Korea Standard Time' => 'Asia/Pyongyang',
+        'Pacific SA Standard Time' => 'America/Santiago',
+        'Pacific Standard Time' => 'America/Los_Angeles',
+        'Pakistan Standard Time' => 'Asia/Karachi',
+        'Paraguay Standard Time' => 'America/Asuncion',
+        'Romance Standard Time' => 'Europe/Paris',
+        'Russia Time Zone 10' => 'Asia/Srednekolymsk',
+        'Russia Time Zone 11' => 'Asia/Kamchatka',
+        'Russia Time Zone 3' => 'Europe/Samara',
+        'Russian Standard Time' => 'Europe/Moscow',
+        'SA Eastern Standard Time' => 'America/Cayenne',
+        'SA Pacific Standard Time' => 'America/Bogota',
+        'SA Western Standard Time' => 'America/La_Paz',
+        'SE Asia Standard Time' => 'Asia/Bangkok',
+        'Samoa Standard Time' => 'Pacific/Apia',
+        'Singapore Standard Time' => 'Asia/Singapore',
+        'South Africa Standard Time' => 'Africa/Johannesburg',
+        'Sri Lanka Standard Time' => 'Asia/Colombo',
+        'Syria Standard Time' => 'Asia/Damascus',
+        'Taipei Standard Time' => 'Asia/Taipei',
+        'Tasmania Standard Time' => 'Australia/Hobart',
+        'Tokyo Standard Time' => 'Asia/Tokyo',
+        'Tonga Standard Time' => 'Pacific/Tongatapu',
+        'Turkey Standard Time' => 'Europe/Istanbul',
+        'US Eastern Standard Time' => 'America/Indiana/Indianapolis',
+        'US Mountain Standard Time' => 'America/Phoenix',
+        'UTC' => 'Etc/GMT',
+        'UTC+12' => 'Etc/GMT-12',
+        'UTC-02' => 'Etc/GMT+2',
+        'UTC-11' => 'Etc/GMT+11',
+        'Ulaanbaatar Standard Time' => 'Asia/Ulaanbaatar',
+        'Venezuela Standard Time' => 'America/Caracas',
+        'Vladivostok Standard Time' => 'Asia/Vladivostok',
+        'W. Australia Standard Time' => 'Australia/Perth',
+        'W. Central Africa Standard Time' => 'Africa/Lagos',
+        'W. Europe Standard Time' => 'Europe/Berlin',
+        'West Asia Standard Time' => 'Asia/Tashkent',
+        'West Pacific Standard Time' => 'Pacific/Port_Moresby',
+        'Yakutsk Standard Time' => 'Asia/Yakutsk'
+      }.freeze
+
+      def valid?
+        support_classes_defined? && tz
+      end
+
+      def normalized_value
+        Icalendar.logger.debug("Plan a - parsing #{value}/#{tzid} as ActiveSupport::TimeWithZone")
+        # plan a - use ActiveSupport::TimeWithZone
+        Icalendar::Values::Helpers::ActiveSupportTimeWithZoneAdapter.new(nil, tz, value)
+      end
+
+      def normalized_tzid
+        [WINDOWS_TO_IANA[tzid]].compact
+      end
+
+      private
+
+      def tz
+        @tz ||= ActiveSupport::TimeZone[normalized_tzid.first || '']
+      end
+    end
+  end
+end

data/lib/icalendar/offset.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Icalendar
+  class Offset
+    def self.build(value, params, timezone_store)
+      return nil if params.nil? || params['tzid'].nil?
+
+      tzid = Array(params['tzid']).first
+
+      [
+        Icalendar::Offset::ActiveSupportExact,
+        Icalendar::Offset::TimeZoneStore,
+        Icalendar::Offset::WindowsToIana,
+        Icalendar::Offset::ActiveSupportPartial,
+        Icalendar::Offset::Null
+      ].lazy.map { |klass| klass.new(tzid, value, timezone_store) }.detect(&:valid?)
+    end
+
+    def initialize(tzid, value, timezone_store)
+      @tzid = tzid
+      @value = value
+      @timezone_store = timezone_store
+    end
+
+    def normalized_tzid
+      Array(tzid)
+    end
+
+    private
+
+    attr_reader :tzid, :value, :timezone_store
+
+    def support_classes_defined?
+      defined?(ActiveSupport::TimeZone) &&
+        defined?(Icalendar::Values::Helpers::ActiveSupportTimeWithZoneAdapter)
+    end
+  end
+end
+
+require_relative 'offset/active_support_exact'
+require_relative 'offset/active_support_partial'
+require_relative 'offset/null'
+require_relative 'offset/time_zone_store'
+require_relative 'offset/windows_to_iana'