luaof 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c6a1ca3a8d8612d70ca89b1c1810474db873a9cbaeba467874e4c9c62bca2ced
+  data.tar.gz: 98ee0e1f889f4bc99a30cdfd2d8f4590d80a4ab2e7fd01b6e157a17b02819355
+SHA512:
+  metadata.gz: 796b1810e48641095effaedcb489c310fa96a2b2b2f57c01666c47bac0675873f04f5355e3aca601137a67e2bcc11529abfcc3ae76c27429a7036dd65ca8d51f
+  data.tar.gz: c0faed3de422a2adf1633d791cae880151f05caea064a48f8a0c412fa57ea7f26348b0fa967397647bb2183d837a0dda0193b671cf8fd8eac1ddfdc72f3385de

data/.rubocop.yml

@@ -0,0 +1,9 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  DisabledByDefault: true
+
+Lint/BooleanSymbol:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,7 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2024-06-01 09:14:58 UTC using RuboCop version 1.48.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# ChangeLog of luaof
+
+## [Unreleased]
+
+## [0.1.0] - 2024-06-08
+
+- Initial release

data/README.md

@@ -0,0 +1,30 @@
+# Luaof
+
+Luaof is an experimental Lua "our format" parser.
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add luaof
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install luaof
+
+## Usage
+
+Please see `exe/2latex` for the example.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies.
+Then, run `rake test` to run the tests.
+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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome.

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/exe/2latex

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/luaof'
+
+lexer = Luaof::Lexer.new
+parser = Luaof::Parser.new
+
+$stdin.each_line(chomp: true) do |line|
+  lexer.push(line) do |token|
+    parser.push(token)
+  end
+end
+
+parser.parse_section!
+parser.parse_api_indicator!
+
+parser.register_mapping!
+parser.register_refs!
+
+Luaof::LaTeXRenderer.new($stdout, parser.labels, :ja).render(parser.document)

data/lib/luaof/latex_renderer.rb

@@ -0,0 +1,438 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module Luaof
+  class LaTeXRenderer
+    SECTION_LEVEL_TO_CONTROL_SEQUENCE = [nil, 'chapter', 'section', 'subsection', 'subsubsection'].freeze
+
+    def initialize(output, labels, lang)
+      @output = output
+      @labels = labels
+      @lang = lang
+    end
+
+    def render(document)
+      case document
+      in Array
+        document.each { |child| render(child) }
+      in Node[label: { tag: :ANSI }, children:]
+        case @lang
+        in :ja
+          print('ISO~Cの関数\\texttt{')
+        end
+        render(children)
+        print('}')
+      in Node[label: { tag: :manual }, children:]
+        children.each { |child| render(child) }
+
+      # EBNF
+      in Node[label: { tag: :Produc }, children:]
+        print("\\begin{align*}\n")
+        render_ebnf(children)
+        print('\\end{align*}')
+      in Node[label: { tag: :bnfNter |
+                       :bnfrep |
+                       :bnfopt |
+                       :bnfter }]
+        print('\\(')
+        render_ebnf(document)
+        print('\\)')
+
+      in Node[label: { tag: :section, level:, title: } => label, children:]
+        control_sequence = SECTION_LEVEL_TO_CONTROL_SEQUENCE[level] or raise
+        print("\\#{control_sequence}{")
+        render(title)
+        print('}')
+        id = label&.dig(:id) and print("\\label{#{id}}")
+        print("\n\n")
+        render(children)
+      in Node[label: { tag: :simplesect }, children:]
+        render(children)
+      in Node[label: { tag: :verbatim }, children:]
+        print("\n\n\\vskip.5\\baselineskip\\noindent\\fcolorbox{gray!30}{gray!10}{\\parbox{.95\\textwidth}{\\texttt{")
+        render_verbatim_content(children)
+        print("}}}\\hfill\\vskip.5\\baselineskip\n\n")
+      in Node[label: { tag: :emphx | :emph | :def | :rep }, children:]
+        print('\\emph{')
+        render(children)
+        print('}')
+      in Node[label: { tag: :id | :T | :idx }, children:]
+        print('\\texttt{')
+        render(children)
+        print('}')
+      in Node[label: { tag: :Q }, children:]
+        print('「')
+        render(children)
+        print('」')
+
+      in Node[label: { tag: :x }, children: [String => index]]
+        render(index)
+        print('\\index{')
+        render(index)
+        print('}')
+      in Node[label: { tag: :x }, children: [String => index, :linebreak, String => index2] => content]
+        render(content)
+        print('\\index{')
+        render(index)
+        print(' ')
+        render(index2)
+        print('}')
+
+      in Node[label: { tag: :M | :num }, children:]
+        print('\\(')
+        render(children)
+        print('\\)')
+      in Node[label: { tag: :sp }, children:]
+        print('^{')
+        render(children)
+        print('}')
+      in Node[label: { tag: :description }, children:]
+        print("\\begin{description}\n")
+        render(children)
+        print("\\end{description}\n")
+      in Node[label: { tag: :itemize }, children:]
+        print("\\begin{itemize}\n")
+        render(children)
+        print("\\end{itemize}\n")
+      in Node[label: { tag: :item, param: }, children:]
+        print('\\item[')
+        render(param)
+        print(']')
+        render(children)
+      in Node[label: { tag: :item }, children:]
+        print('\\item{}')
+        render(children)
+      in Node[label: { tag: :defid }, children: [String => id]]
+        print('\\texttt{')
+        render(id)
+        print("}\\label{#{id}}")
+      in Node[label: { tag: :see, param: { label: { id: String => id } } => param }]
+        id or raise
+        print("（「#{linktext(param)}」\\pageref{#{id}}ページ）")
+      in Node[label: { tag: :seeF }, children: [String => id]]
+        case @lang
+        in :ja
+          print('（関数\\texttt{')
+          render(id)
+          print("}は\\pageref{#{id}}ページ）")
+        end
+      in Node[label: { tag: :seeC }, children: [String => id]]
+        case @lang
+        in :ja
+          print('（C関数\\texttt{')
+          render(id)
+          print("}は\\pageref{#{id}}ページ）")
+        end
+      in Node[label: { tag: :refsec }, children: [String => id]]
+        id = "sec:#{id}"
+        node = @labels[id] or raise "section reference #{id} not found"
+        case @lang
+        in :ja
+          print("\\ref{#{id}}節「#{linktext(node)}」（\\pageref{#{id}}ページ）")
+        end
+      in Node[label: { tag: :See, param: { label: { id: } } => param }]
+        id or raise
+        case @lang
+        in :ja
+          print("#{linktext(param)}（\\pageref{#{id}}ページ）")
+        end
+      in Node[label: { tag: :link, param: [String => id] }, children:]
+        @labels["sec:#{id}"] and id = "sec:#{id}"
+        render(children)
+        case @lang
+        in :ja
+          print("（\\pageref{#{id}}ページ）")
+        end
+      in Node[label: { tag: :Lid }, children: [String => id]]
+        print('\\texttt{')
+        render(id)
+        case @lang
+        in :ja
+          print("}（\\pageref{#{id}}ページ）")
+        end
+
+      in Node[label: { tag: :index }, children: [String => index]]
+        print('\\index{')
+        render(index)
+        print('}')
+      in Node[label: { tag: :index }, children: [String => index, :linebreak, String => index2]]
+        print('\\index{')
+        render(index)
+        print(' ')
+        render(index2)
+        print('}')
+
+      in Node[label: { tag: :Char }, children:]
+        print('`\\texttt{')
+        render(children)
+        print("}'")
+      in Node[label: { tag: :St }, children:]
+        print('``\\texttt{')
+        render(children)
+        print("}''")
+      in Node[label: { tag: :rw | :Rw }, children:]
+        print('\\textbf{')
+        render(children)
+        print('}')
+
+      in Node[label: { tag: :apii, pop: String => pop, push: String => push, error: String => error }]
+        print('\\dotfill\\(\\begin{smallmatrix}\\texttt{')
+        render(pop)
+        print('}\\\\\\texttt{')
+        render(push)
+        print('}\\\\\\texttt{')
+        render(error)
+        print("}\\end{smallmatrix}\\)\n\n")
+
+      in Node[label: { tag: :APIEntry, param:, indicator: { pop:, push:, error: } }, children:]
+        signature = signaturetext(param)
+        signature.match(/ (lua L? [\w\\{}]+) [)]? [ ]+ [(] /x) or
+          signature.match(/ (lua L? [\w\\{}]+) /x)
+        name = ::Regexp.last_match(1) or raise signature.inspect[..500]
+        id = name.gsub('\\_{}', '_')
+        print("\n\n\\vskip.5\\baselineskip\\noindent\\fcolorbox{gray!30}{gray!10}{\\parbox{.9\\textwidth}{\\texttt{")
+        render_verbatim_content(param)
+        print("}}}\\label{#{id}}\\index{\\texttt{#{name}}}\\dotfill\\(\\begin{smallmatrix}\\texttt{")
+        render(pop)
+        print('}\\\\\\texttt{')
+        render(push)
+        print('}\\\\\\texttt{')
+        render(error)
+        print("}\\end{smallmatrix}\\)\\vskip.5\\baselineskip\n\n")
+        render(children)
+      in Node[label: { tag: :APIEntry, param: }, children:]
+        signature = signaturetext(param)
+        signature.match(/ (lua L? [\w\\{}]+) [)]? [ ]+ [(] /x) or
+          signature.match(/ (lua L? [\w\\{}]+) /x)
+        name = ::Regexp.last_match(1) or raise signature.inspect[..500]
+        id = name.gsub('\\_{}', '_')
+        print("\n\n\\vskip.5\\baselineskip\\noindent\\fcolorbox{gray!30}{gray!10}{\\parbox{.9\\textwidth}{\\texttt{")
+        render_verbatim_content(param)
+        print("}}}\\label{#{id}}\\index{\\texttt{#{name}}}\\hfill\\vskip.5\\baselineskip\n\n")
+        render(children)
+      in Node[label: { tag: :LibEntry, param: }, children:]
+        signature = signaturetext(param)
+        name = signature.sub(/ [ ] [(] .* /x, '')
+        id = name.gsub('\\_{}', '_')
+        print("\n\n\\vskip.5\\baselineskip\\noindent\\hfill\\fcolorbox{gray!30}{gray!10}{\\parbox{.95\\textwidth}{\\texttt{")
+        render_verbatim_content(param)
+        print("}}}\\label{#{id}}\\index{\\texttt{#{name}}}\\hfill\\vskip.5\\baselineskip\n\n")
+        render(children)
+
+      in Node[label: { tag: :N }, children:]
+        render(children)
+      in Node[label: { tag: :At }, children: []]
+        print('@')
+      in Node[label: { tag: :En }, children: []]
+        print('--')
+      in Node[label: { tag: :CId }, children: ]
+        case @lang
+        in :ja
+          print('Cの関数')
+        end
+        render(children)
+      in { pipe: }
+        render(pipe)
+      in { label: :leftbrace, children: }
+        print('{')
+        render(children)
+        print('}')
+      in String
+        print(escape(document))
+      in :linebreak
+        print("\n")
+      in :emptyline
+        print("\n\n")
+      in keyword: :Cdots
+        print('\\dots{}')
+      in keyword: :En
+        print('--')
+      in keyword: :VerBar
+        print('\\textbar{}')
+      in keyword: :leq
+        print('\\(\\leq\\)')
+      in keyword: :At
+        print('@')
+      in keyword: :pi
+        print('\\pi{}')
+      in keyword: :log
+        print('\\log{}')
+      in keyword: :cpp
+        print('\\cpluspluslogo{}')
+      in keyword: :nil | :false | :true | :fail => name
+        print('\\textbf{')
+        render(name)
+        print('}')
+      in Symbol => name
+        print(name)
+      else
+        raise document.inspect[..500]
+      end
+    end
+
+    def render_ebnf(target)
+      case target
+      in Array
+        target.each do |child|
+          render_ebnf(child)
+        end
+      in Node[label: { tag: :producname }, children:]
+        render_ebnf(children)
+      in keyword: :Or
+        print(' \\quad\\text{\\textbar{}} ')
+      in keyword: :OrNL
+        print("\\\\\n\\text{\\textbar{}} &")
+      in Node[label: { tag: :producbody }, children:]
+        print(' \\rightarrow{} &')
+        render_ebnf(children)
+        print("\\\\\n")
+
+      in keyword: :Open
+        print('\\text{\\{}')
+      in keyword: :Close
+        print('\\text{\\}}')
+      in :emptyline
+      # nop
+      in { pipe: }
+        print(pipe.gsub('|', '\\text{\\textbar{}}'))
+      in String
+        print("\\text{#{escape(target)}}")
+      in Node[label: { tag: :bnfNter }, children:]
+        render_ebnf(children)
+      in Node[label: { tag: :bnfter }, children:]
+        print('\\text{\\textquoteleft{}\\texttt{')
+        render_ebnf(children)
+        print('}\\textquoteright{}}')
+      in Node[label: { tag: :bnfrep }, children:]
+        print('\\left\\{')
+        render_ebnf(children)
+        print('\\right\\}')
+      in Node[label: { tag: :bnfopt }, children:]
+        print('\\left[')
+        render_ebnf(children)
+        print('\\right]')
+
+      in Node[label: { tag: :rep }, children:]
+        print(' \\text{\\emph{')
+        render_ebnf(children)
+        print('}} ')
+      in Node[label: { tag: :rw | :Rw }, children:]
+        print(' \\text{\\textbf{')
+        render_ebnf(children)
+        print('}} ')
+
+      in Node[label: :leftbrace, children:]
+        print('\\text{\\{}')
+        render_ebnf(children)
+        print('\\text{\\}}')
+      in :linebreak
+      # nop
+      else
+        raise target.inspect[..500]
+      end
+    end
+
+    def escape(target)
+      escaped = +''
+      target.each_char do |char|
+        escaped << case char
+                   when '_'
+                     '\\_{}'
+                   when '^'
+                     '\\textasciicircum{}'
+                   when '&'
+                     '\\&'
+                   when '#'
+                     '\\#'
+                   when '%'
+                     '\\%'
+                   when '$'
+                     '\\${}'
+                   when '\\'
+                     '\\textbackslash{}'
+                   when '~'
+                     '\\textasciitilde{}'
+                   else
+                     char
+                   end
+      end
+      escaped
+    end
+
+    def render_verbatim_content(target)
+      case target
+      in Array
+        target.each { |child| render_verbatim_content(child) }
+      in String
+        escaped = +''
+        target.each_char { |char| escaped << (char == ' ' ? '\\ ' : escape(char)) }
+        print(escaped)
+      in keyword: :Cdots
+        print('\\dots{}')
+      in Node[label: :leftbrace, children:]
+        print('\\{')
+        render_verbatim_content(children)
+        print('\\}')
+      in Node[label: { tag: :rep }, children:]
+        print('\\emph{')
+        render_verbatim_content(children)
+        print('}')
+      in :linebreak
+        print("\\\\\n")
+      in :emptyline
+        print("\\\\\n\\\\\n")
+      in keyword: :ldots
+        print('\\dots{}')
+      else
+        raise target.inspect[..500]
+      end
+    end
+
+    def signaturetext(node)
+      case node
+      in Array
+        node.map { |n| signaturetext(n) }.join
+      in String
+        escape(node)
+      in :linebreak
+        "\n"
+      in { keyword: :ldots }
+        '\\ldots{}'
+      in { keyword: :Cdots }
+        '\\dots{}'
+      in Node[label: :leftbrace, children:]
+        content = children.map { |c| signaturetext(c) }.join
+        "{#{content}}"
+      in Node[label: { tag: :rep }, children:]
+        "\\emph{#{signaturetext(children)}}"
+      else
+        raise node.inspect[..500]
+      end
+    end
+
+    def linktext(node)
+      case node
+      in label: { tag: :section, title: [String => title] }
+        title
+      in label: { tag: :APIEntry, param: }
+        name = signaturetext(param)
+        name.match(/ (lua L? [\w\\{}]+) [)]? [ ]+ [(] /x) or
+          name.match(/ (lua L? [\w\\{}]+) /x)
+        name = ::Regexp.last_match(1) or raise [name, node].inspect[..500]
+        "\\texttt{#{name}}"
+      else
+        raise node.inspect[..500]
+      end
+    end
+
+    def print(target)
+      target.is_a?(Symbol) and target = target.to_s
+      case target
+      in String
+        target.scrub!
+        @output.print(target)
+      end
+    end
+  end
+end

data/lib/luaof/lexer.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "strscan"
+require "forwardable"
+
+module Luaof
+  class Lexer
+    def initialize
+      @scanner = StringScanner.new(+'')
+    end
+
+    def push(line)
+      if line.empty?
+        yield :emptyline
+        return
+      end
+      concat(line)
+      until eos?
+        if skip(/ @ (\w+) ({)? /x)
+          if @scanner[2]
+            yield({ tag: @scanner[1].intern })
+          else
+            yield({ keyword: @scanner[1].intern })
+          end
+        elsif skip('{')
+          yield :leftbrace
+        elsif skip('}')
+          yield :closer
+        elsif (text = scan(/ [|] \s* /x))
+          yield({ pipe: text })
+        elsif (text = scan(/ [^@{}|]+ /x))
+          yield text
+        else
+          raise ">>>#{rest}"
+        end
+      end
+      yield :linebreak
+    end
+
+    extend Forwardable
+    def_delegators :@scanner, :eos?, :concat, :string, :skip, :rest, :scan, :pos
+  end
+end

data/lib/luaof/node.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Luaof
+  class Node
+    attr :label
+    attr_accessor :children
+
+    def initialize(label, mapping)
+      @label = label
+      @children = []
+      @mapping = mapping
+    end
+
+    def parse_api_indicator!
+      case self
+      in label: { tag: :APIEntry }, children: [{ label: { tag: :apii }, children: indicator }, *_]
+        pop, push, error, nope = expand_indicator(indicator).split(',')
+        nope and raise indicator
+        @label.update(indicator: { pop:, push:, error: })
+        @children.shift
+      in label: { tag: :apii }, children: indicator
+        pop, push, error, nope = expand_indicator(indicator).split(',')
+        nope and raise indicator
+        @label.update(pop:, push:, error:)
+        @children = []
+      else
+        @children.select { _1.is_a?(Node) }.each(&:parse_api_indicator!)
+      end
+    end
+
+    def expand_indicator(directives)
+      result = +''
+      directives.each do |directive|
+        directive => String
+        result.concat(directive)
+      end
+      result
+    end
+
+    def parse_section!
+      case self
+      in label: { tag: :section } => label,
+         children: [Node[label: { tag: :title }, children: title], *_] => children
+        children.shift
+        @label = { **label, title: }
+      else
+        # nop
+      end
+      @children.select { _1.is_a?(Node) }.each(&:parse_section!)
+    end
+
+    def register_mapping!
+      case self
+      in label: { tag: :section, param: [String => id] }
+        id = "sec:#{id}"
+        @mapping[id] and raise "already registered: #{id}"
+        @label[:id] = id
+        @mapping[id] = self
+      in label: { tag: :APIEntry, param: }
+        text = signaturetext(param)
+        text.match(/ (lua L? _ \w+) [)]? [ ]+ [(] /x) or
+          text.match(/ (lua L? _ \w+) /x)
+        id = ::Regexp.last_match(1) or raise "empty: #{text}"
+        id = id.to_s
+        @mapping[id] and raise "already registered: #{id}"
+        @label[:id] = id
+        @mapping[id] = self
+      in label: { tag: :defid }, children: String => id
+        @mapping[id] and raise "already registered: #{id}"
+        @label[:id] = id
+        @mapping[id] = self
+      else
+        # nop
+      end
+      @children.select { _1.is_a?(Node) }.each(&:register_mapping!)
+    end
+
+    def register_refs!
+      case self
+      in label: { tag: :see }, children: [String => id]
+        label = @mapping[id] || @mapping["sec:#{id}"] or
+          raise "not found: #{id}"
+        @label[:param] = label
+      in label: { tag: :See }, children: [String => id]
+        label = @mapping[id] || @mapping["sec:#{id}"] or
+          raise "not found: #{id}"
+        @label[:param] = label
+      else
+        # nop
+      end
+      @children.select { _1.is_a?(Node) }.each(&:register_refs!)
+    end
+
+    def signaturetext(target)
+      case target
+      in Array
+        target.map { |t| signaturetext(t) }.join
+      in String
+        target
+      in :linebreak
+        "\n"
+      in keyword: :ldots
+        '\\ldots{}'
+      in Node[label: { tag: :rep }, children:]
+        content = children.map { |c| signaturetext(c) }.join
+        "\\emph{#{content}}"
+      in Node[label: :leftbrace, children:]
+        content = children.map { |c| signaturetext(c) }.join
+        "{#{content}}"
+      else
+        raise target.inspect[..500]
+      end
+    end
+
+    def deconstruct_keys(_keys)
+      { label: @label, children: @children }
+    end
+
+    def pretty_print(q)
+      q.object_group(self) do
+        q.breakable
+        q.text 'label='
+        q.pp(@label)
+        q.text ','
+        q.breakable
+        q.text 'children='
+        q.pp(@children)
+      end
+    end
+  end
+end

data/lib/luaof/parser.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "node"
+
+module Luaof
+  class Parser
+    attr :document, :labels
+
+    def initialize
+      @document = []
+      @stack = []
+      @labels = {}
+    end
+
+    def push(token)
+      case token
+      in { tag: :sect1 | :sect2 | :sect3 | :sect4 => tag }
+        @stack.unshift(Node.new({ **token, tag: :section,
+                                  level: Integer(tag.to_s.match(/ sect (\d) /x)[1]) }, @labels))
+      in { tag: _ } | :leftbrace
+        @stack.unshift(Node.new(token, @labels))
+      in { pipe: }
+        case @stack
+        in { label: { tag: (:item | :link | :APIEntry | :LibEntry | :section) } => label,
+             children: } => function, *_
+          label[:param] and raise
+          label[:param] = children
+          function.children = []
+        else
+          @stack.first.children << pipe
+        end
+      in String | { keyword: _ }
+        case @stack
+        in Node => node, *_
+          node.children << token
+        end
+      in :closer
+        case @stack
+        in Node[label: { tag: :C | :Ci }], *_
+          @stack.shift
+        in Node[label: :leftbrace] => child, Node => parent, *_
+          parent.children << @stack.shift
+        in [Node => child, Node => parent, *_]
+          child.children.pop while child.children.last in :emptyline | :linebreak
+          parent.children << @stack.shift
+        in [Node[label: { tag: :manual }], *_]
+          @document << @stack.shift
+        end
+      in :emptyline
+        case @stack
+        in Node[children: [*_, :linebreak | :emptyline]] => node, *_
+          node.children[-1] = token
+        in Node[children: [] | [*_, Node[label: { tag: :title }]]], *_
+        # nop
+        in Node => node, *_
+          node.children << token
+        end
+      in :linebreak
+        case @stack
+        in [Node[label: :leftbrace] => node, *_]
+          node.children << token
+        in [] | [Node[children: [] | [*_, Node[label: { tag: :title }] | :emptyline]], *_]
+        # nop
+        in Node => node, *_
+          node.children << token
+        end
+      end
+    end
+
+    def parse_section!
+      @document.each(&:parse_section!)
+    end
+
+    def register_mapping!
+      @document.each(&:register_mapping!)
+    end
+
+    def register_refs!
+      @document.each(&:register_refs!)
+    end
+
+    def parse_api_indicator!
+      @document.each(&:parse_api_indicator!)
+    end
+  end
+end

data/lib/luaof/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Luaof
+  VERSION = "0.1.0"
+end

data/lib/luaof.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "luaof/version"
+require_relative "luaof/lexer"
+require_relative "luaof/parser"
+require_relative "luaof/latex_renderer"
+
+module Luaof
+  Error = Class.new(StandardError)
+end

data/manifest.scm

@@ -0,0 +1 @@
+(specifications->manifest (list "ruby@3.1" "ruby-rubocop"))

data/sig/luaof.gen.rbs

@@ -0,0 +1,64 @@
+# TypeProf 0.21.3
+
+# Classes
+module Luaof
+  VERSION: String
+  Error: Class
+
+  class Lexer
+    extend Forwardable
+    @scanner: StringScanner
+
+    def initialize: -> void
+    def push: (untyped line) -> nil
+  end
+
+  class Node
+    @label: untyped
+    @labels: Hash[untyped, untyped]
+
+    attr_accessor children: Array[untyped]
+    def initialize: (untyped label, Hash[untyped, untyped] labels) -> void
+    def parse_param!: -> Array[untyped]
+    def parse_api_indicator!: -> Array[untyped]
+    def expand_indicator: (Array[untyped] directives) -> String
+    def parse_section!: -> Array[untyped]
+    def register_labels!: -> Array[untyped]
+    def register_refs!: -> Array[untyped]
+    def signaturetext: (untyped target) -> String
+    def expand_pipe!: -> Array[untyped]
+    def surely_expand_pipe!: (Array[untyped] target, ?parent: ^(untyped) -> untyped?) -> Array[untyped]?
+    def deconstruct_keys: (Array[:children | :label] _keys) -> {label: untyped, children: Array[untyped]}
+    def pretty_print: (untyped q) -> untyped
+  end
+
+  class Parser
+    @document: Array[Node?]
+    @stack: Array[Node]
+    @labels: Hash[untyped, untyped]
+
+    def initialize: -> void
+    def push: (untyped token) -> ((Array[Node?] | Node)?)
+    def parse_param!: -> Array[Node?]
+    def parse_section!: -> Array[Node?]
+    def register_labels!: -> Array[Node?]
+    def register_refs!: -> Array[Node?]
+    def parse_api_indicator!: -> Array[Node?]
+    def expand_pipe!: -> Array[Node?]
+  end
+
+  class Renderer
+    SECTION_LEVEL_TO_CONTROL_SEQUENCE: [nil, String, String, String, String]
+    @output: untyped
+    @labels: untyped
+
+    def initialize: (untyped output, untyped labels) -> void
+    def render: (untyped document) -> untyped
+    def render_ebnf: (untyped target) -> nil
+    def escape: (untyped target) -> String
+    def render_verbatim_content: (untyped target) -> untyped
+    def signaturetext: (untyped node) -> String
+    def linktext: (untyped node) -> String
+    def print: (String target) -> untyped
+  end
+end

data/sig/luaof.rbs

@@ -0,0 +1,4 @@
+module Luaof
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: luaof
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- gemmaro
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-06-08 00:00:00.000000000 Z
+dependencies: []
+description: luaof is a Lua "our format" parser library.  The "our format" is used
+  for the Lua reference manual.  This gem has highly experimental LaTeX renderer for
+  Japanese, which can be referred as an example renderer.
+email:
+- gemmaro.dev@gmail.com
+executables:
+- 2latex
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- README.md
+- Rakefile
+- exe/2latex
+- lib/luaof.rb
+- lib/luaof/latex_renderer.rb
+- lib/luaof/lexer.rb
+- lib/luaof/node.rb
+- lib/luaof/parser.rb
+- lib/luaof/version.rb
+- manifest.scm
+- sig/luaof.gen.rbs
+- sig/luaof.rbs
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Lua our format parser
+test_files: []