coradoc-mirror 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e474854dfc3ccc3cb6edce0dce14958aa962cfd87d40ce77a530348d6f7488b
-  data.tar.gz: 50b26a4e35effc7a2065e06a739eb3ca4bfc62ccf1b0242987c8d29f42a9722b
+  metadata.gz: 000b9fd36ba19db9a57b3ad656292b1629eb82a12e7004add2e97b7823060e19
+  data.tar.gz: f5364e581508705701aac01de53a2d03371213a4224356d4343f197aa37edab0
 SHA512:
-  metadata.gz: 6dee99c97897a0a65cf8667b5b78ee6ac549511b5e16208454b467955baf8f48030fcfe724120f4f42ec183521c61660811cd89be834c46be8deee0994052c68
-  data.tar.gz: 94c0a6bcb1e973cea8fee23324a7f4d4eaa70673c1400313da931c7a2eab0132facc7d7356cbb9f639c3895a67cf1f968f6df08c12d43fc23db1db202c2c8045
+  metadata.gz: 8bcd0570c09daf184700080579a5cb17c54a2cccc16d8afb95b3f0598d644d5f5b14790c81024fafdb8306720170ae1e9ddeda893f111446e854b03effcb6826
+  data.tar.gz: f40e562805ca5466db7847773f7386c8709471c8aa4acbfbc4971db7e8255ede4b32e54b42cec361fa517cd31b1fbed1f283e6c01c3efadcf29ea1b33e75112f

data/lib/coradoc/mirror/handlers/include.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Coradoc
+  module Mirror
+    module Handlers
+      # Include directive handler.
+      #
+      # Emits a ProseMirror-compatible +include+ node carrying the
+      # target path and parsed options as typed attrs. Graph-mode
+      # preservation: the node survives serialization and round-trips
+      # back to a +CoreModel::Include+ via the reverse builder.
+      module Include
+        def self.call(element, context:)
+          Node::Include.new(attrs: build_attrs(element))
+        end
+
+        class << self
+          private
+
+          def build_attrs(element)
+            options = element.options
+            Node::Include::Attrs.new(
+              target: element.target,
+              tags: tags_value(options),
+              lines: options&.lines_spec,
+              leveloffset: leveloffset_value(options),
+              indent: options&.indent,
+              file_encoding: options&.file_encoding,
+              raw_options: element.raw_options
+            )
+          end
+
+          def tags_value(options)
+            return [] unless options
+
+            options.tags
+          end
+
+          def leveloffset_value(options)
+            return nil unless options&.leveloffset
+
+            options.leveloffset.to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/coradoc/mirror/handlers.rb

@@ -33,6 +33,7 @@ module Coradoc
       autoload :Toc, "#{__dir__}/handlers/toc"
       autoload :Frontmatter, "#{__dir__}/handlers/frontmatter"
       autoload :GenericBlock, "#{__dir__}/handlers/generic_block"
+      autoload :Include, "#{__dir__}/handlers/include"
     end
   end
 end

data/lib/coradoc/mirror/node.rb

@@ -512,6 +512,40 @@ module Coradoc
         end
       end
 
+      # Include directive node — a text-graph edge pointing at another file.
+      # Graph mode emits this; flat mode (ResolveIncludes) replaces it with
+      # the included subtree before serialization.
+      class Include < Node
+        PM_TYPE = 'include'
+
+        class Attrs < Lutaml::Model::Serializable
+          attribute :target, :string
+          attribute :tags, :string, collection: true
+          attribute :lines, :string
+          attribute :leveloffset, :string
+          attribute :indent, :integer
+          attribute :file_encoding, :string
+          attribute :raw_options, :string
+
+          key_value do
+            map 'target', to: :target
+            map 'tags', to: :tags
+            map 'lines', to: :lines
+            map 'leveloffset', to: :leveloffset
+            map 'indent', to: :indent
+            map 'encoding', to: :file_encoding
+            map 'raw_options', to: :raw_options
+          end
+        end
+
+        attribute :attrs, Attrs
+
+        key_value do
+          map 'type', to: :type, render_default: true
+          map 'attrs', to: :attrs
+        end
+      end
+
       # ── Tables ──
 
       class Table < Node

data/lib/coradoc/mirror/reverse_builder.rb

@@ -386,6 +386,43 @@ module Coradoc
         end
       end
 
+      # Include directive: round-trips back to a CoreModel::Include link
+      # node. The text graph is preserved through mirror_json → core.
+      class Include < Base
+        registers 'include'
+
+        def build(node)
+          attrs = node.attrs
+          CoreModel::Include.new(
+            target: attrs&.target,
+            options: build_options(attrs),
+            raw_options: attrs&.raw_options || ''
+          )
+        end
+
+        private
+
+        def build_options(attrs)
+          return CoreModel::IncludeOptions.new unless attrs
+
+          CoreModel::IncludeOptions.new(
+            tags: Array(attrs.tags),
+            tags_wildcard: attrs.tags == ['*'],
+            tags_inverted: attrs.tags == ['**'],
+            lines_spec: attrs.lines,
+            leveloffset: parse_leveloffset(attrs.leveloffset),
+            indent: attrs.indent,
+            file_encoding: attrs.file_encoding
+          )
+        end
+
+        def parse_leveloffset(raw)
+          return nil if raw.nil? || raw.to_s.empty?
+
+          Coradoc::CoreModel::IncludeLevelOffset.parse(raw.to_s)
+        end
+      end
+
       # ── Tables ──
 
       class Table < Base

data/lib/coradoc/mirror/version.rb

@@ -2,6 +2,6 @@
 
 module Coradoc
   module Mirror
-    VERSION = '0.1.3'
+    VERSION = '0.1.4'
   end
 end

data/lib/coradoc/mirror.rb

@@ -111,6 +111,9 @@ module Coradoc
       # ── Frontmatter ──
       registry.register(CoreModel::FrontmatterBlock, Handlers::Frontmatter)
 
+      # ── Include directive (text-graph edge) ──
+      registry.register(CoreModel::Include, Handlers::Include)
+
       # ── Generic Block (catch-all for unrecognized block types) ──
       registry.register(CoreModel::Block, Handlers::GenericBlock)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coradoc-mirror
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Ribose Inc.
@@ -93,6 +93,7 @@ files:
 - lib/coradoc/mirror/handlers/generic_block.rb
 - lib/coradoc/mirror/handlers/horizontal_rule.rb
 - lib/coradoc/mirror/handlers/image.rb
+- lib/coradoc/mirror/handlers/include.rb
 - lib/coradoc/mirror/handlers/inline.rb
 - lib/coradoc/mirror/handlers/list.rb
 - lib/coradoc/mirror/handlers/open_block.rb