bitclust-core 1.6.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c50953e0ecaf38a9d4c6187b22eaccedd4b9f52029bb638e026fbbfc655d8a2
-  data.tar.gz: c5ce94f2931f5472651e6bd425c766ba19b9ff4acc87d8fd5ae8e57f384db3d6
+  metadata.gz: 9f02fb9cdddf44a8c30df3e0e9d2fa51159db37abb39220e090a5bc94b61c9cf
+  data.tar.gz: ceffcab8cd2c8bdd34d555e104cd8ac0d774f89b4e42296ff26b64f16570ccbd
 SHA512:
-  metadata.gz: 4766a837042d881e63e96264338d7e04aa6e10e63db1b2ff22ca0e53e6f6e97f766efadbe9c1a6ff8c4b89bfac996eb4c060c9b9abfd8c4aff420c57a987a3f7
-  data.tar.gz: e64091ccdeddf09ed18339d2be46af88abc28c6d9aaf6ae9da888c4125c5ab47b526c315d9f630e76389258fe56f950600b1265d42c10d98a2d595b3892f02d8
+  metadata.gz: 66e1b74b7651e3c12be4d9f55facd88ab6a29def01fae1deb67670191d861a070d95a05c21309e61edf7f43ee7a6f3a948aff410a3bc400eb4b96b5ec6822634
+  data.tar.gz: 680e2945c4225e31b0417495c72945a90824105a7af7d9151a006a30d690fc7b36bd04b9fd4427fad46ab6b1513517c7c052ce49c9ec7913ed3b155402f9fa20

data/Rakefile

@@ -21,6 +21,7 @@ namespace :test do
     sh 'qjs', 'test/js/test_run.mjs'
     sh 'qjs', 'test/js/test_script.mjs'
     sh 'qjs', 'test/js/test_search.mjs'
+    sh 'qjs', 'test/js/test_version_switcher.mjs'
   end
 end
 

data/data/bitclust/catalog/ja_JP.UTF-8

@@ -7,7 +7,7 @@ Added/Redefined Methods
 All Classes
 クラス一覧
 All Functions
-関数一覧
+C API 関数一覧
 All Libraries
 ライブラリ一覧
 Ancestor Methods
@@ -51,7 +51,7 @@ File
 FileFormat
 ファイルフォーマット
 Function Index
-関数一覧
+C API 関数一覧
 Index
 目次
 I/O
@@ -112,6 +112,8 @@ Text
 テキスト
 Thread
 スレッド
+This is a list of functions provided by the Ruby C API for developing Ruby itself and C extension libraries. These functions cannot be called directly from Ruby programs.
+Ruby の C API(C 言語 API)の関数の一覧です。Ruby 本体や拡張ライブラリの開発に使うもので、Ruby プログラムから直接呼び出す関数ではありません。
 This reference manual is for a version of Ruby that is no longer maintained.
 このマニュアルは既にメンテナンスが終了したバージョンの Ruby を対象としています。
 Undefined Methods for Explanation

data/data/bitclust/template/function-index

@@ -8,6 +8,7 @@
     headline_init
 %>
 <%= headline(_("Function Index")) %>
+<p><%= _('This is a list of functions provided by the Ruby C API for developing Ruby itself and C extension libraries. These functions cannot be called directly from Ruby programs.') %></p>
 <table class="entries functions">
 <%
     headline_push

data/data/bitclust/template/layout

@@ -13,6 +13,7 @@
   <link rel="search" type="application/opensearchdescription+xml" title="<%= _('Ruby %s Reference Manual', ruby_version()) %>" href="<%=h opensearchdescription_url() %>">
 <% if run_ruby_wasm_url %>
   <meta name="rurema-run-ruby-wasm" content="<%=h run_ruby_wasm_url %>">
+  <meta name="rurema-run-help" content="<%=h document_url('help') %>#run">
   <script type="module" src="<%=h custom_js_url('js/run.js') %>"></script>
 <% end %>
 </head>

data/data/bitclust/template.offline/function-index

@@ -36,6 +36,7 @@
 </header>
 
 <main>
+<p><%= _('This is a list of functions provided by the Ruby C API for developing Ruby itself and C extension libraries. These functions cannot be called directly from Ruby programs.') %></p>
 <table class="entries functions">
 <%
     headline_push

data/data/bitclust/template.offline/layout

@@ -21,8 +21,10 @@
 <script src="<%=h custom_js_url('js/search_ranker.js') %>"></script>
 <script src="<%=h custom_js_url('js/search_controller.js') %>"></script>
 <script src="<%=h custom_js_url('js/search_init.js') %>"></script>
+<script defer src="<%=h custom_js_url('js/version_switcher.js') %>"></script>
 <% if run_ruby_wasm_url %>
 <meta name="rurema-run-ruby-wasm" content="<%=h run_ruby_wasm_url %>">
+<meta name="rurema-run-help" content="<%=h document_url('help') %>#run">
 <script type="module" src="<%=h custom_js_url('js/run.js') %>"></script>
 <% end %>
 </head>
@@ -35,6 +37,7 @@
 <% end %>
 <div id="rurema-topbar">
   <div id="rurema-brand"><%= manual_home_link %></div>
+  <div id="version-switcher"></div>
   <div id="search-section" role="search">
     <input id="search-field" type="text" autocomplete="off" spellcheck="false"
            placeholder="クラス・メソッドを検索 (/)"

data/lib/bitclust/classentry.rb

@@ -452,7 +452,7 @@ module BitClust
     end
 
     def description
-      description_text(source.split(/\n\n+/, 2)[0].strip)
+      description_text(source.split(/\n\n+/, 2)[0].to_s.strip)
     end
 
     def clear_cache

data/lib/bitclust/docentry.rb

@@ -84,7 +84,7 @@ module BitClust
     end
 
     def description
-      description_text(source.split(/\n\n/, 2)[0].strip)
+      description_text(source.split(/\n\n/, 2)[0].to_s.strip)
     end
   end
 end

data/lib/bitclust/functionentry.rb

@@ -83,7 +83,7 @@ module BitClust
     end
 
     def description
-      description_text(source.split(/\n\n+/, 2)[0].strip)
+      description_text(source.split(/\n\n+/, 2)[0].to_s.strip)
     end
   end
 end

data/lib/bitclust/irb.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+#
+# irb からるりま(Ruby リファレンスマニュアル)を引く refe コマンド。
+# ~/.irbrc に `require "bitclust/irb"` と書くと irb に `refe` コマンドが
+# 登録される。検索対象の DB は refe コマンドと同じ場所
+# (bitclust setup が作る ~/.bitclust/config)から探す。
+
+require 'stringio'
+require 'bitclust'
+require 'bitclust/searcher'
+
+module BitClust
+  module Irb
+    USAGE = <<~USAGE
+      Usage: refe <pattern>
+
+      例:
+        refe String#gsub     インスタンスメソッド
+        refe Array.new       特異メソッド
+        refe Comparable      クラス・モジュール
+        refe printf          名前だけでの検索
+
+      DB が無い場合は `bitclust setup` で作成してください。
+    USAGE
+
+    # pattern を検索して整形済みテキストを io へ書く。db が nil なら
+    # 既定の場所から探す。検索の失敗は例外にせず io へメッセージを書く
+    # (irb セッションを止めないため)
+    def self.lookup(pattern, io: $stdout, db: nil)
+      words = pattern.to_s.split
+      if words.empty?
+        io.puts USAGE
+        return
+      end
+      view = TerminalView.new(Plain.new,
+                              { describe_all: false, line: false, encoding: nil },
+                              io: io)
+      Searcher.new.run_query(db, words, view)
+    rescue BitClust::UserError => err
+      io.puts err.message
+    end
+
+    begin
+      require 'irb/command'
+    rescue LoadError
+      # irb が無い(または irb < 1.13 で公開コマンド API が無い)環境では
+      # コマンド登録だけを諦め、Irb.lookup は使えるままにする
+    else
+      class RefeCommand < ::IRB::Command::Base
+        category 'Documentation'
+        description 'るりま(Ruby リファレンスマニュアル)を検索して表示します'
+        help_message USAGE
+
+        def execute(arg)
+          content = StringIO.new
+          BitClust::Irb.lookup(arg, io: content)
+          if ::IRB.const_defined?(:Pager)
+            ::IRB::Pager.page_content(content.string)
+          else
+            $stdout.puts content.string
+          end
+        end
+      end
+
+      ::IRB::Command.register(:refe, RefeCommand)
+    end
+  end
+end

data/lib/bitclust/markdown_exporter.rb

@@ -0,0 +1,311 @@
+# frozen_string_literal: true
+
+require 'bitclust/nameutils'
+
+module BitClust
+
+  # statichtml の --markdown-output 用に、HTML の各ページと対になる Markdown を
+  # エントリの前処理済みソース(Markdown ツリー由来の md)から組み立てる。
+  # 参照記法(単一ブラケットの [m:...] 等と、参照 scheme を宛先にした
+  # ラベル付きリンク)は相対 .md リンクへ解決する。解決できない参照
+  # (未対応の種別・不正な指定)はそのまま残し、エラーにしない。
+  # コードスパンとコードフェンスの中は変換しない。
+  class MarkdownExporter
+
+    # クラスページの メソッド種別 → セクション見出し(doctree の md と同じ名称)
+    CLASS_SECTIONS = [
+      ["Class Methods",              :public,    :singleton_method],
+      ["Instance Methods",           :public,    :instance_method],
+      ["Private Class Methods",      :private,   :singleton_method],
+      ["Private Instance Methods",   :private,   :instance_method],
+      ["Protected Instance Methods", :protected, :instance_method],
+      ["Module Functions",           :public,    :module_function],
+      ["Constants",                  :public,    :constant],
+      ["Special Variables",          :public,    :special_variable],
+    ].freeze
+
+    def initialize(urlmapper, html_suffix)
+      @urlmapper = urlmapper
+      @html_suffix = html_suffix
+    end
+
+    def library_page(entry)
+      page("# library #{entry.name}", entry.source)
+    end
+
+    # クラスページは HTML と同じく本文+メソッドリンク一覧(本文は載せない)
+    def class_page(entry)
+      out = +""
+      CLASS_SECTIONS.each do |section, visibility, type|
+        methods = entry.entries.select { |m|
+          !m.undefined? && m.type == type && m.visibility == visibility
+        }
+        next if methods.empty?
+        out << "\n## #{section}\n\n"
+        methods.each do |m|
+          m.names.each do |name|
+            spec = m.klass.name + m.typemark + name
+            url = ref_url('m', spec)
+            out << (url ? "- [#{escape_label(name)}](#{url})\n" : "- #{escape_label(name)}\n")
+          end
+        end
+      end
+      page(class_heading(entry), entry.source, out)
+    end
+
+    def method_page(method_name, entries)
+      out = +"# #{method_name.sub('.#', '?.')}\n"
+      entries.each do |m|
+        body = m.source.strip
+        out << "\n" << convert_text(body) << "\n" unless body.empty?
+      end
+      out
+    end
+
+    def doc_page(entry)
+      page("# #{entry.title}", entry.source)
+    end
+
+    def function_page(entry)
+      page("# #{entry.name}", "### #{entry.header}\n#{entry.source}")
+    end
+
+    # 本文中の参照をコードスパン・コードフェンスを避けて相対 .md リンクへ
+    # 変換する
+    def convert_text(str)
+      out = +''
+      fence = nil
+      str.each_line do |line|
+        if fence
+          out << line
+          stripped = line.strip
+          fence = nil if stripped.match?(/\A`+\z/) && stripped.length >= (fence || 0)
+        elsif (m = /\A {0,3}(`{3,})/.match(line))
+          fence = (m[1] || raise).length
+          out << line
+        else
+          out << convert_line(line)
+        end
+      end
+      out
+    end
+
+    private
+
+    def page(heading, source, trailer = "")
+      out = +"#{heading}\n"
+      body = source.strip
+      out << "\n" << convert_text(body) << "\n" unless body.empty?
+      out << trailer
+      out
+    end
+
+    def class_heading(entry)
+      case entry.type
+      when :class
+        sc = entry.superclass
+        sc ? "# class #{entry.name} < #{sc.name}" : "# class #{entry.name}"
+      when :module
+        "# module #{entry.name}"
+      when :object
+        "# object #{entry.name}"
+      else
+        "# #{entry.name}"
+      end
+    end
+
+    def convert_line(line)
+      spans = [] #: Array[String]
+      converted = convert_refs(extract_code_spans(line, spans))
+      converted.gsub(/\x00(\d+)\x00/) { spans[($1 || raise).to_i] || raise }
+    end
+
+    # インラインコードスパン(CommonMark 6.1、N 連バッククォートの同長
+    # ペアリング)を書かれたままプレースホルダへ退避する
+    def extract_code_spans(str, saved)
+      result = +''
+      i = 0
+      len = str.length
+      while i < len
+        c = str[i] or raise
+        if c == '\\' && i + 1 < len
+          result << (str[i, 2] || raise)
+          i += 2
+          next
+        end
+        if c == '`'
+          run = 1
+          run += 1 while str[i + run] == '`'
+          close = find_code_span_close(str, i + run, run)
+          if close
+            saved << (str[i...(close + run)] || raise)
+            result << "\x00#{saved.size - 1}\x00"
+            i = close + run
+            next
+          end
+          result << ('`' * run)
+          i += run
+          next
+        end
+        result << c
+        i += 1
+      end
+      result
+    end
+
+    def find_code_span_close(str, from, run_len)
+      i = from
+      len = str.length
+      while i < len
+        case str[i]
+        when "\n"
+          return nil
+        when '`'
+          j = i
+          j += 1 while str[j] == '`'
+          return i if j - i == run_len
+          i = j
+        else
+          i += 1
+        end
+      end
+      nil
+    end
+
+    REF_SCHEME_RE = /\A([a-zA-Z][a-zA-Z-]*):(.*)\z/m
+
+    def convert_refs(str)
+      result = +''
+      i = 0
+      while i < str.length
+        if str[i] == '\\' && i + 1 < str.length
+          result << (str[i, 2] || raise)
+          i += 2
+          next
+        end
+        if str[i] == '['
+          close = matching_delimiter(str, i, '[', ']')
+          if close
+            if str[close + 1] == '(' &&
+               (dest_end = matching_delimiter(str, close + 1, '(', ')', space_ends: true)) &&
+               (dest = str[(close + 2)...dest_end])
+              # ラベル付きリンク [text](dest)
+              if (m = REF_SCHEME_RE.match(dest)) && (url = ref_url(m[1] || raise, m[2] || raise))
+                result << "[#{str[(i + 1)...close]}](#{url})"
+                i = dest_end + 1
+                next
+              end
+              if dest.start_with?('#') || dest.match?(%r{\Ahttps?://})
+                # 通常の Markdown リンクはそのまま(ラベル内は再解釈しない)
+                result << (str[i..dest_end] || raise)
+                i = dest_end + 1
+                next
+              end
+            end
+            # 単一ブラケット参照 [type:target]([[ は除外)
+            inner = str[(i + 1)...close] || raise
+            if str[i + 1] != '[' && (m = REF_SCHEME_RE.match(inner)) &&
+               (converted = bare_ref(m[1] || raise, m[2] || raise, inner))
+              result << converted
+              i = close + 1
+              next
+            end
+          end
+        end
+        result << (str[i] || raise)
+        i += 1
+      end
+      result
+    end
+
+    # open 位置の括弧に対応する閉じ括弧の位置(\ エスケープ対応・ネスト可)。
+    # space_ends: リンク宛先用。空白が現れたらリンクではない(nil)
+    def matching_delimiter(str, open, open_char, close_char, space_ends: false)
+      depth = 0
+      i = open
+      while i < str.length
+        c = str[i]
+        if c == '\\'
+          i += 1
+        elsif space_ends && c =~ /\s/
+          return nil
+        elsif c == open_char
+          depth += 1
+        elsif c == close_char
+          depth -= 1
+          return i if depth == 0
+        end
+        i += 1
+      end
+      nil
+    end
+
+    # 単一ブラケット参照 1 個を Markdown リンクにする。ラベルは書かれた
+    # ままの形(エスケープ込み)から type: を落としたもの
+    def bare_ref(type, arg, written)
+      label =
+        case type
+        when 'm', 'c', 'lib', 'd', 'f'
+          written.split(':', 2)[1]
+        when 'url'
+          arg
+        when 'ref'
+          case arg
+          when /\A(\w+):(.*)\#([-\w]+)\z/
+            "#{$2}##{$3}"
+          when /\A[-\w]+\z/
+            arg
+          end
+        end
+      return nil unless label
+      url = ref_url(type, arg)
+      return nil unless url
+      "[#{label}](#{url})"
+    end
+
+    # 参照 scheme の宛先 URL(.md への相対リンク)。解決できなければ nil
+    def ref_url(type, arg)
+      arg = unescape_md_brackets(arg)
+      case type
+      when 'm'
+        # md 表記の module function ?. は内部表記 .# に正規化して引く
+        md_suffix(@urlmapper.method_url(arg.sub('?.', '.#')))
+      when 'c'
+        md_suffix(@urlmapper.class_url(arg))
+      when 'lib'
+        md_suffix(@urlmapper.library_url(arg))
+      when 'd'
+        md_suffix(@urlmapper.document_url(arg))
+      when 'f'
+        md_suffix(@urlmapper.function_url(arg))
+      when 'url'
+        arg
+      when 'ref'
+        case arg
+        when /\A(\w+):(.*)\#([-\w]+)\z/
+          url = ref_url($1 || raise, $2 || raise)
+          url ? "#{url}##{$3}" : nil
+        when /\A[-\w]+\z/
+          "##{arg}"
+        end
+      end
+    rescue StandardError
+      nil
+    end
+
+    def md_suffix(html_url)
+      return html_url unless html_url.end_with?(@html_suffix)
+      "#{html_url[0, html_url.length - @html_suffix.length]}.md"
+    end
+
+    def unescape_md_brackets(str)
+      str.gsub(/\\([\[\]\\])/, '\1')
+    end
+
+    def escape_label(text)
+      text.gsub(/[\\\[\]]/) { "\\#{$&}" }
+    end
+
+  end
+
+end

data/lib/bitclust/mdcompiler.rb

@@ -126,6 +126,12 @@ module BitClust
           break
         end
       end
+      # RBS シグネチャは見出し <dt> 群の直後・説明 <dd> の直前に、この
+      # チャンクへ振り分けられたぶんだけ <dt> 行として出す(rd 側
+      # entry_chunk と同じ。rbs_sig property が無ければ何も出ない)
+      if (rbs_dts = rbs_signature_dts_for_chunk())
+        @out.puts rbs_dts
+      end
       @out.puts %Q(<dd class="#{@type.to_s}-description">)
       undef_message if attrs.include?('undef')
       while @f.next?
@@ -184,6 +190,12 @@ module BitClust
       super(sig_line.sub(signature_re, '--- '), first)
     end
 
+    # RBS シグネチャのチャンク走査（RbsSignatures）用: md のシグネチャ行を
+    # rd の正規形にして返す（method_signature と同じ変換）
+    def rbs_signature_line(line)
+      line.sub(signature_re, '--- ') if signature_re =~ line
+    end
+
     def headline(line)
       hashes = line[/\A#+/] || raise
       label = line.sub(/\A#+\s*/, '').strip
@@ -405,11 +417,13 @@ module BitClust
       }
     end
 
+    # 列揃えはインラインスタイルで出す。align 属性は presentational hint
+    # としての扱いになり、テーマ CSS の text-align 指定に負けて効かない
     def table_row(row, tag, aligns)
       cells = split_table_row(row)
       string '<tr>'
       cells.each_with_index do |cell, i|
-        align = aligns[i] ? %Q( align="#{aligns[i]}") : ''
+        align = aligns[i] ? %Q( style="text-align:#{aligns[i]}") : ''
         string "<#{tag}#{align}>#{compile_text(cell)}</#{tag}>"
       end
       line '</tr>'

data/lib/bitclust/mdparser.rb

@@ -314,11 +314,50 @@ module BitClust
       src = (header + body).join('')
       src.location = sig_lines[0].location
       sigs = sig_lines.map {|line| method_signature(line) }
+      # キーワード不一致はより具体的なメッセージになるよう
+      # check_chunk_signatures(signature crash)より先に検査する
+      check_entry_style(sig_lines, sigs)
       mainsig = check_chunk_signatures(sigs, sig_lines[0])
       names = sigs.map {|s| s.name }.compact.uniq.sort
       Chunk.new(mainsig, names, src)
     end
 
+    # セクション（h2）の型ごとに期待するエントリキーワード。
+    # キーワードは型決定には使われない（型はセクションで決まる）ため、
+    # 食い違ったまま書けてしまう分類間違い（rurema/doctree#3291 の
+    # 「Class Methods 配下の const」等）をパース時に検出する
+    ENTRY_KEYWORD_RE = /\A### (module_function def|def|const|gvar) /
+    EXPECTED_ENTRY_KEYWORD = {
+      '#'  => 'def',
+      '.'  => 'def',
+      '.#' => 'module_function def',
+      '::' => 'const',
+      '$'  => 'gvar',
+    }.freeze
+
+    # エントリの書式とセクションの一致検査。
+    # - キーワードがセクションの種別と一致すること
+    # - 特異メソッドは `def Klass.name` / `def self.name` のプレフィクス
+    #   必須（MARKUP_SPEC §3.1。def 行だけでメソッド種別が分かるようにする）
+    def check_entry_style(sig_lines, sigs)
+      cxt = @context.signature
+      return unless cxt && cxt.type
+      expected = EXPECTED_ENTRY_KEYWORD[cxt.type] or return
+      sig_lines.zip(sigs).each do |line, sig|
+        keyword = (line || raise)[ENTRY_KEYWORD_RE, 1]
+        unless keyword == expected
+          parse_error "entry keyword `#{keyword}' does not match this section (expected `#{expected}')", line
+        end
+        if cxt.type == '.' && sig && sig.type.nil?
+          parse_error "singleton method entry must be written as `def #{cxt.klass || 'Klass'}.name' or `def self.name'", line
+        end
+      end
+    end
+
+    # `def self.name` 形式。type は singleton に確定し、klass は
+    # 見出しコンテキスト（H1/H2）から補完される
+    SELF_SIGNATURE = /\A---\s*self\.(#{METHOD_NAME_RE})/
+
     # md シグネチャ行を rd 形式（--- ...）へ落とし、既存の
     # Signature パースを継承する。エラー時は元の行を報告する
     def method_signature(line)
@@ -326,12 +365,14 @@ module BitClust
       begin
         # 描画（MethodSignature.parse）が受理できないシグネチャは
         # statichtml まで進んでから落ちる（か、誤った名前で DB に入る）ので
-        # パース時に拒否する。RBS 形式（def name:）や self. プレフィクスが該当
+        # パース時に拒否する。RBS 形式（def name:）が該当
         MethodSignature.parse(rd_line)
       rescue ParseError
         parse_error "unsupported method signature", line
       end
       case
+      when m = SELF_SIGNATURE.match(rd_line)
+        Signature.new(nil, '.', m[1])
       when m = SIGNATURE.match(rd_line)
         klass, typemark_, name = m.captures
         typemark = _ = typemark_

data/lib/bitclust/methodentry.rb

@@ -10,6 +10,7 @@
 
 require 'bitclust/entry'
 require 'bitclust/exception'
+require 'json'
 
 module BitClust
 
@@ -118,6 +119,11 @@ module BitClust
       # 現れない前提。fill_since/fill_until で検査する）
       property :since_by_name,   '[String]'
       property :until_by_name,   '[String]'
+      # RBS シグネチャ表示。オーバーロード配列(RbsSigImporter 参照)の
+      # JSON 1 行を持つ。型シグネチャは ',' を普通に含むので [String] 型
+      # (',' 区切り)は使えない。JSON は改行を含まず、property ファイルの
+      # key=value 1 行形式は値中の '=' を許す(split('=', 2))ので安全
+      property :rbs_sig,         'String'
     }
 
     def inspect
@@ -166,6 +172,24 @@ module BitClust
       "#{methodid2typechar(@id)}_#{encodename_fs(name).gsub(/=/, '--')}".upcase
     end
 
+    # rbs_sig(JSON)をオーバーロード配列に戻す。現行形式は
+    # {"overloads":[{"segments":..., "params":..., "arity":..., "block":...}]}
+    # で、セグメント行列そのものの配列だった旧形式の DB は segments だけの
+    # オーバーロード列に読み替える。property が無い古い DB(nil)・
+    # シグネチャ無しで保存された空文字列・未保存エントリの "(uninitialized)"
+    # センチネル・壊れた JSON はすべて nil(= 表示しない)に落として
+    # 描画側を守る
+    def rbs_signature_overloads
+      json = rbs_sig()
+      return nil unless json && (json.start_with?('{') || json.start_with?('['))
+      data = JSON.parse(json)
+      overloads = data.is_a?(Hash) ? data['overloads']
+                                   : data.map {|segments| {'segments' => segments} }
+      overloads.is_a?(Array) && !overloads.empty? ? overloads : nil
+    rescue JSON::ParserError
+      nil
+    end
+
     def labels
       c, t, _m, _lib = methodid2specparts(@id)
       names().map {|name| "#{c}#{t}#{name}" }

data/lib/bitclust/methodsignature.rb

@@ -21,7 +21,7 @@ module BitClust
 
     METHOD_SIGNATURE_RE = /\A
         --- \s*
-          (?: (?:#{CLASS_PATH_RE} #{TYPEMARK_RE})? (#{METHOD_NAME_RE})
+          (?: (?:#{CLASS_PATH_RE} #{TYPEMARK_RE} | self\.)? (#{METHOD_NAME_RE})
           | (#{GVAR_RE})
           )                 \s*         # method name ($1) or gvar name ($2)
         (?: \( (.*?) \)     \s* )?      # parameters (optional); $3=parameter_list