sketchup-api-stubs 0.7.7 → 0.7.8

data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::PickHelper} class is used to pick entities that reside under
@@ -73,6 +73,8 @@ class Sketchup::PickHelper
   # criteria can be for completely-contained or partially-contained entities,
   # similar to how the Selection tool works.
   #
+  # transformation) if num_picked > 0 Sketchup.active_model.selection.add(ph.all_picked) end
+  #
   # @example
   #   boundingbox = Geom::BoundingBox.new
   #   boundingbox.add([1, 1, 1], [100, 100, 100])
@@ -82,10 +84,7 @@ class Sketchup::PickHelper
   #   angle = 45
   #   transformation = Geom::Transformation.new(ORIGIN, Z_AXIS, angle)
   #
-  #   num_picked = ph.boundingbox_pick(boundingbox, Sketchup::PickHelper::PICK_CROSSING, transformation)
-  #   if num_picked > 0
-  #     Sketchup.active_model.selection.add(ph.all_picked)
-  #   end
+  #   num_picked = ph.boundingbox_pick(boundingbox, Sketchup::PickHelper::PICK_CROSSING,
   #
   # @param bounding_box
   #   BoundingBox object defining the volume to use for picking

data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::RegionalSettings} module contains methods getting information about the

data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The RenderingOptions class contains method to extract the rendering

data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to rendering options events.

data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The SectionPlane class represents a section plane in a SketchUp model. Note

data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A set of the currently selected entities. Use the Model.selection method
@@ -155,7 +155,7 @@ class Sketchup::Selection
   #   number = selection.count
   #
   # @note Since SketchUp 2014 the count method is inherited from Ruby's
-  #   +Enumable+ mix-in module. Prior to that the {#count} method is an alias
+  #   +Enumerable+ mix-in module. Prior to that the {#count} method is an alias
   #   for {#length}.
   #
   # @return [Integer]

data/lib/sketchup-api-stubs/stubs/Sketchup/SelectionObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to selection events.

data/lib/sketchup-api-stubs/stubs/Sketchup/Set.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The set class represents a collection of unique objects. This class is useful

data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfo.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ShadowInfo class contains method to extract the shadow information for a
@@ -7,12 +7,14 @@
 #
 # The following shadow information keys are maintained in SketchUp:
 #
-# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that 'City' is called 'Location' in the UI
+# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that 'City' is called
+# 'Location' in the UI
 # - +Country+ (in Model Info > Geo-location > Set Manual Location...)
 # - +Dark+ (in Window > Shadows)
 # - +DayOfYear+
 # - +DaylightSavings+
-# - +DisplayNorth+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes' on Mac
+# - +DisplayNorth+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes'
+# on Mac
 # - +DisplayOnAllFaces+ (in Window > Shadows)
 # - +DisplayOnGroundPlane+ (in Window > Shadows)
 # - +DisplayShadows+ (in Window > Shadows)
@@ -20,7 +22,8 @@
 # - +Latitude+ (in Model Info > Geo-location > Set Manual Location...)
 # - +Light+ (in Window > Shadows)
 # - +Longitude+ (in Model Info > Geo-location > Set Manual Location...)
-# - +NorthAngle+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes' on Mac
+# - +NorthAngle+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes'
+# on Mac
 # - +ShadowTime+ (in Window > Shadows)
 # - +ShadowTime_time_t+ (ShadowTime in Epoch time)
 # - +SunDirection+ (Generated based on ShadowTime)

data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfoObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to changes to the shadow

data/lib/sketchup-api-stubs/stubs/Sketchup/Skp.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Skp} module is used to read metadata from external SketchUp

data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Style class contains methods for modifying information about a specific

data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Styles class contains methods for manipulating a collection of styles in
@@ -94,7 +94,7 @@ class Sketchup::Styles < Sketchup::Entity
   #   number = styles.count
   #
   # @note Since SketchUp 2014 the count method is inherited from Ruby's
-  #   +Enumable+ mix-in module. Prior to that the {#count} method is an alias
+  #   +Enumerable+ mix-in module. Prior to that the {#count} method is an alias
   #   for {#length}.
   #
   # @return [Integer]

data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Text class contains method to manipulate a Text entity object.

data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Texture class contains methods for obtaining information about textures

data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The TextureWriter class is used primarily for writing the textures used in a

data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb

@@ -1,9 +1,11 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Tool is the interface that you implement to create a SketchUp tool.
-# See https://github.com/SketchUp/sketchup-ruby-api-tutorials/tree/master/examples/02_custom_tool
-# for an example of how to create a custom tool in Ruby.
+# See
+# {our code
+# example}[https://github.com/SketchUp/sketchup-ruby-api-tutorials/tree/main/examples/02_custom_tool]
+# for how to create a custom tool in Ruby.
 #
 # To create a new tool in Ruby, you must define a new class that implements
 # the methods for the events that you want to respond to. You do not have

data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Tools class contains methods to manipulate a collection of SketchUp

data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to tool events.

data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The UV Helper class contains methods allowing you to determine the location
@@ -22,8 +22,10 @@ class Sketchup::UVHelper
   #   face.outer_loop.vertices.each do |vert|
   #     uvq = uv_helper.get_back_UVQ(vert.position)
   #     # "Normalize" UVQ to UV.
-  #     u = uvq.u / unq.q
-  #     v = uvq.v / unq.q
+  #     # #x, #y and #z corresponds to U, V and Q respectively,
+  #     # as SketchUp re-uses the normal Point3d objects for UVQs
+  #     u = uvq.x / uvq.z
+  #     v = uvq.y / uvq.z
   #     puts "u=#{u} v=#{v}""
   #   end
   #
@@ -49,8 +51,10 @@ class Sketchup::UVHelper
   #   face.outer_loop.vertices.each do |vert|
   #     uvq = uv_helper.get_front_UVQ(vert.position)
   #     # "Normalize" UVQ to UV.
-  #     u = uvq.u / unq.q
-  #     v = uvq.v / unq.q
+  #     # #x, #y and #z corresponds to U, V and Q respectively,
+  #     # as SketchUp re-uses the normal Point3d objects for UVQs
+  #     u = uvq.x / uvq.z
+  #     v = uvq.y / uvq.z
   #     puts "u=#{u} v=#{v}""
   #   end
   #

data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A Vertex. A Vertex represents the end of an Edge or a point inside a Face.

data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This class contains methods to manipulate the current point of view of the
@@ -462,10 +462,18 @@ class Sketchup::View
   # around the full bounds of the text, use {#text_bounds} to compute the
   # desired alignment.
   #
+  # The vertical alignment can vary between fonts and platforms. It's recommended
+  # to test different fonts and find one that fits well across both platforms
+  # for your purposes.
+  #
   # <b>Example of different vertical alignment and text bounds:</b>
   #
   # rdoc-image:../images/view-draw-text-with-bounds.png
   #
+  # @bug Prior to SU2022.0, on macOS, the vertical text alignment for some fonts
+  #   could appear to be offset from their expected positions. As of SU2022.0 the
+  #   vertical alignment should be more accurate and consistent.
+  #
   # @example
   #   class ExampleTool
   #     def draw(view)
@@ -505,7 +513,7 @@ class Sketchup::View
   #     def draw_text(view, position, text, **options)
   #       native_options = options.dup
   #       if IS_WIN && options.key?(:size)
-  #         native_options[:size] = pixels_to_points(size)
+  #         native_options[:size] = pixels_to_points(options[:size])
   #       end
   #       view.draw_text(position, text, **native_options)
   #     end
@@ -1192,8 +1200,7 @@ class Sketchup::View
   # For other file formats  available from the GUI in File > Export > 2D
   # Graphics, .e.g `.pdf`, use {Sketchup::Model#export}.
   #
-  # @overload write_image(filename, width = view.vpwidth, height = view.vpheight, antialias = false, compression = 1.0)
-  #
+  # compression = 1.0)
   #   @note Prefer the overload with option hash instead of this variant. This
   #     overload is not updated with new options.
   #
@@ -1215,6 +1222,9 @@ class Sketchup::View
   #   @param [Float] compression
   #     Compression factor for JPEG images, between +0.0+ and +1.0+.
   #
+  # @overload write_image(filename, width = view.vpwidth, height = view.vpheight, antialias = false,
+  #
+  #
   # @overload write_image(options)
   #
   #   @example

data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to view events.

data/lib/sketchup-api-stubs/stubs/{sketchup.rb → Sketchup.rb}

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Sketchup module contains a number of important utility methods for use in
@@ -140,6 +140,11 @@ module Sketchup
   # @example
   #   Sketchup.debug_mode = true
   #
+  # @note Changing this value within your extension can cause problems for other
+  #   extension developers who rely on the debug information for their own work.
+  #   Only use this locally; never change this value in an extension you
+  #   publish.
+  #
   # @param [Boolean] enabled
   #   If true, SketchUp will produce debug warnings.
   #
@@ -182,11 +187,13 @@ module Sketchup
   # Returns the ExtensionsManager where you can find all registered
   # SketchupExtension objects.
   #
+  # #{extension.loaded?}"
+  #   }
+  #
   # @example
   #   extensions = Sketchup.extensions
   #   extensions.each{ |extension|
-  #     puts "The next extension is named: #{extension.name} and its loaded? state is: #{extension.loaded?}"
-  #   }
+  #     puts "The next extension is named: #{extension.name} and its loaded? state is:
   #
   # @return [Sketchup::ExtensionsManager] an ExtensionsManager object.
   #

data/lib/sketchup-api-stubs/stubs/{sketchupextension.rb → SketchupExtension.rb}

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The SketchupExtension class contains methods allowing you to create and

data/lib/sketchup-api-stubs/stubs/{string.rb → String.rb}

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The String class contains a method used to parse a string as a length value.

data/lib/sketchup-api-stubs/stubs/UI/Command.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Command class is the preferred class for adding tools to the menus and
@@ -67,6 +67,58 @@ class UI::Command
 
   # Instance Methods
 
+  # The {#extension} method returns the command's associated extension.
+  #
+  # @example
+  #   extension = Sketchup.extensions['Sandbox Tools']
+  #   cmd = UI::Command.new("Tester") {}
+  #   cmd.extension = extension
+  #   p cmd.extension == extension
+  #
+  # @note This is an advanced feature that extension developers normally won't
+  #   have to deal with. It's purpose is to address scenarios when SketchUp
+  #   isn't able to automatically infer which extension the command belongs to.
+  #
+  # @return [SketchupExtension, nil]
+  #
+  # @version SketchUp 2022.0
+  def extension
+  end
+
+  # The {#extension=} method explicitly sets the command's associated extension.
+  #
+  # @example
+  #   extension = Sketchup.extensions['Sandbox Tools']
+  #   cmd = UI::Command.new("Tester") {}
+  #   cmd.extension = extension
+  #
+  # @note This is an advanced feature that extension developers normally won't
+  #   have to deal with. It's purpose is to address scenarios when SketchUp
+  #   isn't able to automatically infer which extension the command belongs to.
+  #   These scenarios are for example an extension using a library to add its
+  #   commands or command manager extensions.
+  #
+  # @param [SketchupExtension, nil] extension
+  #
+  # @version SketchUp 2022.0
+  def extension=(extension)
+  end
+
+  # The {#get_validation_proc} method returns the command's validation proc.
+  #
+  # @example
+  #   cmd = UI::Command.new("Tester") {}
+  #   cmd.set_validation_proc { MF_DISABLED }
+  #   proc = cmd.get_validation_proc
+  #
+  # @return [Proc, nil]
+  #
+  # @see #set_validation_proc
+  #
+  # @version SketchUp 2022.0
+  def get_validation_proc
+  end
+
   # The large_icon method returns the icon file for the command's
   # large icon.
   #
@@ -149,6 +201,21 @@ class UI::Command
   def menu_text=(menuitem)
   end
 
+  # The {#proc} method returns the command's proc that is called when the command
+  # is invoked.
+  #
+  # @example
+  #   cmd = UI::Command.new("Tester") {}
+  #   cmd.set_validation_proc { MF_DISABLED }
+  #   proc = cmd.proc
+  #   proc.call
+  #
+  # @return [Proc]
+  #
+  # @version SketchUp 2022.0
+  def proc
+  end
+
   # The {#set_validation_proc} method allows you to change whether the command
   # is enabled, checked, etc. For instance, the command toggling a dialog window
   # may be displayed as checked while the dialog is open.
@@ -177,6 +244,8 @@ class UI::Command
   #
   # @return [UI::Command]
   #
+  # @see #get_validation_proc
+  #
   # @version SketchUp 6.0
   #
   # @yield []
@@ -236,13 +305,13 @@ class UI::Command
   # command.
   #
   # @example
-  #   toolbar = UI::Toolbar.new "Test"
+  #   toolbar = UI::Toolbar.new("Test")
   #   # This toolbar tool simply displays Hello World on the screen
   #   # when clicked
   #   cmd = UI::Command.new("Tester") { UI.messagebox("Hello World") }
   #   cmd.small_icon = "ToolPencilSmall.png"
   #   cmd.large_icon = "ToolPencilLarge.png"
-  #   cmd.status_bar_text = $tStrings.GetString("Testing the toolbars class")
+  #   cmd.status_bar_text = "Testing the toolbars class."
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #   puts cmd.status_bar_text
@@ -254,15 +323,15 @@ class UI::Command
   end
 
   # The status_bar_text= method is used to set the status bar text for the
-  # command.
+  # command. This should be a description what the command does.
   #
   # @example
-  #   toolbar = UI::Toolbar.new "Test"
+  #   toolbar = UI::Toolbar.new("Test")
   #   # This toolbar tool simply displays Hello World on the screen when clicked
   #   cmd = UI::Command.new("Tester") { UI.messagebox("Hello World") }
   #   cmd.small_icon = "ToolPencilSmall.png"
   #   cmd.large_icon = "ToolPencilLarge.png"
-  #   cmd.status_bar_text = $tStrings.GetString("Testing the toolbars class")
+  #   cmd.status_bar_text = "Testing the toolbars class."
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #
@@ -293,7 +362,7 @@ class UI::Command
   def tooltip
   end
 
-  # The tooltip= method is used to define a command item's tooltip text. Tooltips
+  # The {#tooltip=} method is used to define a command item's tooltip header. Tooltips
   # will appear when the command is attached to a tool bar and the user hovers
   # their cursor over the icon.
   #
@@ -305,6 +374,9 @@ class UI::Command
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #
+  # @note The tooltip text should repeat the commands' title text. For the command
+  #   description, use {#status_bar_text}.
+  #
   # @param [String] text
   #   The text of the tooltip.
   #

data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Ruby HtmlDialog class allows you to create and interact with HTML dialog
@@ -16,6 +16,8 @@
 #
 # For usage examples, including how to migrate from the old WebDialog class,
 # see https://github.com/SketchUp/htmldialog-examples.
+# You may use the {https://sketchup.github.io/modus-for-sketchup-extensions Trimble Modus}
+# framework for a look and feel of your dialog that matches that of SketchUp's dialogs.
 #
 # HtmlDialog uses the following versions of CEF (Chromium Embedded Framework):
 #
@@ -150,7 +152,8 @@ class UI::HtmlDialog
   def execute_script(script)
   end
 
-  # The {#get_content_size} method is used to get the content size of the HtmlDialog, in logical pixels.
+  # The {#get_content_size} method is used to get the content size of the HtmlDialog, in logical
+  # pixels.
   #
   # @example
   #   width, height = dialog.get_content_size
@@ -192,7 +195,8 @@ class UI::HtmlDialog
 
   # The new method is used to create a new HtmlDialog.
   #
-  # When +use_content_size+ is set to +true+, +width+, +height+, +min_width+,
+  # In SketchUp 2021.1 +use_content_size+ was added.
+  # When set to +true+, +width+, +height+, +min_width+,
   # +max width+, +min_height+, +max_height+ will represent the size of the
   # content area of the window. This excludes the titlebar and the window frame.
   # When +use_content_size+ is set to +false+ (the default value),
@@ -210,6 +214,23 @@ class UI::HtmlDialog
   # [+UI::HtmlDialog::STYLE_UTILITY+]  HtmlDialog is shown with small titlebar
   #                                    and stays on top of SketchUp.
   #
+  # @bug Prior to SketchUp 2019 the +:width+ and +:height+ provided is ignored
+  #   if a +:preference_key+ is also present. To work around this bug on older
+  #   versions use {#set_size} after you initialize the dialog.
+  #
+  # @bug SketchUp 2022.0 fixed a bug where position was set incorrectly when
+  #   +use_content_size+ was set to +true+.
+  #
+  # @bug SketchUp 2022.0 fixed a bug where +max_height+ and +max_width+ were swapped
+  #   when +use_content_size+ was set to +true+.
+  #
+  # @bug SketchUp 2022.0 fixed a bug where +use_content_size+ was not persisted (when
+  #   +preferences_key+ is set).
+  #
+  # @bug SketchUp 2022.0 fixed a bug on Mac where size and position of the
+  #   HtmlDialog were not persisted when SketchUp was closed without first
+  #   closing the HtmlDialog window.
+  #
   # @example With options Hash
   #   dialog = UI::HtmlDialog.new(
   #   {
@@ -249,10 +270,6 @@ class UI::HtmlDialog
   #   dialog.set_url("https://www.sketchup.com")
   #   dialog.show
   #
-  # @note Prior to SketchUp 2019 the +:width+ and +:height+ provided is ignored
-  #   if a +:preference_key+ is also present. To work around this bug on older
-  #   versions use {#set_size} after you initialize the dialog.
-  #
   # @note Prefix +preference_key+ with something unique to your extension.
   #
   # @note If there is no reference kept to the HtmlDialog object, the window
@@ -316,7 +333,8 @@ class UI::HtmlDialog
   def set_can_close
   end
 
-  # The {#set_content_size} method is used to set the content size of the HtmlDialog, in logical pixels.
+  # The {#set_content_size} method is used to set the content size of the HtmlDialog, in logical
+  # pixels.
   #
   # @example
   #   dialog.set_content_size(600, 400)

data/lib/sketchup-api-stubs/stubs/UI/Notification.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # {UI::Notification} objects allows you to show native notifications in the

data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Toolbar class contains methods to create and manipulate SketchUp

data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Ruby WebDialog class allows you to create and interact with DHTML dialog
@@ -177,6 +177,22 @@ class UI::WebDialog
 
   # The +new+ method is used to create a new webdialog.
   #
+  # 250, left = 0, top = 0, resizable = true)
+  #   @param [String] dialog_title   The title to be displayed in the webdialog.
+  #   @param [Boolean] scrollable    true if you want to allow scrollbars, false
+  #                                  if you do not want to allow scrollbars.
+  #   @param [String, nil] pref_key  The registry entry where the location and
+  #                                  size of the dialog will be saved.
+  #                                  If preferences_key is not included, the
+  #                                  location and size will not be stored.
+  #   @param [Integer] width         The width of the webdialog.
+  #   @param [Integer] height        The height of the webdialog.
+  #   @param [Integer] left          The number of pixels from the left.
+  #   @param [Integer] top           The number of pixels from the top.
+  #   @param [Integer] resizable     true if you want the webdialog to be resizable,
+  #                                  false if not.
+  #   @return [UI::WebDialog]
+  #
   # @example
   #   dlg = UI::WebDialog.new("Show sketchup.com", true,
   #     "ShowSketchupDotCom", 739, 641, 150, 150, true);
@@ -191,22 +207,8 @@ class UI::WebDialog
   #   user's OS. On Mac, Safari is embedded, while on the PC whatever version of
   #   Internet Explorer is installed will be embedded.
   #
-  # @overload initialize(dialog_title = "", scrollable = true, pref_key = nil, width = 250, height = 250, left = 0, top = 0, resizable = true)
+  # @overload initialize(dialog_title = "", scrollable = true, pref_key = nil, width = 250, height =
   #
-  #   @param [String] dialog_title   The title to be displayed in the webdialog.
-  #   @param [Boolean] scrollable    true if you want to allow scrollbars, false
-  #                                  if you do not want to allow scrollbars.
-  #   @param [String, nil] pref_key  The registry entry where the location and
-  #                                  size of the dialog will be saved.
-  #                                  If preferences_key is not included, the
-  #                                  location and size will not be stored.
-  #   @param [Integer] width         The width of the webdialog.
-  #   @param [Integer] height        The height of the webdialog.
-  #   @param [Integer] left          The number of pixels from the left.
-  #   @param [Integer] top           The number of pixels from the top.
-  #   @param [Integer] resizable     true if you want the webdialog to be resizable,
-  #                                  false if not.
-  #   @return [UI::WebDialog]
   #
   # @overload initialize(properties)
   #