Skip to content

fix(ruby): keep warp and digit-leading names of custom blocks in ruby - #2123

Merged
smalruby3-editor-bot[bot] merged 2 commits into
developfrom
fix/converter-procedure-warp-name
Nov 17, 2026
Merged

smalruby3-editor-bot[bot] merged 2 commits into
developfrom
fix/converter-procedure-warp-name

Conversation

@smalruby3-editor-bot

Copy link
Copy Markdown

Summary

定義ブロック(ブロックを作る)の Ruby での表し方の 2 つの不具合を直す。どちらも def の行と生成器 procedure.js / 変換器 my-blocks.js の同じ所を変えるので、1 つの PR にした。

#2114 「画面を再描画せずに実行する」が Ruby を通すと消える

def の前に without_screen_refresh を書く形にした(Ruby の private def foo と同じ形。Ruby だけで書く人も書ける)。

# 前: warp の印が出ず、Ruby を直してブロックに戻すと全部 warp = false
def 学習する
  @見る長さ = 1
end

# 後
without_screen_refresh def 学習する
  @見る長さ = 1
end

変換器は解析の段で、この呼び出しを中の def に置きかえて(screen-refresh-defs.js)、その def を覚える。分析・class / module・コメント・ブロック内 def の検査などは今までどおりの def として見るので、ほかの所を変えずにすむ。my-blocks.js が warp を "true" にする(呼び出しの mutation.warp も合わせる)。生成器は mutation.warp が "true"/true のとき前に付ける。class の中・module(include)・v1(def self.)も往復する。自分で def without_screen_refresh を定義したコードでは置きかえない。

smalruby3 gem には、名前を返すだけのクラスメソッド without_screen_refresh を足した(生成した Ruby が gem で NoMethodError にならないように。gem の側で warp の動きはまだ実装していない)。

#2116 名前が数字で始まる定義ブロックが def 1_文字えらぶ になる

メソッドにできない名前は前に _ を付け、変換器が取る(src/lib/ruby-method-name.js に 1 か所)。

# 前: 文法エラー(trailing '_' in number)でブロックに戻れない
def 1_文字えらぶ(n)
end
1_文字えらぶ(1)

# 後
def _1_文字えらぶ(n)
end
_1_文字えらぶ(1)
  • 対象: 数字で始まる名前、Ruby の予約語(end・if など)。
  • 1 けたの数字だけの名前は __ を付ける(_1〜_9 は Ruby の番号指定パラメータで名前にできない。「1」→ __1)。
  • もとから _ で始まる同じ形の名前(「_1x」「_end」)は、もう 1 つ _ を付けるので(__1x)、どの名前も往復で変わらない。_foo のような名前は今までどおり。

同じところで見つけて直したもの

  • 生成器が @ruby:return:<メソッド> を \w+ で読んでいたため、日本語の名前のメソッドで return を使う/同じ行で 2 回呼ぶと、@_return_…_ = "" と控えの行が Ruby に出ていた。[^:,\s]+ で読むようにした(data.js / procedure.js / control.js の 5 か所)。
  • class-wrapper.js のファイル書き出しで、ハット/def の節を見分ける正規表現に without_screen_refresh def を足した。

Test Coverage

  • 新規 test/unit/lib/ruby-roundtrip/my-block-warp-and-name.test.js(24 件: warp の変換・生成・真偽値の warp・引数と戻り値・2 つの定義・v1・class・module・自分で定義した without_screen_refresh、名前 1 文字えらぶ・end・if・_1 x・_end・1・_1・10 の往復、戻り値・明示の return・warp つきの往復)。修正前に 17 件が落ちることを確認。
  • gem: ruby/smalruby3/test/dsl_test.rb に 1 件(コンテナに Ruby が無いので手元では流していない。CI の ci-ruby で確かめる)。
  • 関係する既存テストを 1 つずつ実行して通過: converter の class・class-error-message・method-return1〜5・module・my-blocks1〜3・my-blocks-backward-compat・super・visibility-modifiers、generator の class-wrapper・class・method-return・module・control1/2、module-sync、ruby-roundtrip-class-*(4)・ruby-roundtrip-method-return、roundtrip の my_blocks・case-procedure-call・return-value-used-twice・method-return-value-shapes・return-literal-no-orphan・return-call-paren-list-and-self-line。
  • eslint / prettier(触ったファイル)OK。新しいファイル src/lib/ruby-method-name.js は .prettierignore に追加。

Docs

  • docs/ruby-editor/bridging-patterns.md: P20「定義ブロックの名前と『画面を再描画せずに実行する』」を追加、「変換器が使う名前」に _<名前> を追加。
  • 言語仕様(ja / en)のメソッド定義に、without_screen_refresh def と名前の _ の決まりを追記。

見つけたほかの点(この PR では直していない)

  • 名前の中の空白は _ になり、ブロックに戻しても _ のまま(「1 文字えらぶ」→「1_文字えらぶ」。前からの動き)。
  • - など Ruby の名前に使えない記号の入った定義ブロックの名前は、そのまま書くので文法エラーになる。
  • 大文字で始まる名前(「Jump」)は、引数なしで呼ぶと定数として読まれる(未確認・要調査)。
  • 引数を、値を返す別のメソッドの引数に渡す def bar(n); say(foo(n)); end; bar(3) が「My Block "bar" の引数の型がまちがっています」になる(warp と関係なく、develop でも起きる)。
  • 日本語モードは without_screen_refresh def の行を読めない。
  • ふりがなモードは without_screen_refresh にふりがなを付けない(with_screen_refresh も付けていない)。

Closes #2114
Closes #2116

🤖 Generated with Claude Code

"Run without screen refresh" of a custom block is written
`without_screen_refresh def foo ... end`. The parse stage unwraps the call
to the def and remembers it, so my-blocks.js sets warp "true"; before, Ruby
dropped it and converting back turned it off.

A custom block name that starts with a digit or is a reserved word gets
`_` in front (`1 文字えらぶ` -> `def _1_文字えらぶ`; one digit gets `__`, as
`_1`..`_9` are numbered parameters), and the converter takes it off again
(ruby-method-name.js). The @ruby:return markers are read with [^:,\s]+
instead of \w+, which missed Japanese method names. The smalruby3 gem
gets a no-op `without_screen_refresh` class method.

Closes #2114
Closes #2116

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

🚀 Preview deployed (stg API): https://preview.smalruby.app/fix-converter-procedure-warp-name-8f52ad7a/

@smalruby3-editor-bot
smalruby3-editor-bot Bot merged commit a43c56d into develop Nov 17, 2026
14 checks passed
@smalruby3-editor-bot
smalruby3-editor-bot Bot deleted the fix/converter-procedure-warp-name branch November 17, 2026 07:37
smalruby3-editor-bot Bot added a commit that referenced this pull request Nov 17, 2026
…103b

chore: merge develop into topic/lessons-lm (#2123)

This branch was previously deployed

1 inactive deployment
stg — 48045d78 Deployed Nov 17, 2026 by smalruby3-editor-bot[bot] via cleanup #350
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

0 participants