autocad 0.4.6 → 0.5

data/sig/generated/autocad/line.rbs

@@ -1,25 +1,128 @@
-# Generated from lib/autocad/line.rb with RBS::Inline
-
-module Autocad
-  class Line < Element
-    def length: () -> untyped
-
-    def line?: () -> untyped
-
-    def start_point: () -> untyped
-
-    def end_point: () -> untyped
-  end
-
-  class Circle < Element
-    def center: () -> untyped
-
-    def radius: () -> untyped
-  end
-
-  class Polyline < Element
-    def length: () -> untyped
-
-    def coordinates: () -> untyped
-  end
-end
+# Generated from lib/autocad/line.rb with RBS::Inline
+
+module Autocad
+  # Represents a line entity in AutoCAD, providing access to geometric properties and spatial relationships.
+  #
+  # Key Features:
+  # - Length calculation
+  # - Start/end point coordinates
+  # - 3D orientation properties
+  # - Thickness control
+  # - Geometric vector analysis
+  #
+  # Geometric Relationships:
+  #        Normal (Z-axis)
+  #           ↑
+  #           │
+  # Start ●───┼───● End
+  #           │
+  #           └─── Delta Vector
+  #
+  # @example Create and query a line
+  #   line = drawing.model.add_line([0,0,0], [5,5,0])
+  #   puts line.length  # => 7.0710678118654755
+  #   puts line.delta   # => (5.0, 5.0, 0.0)
+  class Line < Element
+    # Calculates the linear length of the line segment.
+    #
+    # @example
+    #   line = drawing.model.add_line([0,0,0], [5,5,0])
+    #   puts line.length  # => 7.0710678118654755
+    #
+    # @return [Float] The length of the line
+    # @rbs return float
+    def length: () -> float
+
+    # Type-check method confirming this is a line entity.
+    #
+    # @example
+    #   line.line?  # => true
+    #
+    # @return [Boolean] Always returns true for Line objects
+    # @rbs return bool
+    def line?: () -> bool
+
+    # 3D coordinates of the line's starting point in World Coordinate System (WCS).
+    #
+    # @example
+    #   start = line.start_point
+    #   puts start  # => (0.0, 0.0, 0.0)
+    #
+    # @return [Point3d] The start point coordinates
+    # @rbs return Point3d
+    def start_point: () -> Point3d
+
+    # 3D coordinates of the line's endpoint in World Coordinate System (WCS).
+    #
+    # @example
+    #   ending = line.end_point
+    #   puts ending  # => (5.0, 5.0, 0.0)
+    #
+    # @return [Point3d] The end point coordinates
+    # @rbs return Point3d
+    def end_point: () -> Point3d
+
+    # Unit vector perpendicular to the line's plane (Z-axis direction by default).
+    #
+    # Properties:
+    # - Always returns unit vector (magnitude = 1)
+    # - Affects shading and 3D operations
+    #
+    # @example
+    #   line.normal  # => (0.0, 0.0, 1.0)
+    #
+    # @return [Point3d] The normal vector
+    # @rbs return Point3d
+    def normal: () -> Point3d
+
+    # Extrusion thickness along the normal vector (3D effect).
+    #
+    # Note:
+    # - Positive values extrude in normal direction
+    # - Negative values extrude opposite direction
+    # - 0 = 2D line
+    #
+    # @example
+    #   line.thickness = 2.5  # Creates 3D prism
+    #
+    # @return [Float] The current thickness value
+    # @rbs return float
+    def thickness: () -> float
+
+    # Directional vector from start to end point (equivalent to `end_point - start_point`).
+    #
+    # Mathematical Properties:
+    # - X/Y/Z components = coordinate differences
+    # - Magnitude = line length
+    #
+    # @example
+    #   line.delta  # => (5.0, 5.0, 0.0)
+    #   line.delta.magnitude == line.length  # => true
+    #
+    # @return [Point3d] The vector from start to end point
+    # @rbs return Point3d
+    def delta: () -> Point3d
+  end
+
+  class Circle < Element
+    # The center point of the circle in World Coordinate System (WCS)
+    # @rbs return Point3d
+    def center: () -> Point3d
+
+    # The radius of the circle
+    # @rbs return float
+    def radius: () -> float
+
+    def inspect: () -> untyped
+  end
+
+  class Polyline < Element
+    # The total length of all polyline segments
+    # @rbs return float
+    def length: () -> float
+
+    # Array of all vertex coordinates in the polyline
+    # @rbs return Array[Point3d]
+    def coordinates: () -> Array[Point3d]
+  end
+end

data/sig/generated/autocad/message_box.rbs

@@ -1,81 +1,81 @@
-# Generated from lib/autocad/message_box.rb with RBS::Inline
-
-module WinAPI
-  extend Fiddle::Importer
-
-  include Fiddle::BasicTypes
-
-  include Fiddle::Win32Types
-
-  def get_foreground_window: () -> untyped
-
-  def self.get_text_of_active_window: () -> untyped
-
-  module MB
-    OK: ::Integer
-
-    CANCEL: ::Integer
-
-    ABORT: ::Integer
-
-    RETRY: ::Integer
-
-    IGNORE: ::Integer
-
-    YES: ::Integer
-
-    NO: ::Integer
-
-    module ICON
-      ERROR: ::Integer
-
-      QUESTION: ::Integer
-
-      INFORMATION: ::Integer
-
-      WARNING: ::Integer
-    end
-
-    module BTN
-      OK: ::Integer
-
-      OKCANCEL: ::Integer
-
-      ABORTRETRYIGNORE: ::Integer
-
-      YESNO: ::Integer
-    end
-  end
-end
-
-# msgbox_yesno('Do you want to continue?') do |y|
-#   if y
-#     puts 'proceeding with ...'
-#   else
-#     puts 'cancelled ...'
-#   end
-# end
-#
-# msgbox('We are finished here')
-#
-# loop do
-#   puts WinAPI.get_text_of_active_window
-#   sleep 1
-# end
-module Kernel
-  # @rbs str: String
-  # @rbs return String
-  def self?.L: (String str) -> String
-
-  # @example
-  # msg_box_yesno("Do you want to continue") do |y|
-  #  if y
-  #    puts "proceeding"
-  # else
-  #   puts "cancelled"
-  # end
-  # end
-  def self?.msgbox_yesno: (untyped content, ?title: untyped) -> untyped
-
-  def self?.msgbox: (untyped content, ?title: untyped) -> untyped
-end
+# Generated from lib/autocad/message_box.rb with RBS::Inline
+
+module WinAPI
+  extend Fiddle::Importer
+
+  include Fiddle::BasicTypes
+
+  include Fiddle::Win32Types
+
+  def get_foreground_window: () -> untyped
+
+  def self.get_text_of_active_window: () -> untyped
+
+  module MB
+    OK: ::Integer
+
+    CANCEL: ::Integer
+
+    ABORT: ::Integer
+
+    RETRY: ::Integer
+
+    IGNORE: ::Integer
+
+    YES: ::Integer
+
+    NO: ::Integer
+
+    module ICON
+      ERROR: ::Integer
+
+      QUESTION: ::Integer
+
+      INFORMATION: ::Integer
+
+      WARNING: ::Integer
+    end
+
+    module BTN
+      OK: ::Integer
+
+      OKCANCEL: ::Integer
+
+      ABORTRETRYIGNORE: ::Integer
+
+      YESNO: ::Integer
+    end
+  end
+end
+
+# msgbox_yesno('Do you want to continue?') do |y|
+#   if y
+#     puts 'proceeding with ...'
+#   else
+#     puts 'cancelled ...'
+#   end
+# end
+#
+# msgbox('We are finished here')
+#
+# loop do
+#   puts WinAPI.get_text_of_active_window
+#   sleep 1
+# end
+module Kernel
+  # @rbs str: String
+  # @rbs return String
+  def self?.L: (String str) -> String
+
+  # @example
+  # msg_box_yesno("Do you want to continue") do |y|
+  #  if y
+  #    puts "proceeding"
+  # else
+  #   puts "cancelled"
+  # end
+  # end
+  def self?.msgbox_yesno: (untyped content, ?title: untyped) -> untyped
+
+  def self?.msgbox: (untyped content, ?title: untyped) -> untyped
+end

data/sig/generated/autocad/model.rbs

@@ -1,41 +1,115 @@
-# Generated from lib/autocad/model.rb with RBS::Inline
-
-module Autocad
-  module ModelTrait
-    def each: () -> untyped
-
-    # @rbs pt1: Autocad::Point3d
-    # @rbs return Autocad::Line
-    def add_line: (Autocad::Point3d pt1, untyped pt2, ?layer: untyped) -> Autocad::Line
-
-    # @rbs center: [] | Point3d -- center of circle
-    # @rbs radius:
-    def add_circle: ([ ] | Point3d center, untyped radius) -> untyped
-
-    def add_rectangle: (untyped upper_left, untyped lower_right) -> untyped
-
-    def add_spline: (untyped points) -> untyped
-
-    def drawing: () -> untyped
-  end
-
-  class PaperSpace
-    include ModelTrait
-
-    attr_reader app: untyped
-
-    attr_reader ole_obj: untyped
-
-    def initialize: (untyped ole, untyped app) -> untyped
-  end
-
-  class ModelSpace
-    include ModelTrait
-
-    attr_reader app: untyped
-
-    attr_reader ole_obj: untyped
-
-    def initialize: (untyped ole, untyped app) -> untyped
-  end
-end
+# Generated from lib/autocad/model.rb with RBS::Inline
+
+module Autocad
+  module ModelTrait
+    # Iterate through all elements in the model space
+    # @rbs return Enumerator[Autocad::Element]
+    # @rbs &: (Autocad::Element) -> void
+    def each: () { (Autocad::Element) -> void } -> Enumerator[Autocad::Element]
+
+    # Check if this model is an external reference
+    # @rbs return bool
+    def xref?: () -> bool
+
+    # Attach an external reference to the model
+    # @rbs path: String
+    # @rbs name: String
+    # @rbs pt: Array[Numeric] | Autocad::Point3d
+    # @rbs x_scale: Numeric
+    # @rbs y_scale: Numeric
+    # @rbs z_scale: Numeric
+    # @rbs rotation: Numeric
+    # @rbs overlay: bool
+    # @rbs password: String?
+    # @rbs return Autocad::BlockReference?
+    def attach_external_reference: (String path, name: String, ?pt: Array[Numeric] | Autocad::Point3d, ?x_scale: Numeric, ?y_scale: Numeric, ?z_scale: Numeric, ?rotation: Numeric, ?overlay: bool, ?password: String?) -> Autocad::BlockReference?
+
+    # Add a line to the model
+    # @rbs pt1: Array[Numeric] | Autocad::Point3d
+    # @rbs pt2: Array[Numeric] | Autocad::Point3d
+    # @rbs layer: String?
+    # @rbs return Autocad::Line?
+    def add_line: (Array[Numeric] | Autocad::Point3d pt1, Array[Numeric] | Autocad::Point3d pt2, ?layer: String?) -> Autocad::Line?
+
+    # Get the layout associated with this model
+    # @rbs return Autocad::Layout
+    def layout: () -> Autocad::Layout
+
+    # Add an arc to the model
+    # @rbs center: Array[Numeric] | Autocad::Point3d
+    # @rbs radius: Numeric
+    # @rbs start_angle: Numeric
+    # @rbs end_angle: Numeric
+    # @rbs return Autocad::Arc
+    # @raise [Autocad::Error] If arc creation fails
+    def add_arc: (Array[Numeric] | Autocad::Point3d center, Numeric radius, Numeric start_angle, Numeric end_angle) -> Autocad::Arc
+
+    # Add a circle to the model
+    # @rbs center: Array[Numeric] | Autocad::Point3d
+    # @rbs radius: Numeric
+    # @rbs return Autocad::Circle
+    # @raise [Autocad::Error] If circle creation fails
+    def add_circle: (Array[Numeric] | Autocad::Point3d center, Numeric radius) -> Autocad::Circle
+
+    # Add a rectangular polyline to the model
+    # @rbs lower_left: Array[Numeric] | Autocad::Point3d
+    # @rbs upper_right: Array[Numeric] | Autocad::Point3d
+    # @rbs return Autocad::Element
+    # @raise [Autocad::Error] If rectangle creation fails
+    def add_rectangle: (Array[Numeric] | Autocad::Point3d lower_left, Array[Numeric] | Autocad::Point3d upper_right) -> Autocad::Element
+
+    # Add an ellipse to the model
+    # @rbs center: Array[Numeric] | Autocad::Point3d
+    # @rbs major_axis: Numeric
+    # @rbs radius_ratio: Numeric
+    # @rbs return Autocad::Ellipse
+    # @raise [Autocad::Error] If ellipse creation fails
+    def add_ellipse: (Array[Numeric] | Autocad::Point3d center, Numeric major_axis, Numeric radius_ratio) -> Autocad::Ellipse
+
+    # Add a spline to the model
+    # @rbs points: Array[Array[Numeric] | Autocad::Point3d]
+    # @rbs start_tangent: Array[Numeric] | Autocad::Point3d
+    # @rbs end_tangent: Array[Numeric] | Autocad::Point3d
+    # @rbs return Autocad::Spline
+    # @raise [Autocad::Error] If spline creation fails
+    def add_spline: (Array[Array[Numeric] | Autocad::Point3d] points, Array[Numeric] | Autocad::Point3d start_tangent, Array[Numeric] | Autocad::Point3d end_tangent) -> Autocad::Spline
+
+    # Get the parent drawing document
+    # @rbs return Autocad::Drawing
+    def drawing: () -> Autocad::Drawing
+
+    private
+
+    # Internal method to create/get a layer
+    # @rbs name: String
+    # @rbs color: Numeric | Symbol | String?
+    # @rbs return Autocad::Layer
+    def create_layer: (String name, ?Numeric | Symbol | String? color) -> Autocad::Layer
+  end
+
+  # Paper space container class
+  class PaperSpace < Element
+    include ModelTrait
+
+    # Add a paper space viewport
+    # @rbs center: Array[Numeric] | Autocad::Point3d
+    # @rbs width: Numeric
+    # @rbs height: Numeric
+    # @rbs return Autocad::PViewport
+    # @raise [StandardError] If viewport creation fails
+    def add_pv_viewport: (Array[Numeric] | Autocad::Point3d center, width: Numeric, height: Numeric) -> Autocad::PViewport
+
+    # Get all paper space viewports
+    # @rbs return Array[Autocad::PViewport]
+    def pviewports: () -> Array[Autocad::PViewport]
+
+    # Delete all paper space viewports
+    # @rbs return void
+    def clear_pviewports: () -> void
+  end
+
+  # Model space container class
+  class ModelSpace < Element
+    include ModelTrait
+  end
+end

data/sig/generated/autocad/mtext.rbs

@@ -0,0 +1,123 @@
+# Generated from lib/autocad/mtext.rb with RBS::Inline
+
+module Autocad
+  # Multi-line formatted text container in AutoCAD
+  #
+  # Represents a rich text entity with multiple lines and formatting.
+  # Supports Liquid templates, table cell awareness, and line-by-line operations.
+  #
+  # @example Create and render a template
+  #   specs = drawing.model.add_mtext("Project: {{name}}")
+  #   specs.render(name: "Tower A")
+  class MText < Element
+    # @rbs attr_reader original: String
+    # @rbs attr_reader ole_obj: WIN32OLE
+    attr_reader original: untyped
+
+    # @rbs attr_reader original: String
+    # @rbs attr_reader ole_obj: WIN32OLE
+    attr_reader ole_obj: untyped
+
+    # Convert content to regex pattern
+    #
+    # @return [Regexp] A regular expression based on the text content
+    # @rbs return Regexp
+    def to_regexp: () -> Regexp
+
+    # Check for empty content
+    #
+    # @return [Boolean] True if the MText has no content
+    # @rbs return bool
+    def empty?: () -> bool
+
+    # Type check for multi-line text (always true)
+    #
+    # @return [Boolean] Always returns true for MText objects
+    # @rbs return bool
+    def mtext?: () -> bool
+
+    # Override text type check (always false)
+    #
+    # @return [Boolean] Always returns false for MText objects
+    # @rbs return bool
+    def text?: () -> bool
+
+    # Get number of text lines
+    #
+    # @return [Integer] The number of lines in the MText
+    # @rbs return Integer
+    def size: () -> Integer
+
+    # Read content from OLE object
+    #
+    # @param ole [WIN32OLE] The OLE object to read from
+    # @return [String] The text content
+    # @rbs ole: WIN32OLE -> String
+    def read_ole: (WIN32OLE ole) -> untyped
+
+    # Update text content with cell awareness
+    #
+    # @param text [String] The new text content
+    # @return [void]
+    # @rbs text: String -> void
+    def write_ole: (String text) -> untyped
+
+    # Update text content for regular MText
+    #
+    # @param text [String] The new text content
+    # @return [void]
+    # @rbs text: String -> void
+    def write_ole_regular: (String text) -> untyped
+
+    # Update text content for MText in table cell
+    #
+    # @param text [String] The new text content
+    # @return [void]
+    # @rbs text: String -> void
+    def write_ole_in_cell: (String text) -> untyped
+
+    # Full content rewrite with line-by-line updates
+    #
+    # @param text [String] The new text content
+    # @return [void]
+    # @rbs text: String -> void
+    def update_ole!: (String text) -> untyped
+
+    # Get content as string
+    #
+    # @return [String] The text content
+    # @rbs return String
+    def to_s: () -> String
+
+    # Regex pattern matching against text content
+    #
+    # @param reg [Regexp] The regular expression to match against
+    # @return [Integer, nil] Match position or nil if no match
+    # @rbs reg: Regexp -> Integer?
+    def =~: (Regexp reg) -> untyped
+
+    # Check for Liquid template placeholders
+    #
+    # @return [Boolean] True if the text contains template placeholders
+    # @rbs return bool
+    def template?: () -> bool
+
+    # Render Liquid template with provided context
+    #
+    # @param h [Hash] The template variables
+    # @return [self] The MText object
+    # @example Render a template with variables
+    #   mtext.render(client: "ABC Corp", floors: 42)
+    # @rbs h: Hash[Symbol, untyped] -> self
+    def render: (?Hash[Symbol, untyped] h) -> untyped
+
+    # Delegate uppercase methods to OLE object, lowercase to string methods
+    #
+    # @param meth [Symbol] The method name
+    # @param * [Array] Method arguments
+    # @param & [Proc] Optional block
+    # @return [Object] Result of the method call
+    # @rbs (Symbol, *untyped) -> untyped
+    def method_missing: (Symbol, *untyped) -> untyped
+  end
+end

data/sig/generated/autocad/plot.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/autocad/plot.rb with RBS::Inline
+
+module Autocad
+  class Plot < Element
+    # Configure which layouts to include in the plot
+    # @rbs *layouts: Array[String | Autocad::Layout] | String | Autocad::Layout
+    # @rbs return void
+    def set_layouts_to_plot: (*Array[String | Autocad::Layout] | String | Autocad::Layout layouts) -> void
+
+    # Display full plot preview window
+    # @rbs return void
+    def plot_preview: () -> void
+
+    # Execute plot using configured device
+    # @rbs return void
+    # @raise [Autocad::Error] If device communication fails
+    def plot_to_device: () -> void
+
+    # Plot to file with specified configuration
+    # @rbs filename: String | Pathname
+    # @rbs plot_config: String | Autocad::PlotConfiguration?
+    # @rbs return void
+    # @raise [Autocad::Error] If file creation fails
+    def plot_to_file: (String | Pathname filename, ?plot_config: String | Autocad::PlotConfiguration?) -> void
+  end
+end