cyrillic 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a5904094fb9d492197e816b4dd0270aa4245e64fe3388b5a8177bef6deb01fd
-  data.tar.gz: 2fd71ce5f7e37778beae85554c5bcfc6277b348278d931219efddbbae6175020
+  metadata.gz: 6ccb18a2a8380ecae221098c62b00e1d21654f99020a78a48d921763075adaac
+  data.tar.gz: d5ef041b472f740ab9461b67efbeb683b85120adf5a34d5d21d5fa10067a7d30
 SHA512:
-  metadata.gz: ea05ab8fbb717eec3902faca17b7c2783fb8e5e2dd5feab4ef003f0d979d1e91dadc001cde2fdc06d86eb8beaaf503621b61df8b23137e47b798c61cf384eba0
-  data.tar.gz: dfd8f00970bb557ed16b6d7db598365f6110ebc8815f9ab088ef164a392bc075d94c285859eb80a021d71645c27c76495454dd1f0f9f2688205f3ebc17731852
+  metadata.gz: 8e60b7cb7871b6b7bc0d787cf4520ef0a28dbd2ac63ddb117f1a2d44527191576037f6cf7d269b1e66a157489c56a89c32d5269cf0cd074fec68553427759e3f
+  data.tar.gz: 26d33008bf7af9bc70926dff63ce77d0d4cff9542cfd73dc3bd787aae2a0171a35617339684fcbb14401b94e1368f750968f9bbded55d95e9b66f72872de9b4a

data/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-17
+
+### Added
+- 5 new transliteration schemes:
+  - Serbian (`:serbian`) translating Vuk's Cyrillic to Gaj's Latin (`Lj`, `Nj`, `Dž`, `Đ`, `Ć`).
+  - GOST 7.79-2000 System B (`:gost779b`) with standard ASCII digraphs.
+  - BGN/PCGN 1947 geographic romanization (`:bgn_pcgn`).
+  - Bulgarian official Streamlined System (`:bulgarian`).
+  - Belarusian national / UN 2012 Łacinka (`:belarusian`).
+- Reverse transliteration (detransliteration) via `Cyrillic.detransliterate` (and aliases `.det`, `.reverse_transliterate`) with reverse mapping tables and longest-token-first greedy matching.
+- CLI flag `-r, --reverse` for reversing transliterated text back to Cyrillic.
+- Comprehensive fixture datasets in `test/fixtures/` and automated test suite in `test/fixtures_test.rb` verifying Ukrainian, Serbian, Bulgarian, Belarusian, Mongolian, and standard international schemes.
+- Comprehensive performance benchmark suite in `benchmark/run.rb` with `rake benchmark` task testing all schemes, detransliteration, and text scale using `benchmark-ips`.
+- Automated YARD documentation generation and deployment to GitHub Pages via `.github/workflows/docs.yml` and `rake yard` task.
+- Documentation link badge in `README.md` and `documentation_uri` gem metadata.
+- CLI executable support and unit test coverage for all new schemes and detransliteration.
+
 ## [0.3.0] - 2026-09-17
 
 ### Added

data/README.md

@@ -1,6 +1,7 @@
 # Cyrillic
 
 [![Ruby](https://github.com/rovetz/cyrillic/actions/workflows/ruby.yml/badge.svg)](https://github.com/rovetz/cyrillic/actions/workflows/ruby.yml)
+[![Docs](https://img.shields.io/badge/docs-rubydoc.info-blue.svg)](https://rovetz.github.io/cyrillic/)
 [![Gem Version](https://badge.fury.io/rb/cyrillic.svg)](https://badge.fury.io/rb/cyrillic)
 [![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
@@ -9,9 +10,14 @@
 ## Supported Schemes
 
 *   `:cyrillic` (Default generic Cyrillic transliteration)
-*   `:iso9` (ISO 9:1995 standard)
+*   `:iso9` (ISO 9:1995 international standard)
+*   `:serbian` (Serbian Vuk's Cyrillic to Gaj's Latin)
+*   `:gost779b` (GOST 7.79-2000 System B ASCII digraphs)
+*   `:bgn_pcgn` (BGN/PCGN 1947 geographic romanization)
+*   `:bulgarian` (Bulgarian official Streamlined System)
+*   `:belarusian` (Belarusian national / UN 2012 Łacinka)
 *   `:ukrainian` (Ukrainian national standard)
-*   `:ua_passport` (Ukrainian international passport transliteration standard)
+*   `:ua_passport` (Ukrainian international passport standard)
 *   `:mongolian` (Mongolian Cyrillic MNS 5217:2012)
 *   `:de` (German Duden/phonetic transliteration)
 
@@ -48,6 +54,26 @@ Cyrillic.t("Кириллица")
 Cyrillic.t("Не важно, как медленно ты продвигаешься", :iso9)
 # => "Ne važno, kak medlenno ty prodvigaešʹsâ"
 
+# Serbian Cyrillic to Latin (Vukovica to Gajica)
+Cyrillic.t("Љубљана", :serbian)
+# => "Ljubljana"
+
+# GOST 7.79-2000 System B (ASCII digraphs)
+Cyrillic.t("Щука", :gost779b)
+# => "Shhuka"
+
+# BGN/PCGN 1947 geographic romanization
+Cyrillic.t("Хабаровск", :bgn_pcgn)
+# => "Khabarovsk"
+
+# Bulgarian Streamlined System
+Cyrillic.t("България", :bulgarian)
+# => "Balgariya"
+
+# Belarusian national / UN 2012 Łacinka
+Cyrillic.t("Мінск", :belarusian)
+# => "Minsk"
+
 # Ukrainian scheme
 Cyrillic.t("Київ", :ukrainian)
 # => "Kyiv"
@@ -63,6 +89,14 @@ Cyrillic.t("Монгол хэл", :mongolian)
 # German transliteration scheme
 Cyrillic.t("Чайковский", :de)
 # => "Tschajkowskij"
+
+# Reverse transliteration (Detransliteration)
+Cyrillic.detransliterate("Transliteraciâ", :iso9)
+# => "Транслитерация"
+
+# Short alias .det
+Cyrillic.det("Ljubljana", :serbian)
+# => "Љубљана"
 ```
 
 ### Command Line Interface (CLI)
@@ -85,6 +119,21 @@ $ cyrillic text.txt
 $ cyrillic -s iso9 "Транслитерация"
 Transliteraciâ
 
+$ cyrillic -s serbian "Љубљана"
+Ljubljana
+
+$ cyrillic -s gost779b "Щука"
+Shhuka
+
+$ cyrillic -s bgn_pcgn "Хабаровск"
+Khabarovsk
+
+$ cyrillic -s bulgarian "България"
+Balgariya
+
+$ cyrillic -s belarusian "Мінск"
+Minsk
+
 $ cyrillic -s ukrainian "Київ"
 Kyiv
 
@@ -93,11 +142,18 @@ Borshchahivka
 
 $ cyrillic -s de "Весна"
 Wesna
+
+# Reverse transliteration (-r, --reverse)
+$ cyrillic -r "Transliteraciâ"
+Транслитерация
+
+$ cyrillic -r -s serbian "Ljubljana"
+Љубљана
 ```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` to run tests and code style checks (RuboCop). You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` to run tests and code style checks (RuboCop). You can run performance benchmarks with `bundle exec rake benchmark`. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 

data/Rakefile

@@ -12,4 +12,18 @@ end
 
 RuboCop::RakeTask.new(:rubocop)
 
+desc "Run performance benchmarks"
+task :benchmark do
+  ruby "benchmark/run.rb"
+end
+
+begin
+  require "yard"
+  YARD::Rake::YardocTask.new do |t|
+    t.files = ["lib/**/*.rb", "-", "README.md", "CHANGELOG.md", "LICENSE.txt"]
+  end
+rescue LoadError
+  # YARD not available
+end
+
 task default: %i[test rubocop]

data/benchmark/run.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "benchmark/ips"
+require_relative "../lib/cyrillic"
+
+SHORT_TEXT = "Не важно, как медленно ты продвигаешься, главное, что ты не останавливаешься."
+PARAGRAPH_TEXT = [
+  "Весна пришла в город с первыми теплыми лучами солнца и ароматом цветущих садов.",
+  "На центральных улицах кипела жизнь: открывались уютные кафе, люди гуляли по набережной.",
+  "Каждый новый день приносил вдохновение, надежду и стремление к созиданию прекрасного будущего.",
+  "В библиотеках и университетах студенты усердно готовились к весенним экзаменам и научным конференциям."
+].join(" ")
+LONG_TEXT = "#{PARAGRAPH_TEXT} " * 30
+
+puts "=" * 60
+puts "Cyrillic Gem Performance Benchmarks"
+puts "Ruby: #{RUBY_DESCRIPTION}"
+puts "=" * 60
+
+puts "\n[1] Schemes Comparison (Paragraph Text, ~350 chars)"
+Benchmark.ips do |x|
+  x.config(time: 1, warmup: 0.5)
+
+  %i[cyrillic iso9 serbian gost779b bgn_pcgn bulgarian belarusian mongolian ukrainian ua_passport de].each do |scheme|
+    x.report(scheme.to_s) do
+      Cyrillic.t(PARAGRAPH_TEXT, scheme)
+    end
+  end
+
+  x.compare!
+end
+
+puts "\n[2] Forward vs Reverse Transliteration (ISO 9 & Serbian)"
+iso9_latin = Cyrillic.t(PARAGRAPH_TEXT, :iso9)
+serbian_cyr = "Београд, Нови Сад, Ниш, Крагујевац, Суботица, Зрењанин, Панчево, Чачак, Краљево, Ваљево."
+serbian_lat = Cyrillic.t(serbian_cyr, :serbian)
+
+Benchmark.ips do |x|
+  x.config(time: 1, warmup: 0.5)
+
+  x.report("iso9 forward")  { Cyrillic.t(PARAGRAPH_TEXT, :iso9) }
+  x.report("iso9 reverse")  { Cyrillic.det(iso9_latin, :iso9) }
+  x.report("serbian fwd")   { Cyrillic.t(serbian_cyr, :serbian) }
+  x.report("serbian rev")   { Cyrillic.det(serbian_lat, :serbian) }
+
+  x.compare!
+end
+
+puts "\n[3] Scalability by Text Size (ISO 9: short, medium, long)"
+Benchmark.ips do |x|
+  x.config(time: 1, warmup: 0.5)
+
+  x.report("short (~75 chars)")    { Cyrillic.t(SHORT_TEXT, :iso9) }
+  x.report("medium (~350 chars)")  { Cyrillic.t(PARAGRAPH_TEXT, :iso9) }
+  x.report("long (~10,500 chars)") { Cyrillic.t(LONG_TEXT, :iso9) }
+
+  x.compare!
+end

data/cyrillic.gemspec

@@ -20,6 +20,7 @@ Gem::Specification.new do |spec|
   spec.metadata["source_code_uri"] = "https://github.com/rovetz/cyrillic"
   spec.metadata["changelog_uri"] = "https://github.com/rovetz/cyrillic/blob/main/CHANGELOG.md"
   spec.metadata["bug_tracker_uri"] = "https://github.com/rovetz/cyrillic/issues"
+  spec.metadata["documentation_uri"] = "https://rovetz.github.io/cyrillic/"
   spec.metadata["rubygems_mfa_required"] = "true"
 
   spec.files = Dir.chdir(__dir__) do
@@ -32,10 +33,13 @@ Gem::Specification.new do |spec|
   spec.executables   = ["cyrillic"]
   spec.require_paths = ["lib"]
 
+  spec.add_development_dependency "benchmark"
+  spec.add_development_dependency "benchmark-ips"
   spec.add_development_dependency "irb"
   spec.add_development_dependency "minitest", ">= 5.25"
   spec.add_development_dependency "rake", ">= 13.2"
   spec.add_development_dependency "rdoc"
   spec.add_development_dependency "rubocop", ">= 1.64"
   spec.add_development_dependency "simplecov", ">= 0.22"
+  spec.add_development_dependency "yard", ">= 0.9.36"
 end

data/exe/cyrillic

@@ -5,29 +5,33 @@ require "optparse"
 require "cyrillic"
 
 scheme = nil
+reverse = false
 
 parser = OptionParser.new do |opts|
   opts.banner = "Usage: cyrillic [options] [text | file...]"
   opts.separator ""
-  opts.separator "Transliterate Cyrillic script to Roman (Latin) script."
+  opts.separator "Transliterate Cyrillic script to Roman (Latin) script, or reverse with -r."
   opts.separator ""
   opts.separator "Examples:"
   opts.separator "  cyrillic 'Кириллица'"
   opts.separator "  echo 'Кириллица' | cyrillic"
-  opts.separator "  cyrillic text.txt"
-  opts.separator "  cyrillic -s iso9 'Транслитерация'"
-  opts.separator "  cyrillic -s ukrainian 'Київ'"
-  opts.separator "  cyrillic -s ua_passport 'Борщагівка'"
-  opts.separator "  cyrillic -s mongolian 'Монгол'"
-  opts.separator "  cyrillic -s de 'Весна'"
+  opts.separator "  cyrillic -r 'Transliteraciâ'"
+  opts.separator "  cyrillic -s serbian 'Љубљана'"
+  opts.separator "  cyrillic -r -s serbian 'Ljubljana'"
+  opts.separator "  cyrillic -r -s gost779b 'Shhuka'"
   opts.separator ""
   opts.separator "Options:"
 
-  opts.on("-s", "--scheme SCHEME", %w[default cyrillic iso9 mongolian ukrainian ua_passport de],
-          "Transliteration scheme (default, cyrillic, iso9, mongolian, ukrainian, ua_passport, de)") do |s|
+  schemes = %w[default cyrillic iso9 mongolian ukrainian ua_passport de serbian gost779b bgn_pcgn bulgarian belarusian]
+  opts.on("-s", "--scheme SCHEME", schemes,
+          "Transliteration scheme (#{schemes.join(', ')})") do |s|
     scheme = s == "default" ? nil : s.to_sym
   end
 
+  opts.on("-r", "--reverse", "Reverse transliteration (Latin to Cyrillic)") do
+    reverse = true
+  end
+
   opts.on("-v", "--version", "Show version") do
     puts "cyrillic #{Cyrillic::VERSION}"
     exit
@@ -41,8 +45,12 @@ end
 
 parser.parse!
 
-transliterate = lambda do |text|
-  Cyrillic.transliterate(text, scheme || :cyrillic)
+process = lambda do |text|
+  if reverse
+    Cyrillic.detransliterate(text, from: scheme || :iso9)
+  else
+    Cyrillic.transliterate(text, scheme || :cyrillic)
+  end
 end
 
 if ARGV.empty?
@@ -51,17 +59,17 @@ if ARGV.empty?
     exit 1
   else
     $stdin.each_line do |line|
-      puts transliterate.call(line.chomp)
+      puts process.call(line.chomp)
     end
   end
 else
   ARGV.each do |arg|
     if File.file?(arg)
       File.foreach(arg) do |line|
-        puts transliterate.call(line.chomp)
+        puts process.call(line.chomp)
       end
     else
-      puts transliterate.call(arg)
+      puts process.call(arg)
     end
   end
 end

data/lib/cyrillic/belarusian.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cyrillic
+  # Belarusian national / UN 2012 Łacinka transliteration.
+  module Belarusian
+    k = %w[
+      А Б В Г Д Е Ё Ж З І Й К Л М Н О П Р С Т У Ў Ф Х Ц Ч Ш Ы Ь Э Ю Я
+      а б в г д е ё ж з і й к л м н о п р с т у ў ф х ц ч ш ы ь э ю я
+    ].freeze
+
+    v = %w[
+      A B V H D E Jo Ž Z I J K L M N O P R S T U Ŭ F Ch C Č Š Y ' E Ju Ja
+      a b v h d e jo ž z i j k l m n o p r s t u ŭ f ch c č š y ' e ju ja
+    ].freeze
+
+    CHARACTER_TABLE = k.zip(v).to_h.freeze
+    REGEXP = Regexp.union(CHARACTER_TABLE.keys).freeze
+  end
+end
+
+Belarusian = Cyrillic::Belarusian unless defined?(Belarusian)

data/lib/cyrillic/bgn_pcgn.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cyrillic
+  # BGN/PCGN 1947 geographic romanization system.
+  module BgnPcgn
+    k = %w[
+      А Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я
+      а б в г д е ё ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ы ь э ю я
+    ].freeze
+
+    v = %w[
+      A B V G D E Yo Zh Z I Y K L M N O P R S T U F Kh Ts Ch Sh Shch " Y ' E Yu Ya
+      a b v g d e yo zh z i y k l m n o p r s t u f kh ts ch sh shch " y ' e yu ya
+    ].freeze
+
+    CHARACTER_TABLE = k.zip(v).to_h.freeze
+    REGEXP = Regexp.union(CHARACTER_TABLE.keys).freeze
+  end
+end
+
+BgnPcgn = Cyrillic::BgnPcgn unless defined?(BgnPcgn)

data/lib/cyrillic/bulgarian.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cyrillic
+  # Bulgarian official Streamlined System (2006/2009) transliteration.
+  module Bulgarian
+    k = %w[
+      А Б В Г Д Е Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ь Ю Я
+      а б в г д е ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ь ю я
+    ].freeze
+
+    v = %w[
+      A B V G D E Zh Z I Y K L M N O P R S T U F H Ts Ch Sh Sht A Y Yu Ya
+      a b v g d e zh z i y k l m n o p r s t u f h ts ch sh sht a y yu ya
+    ].freeze
+
+    CHARACTER_TABLE = k.zip(v).to_h.freeze
+    REGEXP = Regexp.union(CHARACTER_TABLE.keys).freeze
+  end
+end
+
+Bulgarian = Cyrillic::Bulgarian unless defined?(Bulgarian)

data/lib/cyrillic/de.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Cyrillic
+  # German (Duden/phonetic) transliteration system.
   module De
     k = %w[А Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я а б в г д е ё ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ы ь э ю я].freeze
     v = %w[A B W G D E Jo Sch S I J K L M N O P R S T U F Ch Z Tsch Sch Schtsch "" Y "" E Ju Ja a b w g d e jo sch s i j k l m n o p r s t u f ch z tsch sch schtsch "" y "" e ju ja].freeze

data/lib/cyrillic/gost779b.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cyrillic
+  # GOST 7.79-2000 System B (ISO 9 System B) ASCII digraphs transliteration.
+  module Gost779b
+    k = %w[
+      А Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я
+      а б в г д е ё ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ы ь э ю я
+    ].freeze
+
+    v = %w[
+      A B V G D E Yo Zh Z I J K L M N O P R S T U F X Cz Ch Sh Shh " Y ' E' Yu Ya
+      a b v g d e yo zh z i j k l m n o p r s t u f x cz ch sh shh " y ' e' yu ya
+    ].freeze
+
+    CHARACTER_TABLE = k.zip(v).to_h.freeze
+    REGEXP = Regexp.union(CHARACTER_TABLE.keys).freeze
+  end
+end
+
+Gost779b = Cyrillic::Gost779b unless defined?(Gost779b)

data/lib/cyrillic/iso9.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Cyrillic
+  # ISO 9:1995 international standard transliteration.
   module Iso9
     CHARACTER_TABLE = {
       "А" => "A",

data/lib/cyrillic/mongolian.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Cyrillic
+  # Mongolian Cyrillic standard (MNS 5217:2012) romanization.
   module Mongolian
     k = %w[А Б В Г Д Е Ё Ж З И Й К Л М Н О Ө П Р С Т У Ү Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я а б в г д е ё ж з и й к л м н о ө п р с т у ү ф х ц ч ш щ ъ ы ь э ю я].freeze
     v = %w[A B V G D Ye Yo J Z I I K L M N O O P R S T U U F Kh Ts Ch Sh Sh I Y I E Yu Ya a b v g d ye yo j z i i k l m n o o p r s t u u f kh ts ch sh sh i y i e yu ya].freeze

data/lib/cyrillic/serbian.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cyrillic
+  # Serbian Cyrillic to Gaj's Latin transliteration (Vukovica to Gajica).
+  module Serbian
+    k = %w[
+      А Б В Г Д Ђ Е Ж З И Ј К Л Љ М Н Њ О П Р С Т Ћ У Ф Х Ц Ч Џ Ш
+      а б в г д ђ е ж з и ј к л љ м н њ о п р с т ћ у ф х ц ч џ ш
+    ].freeze
+
+    v = %w[
+      A B V G D Đ E Ž Z I J K L Lj M N Nj O P R S T Ć U F H C Č Dž Š
+      a b v g d đ e ž z i j k l lj m n nj o p r s t ć u f h c č dž š
+    ].freeze
+
+    CHARACTER_TABLE = k.zip(v).to_h.freeze
+    REGEXP = Regexp.union(CHARACTER_TABLE.keys).freeze
+  end
+end
+
+Serbian = Cyrillic::Serbian unless defined?(Serbian)

data/lib/cyrillic/ukrainian.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Cyrillic
+  # Ukrainian national transliteration system.
   module Ukrainian
     k = %w[А Б В Г Ґ Д Е Є Ж З И І Ї Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ь Ю Я а б в г ґ д е є ж з и і ї й к л м н о п р с т у ф х ц ч ш щ ь ю я].freeze
     v = %w[A B V H G D E Ye Zh Z Y I Yi I K L M N O P R S T U F Kh Ts Ch Sh Shch ʹ Iu Ia a b v h g d e ye zh z y i yi i k l m n o p r s t u f kh ts ch sh shch ʹ iu ia].freeze

data/lib/cyrillic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cyrillic
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/cyrillic.rb

@@ -6,6 +6,11 @@ require "cyrillic/mongolian"
 require "cyrillic/ukrainian"
 require "cyrillic/ua_passport"
 require "cyrillic/de"
+require "cyrillic/serbian"
+require "cyrillic/gost779b"
+require "cyrillic/bgn_pcgn"
+require "cyrillic/bulgarian"
+require "cyrillic/belarusian"
 
 module Cyrillic
   k = %w[
@@ -27,14 +32,44 @@ module Cyrillic
     mongolian: [Mongolian::CHARACTER_TABLE, Mongolian::REGEXP].freeze,
     ukrainian: [Ukrainian::CHARACTER_TABLE, Ukrainian::REGEXP].freeze,
     ua_passport: :ua_passport,
-    de: [De::CHARACTER_TABLE, De::REGEXP].freeze
+    de: [De::CHARACTER_TABLE, De::REGEXP].freeze,
+    serbian: [Serbian::CHARACTER_TABLE, Serbian::REGEXP].freeze,
+    gost779b: [Gost779b::CHARACTER_TABLE, Gost779b::REGEXP].freeze,
+    bgn_pcgn: [BgnPcgn::CHARACTER_TABLE, BgnPcgn::REGEXP].freeze,
+    bulgarian: [Bulgarian::CHARACTER_TABLE, Bulgarian::REGEXP].freeze,
+    belarusian: [Belarusian::CHARACTER_TABLE, Belarusian::REGEXP].freeze
+  }.freeze
+
+  def self.build_reverse_mapping(table, extra = {})
+    rev = table.reject { |_cyr, lat| lat.nil? || lat.empty? }.to_h { |cyr, lat| [lat, cyr] }
+    rev.merge!(extra)
+    sorted_keys = rev.keys.sort_by { |key| -key.length }
+    [rev.freeze, Regexp.union(sorted_keys).freeze].freeze
+  end
+
+  REVERSE_SCHEMES = {
+    iso9: build_reverse_mapping(Iso9::CHARACTER_TABLE),
+    serbian: build_reverse_mapping(
+      Serbian::CHARACTER_TABLE,
+      { "LJ" => "Љ", "NJ" => "Њ", "DŽ" => "Џ", "DZ" => "Џ", "dz" => "џ" }
+    ),
+    gost779b: build_reverse_mapping(Gost779b::CHARACTER_TABLE),
+    bgn_pcgn: build_reverse_mapping(BgnPcgn::CHARACTER_TABLE),
+    bulgarian: build_reverse_mapping(Bulgarian::CHARACTER_TABLE),
+    belarusian: build_reverse_mapping(Belarusian::CHARACTER_TABLE),
+    mongolian: build_reverse_mapping(Mongolian::CHARACTER_TABLE),
+    ukrainian: build_reverse_mapping(Ukrainian::CHARACTER_TABLE),
+    de: build_reverse_mapping(De::CHARACTER_TABLE),
+    cyrillic: build_reverse_mapping(CHARACTER_TABLE),
+    default: build_reverse_mapping(CHARACTER_TABLE)
   }.freeze
 
   class << self
     # Transliterates Cyrillic text into Roman (Latin) script.
     #
     # @param string [String, #to_s] The text to transliterate.
-    # @param to [Symbol, String] The transliteration scheme (:cyrillic, :iso9, :mongolian, :ukrainian, :ua_passport, :de).
+    # @param to [Symbol, String] The transliteration scheme (:cyrillic, :iso9, :mongolian,
+    #   :ukrainian, :ua_passport, :de, :serbian, :gost779b, :bgn_pcgn, :bulgarian, :belarusian).
     # @return [String] The transliterated Latin script string.
     # @raise [ArgumentError] If the given transliteration scheme is unknown.
     #
@@ -44,8 +79,8 @@ module Cyrillic
     # @example Short alias .t with ISO 9 scheme
     #   Cyrillic.t("Кириллица", :iso9) #=> "Kirillica"
     #
-    # @example Ukrainian Passport scheme
-    #   Cyrillic.t("Борщагівка", :ua_passport) #=> "Borshchahivka"
+    # @example Serbian Cyrillic to Latin (Vukovica to Gajica)
+    #   Cyrillic.t("Љубљана", :serbian) #=> "Ljubljana"
     def transliterate(string = "", to = :cyrillic)
       return "" if string.nil? || string.empty?
 
@@ -62,5 +97,37 @@ module Cyrillic
       string.to_s.gsub(regexp, table)
     end
     alias t transliterate
+
+    # Detransliterates (reverses) Latin script text back into Cyrillic script.
+    #
+    # @param string [String, #to_s] The Latin script text to detransliterate.
+    # @param from [Symbol, String] The scheme to reverse (:iso9, :serbian, :gost779b, etc.).
+    # @return [String] The Cyrillic script string.
+    # @raise [ArgumentError] If the given scheme is unknown.
+    #
+    # @example Reverse ISO 9:1995 transliteration
+    #   Cyrillic.detransliterate("Transliteraciâ", from: :iso9) #=> "Транслитерация"
+    #
+    # @example Reverse Serbian transliteration (Gajica to Vukovica)
+    #   Cyrillic.det("Ljubljana", from: :serbian) #=> "Љубљана"
+    #
+    # @example Reverse GOST 7.79 System B
+    #   Cyrillic.det("Shhuka", from: :gost779b) #=> "Щука"
+    def detransliterate(string = "", scheme = nil, from: nil)
+      return "" if string.nil? || string.empty?
+
+      chosen = from || scheme || :iso9
+      scheme_key = chosen.to_s.downcase.to_sym
+      scheme_data = REVERSE_SCHEMES[scheme_key]
+      unless scheme_data
+        available = (REVERSE_SCHEMES.keys - [:default]).map(&:inspect).join(", ")
+        raise ArgumentError, "Unknown detransliteration scheme: #{chosen.inspect}. Available schemes: #{available}"
+      end
+
+      table, regexp = scheme_data
+      string.to_s.gsub(regexp, table)
+    end
+    alias det detransliterate
+    alias reverse_transliterate detransliterate
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cyrillic
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - rovetz
@@ -9,6 +9,34 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: irb
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +121,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.36
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.36
 description: Converts Cyrillic text to the Roman (Latin) script
 email:
 - zakbox@gmail.com
@@ -107,12 +149,18 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- benchmark/run.rb
 - cyrillic.gemspec
 - exe/cyrillic
 - lib/cyrillic.rb
+- lib/cyrillic/belarusian.rb
+- lib/cyrillic/bgn_pcgn.rb
+- lib/cyrillic/bulgarian.rb
 - lib/cyrillic/de.rb
+- lib/cyrillic/gost779b.rb
 - lib/cyrillic/iso9.rb
 - lib/cyrillic/mongolian.rb
+- lib/cyrillic/serbian.rb
 - lib/cyrillic/ua_passport.rb
 - lib/cyrillic/ukrainian.rb
 - lib/cyrillic/version.rb
@@ -123,6 +171,7 @@ metadata:
   source_code_uri: https://github.com/rovetz/cyrillic
   changelog_uri: https://github.com/rovetz/cyrillic/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/rovetz/cyrillic/issues
+  documentation_uri: https://rovetz.github.io/cyrillic/
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: