japanese_address_parser 4.0.0 → 4.0.1

data/lib/japanese_address_parser/data/prefecture_api.rb

@@ -9,13 +9,14 @@ require 'japanese_address_parser/data/single_prefecture'
 module JapaneseAddressParser
   module Data
     # api/ja.json のレスポンス全体（全都道府県＋配下市区町村）。JS の PrefectureApi。
-    PrefectureApi =
-      ::Data.define(:meta, :data) do
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          new(meta: ApiMeta.from_json(hash['meta']), data: (hash['data'] || []).map { |pref| SinglePrefecture.from_json(pref) })
-        end
-      end
+    PrefectureApi = ::Data.define(:meta, :data)
     public_constant :PrefectureApi
+
+    class PrefectureApi
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(meta: ApiMeta.from_json(hash['meta']), data: (hash['data'] || []).map { |pref| SinglePrefecture.from_json(pref) })
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/single_chiban.rb

@@ -5,23 +5,24 @@
 
 module JapaneseAddressParser
   module Data
-    # SingleChiban — 地番（地番1・地番2・地番3）。M8 で CSV 行から生成する。
-    SingleChiban =
-      ::Data.define(:prc_num1, :prc_num2, :prc_num3, :point) do
-        # JS: chibanToString(chiban) => [prc_num1, prc_num2, prc_num3].filter(Boolean).join('-')
-        # JS の filter(Boolean) は falsy（nil・空文字）を除外する。Ruby では空文字は truthy なので
-        # compact だけでは不十分。nil と空文字の両方を除外して忠実に再現する。
-        def chiban_to_string
-          [prc_num1, prc_num2, prc_num3]
-            .reject { |value| value.nil? || value == '' }
-            .join('-')
-        end
+    # SingleChiban — 地番（地番1・地番2・地番3）。CSV 行から生成する。
+    SingleChiban = ::Data.define(:prc_num1, :prc_num2, :prc_num3, :point)
+    public_constant :SingleChiban
 
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          new(prc_num1: hash['prc_num1'], prc_num2: hash['prc_num2'], prc_num3: hash['prc_num3'], point: hash['point'])
-        end
+    class SingleChiban
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(prc_num1: hash['prc_num1'], prc_num2: hash['prc_num2'], prc_num3: hash['prc_num3'], point: hash['point'])
       end
-    public_constant :SingleChiban
+
+      # JS: chibanToString(chiban) => [prc_num1, prc_num2, prc_num3].filter(Boolean).join('-')
+      # JS の filter(Boolean) は falsy（nil・空文字）を除外する。Ruby では空文字は truthy なので
+      # compact だけでは不十分。nil と空文字の両方を除外して忠実に再現する。
+      def chiban_to_string
+        [prc_num1, prc_num2, prc_num3]
+          .reject { |value| value.nil? || value == '' }
+          .join('-')
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/single_city.rb

@@ -8,31 +8,32 @@ module JapaneseAddressParser
     # SingleCity — api/ja.json の cities 要素（政令市の場合は区で区切られる）。
     # `::Data.define`（先頭 `::` は名前空間 JapaneseAddressParser::Data 内で
     # トップレベル定数 ::Data を指すために必須）。
-    SingleCity =
-      ::Data.define(:code, :county, :county_k, :county_r, :city, :city_k, :city_r, :ward, :ward_k, :ward_r, :point) do
-        # JS: cityName(city) => `${city.county || ''}${city.city}${city.ward || ''}`
-        # nil の補間は Ruby では空文字になるため `|| ''` 相当。
-        def city_name
-          "#{county}#{city}#{ward}"
-        end
+    SingleCity = ::Data.define(:code, :county, :county_k, :county_r, :city, :city_k, :city_r, :ward, :ward_k, :ward_r, :point)
+    public_constant :SingleCity
 
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          new(
-            code: hash['code'],
-            county: hash['county'],
-            county_k: hash['county_k'],
-            county_r: hash['county_r'],
-            city: hash['city'],
-            city_k: hash['city_k'],
-            city_r: hash['city_r'],
-            ward: hash['ward'],
-            ward_k: hash['ward_k'],
-            ward_r: hash['ward_r'],
-            point: hash['point']
-          )
-        end
+    class SingleCity
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(
+          code: hash['code'],
+          county: hash['county'],
+          county_k: hash['county_k'],
+          county_r: hash['county_r'],
+          city: hash['city'],
+          city_k: hash['city_k'],
+          city_r: hash['city_r'],
+          ward: hash['ward'],
+          ward_k: hash['ward_k'],
+          ward_r: hash['ward_r'],
+          point: hash['point']
+        )
       end
-    public_constant :SingleCity
+
+      # JS: cityName(city) => `${city.county || ''}${city.city}${city.ward || ''}`
+      # nil の補間は Ruby では空文字になるため `|| ''` 相当。
+      def city_name
+        "#{county}#{city}#{ward}"
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/single_machi_aza.rb

@@ -8,34 +8,35 @@ module JapaneseAddressParser
     # SingleMachiAza — api/ja/{都道府県名}/{市区町村名}.json の data 要素（町字）。
     # `rsdt` は値が存在するとき必ず `true`（住居表示住所データの存在フラグ）。
     # `csv_ranges` は level 8 で住居表示/地番 CSV の該当バイト範囲を引くために保持する。
-    SingleMachiAza =
-      ::Data.define(:machiaza_id, :oaza_cho, :oaza_cho_k, :oaza_cho_r, :chome, :chome_n, :koaza, :koaza_k, :koaza_r, :rsdt, :point, :csv_ranges) do
-        # JS: machiAzaName(machiAza) => `${oaza_cho || ''}${chome || ''}${koaza || ''}`
-        # nil の補間は Ruby では空文字になるため `|| ''` 相当。
-        def machi_aza_name
-          "#{oaza_cho}#{chome}#{koaza}"
-        end
+    SingleMachiAza = ::Data.define(:machiaza_id, :oaza_cho, :oaza_cho_k, :oaza_cho_r, :chome, :chome_n, :koaza, :koaza_k, :koaza_r, :rsdt, :point, :csv_ranges)
+    public_constant :SingleMachiAza
 
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        # csv_ranges は `{ "住居表示" => { "start" => Integer, "length" => Integer }, "地番" => {...} }`
-        # の構造をそのまま保持する（M8 で消費する）。
-        def self.from_json(hash)
-          new(
-            machiaza_id: hash['machiaza_id'],
-            oaza_cho: hash['oaza_cho'],
-            oaza_cho_k: hash['oaza_cho_k'],
-            oaza_cho_r: hash['oaza_cho_r'],
-            chome: hash['chome'],
-            chome_n: hash['chome_n'],
-            koaza: hash['koaza'],
-            koaza_k: hash['koaza_k'],
-            koaza_r: hash['koaza_r'],
-            rsdt: hash['rsdt'],
-            point: hash['point'],
-            csv_ranges: hash['csv_ranges']
-          )
-        end
+    class SingleMachiAza
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      # csv_ranges は `{ "住居表示" => { "start" => Integer, "length" => Integer }, "地番" => {...} }`
+      # の構造をそのまま保持する（level 8 のデータアクセスで消費する）。
+      def self.from_json(hash)
+        new(
+          machiaza_id: hash['machiaza_id'],
+          oaza_cho: hash['oaza_cho'],
+          oaza_cho_k: hash['oaza_cho_k'],
+          oaza_cho_r: hash['oaza_cho_r'],
+          chome: hash['chome'],
+          chome_n: hash['chome_n'],
+          koaza: hash['koaza'],
+          koaza_k: hash['koaza_k'],
+          koaza_r: hash['koaza_r'],
+          rsdt: hash['rsdt'],
+          point: hash['point'],
+          csv_ranges: hash['csv_ranges']
+        )
       end
-    public_constant :SingleMachiAza
+
+      # JS: machiAzaName(machiAza) => `${oaza_cho || ''}${chome || ''}${koaza || ''}`
+      # nil の補間は Ruby では空文字になるため `|| ''` 相当。
+      def machi_aza_name
+        "#{oaza_cho}#{chome}#{koaza}"
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/single_prefecture.rb

@@ -8,19 +8,20 @@ require_relative 'single_city'
 module JapaneseAddressParser
   module Data
     # SinglePrefecture — api/ja.json の data 要素（都道府県＋配下の市区町村一覧）。
-    SinglePrefecture =
-      ::Data.define(:code, :pref, :pref_k, :pref_r, :point, :cities) do
-        # JS: prefectureName(pref) => pref.pref
-        def prefecture_name
-          pref
-        end
+    SinglePrefecture = ::Data.define(:code, :pref, :pref_k, :pref_r, :point, :cities)
+    public_constant :SinglePrefecture
 
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          cities = (hash['cities'] || []).map { |city| ::JapaneseAddressParser::Data::SingleCity.from_json(city) }
-          new(code: hash['code'], pref: hash['pref'], pref_k: hash['pref_k'], pref_r: hash['pref_r'], point: hash['point'], cities:)
-        end
+    class SinglePrefecture
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        cities = (hash['cities'] || []).map { |city| ::JapaneseAddressParser::Data::SingleCity.from_json(city) }
+        new(code: hash['code'], pref: hash['pref'], pref_k: hash['pref_k'], pref_r: hash['pref_r'], point: hash['point'], cities:)
       end
-    public_constant :SinglePrefecture
+
+      # JS: prefectureName(pref) => pref.pref
+      def prefecture_name
+        pref
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/single_rsdt.rb

@@ -5,23 +5,24 @@
 
 module JapaneseAddressParser
   module Data
-    # SingleRsdt — 住居表示住所（街区符号・住居番号・住居番号2）。M8 で CSV 行から生成する。
-    SingleRsdt =
-      ::Data.define(:blk_num, :rsdt_num, :rsdt_num2, :point) do
-        # JS: rsdtToString(rsdt) => [blk_num, rsdt_num, rsdt_num2].filter(Boolean).join('-')
-        # JS の filter(Boolean) は falsy（nil・空文字）を除外する。Ruby では空文字は truthy なので
-        # compact だけでは不十分。nil と空文字の両方を除外して忠実に再現する。
-        def rsdt_to_string
-          [blk_num, rsdt_num, rsdt_num2]
-            .reject { |value| value.nil? || value == '' }
-            .join('-')
-        end
+    # SingleRsdt — 住居表示住所（街区符号・住居番号・住居番号2）。CSV 行から生成する。
+    SingleRsdt = ::Data.define(:blk_num, :rsdt_num, :rsdt_num2, :point)
+    public_constant :SingleRsdt
 
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          new(blk_num: hash['blk_num'], rsdt_num: hash['rsdt_num'], rsdt_num2: hash['rsdt_num2'], point: hash['point'])
-        end
+    class SingleRsdt
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(blk_num: hash['blk_num'], rsdt_num: hash['rsdt_num'], rsdt_num2: hash['rsdt_num2'], point: hash['point'])
       end
-    public_constant :SingleRsdt
+
+      # JS: rsdtToString(rsdt) => [blk_num, rsdt_num, rsdt_num2].filter(Boolean).join('-')
+      # JS の filter(Boolean) は falsy（nil・空文字）を除外する。Ruby では空文字は truthy なので
+      # compact だけでは不十分。nil と空文字の両方を除外して忠実に再現する。
+      def rsdt_to_string
+        [blk_num, rsdt_num, rsdt_num2]
+          .reject { |value| value.nil? || value == '' }
+          .join('-')
+      end
+    end
   end
 end

data/lib/japanese_address_parser/dictionaries/convert.rb

@@ -16,6 +16,7 @@ module JapaneseAddressParser
       #     return { ...acc, [d.src]: pattern, [d.dst]: pattern }
       #   }, {})
       # 既存キーへの再代入は位置を保って値を更新する（JS object と Ruby Hash で同挙動）。
+      # @type var pattern_map: ::Hash[::String, ::String]
       pattern_map = {}
       Dictionary::DICTIONARY.each do |entry|
         pattern = "(#{entry[:src]}|#{entry[:dst]})"

data/lib/japanese_address_parser/fetcher.rb

@@ -16,19 +16,20 @@ module JapaneseAddressParser
   module Fetcher
     # 取得結果。JS の FetchResponseLike `{ json(), text(), ok }` に対応する。
     # body は UTF-8 の生文字列、ok は取得成功フラグ。
-    Response =
-      ::Data.define(:body, :ok) do
-        # JS: json: async () => JSON.parse(contents.toString('utf-8'))
-        def json
-          ::JSON.parse(body)
-        end
+    Response = ::Data.define(:body, :ok)
+    public_constant :Response
 
-        # JS: text: async () => contents.toString('utf-8')
-        def text
-          body
-        end
+    class Response
+      # JS: json: async () => JSON.parse(contents.toString('utf-8'))
+      def json
+        ::JSON.parse(body)
       end
-    public_constant :Response
+
+      # JS: text: async () => contents.toString('utf-8')
+      def text
+        body
+      end
+    end
 
     # User-Agent のコメント部で自己申告する本 gem の homepage。
     HOMEPAGE_URL = 'https://github.com/yamat47/japanese_address_parser'
@@ -84,7 +85,7 @@ module JapaneseAddressParser
       request['Range'] = "bytes=#{offset}-#{offset + length - 1}" unless offset.nil? || length.nil?
 
       response =
-        ::Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.is_a?(::URI::HTTPS)) do |http|
+        ::Net::HTTP.start(uri.hostname.to_s, uri.port, use_ssl: uri.is_a?(::URI::HTTPS)) do |http|
           http.request(request)
         end
 

data/lib/japanese_address_parser/japanese_numeral.rb

@@ -152,6 +152,7 @@ module JapaneseAddressParser
     # 進める（ECMAScript の lastIndex 前進と同じ）。
     def ecmascript_global_match(text, pattern)
       anchored = ::Regexp.new("\\A(?:#{pattern})\\z")
+      # @type var matches: ::Array[::String]
       matches = []
       position = 0
       while position <= text.length
@@ -187,6 +188,7 @@ module JapaneseAddressParser
     # JS: splitLargeNumber(japanese) — 漢数字を兆・億・万単位に分割する
     def split_large_number(japanese)
       kanji = japanese
+      # @type var numbers: ::Hash[::String, ::Integer]
       numbers = {}
       LARGE_NUMBERS.each_key do |key|
         match = kanji.match(::Regexp.new("(.+)#{key}"))

data/lib/japanese_address_parser/normalize_result_point.rb

@@ -2,34 +2,34 @@
 
 # Port of: https://github.com/geolonia/normalize-japanese-addresses/blob/49c1ae4be9d2ba353b86eaf40fd7eb12a1269f3e/src/types.ts
 # Upstream: @geolonia/normalize-japanese-addresses v3.1.3
-#   NormalizeResultPoint と座標変換ヘルパ（rsdtOrChibanToResultPoint は M8、
-#   isNormalizeResultPoint は公開 API 検証とともに M6 で移植する）。
+#   NormalizeResultPoint と座標変換ヘルパ。
 
 module JapaneseAddressParser
   # 正規化結果の位置情報（EPSG:4326 / WGS84）。level は座標の正確さ（1:県 2:市 3:町字 8:住居表示/地番）。
-  NormalizeResultPoint =
-    ::Data.define(:lat, :lng, :level) do
-      # Ruby 独自の補助コンストラクタ: [lng, lat] 配列（無ければ nil）から VO を作る。
-      # 上流 types.ts の *ToResultPoint は VO の .point を直接受けるため逐語移植のまま残し、
-      # metadata の Hash（[lng, lat] 配列）から組み立てる M6 リッチ VO 層はこのファクトリを共有する。
-      def self.from_lng_lat(point, level:)
-        return if point.nil?
+  NormalizeResultPoint = ::Data.define(:lat, :lng, :level)
+  public_constant :NormalizeResultPoint
+
+  class NormalizeResultPoint
+    # Ruby 独自の補助コンストラクタ: [lng, lat] 配列（無ければ nil）から VO を作る。
+    # 上流 types.ts の *ToResultPoint は VO の .point を直接受けるため逐語移植のまま残し、
+    # metadata の Hash（[lng, lat] 配列）から組み立てるリッチ VO 層はこのファクトリを共有する。
+    def self.from_lng_lat(point, level:)
+      return if point.nil?
 
-        new(lat: point[1], lng: point[0], level:)
-      end
+      new(lat: point[1], lng: point[0], level:)
+    end
 
-      # JS: isNormalizeResultPoint(obj) — 任意の値が NormalizeResultPoint の形か検証する type guard。
-      # JS は object のプロパティ存在＋数値型を見る。Ruby では lat/lng/level に応答し、それらが
-      # Numeric かつ level が 1/2/3/8 のいずれか、で判定する（JS↔Ruby のオブジェクトモデル差のため
-      # Hash は対象外＝working_agreement §3-4。挙動は spec に固定する）。
-      def self.normalize_result_point?(obj)
-        return false unless obj.respond_to?(:lat) && obj.respond_to?(:lng) && obj.respond_to?(:level)
-        return false unless obj.lat.is_a?(::Numeric) && obj.lng.is_a?(::Numeric) && obj.level.is_a?(::Numeric)
+    # JS: isNormalizeResultPoint(obj) — 任意の値が NormalizeResultPoint の形か検証する type guard。
+    # JS は object のプロパティ存在＋数値型を見る。Ruby では lat/lng/level に応答し、それらが
+    # Numeric かつ level が 1/2/3/8 のいずれか、で判定する（JS↔Ruby のオブジェクトモデル差のため
+    # Hash は対象外＝working_agreement §3-4。挙動は spec に固定する）。
+    def self.normalize_result_point?(obj)
+      return false unless obj.respond_to?(:lat) && obj.respond_to?(:lng) && obj.respond_to?(:level)
+      return false unless obj.lat.is_a?(::Numeric) && obj.lng.is_a?(::Numeric) && obj.level.is_a?(::Numeric)
 
-        [1, 2, 3, 8].include?(obj.level) # JS: validLevels = [1, 2, 3, 8]
-      end
+      [1, 2, 3, 8].include?(obj.level) # JS: validLevels = [1, 2, 3, 8]
     end
-  public_constant :NormalizeResultPoint
+  end
 
   # Single* VO（point は [lng, lat]）から NormalizeResultPoint を作る変換ヘルパ群。
   module ResultPoint

data/lib/japanese_address_parser/prefecture.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Rich value object exposed by the v4 public API (M6).
+# Rich value object exposed by the v4 public API.
 # Ruby-original enrichment layer over the faithful NormalizeResult (working_agreement §1-3).
 # 供給元: NormalizeResult#metadata.prefecture（Omit<SinglePrefecture, 'cities'> 相当の Hash）。
 
@@ -8,20 +8,21 @@ require 'japanese_address_parser/normalize_result_point'
 
 module JapaneseAddressParser
   # 都道府県のリッチ VO。point は代表点（NormalizeResultPoint, level 1）。
-  Prefecture =
-    ::Data.define(:name, :code, :name_kana, :name_romaji, :point) do
-      # metadata.prefecture（cities を除いた Hash・Symbol キー）から VO を作る。pref 未判別なら nil。
-      # point（level 1 代表点）は都道府県データに必ず存在する（from_lng_lat は nil 受けも安全）。
-      def self.from_metadata(hash)
-        return if hash.nil?
+  Prefecture = ::Data.define(:name, :code, :name_kana, :name_romaji, :point)
+  public_constant :Prefecture
 
-        new(name: hash[:pref], code: hash[:code], name_kana: hash[:pref_k], name_romaji: hash[:pref_r], point: NormalizeResultPoint.from_lng_lat(hash[:point], level: 1))
-      end
+  class Prefecture
+    # metadata.prefecture（cities を除いた Hash・Symbol キー）から VO を作る。pref 未判別なら nil。
+    # point（level 1 代表点）は都道府県データに必ず存在する（from_lng_lat は nil 受けも安全）。
+    def self.from_metadata(hash)
+      return if hash.nil?
 
-      # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
-      def to_h
-        { name:, code:, name_kana:, name_romaji:, point: point.to_h }
-      end
+      new(name: hash[:pref], code: hash[:code], name_kana: hash[:pref_k], name_romaji: hash[:pref_r], point: NormalizeResultPoint.from_lng_lat(hash[:point], level: 1))
     end
-  public_constant :Prefecture
+
+    # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
+    def to_h
+      { name:, code:, name_kana:, name_romaji:, point: point.to_h }
+    end
+  end
 end

data/lib/japanese_address_parser/town.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Rich value object exposed by the v4 public API (M6).
+# Rich value object exposed by the v4 public API.
 # Ruby-original enrichment layer over the faithful NormalizeResult (working_agreement §1-3).
 # 供給元: NormalizeResult#metadata.machi_aza（Omit<SingleMachiAza, 'csv_ranges'> 相当の Hash）。
 
@@ -9,28 +9,29 @@ require 'japanese_address_parser/normalize_result_point'
 module JapaneseAddressParser
   # 町字のリッチ VO。name は machiAzaName（大字＋丁目＋小字）。point は代表点（NormalizeResultPoint, level 3）。
   # chome は "一丁目" 等の文字列、chome_n は 1 等の整数（JS SingleMachiAza が両方持つため両方公開する）。
-  Town =
-    ::Data.define(:name, :machiaza_id, :chome, :chome_n, :koaza, :point) do
-      # metadata.machi_aza（csv_ranges を除いた Hash・Symbol キー）から VO を作る。town 未判別なら nil。
-      # point（level 3 代表点）は町字によっては存在しないため from_lng_lat が nil を返す。
-      # name は Hash 入力のため SingleMachiAza#machi_aza_name を呼べない。式は同メソッド（JS: machiAzaName）と一致させる。
-      def self.from_metadata(hash)
-        return if hash.nil?
+  Town = ::Data.define(:name, :machiaza_id, :chome, :chome_n, :koaza, :point)
+  public_constant :Town
 
-        new(
-          name: "#{hash[:oaza_cho]}#{hash[:chome]}#{hash[:koaza]}",
-          machiaza_id: hash[:machiaza_id],
-          chome: hash[:chome],
-          chome_n: hash[:chome_n],
-          koaza: hash[:koaza],
-          point: NormalizeResultPoint.from_lng_lat(hash[:point], level: 3)
-        )
-      end
+  class Town
+    # metadata.machi_aza（csv_ranges を除いた Hash・Symbol キー）から VO を作る。town 未判別なら nil。
+    # point（level 3 代表点）は町字によっては存在しないため from_lng_lat が nil を返す。
+    # name は Hash 入力のため SingleMachiAza#machi_aza_name を呼べない。式は同メソッド（JS: machiAzaName）と一致させる。
+    def self.from_metadata(hash)
+      return if hash.nil?
 
-      # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
-      def to_h
-        { name:, machiaza_id:, chome:, chome_n:, koaza:, point: point&.to_h }
-      end
+      new(
+        name: "#{hash[:oaza_cho]}#{hash[:chome]}#{hash[:koaza]}",
+        machiaza_id: hash[:machiaza_id],
+        chome: hash[:chome],
+        chome_n: hash[:chome_n],
+        koaza: hash[:koaza],
+        point: NormalizeResultPoint.from_lng_lat(hash[:point], level: 3)
+      )
     end
-  public_constant :Town
+
+    # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
+    def to_h
+      { name:, machiaza_id:, chome:, chome_n:, koaza:, point: point&.to_h }
+    end
+  end
 end

data/lib/japanese_address_parser/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module JapaneseAddressParser
-  VERSION = '4.0.0'
+  VERSION = '4.0.1'
   public_constant :VERSION
 end

data/sig/address.rbs

@@ -1,8 +1,5 @@
-# Interim signature for the v4.0.0 public value objects (M6).
-# The full RBS overhaul happens in M9.
-#
-# These are `Data.define` value objects, but the bundled RBS (rbs 2.6.0) predates the
-# core `Data` class, so they are declared as plain classes exposing the interface we use.
+# These are `Data.define` value objects, declared as plain classes exposing the
+# interface we use (attr_reader + keyword-argument new).
 
 module JapaneseAddressParser
   class Prefecture

data/sig/cache_regexes.rbs

@@ -1,6 +1,3 @@
-# Interim signature for the v4.0.0 config & data-access layer (M3/M4).
-# The full RBS overhaul happens in M9.
-#
 # LruRedux には RBS が無いため、キャッシュ関連は untyped で受ける。
 # 町字パターン配列の要素は SingleMachiAza か TownAlias の混在なので untyped にしている。
 
@@ -23,28 +20,28 @@ module JapaneseAddressParser
     @cached_towns: Hash[String, Data::MachiAzaApi]?
     @cached_same_named_prefecture_city_regex_patterns: Array[[String, String]]?
 
-    def self.cache: () -> untyped
-    def self.fetch_from_cache: (String key) { () -> untyped } -> untyped
-    def self.reset!: () -> nil
-    def self.get_prefectures: () -> Data::PrefectureApi
-    def self.cache_prefectures: (Data::PrefectureApi data) -> Data::PrefectureApi
-    def self.get_prefecture_regex_patterns: (Data::PrefectureApi api) -> Array[[Data::SinglePrefecture, String]]
-    def self.get_city_regex_patterns: (Data::SinglePrefecture pref) -> Array[[Data::SingleCity, String]]
-    def self.get_towns: (Data::SinglePrefecture pref_obj, Data::SingleCity city_obj, Integer api_version) -> Data::MachiAzaApi
-    def self.get_town_regex_patterns: (Data::SinglePrefecture pref, Data::SingleCity city, Integer api_version) -> Array[[untyped, String]]
-    def self.get_same_named_prefecture_city_regex_patterns: (Data::PrefectureApi pref_api) -> Array[[String, String]]
-    def self.get_rsdt: (Data::SinglePrefecture pref, Data::SingleCity city, Data::SingleMachiAza town, Integer api_version) -> Array[Data::SingleRsdt]
-    def self.get_chiban: (Data::SinglePrefecture pref, Data::SingleCity city, Data::SingleMachiAza town, Integer api_version) -> Array[Data::SingleChiban]
-    def self.fetch_subresource: (String kind, Data::SinglePrefecture pref, Data::SingleCity city, Hash[String, Integer] row, Integer api_version) -> String
-    def self.parse_subresource: (String data) -> Array[untyped]
-    def self.point_from: (untyped lng, untyped lat) -> [Float, Float]?
+    def self?.cache: () -> untyped
+    def self?.fetch_from_cache: (String key) { () -> untyped } -> untyped
+    def self?.reset!: () -> nil
+    def self?.get_prefectures: () -> Data::PrefectureApi
+    def self?.cache_prefectures: (Data::PrefectureApi data) -> Data::PrefectureApi
+    def self?.get_prefecture_regex_patterns: (Data::PrefectureApi api) -> Array[[Data::SinglePrefecture, String]]
+    def self?.get_city_regex_patterns: (Data::SinglePrefecture pref) -> Array[[Data::SingleCity, String]]
+    def self?.get_towns: (Data::SinglePrefecture pref_obj, Data::SingleCity city_obj, Integer api_version) -> Data::MachiAzaApi
+    def self?.get_town_regex_patterns: (Data::SinglePrefecture pref, Data::SingleCity city, Integer api_version) -> Array[[untyped, String]]
+    def self?.get_same_named_prefecture_city_regex_patterns: (Data::PrefectureApi pref_api) -> Array[[String, String]]
+    def self?.get_rsdt: (Data::SinglePrefecture pref, Data::SingleCity city, Data::SingleMachiAza town, Integer api_version) -> Array[Data::SingleRsdt]
+    def self?.get_chiban: (Data::SinglePrefecture pref, Data::SingleCity city, Data::SingleMachiAza town, Integer api_version) -> Array[Data::SingleChiban]
+    def self?.fetch_subresource: (String kind, Data::SinglePrefecture pref, Data::SingleCity city, Hash[String, Integer] row, Integer api_version) -> String
+    def self?.parse_subresource: (String data) -> Array[untyped]
+    def self?.point_from: (untyped lng, untyped lat) -> [Float, Float]?
 
-    def self.cached_city_patterns: () -> Hash[Integer, Array[[Data::SingleCity, String]]]
-    def self.cached_towns: () -> Hash[String, Data::MachiAzaApi]
-    def self.stable_sort_by: (untyped list) { (untyped) -> untyped } -> untyped
-    def self.town_sort_length: (untyped town) -> Integer
-    def self.kanji_number_followed_by_cho?: (String target_town_name) -> bool
-    def self.town_pattern_source: (String name) -> String
-    def self.expand_town_number: (String match) -> String
+    def self?.cached_city_patterns: () -> Hash[Integer, Array[[Data::SingleCity, String]]]
+    def self?.cached_towns: () -> Hash[String, Data::MachiAzaApi]
+    def self?.stable_sort_by: (untyped list) { (untyped) -> untyped } -> untyped
+    def self?.town_sort_length: (untyped town) -> Integer
+    def self?.kanji_number_followed_by_cho?: (String target_town_name) -> bool
+    def self?.town_pattern_source: (String name) -> String
+    def self?.expand_town_number: (String match) -> String
   end
 end

data/sig/config.rbs

@@ -1,5 +1,3 @@
-# Interim signature for the v4.0.0 config & data-access layer (M3).
-# The full RBS overhaul happens in M9.
 
 module JapaneseAddressParser
   class Config

data/sig/data.rbs

@@ -1,8 +1,5 @@
-# Interim signatures for the v4.0.0 data model layer (M1).
-# The full RBS overhaul happens in M9; these keep `steep check` green in the meantime.
-#
-# These are `Data.define` value objects, but the bundled RBS (rbs 2.6.0) predates the
-# core `Data` class, so they are declared as plain classes exposing the interface we use.
+# These are `Data.define` value objects, declared as plain classes exposing the
+# interface we use (attr_reader + keyword-argument new).
 
 module JapaneseAddressParser
   module Data

data/sig/dict.rbs

@@ -1,8 +1,6 @@
-# Interim signature for the v4.0.0 utility layer (M2).
-# The full RBS overhaul happens in M9.
 
 module JapaneseAddressParser
   module Dict
-    def self.to_regex_pattern: (String string) -> String
+    def self?.to_regex_pattern: (String string) -> String
   end
 end

data/sig/dictionaries.rbs

@@ -1,5 +1,3 @@
-# Interim signature for the v4.0.0 utility layer (M2).
-# The full RBS overhaul happens in M9.
 
 module JapaneseAddressParser
   module Dictionaries
@@ -15,7 +13,7 @@ module JapaneseAddressParser
       PATTERN_MAP: Hash[String, String]
       REGEXP: Regexp
 
-      def self.call: (String regex_text) -> String
+      def self?.call: (String regex_text) -> String
     end
   end
 end