sketchup-api-stubs 0.7.10 → 0.7.11

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # References a collection of style attributes that determine the visual
@@ -102,6 +102,9 @@ class Layout::Style
   STROKE_PATTERN_SHORT_DASH = nil # Stub value.
   STROKE_PATTERN_SOLID = nil # Stub value.
 
+  STRIKETHROUGH_NONE = nil # Stub value.
+  STRIKETHROUGH_SINGLE = nil # Stub value.
+
   SUPER_SCRIPT = nil # Stub value.
 
   SUB_SCRIPT = nil # Stub value.
@@ -1471,6 +1474,49 @@ class Layout::Style
   def text_italic=(italic)
   end
 
+  # The {#text_strikethrough} method returns the text strike through type, or +nil+ if the
+  # {Layout::Style} does not have a value for that setting.
+  #
+  # The strikethrough type can be one of the following values:
+  # [+Layout::Style::STRIKETHROUGH_NONE+]
+  # [+Layout::Style::STRIKETHROUGH_SINGLE+]
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   page = doc.pages.first
+  #   entity = page.entities.first
+  #   style = entity.style
+  #   strikethrough_type = style.text_strikethrough
+  #
+  # @return [Integer, nil]
+  #
+  # @version LayOut 2026.0
+  def text_strikethrough
+  end
+
+  # The {#text_strikethrough=} method sets the text strike through type.
+  #
+  # The strikethrough type can be one of the following values:
+  # [+Layout::Style::STRIKETHROUGH_NONE+]
+  # [+Layout::Style::STRIKETHROUGH_SINGLE+]
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   page = doc.pages.first
+  #   entity = page.entities.first
+  #   style = entity.style
+  #   style.text_strikethrough = Layout::Style::STRIKETHROUGH_SINGLE
+  #   # Set the style to apply changes
+  #   entity.style = style
+  #
+  # @param [Integer] strikethrough_type
+  #
+  # @raise [ArgumentError] if strikethrough_type is not a valid strike through type
+  #
+  # @version LayOut 2026.0
+  def text_strikethrough=(strikethrough_type)
+  end
+
   # The {#text_underline} method returns the text underline type, or +nil+ if the
   # {Layout::Style} does not have a value for that setting.
   #

data/lib/sketchup-api-stubs/stubs/Layout/Table.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A {Layout::Table} is a series of rows and columns that holds data.

data/lib/sketchup-api-stubs/stubs/Layout/TableCell.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A {Layout::TableCell} is a single cell from a table that contains data.

data/lib/sketchup-api-stubs/stubs/Layout/TableColumn.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A {Layout::TableColumn} is a single column from a table.

data/lib/sketchup-api-stubs/stubs/Layout/TableRow.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A {Layout::TableColumn} is a single row from a table.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The LayOut module is the root of the LayOut Ruby API. Many of the classes in

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Because length units are used so often in SketchUp, a special class has been
@@ -8,6 +8,8 @@
 # Internally, all lengths in SketchUp are stored in inches. The Length class
 # stores values in inches as well. A number of methods have been added to the
 # Ruby Numeric class to do units conversions.
+# {Find more info about units and lengths in this
+# article}[https://developer.sketchup.com/article-lengthsandunits].
 #
 # The setting for the Length Format and Length Unit can be retrieved from the
 # {Sketchup::Model#options} by querying the +"UnitsOptions"+
@@ -56,6 +58,12 @@
 # @note Prior to SketchUp 2015, +Length+ used to be derived from +Float+. This
 #   is no longer the case.
 #
+# @note When serializing a Length object to a string to save for later use, e.g.
+#   in a config file, first convert them to Float objects. The string representation
+#   of a Length is rounded and uses the local decimal separator which can lead to
+#   data loss and portability issues. The string representation is intended for
+#   humans, not computers.
+#
 # @version SketchUp 6.0
 class Length < Float
 

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A number of methods have been added to the Ruby Numeric class to do units

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Animation} interface is implemented to create animations
@@ -6,24 +6,47 @@
 # {Sketchup::View}. To make your own, build a Ruby class that contains the
 # methods described below:
 #
-#   # This is an example of a simple animation that floats the camera up to
-#   # a z position of 200". The only required method for an animation is
-#   # nextFrame. It is called whenever you need to show the next frame of
-#   # the animation. If nextFrame returns false, the animation will stop.
-#   class FloatUpAnimation
+#   # This example demonstrates a simple animation with implementation of
+#   # the optional callback method stop, which is invoked
+#   # by SketchUp during specific animation events.
+#   class SimpleFloatAnimation
+#     def initialize
+#       @speed = 1.0           # Camera movement speed
+#       puts "Animation initialized"
+#     end
+#
+#     # Required method - called for each animation frame
 #     def nextFrame(view)
+#       # Move camera upward
 #       new_eye = view.camera.eye
-#       new_eye.z = new_eye.z + 1.0
+#       new_eye.z = new_eye.z + @speed
 #       view.camera.set(new_eye, view.camera.target, view.camera.up)
 #       view.show_frame
+#
+#       # Continue animation until reaching maximum height
 #       return new_eye.z < 500.0
 #     end
-#   end
 #
-#   # This adds an item to the Camera menu to activate our custom animation.
-#   UI.menu("Camera").add_item("Run Float Up Animation") {
-#     Sketchup.active_model.active_view.animation = FloatUpAnimation.new
-#   }
+#     # Optional callback - called by SketchUp when animation is stopped
+#     # Note: This method is called automatically by SketchUp and cannot
+#     # be called directly to stop an animation
+#     def stop
+#       puts "Animation was stopped by SketchUp"
+#       # Cleanup code when animation ends
+#     end
+#    end
+#
+#    # Add menu item to start the animation
+#    UI.menu("Camera").add_item("Start Animation") {
+#      animation = SimpleFloatAnimation.new
+#      Sketchup.active_model.active_view.animation = animation
+#    }
+#
+#    # To stop the animation programmatically:
+#    UI.menu("Camera").add_item("Stop Animation") {
+#      # Setting animation to nil will trigger the stop method in our animation class
+#      Sketchup.active_model.active_view.animation = nil
+#    }
 #
 # {Sketchup::Animation} objects are activated by using the
 # {Sketchup::View#animation=} method on a {Sketchup::View}
@@ -32,6 +55,35 @@
 #
 #   Sketchup.active_model.active_view.animation = nil
 #
+#
+# ==Managing Multiple Animations:
+#
+# While only one animation object can be active on a {Sketchup::View} at any
+# given time, you can create a composite animation class to manage multiple
+# animations simultaneously. This approach allows you to animate different
+# elements, such as objects and the camera, within a single animation framework.
+#
+# Example:  Combining Animations
+#
+#   class CombinedAnimation
+#     def initialize(object_animation, camera_animation)
+#       @object_animation = object_animation
+#       @camera_animation = camera_animation
+#     end
+#
+#     def nextFrame(view)
+#       @object_animation.nextFrame(view)
+#       @camera_animation.nextFrame(view)
+#       true
+#     end
+#   end
+#
+#   # Usage
+#   object_animation = RotateAnimation.new
+#   camera_animation = RotateCamera.new(0.01)
+#   combined_animation = CombinedAnimation.new(object_animation, camera_animation)
+#   Sketchup.active_model.active_view.animation = combined_animation
+#
 # @abstract Implement the methods described in this class to create a an
 #   animation. You can not sub-class this class because it is not defined by
 #   the API.
@@ -131,7 +183,7 @@ class Sketchup::Animation
   #     end
   #   end
   #
-  # @note Do not call {#Sketchup::View#animation=} from this method. This will
+  # @note Do not call {Sketchup::View#animation=} from this method. This will
   #   cause a recursive loop and crash SketchUp 2017 and earlier versions.
   #   As of SketchUp 2018 this will raise a +RunTimeError+.
   #

data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.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 application events.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # An ArcCurve is a Curve that makes up part of a circle. This is the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The AttributeDictionaries class is a collection of all of the
@@ -33,14 +33,9 @@ class Sketchup::AttributeDictionaries < Sketchup::Entity
   #
   # @example
   #   model = Sketchup.active_model
+  #   value = model.set_attribute("my_dictionary", "test", 110)
   #   attrdicts = model.attribute_dictionaries
-  #   # Iterates through all dictionaries and prints to screen.
   #   dict = attrdicts['my_dictionary']
-  #   if dict
-  #     UI.messagebox("Found: " + dict.to_s)
-  #   else
-  #     UI.messagebox("No dictionary found.")
-  #   end
   #
   # @param [String] key
   #   The name of the attribute dictionary.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The AttributeDictionary class allows you to attach arbitrary collections of
@@ -185,6 +185,20 @@ class Sketchup::AttributeDictionary < Sketchup::Entity
   def each_pair
   end
 
+  # The {#empty?} method is used to check if the attribute dictionary is empty.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   attribute_dictionary = model.attribute_dictionary("example", true)
+  #   attribute_dictionary["attribute_one"] = "1"
+  #   attribute_dictionary.empty? # Returns false
+  #
+  # @return [Boolean] true if the attribute dictionary is empty, false otherwise
+  #
+  # @version SketchUp 2025.0
+  def empty?
+  end
+
   # The keys method is used to retrieve an array with all of the attribute keys.
   #
   # @example
@@ -231,8 +245,7 @@ class Sketchup::AttributeDictionary < Sketchup::Entity
   #   attrdict["attr_one"] = "one"
   #   attrdict["attr_two"] = "two"
   #
-  #   # Show the name.
-  #   UI.messagebox attrdict.name
+  #   puts attrdict.name
   #
   # @return [String] the name of the attribute dictionary if
   #   successful

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # SketchUp's drawing axes consist of three colored lines (red, green, blue),
@@ -29,18 +29,18 @@ class Sketchup::Axes < Sketchup::Entity
   def axes
   end
 
-  # The origin method returns the origin of the axes.
+  # The {#origin} method returns the origin of the axes.
   #
   # @example
   #   point = Sketchup.active_model.axes.origin
   #
-  # @return Point3d - the origin for the axes.
+  # @return [Geom::Point3d]
   #
   # @version SketchUp 2016
   def origin
   end
 
-  # The set method allows the axes to be manipulated. The axes must always be
+  # The {#set} method allows the axes to be manipulated. The axes must always be
   # orthogonal, otherwise an error is thrown.
   #
   # @example
@@ -60,7 +60,7 @@ class Sketchup::Axes < Sketchup::Entity
   # @param zaxis
   #   Vector3d - The z axis to set.
   #
-  # @return Axes - the axes object being set.
+  # @return [Sketchup::Axes] - the axes object being set.
   #
   # @version SketchUp 2016
   def set(origin, xaxis, yaxis, zaxis)
@@ -90,7 +90,7 @@ class Sketchup::Axes < Sketchup::Entity
   def to_a
   end
 
-  # The transformation method returns the transformation of the axes. This is
+  # The {#transformation} method returns the transformation of the axes. This is
   # useful when creating tools that respect the model's drawing axes.
   #
   # @example
@@ -107,40 +107,40 @@ class Sketchup::Axes < Sketchup::Entity
   #   points.each { |point| point.transform!(tr) }
   #   Sketchup.active_model.active_entities.add_face(points)
   #
-  # @return Transformation - the transformation for the axes.
+  # @return [Geom::Transformation] - the transformation for the axes.
   #
   # @version SketchUp 2016
   def transformation
   end
 
-  # The xaxis method returns the x axis of the axes.
+  # The {#xaxis} method returns the x axis of the axes.
   #
   # @example
   #   vector = Sketchup.active_model.axes.xaxis
   #
-  # @return Vector3d - the x axis for the axes.
+  # @return [Geom::Vector3d] - the x axis for the axes.
   #
   # @version SketchUp 2016
   def xaxis
   end
 
-  # The yaxis method returns the y axis of the axes.
+  # The {#yaxis} method returns the y axis of the axes.
   #
   # @example
   #   vector = Sketchup.active_model.axes.yaxis
   #
-  # @return Vector3d - the y axis for the axes.
+  # @return [Geom::Vector3d] - the y axis for the axes.
   #
   # @version SketchUp 2016
   def yaxis
   end
 
-  # The zaxis method returns the z axis of the axes.
+  # The {#zaxis} method returns the z axis of the axes.
   #
   # @example
   #   vector = Sketchup.active_model.axes.zaxis
   #
-  # @return Vector3d - the z axis for the axes.
+  # @return [Geom::Vector3d] - the z axis for the axes.
   #
   # @version SketchUp 2016
   def zaxis

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Behavior class is used to control the "behavior" of components, which
@@ -52,26 +52,20 @@ class Sketchup::Behavior < Sketchup::Entity
   #   definitions = model.definitions
   #   path = Sketchup.find_support_file "Bed.skp",
   #     "Components/Components Sampler/"
-  #
-  #   begin
-  #     definition = definitions.load path
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #
+  #   definition = definitions.load path
   #   behavior = definition.behavior
   #   b = behavior.always_face_camera?
   #   if (b)
-  #     UI.messagebox b
+  #     puts "Component faces camera"
   #   else
-  #     UI.messagebox "Always Face Camera is equal to false"
+  #     puts "Component does not face camera"
   #   end
   #   status = behavior.always_face_camera = true
   #   b = behavior.always_face_camera?
   #   if (b)
-  #     UI.messagebox b
+  #     puts "Alwas Face Camera is equal to true"
   #   else
-  #     UI.messagebox "Failure"
+  #     puts "Failure"
   #   end
   #
   # @return [Boolean] behavior - true if the component is set to always face
@@ -236,8 +230,8 @@ class Sketchup::Behavior < Sketchup::Entity
   #     "Components/Components Sampler/"
   #   begin
   #     definition = definitions.load path
-  #   rescue
-  #     UI.messagebox $!.message
+  #   rescue => exception
+  #     puts exception.message
   #   end
   #
   # @return [Boolean] status - true if the component's is to be cast from the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Camera class contains methods for creating and manipulating a camera.
@@ -66,7 +66,7 @@ class Sketchup::Camera
   # @example
   #   Sketchup.active_model.active_view.camera.center_2d
   #
-  # @return [Geom::Point3d] ]
+  # @return [Geom::Point3d]
   #
   # @version SketchUp 2015
   def center_2d
@@ -312,8 +312,8 @@ class Sketchup::Camera
   def initialize(*args)
   end
 
-  # The {#is_2d?} method indicates if the camera two-point perspective or match photo
-  # mode.
+  # The {#is_2d?} method indicates whether the camera mode is two-point perspective or match photo
+  # mode, as opposed to a normal perspective or parallel projection camera.
   #
   # @example
   #   Sketchup.active_model.active_view.camera.is_2d?
@@ -365,7 +365,7 @@ class Sketchup::Camera
   # @example
   #   Sketchup.active_model.active_view.camera.scale_2d
   #
-  # @return float
+  # @return [Float]
   #
   # @version SketchUp 2015
   def scale_2d
@@ -388,7 +388,7 @@ class Sketchup::Camera
   # @param [Geom::Point3d] target
   #   See {#target}.
   #
-  # @param [Geom::Point3d] up
+  # @param [Geom::Vector3d] up
   #   See {#up}.
   #
   # @return [Sketchup::Camera]
@@ -432,7 +432,7 @@ class Sketchup::Camera
   #   camera = Sketchup::Camera.new
   #   xaxis = camera.xaxis
   #
-  # @return [Geom::Vector3d] ]
+  # @return [Geom::Vector3d]
   #
   # @version SketchUp 6.0
   def xaxis
@@ -449,7 +449,7 @@ class Sketchup::Camera
   #   # 0.0, 1.0, 0.0
   #   yaxis = camera.yaxis
   #
-  # @return [Geom::Vector3d] ]
+  # @return [Geom::Vector3d]
   #
   # @version SketchUp 6.0
   def yaxis
@@ -462,14 +462,9 @@ class Sketchup::Camera
   # @example
   #   camera = Sketchup::Camera.new
   #   # 0.0, 1.0, 0.0
-  #   v = camera.zaxis
-  #   if (v)
-  #     UI.messagebox v.to_s
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
+  #   vector = camera.zaxis
   #
-  # @return vector - a Vector3d object if successful
+  # @return [Geom::Vector3d]
   #
   # @version SketchUp 6.0
   def zaxis

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ClassificationSchema class represent schemas loaded in the model.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Classifications class is a container/manager for all classifications in
@@ -77,7 +77,7 @@ class Sketchup::Classifications
   #
   # @example
   #   c = Sketchup.active_model.classifications
-  #   file = Sketchup.find_support_file('IFC 4.skc', 'Classifications')
+  #   file = Sketchup.find_support_file('IFC4.skc', 'Classifications')
   #   status = c.load_schema(file) if !file.nil?
   #
   # @param file

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Color class is used to create and manipulate colors within SketchUp

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentDefinition} class is used to define the contents for
@@ -37,7 +37,7 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   #   c2=Sketchup.find_support_file "Fence.skp",
   #     "Components/Components Sampler/"
   #   if c1 <=> c2
-  #     UI.messagebox("c1 sorts before c2")
+  #     puts "c1 sorts before c2"
   #   end
   #
   # @param [Sketchup::ComponentDefinition] compdef2
@@ -58,9 +58,7 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   #     "Components/Components Sampler/"
   #   c2=Sketchup.find_support_file "Fence.skp",
   #     "Components/Components Sampler/"
-  #   if c1 == c2
-  #     UI.messagebox("These definitions are the same.")
-  #   end
+  #   c1 == c2
   #
   # @param [Sketchup::ComponentDefinition] compdef2
   #   The second component definition in the comparison.
@@ -258,8 +256,15 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   def guid
   end
 
-  # The hidden method is used to determine if this component definition should
-  # be hidden on the component browser.
+  # The {#hidden?} method is used to determine if this component definition is
+  # hidden in the component browser.
+  #
+  # This is based on how its instances are placed
+  # in the model hierarchy. For more details, see
+  # {this article}[https://developer.sketchup.com/article-hiddensubcomponents].
+  #
+  # In addition, component definitions used by Groups and Images are always hidden
+  # in the Component Browser. See {#group?} and {#image?}.
   #
   # @example
   #   componentdefinition = Sketchup.active_model.definitions[0]
@@ -277,12 +282,6 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   # @example
   #   componentdefinition = Sketchup.active_model.definitions[0]
   #   status = componentdefinition.image?
-  #   if (status)
-  #     UI.messagebox "Component definition defines an image"
-  #   else
-  #     UI.messagebox status.to_s
-  #     UI.messagebox "Component definition does not define an image"
-  #   end
   #
   # @return [Boolean]
   #
@@ -408,6 +407,21 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   def live_component?
   end
 
+  # The {#load_time} method gets the load time of the component definition. For an internal
+  # component definition, this is the time that it was created. For an external component
+  # definition, this is the time that it was added to the model.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   definition = model.definitions.first
+  #   definition.load_time
+  #
+  # @return [Time]
+  #
+  # @version SketchUp 2025.0
+  def load_time
+  end
+
   # The name method retrieves the name of the component definition.
   #
   # @example
@@ -542,7 +556,7 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   #     See {Sketchup::Model#save} for supported values.
   #   @version SketchUp 2022.0
   #
-  # @return [Boolean] true if successful
+  # @return [Boolean] true if successful, false otherwise
   def save_as(*args)
   end