coradoc-adoc 2.0.0

data/lib/coradoc/asciidoc/model/inline/span.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Span inline element for applying styles to text in AsciiDoc documents.
+        #
+        # Spans allow applying roles and custom attributes to inline text.
+        #
+        # @!attribute [r] text
+        #   @return [String] The text content
+        #
+        # @!attribute [r] role
+        #   @return [String, nil] The CSS role to apply
+        #
+        # @!attribute [r] attributes
+        #   @return [Coradoc::AsciiDoc::Model::AttributeList, nil] Additional attributes
+        #
+        # @!attribute [r] unconstrained
+        #   @return [Boolean] Whether to use unconstrained formatting (default: false)
+        #
+        # @example Create a span with a role
+        #   span = Coradoc::AsciiDoc::Model::Inline::Span.new
+        #   span.text = "Important text"
+        #   span.role = "red"
+        #   span.to_adoc # => "[.red]#Important text#"
+        #
+        class Span < Base
+          attribute :text, :string
+          attribute :role, :string
+          attribute :attributes, Coradoc::AsciiDoc::Model::AttributeList
+          attribute :unconstrained, :boolean, default: -> { false }
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline/stem.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Stem inline element for AsciiDoc documents.
+        #
+        # STEM macros are mathematical notation: stem:[formula] or latexmath:[formula]
+        #
+        # @!attribute [r] type
+        #   @return [String] The stem type (stem, latexmath, asciimath)
+        #
+        # @!attribute [r] content
+        #   @return [String] The mathematical content/formula
+        #
+        class Stem < Base
+          attribute :type, :string, default: 'stem'
+          attribute :content, :string
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline/strikethrough.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Strikethrough inline text formatting for AsciiDoc documents.
+        #
+        # Strikethrough text is rendered with line-through role: [.line-through]#text#.
+        #
+        # @!attribute [r] content
+        #   @return [String, Array<Lutaml::Model::Serializable>] The text content to format as strikethrough
+        #
+        # @!attribute [r] text
+        #   @return [String] Alternative text attribute (aliased to content)
+        #
+        # @!attribute [r] unconstrained
+        #   @return [Boolean] Whether to use unconstrained formatting (default: false)
+        #
+        # @example Create strikethrough text
+        #   strikethrough = Coradoc::AsciiDoc::Model::Inline::Strikethrough.new
+        #   strikethrough.content = "Deleted text"
+        #   strikethrough.to_adoc # => "[.line-through]#Deleted text#"
+        #
+        class Strikethrough < Base
+          attribute :content,
+                    Lutaml::Model::Serializable,
+                    default: -> { nil },
+                    polymorphic: [
+                      Lutaml::Model::Type::String,
+                      :array
+                    ]
+          attribute :text, :string, default: -> { nil }
+          attribute :unconstrained, :boolean, default: -> { false }
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline/subscript.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Subscript inline text formatting for AsciiDoc documents.
+        #
+        # Subscript text is rendered with tildes: ~subscript~.
+        #
+        # @!attribute [r] content
+        #   @return [String, Array<Lutaml::Model::Serializable>] The text content to format as subscript
+        #
+        # @example Create subscript text
+        #   sub = Coradoc::AsciiDoc::Model::Inline::Subscript.new
+        #   sub.content = "2"
+        #   sub.to_adoc # => "~2~"
+        #
+        # @see Coradoc::AsciiDoc::Model::Inline::Superscript Superscript text
+        #
+        class Subscript < Base
+          attribute :content,
+                    Lutaml::Model::Serializable,
+                    default: -> { nil },
+                    polymorphic: [
+                      Lutaml::Model::Type::String,
+                      :array
+                    ]
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline/superscript.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Superscript inline text formatting for AsciiDoc documents.
+        #
+        # Superscript text is rendered with carets: ^superscript^.
+        #
+        # @!attribute [r] content
+        #   @return [String, Array<Lutaml::Model::Serializable>] The text content to format as superscript
+        #
+        # @example Create superscript text
+        #   sup = Coradoc::AsciiDoc::Model::Inline::Superscript.new
+        #   sup.content = "TM"
+        #   sup.to_adoc # => "^TM^"
+        #
+        # @see Coradoc::AsciiDoc::Model::Inline::Subscript Subscript text
+        #
+        class Superscript < Base
+          attribute :content,
+                    Lutaml::Model::Serializable,
+                    default: -> { nil },
+                    polymorphic: [
+                      Lutaml::Model::Type::String,
+                      :array
+                    ]
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline/underline.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Underline inline text formatting for AsciiDoc documents.
+        #
+        # Underlined text is rendered with underscores: [u]#text#.
+        #
+        # @!attribute [r] text
+        #   @return [String] The text content to underline
+        #
+        # @example Create underlined text
+        #   underline = Coradoc::AsciiDoc::Model::Inline::Underline.new
+        #   underline.text = "Underlined"
+        #   underline.to_adoc # => "[u]#Underlined#"
+        #
+        class Underline < Base
+          attribute :text, :string
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/inline.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module Inline
+        # Autoload inline elements lazily
+        autoload :Base, 'coradoc/asciidoc/model/inline/base'
+        autoload :Anchor, 'coradoc/asciidoc/model/inline/anchor'
+        autoload :AttributeReference, 'coradoc/asciidoc/model/inline/attribute_reference'
+        autoload :Bold, 'coradoc/asciidoc/model/inline/bold'
+        autoload :Italic, 'coradoc/asciidoc/model/inline/italic'
+        autoload :CrossReference, 'coradoc/asciidoc/model/inline/cross_reference'
+        autoload :CrossReferenceArg, 'coradoc/asciidoc/model/inline/cross_reference_arg'
+        autoload :Monospace, 'coradoc/asciidoc/model/inline/monospace'
+        autoload :Link, 'coradoc/asciidoc/model/inline/link'
+        autoload :Quotation, 'coradoc/asciidoc/model/inline/quotation'
+        autoload :Highlight, 'coradoc/asciidoc/model/inline/highlight'
+        autoload :Subscript, 'coradoc/asciidoc/model/inline/subscript'
+        autoload :Superscript, 'coradoc/asciidoc/model/inline/superscript'
+        autoload :HardLineBreak, 'coradoc/asciidoc/model/inline/hard_line_break'
+        autoload :Span, 'coradoc/asciidoc/model/inline/span'
+        autoload :Footnote, 'coradoc/asciidoc/model/inline/footnote'
+        autoload :Underline, 'coradoc/asciidoc/model/inline/underline'
+        autoload :Small, 'coradoc/asciidoc/model/inline/small'
+        autoload :Strikethrough, 'coradoc/asciidoc/model/inline/strikethrough'
+        autoload :Stem, 'coradoc/asciidoc/model/inline/stem'
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/line_break.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class LineBreak < Base
+        attribute :line_break, :string, default: -> { '' }
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/core.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # Base class for list elements in AsciiDoc documents.
+        #
+        # Lists are container elements that hold list items and provide
+        # functionality for different list types (ordered, unordered, definition).
+        #
+        # @!attribute [r] id
+        #   @return [String, nil] Optional identifier for the list
+        # @!attribute [r] prefix
+        #   @return [String, nil] List marker prefix (e.g., "*", "*", "**", etc.)
+        # @!attribute [r] items
+        #   @return [Array<ListItem>] List items in this list
+        # @!attribute [r] ol_count
+        # @return [Integer] Ordered list nesting level
+        # @!attribute [r] attrs
+        #   @return [AttributeList] Additional list attributes
+        # @!attribute [r] marker
+        #   @return [String, nil] The marker character used for this list
+        #
+        # @example Create an unordered list
+        #   list = Coradoc::AsciiDoc::Model::List::Unordered.new
+        #   list.items << Coradoc::AsciiDoc::Model::List::Item.new("Item 1")
+        #
+        class Core < Nestable
+          include Coradoc::AsciiDoc::Model::Anchorable
+
+          def block_level?
+            true
+          end
+
+          attribute :id, :string
+          attribute :prefix, :string
+          # attribute :anchor, Inline::Anchor, default: -> {
+          #   id.nil? ? nil : Inline::Anchor.new(id)
+          # }
+          attribute :items, Coradoc::AsciiDoc::Model::List::Item, collection: true, initialize_empty: true
+          attribute :ol_count, :integer, default: -> { 1 }
+          attribute :attrs, Coradoc::AsciiDoc::Model::AttributeList, default: lambda {
+            Coradoc::AsciiDoc::Model::AttributeList.new
+          }
+          attribute :marker, :string
+
+          asciidoc do
+            map_attribute 'id', to: :id
+            map_attribute 'anchor', to: :anchor
+            map_attribute 'prefix', to: :prefix
+            map_attribute 'items', to: :items
+            map_attribute 'ol_count', to: :ol_count
+            map_attribute 'attrs', to: :attrs
+            map_attribute 'marker', to: :marker
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/definition.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        class Definition < Base
+          attribute :items,
+                    Coradoc::AsciiDoc::Model::Base,
+                    polymorphic: [Coradoc::AsciiDoc::Model::List::DefinitionItem],
+                    collection: true,
+                    initialize_empty: true
+          attribute :delimiter, :string, default: -> { '::' }
+
+          asciidoc do
+            map_attribute 'items', to: :items
+            map_attribute 'delimiter', to: :delimiter
+          end
+
+          def prefix
+            delimiter
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/definition_item.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # Definition list item for AsciiDoc definition/labeled lists.
+        #
+        # A DefinitionItem contains one or more terms and their associated
+        # definitions. In AsciiDoc, this maps to the labeled list syntax:
+        #
+        #   Term 1:: Definition 1
+        #   Term 2::: Definition 2 (deeper level)
+        #
+        # @!attribute [r] id
+        #   @return [String, nil] Optional identifier for the definition item
+        #
+        # @!attribute [r] terms
+        #   @return [Array<Term>] The terms being defined (can have multiple)
+        #
+        # @!attribute [r] contents
+        #   @return [Array<TextElement>] The definitions/contents for the terms
+        #
+        # @example Create a definition list item
+        #   item = Coradoc::AsciiDoc::Model::List::DefinitionItem.new
+        #   item.terms << Coradoc::AsciiDoc::Model::Term.new(term: "API")
+        #   item.contents << Coradoc::AsciiDoc::Model::TextElement.new("Application Programming Interface")
+        #
+        class DefinitionItem < Base
+          include Coradoc::AsciiDoc::Model::Anchorable
+
+          attribute :id, :string
+          attribute :terms, Coradoc::AsciiDoc::Model::Term, collection: true
+          attribute :contents, Coradoc::AsciiDoc::Model::TextElement, collection: true
+
+          def to_adoc(delimiter: '')
+            Coradoc::AsciiDoc::Serializer.serialize(self, delimiter: delimiter)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/item.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # List item element for ordered and unordered AsciiDoc lists.
+        #
+        # Represents a single item in an ordered or unordered list, which can
+        # contain text content, attached blocks (paragraphs, admonitions),
+        # and nested lists.
+        #
+        # @!attribute [r] id
+        #   @return [String, nil] Optional identifier for the list item
+        #
+        # @!attribute [r] content
+        #   @return [Array<Coradoc::AsciiDoc::Model::Base>] Polymorphic content
+        #
+        # @!attribute [r] marker
+        #   @return [String, nil] Custom list marker for this item
+        #
+        # @!attribute [r] subitem
+        #   @return [String, nil] Sub-item text
+        #
+        # @!attribute [r] line_break
+        #   @return [String] Line break character (default: "\n")
+        #
+        # @!attribute [r] attached
+        #   @return [Array<Coradoc::AsciiDoc::Model::Attached>] Attached blocks
+        #
+        # @!attribute [r] nested
+        #   @return [Coradoc::AsciiDoc::Model::List::Nestable, nil] Nested list
+        #
+        # @example Create a simple list item
+        #   item = Coradoc::AsciiDoc::Model::List::Item.new
+        #   item.content = [Coradoc::AsciiDoc::Model::TextElement.new("First item")]
+        #
+        # @example Create a list item with nested list
+        #   item = Coradoc::AsciiDoc::Model::List::Item.new
+        #   item.nested = Coradoc::AsciiDoc::Model::List::Unordered.new
+        #   item.nested.items << Coradoc::AsciiDoc::Model::List::Item.new
+        #
+        class Item < Base
+          include Coradoc::AsciiDoc::Model::Anchorable
+
+          attribute :id, :string
+          attribute :content,
+                    Coradoc::AsciiDoc::Model::Base,
+                    polymorphic: [
+                      Coradoc::AsciiDoc::Model::TextElement,
+                      Coradoc::AsciiDoc::Model::Section
+                    ]
+          attribute :marker, :string
+          attribute :subitem, :string
+          attribute :line_break, :string, default: -> { "\n" }
+
+          attribute :attached,
+                    Coradoc::AsciiDoc::Model::Attached,
+                    polymorphic: [
+                      Coradoc::AsciiDoc::Model::Admonition,
+                      Coradoc::AsciiDoc::Model::Paragraph,
+                      Coradoc::AsciiDoc::Model::Block::Core
+                    ],
+                    collection: true,
+                    initialize_empty: true
+
+          attribute :nested, Coradoc::AsciiDoc::Model::List::Nestable
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/nestable.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # Mixin module for nestable list functionality.
+        # Provides common functionality for lists that can contain nested lists.
+        class Nestable < Coradoc::AsciiDoc::Model::Base
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/ordered.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # Ordered (numbered) list for AsciiDoc documents.
+        #
+        # Ordered lists use numeric markers (1, 2, 3...) or custom markers
+        # and are typically used for sequential items.
+        #
+        # @example Create an ordered list
+        #   list = Coradoc::AsciiDoc::Model::List::Ordered.new
+        #   item = Coradoc::AsciiDoc::Model::ListItem.new
+        #   item.content = [Coradoc::AsciiDoc::Model::TextElement.new("First item")]
+        #   list.items << item
+        #
+        # @see Coradoc::AsciiDoc::Model::List::Core Base list class
+        # @see Coradoc::AsciiDoc::Model::List::Unordered Unordered (bulleted) lists
+        #
+        class Ordered < Core
+          # Generate the prefix marker for this list level
+          #
+          # @return [String] The prefix marker (e.g., ".", "..", "...")
+          def prefix
+            return marker if marker
+
+            '.' * [ol_count, 1].max
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list/unordered.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      module List
+        # Unordered (bulleted) list for AsciiDoc documents.
+        #
+        # Unordered lists use asterisk markers (*, **, ***) and are
+        # typically used for non-sequential items where order doesn't matter.
+        #
+        # @example Create an unordered list
+        #   list = Coradoc::AsciiDoc::Model::List::Unordered.new
+        #   item = Coradoc::AsciiDoc::Model::ListItem.new
+        #   item.content = [Coradoc::AsciiDoc::Model::TextElement.new("Bullet point")]
+        #   list.items << item
+        #
+        # @see Coradoc::AsciiDoc::Model::List::Core Base list class
+        # @see Coradoc::AsciiDoc::Model::List::Ordered Ordered (numbered) lists
+        #
+        class Unordered < Core
+          # Generate the prefix marker for this list level
+          #
+          # @return [String] The prefix marker (e.g., "*", "**", "***")
+          def prefix
+            return marker if marker
+
+            '*' * [ol_count, 1].max
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/list.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Namespace for all AsciiDoc list types and their items.
+      #
+      # List Architecture:
+      #   - List::Core - Common list functionality (base class)
+      #   - List::Ordered - Numbered lists (1., 2., 3., etc.)
+      #   - List::Unordered - Bulleted lists (*, **, etc.)
+      #   - List::Definition - Labeled/definition lists (term:: definition)
+      #   - List::Item - Item for ordered/unordered lists
+      #   - List::DefinitionItem - Item for definition lists
+      #   - List::Nestable - Mixin for nesting support
+      #
+      module List
+        # Autoload list types lazily
+        autoload :Core, 'coradoc/asciidoc/model/list/core'
+        autoload :Nestable, 'coradoc/asciidoc/model/list/nestable'
+        autoload :Ordered, 'coradoc/asciidoc/model/list/ordered'
+        autoload :Unordered, 'coradoc/asciidoc/model/list/unordered'
+        autoload :Definition, 'coradoc/asciidoc/model/list/definition'
+        autoload :Item, 'coradoc/asciidoc/model/list/item'
+        autoload :DefinitionItem, 'coradoc/asciidoc/model/list/definition_item'
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/named_attribute.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class NamedAttribute < Base
+        attribute :name, :string
+        attribute :value, :string, collection: true, initialize_empty: true
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/paragraph.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      # Paragraph block element.
+      #
+      # Represents a paragraph of text in an AsciiDoc document. Paragraphs can
+      # contain mixed content including text, inline formatting, and other elements.
+      #
+      # @!attribute [r] id
+      #   @return [String, nil] Optional identifier for the paragraph
+      # @!attribute [r] content
+      #   @return [Array<String, TextElement>] Paragraph content (can be text or TextElement objects)
+      # @!attribute [r] title
+      #   @return [String, nil] Optional title for the paragraph
+      # @!attribute [r] attributes
+      #   @return [AttributeList] Additional paragraph attributes (style, position, etc.)
+      # @!attribute [r] tdsinglepara
+      #   @return [Boolean] Special table cell paragraph flag
+      #
+      # @example Create a simple paragraph
+      #   para = Coradoc::AsciiDoc::Model::Paragraph.new("Hello World")
+      #   para.to_adoc # => "Hello World"
+      #
+      # @example Create a paragraph with attributes
+      #   para = Coradoc::AsciiDoc::Model::Paragraph.new(
+      #     "Note: This is important",
+      #     attributes: Coradoc::AsciiDoc::Model::Coradoc::AsciiDoc::Model::AttributeList.new(["NOTE"])
+      #   )
+      #
+      class Paragraph < Attached
+        include Coradoc::AsciiDoc::Model::Anchorable
+
+        attribute :id, :string
+        # NOTE: Content uses polymorphic collection supporting both String and TextElement
+        # types via lutaml-model's polymorphic attribute feature.
+        attribute :content,
+                  Lutaml::Model::Serializable,
+                  collection: true,
+                  initialize_empty: true,
+                  polymorphic: [
+                    # :string,
+                    Lutaml::Model::Type::String,
+                    Coradoc::AsciiDoc::Model::TextElement
+                  ]
+        attribute :title, :string
+        attribute :attributes, Coradoc::AsciiDoc::Model::AttributeList, default: lambda {
+          Coradoc::AsciiDoc::Model::AttributeList.new
+        }
+        attribute :tdsinglepara, :boolean, default: -> { false }
+        # Trailing newlines after paragraph for exact round-trip preservation
+        # nil = use default "\n\n" spacing (semantic mode)
+        # string = exact trailing newlines from original (exact mode)
+        attribute :trailing_newlines, :string, default: nil
+      end
+    end
+  end
+end

data/lib/coradoc/asciidoc/model/rejected_positional_attribute.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module AsciiDoc
+    module Model
+      class RejectedPositionalAttribute < Base
+        attribute :position, :integer
+        attribute :value, :string
+      end
+    end
+  end
+end