sketchup-api-stubs 0.7.10 → 0.7.11

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentInstance} class is used to represent component
@@ -109,12 +109,8 @@ class Sketchup::ComponentInstance < Sketchup::Drawingelement
   #
   # @example
   #   # Assuming 'instance' is a ComponentInstance object
-  #   array = instance.explode
-  #   if array
-  #     UI.messagebox "Exploded the component instance"
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
+  #   instance = Sketchup.active_model.active_entities.grep(Sketchup::ComponentInstance).first
+  #   entities = instance.explode
   #
   # @return [Array<Sketchup::Entity>, false] An array of entity objects if successful, +false+ if
   #   unsuccessful
@@ -519,13 +515,19 @@ class Sketchup::ComponentInstance < Sketchup::Drawingelement
   #   new_transformation = Geom::Transformation.new([100,0,0])
   #   componentinstance.transformation = new_transformation
   #
+  # @note As of SketchUp 2026, this will raise an error if the
+  #   {Geom::Transformation} is not invertible. Prior to 2026 this would silently set the
+  #   transformation possibly causing rendering or editing problems.
+  #
   # @param [Geom::Transformation] transformation
   #
+  # @raise ArgumentError if the {Geom::Transformation} is not invertible (as of Sketchup 2026)
+  #
   # @version SketchUp 6.0
   def transformation=(transformation)
   end
 
-  # The trim method is used to compute the (non-destructive) boolean difference
+  # The {#trim} method is used to compute the (non-destructive) boolean difference
   # of the two instances representing manifold solid volumes (this - arg).  If
   # the specified objects (this and arg) do not represent manifold volumes, this
   # method fails.
@@ -536,6 +538,11 @@ class Sketchup::ComponentInstance < Sketchup::Drawingelement
   #   instance2 = entities[1]
   #   result = instance1.trim(instance2)
   #
+  # @note Trimming object instance2 using instance1 results in a new trimmed version of instance2.
+  #   If the trim is successful the original instance2 is erased and a newly trimmed
+  #   version is created. This new version, derived from the trimming operation,
+  #   will possess a new GUID and will be returned.
+  #
   # @note This method is not available in SketchUp Make.
   #
   # @param [Sketchup::ComponentInstance] instance

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Console class is used by SketchUp to direct $stdout and $stderr to the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ConstructionLine class contains methods for modifying construction
@@ -20,11 +20,6 @@ class Sketchup::ConstructionLine < Sketchup::Drawingelement
   #   point2 = Geom::Point3d.new(20,20,20)
   #   constline = entities.add_cline(point1, point2)
   #   vector = constline.direction
-  #   if (vector)
-  #     UI.messagebox(vector)
-  #   else
-  #     UI.messagebox("Failure")
-  #   end
   #
   # @return vector - a Vector3d object if successful
   #
@@ -83,12 +78,12 @@ class Sketchup::ConstructionLine < Sketchup::Drawingelement
   # @example
   #   model = Sketchup.active_model
   #   entities = model.active_entities
-  #   point1 = Geom::Point3d.new(0,0,0)
-  #   point2 = Geom::Point3d.new(20,20,20)
-  #   point3 = Geom::Point3d.new(10,10,10)
+  #   point1 = Geom::Point3d.new(0, 0, 0)
+  #   point2 = Geom::Point3d.new(20, 20, 20)
+  #   point3 = Geom::Point3d.new(10, 10, 10)
   #   constline = entities.add_cline(point1, point2)
-  #   UI.messagebox(constline.end)
-  #   # Will display point2
+  #   constline.end = point3
+  #   # Will shorten the line to [10, 10, 10]
   #
   # @overload end=(point)
   #
@@ -225,7 +220,7 @@ class Sketchup::ConstructionLine < Sketchup::Drawingelement
   #   constline = entities.add_cline(point1, point2)
   #   puts constline.stipple
   #
-  # @return [String]
+  # @return [Integer]
   #
   # @version SketchUp 6.0
   def stipple

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A construction point represents a point in the model that can be used to aid

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Curve class is used by SketchUp to unite a series of Edge objects into

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A DefinitionList object holds a list of all of the ComponentDefinition
@@ -145,7 +145,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #   be skipped as the indices change. Instead copy the current collection to an
   #   array using +to_a+ and then use +each+ on the array, when removing content.
   #
-  # @return [nil]
+  # @return [Sketchup::ComponentDefinition]
   #
   # @version SketchUp 6.0
   #
@@ -233,7 +233,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #   @param [String] path
   #     The path where the component definition file is located.
   #
-  # @overload load(path, allow_newer: true)
+  # @overload load(path, allow_newer: false)
   #
   #   Starting with SketchUp 2021.0 SketchUp attempts to load newer SketchUp
   #   models. If a newer model is loaded some information might have been skipped
@@ -268,13 +268,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #
   # This method throws an exception if an url string is not
   # given, or an error occurs during retrieval from URL and a
-  # +load_handler+ was not given. Optional second parameter +load_handler+ can be
-  # used to pass in a Ruby object that responds to the following methods:
-  #
-  # - +cancelled?+
-  # - +onPercentChange(percent)+
-  # - +onSuccess()+
-  # - +onFailure(message_string)+
+  # {Sketchup::LoadHandler load_handler} was not given.
   #
   # @bug Calling this method from an {UI::HtmlDialog}'s action callback on macOS will cause the
   #   SketchUp application to become unresponsive or crash. To work around this, defer the call

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to component definition

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to events on a definitions

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Dimension class provides base functionality for classes DimensionLinear
@@ -38,13 +38,14 @@ class Sketchup::Dimension < Sketchup::Drawingelement
   def add_observer(observer)
   end
 
-  # The arrow_type method retrieves the current arrow type of the dimension.
-  # Valid arrow types are class constants:
-  # - +Dimension::ARROW_NONE,+
-  # - +Dimension::ARROW_SLASH+
-  # - +Dimension::ARROW_DOT+
-  # - +Dimension::ARROW_CLOSED+
-  # - +Dimension::ARROW_OPEN+
+  # The {#arrow_type} method retrieves the current arrow type of the dimension.
+  #
+  # Valid arrow types are:
+  # - {Sketchup::Dimension::ARROW_NONE}
+  # - {Sketchup::Dimension::ARROW_SLASH}
+  # - {Sketchup::Dimension::ARROW_DOT}
+  # - {Sketchup::Dimension::ARROW_CLOSED}
+  # - {Sketchup::Dimension::ARROW_OPEN}
   #
   # @example
   #   type = dim.arrow_type
@@ -58,13 +59,14 @@ class Sketchup::Dimension < Sketchup::Drawingelement
   def arrow_type
   end
 
-  # The arrow_type= method sets the arrow type of the dimension.
-  # Valid arrow types are class constants:
-  # - +Dimension::ARROW_NONE,+
-  # - +Dimension::ARROW_SLASH+
-  # - +Dimension::ARROW_DOT+
-  # - +Dimension::ARROW_CLOSED+
-  # - +Dimension::ARROW_OPEN+
+  # The {#arrow_type=} method sets the arrow type of the dimension.
+  #
+  # Valid arrow types are:
+  # - {Sketchup::Dimension::ARROW_NONE}
+  # - {Sketchup::Dimension::ARROW_SLASH}
+  # - {Sketchup::Dimension::ARROW_DOT}
+  # - {Sketchup::Dimension::ARROW_CLOSED}
+  # - {Sketchup::Dimension::ARROW_OPEN}
   #
   # @example
   #   dim.arrow_type = Sketchup::Dimension::ARROW_CLOSED

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The DimensionLinear class represents linear dimensions.
@@ -18,12 +18,12 @@ class Sketchup::DimensionLinear < Sketchup::Dimension
 
   # Instance Methods
 
-  # The aligned_text_position method returns the text position for dimensions
+  # The {#aligned_text_position} method returns the text position for dimensions
   # with aligned text (i.e. has_aligned_text? returns true).
   # Valid values are class constants:
-  # - DimensionLinear::ALIGNED_TEXT_ABOVE
-  # - DimensionLinear::ALIGNED_TEXT_CENTER
-  # - DimensionLinear::ALIGNED_TEXT_OUTSIDE
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE}
   #
   # @example
   #   pos = dim.aligned_text_position
@@ -41,12 +41,12 @@ class Sketchup::DimensionLinear < Sketchup::Dimension
   def aligned_text_position
   end
 
-  # The aligned_text_position= method is used to set the text position for
+  # The {#aligned_text_position=} method is used to set the text position for
   # dimensions with aligned text (i.e. has_aligned_text? returns true).
   # Valid values are class constants:
-  # - DimensionLinear::ALIGNED_TEXT_ABOVE
-  # - DimensionLinear::ALIGNED_TEXT_CENTER
-  # - DimensionLinear::ALIGNED_TEXT_OUTSIDE
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE}
   #
   # @example
   #   dim.aligned_text_position = Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER
@@ -263,11 +263,11 @@ class Sketchup::DimensionLinear < Sketchup::Dimension
   def start_attached_to=(path)
   end
 
-  # The text_position method returns the position of the text along the dimension
+  # The {#text_position} method returns the position of the text along the dimension
   # line. Valid values are class constants:
-  # - DimensionLinear::TEXT_OUTSIDE_START
-  # - DimensionLinear::TEXT_CENTERED
-  # - DimensionLinear::TEXT_OUTSIDE_END
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_START}
+  # - {Sketchup::DimensionLinear::TEXT_CENTERED}
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_END}
   #
   # @example
   #   pos = dim.text_position
@@ -285,11 +285,11 @@ class Sketchup::DimensionLinear < Sketchup::Dimension
   def text_position
   end
 
-  # The text_position= method is used to set the position of the text along the
+  # The {#text_position=} method is used to set the position of the text along the
   # dimension line. Valid values are class constants:
-  # - DimensionLinear::TEXT_OUTSIDE_START
-  # - DimensionLinear::TEXT_CENTERED
-  # - DimensionLinear::TEXT_OUTSIDE_END
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_START}
+  # - {Sketchup::DimensionLinear::TEXT_CENTERED}
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_END}
   #
   # @example
   #   dim.text_position = Sketchup::DimensionLinear::TEXT_CENTERED

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to changes in dimension text.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The DimensionRadial class represents radius and diameter dimensions on
@@ -37,7 +37,7 @@ class Sketchup::DimensionRadial < Sketchup::Dimension
   def arc_curve=(arc_curve)
   end
 
-  # The leader_break_point method returns the break point on the leader where the
+  # The {#leader_break_point} method returns the break point on the leader where the
   # dimension text is attached.
   #
   # @example
@@ -50,7 +50,7 @@ class Sketchup::DimensionRadial < Sketchup::Dimension
   def leader_break_point
   end
 
-  # The leader_break_point= method is used to set the break point on the leader
+  # The {#leader_break_point=} method is used to set the break point on the leader
   # where the dimension text is attached.
   #
   # @example

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Drawingelement is a base class for an item in the model that can be
@@ -60,7 +60,6 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #
   #   # Make the face not cast shadows.
   #   status = face.casts_shadows = false
-  #   UI.messagebox status.to_s
   #
   # @param [Boolean] casts
   #   true if you want the Drawingelement object to cast
@@ -89,7 +88,6 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #   # Add the face to the entities in the model
   #   face = entities.add_face pts
   #   status = face.casts_shadows?
-  #   UI.messagebox status.to_s
   #
   # @return [Boolean]
   #
@@ -176,7 +174,6 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #   # Add the face to the entities in the model
   #   face = entities.add_face pts
   #   status = face.hidden?
-  #   UI.messagebox "hidden? " + status.to_s
   #
   # @return [Boolean]
   #
@@ -281,8 +278,8 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #     # Returns nil if not successful, path if successful.
   #     # Should return a texture object.
   #     m.texture = "c:\\My Textures\\Carpet.jpg"
-  #   rescue
-  #     UI.messagebox $!.message
+  #   rescue => exception
+  #     puts exception.message
   #   end
   #   # You will see the material applied when you reverse the box's faces
   #   material = face.material = m
@@ -315,7 +312,6 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #
   #   # Make the face not receive shadows.
   #   status = face.receives_shadows = false
-  #   UI.messagebox status.to_s
   #
   # @param [Boolean] receive
   #   true if you want the Drawingelement object to
@@ -343,7 +339,6 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #   # Add the face to the entities in the model
   #   face = entities.add_face pts
   #   status = face.receives_shadows?
-  #   UI.messagebox status.to_s
   #
   # @return [Boolean]
   #
@@ -351,7 +346,7 @@ class Sketchup::Drawingelement < Sketchup::Entity
   def receives_shadows?
   end
 
-  # The visible= method is used to set the visible status for an element. This
+  # The {#visible=} method is used to set the visible status for an element. This
   # method performs an opposite function to the hidden= method.
   #
   # @example
@@ -370,16 +365,16 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #   status = face.visible = false
   #
   # @param [Boolean] visibility
-  #   true if you want to hide the element, false if not
-  #
-  # @return [Boolean] true if the element has been hidden, false if
-  #   the element has not been hidden.
+  #   true if you want to make the element visible, false if not
   #
   # @version SketchUp 6.0
   def visible=(visibility)
   end
 
-  # The visible? method is used to get the visible status for an element.
+  # The {#visible?} method checks if a Drawingelement object is not explicitly hidden (i.e. its
+  # hidden property is false). However, this method's return value alone does not guarantee that the
+  # element is visible in the model view. Its tag or parent elements can also be hidden. Some element
+  # types can also be hidden by rendering options (Styles).
   #
   # @example
   #   depth = 100
@@ -399,6 +394,8 @@ class Sketchup::Drawingelement < Sketchup::Entity
   #
   # @return [Boolean]
   #
+  # @see Sketchup::Model#drawing_element_visible?
+  #
   # @version SketchUp 6.0
   def visible?
   end

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Edge class contains methods modifying and extracting information for
@@ -324,7 +324,7 @@ class Sketchup::Edge < Sketchup::Drawingelement
   def soft?
   end
 
-  # The split method is used to  to split an edge into two or more distinct
+  # The {#split} method is used to split an edge into two or more distinct
   # edges. If a Point3d is given, it must be a point that is on the Edge.
   #
   # If a Float is given, it is a number between 0 and 1 that gives the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The EdgeUse class defines how an Edge is used in the definition of a Face.
@@ -23,7 +23,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   edge = edgeuse.edge
   #
-  # @return edge - an Edge object used by this edge use
+  # @return [Sketchup::Edge] an Edge object used by this edge use
   #
   # @version SketchUp 6.0
   def edge
@@ -45,7 +45,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   vector3d = edgeuse.end_vertex_normal
   #
-  # @return vector3d - a vector3d object if successful.
+  # @return [Geom::Vector3d] a vector3d object if successful.
   #
   # @version SketchUp 6.0
   def end_vertex_normal
@@ -66,7 +66,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   face = edgeuse.face
   #
-  # @return face - a Face object used by this edge use
+  # @return [Sketchup::Face] a Face object used by this edge use
   #
   # @version SketchUp 6.0
   def face
@@ -87,7 +87,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   loop = edgeuse.loop
   #
-  # @return loop - a Loop object that contains this edge use.
+  # @return [Sketchup::Loop] a Loop object that contains this edge use.
   #
   # @version SketchUp 6.0
   def loop
@@ -108,7 +108,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   next_edgeuse = edgeuse.next
   #
-  # @return edgeuse - the next EdgeUse object in a loop
+  # @return [Sketchup::EdgeUse] the next EdgeUse object in a loop
   #
   # @version SketchUp 6.0
   def next
@@ -136,7 +136,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[1]
   #   partners = edgeuse.partners
   #
-  # @return array - an array of partner Edge Use objects.
+  # @return [Array<Sketchup::EdgeUse>] an array of partner Edge Use objects.
   #
   # @version SketchUp 6.0
   def partners
@@ -157,7 +157,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   previous_edgeuse = edgeuse.previous
   #
-  # @return edgeuse - the previous Edge Use object in the loop
+  # @return [Sketchup::EdgeUse] the previous Edge Use object in the loop
   #
   # @version SketchUp 6.0
   def previous
@@ -180,7 +180,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   reversed = edgeuse.reversed?
   #
-  # @return [Boolean] boolean - true if reversed, false if not reversed.
+  # @return [Boolean] true if reversed, false if not reversed.
   #
   # @version SketchUp 6.0
   def reversed?
@@ -202,7 +202,7 @@ class Sketchup::EdgeUse < Sketchup::Entity
   #   edgeuse = edgeuses[0]
   #   vector3d = edgeuse.start_vertex_normal
   #
-  # @return vector3d - a vector3d object if successful.
+  # @return [Geom::Vector3d] a vector3d object if successful.
   #
   # @version SketchUp 6.0
   def start_vertex_normal

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Entities} class is a collection of Entity objects, either in a
@@ -520,8 +520,7 @@ class Sketchup::Entities
   def add_faces_from_mesh(polygon_mesh, smooth_flags = Geom::PolygonMesh::AUTO_SOFTEN|Geom::PolygonMesh::SMOOTH_SOFT_EDGES, f_material = nil, b_material = nil)
   end
 
-  # The add_group method is used to create an empty group or a group with
-  # entities.
+  # The {#add_group} method is used to create a new group.
   #
   # @example
   #   model = Sketchup.active_model
@@ -582,8 +581,8 @@ class Sketchup::Entities
   def add_image(path, point, width, height = 0.0)
   end
 
-  # The add_instance method adds a component instance to the collection of
-  # entities.
+  # The {#add_instance} method adds a group or component instance to the collection of
+  # entities using an existent definition.
   #
   # @example
   #   model = Sketchup.active_model
@@ -694,7 +693,9 @@ class Sketchup::Entities
   def add_observer(observer)
   end
 
-  # The add_section_plane method adds a section plane object to the entities.
+  # Adds a section plane object to the entities.
+  #
+  # Refer to the {Geom} module for information on how planes are represented.
   #
   # @example
   #   # Create a section plane
@@ -705,16 +706,53 @@ class Sketchup::Entities
   #   # Make sure section planes are visible
   #   model.rendering_options['DisplaySectionPlanes'] = true
   #
-  # @param plane
-  #   the geometric plane where the SectionPlane object is to
-  #   be created. Refer to the Geom module for information on
-  #   how planes are represented.
+  # @overload add_section_plane(point, vector)
+  #
+  #   @param [Geom::Point3d] point
+  #   @param [Geom::Vector3d] vector
+  #
+  # @overload add_section_plane(plane)
   #
-  # @return [Sketchup::SectionPlane, nil] the created SectionPlane object if
-  #   successful, nil on failure.
+  #   @param [Array(Geom::Point3d), Geom::Vector3d]] plane
+  #
+  # @overload add_section_plane(plane)
+  #
+  #   @param [Array(Integer, Integer, Integer, Integer)] plane
+  #     Plane coefficents.
+  #
+  # @return [Sketchup::SectionPlane, nil]
   #
   # @version SketchUp 2014
-  def add_section_plane(plane)
+  def add_section_plane(*args)
+  end
+
+  # The {#add_snap} method is used to create a new {Sketchup::Snap}.
+  #
+  # @example
+  #   entities = Sketchup.active_model.entities
+  #   snap = entities.add_snap(ORIGIN, X_AXIS)
+  #
+  # @overload add_snap(position, direction)
+  #
+  #   With a position and a direction vector provided, but no up vector, SketchUp tries
+  #   to keep the Snap upright.
+  #   @param [Geom::Point3d] position
+  #   @param [Geom::Vector3d] direction
+  #
+  # @overload add_snap(position, direction, up)
+  #
+  #   @param [Geom::Point3d] position
+  #   @param [Geom::Vector3d] direction
+  #   @param [Geom::Vector3d] up
+  #
+  # @raise ArgumentError if +direction+ and +up+ are parallel.
+  #
+  # @return [Sketchup::Snap]
+  #
+  # @see Sketchup::Snap
+  #
+  # @version SketchUp 2025.0
+  def add_snap(*args)
   end
 
   # The {#add_text} method adds a note or label text entity to the entities.
@@ -825,9 +863,9 @@ class Sketchup::Entities
   #   }
   #
   # @note While using {Sketchup::Entities#build} it is important to not
-  #   add or remove vertices by other means of the builder. Also don't modify the
-  #   position of the vertices in the {Sketchup::Entities} container geometry is
-  #   added to. Doing so can break the vertex-cache that de-duplicates the vertices.
+  #   add or remove vertices by other means than the builder. Also don't modify the
+  #   position of the vertices in the {Sketchup::Entities} collection. Doing so can break the
+  #   vertex-cache that de-duplicates the vertices.
   #
   # @return [nil]
   #
@@ -1001,8 +1039,10 @@ class Sketchup::Entities
   def fill_from_mesh(polygon_mesh, weld_vertices = true, smooth_flags = Geom::PolygonMesh::AUTO_SOFTEN|Geom::PolygonMesh::SMOOTH_SOFT_EDGES, f_material = nil, b_material = nil)
   end
 
-  # The intersect_with method is used to intersect an entities, component
-  # instance, or group object with a entities object.
+  # The {#intersect_with} method is used to intersect a Sketchup::Entities, Sketchup::Component,
+  # or Sketchup::Group object with a entities object.
+  #
+  # empty if no intersection(s) were found.
   #
   # @example
   #   model = Sketchup.active_model
@@ -1048,7 +1088,7 @@ class Sketchup::Entities
   # @param [Sketchup::Entity, Array<Sketchup::Entity>] entities2
   #   A single entity, or an array of entities.
   #
-  # @return [nil]
+  # @return [Array<Sketchup::Edge>] The intersecting edges created. This array may be
   #
   # @version SketchUp 6.0
   def intersect_with(recurse, transform1, entities1, transform2, hidden, entities2)

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::EntitiesBuilder} is an interface to generate bulk geometry

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to {Sketchup::Entities}