SketchUp 2027.0 by mirunaencuna · Pull Request #91 · SketchUp/ruby-api-stubs

mirunaencuna · 2026-10-07T12:23:40Z

No description provided.

thomthom · 2026-10-08T14:57:43Z

@@ -0,0 +1,15 @@
+**SketchUp 2023 or later on Windows / SketchUp 2027 or later on macOS**


What is this file for?

I would think it is a markdown table to insert into constructor docstring for the UI::HtmlDialog class. It would likely replace the existing table with the dialog style constants.

thomthom · 2026-10-08T15:20:24Z

  # line in world coordinates.
  #
+  # objects. Point 0: leader break point, where the text extension attaches. Point 1: attach point,
+  #                      where leader touches the arc/circle. Point 2: opposite


This formatting looks odd. Is this also in the API docs? How does it render when using YARD these stubs?

Leading spaces will make line 71 render as code.

thomthom · 2026-10-08T15:20:41Z

  # The leader_points method returns the 3 significant points along the dimension
  # line in world coordinates.
  #
+  # objects. Point 0: leader break point, where the text extension attaches. Point 1: attach point,


This starts with an incomplete sentence. Something is wrong here...?

thomthom · 2026-10-08T15:22:13Z

  # For the last form that takes a Curve, the curve must be closed - like a
  # circle.
  #
+  # open operation if:


Another odd section: "open operation if:"?

Indentation and formatting looks to be off as well?

thomthom · 2026-10-08T15:22:49Z

  # @note A special case exists for any face created on the ground plane, in
  #   which case the vertex order is ignored and the face is always facing down.
  #
+  # @note When using the edge array or curve overload this method will return +nil+ and abort any


Oh, do the section above belong to this @note?

Something broken in our API doc comment? Or in the stub generator?

Likely YARD output is out of order due to indentation. Any line with 2 leading spaces will be rendered as code. I think @note blocks are always rendered last. So if note lines are indented, they end up rendering as code blocks in front of the note.

thomthom · 2026-10-08T15:26:04Z

  #   status = entity1.set_attribute "testdictionary", "test", 115
  #
+  # @note {Geom::Point3d} or {Geom::Vector3d} array values stored as vertex
+  #   attributes are automatically transformed when the vertex is moved.


This @note is working fine. So I'm not sure why the other notes appear broken...

Following lines should not be indented.

thomthom · 2026-10-08T15:27:18Z

+  def save_fill_pattern_to_file(file_name)
+  end
+
+  # the file is loaded; any others are ignored.


Something is wrong here...

thomthom · 2026-10-08T15:31:21Z

  #   layer.visible = false
  #
+  # @note The behavior of +layer.visible = false+ differs from the UI when the layer is active.
+  #


How does this @note render? The empty lines look odd.

thomthom · 2026-10-08T15:33:16Z

-  # @return [Array<Sketchup::Drawingelement>] an array of drawing elements that are
-  #   *hidden* on the page.
+  # @note Behavior depends on which hidden-visibility flags are used:
+  #   - SketchUp 2020.1 and later:


How does this section render in YARD?

It renders fine:

I think this needs improvements. But that should be done at the source. Can you log a ticket for followup to clean up here? We should mark inline code with inline code syntax.

Logged SKEXT-5556.

thomthom · 2026-10-08T15:35:39Z

+#
+# @todo Add documentation.
+#
+# @version SketchUp 2025.0


Space entities haven't been released yet. Is this on in release branch?

thomthom · 2026-10-08T15:37:02Z

+# @api InputBox
+#
+# @version SketchUp 2027.0
+module UI::InputBox::ValueType


This was not release for 27.0. Is this on in release branch? or was the stubs generated from develop?

My interest is ~~peeked~~ piqued.

I generated them from the release branch using bundle exec thor stubs:install, but now, after reviewing the Release Notes, I deleted them.

Something is wrong with the stub generator script if this was generated from release branch. We should find root cause. There should not be any manual cleanup needed on the generated output.

thomthom · 2026-10-08T15:40:55Z

+# @todo Complete documentation.
+#
+# @version SketchUp 2027.0
+class UI::InputBox


This is not a released feature.

thomthom · 2026-10-08T15:41:53Z

This file should not be checked in. gitignore it.

DanRathbun · 2026-10-08T17:33:30Z

+  CORNER_RIGHT_BACK_TOP = nil # Stub value.
+  CORNER_RIGHT_FRONT_BOTTOM = nil # Stub value.
+  CORNER_RIGHT_FRONT_TOP = nil # Stub value.
+


The constants are already listed in the YARD docs. Why assign them nil when they are Integer values?

I checked the existing stubs in this repo and every constant is initialized as nil # Stub value, so I followed that pattern for consistency.

Docs doesn't display constant values, the actual value is implementation detail that might be subject to change.

DanRathbun · 2026-10-08T18:10:27Z

-#   # core.rb.
 #   require 'sketchup.rb'
 #   require 'extensions.rb'
 #


The file extension should not be specified. Doing so causes a reload by the require method when other file have already loaded it with just require 'sketchup', etc. The reloads cause excessive noise in the Ruby Console with messages about constants already defined.
This also applies to loading Ruby standard library files, such as: require 'json', require 'fiddle', and so forth.

For an example of confusion, noise and exceptions occurring caused by double loading, see:

Error in Fiddle Standard Lib - #1113

thomthom

I'm making this as Requested changes while we wait for the doc and stub generatpr fixes up stream. Makes the Review Inbox easier to read.

mirunaencuna requested review from a team, DavidMan20, GMircea22, iacobbianca, simonaspaccatrosi-oss and thomthom October 7, 2026 12:23

SketchUp 2027.0

23abe5d

mirunaencuna force-pushed the staging branch from 9637a21 to 23abe5d Compare October 8, 2026 12:09

thomthom reviewed Oct 8, 2026

View reviewed changes

thomthom requested changes Oct 8, 2026

View reviewed changes

DanRathbun reviewed Oct 8, 2026

View reviewed changes

.

7cda035

mirunaencuna requested review from DanRathbun and thomthom October 12, 2026 10:39

thomthom removed request for DanRathbun and simonaspaccatrosi-oss October 19, 2026 11:01

thomthom requested changes Oct 21, 2026

View reviewed changes

.

e79d83f

mirunaencuna requested a review from thomthom October 30, 2026 12:20

		@@ -0,0 +1,15 @@
		SketchUp 2023 or later on Windows / SketchUp 2027 or later on macOS

Conversation

mirunaencuna commented Oct 7, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DanRathbun Oct 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DanRathbun Oct 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

thomthom left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

DanRathbun Oct 8, 2026 •

edited

Loading

DanRathbun Oct 8, 2026 •

edited

Loading