japanese_address_parser 4.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc60cb10d4d82995816196dffbb29519d6e8d6c7088dca5da2dfcd2d73c22b1a
-  data.tar.gz: a27154a347951759bef645e81b94559f6d66cc93393651607a045daa9359de93
+  metadata.gz: 4b19df70505de62d54e53148e4987925f9fef8054550e5c1d48c8b2048814dda
+  data.tar.gz: cca05c04ce8cbddad73903dc8d07f5f8867e03f1c687c70620cec0954073b3b5
 SHA512:
-  metadata.gz: e396466caac9d0d76c294a147625d6f012439b97823840f8f350fa395446dc768d788c2e139503a971d1056a6dc16a9f8647a9c5ae33da67090b79092bb401bd
-  data.tar.gz: 8a9cd3d54cc50c8133535099e037ada4957dbafdb3a07bf2f65119abdea0edf114155bb389569fc5030b571e693bbc27a06effd734ce8ef964ccee7d318be1b9
+  metadata.gz: bb15346ae7129d17d418ec239092592587e60fe65ffe1fa30aaee6eae4b5b5a4a0c217f4485600d60df46c917de42a79bad86a142378d5403128720571b6af69
+  data.tar.gz: 5aae0a4aa7d390b1fbaa1212f29e8743c9bf1d7f1562bd9cb1a481d7f18d903b2a2e4f184b9ac35b49a48bbaac2c332339a6b51159b6190e48105c6854244c2b

data/.rubocop.yml

@@ -1,6 +1,6 @@
 inherit_from: .rubocop_todo.yml
 
-require:
+plugins:
   - rubocop-rake
   - rubocop-rspec
 
@@ -15,7 +15,7 @@ Metrics/BlockLength:
     # v4 の逐語移植では上流 JS の巨大なコールバック（getTownRegexPatterns 等）をそのまま写す。
     - lib/japanese_address_parser/**/*.rb
 
-# v4 リアーキの lib は上流 JS の逐語移植（working_agreement §3）。メソッド構成・
+# v4 の lib は上流 JS（@geolonia/normalize-japanese-addresses）の逐語移植。メソッド構成・
 # 複雑度・モジュール長は移植元 JS に合わせるため、これらの Metrics を v4 では緩める。
 # （from_json のフィールドマッピングや japanese_numeral の漢数字変換ロジック等。）
 Metrics/MethodLength:
@@ -58,12 +58,61 @@ Naming/AccessorMethodName:
   Exclude:
     - lib/japanese_address_parser/**/*.rb
 
-# v4 は正規表現を文字列レベルで逐語コピーする（§3-1）。上流が文字クラス内に
+# v4 は上流 JS の正規表現を文字列レベルで逐語コピーする。上流が文字クラス内に
 # リテラル `|` を含める癖（例: /[都|道|府|県]$/）もそのまま移植するため許容する。
 Lint/DuplicateRegexpCharacterClassElement:
   Exclude:
     - lib/japanese_address_parser/**/*.rb
 
+# 同じく正規表現を逐語コピーするため、上流の冗長なエスケープ（例: 文字クラス内の `\-`）も
+# そのまま写すのを許容する。
+Style/RedundantRegexpEscape:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+# v4 は JS の `array[0]` / `a && a.b` / import 順もそのまま写すため lib では緩める。
+Style/ArrayFirstLast:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+Style/SafeNavigation:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+Style/RequireOrder:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+    - lib/japanese_address_parser.rb
+
+# jis_dai2 の異体字辞書は上流 dict.ts のデータの逐語移植なので許容する。
+Metrics/CollectionLiteralLength:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+# Data.define したクラスの再オープン（Steep 対応。クラスメソッドだけを追加するケース）を
+# 「クラスメソッドのみのクラス」と誤認して module 化を提案するため lib では緩める。
+Style/StaticClass:
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+# Data.define したクラスの再オープンにも別途のドキュメントコメントを要求するため lib では
+# 緩める（VO の説明は定数代入側にある）。merge 指定は .rubocop_todo.yml 側の Exclude を
+# 上書きせず追記するため。
+Style/Documentation:
+  inherit_mode:
+    merge:
+      - Exclude
+  Exclude:
+    - lib/japanese_address_parser/**/*.rb
+
+# キー欠落を黙って nil にせず例外にしたい箇所で Hash#fetch を意図的に使うため無効化する。
+Style/HashLookupMethod:
+  Enabled: false
+
+# 開発依存は従来どおり gemspec で管理する（Gemfile への移行はしない）。
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
 # contextの記述を日本語で記述するのを許容する。
 RSpec/ContextWording:
   Enabled: false
@@ -74,12 +123,24 @@ RSpec/ExampleLength:
 RSpec/MultipleExpectations:
   Enabled: false
 
-# v4 リアーキの spec は隔離のため spec/v4 配下に置く（クラスの名前空間を
-# そのままパスに写すと spec/japanese_address_parser/v4/... となり隔離できない）。
-RSpec/FilePath:
+# spec は上流テストファイル・ドメイン単位の命名（addresses_spec 等）で、クラスの
+# 名前空間をパスに写さない（spec/japanese_address_parser/... 形式にしない）ため無効化。
+RSpec/SpecFilePathFormat:
   Exclude:
     - spec/**/*_spec.rb
 
+# addresses_spec は上流 addresses.test.ts の逐語移植で、CSV の行ごとに describe 直下で
+# 期待値を組み立てて example を生成するデータ駆動形式のため、この cop の警告対象になる。
+# 各変数はイテレーションごとに束縛され example 実行前に変更されないのでリークしない。
+RSpec/LeakyLocalVariable:
+  Exclude:
+    - spec/addresses_spec.rb
+
+# level1 / level3 の数字は位置情報レベル（level: 1 / 3）というドメインの値を指すため許容する。
+RSpec/IndexedLet:
+  Exclude:
+    - spec/normalize_result_point_spec.rb
+
 # filesystem_api_spec は CDN から tmpdir へ一度だけ DL するため before/after(:context) を使う。
 # 状態（Config / モジュールキャッシュ）は around で example ごとに復元・reset し、tmpdir は
 # after(:context) で削除するので、本 cop が警告する状態リークは管理済み。

data/CHANGELOG.md

@@ -18,6 +18,23 @@ Change Log の形式は [Keep a Changelog](http://keepachangelog.com/) に従い
 
 ### Security
 
+## [4.0.1] - 2026-08-22
+
+### Added
+
+- [#149](https://github.com/yamat47/japanese_address_parser/pull/149) Add Trusted Publishing release workflow([@yamat47](https://github.com/yamat47))
+
+### Changed
+
+- [#143](https://github.com/yamat47/japanese_address_parser/pull/143) Bump actions/checkout from 4 to 7([@yamat47](https://github.com/yamat47))
+- [#150](https://github.com/yamat47/japanese_address_parser/pull/150) Group Dependabot updates per ecosystem([@yamat47](https://github.com/yamat47))
+- [#151](https://github.com/yamat47/japanese_address_parser/pull/151) Bump actions/checkout in the github-actions-dependencies group([@yamat47](https://github.com/yamat47))
+- [#152](https://github.com/yamat47/japanese_address_parser/pull/152) Bump the bundler-dependencies group (8 updates) and migrate to RuboCop 1.89 / Steep 2.0([@yamat47](https://github.com/yamat47))
+
+### Security
+
+- [#142](https://github.com/yamat47/japanese_address_parser/pull/142) Update vulnerable development dependencies (activesupport / concurrent-ruby / rexml)([@yamat47](https://github.com/yamat47))
+
 ## [4.0.0]
 
 ### Changed

data/Gemfile.lock

@@ -1,100 +1,144 @@
 PATH
   remote: .
   specs:
-    japanese_address_parser (4.0.0)
+    japanese_address_parser (4.0.1)
       csv
       lru_redux
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.7.1)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+    activesupport (8.1.3.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      tzinfo (~> 2.0)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
     addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
-    ast (2.4.2)
+    ast (2.4.3)
     base64 (0.3.0)
+    benchmark (0.5.0)
     bigdecimal (4.1.2)
-    concurrent-ruby (1.2.2)
+    concurrent-ruby (1.3.8)
+    connection_pool (3.0.2)
     crack (1.0.1)
       bigdecimal
       rexml
-    csv (3.3.2)
-    diff-lcs (1.5.0)
-    ffi (1.15.5)
+    csv (3.3.6)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-aarch64-linux-musl)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    fileutils (1.8.0)
     hashdiff (1.2.1)
-    i18n (1.14.1)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    json (2.6.2)
-    language_server-protocol (3.17.0.1)
-    listen (3.7.1)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.7.0)
     lru_redux (1.1.0)
-    minitest (5.19.0)
-    parallel (1.22.1)
-    parser (3.2.2.3)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    ostruct (0.6.3)
+    parallel (1.28.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
+    prism (1.9.0)
     public_suffix (7.0.5)
-    racc (1.7.1)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (13.4.2)
     rb-fsevent (0.11.2)
-    rb-inotify (0.10.1)
+    rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rbs (2.6.0)
-    regexp_parser (2.5.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.1)
+    rbs (4.1.3)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    regexp_parser (2.12.0)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.1)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.1)
-    rubocop (1.36.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.89.0)
       json (~> 2.3)
-      parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.20.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.21.0)
-      parser (>= 3.1.1.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (2.13.2)
-      rubocop (~> 1.33)
-    ruby-progressbar (1.11.0)
-    steep (1.1.1)
-      activesupport (>= 5.1)
-      language_server-protocol (>= 3.15, < 4.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.10.2)
+      lint_roller (~> 1.1)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    steep (2.0.0)
+      concurrent-ruby (>= 1.1.10)
+      csv (>= 3.0.9)
+      fileutils (>= 1.1.0)
+      json (>= 2.1.0)
+      language_server-protocol (>= 3.17.0.4, < 4.0)
       listen (~> 3.0)
-      parallel (>= 1.0.0)
-      parser (>= 3.1)
+      logger (>= 1.3.0)
+      parser (>= 3.2)
+      prism (>= 0.25.0)
       rainbow (>= 2.2.2, < 4.0)
-      rbs (>= 2.3.2)
-      terminal-table (>= 2, < 4)
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
-    typeprof (0.21.3)
+      rbs (~> 4.0)
+      securerandom (>= 0.1)
+      strscan (>= 1.0.0)
+      terminal-table (>= 2, < 5)
+      uri (>= 0.12.0)
+    strscan (3.1.8)
+    terminal-table (4.0.0)
+      unicode-display_width (>= 1.1.1, < 4)
+    tsort (0.2.0)
+    typeprof (0.21.11)
       rbs (>= 1.8.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.3.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
     webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
@@ -114,7 +158,9 @@ PLATFORMS
 DEPENDENCIES
   activesupport
   base64
+  benchmark
   japanese_address_parser!
+  ostruct
   rake
   rspec
   rubocop

data/Steepfile

@@ -5,13 +5,7 @@ target :lib do
 
   check 'lib'
 
-  configure_code_diagnostics(::Steep::Diagnostic::Ruby.strict)
-end
-
-target :test do
-  signature 'sig'
-
-  check 'spec'
+  library 'csv', 'json', 'net-http', 'socket', 'uri'
 
   configure_code_diagnostics(::Steep::Diagnostic::Ruby.strict)
 end

data/japanese_address_parser.gemspec

@@ -34,6 +34,8 @@ require_relative 'lib/japanese_address_parser/version'
   spec.add_dependency('lru_redux')
   spec.add_development_dependency('activesupport')
   spec.add_development_dependency('base64')
+  spec.add_development_dependency('benchmark')
+  spec.add_development_dependency('ostruct')
   spec.add_development_dependency('rake')
   spec.add_development_dependency('rspec')
   spec.add_development_dependency('rubocop')

data/lib/japanese_address_parser/address.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Public value object returned by the v4 API (M6).
+# Public value object returned by the v4 API.
 # Ruby-original enrichment layer over the faithful NormalizeResult (working_agreement §1-3 / rearchitecture §5.2)。
 # JS の NormalizeResult（文字列 pref/city/town）をネストしたリッチ VO に組み替える。
 
@@ -11,39 +11,40 @@ require 'japanese_address_parser/town'
 module JapaneseAddressParser
   # 正規化結果の公開 VO。prefecture/city/town は未判別なら nil（JS 同様、未マッチは失敗ではない）。
   # metadata は VO に昇格しない生データ（rsdt/chiban 等）の逃がし道（working_agreement §1-3）。
-  Address =
-    ::Data.define(:full_address, :prefecture, :city, :town, :addr, :other, :point, :level, :metadata) do
-      # 内部 NormalizeResult（M5）から公開 Address を組み立てる。
-      def self.from_normalize_result(result)
-        metadata = result.metadata
-        new(
-          full_address: metadata.input,
-          prefecture: Prefecture.from_metadata(metadata.prefecture),
-          city: City.from_metadata(metadata.city),
-          town: Town.from_metadata(metadata.machi_aza),
-          addr: result.addr,
-          other: result.other,
-          point: result.point,
-          level: result.level,
-          metadata:
-        )
-      end
+  Address = ::Data.define(:full_address, :prefecture, :city, :town, :addr, :other, :point, :level, :metadata)
+  public_constant :Address
 
-      # ネストした VO・座標も含めて Hash 化する Ruby 独自 API。metadata は生データの逃がし道として
-      # shallow に Hash 化する（内部の SingleCity 等は VO のまま）。
-      def to_h
-        {
-          full_address:,
-          prefecture: prefecture&.to_h,
-          city: city&.to_h,
-          town: town&.to_h,
-          addr:,
-          other:,
-          point: point&.to_h,
-          level:,
-          metadata: metadata.to_h
-        }
-      end
+  class Address
+    # 内部 NormalizeResult から公開 Address を組み立てる。
+    def self.from_normalize_result(result)
+      metadata = result.metadata
+      new(
+        full_address: metadata.input,
+        prefecture: Prefecture.from_metadata(metadata.prefecture),
+        city: City.from_metadata(metadata.city),
+        town: Town.from_metadata(metadata.machi_aza),
+        addr: result.addr,
+        other: result.other,
+        point: result.point,
+        level: result.level,
+        metadata:
+      )
     end
-  public_constant :Address
+
+    # ネストした VO・座標も含めて Hash 化する Ruby 独自 API。metadata は生データの逃がし道として
+    # shallow に Hash 化する（内部の SingleCity 等は VO のまま）。
+    def to_h
+      {
+        full_address:,
+        prefecture: prefecture&.to_h,
+        city: city&.to_h,
+        town: town&.to_h,
+        addr:,
+        other:,
+        point: point&.to_h,
+        level:,
+        metadata: metadata.to_h
+      }
+    end
+  end
 end

data/lib/japanese_address_parser/cache_regexes.rb

@@ -2,10 +2,8 @@
 
 # Port of: https://github.com/geolonia/normalize-japanese-addresses/blob/49c1ae4be9d2ba353b86eaf40fd7eb12a1269f3e/src/lib/cacheRegexes.ts
 # Upstream: @geolonia/normalize-japanese-addresses v3.1.3
-#   level 0-3 部分のみ。rsdt/chiban（getRsdt/getChiban/fetchSubresource/parseSubresource）は M8 で実装する。
 
 require 'csv'
-require 'set'
 require 'lru_redux'
 require 'japanese_address_parser/config'
 require 'japanese_address_parser/fetcher'
@@ -24,15 +22,16 @@ module JapaneseAddressParser
   module CacheRegexes
     # 「○○町」の省略エイリアス。JS では SingleMachiAza に originalTown を生やした部分オブジェクト。
     # machi_aza_name は oaza_cho（町を除いた名前）を返す（chome/koaza は持たない）。
-    TownAlias =
-      ::Data.define(:machiaza_id, :point, :oaza_cho, :original_town) do
-        # JS: machiAzaName(town) 相当。エイリアスは oaza_cho（町を除いた名前）のみを持つ。
-        def machi_aza_name
-          oaza_cho
-        end
-      end
+    TownAlias = ::Data.define(:machiaza_id, :point, :oaza_cho, :original_town)
     public_constant :TownAlias
 
+    class TownAlias
+      # JS: machiAzaName(town) 相当。エイリアスは oaza_cho（町を除いた名前）のみを持つ。
+      def machi_aza_name
+        oaza_cho
+      end
+    end
+
     module_function
 
     # JS: const cache = new LRUCache({ max: currentConfig.cacheSize })
@@ -67,7 +66,8 @@ module JapaneseAddressParser
 
     # JS: getPrefectures()
     def get_prefectures
-      return @cached_prefectures unless @cached_prefectures.nil?
+      cached = @cached_prefectures
+      return cached unless cached.nil?
 
       response = Fetcher.fetch('.json') # ja.json
       cache_prefectures(Data::PrefectureApi.from_json(response.json))
@@ -80,7 +80,8 @@ module JapaneseAddressParser
 
     # JS: getPrefectureRegexPatterns(api)
     def get_prefecture_regex_patterns(api)
-      return @cached_prefecture_patterns if @cached_prefecture_patterns
+      cached = @cached_prefecture_patterns
+      return cached if cached
 
       @cached_prefecture_patterns =
         api.data.map do |pref|
@@ -137,6 +138,7 @@ module JapaneseAddressParser
         api = get_towns(pref, city, api_version)
         pre_towns = api.data
         town_set = ::Set.new(pre_towns.map(&:machi_aza_name))
+        # @type var towns: ::Array[Data::SingleMachiAza | TownAlias]
         towns = []
 
         is_kyoto = city.city == '京都市'
@@ -163,6 +165,8 @@ module JapaneseAddressParser
         # JS: towns.sort((a, b) => bLen - aLen)（大字始まりは優先度を下げる）— 文字数の降順に安定ソート
         towns = stable_sort_by(towns) { |town| -town_sort_length(town) }
 
+        # 後段の丁目ループは TownAlias を元 VO に剥がさずそのまま追加する（JS と同挙動）。
+        # @type var patterns: ::Array[[Data::SingleMachiAza | TownAlias, ::String]]
         patterns =
           towns.map do |town|
             pattern = Dict.to_regex_pattern(town_pattern_source(town.machi_aza_name))
@@ -190,12 +194,14 @@ module JapaneseAddressParser
 
     # JS: getSameNamedPrefectureCityRegexPatterns(prefApi)
     def get_same_named_prefecture_city_regex_patterns(pref_api)
-      return @cached_same_named_prefecture_city_regex_patterns unless @cached_same_named_prefecture_city_regex_patterns.nil?
+      cached = @cached_same_named_prefecture_city_regex_patterns
+      return cached unless cached.nil?
 
       pref_list = pref_api.data
       # JS: pref.pref.replace(/[都|道|府|県]$/, '') — 文字クラス（| も含む）は上流のまま（$ → \z）
       prefs = pref_list.map { |pref| pref.pref.sub(/[都|道|府|県]\z/, '') }
 
+      # @type var patterns: ::Array[[::String, ::String]]
       patterns = []
       pref_list.each do |pref|
         pref.cities.each do |city|
@@ -248,7 +254,8 @@ module JapaneseAddressParser
       # JS: firstLineEnd = data.indexOf('\n')（未検出は -1）; rest = data.slice(firstLineEnd + 1)
       first_line_end = data.index("\n") || -1
       rest = data[(first_line_end + 1)..].to_s
-      ::CSV.parse(rest, headers: true).filter_map do |row|
+      rows = _ = ::CSV.parse(rest, headers: true)
+      rows.filter_map do |row|
         point = point_from(row['lng'], row['lat'])
         if row.headers.include?('blk_num') # JS: 'blk_num' in line
           Data::SingleRsdt.new(blk_num: row['blk_num'], rsdt_num: row['rsdt_num'], rsdt_num2: row['rsdt_num2'], point:)
@@ -296,7 +303,7 @@ module JapaneseAddressParser
       x_cho = target_town_name.scan(/.町/) # JS: match(/.町/g)
       return false if x_cho.empty?
 
-      !JapaneseNumeral.find_kanji_numbers(x_cho[0]).empty?
+      !JapaneseNumeral.find_kanji_numbers(x_cho[0].to_s).empty?
     end
 
     # JS: getTownRegexPatterns 内の machiAzaName(town).replace(...) チェーン（toRegexPattern へ渡す前段）。
@@ -314,6 +321,7 @@ module JapaneseAddressParser
     # JS: getTownRegexPatterns 内の数字パターン展開コールバック。
     def expand_town_number(match)
       suffix = /(丁目?|番(町|丁)|条|軒|線|(の|ノ)町|地割|号)/
+      # @type var patterns: ::Array[::String]
       patterns = []
       patterns << match.sub(suffix, '') # 漢数字（接尾辞を除く）
 

data/lib/japanese_address_parser/city.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.city（SingleCity VO）。
 
@@ -8,19 +8,20 @@ require 'japanese_address_parser/normalize_result_point'
 
 module JapaneseAddressParser
   # 市区町村のリッチ VO。name は cityName（郡＋市＋政令区）。point は代表点（NormalizeResultPoint, level 2）。
-  City =
-    ::Data.define(:name, :code, :county, :ward, :name_kana, :name_romaji, :point) do
-      # metadata.city（SingleCity VO）から VO を作る。city 未判別なら nil。
-      def self.from_metadata(city)
-        return if city.nil?
+  City = ::Data.define(:name, :code, :county, :ward, :name_kana, :name_romaji, :point)
+  public_constant :City
 
-        new(name: city.city_name, code: city.code, county: city.county, ward: city.ward, name_kana: city.city_k, name_romaji: city.city_r, point: ResultPoint.city_to_result_point(city))
-      end
+  class City
+    # metadata.city（SingleCity VO）から VO を作る。city 未判別なら nil。
+    def self.from_metadata(city)
+      return if city.nil?
 
-      # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
-      def to_h
-        { name:, code:, county:, ward:, name_kana:, name_romaji:, point: point.to_h }
-      end
+      new(name: city.city_name, code: city.code, county: city.county, ward: city.ward, name_kana: city.city_k, name_romaji: city.city_r, point: ResultPoint.city_to_result_point(city))
     end
-  public_constant :City
+
+    # 緯度経度をネストも含めて Hash 化する Ruby 独自 API。
+    def to_h
+      { name:, code:, county:, ward:, name_kana:, name_romaji:, point: point.to_h }
+    end
+  end
 end

data/lib/japanese_address_parser/data/api_meta.rb

@@ -7,13 +7,14 @@ module JapaneseAddressParser
   module Data
     # API レスポンスの meta。`updated` はデータの更新時刻で、町字/サブリソース取得時の
     # `?v={apiVersion}` に使う（キャッシュバスティング）。
-    ApiMeta =
-      ::Data.define(:updated) do
-        # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
-        def self.from_json(hash)
-          new(updated: hash['updated'])
-        end
-      end
+    ApiMeta = ::Data.define(:updated)
     public_constant :ApiMeta
+
+    class ApiMeta
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(updated: hash['updated'])
+      end
+    end
   end
 end

data/lib/japanese_address_parser/data/machi_aza_api.rb

@@ -9,13 +9,14 @@ require 'japanese_address_parser/data/single_machi_aza'
 module JapaneseAddressParser
   module Data
     # api/ja/{県}/{市}.json のレスポンス全体（町字一覧）。JS の MachiAzaApi。
-    MachiAzaApi =
-      ::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 { |machi_aza| SingleMachiAza.from_json(machi_aza) })
-        end
-      end
+    MachiAzaApi = ::Data.define(:meta, :data)
     public_constant :MachiAzaApi
+
+    class MachiAzaApi
+      # JSON（パース済み Hash・文字列キー）から VO を生成する Ruby 独自ヘルパ。
+      def self.from_json(hash)
+        new(meta: ApiMeta.from_json(hash['meta']), data: (hash['data'] || []).map { |machi_aza| SingleMachiAza.from_json(machi_aza) })
+      end
+    end
   end
 end