pressroom 0.1.0

data/lib/pressroom/transliteration.rb

@@ -0,0 +1,213 @@
+# frozen_string_literal: true
+
+module Pressroom
+  # Transliteration rules the gem carries itself.
+  #
+  # These cannot live in locale files alone. I18n leaves a locale out of
+  # available_locales when its data holds nothing but an :i18n key, which is
+  # exactly the shape of a transliteration-rules file, and I18n.transliterate
+  # then rejects that locale. Padding the files with a filler key would fix
+  # the lookup but would also push :ru and :uk into the host application's
+  # available_locales, which is not this gem's business.
+  #
+  # So: when the locale really is one of the host's, its own rules win --
+  # including the YAML this gem ships, which the host picks up automatically
+  # in that case. Otherwise these tables are used directly.
+  module Transliteration
+    RULES = {
+      ru: {
+        "а" => "a",
+        "б" => "b",
+        "в" => "v",
+        "г" => "g",
+        "д" => "d",
+        "е" => "e",
+        "ё" => "e",
+        "ж" => "zh",
+        "з" => "z",
+        "и" => "i",
+        "й" => "i",
+        "к" => "k",
+        "л" => "l",
+        "м" => "m",
+        "н" => "n",
+        "о" => "o",
+        "п" => "p",
+        "р" => "r",
+        "с" => "s",
+        "т" => "t",
+        "у" => "u",
+        "ф" => "f",
+        "х" => "h",
+        "ц" => "ts",
+        "ч" => "ch",
+        "ш" => "sh",
+        "щ" => "sch",
+        "ъ" => "",
+        "ы" => "y",
+        "ь" => "",
+        "э" => "e",
+        "ю" => "yu",
+        "я" => "ya",
+        "А" => "A",
+        "Б" => "B",
+        "В" => "V",
+        "Г" => "G",
+        "Д" => "D",
+        "Е" => "E",
+        "Ё" => "E",
+        "Ж" => "Zh",
+        "З" => "Z",
+        "И" => "I",
+        "Й" => "I",
+        "К" => "K",
+        "Л" => "L",
+        "М" => "M",
+        "Н" => "N",
+        "О" => "O",
+        "П" => "P",
+        "Р" => "R",
+        "С" => "S",
+        "Т" => "T",
+        "У" => "U",
+        "Ф" => "F",
+        "Х" => "H",
+        "Ц" => "Ts",
+        "Ч" => "Ch",
+        "Ш" => "Sh",
+        "Щ" => "Sch",
+        "Ъ" => "",
+        "Ы" => "Y",
+        "Ь" => "",
+        "Э" => "E",
+        "Ю" => "Yu",
+        "Я" => "Ya",
+      }.freeze,
+      uk: {
+        "а" => "a",
+        "б" => "b",
+        "в" => "v",
+        "г" => "h",
+        "ґ" => "g",
+        "д" => "d",
+        "е" => "e",
+        "є" => "ie",
+        "ж" => "zh",
+        "з" => "z",
+        "и" => "y",
+        "і" => "i",
+        "ї" => "i",
+        "й" => "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",
+        "Є" => "Ie",
+        "Ж" => "Zh",
+        "З" => "Z",
+        "И" => "Y",
+        "І" => "I",
+        "Ї" => "I",
+        "Й" => "I",
+        "К" => "K",
+        "Л" => "L",
+        "М" => "M",
+        "Н" => "N",
+        "О" => "O",
+        "П" => "P",
+        "Р" => "R",
+        "С" => "S",
+        "Т" => "T",
+        "У" => "U",
+        "Ф" => "F",
+        "Х" => "Kh",
+        "Ц" => "Ts",
+        "Ч" => "Ch",
+        "Ш" => "Sh",
+        "Щ" => "Shch",
+        "Ь" => "",
+        "Ю" => "Iu",
+        "Я" => "Ia",
+      }.freeze
+    }.freeze
+
+    CYRILLIC = /\p{Cyrillic}/
+    UKRAINIAN_ONLY = /[іїєґІЇЄҐ]/
+
+    class << self
+      def call(string, locale)
+        string = string.to_s
+        key = locale.to_s.to_sym
+        result = transliterate(string, key)
+
+        cyrillic = string.scan(CYRILLIC).join
+        return result if cyrillic.empty?
+
+        # Judge the Cyrillic characters on their own. A title like
+        # "Как устроен Rails" keeps its Latin word under any locale, so
+        # looking at the whole result would wrongly suggest the locale
+        # coped.
+        return result if usable?(transliterate(cyrillic, key))
+
+        # The configured locale has no rules for this script -- an
+        # English-locale application with a Russian article, which is the
+        # common case rather than the exotic one. Falling back to the
+        # script's own rules beats an empty slug that numbers every article
+        # post-2, post-3, post-4.
+        transliterate(string, detect_script(string))
+      end
+
+      private
+
+      def transliterate(string, key)
+        return I18n.transliterate(string, locale: key, replacement: "") if host_locale?(key)
+
+        rule = RULES[key]
+        return transliterator_for(key, rule).transliterate(string, "") if rule
+
+        I18n.transliterate(string, locale: I18n.default_locale, replacement: "")
+      end
+
+      def usable?(result)
+        result.match?(/[a-zA-Z0-9]/)
+      end
+
+      def detect_script(string)
+        return nil unless string.match?(CYRILLIC)
+
+        string.match?(UKRAINIAN_ONLY) ? :uk : :ru
+      end
+
+      def host_locale?(key)
+        I18n.available_locales.include?(key)
+      end
+
+      def transliterator_for(key, rule)
+        @transliterators ||= {}
+        @transliterators[key] ||= I18n::Backend::Transliterator.get(rule)
+      end
+    end
+  end
+end

data/lib/pressroom/version.rb

@@ -0,0 +1,3 @@
+module Pressroom
+  VERSION = "0.1.0"
+end

data/lib/pressroom.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "pressroom/version"
+require "pressroom/errors"
+require "pressroom/transliteration"
+require "pressroom/configuration"
+require "pressroom/blocks/schema"
+require "pressroom/blocks/definition"
+require "pressroom/blocks/registry"
+require "pressroom/blocks/sanitizer"
+require "pressroom/blocks/renderer"
+require "pressroom/blocks/text_extractor"
+require "pressroom/built_in_blocks"
+require "pressroom/feed"
+require "pressroom/engine"
+
+module Pressroom
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield config
+      config
+    end
+
+    # Test helper: restores pristine defaults between examples.
+    def reset_configuration!
+      @config = Configuration.new
+    end
+
+    def registry
+      @registry ||= Blocks::Registry.new
+    end
+
+    # Public API: registers a block type.
+    #
+    #   Pressroom.register_block :callout do |b|
+    #     b.tool "Callout"
+    #     b.schema { string :title, required: true }
+    #     b.partial "pressroom/blocks/callout"
+    #   end
+    def register_block(type, &block)
+      registry.register(type, &block)
+    end
+
+    # Built per call rather than memoized: configuration may change at
+    # runtime in tests, and construction is cheap.
+    def renderer
+      Blocks::Renderer.new(
+        registry: registry,
+        sanitizer: Blocks::Sanitizer.new(tags: config.sanitizer_tags,
+                                         attributes: config.sanitizer_attributes),
+        strategy: config.resolved_unknown_block_strategy,
+        logger: defined?(Rails) ? Rails.logger : nil
+      )
+    end
+
+    def text_extractor
+      Blocks::TextExtractor.new(registry: registry)
+    end
+
+    # ActiveStorage is optional. When it is absent the image block still
+    # renders a picture from a URL; there is simply nowhere to upload to.
+    def active_storage?
+      defined?(ActiveStorage::Blob).present?
+    end
+  end
+end

data/lib/tasks/pressroom_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :pressroom do
+#   # Task goes here
+# end

data/lib/tasks/pressroom_vendor.rake

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "open-uri"
+require "yaml"
+
+namespace :pressroom do
+  namespace :vendor do
+    desc "Download the pinned Editor.js builds into the gem"
+    task :editorjs do
+      root = File.expand_path("../..", __dir__)
+      manifest = YAML.load_file(File.join(root, "config/editorjs_manifest.yml"))
+      target = File.join(root, "app/assets/javascripts/pressroom/vendor")
+
+      FileUtils.mkdir_p(target)
+
+      manifest.each do |name, entry|
+        url = "https://cdn.jsdelivr.net/npm/#{name}@#{entry['version']}/#{entry['remote']}"
+        destination = File.join(target, entry["local"])
+
+        print "#{name}@#{entry['version']} -> #{entry['local']} ... "
+        URI.parse(url).open do |remote|
+          File.binwrite(destination, remote.read)
+        end
+        puts "#{File.size(destination)} bytes"
+      end
+
+      puts "Vendored #{manifest.size} packages into #{target}"
+    end
+  end
+end

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: pressroom
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alex Andreiev
+bindir: bin
+cert_chain: []
+date: 2026-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+- !ruby/object:Gem::Dependency
+  name: rails-html-sanitizer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rss
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: A mountable Rails engine that adds block-editor articles, categories,
+  tags and feeds to an existing application.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/javascripts/pressroom/application.js
+- app/assets/javascripts/pressroom/controllers/editor_controller.js
+- app/assets/javascripts/pressroom/vendor/code.js
+- app/assets/javascripts/pressroom/vendor/delimiter.js
+- app/assets/javascripts/pressroom/vendor/editorjs.js
+- app/assets/javascripts/pressroom/vendor/header.js
+- app/assets/javascripts/pressroom/vendor/image.js
+- app/assets/javascripts/pressroom/vendor/inline-code.js
+- app/assets/javascripts/pressroom/vendor/list.js
+- app/assets/javascripts/pressroom/vendor/marker.js
+- app/assets/javascripts/pressroom/vendor/quote.js
+- app/assets/javascripts/pressroom/vendor/stimulus.js
+- app/assets/javascripts/pressroom/vendor/turbo.js
+- app/assets/stylesheets/pressroom/admin.css
+- app/assets/stylesheets/pressroom/content.css
+- app/controllers/pressroom/application_controller.rb
+- app/controllers/pressroom/categories_controller.rb
+- app/controllers/pressroom/posts_controller.rb
+- app/controllers/pressroom/tags_controller.rb
+- app/controllers/pressroom/uploads_controller.rb
+- app/helpers/pressroom/application_helper.rb
+- app/helpers/pressroom/blocks_helper.rb
+- app/jobs/pressroom/application_job.rb
+- app/mailers/pressroom/application_mailer.rb
+- app/models/concerns/pressroom/authorable.rb
+- app/models/concerns/pressroom/sluggable.rb
+- app/models/pressroom/application_record.rb
+- app/models/pressroom/category.rb
+- app/models/pressroom/post.rb
+- app/models/pressroom/tag.rb
+- app/models/pressroom/tagging.rb
+- app/views/layouts/pressroom/admin.html.erb
+- app/views/layouts/pressroom/application.html.erb
+- app/views/pressroom/blocks/_code.html.erb
+- app/views/pressroom/blocks/_delimiter.html.erb
+- app/views/pressroom/blocks/_header.html.erb
+- app/views/pressroom/blocks/_image.html.erb
+- app/views/pressroom/blocks/_list.html.erb
+- app/views/pressroom/blocks/_list_items.html.erb
+- app/views/pressroom/blocks/_paragraph.html.erb
+- app/views/pressroom/blocks/_quote.html.erb
+- app/views/pressroom/categories/_form.html.erb
+- app/views/pressroom/categories/edit.html.erb
+- app/views/pressroom/categories/index.html.erb
+- app/views/pressroom/categories/new.html.erb
+- app/views/pressroom/posts/_form.html.erb
+- app/views/pressroom/posts/_post_row.html.erb
+- app/views/pressroom/posts/edit.html.erb
+- app/views/pressroom/posts/index.html.erb
+- app/views/pressroom/posts/new.html.erb
+- app/views/pressroom/tags/edit.html.erb
+- app/views/pressroom/tags/index.html.erb
+- config/editorjs_manifest.yml
+- config/importmap.rb
+- config/locales/pressroom.en.yml
+- config/locales/transliteration.ru.yml
+- config/locales/transliteration.uk.yml
+- config/routes.rb
+- db/migrate/20260821000001_create_pressroom_posts.rb
+- db/migrate/20260821000002_create_pressroom_taxonomy.rb
+- lib/pressroom.rb
+- lib/pressroom/blocks/definition.rb
+- lib/pressroom/blocks/registry.rb
+- lib/pressroom/blocks/renderer.rb
+- lib/pressroom/blocks/sanitizer.rb
+- lib/pressroom/blocks/schema.rb
+- lib/pressroom/blocks/text_extractor.rb
+- lib/pressroom/built_in_blocks.rb
+- lib/pressroom/configuration.rb
+- lib/pressroom/engine.rb
+- lib/pressroom/errors.rb
+- lib/pressroom/feed.rb
+- lib/pressroom/transliteration.rb
+- lib/pressroom/version.rb
+- lib/tasks/pressroom_tasks.rake
+- lib/tasks/pressroom_vendor.rake
+homepage: https://github.com/alex-andreiev/pressroom
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/alex-andreiev/pressroom
+  changelog_uri: https://github.com/alex-andreiev/pressroom/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/alex-andreiev/pressroom/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Block-based article publishing engine for Rails
+test_files: []