mdx-tex 0.1.13 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8343fef64d295ffcb1ceeebe1486fe2311bbfd8a1c8b0f8bdcf3f95ac1114ce5
-  data.tar.gz: 8606c4ccb96a3494499e221d3c7c6d7c816234bb75f90c11dd4f7889a487043e
+  metadata.gz: c30f6b611b9feb5094eb58bff7920f23bdac921d2eb8d4bf82a5700516672d43
+  data.tar.gz: c571088c6cae7523ce3ece74dc648f10b08ba74c9b53fafa262c78c37e981a01
 SHA512:
-  metadata.gz: 071b049091b240866d57edd34dd35ee53052d012a32ab9c573ad3156eb557c5e4ae57d65fa7f55d7f1a7338fb34bb75ca063db57a819a6094a3ae678f3e327fa
-  data.tar.gz: 1edcbbdd10d9b07461281e43c8b6455e3f48083ca660b85acd0ee0f9ed26c5181645852c5f608d3e475b9266452bbb78e5e34a2bce2747e3959664a38a0be748
+  metadata.gz: 45806c1388c49103d659f12ad50f144081477f479db973a9ad2900dbfb7eacb1e569632fbdf8adf7958dd1de331ba40ed2bc71ffdc2abca5f5f759eebace4584
+  data.tar.gz: 737d4a0f4c3a07ded53396994ed78d38ee7acdfb40ea4900fb182c6628e5bff957892e8d259d040b9eb28b74e231d2204a42326490e28ddf9c1ee8fec57b816a

data/lib/mdx_tex/core_ext/string.rb

@@ -6,6 +6,10 @@ module MdxTex
       def to_textile(**options)
         MdxTex.to_textile(markdown: self, **options)
       end
+
+      def to_markdown
+        MdxTex.to_markdown(textile: self)
+      end
     end
   end
 end

data/lib/mdx_tex/to_markdown/bold.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module MdxTex
+  class ToMarkdown
+    # Converts Textile bold syntax to Markdown bold syntax.
+    # Textile bold is *text* with non-whitespace immediately inside both asterisks;
+    # whitespace-padded asterisks are not bold (and are typically list markers).
+    #
+    # | Input (Textile)   | Output (Markdown) |
+    # |-------------------|-------------------|
+    # | *hello*           | **hello**         |
+    # | *a* and *b*       | **a** and **b**   |
+    # | *  hello  *       | *  hello  *       |
+    module Bold
+      # Matches a Textile bold span: *...*
+      #   \*                opening literal *
+      #   (                 capture the content
+      #     [^\s*]          first char must be non-whitespace and non-*
+      #                     (Textile rule: no padding inside the asterisks;
+      #                     also keeps us from matching list markers like `* item`)
+      #     (?:             optional trailing run, present only for 2+ char content
+      #       [^*]*?        any chars except *, non-greedy so we stop at the
+      #                     nearest closing * rather than spanning into another span
+      #       [^\s*]        last char must also be non-whitespace and non-*
+      #     )?              optional, so single-char bold like *a* still matches
+      #   )
+      #   \*                closing literal *
+      PATTERN = /\*([^\s*](?:[^*]*?[^\s*])?)\*/.freeze
+
+      def self.execute(line)
+        line.gsub(PATTERN, '**\1**')
+      end
+    end
+  end
+end

data/lib/mdx_tex/to_markdown/header.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module MdxTex
+  class ToMarkdown
+    # Converts a Textile heading to a Markdown heading.
+    # The Textile tag's level determines the number of leading #s.
+    # A space must follow the period for the line to be recognised as a heading.
+    # Lines that do not match are returned unchanged.
+    #
+    # | Input (Textile)    | Output (Markdown)  |
+    # |--------------------|--------------------|
+    # | h1. Title          | # Title            |
+    # | h3. Note           | ### Note           |
+    # | h6. Tiny           | ###### Tiny        |
+    # | h3.NoSpace         | h3.NoSpace         |
+    # | h7. TooDeep        | h7. TooDeep        |
+    module Header
+      # Matches a Textile heading line: hN. content
+      #   \A          anchor to start of line (no leading whitespace allowed)
+      #   h           literal 'h'
+      #   ([1-6])     capture the heading level digit, restricted to 1-6
+      #               (Textile/HTML only have h1..h6)
+      #   \.          literal period
+      #   \s+         one or more whitespace chars
+      #               (required: `h3.NoSpace` is not a heading)
+      #   (.+)        capture the heading content (at least one char)
+      #   \z          anchor to end of line
+      PATTERN = /\Ah([1-6])\.\s+(.+)\z/.freeze
+
+      def self.execute(line)
+        line.sub(PATTERN) { "#{'#' * ::Regexp.last_match(1).to_i} #{::Regexp.last_match(2)}" }
+      end
+    end
+  end
+end

data/lib/mdx_tex/to_markdown/ordered_list.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module MdxTex
+  class ToMarkdown
+    # Converts a Textile ordered list item to a Markdown ordered list item.
+    # Depth is derived from the leading-hash count minus +base_list_depth+
+    # (the smallest hash count seen anywhere in the document, detected by the
+    # coordinator). Markdown indents 2 spaces per depth level. The +number+
+    # is supplied by the coordinator, which maintains per-depth counters.
+    #
+    # | Input (Textile) | base_list_depth | number | Output (Markdown) |
+    # |-----------------|-----------------|--------|-------------------|
+    # | # item          | 1               | 1      | 1. item           |
+    # | # item          | 1               | 5      | 5. item           |
+    # | ## nested       | 1               | 1      |   1. nested       |
+    # | ## item         | 2               | 1      | 1. item           |
+    module OrderedList
+      INDENT_SIZE = 2
+
+      # Matches a Textile ordered list line: optional leading whitespace, a run
+      # of hashes, a mandatory space, and at least one content character.
+      #   \A          start of line
+      #   \s*         tolerate leading whitespace (not preserved in the output)
+      #   (#+)        capture the run of hashes (depth indicator)
+      #   \s+         one or more whitespace chars
+      #               (required: distinguishes a list marker from things like
+      #               `#foo` which is not a Textile ordered list item)
+      #   (.+)        capture the item content
+      #   \z          end of line
+      PATTERN = /\A\s*(#+)\s+(.+)\z/.freeze
+
+      def self.execute(line, base_list_depth:, number:)
+        line.sub(PATTERN) do
+          depth = ::Regexp.last_match(1).length - base_list_depth + 1
+          indent = ' ' * ((depth - 1) * INDENT_SIZE)
+          "#{indent}#{number}. #{::Regexp.last_match(2)}"
+        end
+      end
+    end
+  end
+end

data/lib/mdx_tex/to_markdown/unordered_list.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module MdxTex
+  class ToMarkdown
+    # Converts a Textile unordered list item to a Markdown unordered list item.
+    # Depth is derived from the leading-asterisk count minus +base_list_depth+
+    # (the smallest asterisk count seen anywhere in the document, detected by
+    # the coordinator). Markdown indents 2 spaces per depth level.
+    #
+    # | Input (Textile) | base_list_depth | Output (Markdown) |
+    # |-----------------|-----------------|-------------------|
+    # | *** item        | 3               | - item            |
+    # | **** nested     | 3               |   - nested        |
+    # | ***** deep      | 3               |     - deep        |
+    # | * item          | 1               | - item            |
+    # | ** nested       | 1               |   - nested        |
+    module UnorderedList
+      INDENT_SIZE = 2
+
+      # Matches a Textile unordered list line: optional leading whitespace, a run
+      # of asterisks, a mandatory space, and at least one content character.
+      #   \A          start of line
+      #   \s*         tolerate leading whitespace (not preserved in the output)
+      #   (\*+)       capture the run of asterisks (depth indicator)
+      #   \s+         one or more whitespace chars
+      #               (required: this is what distinguishes a list marker from
+      #               inline bold like `*foo*` or a bare `*`)
+      #   (.+)        capture the item content
+      #   \z          end of line
+      PATTERN = /\A\s*(\*+)\s+(.+)\z/.freeze
+
+      def self.execute(line, base_list_depth:)
+        line.sub(PATTERN) do
+          depth = ::Regexp.last_match(1).length - base_list_depth + 1
+          indent = ' ' * ((depth - 1) * INDENT_SIZE)
+          "#{indent}- #{::Regexp.last_match(2)}"
+        end
+      end
+    end
+  end
+end

data/lib/mdx_tex/to_markdown.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'mdx_tex/to_markdown/bold'
+require 'mdx_tex/to_markdown/header'
+require 'mdx_tex/to_markdown/unordered_list'
+require 'mdx_tex/to_markdown/ordered_list'
+
+module MdxTex
+  # Converts Textile to Markdown.
+  #
+  # The base list depth is auto-detected per document (smallest asterisks/hashes
+  # count across all list lines) so that input with inconsistent base
+  # indentation still produces a clean depth-1 Markdown list. Ordered list
+  # items are numbered with incrementing per-depth counters that reset on
+  # blank lines or any non-ordered-list line.
+  class ToMarkdown
+    def execute(input)
+      return nil if input.nil?
+
+      lines = input.to_s.split("\n", -1)
+      @unordered_base, @ordered_base = detect_bases(lines)
+      @counters = {}
+
+      lines.map { |line| convert_line(line) }.join("\n")
+    end
+
+    private
+
+    # Single pass over the document:
+    # - every line is matched against the list patterns once,
+    #   and the smallest marker run seen for each kind becomes the depth-1 base.
+    # - Falls back to 1 when no list of that kind is present
+    #   (the value is irrelevant in that case — no line will match for conversion).
+    def detect_bases(lines)
+      unordered_counts = []
+      ordered_counts = []
+      lines.each do |line|
+        if (m = line.match(UnorderedList::PATTERN))
+          unordered_counts << m[1].length
+        elsif (m = line.match(OrderedList::PATTERN))
+          ordered_counts << m[1].length
+        end
+      end
+      [unordered_counts.min || 1, ordered_counts.min || 1]
+    end
+
+    def convert_line(line)
+      # List conversion must run before Bold (and before Header for symmetry):
+      # - Textile uses `*` for both unordered list markers and inline bold.
+      #   A line like `*** *foo*` is a depth-3 list item containing the bold word "foo".
+      # - If Bold ran first, the leading `*` characters would be eaten by its
+      #   regex and the list structure would be lost.
+      #   Converting lists first rewrites the leading markers to Markdown `-`/`1.`,
+      #   leaving only the inline `*foo*` for Bold to handle on the next pass.
+      line = convert_ordered_and_unordered_list(line)
+      line = Header.execute(line)
+      Bold.execute(line)
+    end
+
+    def convert_ordered_and_unordered_list(line)
+      match = line.match(OrderedList::PATTERN)
+      if match
+        # Ordered-list line: bump the counter at this depth
+        # (which also drops any deeper counters so they restart fresh next time we descend).
+        depth = match[1].length - @ordered_base + 1
+        number = bump_counter(depth)
+        OrderedList.execute(line, base_list_depth: @ordered_base, number: number)
+      else
+        # Anything else (blank line, unordered item, header, paragraph)
+        # ends the current run of ordered items, so all ordered counters reset.
+        # The next `# foo` encountered will start over at 1.
+        @counters.clear
+        UnorderedList.execute(line, base_list_depth: @unordered_base)
+      end
+    end
+
+    # Increment the counter at +depth+ and drop any deeper-depth counters.
+    # So the next time we descend to those depths they start fresh at 1.
+    def bump_counter(depth)
+      @counters[depth] = (@counters[depth] || 0) + 1
+      @counters.delete_if { |d, _| d > depth }
+      @counters[depth]
+    end
+  end
+end

data/lib/mdx_tex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MdxTex
-  VERSION = '0.1.13'
+  VERSION = '0.2.0'
 end

data/lib/mdx_tex.rb

@@ -3,6 +3,7 @@
 require 'mdx_tex/version'
 require 'mdx_tex/configuration'
 require 'mdx_tex/to_textile'
+require 'mdx_tex/to_markdown'
 
 module MdxTex
   class << self
@@ -21,6 +22,10 @@ module MdxTex
       MdxTex::ToTextile.new(**merged).execute(markdown)
     end
 
+    def to_markdown(textile:)
+      MdxTex::ToMarkdown.new.execute(textile)
+    end
+
     def load_string_extension!
       require 'mdx_tex/core_ext/string'
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mdx-tex
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.2.0
 platform: ruby
 authors:
 - Gloria Budiman
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies: []
 description: Converts Markdown syntax to Textile syntax, with configurable header
   levels and list depth.
@@ -24,6 +24,11 @@ files:
 - lib/mdx_tex/configuration.rb
 - lib/mdx_tex/core_ext/string.rb
 - lib/mdx_tex/railtie.rb
+- lib/mdx_tex/to_markdown.rb
+- lib/mdx_tex/to_markdown/bold.rb
+- lib/mdx_tex/to_markdown/header.rb
+- lib/mdx_tex/to_markdown/ordered_list.rb
+- lib/mdx_tex/to_markdown/unordered_list.rb
 - lib/mdx_tex/to_textile.rb
 - lib/mdx_tex/to_textile/bold.rb
 - lib/mdx_tex/to_textile/errors.rb