coradoc-markdown 1.0.6 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdce5853004d12a0dde16c5e512cdb8ce689babaa65b64ec2b64c6dd69b0b245
-  data.tar.gz: 27c0c58e7ca3b4ed423fc072730442915be12d435f5eb09e58181e15824ba45f
+  metadata.gz: d207c747b020fc24b596609a937ae0a4b756295f3e834d925c0ff4af6b403e8f
+  data.tar.gz: b1a62c3d3f4df78ef3a0d177cfdf5432f1fe28a1cf24c6716f1da74c00d4122a
 SHA512:
-  metadata.gz: 32fdb2bf2484781c0d704300eba6b7d60e15c3980f6468252c621f3884b8abee17a5da7283fd0197a1c76f84a3d033538d41f818f2f1ae356071a602a30a203b
-  data.tar.gz: 72b5e70e3aec45b3670727fcff8439cb0ef520d2019f91c71c753b3dfb14e39648e3e3c66ed02429f3bb099465e61dc0568c4ef496745680b1b3d870c9b0a946
+  metadata.gz: 6842c914db9bfa787cc93e9f4b197e010bd303fc7da0687b49e5d8b025dae06c6376a12f8b6f98fd76617b1224db22766883a18a5fd423d7829e690f45337b3f
+  data.tar.gz: 16c27e25254e057943c8505b6ef493dd48aa5280d8d9581ccf8aa106e06fa1524522a86ba56ed31be5e90c9e5adf3b497eed30cad47665d2871f99e8769e30e3

data/lib/coradoc/markdown/model/sidebar.rb

@@ -6,16 +6,19 @@ module Coradoc
   module Markdown
     # Sidebar block — a tangential aside, visually distinct from main flow.
     #
-    # Markdown has no native sidebar. Serialized as an HTML fallback:
-    #   <div class="sidebar">...</div>
+    # Markdown has no native sidebar. Serialized as a VitePress `:::info`
+    # custom container. When the sidebar contains structured children
+    # (code blocks, lists, etc.), they are rendered into the container.
     class Sidebar < Base
       attribute :content, :string
       attribute :title, :string
+      attribute :children, Coradoc::Markdown::Base, collection: true, default: []
 
-      def initialize(content:, title: nil, **rest)
+      def initialize(content:, title: nil, children: [], **rest)
         super
         @content = content
         @title = title
+        @children = Array(children)
       end
     end
   end

data/lib/coradoc/markdown/serializer/serializers/literal.rb

@@ -6,13 +6,18 @@ module Coradoc
   module Markdown
     class Serializer
       module Serializers
-        # Literal block: indented code block (4 leading spaces per line).
-        # Distinct from a code block (which carries a language hint).
+        # Literal block: preformatted text with no language hint. Uses an
+        # unlabeled fenced code block so the content survives VitePress's
+        # Vue template parser (4-space indented code blocks only work in
+        # specific contexts and leak `<` characters when not separated by
+        # blank lines).
         class Literal < ElementSerializer
           handles_type ::Coradoc::Markdown::Literal
 
           def call(element, _ctx)
-            element.content.to_s.lines.map { |line| "    #{line}" }.join
+            body = element.content.to_s
+            body = body.chomp + "\n" unless body.end_with?("\n")
+            "```\n#{body}```\n"
           end
         end
       end

data/lib/coradoc/markdown/serializer/serializers/pass.rb

@@ -6,13 +6,22 @@ module Coradoc
   module Markdown
     class Serializer
       module Serializers
-        # Pass block: emit content inside kramdown's nomarkdown extension
-        # so it bypasses Markdown rendering.
+        # Pass block. AsciiDoc pass content is raw and bypasses all
+        # substitutions. Markdown has no equivalent — kramdown's
+        # `{::nomarkdown}` extension is not supported by VitePress /
+        # markdown-it, so emitting it leaks raw HTML that breaks Vue's
+        # template compiler.
+        #
+        # Emit as an HTML comment so the content is preserved (for
+        # debugging or downstream tooling) but never rendered as HTML.
         class Pass < ElementSerializer
           handles_type ::Coradoc::Markdown::Pass
 
           def call(element, _ctx)
-            "{::nomarkdown}#{element.content.to_s}{:/}"
+            content = element.content.to_s
+            stripped = content.gsub(/\A\n+|\n+\z/, '')
+            comment_body = stripped.empty? ? '' : " #{stripped} "
+            "<!--#{comment_body}-->"
           end
         end
       end

data/lib/coradoc/markdown/serializer/serializers/sidebar.rb

@@ -6,12 +6,25 @@ module Coradoc
   module Markdown
     class Serializer
       module Serializers
+        # Sidebar block — a callout box. VitePress maps the `:::info`
+        # custom container to a styled callout, which matches AsciiDoc's
+        # sidebar semantics without leaking raw HTML into the Markdown.
         class Sidebar < ElementSerializer
           handles_type ::Coradoc::Markdown::Sidebar
 
-          def call(element, _ctx)
-            title_html = element.title ? %(<div class="title">#{element.title}</div>\n) : ''
-            %(<div class="sidebar">\n#{title_html}#{element.content.to_s}\n</div>)
+          def call(element, ctx)
+            title = element.title.to_s
+            header = title.empty? ? '' : " #{title}"
+            body = render_body(element, ctx)
+            ":::info#{header}\n#{body}\n:::"
+          end
+
+          private
+
+          def render_body(element, ctx)
+            return element.content.to_s.chomp if element.children.nil? || element.children.empty?
+
+            element.children.map { |c| ctx.serialize(c) }.join("\n\n").chomp
           end
         end
       end

data/lib/coradoc/markdown/transform/from_core_model.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'cgi'
+
 module Coradoc
   module Markdown
     module Transform
@@ -228,7 +230,11 @@ module Coradoc
           end
 
           def transform_literal_block(block)
-            Coradoc::Markdown::Literal.new(content: block.content.to_s)
+            content = CoreModel::CalloutText.strip_markers(block.content.to_s, block.callouts)
+            literal = Coradoc::Markdown::Literal.new(content: content)
+            return literal if block.callouts.nil? || block.callouts.empty?
+
+            [literal, transform_callout_list(block.callouts)]
           end
 
           def transform_example_block(block)
@@ -241,9 +247,11 @@ module Coradoc
           end
 
           def transform_sidebar_block(block)
+            children = Array(block.children).map { |c| transform(c) }.flat_map { |c| flatten_result(c) }
             Coradoc::Markdown::Sidebar.new(
               content: block.flat_text,
-              title: block.title.to_s
+              title: block.title.to_s,
+              children: children
             )
           end
 
@@ -350,13 +358,13 @@ module Coradoc
 
               # Check if first row is marked as header, or if any of its cells are header cells
               if first_row&.header || first_row_cells.any?(&:header)
-                headers = first_row_cells.map(&:flat_text)
+                headers = first_row_cells.map { |cell| strip_cell_callouts(cell.flat_text) }
                 table_rows = table_rows[1..] || []
               end
 
               # Convert remaining rows to pipe-separated strings
               rows = table_rows.map do |row|
-                Array(row.cells).map(&:flat_text).join(' | ')
+                Array(row.cells).map { |cell| strip_cell_callouts(cell.flat_text) }.join(' | ')
               end
             end
 
@@ -366,6 +374,12 @@ module Coradoc
             )
           end
 
+          CALLOUT_MARKER_IN_CELL = /\s*<\d+>(?=\s|\z)/.freeze
+
+          def strip_cell_callouts(text)
+            text.to_s.gsub(CALLOUT_MARKER_IN_CELL, '')
+          end
+
           def transform_image(image)
             Coradoc::Markdown::Image.new(
               src: image.src,
@@ -405,6 +419,8 @@ module Coradoc
                 text: element.content.to_s,
                 target: element.target.to_s
               )
+            when 'raw_inline'
+              CGI.escapeHTML(element.content.to_s)
             else
               element.content.to_s
             end

data/lib/coradoc/markdown/transform/inline_transformer.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'cgi'
+
 module Coradoc
   module Markdown
     module Transform
@@ -37,6 +39,8 @@ module Coradoc
                 text: element.content.to_s,
                 target: element.target.to_s
               )
+            when 'raw_inline'
+              CGI.escapeHTML(element.content.to_s)
             else
               element.content.to_s
             end

data/lib/coradoc/markdown/version.rb

@@ -2,6 +2,6 @@
 
 module Coradoc
   module Markdown
-    VERSION = '1.0.6'
+    VERSION = '1.0.8'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coradoc-markdown
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.8
 platform: ruby
 authors:
 - Ribose Inc.