mahjong-render 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b8def8b9aad27b78db9af644359d270c88f095c2d48e6e459fd3023c4ca39ee
-  data.tar.gz: 8de5e8246e9cc2c8236c231d6a2cfa79e5ddd03bd90352d221f88454f8477f21
+  metadata.gz: 2db0d057ecd91d7f1dcd61f8a0cddb94ebf2f2d185150654fb44ef706d843dca
+  data.tar.gz: 767cd4073a98a9713f6919dc8db625ac1002c064ebb2407a1e0bea4abf138610
 SHA512:
-  metadata.gz: 9340c3a83a8d69025b9be5dff44d808e6cda0832c67ebdca6023ad43c573658e605c926d588dbb93e52db988880b5ab1eb6da457f54b5c4f355960c892003840
-  data.tar.gz: 33b9aa0251fbdd0d8eeec5b1d16e2a2fd4c25458aad3785f7c20494409ae9a2281ff845ceb7bcb4d376bd29e6e20299ee615c168715ff72c9a71eec91bf60268
+  metadata.gz: 3ec43b9857f9dc92eef96244d7d8305a6d9bace79e1a27ee69309d07603669be49a4a61f4355c920090860e13aa10bd887a1642017b223cbd02cc124185d5e5e
+  data.tar.gz: 96ac7c126a790c7d7a52d69fa85b9a22f55f0ab61720486204722847e4aadabbd2f554c7fccf105a9615b8095f49819567cb8312a60faeea798ee11a0ebcf0c0

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes will be recorded here. Versions follow Semantic Versioning.
 
+## 0.2.2 — 2026-09-25
+
+- Support standard AsciiDoc block titles on the `mahjong` block macro while continuing to reject unsupported macro attributes.
+
 ## 0.2.1 — 2026-09-25
 
 - Use the GitHub account name `kjun1` in copyright notices and RubyGems author metadata.

data/README.ja.md

@@ -27,7 +27,7 @@ gem install mahjong-render
 
 ```sh
 gem build mahjong-render.gemspec
-gem install --local ./mahjong-render-0.2.1.gem
+gem install --local ./mahjong-render-0.2.2.gem
 ```
 
 インストール後、次のコマンドで `hand.svg` を作成できます。
@@ -57,7 +57,7 @@ printf '= Mahjong hand\n\nmahjong::405m456p789s12344z[]\n' > hand.adoc
 asciidoctor -r mahjong_render/asciidoctor hand.adoc
 ```
 
-間隔の違う牌列を含む [AsciiDoc の例](examples/basic.adoc) もあります。拡張は HTML5 の block macro に対応します。macro 属性、inline macro、PDF 出力には対応しません。
+間隔の違う牌列を含む [AsciiDoc の例](examples/basic.adoc) もあります。拡張は HTML5 の block macro に対応し、macro の直前に置く `.現在の手牌` のような標準 AsciiDoc block title も描画します。macro の `[]` 内に書く属性、inline macro、PDF 出力には対応しません。
 
 牌のまとまりを少し離して見せるには、完成したグループの間に `|` を入れます。たとえば `mahjong::123m|456p|789s[]` と書きます。`|` は牌幅の4分の1の空白を追加し、`|(0.25)` と同じ幅です。幅を変える場合は `mahjong::123m|(0.5)456p[]` のように書けます。
 
@@ -92,7 +92,7 @@ devcontainer、または保証対象の MRI Ruby・Bundler・`rsvg-convert` を
 bundle install
 bundle exec rake lint test assets:check licenses:check example:build
 gem build mahjong-render.gemspec
-ruby script/check_package.rb mahjong-render-0.2.1.gem
+ruby script/check_package.rb mahjong-render-0.2.2.gem
 ```
 
 設計の経緯は [既存ライブラリの調査](docs/research/existing-renderers.md) と [ADR](docs/adr/) に記録しています。

data/README.md

@@ -29,7 +29,7 @@ To install a build from a local checkout:
 
 ```sh
 gem build mahjong-render.gemspec
-gem install --local ./mahjong-render-0.2.1.gem
+gem install --local ./mahjong-render-0.2.2.gem
 ```
 
 Render a hand from the command line or from Ruby:
@@ -61,7 +61,7 @@ See [the complete AsciiDoc example](examples/basic.adoc) for hands with and with
 
 To show separate groups, insert `|` between complete tile groups: `mahjong::123m|456p|789s[]`. Each `|` adds a quarter tile width of empty space, the same as `|(0.25)`. Use `|(0.5)` for half a tile width or `|(1)` for a full tile width, for example `mahjong::123m|(0.5)456p[]`.
 
-The adapter supports the HTML5 backend. Macro attributes, inline macros, and PDF output are unsupported. The Ruby rendering API does not load Asciidoctor.
+The adapter supports the HTML5 backend and standard AsciiDoc block titles such as `.Current hand` immediately before the macro. Attributes written inside the macro's `[]`, inline macros, and PDF output are unsupported. The Ruby rendering API does not load Asciidoctor.
 
 ## Supported notation
 
@@ -106,7 +106,7 @@ Open this repository in a devcontainer, or use a supported MRI Ruby with Bundler
 bundle install
 bundle exec rake lint test assets:check licenses:check example:build
 gem build mahjong-render.gemspec
-ruby script/check_package.rb mahjong-render-0.2.1.gem
+ruby script/check_package.rb mahjong-render-0.2.2.gem
 ```
 
 The example HTML is written to `tmp/basic.html`. The test suite rasterizes a sample SVG to confirm the embedded vector artwork renders.

data/docs/api.md

@@ -16,7 +16,8 @@ Invalid notation raises `MahjongRender::NotationError`. Its `token` reader ident
 Install Ruby Asciidoctor 2.x separately and load `mahjong_render/asciidoctor` to register the `mahjong` block macro:
 
 ```asciidoc
+.Current hand
 mahjong::405m456p789s12344z[]
 ```
 
-The adapter supports the HTML5 backend. It raises `MahjongRender::UnsupportedBackendError` for other backends and `MahjongRender::UnsupportedAttributeError` for macro attributes. Invalid notation raises `MahjongRender::NotationError`. Inline macros and PDF output are unsupported. Loading `mahjong_render` alone does not load Asciidoctor.
+Standard AsciiDoc block titles (`.Title` on the line before the macro) are supported and rendered above the tiles. The adapter supports the HTML5 backend. It raises `MahjongRender::UnsupportedBackendError` for other backends and `MahjongRender::UnsupportedAttributeError` for attributes written inside the macro's `[]`. Invalid notation raises `MahjongRender::NotationError`. Inline macros and PDF output are unsupported. Loading `mahjong_render` alone does not load Asciidoctor.

data/lib/mahjong_render/asciidoctor.rb

@@ -18,10 +18,16 @@ module MahjongRender
 
       def process(parent, target, attrs)
         raise UnsupportedBackendError, "mahjong block macro supports HTML output only" unless parent.document.basebackend?("html")
-        raise UnsupportedAttributeError, "mahjong block macro does not support attributes: #{attrs.keys.join(', ')}" unless attrs.empty?
+
+        unsupported_attrs = attrs.keys - ["title"]
+        unless unsupported_attrs.empty?
+          message = "mahjong block macro does not support attributes: #{unsupported_attrs.join(', ')}"
+          raise UnsupportedAttributeError, message
+        end
 
         svg = MahjongRender.render(target)
-        create_pass_block(parent, %(<div class="mahjong-render">#{svg}</div>), {}, subs: nil)
+        title_html = attrs.key?("title") ? %(<div class="title">#{attrs['title']}</div>\n) : ""
+        create_pass_block(parent, %(<div class="mahjong-render">#{title_html}#{svg}</div>), attrs, subs: nil)
       end
     end
   end

data/lib/mahjong_render/version.rb

@@ -4,5 +4,5 @@
 # SPDX-License-Identifier: Apache-2.0
 
 module MahjongRender
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mahjong-render
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - kjun1
 bindir: bin
 cert_chain: []
-date: 2026-09-24 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -98,10 +98,10 @@ licenses:
 - Apache-2.0
 - CC0-1.0
 metadata:
-  source_code_uri: https://github.com/kjun1/mahjong-render/tree/v0.2.1
-  changelog_uri: https://github.com/kjun1/mahjong-render/blob/v0.2.1/CHANGELOG.md
+  source_code_uri: https://github.com/kjun1/mahjong-render/tree/v0.2.2
+  changelog_uri: https://github.com/kjun1/mahjong-render/blob/v0.2.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kjun1/mahjong-render/issues
-  documentation_uri: https://github.com/kjun1/mahjong-render/blob/v0.2.1/docs/api.md
+  documentation_uri: https://github.com/kjun1/mahjong-render/blob/v0.2.2/docs/api.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: