fix: switch to github compatible markdown engine (#189)

Author: stainless-app[bot]

.rubocop.yml

@@ -235,6 +235,10 @@ Style/RegexpLiteral:
 Style/SafeNavigation:
   Enabled: false
 
+Style/SignalException:
+  Exclude:
+    - Rakefile
+
 # We use these sparingly, where we anticipate future branches for the
 # inner conditional.
 Style/SoleNestedConditional:

.yardopts

@@ -1,3 +1,4 @@
 --markup markdown
+--markup-provider redcarpet
 --exclude /rbi
 --exclude /sig

Gemfile

@@ -5,12 +5,6 @@ source "https://rubygems.org"
 gemspec
 
 group :development do
-  gem "async"
-  gem "minitest"
-  gem "minitest-focus"
-  gem "minitest-hooks"
-  gem "minitest-proveit"
-  gem "minitest-rg"
   gem "rake"
   gem "rbs"
   gem "rubocop"
@@ -20,6 +14,19 @@ group :development do
   # TODO: using a fork for now, the prettier below has a bug
   gem "syntax_tree-rbs", github: "stainless-api/syntax_tree-rbs", branch: "main"
   gem "tapioca"
+end
+
+group :development, :test do
+  gem "async"
+  gem "minitest"
+  gem "minitest-focus"
+  gem "minitest-hooks"
+  gem "minitest-proveit"
+  gem "minitest-rg"
+end
+
+group :development, :docs do
+  gem "redcarpet"
   gem "webrick"
   gem "yard"
 end

Gemfile.lock

@@ -29,8 +29,8 @@ GEM
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
-    ast (2.4.2)
-    async (2.23.0)
+    ast (2.4.3)
+    async (2.23.1)
       console (~> 1.29)
       fiber-annotation
       io-event (~> 1.9)
@@ -41,11 +41,11 @@ GEM
     bigdecimal (3.1.9)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.0)
-    console (1.29.3)
+    console (1.30.2)
       fiber-annotation
       fiber-local (~> 1.1)
       json
-    csv (3.3.2)
+    csv (3.3.3)
     drb (2.2.1)
     erubi (1.13.1)
     ffi (1.17.1)
@@ -56,16 +56,16 @@ GEM
     fileutils (1.7.3)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    io-event (1.9.0)
-    json (2.10.1)
+    io-event (1.10.0)
+    json (2.10.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
     listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    logger (1.6.6)
-    metrics (0.12.1)
-    minitest (5.25.4)
+    logger (1.7.0)
+    metrics (0.12.2)
+    minitest (5.25.5)
     minitest-focus (1.4.0)
       minitest (>= 4, < 6)
     minitest-hooks (1.5.2)
@@ -74,68 +74,73 @@ GEM
       minitest (> 5, < 7)
     minitest-rg (5.3.0)
       minitest (~> 5.0)
+    mutex_m (0.3.0)
     netrc (0.11.0)
     parallel (1.26.3)
-    parser (3.3.7.1)
+    parser (3.3.7.4)
       ast (~> 2.4.1)
       racc
     prettier_print (1.2.1)
-    prism (1.3.0)
+    prism (1.4.0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rbi (0.2.4)
+    rbi (0.3.1)
       prism (~> 1.0)
+      rbs (>= 3.4.4)
       sorbet-runtime (>= 0.5.9204)
-    rbs (3.8.1)
+    rbs (3.9.2)
       logger
+    redcarpet (3.6.1)
     regexp_parser (2.10.0)
-    rubocop (1.73.2)
+    rubocop (1.75.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.43.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.38.1)
-      parser (>= 3.3.1.0)
+    rubocop-ast (1.43.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    sorbet (0.5.11888)
-      sorbet-static (= 0.5.11888)
-    sorbet-runtime (0.5.11888)
-    sorbet-static (0.5.11888-x86_64-linux)
-    sorbet-static-and-runtime (0.5.11888)
-      sorbet (= 0.5.11888)
-      sorbet-runtime (= 0.5.11888)
-    spoom (1.5.4)
+    sorbet (0.5.11966)
+      sorbet-static (= 0.5.11966)
+    sorbet-runtime (0.5.11966)
+    sorbet-static (0.5.11966-x86_64-linux)
+    sorbet-static-and-runtime (0.5.11966)
+      sorbet (= 0.5.11966)
+      sorbet-runtime (= 0.5.11966)
+    spoom (1.6.1)
       erubi (>= 1.10.0)
       prism (>= 0.28.0)
       rbi (>= 0.2.3)
       sorbet-static-and-runtime (>= 0.5.10187)
       thor (>= 0.19.2)
-    steep (1.9.4)
+    steep (1.10.0)
       activesupport (>= 5.1)
       concurrent-ruby (>= 1.1.10)
       csv (>= 3.0.9)
       fileutils (>= 1.1.0)
       json (>= 2.1.0)
-      language_server-protocol (>= 3.15, < 4.0)
+      language_server-protocol (>= 3.17.0.4, < 4.0)
       listen (~> 3.0)
       logger (>= 1.3.0)
+      mutex_m (>= 0.3.0)
       parser (>= 3.1)
       rainbow (>= 2.2.2, < 4.0)
-      rbs (~> 3.8)
+      rbs (~> 3.9)
       securerandom (>= 0.1)
       strscan (>= 1.0.0)
-      terminal-table (>= 2, < 4)
+      terminal-table (>= 2, < 5)
       uri (>= 0.12.0)
     strscan (3.1.2)
     syntax_tree (6.2.0)
@@ -150,13 +155,15 @@ GEM
       spoom (>= 1.2.0)
       thor (>= 1.2.0)
       yard-sorbet
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
+    terminal-table (4.0.0)
+      unicode-display_width (>= 1.1.1, < 4)
     thor (1.3.2)
     traces (0.15.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.6.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
     uri (1.0.3)
     webrick (1.9.1)
     yard (0.9.37)
@@ -177,6 +184,7 @@ DEPENDENCIES
   orb!
   rake
   rbs
+  redcarpet
   rubocop
   sorbet
   steep

lib/orb/type/converter.rb

@@ -2,6 +2,7 @@
 
 module Orb
   module Type
+    # rubocop:disable Metrics/ModuleLength
     # @api private
     module Converter
       # rubocop:disable Lint/UnusedMethodArgument
@@ -118,6 +119,8 @@ def coerce(
           value,
           state: {strictness: true, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
         )
+          # rubocop:disable Lint/SuppressedException
+          # rubocop:disable Metrics/BlockNesting
           strictness, exactness = state.fetch_values(:strictness, :exactness)
 
           case target
@@ -194,6 +197,8 @@ def coerce(
 
           exactness[:no] += 1
           value
+          # rubocop:enable Metrics/BlockNesting
+          # rubocop:enable Lint/SuppressedException
         end
 
         # @api private
@@ -207,5 +212,6 @@ def dump(target, value)
         end
       end
     end
+    # rubocop:enable Metrics/ModuleLength
   end
 end

rbi/lib/orb/models/alert.rbi

@@ -76,7 +76,18 @@ module Orb
         )
           .returns(T.attached_class)
       end
-      def self.new(id:, created_at:, currency:, customer:, enabled:, metric:, plan:, subscription:, thresholds:, type:)
+      def self.new(
+        id:,
+        created_at:,
+        currency:,
+        customer:,
+        enabled:,
+        metric:,
+        plan:,
+        subscription:,
+        thresholds:,
+        type:
+      )
       end
 
       sig do

rbi/lib/orb/models/coupon.rbi

@@ -50,7 +50,15 @@ module Orb
         )
           .returns(T.attached_class)
       end
-      def self.new(id:, archived_at:, discount:, duration_in_months:, max_redemptions:, redemption_code:, times_redeemed:)
+      def self.new(
+        id:,
+        archived_at:,
+        discount:,
+        duration_in_months:,
+        max_redemptions:,
+        redemption_code:,
+        times_redeemed:
+      )
       end
 
       sig do

rbi/lib/orb/models/coupon_create_params.rbi

@@ -44,7 +44,13 @@ module Orb
         )
           .returns(T.attached_class)
       end
-      def self.new(discount:, redemption_code:, duration_in_months: nil, max_redemptions: nil, request_options: {})
+      def self.new(
+        discount:,
+        redemption_code:,
+        duration_in_months: nil,
+        max_redemptions: nil,
+        request_options: {}
+      )
       end
 
       sig do

rbi/lib/orb/models/credit_note.rbi

@@ -374,7 +374,13 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(amount_applied:, discount_type:, percentage_discount:, applies_to_prices: nil, reason: nil)
+        def self.new(
+          amount_applied:,
+          discount_type:,
+          percentage_discount:,
+          applies_to_prices: nil,
+          reason: nil
+        )
         end
 
         sig do
@@ -481,7 +487,13 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(amount_applied:, discount_type:, percentage_discount:, applies_to_prices: nil, reason: nil)
+        def self.new(
+          amount_applied:,
+          discount_type:,
+          percentage_discount:,
+          applies_to_prices: nil,
+          reason: nil
+        )
         end
 
         sig do

rbi/lib/orb/models/customers/cost_list_by_external_id_params.rbi

@@ -36,7 +36,13 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(currency: nil, timeframe_end: nil, timeframe_start: nil, view_mode: nil, request_options: {})
+        def self.new(
+          currency: nil,
+          timeframe_end: nil,
+          timeframe_start: nil,
+          view_mode: nil,
+          request_options: {}
+        )
         end
 
         sig do