sketchup-api-stubs 0.7.10 → 0.7.11

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

@@ -1,39 +1,65 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
-# This observer interface is implemented to react to view events.
+# This observer interface is implemented to react to {Sketchup::View} events.
 #
 # @abstract To implement this observer, create a Ruby class of this type,
 #   override the desired methods, and add an instance of the observer to the
-#   view object.
+#   {Sketchup::View} object.
 #
 # @example
-#   # This is an example of an observer that watches tool interactions.
 #   class MyViewObserver < Sketchup::ViewObserver
 #     def onViewChanged(view)
 #       puts "onViewChanged: #{view}"
 #     end
 #   end
 #
-#   # Attach the observer.
 #   Sketchup.active_model.active_view.add_observer(MyViewObserver.new)
 #
+# @see Sketchup::View#add_observer
+#
 # @version SketchUp 6.0
 class Sketchup::ViewObserver
 
   # Instance Methods
 
+  # The {#onScaleFactorChange} method is called whenever the view DPI of the view
+  # changes. This can be the SketchUp window being moved to another monitor with
+  # a different DPI or the user changing the DPI settings of the monitor.
+  #
+  # @example
+  #   class MyViewObserver < Sketchup::ViewObserver
+  #     def onScaleFactorChange(view)
+  #       puts "onScaleFactorChange: #{view}"
+  #       puts "UI.scale_factor(view): #{UI.scale_factor(view)}"
+  #     end
+  #   end
+  #
+  #   Sketchup.active_model.active_view.add_observer(MyViewObserver.new)
+  #
+  # @param [Sketchup::View] view
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 2025.0
+  def onScaleFactorChange(view)
+  end
+
   # The {#onViewChanged} method is called whenever the view is altered, such as
-  # when the user uses the Pan, Orbit, or Zoom tools are used.
+  # when the user uses the Pan, Orbit, or Zoom tools.
   #
   # @bug Prior to SketchUp 2019.2 this event did not trigger when the viewport
   #   size changed.
   #
   # @example
-  #   def onViewChanged(view)
-  #     puts "onViewChanged: #{view}"
+  #   class MyViewObserver < Sketchup::ViewObserver
+  #     def onViewChanged(view)
+  #       puts "onViewChanged: #{view}"
+  #     end
   #   end
   #
+  #   Sketchup.active_model.active_view.add_observer(MyViewObserver.new)
+  #
   # @param [Sketchup::View] view
   #
   # @return [nil]

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Sketchup module contains a number of important utility methods for use in
@@ -22,10 +22,10 @@
 #   # Now that we have our handles, we can start pulling objects and making
 #   # method calls that are useful.
 #   first_entity = entities[0]
-#   UI.messagebox("First thing in your model is a " + first_entity.typename)
+#   puts "First thing in your model is a #{first_entity.typename}"
 #
 #   number_materials = materials.length
-#   UI.messagebox("Your model has " + number_materials.to_s + " materials.")
+#   puts "Your model has #{number_materials} materials."
 #
 #   new_edge = entities.add_line( [0,0,0], [500,500,0])
 #
@@ -43,7 +43,7 @@ module Sketchup
   # @example
   #   model = Sketchup.active_model
   #   if !model
-  #     UI.messagebox("Failure")
+  #     puts "Failure"
   #   else
   #     # code acting on the model
   #   end
@@ -221,12 +221,12 @@ module Sketchup
   #   help_file = Sketchup.find_support_file("help.html", "Plugins/")
   #   if help_file
   #     # Print out the help_file full path
-  #     UI.messagebox(help_file)
+  #     puts help_file
   #
   #     # Open the help_file in a web browser
   #     UI.openURL("file://" + help_file)
   #   else
-  #     UI.messagebox("Failure")
+  #     puts "Failure"
   #   end
   #
   # @param [String] filename
@@ -388,7 +388,7 @@ module Sketchup
   #
   # @example
   #   number = 3.m * 4.m * 5.m # This will result in 60m3 in inches.
-  #   formatted_volume = Sketchup.format_area(number)
+  #   formatted_volume = Sketchup.format_volume(number)
   #
   # @param [Numeric] number
   #   A number to be formatted.
@@ -514,9 +514,9 @@ module Sketchup
   #   begin
   #     Sketchup.install_from_archive(path)
   #   rescue Interrupt => error
-  #     UI.messagebox("User said 'no': " + error)
+  #     puts "User said 'no': #{error}"
   #   rescue Exception => error
-  #     UI.messagebox("Error during unzip: " + error)
+  #     puts "Error during unzip: #{error}"
   #   end
   #
   # @param [String] filepath
@@ -577,7 +577,7 @@ module Sketchup
   #
   # @example
   #   if Sketchup.is_pro?
-  #     UI.messagebox("You are running SU Pro.")
+  #     puts "You are running SU Pro."
   #   end
   #
   # @note In SketchUp Make this method will return +true+ during the Pro trial
@@ -604,13 +604,17 @@ module Sketchup
   def self.is_valid_filename?(filename)
   end
 
-  # The load method is used to include encrypted and nonencrypted ruby files.
+  # The {.load} method is used to load Ruby files.
+  # Unlike Ruby's own +load+ method it also supports SketchUp's encrypted .rbe files.
   #
-  # You do not need to include the file extension on the path. This method will
+  # You do not need to include the file extension in the path. This method will
   # look for .rb first (unencrypted) and then .rbe (encrypted) and finally .rbs
   # (the deprecated scrambled format) files.
   # See the "Distributing your Plugin" article for details.
   #
+  # @bug Unlike Ruby's +load+ method, this method currently can't load the same file twice.
+  #   Instead works similar to Ruby's `require` method.
+  #
   # @example
   #   sfile = "application_loader" # file extension not required
   #   status = Sketchup.load(sfile)
@@ -655,6 +659,19 @@ module Sketchup
   #   @return [Integer, false]  status code if opening with +with_status+ set to +true+,
   #     otherwise +true+ or +false+.
   #
+  # @overload open_file(filename, with_status: true, show_version_warning_dialog: true)
+  #
+  #   Starting with SketchUp 2026.0 SketchUp we added control over displaying the
+  #   messages about version compatibility.
+  #
+  #   @version SketchUp 2026.0
+  #   @param [String] filename  The model file to open.
+  #   @param [Boolean] with_status
+  #   @param [Boolean] show_version_warning_dialog by default set to true and will display the dialog
+  #     box
+  #   @return [Integer, false]  status code if opening with +with_status+ set to +true+,
+  #     otherwise +true+ or +false+.
+  #
   # @version SketchUp 6.0
   def self.open_file(*args)
   end
@@ -768,13 +785,18 @@ module Sketchup
   def self.quit
   end
 
-  # The read_default method is used to retrieve the string associated with a
+  # The {.read_default} method is used to retrieve the string associated with a
   # value within the specified sub-section section of a .INI file or registry
   # (within the Software > SketchUp > SketchUp [Version] section).
   #
   # @example
   #   result = Sketchup.read_default("section", "variable", "default")
   #
+  # @note Be aware that the method is not capable of handling Length objects. You
+  #   can convert the value to a Float before writing and convert back to Length when
+  #   reading the value. Don't store the value as a String as this rounds the value and formats it
+  #   in a way that can't be read if the system setting for decimal separator changes.
+  #
   # @param [String] section
   #   A section in an .INI or registry.
   #
@@ -802,8 +824,8 @@ module Sketchup
   def self.redo
   end
 
-  # The register_extension method is used to register an extension with
-  # SketchUp's extension manager (in SketchUp preferences).
+  # The {.register_extension} method is used to register an extension with
+  # SketchUp's Extension Manager.
   #
   # @example
   #   utilities_extension = SketchupExtension.new("Utilities Tools",
@@ -862,10 +884,10 @@ module Sketchup
   def self.remove_observer(observer)
   end
 
-  # The require method is used to include encrypted and nonencrypted ruby files.
-  # This is an alias of the Sketchup.load method.
+  # The {.require} method is used to load Ruby files once.
+  # Unlike Ruby's own +require+ method it also supports SketchUp's encrypted .rbe files.
   #
-  # You do not need to include the file extension on the path. This method will
+  # You do not need to include the file extension in the path. This method will
   # look for .rbe first (encrypted) and then .rbs (the deprecated scrambled
   # format) and finally .rb (unencrypted) files. The loading order was changed
   # in SketchUp 2016 when the new .rbe encryption was introduced. Prior to
@@ -892,10 +914,14 @@ module Sketchup
   #
   # @bug In SketchUp 2023.1 this method didn't behave correctly on Windows. No known workarounds.
   #
-  # @example
+  # @example Physical pixels
   #   model = Sketchup.active_model
   #   Sketchup.resize_viewport(model, 800, 600)
   #
+  # @example Logical pixels
+  #   model = Sketchup.active_model
+  #   Sketchup.resize_viewport(model, 800, 600, logical_pixels: true)
+  #
   # @note In SketchUp 2024.0 and later this method doesn't behave correctly in all cases on Windows.
   #   The passed values are internally converted to logical pixels, rounded and converted back to
   #   physical pixels. This means certain sizes, such as 1000 px at 150% scaling, cannot be
@@ -910,13 +936,19 @@ module Sketchup
   #     ((1500/1.5).round * 1.5).round # => 1500
   #     ((1500/1.25).round * 1.25).round # => 1500
   #
-  # @param [Sketchup::Model] model
+  # @overload resize_viewport(model, width, height)
+  #
+  #   @param [Sketchup::Model] model
+  #   @param [Integer] width Width in physical pixels
+  #   @param [Integer] height Height in physical pixels
   #
-  # @param [Integer] width
-  #   Width in physical pixels
+  # @overload resize_viewport(model, width, height, logical_pixels: false)
   #
-  # @param [Integer] height
-  #   Height in physical pixels
+  #   @version SketchUp 2025.0
+  #   @param [Sketchup::Model] model
+  #   @param [Integer] width
+  #   @param [Integer] height
+  #   @param [Boolean] logical_pixels Set to true to set size using logical pixels.
   #
   # @return [Boolean] +true+ on success. +false+ if the window couldn't reach the desired size,
   #   e.g. because it wouldn't fit the screen.
@@ -925,8 +957,10 @@ module Sketchup
   #
   # @see Sketchup::View#vpheight
   #
+  # @see UI.scale_factor
+  #
   # @version SketchUp 2023.0
-  def self.resize_viewport(model, width, height)
+  def self.resize_viewport(*args)
   end
 
   # The save_thumbnail method is used to generate a thumbnail for any SKP file -
@@ -1059,7 +1093,7 @@ module Sketchup
   # - 10546: toggle Shadows toolbar
   # - 10551: toogle Large icons
   # - 10576: toggle Render Mode toolbar
-  # - 21019: hide Status bar and VCB
+  # - 21019: select the Eraser tool
   # - 21020: show Status bar and VCB
   # - 21022: hide Status bar and VCB
   # - 21023: place 3d text box
@@ -1179,9 +1213,9 @@ module Sketchup
   # If no arguments are passed, the status bar content is cleared. Valid
   # positions are:
   #
-  # - +SB_PROMPT+ - the text will appear at the left-side of the status bar
-  # - +SB_VCB_LABEL+ - the text will appear in place of the VCB label
-  # - +SB_VCB_VALUE+ - the text will appear in the VCB
+  # - {SB_PROMPT} - the text will appear at the left-side of the status bar
+  # - {SB_VCB_LABEL} - the text will appear in place of the VCB label
+  # - {SB_VCB_VALUE} - the text will appear in the VCB
   #
   # @example
   #   result = Sketchup.set_status_text("This is a Test", SB_VCB_VALUE)
@@ -1328,11 +1362,6 @@ module Sketchup
   #
   # @example
   #   version = Sketchup.version
-  #   if (version)
-  #     UI.messagebox version
-  #   else
-  #     return
-  #   end
   #
   # @return [String] the decimal form of the version
   #
@@ -1364,10 +1393,10 @@ module Sketchup
   # @return [Integer] the whole number form of the version
   #
   # @version SketchUp 6.0
-  def self.version_number(*args)
+  def self.version_number
   end
 
-  # The write_default method is used to set the string associated with a
+  # The {.write_default} method is used to set the string associated with a
   # variable within the specified sub-section of a .plist file on the Mac
   # or the registry on Windows
   # (within the Software > SketchUp > SketchUp [Version] section).
@@ -1375,6 +1404,12 @@ module Sketchup
   # @example
   #   result = Sketchup.write_default("section", "key", "my_value")
   #
+  # @note Be aware that the method is not capable of handling Length objects.
+  #   You can convert the value to a Float before writing and convert back to Length
+  #   when reading the value. Don't store the value as a String as this rounds the
+  #   value and formats it in a way that can't be read if the system setting for
+  #   decimal separator changes.
+  #
   # @param [String] section
   #   A section in a .plist file (Mac) or the registry
   #   (Windows).

data/lib/sketchup-api-stubs/stubs/SketchupExtension.rb

@@ -1,10 +1,10 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The SketchupExtension class contains methods allowing you to create and
 # manipulate SketchUp extensions. Extensions are Ruby scripts that can be
 # loaded and unloaded using the Extension manager (Extensions panel of the
-# Preferences dialog box). Generally you should register your ruby scripts as
+# Extension Manager dialog box). Generally you should register your ruby scripts as
 # an extension to give SketchUp users the ability to disable it through the
 # user interface.
 #
@@ -40,11 +40,11 @@ class SketchupExtension
 
   # Loads the extension, meaning the underlying ruby script is immediately
   # interpreted. This is the equivalent of checking the extension's checkbox
-  # in the Preferences > Extensions list.
+  # in the Extension Manager.
   #
   # @example
   #   # This will register the extension, a necessary step for it to appear
-  #   # in SketchUp's Preferences > Extensions list
+  #   # in SketchUp's Extension Manager > Extensions list
   #   ext_c = SketchupExtension.new('Stair Tools C', 'StairTools/core.rb')
   #   Sketchup.register_extension(ext_c, false)
   #
@@ -214,9 +214,9 @@ class SketchupExtension
   #
   # @example
   #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("load_on_start? is false: #{ext.load_on_start?.to_s}")
+  #   puts "load_on_start? is false: #{ext.load_on_start?.to_s}"
   #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("load_on_start? is now true: #{ext.load_on_start?.to_s}")
+  #   puts "load_on_start? is now true: #{ext.load_on_start?.to_s}"
   #
   # @return [Boolean]
   #
@@ -229,9 +229,9 @@ class SketchupExtension
   #
   # @example
   #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("loaded? is false: #{ext.loaded?.to_s}")
+  #   puts "loaded? is false: #{ext.loaded?.to_s}"
   #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("loaded? is now true: #{ext.loaded?.to_s}")
+  #   puts "loaded? is now true: #{ext.loaded?.to_s}"
   #
   # @return [Boolean]
   #
@@ -277,9 +277,9 @@ class SketchupExtension
   #
   # @example
   #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("My registered? is false: #{ext.registered?.to_s}")
+  #   puts "My registered? is false: #{ext.registered?.to_s}"
   #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("Now registered? is now true: #{ext.registered?.to_s}")
+  #   puts "Now registered? is now true: #{ext.registered?.to_s}"
   #
   # @return [Boolean]
   #
@@ -288,7 +288,7 @@ class SketchupExtension
   end
 
   # Unloads the extension. This is the equivalent of unchecking the extension's
-  # checkbox in the Preferences > Extensions list.
+  # checkbox in the Extension Manager > Extensions list.
   #
   # Note that technically the extension is not "unloaded" in the sense that it
   # stops running during the current SketchUp session, but the next time the

data/lib/sketchup-api-stubs/stubs/String.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 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 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Command class is the preferred class for adding tools to the menus and
@@ -124,8 +124,11 @@ class UI::Command
   #   toolbar = UI::Toolbar.new "Test"
   #   # This command displays Hello World on the screen when clicked
   #   cmd = UI::Command.new("Test") { UI.messagebox("Hello World") }
-  #   cmd.small_icon = "ToolPencilSmall.png"
-  #   cmd.large_icon = "ToolPencilLarge.png"
+  #   # Use __dir__ to set the icon paths relative to the current file's directory
+  #   # __dir__ returns the directory of the file where it is called
+  #   # File.join is used to construct file paths in a platform-independent way
+  #   cmd.small_icon = File.join(__dir__, "icons", "ToolPencilSmall.png")
+  #   cmd.large_icon = File.join(__dir__, "icons", "ToolPencilLarge.png")
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #   puts cmd.large_icon
@@ -149,8 +152,11 @@ class UI::Command
   #   toolbar = UI::Toolbar.new "Test"
   #   # This command displays Hello World on the screen when clicked
   #   cmd = UI::Command.new("Test") { UI.messagebox("Hello World") }
-  #   cmd.small_icon = "ToolPencilSmall.png"
-  #   cmd.large_icon = "ToolPencilLarge.png"
+  #   # Use __dir__ to set the icon paths relative to the current file's directory
+  #   # __dir__ returns the directory of the file where it is called
+  #   # File.join is used to construct file paths in a platform-independent way
+  #   cmd.small_icon = File.join(__dir__, "icons", "ToolPencilSmall.png")
+  #   cmd.large_icon = File.join(__dir__, "icons", "ToolPencilLarge.png")
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #
@@ -260,8 +266,11 @@ class UI::Command
   #   toolbar = UI::Toolbar.new "Test"
   #   # This toolbar command 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"
+  #   # Use __dir__ to set the icon paths relative to the current file's directory
+  #   # __dir__ returns the directory of the file where it is called
+  #   # File.join is used to construct file paths in a platform-independent way
+  #   cmd.small_icon = File.join(__dir__, "icons", "ToolPencilSmall.png")
+  #   cmd.large_icon = File.join(__dir__, "icons", "ToolPencilLarge.png")
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #   puts cmd.small_icon
@@ -285,8 +294,11 @@ class UI::Command
   #   toolbar = UI::Toolbar.new "Test"
   #   # This toolbar command 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"
+  #   # Use __dir__ to set the icon paths relative to the current file's directory
+  #   # __dir__ returns the directory of the file where it is called
+  #   # File.join is used to construct file paths in a platform-independent way
+  #   cmd.small_icon = File.join(__dir__, "icons", "ToolPencilSmall.png")
+  #   cmd.large_icon = File.join(__dir__, "icons", "ToolPencilLarge.png")
   #   toolbar = toolbar.add_item cmd
   #   toolbar.show
   #

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Ruby HtmlDialog class allows you to create and interact with HTML dialog
@@ -21,6 +21,8 @@
 #
 # HtmlDialog uses the following versions of CEF (Chromium Embedded Framework):
 #
+# [SketchUp 2025.0]
+#   CEF 128
 # [SketchUp 2024.0]
 #   CEF 112
 # [SketchUp 2021.1]
@@ -32,6 +34,28 @@
 # [SketchUp 2017.0]
 #   CEF 52
 #
+# Starting with SketchUp 2026.1, HtmlDialog exposes a small set of built-in callbacks (mirroring
+# the legacy +skp:+ protocol used by {UI::WebDialog}).
+#
+# * +sketchup.launchEW(id)+  – Opens the Extension Warehouse dialog and show a specified
+#   extension's page.
+# * +sketchup.installRBZ(url)+ – Downloads and installs a Ruby extension
+#   from the given +.rbz+ URL. (User will be prompted just like using the
+#   Extension Manager.)
+#
+# @example
+#   html = <<-HTML
+#     <button onclick="sketchup.launchEW('b5825acd-ba7c-4544-b255-e9935ddfd63b')">
+#       Open Advanced Camera Tools in EW
+#     </button>
+#     <button onclick="sketchup.installRBZ('https://example.com/my_extension.rbz')">
+#       Install My Extension
+#     </button>
+#   HTML
+#   dlg = UI::HtmlDialog.new(dialog_title: 'EW Example')
+#   dlg.set_html(html)
+#   dlg.show
+#
 # @note The window size is not guaranteed to be pixel perfect in all SketchUp
 #   versions and operating systems. Prefer responsive designs that can take
 #   up some fluctuations in size.
@@ -68,6 +92,7 @@ class UI::HtmlDialog
   #   dialog.add_action_callback("say") { |action_context, param1, param2|
   #     puts "JavaScript said #{param1} and #{param2}"
   #   }
+  #   dialog.show # should be called directly after binding callbacks
   #
   # @example JavaScript
   #   sketchup.say('Hello World', 42);
@@ -79,8 +104,32 @@ class UI::HtmlDialog
   #     }
   #   });
   #
+  # @example A complete example containing both Ruby and JavaScript
+  #   html = <<-HTML
+  #     <h1>Hello World</h1>
+  #     <p><button onclick="sketchup.say('Hello World', 42)">Say Hello</button></p>
+  #     <p><button onclick="sketchup.say('Hello World', 66, { onCompleted: function() {
+  #     console.log('Ruby side done.'); } })">Say Hello with Callback</button></p>
+  #   HTML
+  #
+  #   options = {
+  #     :dialog_title => "Example Dialog",
+  #     :preferences_key => "example.htmldialog",
+  #     :style => UI::HtmlDialog::STYLE_DIALOG
+  #   }
+  #
+  #   dialog = UI::HtmlDialog.new(options)
+  #   dialog.set_html(html)
+  #   dialog.center
+  #
+  #   dialog.add_action_callback("say") { |action_context, param1, param2|
+  #     puts "JavaScript said #{param1} and #{param2}"
+  #   }
+  #
+  #   dialog.show # should be called directly after binding callbacks
+  #
   # @note When an HtmlDialog is closed, all callbacks to that instance are
-  #   cleared. Re-attach them if you need to open the dialog again.
+  #   cleared. Attach or re-attach them before you show the dialog.
   #
   # @param [String] callback_name
   #   The name of the callback method to be invoked from the html dialog.
@@ -197,6 +246,24 @@ class UI::HtmlDialog
   def get_size
   end
 
+  # The {#hide} method is used to hide a dialog box without closing it.
+  # This preserves the dialog's state and allows it to be shown again later
+  # without recreating the dialog.
+  #
+  # @example
+  #   dialog.hide
+  #
+  # @note Modal dialogs cannot be hidden. Attempting to hide a modal dialog
+  #   will raise an ArgumentError.
+  #
+  # @raise [ArgumentError] if the dialog is modal
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 2026.1
+  def hide
+  end
+
   # The new method is used to create a new HtmlDialog.
   #
   # In SketchUp 2021.1 +use_content_size+ was added.
@@ -257,7 +324,7 @@ class UI::HtmlDialog
   #     :max_height => 1000,
   #     :style => UI::HtmlDialog::STYLE_DIALOG
   #   })
-  #   dialog.set_url("http://www.sketchup.com")
+  #   dialog.set_url("https://www.sketchup.com")
   #   dialog.show
   #
   # @example With keyword style argument
@@ -335,6 +402,8 @@ class UI::HtmlDialog
   #
   # @return [Boolean]
   #
+  # @see #set_on_closed
+  #
   # @version SketchUp 2017
   #
   # @yieldreturn [Boolean] Return a boolean to indicate if the dialogs should
@@ -394,13 +463,19 @@ class UI::HtmlDialog
 
   # The {#set_on_closed} method is used to attach a block that will be
   # executed when a dialog is already in the process of closing, do any last
-  # minute operations within this block such as saving the current state.
+  # minute operations within this block such as releasing resources or performing cleanup tasks.
   #
   # @example
-  #   dialog.set_on_closed { save_selection }
+  #   dialog.set_on_closed do
+  #     File.delete('temp_file.txt') if File.exist?('temp_file.txt')
+  #   end
+  #
+  # @note For saving state before window closes use {#set_can_close} instead.
   #
   # @return [Boolean]
   #
+  # @see #set_can_close
+  #
   # @version SketchUp 2017
   def set_on_closed
   end

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

@@ -1,11 +1,20 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # {UI::Notification} objects allows you to show native notifications in the
 # desktop. Notifications can have a message, icon and accept and/or dismiss
 # buttons with callback blocks.
 #
+# Supported icon formats include: .bmp, .png, .jpg.
+# Vector icons are supported as .svg on Windows and .pdf on Mac.
+# Recommended icon size is 48x48 pixels. Icons larger than these sizes will be automatically
+# downscaled to fit within the limits.
+#
+# @bug Prior to SketchUp 2026.0 oversized icons are cropped on Windows.
+#
 # @example
+#   sketchup_extension = Sketchup.extensions[extension_id]
+#   Sketchup.register_extension(sketchup_extension, true)
 #   # For consistency, the accept (yes) and the dismiss (no) buttons
 #   # are always displayed in the same order.
 #   message = "A new version of pizza is available. Install now?"
@@ -107,6 +116,7 @@ class UI::Notification
   #   @notification.show
   #
   # @note In order to insert line breaks into the message you need to use +\\r\\n+.
+  #   From SketchUp 2019 and onwards +\\n+ also works on both Mac and Windows.
   #
   # @param [SketchupExtension] sketchup_extension
   #   {SketchupExtension} instance used to identify
@@ -150,6 +160,7 @@ class UI::Notification
   #   @notification.show
   #
   # @note In order to insert line breaks into the message you need to use +\\r\\n+.
+  #   From SketchUp 2019 and onwards +\\n+ also works on both Mac and Windows.
   #
   # @param [String] message
   #   String providing the new message.
@@ -163,7 +174,7 @@ class UI::Notification
   # Shows a button in the notification with the given title and callback block,
   # both arguments are required.
   #
-  # @bug Prior to SketchUp 2019 both the accept and dismiss buttons were
+  # @bug Prior to SketchUp 2019 both the Accept and Dismiss buttons were
   #   displayed, even if only one had been implemented.
   #
   # @example
@@ -178,7 +189,7 @@ class UI::Notification
   #
   # @param [Proc] block
   #   Sets the action callback, this will be called when
-  #   the user clicks on the dismiss button.
+  #   the user clicks on the accept button.
   #
   # @raise [RuntimeError] When calling on_accept when the notification has
   #   already been shown.