coradoc 1.1.7 → 2.0.2

data/coradoc-adoc/lib/coradoc/asciidoc/model/table.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Table element for AsciiDoc tables.
+      #
+      # Represents a table with rows and cells. Tables can have titles,
+      # captions, and various formatting options.
+      #
+      # @!attribute [r] id
+      #   @return [String, nil] Optional identifier for the table
+      # @!attribute [r] title
+      #   @return [String, nil] Optional table title
+      # @!attribute [r] rows
+      #   @return [Array<TableRow>] Table rows
+      # @!attribute [r] content
+      #   @return [String, nil] Optional string content
+      # @!attribute [r] attrs
+      #   @return [AttributeList] Additional table attributes
+      #
+      # @example Create a simple table
+      #   table = Coradoc::AsciiDoc::Model::Table.new
+      #   table.rows << Coradoc::AsciiDoc::Model::TableRow.new
+      #
+      class Table < Base
+        include Coradoc::AsciiDoc::Model::Anchorable
+
+        attribute :id, :string
+        attribute :title, :string
+        attribute :rows, Coradoc::AsciiDoc::Model::TableRow, collection: true
+        attribute :content, :string
+        # attribute :anchor, Inline::Anchor, default: -> {
+        #   id.nil? ? nil : Inline::Anchor.new(id)
+        # }
+        attribute :attrs, Coradoc::AsciiDoc::Model::AttributeList
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/table_cell.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Table cell with full AsciiDoc format specification support
+      #
+      # Cell format specification: [colspan][.rowspan][halign][valign][style][*]
+      #
+      # @!attribute [r] id
+      #   @return [String, nil] Optional cell identifier
+      # @!attribute [r] content
+      #   @return [Array<TextElement>] Cell content
+      # @!attribute [r] colspan
+      #   @return [Integer, nil] Number of columns to span
+      # @!attribute [r] rowspan
+      #   @return [Integer, nil] Number of rows to span
+      # @!attribute [r] halign
+      #   @return [String, nil] Horizontal alignment: "<" left, "^" center, ">" right
+      # @!attribute [r] valign
+      #   @return [String, nil] Vertical alignment: "<" top, "^" middle, ">" bottom
+      # @!attribute [r] style
+      #   @return [String, nil] Cell style: d/s/e/m/a/l/v
+      # @!attribute [r] repeat
+      #   @return [Boolean] Whether to repeat last cell
+      # @!attribute [r] colrowattr
+      #   @return [String] Legacy combined colspan.rowspan string (for serialization)
+      # @!attribute [r] alignattr
+      #   @return [String] Legacy alignment string (for serialization)
+      #
+      # @example Cell spanning 2 columns
+      #   cell = TableCell.new(content: "text", colspan: 2)
+      #
+      # @example Centered cell with emphasis style
+      #   cell = TableCell.new(content: "text", halign: "^", style: "e")
+      #
+      class TableCell < Base
+        include Coradoc::AsciiDoc::Model::Anchorable
+
+        # Core attributes
+        attribute :id, :string
+        attribute :content, Coradoc::AsciiDoc::Model::TextElement, collection: true, initialize_empty: true
+
+        # Cell format specification attributes
+        attribute :colspan, :integer
+        attribute :rowspan, :integer
+        attribute :halign, :string  # "<" left, "^" center, ">" right
+        attribute :valign, :string  # "<" top, "^" middle, ">" bottom
+        attribute :style, :string   # d/s/e/m/a/l/v
+        attribute :repeat, :boolean, default: -> { false }
+
+        # Legacy attributes for backward compatibility with serializer
+        attribute :colrowattr, :string, default: -> { '' }
+        attribute :alignattr, :string, default: -> { '' }
+
+        # Check if this cell contains AsciiDoc content
+        def asciidoc?
+          style == 'a'
+        end
+
+        # Check if this cell has literal content
+        def literal?
+          style == 'l'
+        end
+
+        # Check if this cell has verse style
+        def verse?
+          style == 'v'
+        end
+
+        # Get horizontal alignment as CSS value
+        # @return [String, nil] "left", "center", or "right"
+        def horizontal_alignment
+          case halign
+          when '<' then 'left'
+          when '^' then 'center'
+          when '>' then 'right'
+          end
+        end
+
+        # Get vertical alignment as CSS value
+        # @return [String, nil] "top", "middle", or "bottom"
+        def vertical_alignment
+          case valign
+          when '<' then 'top'
+          when '^' then 'middle'
+          when '>' then 'bottom'
+          end
+        end
+
+        # Get style name as human-readable string
+        # @return [String, nil] Style name
+        def style_name
+          case style
+          when 'd' then 'default'
+          when 's' then 'strong'
+          when 'e' then 'emphasis'
+          when 'm' then 'monospace'
+          when 'a' then 'asciidoc'
+          when 'l' then 'literal'
+          when 'v' then 'verse'
+          end
+        end
+
+        # Generate colrowattr for serialization (e.g., "2.3" for colspan=2, rowspan=3)
+        # @return [String] Combined colspan.rowspan string
+        def generate_colrowattr
+          result = ''
+          result += colspan.to_s if colspan && colspan > 1
+          result += ".#{rowspan}" if rowspan && rowspan > 1
+          result
+        end
+
+        # Generate alignattr for serialization (e.g., "^" for center)
+        # @return [String] Combined alignment string
+        def generate_alignattr
+          (halign || '') + (valign || '')
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/table_row.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class TableRow < Base
+        attribute :columns, Coradoc::AsciiDoc::Model::TableCell, collection: true
+        attribute :header, :boolean, default: -> { false }
+
+        def table_header_row?
+          header
+        end
+
+        def asciidoc?
+          columns&.any? { |c| c.is_a?(Coradoc::AsciiDoc::Model::TableCell) && c.asciidoc? } || false
+        end
+
+        # NOTE: underline_for provides trailing newline for table row serialization.
+        # The method name follows AsciiDoc table formatting conventions.
+        def underline_for
+          "\n"
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/tag.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Tag element for AsciiDoc documents.
+      #
+      # Tags are metadata markers that can be associated with document elements.
+      #
+      # @!attribute [r] name
+      #   @return [String] The tag name
+      #
+      # @!attribute [r] prefix
+      #   @return [String] Tag prefix (default: "tag")
+      #
+      # @!attribute [r] attrs
+      #   @return [Coradoc::AsciiDoc::Model::AttributeList] Tag attributes
+      #
+      # @!attribute [r] line_break
+      #   @return [String] Line break character (default: "\n")
+      #
+      # @example Create a tag
+      #   tag = Coradoc::AsciiDoc::Model::Tag.new
+      #   tag.name = "important"
+      #
+      class Tag < Base
+        attribute :name, :string
+        attribute :prefix, :string, default: 'tag'
+        attribute :attrs, Coradoc::AsciiDoc::Model::AttributeList, default: lambda {
+          Coradoc::AsciiDoc::Model::AttributeList.new
+        }
+        attribute :line_break, :string, default: -> { "\n" }
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/term.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Term element for AsciiDoc definition lists.
+      #
+      # Terms are the items being defined in definition lists.
+      # Each term has a text value and can have an optional type.
+      #
+      # @!attribute [r] term
+      #   @return [String] The term text being defined
+      #
+      # @!attribute [r] type
+      #   @return [String] The term type/category
+      #
+      # @!attribute [r] lang
+      #   @return [String] Language code (default: "en")
+      #
+      # @!attribute [r] line_break
+      #   @return [String] Line break character (default: "")
+      #
+      # @example Create a term
+      #   term = Coradoc::AsciiDoc::Model::Term.new
+      #   term.term = "ASCII"
+      #   term.type = "acronym"
+      #
+      # @see Coradoc::AsciiDoc::Model::List::Definition Definition lists
+      #
+      class Term < Base
+        attribute :term, :string
+        attribute :type, :string
+        attribute :lang, :string, default: -> { 'en' }
+        attribute :line_break, :string, default: -> { '' }
+
+        def validate
+          errors = super
+
+          errors << Lutaml::Model::Error.new('Term cannot be nil or empty') if term.nil? || term.empty?
+
+          errors << Lutaml::Model::Error.new('Type cannot be nil or empty') if type.nil? || type.empty?
+
+          errors
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/text_element.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class TextElement < Base
+        attribute :id, :string
+        attribute :content,
+                  Lutaml::Model::Serializable,
+                  default: -> { '' },
+                  polymorphic: [
+                    Lutaml::Model::Type::String,
+                    :array
+                  ]
+        attribute :line_break, :string, default: -> { '' }
+
+        def self.escape_keychars(string)
+          subs = { '*' => '\*', '_' => '\_' }
+          string
+            .gsub(/((?<=\s)[*_]+)|[*_]+(?=\s)/) do |n|
+            n.chars.map do |char|
+              subs[char]
+            end.join
+          end
+        end
+
+        # Get text content as string
+        #
+        # @return [String] The text content
+        #
+        def to_s
+          case content
+          when String
+            content
+          when Array
+            content.map(&:to_s).join
+          when Coradoc::AsciiDoc::Model::Base
+            content.to_adoc
+          when Lutaml::Model::Serializable
+            if content.class.attributes.key?(:content)
+              content.content.to_s
+            else
+              ''
+            end
+          when nil
+            ''
+          else
+            content.is_a?(String) ? content.to_s : ''
+          end
+        end
+
+        # Alias for text to work with ContentList
+        #
+        # @return [String] The text content
+        #
+        def text
+          to_s
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/title.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Title element for sections and document headers.
+      #
+      # Represents a title with optional level information. Titles are used by
+      # sections to define their heading level and text content.
+      #
+      # @!attribute [r] id
+      #   @return [String, nil] Optional identifier for the title
+      # @!attribute [r] content
+      #   @return [Array<TextElement>] Title text content (can include inline formatting)
+      # @!attribute [r] level_int
+      #   @return [Integer, nil] Heading level (0-5 for standard, 6+ uses style attribute)
+      # @!attribute [r] line_break
+      #   @return [String] Line break character after title (default: newline)
+      # @!attribute [r] style
+      #   @return [String, nil] Optional style attribute for title formatting
+      #
+      # @example Create a level 1 title
+      #   title = Coradoc::AsciiDoc::Model::Title.new(
+      #     content: [Coradoc::AsciiDoc::Model::TextElement.new("Chapter 1")],
+      #     level_int: 0
+      #   )
+      #   title.to_adoc # => "= Chapter 1\n"
+      #
+      # @example Create a level 2 title
+      #   title = Coradoc::AsciiDoc::Model::Title.new(
+      #     content: [Coradoc::AsciiDoc::Model::TextElement.new("Section 1.1")],
+      #     level_int: 1
+      #   )
+      #   title.to_adoc # => "== Section 1.1\n"
+      #
+      class Title < Base
+        include Coradoc::AsciiDoc::Model::Anchorable
+
+        attribute :id, :string
+        attribute :content, Coradoc::AsciiDoc::Model::TextElement, collection: true
+        # attribute :level, :string
+        attribute :level_int, :integer
+        attribute :line_break, :string, default: -> { "\n" }
+        attribute :style, :string
+
+        alias text content
+
+        # Convert title content to string
+        # @return [String] The title text
+        def to_s
+          case content
+          when String
+            content
+          when Array
+            content.map do |item|
+              item.is_a?(Coradoc::AsciiDoc::Model::TextElement) ? item.content.to_s : item.to_s
+            end.join
+          else
+            content.to_s
+          end
+        end
+
+        def level_str
+          return '' if level_int.nil?
+
+          if level_int <= 5
+            '=' * (level_int + 1)
+          else
+            '======'
+          end
+        end
+
+        def style_str
+          return '' if level_int.nil?
+
+          _style = [style]
+          _style << "level=#{level_int}" if level_int > 5
+          _style = _style.compact.join(',')
+
+          _style.empty? ? '' : "[#{_style}]\n"
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/video/attribute_list.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class Video < Base
+        class AttributeList < Coradoc::AsciiDoc::Model::AttributeList
+          extend AttributeList::Matchers
+          def positional_validators
+            [
+              [:alt, String],
+              [:width, Integer],
+              [:height, Integer]
+            ]
+          end
+
+          def named_validators
+            {
+              title: String,
+              poster: String,
+              width: Integer,
+              height: Integer,
+              start: Integer,
+              end: Integer,
+              theme: one('dark', 'light'),
+              lang: /[a-z]{2,3}(?:-[A-Z]{2})?/,
+              list: String,
+              playlist: String,
+              options: many(
+                'autoplay',
+                'loop',
+                'modest',
+                'nocontrols',
+                'nofullscreen',
+                'muted'
+              )
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model/video.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Video block element for AsciiDoc documents.
+      #
+      # Videos are embedded multimedia content with support for various
+      # video platforms and custom attributes.
+      #
+      # @!attribute [r] id
+      #   @return [String, nil] Optional identifier for the video
+      #
+      # @!attribute [r] title
+      #   @return [String, nil] Optional video title
+      #
+      # @!attribute [r] src
+      #   @return [String] The video source URL or path
+      #
+      # @!attribute [r] attributes
+      #   @return [Coradoc::AsciiDoc::Model::Video::AttributeList] Video-specific attributes
+      #
+      # @!attribute [r] line_break
+      #   @return [String] Line break character (default: "\n")
+      #
+      # @example Create a video block
+      #   video = Coradoc::AsciiDoc::Model::Video.new
+      #   video.src = "https://example.com/video.mp4"
+      #   video.title = "Demo Video"
+      #
+      class Video < Base
+        # Autoload nested AttributeList class
+        autoload :AttributeList, 'coradoc/asciidoc/model/video/attribute_list'
+
+        include Coradoc::AsciiDoc::Model::Anchorable
+
+        attribute :id, :string
+        attribute :title, :string
+        attribute :src, :string, default: -> { '' }
+        attribute :attributes,
+                  Video::AttributeList,
+                  default: lambda {
+                    Coradoc::AsciiDoc::Model::AttributeList.new
+                  }
+        attribute :line_break, :string, default: -> { "\n" }
+      end
+    end
+  end
+end

data/coradoc-adoc/lib/coradoc/asciidoc/model.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# IMPORTANT: Load Base class and Serialization module FIRST
+# These register the asciidoc format with Lutaml::Model, which is needed
+# before any model class can use the asciidoc DSL
+require_relative 'model/base'
+require_relative 'model/serialization'
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Layer 0: Mixins (no dependencies)
+      autoload :Anchorable, "#{__dir__}/model/anchorable"
+      autoload :Attached, "#{__dir__}/model/attached"
+      autoload :Spacing, "#{__dir__}/model/spacing"
+
+      # Layer 1: Simple types (only depend on Layer 0)
+      autoload :Attribute, "#{__dir__}/model/attribute"
+      autoload :AttributeListAttribute, "#{__dir__}/model/attribute_list_attribute"
+      autoload :NamedAttribute, "#{__dir__}/model/named_attribute"
+      autoload :RejectedPositionalAttribute, "#{__dir__}/model/rejected_positional_attribute"
+      autoload :AttributeList, "#{__dir__}/model/attribute_list"
+      autoload :Author, "#{__dir__}/model/author"
+      autoload :Revision, "#{__dir__}/model/revision"
+      autoload :Break, "#{__dir__}/model/break"
+      autoload :CommentBlock, "#{__dir__}/model/comment_block"
+      autoload :CommentLine, "#{__dir__}/model/comment_line"
+      autoload :Glossaries, "#{__dir__}/model/glossaries"
+      autoload :Include, "#{__dir__}/model/include"
+      autoload :Tag, "#{__dir__}/model/tag"
+
+      # Layer 2-3: Text types
+      autoload :TextElement, "#{__dir__}/model/text_element"
+      autoload :Admonition, "#{__dir__}/model/admonition"
+      autoload :Highlight, "#{__dir__}/model/highlight"
+      autoload :LineBreak, "#{__dir__}/model/line_break"
+      autoload :Title, "#{__dir__}/model/title"
+      autoload :Paragraph, "#{__dir__}/model/paragraph"
+
+      # Layer 4-5: Block and List types
+      autoload :Block, "#{__dir__}/model/block"
+      autoload :ContentList, "#{__dir__}/model/content_list"
+      autoload :Term, "#{__dir__}/model/term"
+      autoload :List, "#{__dir__}/model/list"
+
+      # Layer 6: Structural types
+      autoload :DocumentAttributes, "#{__dir__}/model/document_attributes"
+      autoload :Header, "#{__dir__}/model/header"
+      autoload :Section, "#{__dir__}/model/section"
+
+      # Layer 7-8: Content types
+      autoload :Audio, "#{__dir__}/model/audio"
+      autoload :BibliographyEntry, "#{__dir__}/model/bibliography_entry"
+      autoload :Bibliography, "#{__dir__}/model/bibliography"
+      autoload :Video, "#{__dir__}/model/video"
+      autoload :Image, "#{__dir__}/model/image"
+
+      # Layer 9: Table types
+      autoload :TableCell, "#{__dir__}/model/table_cell"
+      autoload :TableRow, "#{__dir__}/model/table_row"
+      autoload :Table, "#{__dir__}/model/table"
+
+      # Layer 10: Inline types
+      autoload :Inline, "#{__dir__}/model/inline"
+
+      # Layer 11: Complex types
+      autoload :ReviewerNote, "#{__dir__}/model/reviewer_note"
+
+      # Layer 12: Document
+      autoload :Document, "#{__dir__}/model/document"
+    end
+  end
+end