coradoc 1.1.6 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f44a34ea3abbb6cff77d55b6516b74400db157035c2134a674ad5fe49a11f94
-  data.tar.gz: aa000ad423925a5e39f410e72e543071f5aa33e5a10c2cdefc10ee8e3bfa3c57
+  metadata.gz: 728aadf584ed71846c925bd918143307f1a67c1c50b03e1d088dc232578a92d4
+  data.tar.gz: 8588d96dc42f3710f6103220f150bedd86b6f445ddb9aa142f2af3322b1cb766
 SHA512:
-  metadata.gz: f8f0ddca5617607309d097195635f5b316b84f031c381cfe9dc8274e557beadb4d610ad990909d219e49297bdedb67034889902e7dcbcfdf2617ec578fc75f69
-  data.tar.gz: 6a98d048011b6314b2c9ae457e43f10730b0238f1329d4cae7d38494966d23b2e13a75dc4f4df1cb4938e5451b3363c5514be15aa6f1f55a4dbfb26eab6c7307
+  metadata.gz: e88d156f5149cddb4f5f3f70765dfc67e4b0f8f44537034f0ea9bd55ef1553a2092a6edf2aa8ec51e0bca5e9622bc3e18da6680ef0aa7b4610eabdcdccf283c9
+  data.tar.gz: 500056c39061e779033c830560c16026828e881f55f13ae97ebcf42d7d6acb4ef1a9383cfa628b126bfe5c6ad4357459b102b9fba12a1ce4f8396255861614cf

data/.envrc

@@ -0,0 +1 @@
+use flake

data/.irbrc

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'coradoc'
+
+# This works with the update to Lutaml Model.
+def parse(str)
+  ast = Coradoc::Parser.parse(str)
+  result = Coradoc::Transformer.transform(ast)
+
+  {
+    ast:,
+    result:
+  }
+end
+
+def parse_file(file_path = 'spec/fixtures/sample.adoc')
+  str = File.read(file_path)
+  parse(str)
+end
+
+def menu
+  puts <<~EOM
+    🔨 Welcome to Coradoc ⨯ \x1b[31;1m#{$PROGRAM_NAME}\x1b[m!
+
+      parse(str)        - Given an asciidoc string, return AST and doc model
+      parse_file(file)  - Given a file path, return AST and doc model
+
+    [[general commands]]
+
+      menu              - prints this menu
+
+  EOM
+end
+
+menu

data/.pryrc.sample

@@ -1 +1 @@
-doc = Coradoc::Parser.parse("spec/fixtures/sample.adoc")
+load ".irbrc"

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.rubocop.yml

@@ -1,10 +1,13 @@
-# Auto-generated by Cimas: Do not edit it manually!
-# See https://github.com/metanorma/cimas
 inherit_from:
-  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+  - .rubocop_todo.yml
 
 # local repo-specific modifications
 # ...
 
 AllCops:
-  TargetRubyVersion: 2.5
+  TargetRubyVersion: 3.1
+
+plugins:
+  - rubocop-performance
+  - rubocop-rake
+  - rubocop-rspec

data/.rubocop_todo.yml

@@ -0,0 +1,522 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-04-22 10:56:31 UTC using RuboCop version 1.75.8.
+# 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.
+
+# Offense count: 3
+# Configuration parameters: Severity, Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'coradoc-adoc/coradoc-adoc.gemspec'
+    - 'coradoc-html/coradoc-html.gemspec'
+    - 'coradoc.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentOneStep, IndentationWidth.
+# SupportedStyles: case, end
+Layout/CaseIndentation:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment.
+Layout/CommentIndentation:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ElseAlignment:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith, Severity.
+# SupportedStylesAlignWith: keyword, variable, start_of_line
+Layout/EndAlignment:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, AllowedPatterns.
+Layout/IndentationWidth:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 6
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 235
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: aligned, indented, indented_relative_to_receiver
+Layout/MultilineMethodCallIndentation:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/input/converters/h.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/coradoc/normalize.rb'
+
+# Offense count: 1
+Lint/BinaryOperatorWithIdenticalOperands:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/converters/attribute_reference.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/transform/helpers_spec.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, AllowComments.
+Lint/EmptyConditionalBody:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/transformer/list_rules.rb'
+    - 'coradoc-html/lib/coradoc/html/converters/bibliography_entry.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowComments.
+Lint/EmptyWhen:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 7
+Lint/IneffectiveAccessModifier:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/spa.rb'
+    - 'coradoc-html/lib/coradoc/html/static.rb'
+    - 'lib/coradoc/configurable.rb'
+
+# Offense count: 4
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/converters/template_html_converter.rb'
+    - 'lib/coradoc/visitor.rb'
+
+# Offense count: 29
+# Configuration parameters: AllowKeywordBlockArguments.
+Lint/UnderscorePrefixedVariableName:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/model/title.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/admonition.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/attribute.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/audio.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/image/core.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/inline/cross_reference.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/inline/quotation.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/list/core.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/list/definition_item.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/list/item.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/paragraph.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/table.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/table_cell.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/title.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/video.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/coradoc/performance_regression.rb'
+    - 'lib/coradoc/query.rb'
+    - 'lib/coradoc/serializer/registry.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, CheckForMethodsWithNoSideEffects.
+Lint/Void:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html.rb'
+
+# Offense count: 240
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 178
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 148
+
+# Offense count: 4
+# Configuration parameters: CountBlocks, CountModifierForms.
+Metrics/BlockNesting:
+  Max: 4
+
+# Offense count: 41
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 556
+
+# Offense count: 191
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 33
+
+# Offense count: 398
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 246
+
+# Offense count: 22
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ModuleLength:
+  Max: 2128
+
+# Offense count: 6
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Max: 8
+  MaxOptionalParameters: 4
+
+# Offense count: 134
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 28
+
+# Offense count: 2
+Naming/AccessorMethodName:
+  Exclude:
+    - 'lib/coradoc/document_manipulator.rb'
+
+# Offense count: 2
+# Configuration parameters: ForbiddenDelimiters.
+# ForbiddenDelimiters: (?i-mx:(^|\s)(EO[A-Z]{1}|END)(\s|$))
+Naming/HeredocDelimiterNaming:
+  Exclude:
+    - '.irbrc'
+    - 'utils/inspect_asciidoc.rb'
+
+# Offense count: 3
+# Configuration parameters: EnforcedStyle, AllowedPatterns, ForbiddenIdentifiers, ForbiddenPatterns.
+# SupportedStyles: snake_case, camelCase
+# ForbiddenIdentifiers: __id__, __send__
+Naming/MethodName:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown.rb'
+
+# Offense count: 18
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
+Naming/MethodParameterName:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/converters/base.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/block_parser.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/inline_parser.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/serializer.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/transform/from_core_model.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/transform/to_core_model.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/transformer.rb'
+    - 'lib/coradoc/lazy.rb'
+
+# Offense count: 13
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicateName:
+  Exclude:
+    - 'spec/**/*'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serialization_context.rb'
+    - 'coradoc-html/lib/coradoc/html/entity.rb'
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/parslet_extras.rb'
+    - 'lib/coradoc/core_model/builder/detection.rb'
+    - 'lib/coradoc/extensions.rb'
+    - 'lib/coradoc/streaming.rb'
+    - 'utils/parser_analyzer.rb'
+
+# Offense count: 3
+# Configuration parameters: EnforcedStyle, AllowedIdentifiers, AllowedPatterns, ForbiddenIdentifiers, ForbiddenPatterns.
+# SupportedStyles: snake_case, camelCase
+Naming/VariableName:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown.rb'
+
+# Offense count: 1
+RSpec/BeforeAfterAll:
+  Exclude:
+    - '**/spec/spec_helper.rb'
+    - '**/spec/rails_helper.rb'
+    - '**/spec/support/**/*.rb'
+    - 'spec/benchmark/performance_spec.rb'
+
+# Offense count: 14
+# Configuration parameters: IgnoredMetadata.
+RSpec/DescribeClass:
+  Exclude:
+    - '**/spec/features/**/*'
+    - '**/spec/requests/**/*'
+    - '**/spec/routing/**/*'
+    - '**/spec/system/**/*'
+    - '**/spec/views/**/*'
+    - 'coradoc-adoc/spec/coradoc/asciidoc/list_continuation_spec.rb'
+    - 'coradoc-adoc/spec/coradoc/asciidoc/parser/parser_spec.rb'
+    - 'coradoc-docx/spec/integration/docx_to_adoc_spec.rb'
+    - 'coradoc-html/spec/coradoc/html/converters/paragraph_e2e_spec.rb'
+    - 'coradoc-html/spec/coradoc/html/output_integration_spec.rb'
+    - 'coradoc-markdown/spec/kramdown_test_suite_spec.rb'
+    - 'coradoc-markdown/spec/model/abbreviation_spec.rb'
+    - 'coradoc-markdown/spec/model/auto_id_spec.rb'
+    - 'coradoc-markdown/spec/model/definition_list_spec.rb'
+    - 'coradoc-markdown/spec/model/footnote_spec.rb'
+    - 'spec/benchmark/performance_spec.rb'
+    - 'spec/coradoc/document_manipulator_spec.rb'
+    - 'spec/integration/cross_format_spec.rb'
+
+# Offense count: 476
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 34
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+RSpec/ExpectActual:
+  Exclude:
+    - '**/spec/routing/**/*'
+    - 'coradoc-markdown/spec/model/abbreviation_spec.rb'
+    - 'spec/plugin_discovery_spec.rb'
+
+# Offense count: 1
+RSpec/IdenticalEqualityAssertion:
+  Exclude:
+    - 'spec/registry_spec.rb'
+
+# Offense count: 38
+# Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
+RSpec/IndexedLet:
+  Exclude:
+    - 'spec/core_model/annotation_block_spec.rb'
+    - 'spec/core_model/base_spec.rb'
+    - 'spec/core_model/block_spec.rb'
+    - 'spec/core_model/image_spec.rb'
+    - 'spec/core_model/inline_element_spec.rb'
+    - 'spec/core_model/list_block_spec.rb'
+    - 'spec/core_model/structural_element_spec.rb'
+    - 'spec/core_model/table_spec.rb'
+    - 'spec/core_model/term_spec.rb'
+    - 'spec/lazy_spec.rb'
+
+# Offense count: 14
+# Configuration parameters: AssignmentOnly.
+RSpec/InstanceVariable:
+  Exclude:
+    - 'spec/input_spec.rb'
+    - 'spec/output_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+RSpec/IteratedExpectation:
+  Exclude:
+    - 'spec/plugin_discovery_spec.rb'
+
+# Offense count: 5
+RSpec/LeakyConstantDeclaration:
+  Exclude:
+    - 'spec/transform/helpers_spec.rb'
+
+# Offense count: 8
+# Configuration parameters: .
+# SupportedStyles: have_received, receive
+RSpec/MessageSpies:
+  EnforcedStyle: receive
+
+# Offense count: 30
+RSpec/MultipleDescribes:
+  Enabled: false
+
+# Offense count: 599
+RSpec/MultipleExpectations:
+  Max: 12
+
+# Offense count: 1
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 7
+
+# Offense count: 14
+# Configuration parameters: EnforcedStyle, IgnoreSharedExamples.
+# SupportedStyles: always, named_only
+RSpec/NamedSubject:
+  Exclude:
+    - 'coradoc-markdown/spec/parser/markdown/atx_headings_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown/block_quotes_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown/indented_code_blocks_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown/setext_headings_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown/thematic_breaks_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown_spec.rb'
+    - 'spec/visitor_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedGroups.
+RSpec/NestedGroups:
+  Max: 4
+
+# Offense count: 4
+# Configuration parameters: AllowedPatterns.
+# AllowedPatterns: ^expect_, ^assert_
+RSpec/NoExpectationExample:
+  Exclude:
+    - 'coradoc-html/spec/coradoc/html/converters/paragraph_e2e_spec.rb'
+    - 'coradoc-markdown/spec/parser/markdown_spec.rb'
+    - 'spec/streaming_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedDescription:
+  Exclude:
+    - 'coradoc-markdown/spec/kramdown_test_suite_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExample:
+  Exclude:
+    - 'coradoc-html/spec/coradoc/html/converters/paragraph_e2e_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExampleGroupDescription:
+  Exclude:
+    - 'spec/coradoc/cli/cli_spec.rb'
+
+# Offense count: 73
+# Configuration parameters: Include, CustomTransform, IgnoreMethods, IgnoreMetadata.
+# Include: **/*_spec.rb
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+# Offense count: 58
+# Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
+RSpec/VerifiedDoubles:
+  Exclude:
+    - 'coradoc-adoc/spec/coradoc/asciidoc/parse_error_spec.rb'
+    - 'spec/core_model/base_spec.rb'
+    - 'spec/lazy_spec.rb'
+    - 'spec/query_spec.rb'
+    - 'spec/streaming_spec.rb'
+    - 'spec/transform/helpers_spec.rb'
+    - 'spec/validation_spec.rb'
+
+# Offense count: 1
+Security/MarshalLoad:
+  Exclude:
+    - 'lib/coradoc/transformation_cache.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowOnConstant, AllowOnSelfClass.
+Style/CaseEquality:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/model/attribute_list.rb'
+    - 'coradoc-adoc/lib/coradoc/asciidoc/model/attribute_list/matchers.rb'
+
+# Offense count: 2
+Style/ClassVars:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/element_registry.rb'
+    - 'coradoc-html/lib/coradoc/html/input/converters.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, SingleLineConditionsOnly, IncludeTernaryExpressions.
+# SupportedStyles: assign_to_condition, assign_inside_condition
+Style/ConditionalAssignment:
+  Exclude:
+    - 'coradoc-markdown/lib/coradoc/markdown/parser/ast_processor.rb'
+
+# Offense count: 289
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, EnforcedStyle, AllowComments.
+# SupportedStyles: empty, nil, both
+Style/EmptyElse:
+  Exclude:
+    - 'coradoc-docx/lib/coradoc/docx/transform/rules/bookmark_rule.rb'
+    - 'coradoc-html/lib/coradoc/html/input/converters/text.rb'
+    - 'lib/coradoc/core_model/toc_generator.rb'
+
+# Offense count: 13
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, MaxUnannotatedPlaceholdersAllowed, Mode, AllowedMethods, AllowedPatterns.
+# SupportedStyles: annotated, template, unannotated
+Style/FormatStringToken:
+  Exclude:
+    - 'coradoc-html/lib/coradoc/html/theme/modern/tailwind_config_builder.rb'
+    - 'lib/coradoc/performance_regression.rb'
+
+# Offense count: 8
+# Configuration parameters: AllowedVariables.
+Style/GlobalVars:
+  Exclude:
+    - 'utils/parser_analyzer.rb'
+
+# Offense count: 5
+# Configuration parameters: MinBranchesCount.
+Style/HashLikeCase:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/model/table_cell.rb'
+    - 'coradoc-html/lib/coradoc/html/input/converters/table.rb'
+    - 'coradoc-html/lib/coradoc/html/input/converters/td.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/parser/content.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantAssignment:
+  Exclude:
+    - 'lib/coradoc/normalize.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: Mode.
+Style/StringConcatenation:
+  Exclude:
+    - 'coradoc-adoc/lib/coradoc/asciidoc/serializer/serializers/document_attributes.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    - 'lib/coradoc/core_model/block.rb'
+    - 'lib/coradoc/core_model/inline_element.rb'
+    - 'lib/coradoc/core_model/list_item.rb'
+    - 'lib/coradoc/core_model/table.rb'
+
+# Offense count: 29
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 235

data/.ruby-version

@@ -0,0 +1 @@
+3.4.2

data/CLAUDE.md

@@ -0,0 +1,82 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Coradoc is a Ruby hub-and-spoke document transformation library. A canonical `CoreModel` serves as the central hub, and format-specific gems (AsciiDoc, HTML, Markdown) are spokes. Adding a new format requires only two transformers (ToCoreModel, FromCoreModel).
+
+## Monorepo Structure
+
+- **`lib/coradoc/`** — Core gem: `CoreModel`, `Registry`, `Transform::Base`, hooks, validation, streaming, query API
+- **`coradoc-adoc/`** — AsciiDoc gem: Parslet-based parser, document model, serializer, transformer (ToCoreModel/FromCoreModel)
+- **`coradoc-html/`** — HTML gem: Nokogiri-based converter, classic renderer, Vue.js SPA theme
+- **`coradoc-markdown/`** — Markdown gem: Parslet-based CommonMark parser, document model, serializer
+
+Each sub-gem has its own gemspec, `lib/`, and `spec/` directory. All are loaded together via the root `Gemfile` using `path:` references.
+
+## Build & Test Commands
+
+```bash
+bundle install              # Install dependencies (all gems together)
+
+# Tests
+bundle exec rspec                          # Run main gem tests
+bundle exec rspec spec/coradoc/            # Run specific directory
+bundle exec rspec spec/coradoc/query_spec.rb  # Run single test file
+bundle exec rspec spec/coradoc/query_spec.rb:42  # Run single test (by line)
+bundle exec rake spec_all                  # Run ALL gem specs (main + sub-gems)
+bundle exec rake spec:coradoc_adoc         # Run only coradoc-adoc specs
+bundle exec rake spec:coradoc_html         # Run only coradoc-html specs
+bundle exec rake spec:coradoc_markdown     # Run only coradoc-markdown specs
+
+# Linting
+bundle exec rubocop
+
+# Console
+bundle exec rake console     # IRB with coradoc preloaded
+```
+
+## Architecture
+
+### CoreModel (`lib/coradoc/core_model.rb`)
+
+The canonical document representation using `lutaml-model`. Key types: `StructuralElement`, `Block`, `ListBlock`, `ListItem`, `InlineElement`, `Table`, `Image`, `Metadata`, `Footnote`, `DefinitionList`, `Bibliography`. All inherit from `CoreModel::Base`.
+
+### Transformation Flow
+
+```
+Source text → Format::Parser → Format Model → ToCoreModel → CoreModel → FromCoreModel → Target Model → Serialize → Target text
+```
+
+- `Coradoc.convert(text, from: :asciidoc, to: :html)` — end-to-end conversion
+- `Coradoc.parse(text, format:)` — parse to CoreModel
+- `Coradoc.serialize(core, to:)` — serialize CoreModel to output
+
+### Format Registration
+
+Format gems register via `Coradoc.register_format(:name, Module)` and must implement `parse_to_core`/`parse` and `serialize`. The `Registry` class in `lib/coradoc/registry.rb` manages this.
+
+### AsciiDoc Gem Internals
+
+- **Parser** (`coradoc-adoc/lib/coradoc/asciidoc/parser/`) — Parslet-based, rule files: `header`, `inline`, `block`, `list`, `section`, `table`, `bibliography`, `citation`, `stem`, `admonition`
+- **Model** (`coradoc-adoc/lib/coradoc/asciidoc/model/`) — ~40+ model classes inheriting from `Model::Base`, built with `lutaml-model`
+- **Serializer** (`coradoc-adoc/lib/coradoc/asciidoc/serializer/`) — Converts AsciiDoc models back to `.adoc` strings via element-specific serializer classes
+- **Transformer** (`coradoc-adoc/lib/coradoc/asciidoc/transformer.rb`) — Parslet `Transform` subclass with rule modules (HeaderRules, InlineRules, etc.)
+- **Transform** (`coradoc-adoc/lib/coradoc/asciidoc/transform/`) — `ToCoreModel` and `FromCoreModel` with registration-based dispatch
+
+### Key Dependencies
+
+- `lutaml-model` — serialization framework for model classes (used by CoreModel and AsciiDoc model)
+- `parslet` — PEG parser (used by AsciiDoc and Markdown parsers)
+- `nokogiri` — HTML parsing (used by HTML gem)
+- `thor` — CLI framework
+
+## Conventions
+
+- **Model classes own only their native format**: No `to_adoc` in Markdown models, no `to_md` in AsciiDoc models. Cross-format conversion always routes through CoreModel transformers (ToCoreModel / FromCoreModel). This enforces SRP, OCP, and DIP.
+- **Autoload over require_relative**: Use `autoload` with `#{__dir__}` paths (see `core_model.rb` for pattern). Exception: files with load-time side effects (registrations, `apply` calls) use `require_relative`.
+- **Error-raising in serializers**: Unknown types in `serialize_content` should raise `ArgumentError`, never fall back to `to_s`. This catches missing serializers immediately rather than producing Ruby object dumps.
+- **Ruby 3.1+ target**, `TargetRubyVersion: 3.1` in RuboCop.
+- RSpec uses `--format documentation`, `--color`, `expect` syntax, `disable_monkey_patching!`.
+- Benchmark tests are excluded unless `BENCHMARK=true`.