jlpt 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 351c7b81b049e4ef39a34cacf7d20e1d7ce04f1d302b7ed0033f62d48dd6eef3
+  data.tar.gz: 903b1e3d8e7b5054a20ae4cb532325cd823dfe0e9de98800ec9705acd80b8651
+SHA512:
+  metadata.gz: 6b5c45194f1469bc1c9e2345b8ea82766a36aa0d21e276f696baa560c7f02a1e4b57f252b9998d1d8e8cf15a2ee1ace6cda520c242ba5e39462fd413b5cb8567
+  data.tar.gz: b41d13beb80bcc12238ed986a5c516f5c3d7ea38a5fd2be6e994c39bdf10ffa62c1c0ab023bf0307bdc74ffdc44ff30b7054aba84fce6a7197db7eb585f8ea96

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jakub Polak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.ja.md

@@ -0,0 +1,246 @@
+<p align="center">
+  <img src="assets/logo.png" alt="JLPT Ruby Gem Logo" width="500">
+</p>
+
+<h1 align="center">JLPT</h1>
+
+<p align="center">
+  <a href="https://github.com/kupolak/jlpt/actions/workflows/ci.yml"><img src="https://github.com/kupolak/jlpt/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://badge.fury.io/rb/jlpt"><img src="https://badge.fury.io/rb/jlpt.svg" alt="Gem Version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <strong>日本語テキスト解析およびJLPT難易度判定（N5〜N1）のためのRuby Gem</strong>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <strong>日本語</strong>
+</p>
+
+JLPT Gemは、日本語テキストの形態素解析、語彙および漢字のJLPT難易度レベル分類（N5〜N1）、ルビ（ふりがな）生成、品詞分布プロファイリング、言い換え・簡略化提案、試験合格可能性評価、Anki用カード出力などを提供する包括的なライブラリです。
+
+---
+
+## 目次
+
+- [インストール](#インストール)
+- [クイックスタート](#クイックスタート)
+  - [1. 基本的なテキスト解析](#1-基本的なテキスト解析)
+  - [2. グローバル設定とオプション](#2-グローバル設定とオプション)
+  - [3. ルビ（ふりがな）・ローマ字生成](#3-ルビふりがなローマ字生成)
+  - [4. テキストプロファイラーと分析機能](#4-テキストプロファイラーと分析機能)
+  - [5. Ankiカード出力・一括処理](#5-ankiカード出力一括処理)
+  - [6. HTML / Markdown ビジュアルレポート](#6-html--markdown-ビジュアルレポート)
+  - [7. Rails ActiveModel バリデーション](#7-rails-activemodel-バリデーション)
+  - [8. CLI コマンドラインツール](#8-cli-コマンドラインツール)
+- [開発](#開発)
+- [ライセンス](#ライセンス)
+
+---
+
+## インストール
+
+`Gemfile` に以下を追加してください:
+
+```ruby
+gem 'jlpt', '~> 1.0.0'
+```
+
+その後、以下のコマンドを実行します:
+
+```bash
+bundle install
+```
+
+または直接インストールします:
+
+```bash
+gem install jlpt
+```
+
+---
+
+## クイックスタート
+
+### 1. 基本的なテキスト解析
+
+```ruby
+require 'jlpt'
+
+result = JLPT.analyze("日本語の勉強はとても面白いです。")
+
+result.recommended_level #=> :n5
+result.score             #=> 25.0
+result.word_count        #=> 7
+result.sentence_count    #=> 1
+result.kanji_density     #=> 0.44
+```
+
+### 2. グローバル設定とオプション
+
+`JLPT.configure` で動作オプションをカスタマイズできます:
+
+```ruby
+JLPT.configure do |config|
+  # ふりがなのデフォルト出力フォーマット (:html, :anki, :markdown)
+  config.default_furigana_format = :anki # デフォルト: :html
+
+  # LRUキャッシュ容量 (メモリ上に保持する解析結果の件数)
+  config.cache_capacity = 2000 # デフォルト: 1000
+
+  # MeCab / natto が未インストール時のPure-Rubyフォールバック
+  config.mecab_fallback = true # デフォルト: true
+end
+```
+
+設定をデフォルト値にリセットするには:
+
+```ruby
+JLPT.reset_config!
+```
+
+#### 設定オプション一覧
+
+| オプション / パラメータ | 指定可能な値 | デフォルト | 説明 |
+| :--- | :--- | :--- | :--- |
+| `default_furigana_format` | `:html`, `:anki`, `:markdown` | `:html` | `JLPT::Furigana.render` のデフォルトフォーマット |
+| `cache_capacity` | `Integer` (例: `500`, `2000`) | `1000` | LRUキャッシュの最大件数 |
+| `mecab_fallback` | `true`, `false` | `true` | MeCab非搭載環境でのPure-Rubyトークナイザー利用 |
+| `target_level` | `:n5`, `:n4`, `:n3`, `:n2`, `:n1` | `:n4` | 目標JLPTレベル（試験準備度およびエクスポート用） |
+| `format` (CLI & Reporter) | `:text`, `:json`, `:html`, `:markdown` | `:text` | 出力フォーマット |
+
+---
+
+### 3. ルビ（ふりがな）・ローマ字生成
+
+```ruby
+JLPT::Furigana.render("学校に行く", format: :html)
+#=> "<ruby><rb>学校</rb><rt>がっこう</rt></ruby>に<ruby><rb>行</rb><rt>い</rt></ruby>く"
+
+JLPT::Furigana.render("学校に行く", format: :anki)
+#=> "学校[がっこう]に行[い]く"
+
+JLPT::Furigana.to_romaji("がっこう")
+#=> "gakkou"
+```
+
+---
+
+### 4. テキストプロファイラーと分析機能
+
+```ruby
+# 品詞分布プロファイル
+JLPT::PosProfiler.profile("学校に行きます。")
+
+# 文法パターン抽出 (N5〜N1)
+JLPT::Grammar.extract("食べてはいけない")
+#=> [{ name: "〜てはいけない", level: :n5, pattern: /.../ }]
+
+# 構文・節の複雑さ分析
+JLPT::Syntax.analyze("雨が降ったから、学校に行かなかった。")
+#=> { conjunction_count: 1, conjunctions: ["から"], avg_clauses_per_sentence: 2.0, complexity_index: 50.0 }
+
+# JLPT目標レベルに対する準備度評価
+JLPT::ExamReadiness.evaluate("割合", target_level: :n3)
+#=> { target_level: :n3, current_level: :n4, readiness_score: 80.86, status: :moderate }
+
+# 敬語・文体プロファイリング
+JLPT::StyleProfiler.profile("ご覧になる")
+#=> { formality_score: 90.0, register: :polite, sonkeigo_count: 1, ... }
+
+# 外来語（カタカナ語）抽出
+JLPT::Loanwords.extract("デパートでパンを買う")
+#=> ["デパート", "パン"]
+
+# 漢字詳細情報照会 (画数・部首・音訓読み・レベル)
+JLPT::KanjiDetails.lookup("学")
+#=> { character: "学", strokes: 8, radical: "子", onyomi: ["ガク"], kunyomi: ["まな.ぶ"], level: :n5 }
+
+# 難解語の言い換え・簡略化提案
+JLPT::Simplifier.simplify("著しい")
+#=> [{ word: "著しい", level: :n1, reading: "いちじるしい", suggestions: ["大きい", "目立つ"] }]
+
+# テキスト・教材間比較（ジャカード係数・共通語彙）
+JLPT::Comparer.compare("私と学校に行く", "私と図書館に行く")
+#=> { overlap_ratio: 0.71, shared_vocab: ["私", "と", "に", "行", "く"], shared_kanji: ["私", "行"] }
+```
+
+---
+
+### 5. Ankiカード出力・一括処理
+
+```ruby
+# 学習目標レベルを超える未知語の抽出
+JLPT::Exporter.find_unknown("急速な発展", target_level: :n4)
+
+# Anki用TSV形式で出力
+JLPT::Exporter.to_anki_tsv("急速な発展", target_level: :n4)
+
+# 複数章・ドキュメントの一括解析
+JLPT::BatchProcessor.process({ "Chapter 1" => "私と学校", "Chapter 2" => "急速な発展" })
+```
+
+---
+
+### 6. HTML / Markdown ビジュアルレポート
+
+```ruby
+result = JLPT.analyze("日本語の勉強")
+
+# 自己完結型HTMLレポート文字列の生成
+html_report = JLPT::Reporter.render_html(result)
+
+# Markdownサマリーテーブルの生成
+md_report = JLPT::Reporter.render_markdown(result)
+```
+
+---
+
+### 7. Rails ActiveModel バリデーション
+
+Railsモデルでユーザー入力の難易度制限を検証します:
+
+```ruby
+class Lesson < ApplicationRecord
+  validates :content, jlpt_level: { max_level: :n3 }
+end
+```
+
+---
+
+### 8. CLI コマンドラインツール
+
+```bash
+# テキスト解析
+jlpt analyze "日本語の勉強"
+
+# ふりがな生成 (Anki形式)
+jlpt furigana "漢字の読み方" --format markdown
+
+# 未知語をAnki TSV形式でファイル出力
+jlpt export "急速な発展" --target n4 > flashcards.tsv
+
+# 漢字詳細・活用・簡略化・統計コマンド
+jlpt kanji "学"
+jlpt conjugate "食べさせられた"
+jlpt simplify "著しい"
+jlpt stats "私と学校"
+```
+
+---
+
+## 開発
+
+テストおよびリンターの実行:
+
+```bash
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+## ライセンス
+
+オープンソースソフトウェアとして [MIT License](LICENSE) の下で利用可能です。

data/README.md

@@ -0,0 +1,224 @@
+<p align="center">
+  <img src="assets/logo.png" alt="JLPT Ruby Gem Logo" width="500">
+</p>
+
+<h1 align="center">JLPT</h1>
+
+<p align="center">
+  <a href="https://github.com/kupolak/jlpt/actions/workflows/ci.yml"><img src="https://github.com/kupolak/jlpt/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://badge.fury.io/rb/jlpt"><img src="https://badge.fury.io/rb/jlpt.svg" alt="Gem Version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <strong>A Ruby gem for Japanese text analysis and JLPT difficulty classification (N5–N1).</strong>
+</p>
+
+<p align="center">
+  <strong>English</strong> | <a href="README.ja.md">日本語</a>
+</p>
+
+It parses Japanese text, classifies vocabulary and kanji by JLPT level, generates furigana, profiles part-of-speech distributions, and provides utilities for text simplification, exam readiness evaluation, and Anki card export.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+  - [1. Basic Analysis](#1-basic-analysis)
+  - [2. Global Configuration & Options](#2-global-configuration--options)
+  - [3. Furigana & Romaji Generation](#3-furigana--romaji-generation)
+  - [4. Text Profiling & Analyzers](#4-text-profiling--analyzers)
+  - [5. Anki Exporting & Batch Processing](#5-anki-exporting--batch-processing)
+  - [6. HTML & Markdown Visual Reports](#6-html--markdown-visual-reports)
+  - [7. Rails ActiveModel Integration](#7-rails-activemodel-integration)
+  - [8. CLI Runner](#8-cli-runner)
+- [Development](#development)
+- [License](#license)
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'jlpt'
+```
+
+And then run:
+
+```bash
+bundle install
+```
+
+Or install it directly:
+
+```bash
+gem install jlpt
+```
+
+## Quick Start
+
+### 1. Basic Analysis
+
+```ruby
+require 'jlpt'
+
+result = JLPT.analyze("日本語の勉強はとても面白いです。")
+
+result.recommended_level #=> :n5
+result.score             #=> 25.0
+result.word_count        #=> 7
+result.sentence_count    #=> 1
+result.kanji_density     #=> 0.44
+```
+
+### 2. Global Configuration & Options
+
+Customize global library settings using `JLPT.configure`:
+
+```ruby
+JLPT.configure do |config|
+  # Default output format for Furigana (:html, :anki, or :markdown)
+  config.default_furigana_format = :anki # Default: :html
+
+  # Capacity for the LRU cache (number of analyzed texts stored in memory)
+  config.cache_capacity = 2000 # Default: 1000
+
+  # Automatic pure-Ruby tokenizer fallback when MeCab/natto gem is absent
+  config.mecab_fallback = true # Default: true
+end
+```
+
+To reset configuration back to defaults at any point:
+
+```ruby
+JLPT.reset_config!
+```
+
+#### Summary of Available Options
+
+| Option / Parameter | Allowed Values / Symbols | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `default_furigana_format` | `:html`, `:anki`, `:markdown` | `:html` | Default format used by `JLPT::Furigana.render` |
+| `cache_capacity` | `Integer` (e.g. `500`, `2000`) | `1000` | Max entries stored in memory LRU cache |
+| `mecab_fallback` | `true`, `false` | `true` | Enable pure-Ruby tokenizer fallback if MeCab is missing |
+| `target_level` | `:n5`, `:n4`, `:n3`, `:n2`, `:n1` | `:n4` | Target JLPT level for exam readiness & exporter |
+| `format` (CLI & Reporter) | `:text`, `:json`, `:html`, `:markdown` | `:text` | Output format for CLI runner and Reporter |
+
+### 3. Furigana & Romaji Generation
+
+```ruby
+JLPT::Furigana.render("学校に行く", format: :html)
+#=> "<ruby><rb>学校</rb><rt>がっこう</rt></ruby>に<ruby><rb>行</rb><rt>い</rt></ruby>く"
+
+JLPT::Furigana.render("学校に行く", format: :anki)
+#=> "学校[がっこう]に行[い]く"
+
+JLPT::Furigana.to_romaji("がっこう")
+#=> "gakkou"
+```
+
+### 4. Text Profiling & Analyzers
+
+```ruby
+# Part-of-Speech Distribution
+JLPT::PosProfiler.profile("学校に行きます。")
+
+# Grammar Pattern Extraction
+JLPT::Grammar.extract("食べてはいけない")
+#=> [{ name: "〜てはいけない", level: :n5, pattern: /.../ }]
+
+# Syntactic Clause Complexity
+JLPT::Syntax.analyze("雨が降ったから、学校に行かなかった。")
+#=> { conjunction_count: 1, conjunctions: ["から"], avg_clauses_per_sentence: 2.0, complexity_index: 50.0 }
+
+# Exam Readiness Evaluation
+JLPT::ExamReadiness.evaluate("割合", target_level: :n3)
+#=> { target_level: :n3, current_level: :n4, readiness_score: 80.86, status: :moderate }
+
+# Style & Keigo Profiling
+JLPT::StyleProfiler.profile("ご覧になる")
+#=> { formality_score: 90.0, register: :polite, sonkeigo_count: 1, ... }
+
+# Katakana Loanwords Extraction
+JLPT::Loanwords.extract("デパートでパンを買う")
+#=> ["デパート", "パン"]
+
+# Kanji Details Lookup
+JLPT::KanjiDetails.lookup("学")
+#=> { character: "学", strokes: 8, radical: "子", onyomi: ["ガク"], kunyomi: ["まな.ぶ"], level: :n5 }
+
+# Beginner Text Simplification
+JLPT::Simplifier.simplify("著しい")
+#=> [{ word: "著しい", level: :n1, reading: "いちじるしい", suggestions: ["大きい", "目立つ"] }]
+
+# Lesson & Text Comparison
+JLPT::Comparer.compare("私と学校に行く", "私と図書館に行く")
+#=> { overlap_ratio: 0.71, shared_vocab: ["私", "と", "に", "行", "く"], shared_kanji: ["私", "行"] }
+```
+
+### 5. Anki Exporting & Batch Processing
+
+```ruby
+# Find words above learner target level
+JLPT::Exporter.find_unknown("急速な発展", target_level: :n4)
+
+# Export TSV for Anki flashcards
+JLPT::Exporter.to_anki_tsv("急速な発展", target_level: :n4)
+
+# Multi-chapter / Document Batch Processing
+JLPT::BatchProcessor.process({ "Chapter 1" => "私と学校", "Chapter 2" => "急速な発展" })
+```
+
+### 6. HTML & Markdown Visual Reports
+
+```ruby
+result = JLPT.analyze("日本語の勉強")
+
+# Render self-contained HTML report string
+html_report = JLPT::Reporter.render_html(result)
+
+# Render Markdown summary table
+md_report = JLPT::Reporter.render_markdown(result)
+```
+
+### 7. Rails ActiveModel Integration
+
+Use the built-in ActiveModel validator to ensure user input does not exceed a given JLPT level:
+
+```ruby
+class Lesson < ApplicationRecord
+  validates :content, jlpt_level: { max_level: :n3 }
+end
+```
+
+### 8. CLI Runner
+
+```bash
+# Analyze Japanese text
+jlpt analyze "日本語の勉強"
+
+# Generate Furigana annotations in Anki format
+jlpt furigana "漢字の読み方" --format markdown
+
+# Export unknown words exceeding N4 level to TSV
+jlpt export "急速な発展" --target n4 > flashcards.tsv
+
+# Inspect Kanji details or verb conjugations
+jlpt kanji "学"
+jlpt conjugate "食べさせられた"
+jlpt simplify "著しい"
+jlpt stats "私と学校"
+```
+
+## Development
+
+Run tests and linter:
+
+```bash
+bundle exec rspec
+bundle exec rubocop
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/bin/jlpt

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/jlpt'
+require_relative '../lib/jlpt/cli'
+
+exit(JLPT::CLI.run(ARGV))

data/lib/jlpt/active_model/validator.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module JLPT
+  module ActiveModel
+    # ActiveModel Validator enforcing JLPT level difficulty constraints on Rails models.
+    #
+    # @example Usage in Rails Model
+    #   class Lesson < ApplicationRecord
+    #     validates :content, jlpt_level: { max_level: :n3 }
+    #   end
+    #
+    class Validator
+      LEVEL_VALS = { n5: 1, n4: 2, n3: 3, n2: 4, n1: 5 }.freeze
+
+      class << self
+        # Validate model attribute against max_level constraint
+        #
+        # @param record [Object] Rails model instance
+        # @param attribute [Symbol] attribute name
+        # @param value [String] text content
+        # @param max_level [Symbol] maximum allowed level (:n5, :n4, :n3, :n2)
+        def validate(record, attribute, value, max_level: :n3)
+          return if value.nil? || value.to_s.strip.empty?
+
+          res = JLPT.analyze(value)
+          add_error_if_exceeds(record, attribute, res, max_level)
+        end
+
+        private
+
+        def add_error_if_exceeds(record, attribute, res, max_level)
+          current_val = LEVEL_VALS[res.recommended_level] || 1
+          max_val = LEVEL_VALS[max_level.to_s.downcase.to_sym] || 3
+          return unless current_val > max_val
+
+          msg = "difficulty level (#{res.recommended_level.to_s.upcase}) exceeds maximum allowed " \
+                "level (#{max_level.to_s.upcase})"
+          record.errors.add(attribute, msg) if record.respond_to?(:errors)
+        end
+      end
+    end
+  end
+end

data/lib/jlpt/analyzers/comparer.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module JLPT
+  # Text Similarity and Lesson Vocabulary Comparer.
+  #
+  # Compares two Japanese texts for vocabulary overlap (Jaccard similarity),
+  # shared kanji characters, and relative JLPT difficulty differences.
+  #
+  module Comparer
+    class << self
+      # Compare two Japanese texts
+      #
+      # @param text_a [String] first text
+      # @param text_b [String] second text
+      # @return [Hash] comparison metrics hash
+      def compare(text_a, text_b)
+        lem_a = Tokenizer.lemmata(text_a).to_set
+        lem_b = Tokenizer.lemmata(text_b).to_set
+        return empty_comparison if lem_a.empty? || lem_b.empty?
+
+        compute_metrics(lem_a, lem_b, text_a, text_b)
+      end
+
+      private
+
+      def compute_metrics(lem_a, lem_b, text_a, text_b)
+        shared_v = (lem_a & lem_b).to_a
+        jaccard = (shared_v.length.to_f / (lem_a | lem_b).length).round(2)
+
+        { overlap_ratio: jaccard, shared_vocab: shared_v, shared_kanji: extract_shared_kanji(text_a, text_b),
+          text_a_level: JLPT.analyze(text_a).recommended_level,
+          text_b_level: JLPT.analyze(text_b).recommended_level }
+      end
+
+      def extract_shared_kanji(text_a, text_b)
+        (Kanji.extract(text_a).to_set & Kanji.extract(text_b).to_set).to_a
+      end
+
+      def empty_comparison
+        { overlap_ratio: 0.0, shared_vocab: [], shared_kanji: [], text_a_level: :n5, text_b_level: :n5 }
+      end
+    end
+  end
+end

data/lib/jlpt/analyzers/conjugation.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module JLPT
+  # Verb and Adjective Inflection & Conjugation Analyzer.
+  #
+  # Identifies grammatical conjugations including te-form, causative, passive,
+  # potential, volitional, conditional, and past tense.
+  #
+  module Conjugation
+    class << self
+      # Analyze inflection type and form tags of a verb or adjective
+      #
+      # @param word [String] conjugated Japanese verb or adjective
+      # @return [Hash] conjugation details hash
+      def analyze(word)
+        return empty_result if word.nil? || word.to_s.strip.empty?
+
+        str = word.to_s.strip
+        forms = detect_voice_forms(str) + detect_tense_and_mood_forms(str)
+        { word: str, type: detect_type(str), forms: forms.uniq }
+      end
+
+      private
+
+      def detect_voice_forms(str)
+        if str.end_with?('せられた', 'せられる', 'させられた', 'させられる')
+          [:causative_passive]
+        elsif str.end_with?('させる', 'させた', 'させ')
+          [:causative]
+        elsif str.end_with?('られる', 'られた', 'れる', 'れた')
+          [:passive]
+        else
+          []
+        end
+      end
+
+      def detect_tense_and_mood_forms(str)
+        forms = []
+        forms << :te_form if str.end_with?('て', 'で')
+        forms << :past if str.end_with?('た', 'だ', 'ました', 'でした')
+        forms << :volitional if str.end_with?('よう', 'おう', 'ましょう')
+        forms << :conditional if str.end_with?('たら', 'ば', 'なら')
+        forms
+      end
+
+      def detect_type(str)
+        return :suru_verb if str.end_with?('する', 'した', 'して', 'します')
+        return :kuru_verb if str.end_with?('くる', 'きた', 'きて', 'きます')
+        return :i_adjective if str.end_with?('い', 'かった', 'くて')
+        return :na_adjective if str.end_with?('だ', 'です', 'でした')
+
+        :verb
+      end
+
+      def empty_result
+        { word: '', type: :unknown, forms: [] }
+      end
+    end
+  end
+end