sevgi-graphics 0.98.2 → 1.1.0

data/lib/sevgi/graphics/element.rb

@@ -6,16 +6,18 @@ module Sevgi
     #
     # @!method self.valid?(name)
     #   Reports whether a candidate can dispatch as an SVG element name.
-    #   With Standard loaded, the name must be known; standalone Graphics accepts any valid XML name.
+    #   With Standard loaded, the name must be known. Standalone Graphics accepts any valid XML name.
     #   @param name [Object] candidate element name
     #   @return [Boolean]
     #
     # Dynamic SVG element methods accept text, content objects, and any number of attribute Hashes in one call. Hashes
-    # are applied from left to right; later values replace earlier values unless their names use the `+` update suffix.
+    # are applied from left to right. Later values replace earlier values unless their names use the `+` update suffix.
+    # Ordinary `dup` and `clone` create independent subtrees, preserve IDs, and detach non-root copies from their parent.
+    # Document copies remain roots. Use `Duplicate` for DSL-specific ID remapping and attachment.
     class Element
       # Builds an element node.
       # @param name [Symbol, String] SVG element name
-      # @param arguments [Array<Hash, String, Sevgi::Graphics::Content>] ordered content and attribute channels; every
+      # @param arguments [Array<Hash, String, Sevgi::Graphics::Content>] ordered content and attribute channels. Every
       #   Hash is applied through {Sevgi::Graphics::Attributes} from left to right
       # @param parent [Sevgi::Graphics::Element] parent element
       # @yield evaluates the drawing DSL in the new element
@@ -178,9 +180,25 @@ module Sevgi
         instance_exec(&block) if block
       end
 
+      # Copies owned storage and reconnects child copies without attaching to the source tree.
+      # @param original [Sevgi::Graphics::Element] source node
+      # @return [void]
+      # @api private
+      def initialize_copy(original)
+        super
+        @parent = Element.root?(original) ? RootParent : DetachedParent
+        @attributes = original.attributes.dup
+        @contents = original.contents.map(&:dup)
+        @children = original.children.map do |child|
+          child.dup.tap { it.instance_variable_set(:@parent, self) }
+        end
+      end
+
+      private :initialize_copy
+
       # Dispatches SVG element DSL calls and caches valid element methods.
       # @param name [Symbol] missing method name
-      # @param arguments [Array<Hash, String, Sevgi::Graphics::Content>] ordered content and attribute channels; later
+      # @param arguments [Array<Hash, String, Sevgi::Graphics::Content>] ordered content and attribute channels. Later
       #   Hashes replace or update attributes assigned by earlier Hashes
       # @yield evaluates the drawing DSL in the dispatched child element
       # @yieldreturn [Object] ignored block result
@@ -232,7 +250,7 @@ module Sevgi
 
         # Parses element DSL arguments.
         # @param name [Symbol] SVG element name
-        # @param args [Array<Object>] positional DSL arguments; Hashes are imported from left to right
+        # @param args [Array<Object>] positional DSL arguments. Hashes are imported from left to right
         # @return [Hash] parsed :attributes and :contents
         # @raise [Sevgi::ArgumentError] when an argument is not a Hash, String, or Content
         def parse(name, *args)
@@ -257,9 +275,6 @@ module Sevgi
 
       private_constant :Dispatch
 
-      protected
-
-      attr_writer :attributes, :children, :contents, :parent
     end
   end
 end

data/lib/sevgi/graphics/mixtures/call.rb

@@ -4,10 +4,10 @@ module Sevgi
   module Graphics
     # Callable drawing module support.
     # Extend a plain Ruby module with this API to make its public instance methods callable drawing steps. Name the
-    # method `call` when the module has a single drawing step; use descriptive method names when it has multiple steps.
+    # method `call` when the module has a single drawing step. Use descriptive method names for multiple steps.
     # Base blocks add argument-independent shared SVG content once per invocation before the public drawing methods.
-    # Invocation does not change the configured module, so it may be frozen after its drawing steps are defined. A
-    # duplicate or clone owns an independent configuration snapshot; freezing a callable module prevents later base
+    # Invocation does not change the configured module, so it can be frozen after its drawing steps are defined. A
+    # duplicate or clone owns an independent configuration snapshot. Freezing a callable module prevents later base
     # registration while leaving invocation available.
     # @example Define and call a drawing module
     #   Widget = Module.new do
@@ -73,8 +73,9 @@ module Sevgi
 
       # Registers argument-independent shared drawing steps. Every invocation runs inherited base blocks parent-first,
       # then locally registered base blocks in registration order, before the module's public drawing methods. The block
-      # runs once in the current element context and does not receive the invocation arguments.
-      # @yield evaluates the drawing DSL in the current element context
+      # runs once on the callable receiver, which delegates drawing words to the current SVG element. It receives no
+      # invocation arguments. Callable methods receive those arguments and the caller's block unchanged.
+      # @yield evaluates shared drawing steps on the callable receiver
       # @yieldreturn [Object] ignored block result
       # @return [nil]
       # @raise [Sevgi::ArgumentError] when no block is given
@@ -133,7 +134,7 @@ module Sevgi
           invoke(context, receiver, methods, ...)
         end
 
-        # Returns the methods that should be executed for a callable module.
+        # Returns the executable drawing methods for a callable module.
         # @param mod [Module] module extended with {Sevgi::Graphics::Module}
         # @return [Array<UnboundMethod>]
         # @raise [Sevgi::ArgumentError] when mod is not a callable drawing module
@@ -173,26 +174,12 @@ module Sevgi
 
       private
 
-      # Gives a duplicated callable module independent configuration containers.
+      # Gives a copied callable module independent configuration containers.
       # @param original [Module] source callable module
       # @return [void]
       # @api private
-      def initialize_dup(original)
+      def initialize_copy(original)
         super
-        copy_configuration(original)
-      end
-
-      # Gives a cloned callable module independent configuration containers.
-      # @param original [Module] source callable module
-      # @param freeze [Boolean] whether Ruby preserves the source frozen state
-      # @return [void]
-      # @api private
-      def initialize_clone(original, freeze: true)
-        super
-        copy_configuration(original)
-      end
-
-      def copy_configuration(original)
         @sevgi_bases = original.instance_variable_get(:@sevgi_bases).dup
         @sevgi_callables = original.instance_variable_get(:@sevgi_callables).dup
         @sevgi_configuration_owner = object_id
@@ -216,8 +203,6 @@ module Sevgi
         own_configuration
         @sevgi_callables << method
       end
-
-      private :copy_configuration, :own_configuration
     end
 
     # Recursive callable drawing module support. Extend a module with this API when it and the modules defined beneath

data/lib/sevgi/graphics/mixtures/core.rb

@@ -93,24 +93,19 @@ module Sevgi
           tap { Adoption.batch(elements, self, front: false) }
         end
 
+        # Returns distinct CSS class names without changing this element.
+        # An absent class attribute returns an empty Array. Strings are split on whitespace and nested Arrays are flattened.
+        # @return [Array<String>] owned class-name snapshot in rendered order
+        # @see #Classify
+        def Classes = Attribute.classes(self[:class])
+
         # Adds CSS classes without duplicating existing values.
-        # @param classes [Array<String, Symbol, Array>] class tokens; strings are split on whitespace
+        # @param classes [Array<String, Symbol, Array>] class tokens. Strings are split on whitespace
         # @return [Sevgi::Graphics::Element] self
+        # @raise [Sevgi::ArgumentError] when a class value is invalid, cyclic, or cannot be stringified as XML
+        # @see #Classes
         def Classify(*classes)
-          tap do
-            tokens = proc do |value|
-              case value
-              when nil
-                []
-              when ::Array
-                value.flat_map { tokens.call(it) }
-              else
-                value.to_s.split
-              end
-            end
-
-            self[:class] = [*tokens.call(self[:class]), *tokens.call(classes)].uniq
-          end
+          tap { self[:class] = Attribute.classes(self[:class], classes) }
         end
 
         # Assigns default attributes only when they are absent.
@@ -128,7 +123,7 @@ module Sevgi
 
         # Builds a child element with an explicit tag name.
         # @param tag [Symbol, String] SVG tag name
-        # @param contents [Array<Object>] text or content objects; non-content objects are stringified and XML-encoded
+        # @param contents [Array<Object>] text or content objects. Non-content objects are stringified and XML-encoded
         # @param attributes [Hash] SVG attributes
         # @yield evaluates the drawing DSL in the new child element
         # @yieldreturn [Object] ignored block result
@@ -176,7 +171,7 @@ module Sevgi
         end
 
         # Returns the topmost element in this tree.
-        # A detached subtree returns its detached topmost element; use {#Root?} to distinguish a document root.
+        # A detached subtree returns its detached topmost element. Use {#Root?} to distinguish a document root.
         # @return [Sevgi::Graphics::Element] document root or detached topmost element
         def Root
           element = self
@@ -283,7 +278,7 @@ module Sevgi
         # Appends an element as a child.
         # @param element [Sevgi::Graphics::Element] element to append
         # @return [Sevgi::Graphics::Element] self
-        # @raise [Sevgi::ArgumentError] when the element has a different concrete class or would create a tree cycle
+        # @raise [Sevgi::ArgumentError] when the element has a different concrete class or creates a tree cycle
         def <<(element)
           Append(element)
         end
@@ -296,7 +291,7 @@ module Sevgi
           # @param parent [Sevgi::Graphics::Element] target parent
           # @param front [Boolean] whether to prepend instead of append
           # @return [void]
-          # @raise [Sevgi::ArgumentError] when an argument is incompatible, repeated, or would create a cycle
+          # @raise [Sevgi::ArgumentError] when an argument is incompatible, repeated, or creates a cycle
           def self.batch(elements, parent, front:)
             validate_batch(elements, parent)
 
@@ -307,11 +302,11 @@ module Sevgi
             end
           end
 
-          # Rejects target parents that would create a cycle.
+          # Rejects target parents that create a cycle.
           # @param element [Sevgi::Graphics::Element] element being moved
           # @param parent [Sevgi::Graphics::Element, Object] target parent
           # @return [void]
-          # @raise [Sevgi::ArgumentError] when the parent is incompatible or would create a cycle
+          # @raise [Sevgi::ArgumentError] when the parent is incompatible or creates a cycle
           def self.validate(element, parent)
             unless element.instance_of?(parent.class)
               ArgumentError.("Element type does not match the new parent type: #{element.class}")
@@ -347,8 +342,9 @@ module Sevgi
           # @param index [Integer] requested insertion index
           # @return [Integer] normalized insertion index
           def self.index_for(element, parent, index)
-            same_parent = element.parent.equal?(parent) && parent.children.include?(element)
-            index(index, parent.children.size - (same_parent ? 1 : 0))
+            children = Element.send(:tree_children, parent)
+            same_parent = element.parent.equal?(parent) && children.include?(element)
+            index(index, children.size - (same_parent ? 1 : 0))
           end
 
           def self.validate_batch(elements, parent)

data/lib/sevgi/graphics/mixtures/duplicate.rb

@@ -10,8 +10,9 @@ module Sevgi
         # moved to non-rendering `-id` metadata before the optional block runs, allowing the block to derive replacement
         # ids without rendering duplicates. A pre-existing `-id` takes precedence over the visible id.
         # Translation and parent channels are validated before the subtree is copied or the customization block runs.
-        # @param dx [Numeric, nil] finite x translation; nil omits the axis
-        # @param dy [Numeric, nil] finite y translation; nil omits the axis
+        # The copied subtree has no parent during customization and is attached to the target parent afterward.
+        # @param dx [Numeric, nil] finite x translation. Nil omits the axis
+        # @param dy [Numeric, nil] finite y translation. Nil omits the axis
         # @param parent [Sevgi::Graphics::Element, nil] explicit parent, or the source parent when nil
         # @yield [element] optional customization hook for each copied element
         # @yieldparam element [Sevgi::Graphics::Element] copied element
@@ -27,7 +28,7 @@ module Sevgi
         #   end
         def Duplicate(dx: nil, dy: nil, parent: nil, &block)
           dx, dy, target = Subtree.channels(self, dx, dy, parent)
-          duplicated = Subtree.copy(self)
+          duplicated = dup
           Subtree.prepare(duplicated, &block)
           Subtree.translate(duplicated, dx, dy)
           Subtree.attach(duplicated, target)
@@ -80,19 +81,6 @@ module Sevgi
             [dx, dy, target]
           end
 
-          # Builds an independent copy of an element subtree.
-          # @param element [Sevgi::Graphics::Element] source subtree root
-          # @param parent [Sevgi::Graphics::Element, Object] parent for the copied root
-          # @return [Sevgi::Graphics::Element] copied subtree root
-          def self.copy(element, parent = Element.send(:tree_parent, element))
-            element.dup.tap do |duplicated|
-              duplicated.send(:parent=, parent)
-              duplicated.send(:attributes=, element.attributes.dup)
-              duplicated.send(:contents=, element.contents.map(&:dup))
-              duplicated.send(:children=, element.children.map { |child| copy(child, duplicated) })
-            end
-          end
-
           # Removes copied public ids and applies an optional customization hook.
           # @api private
           def self.prepare(element, &block)

data/lib/sevgi/graphics/mixtures/export.rb

@@ -4,11 +4,13 @@ module Sevgi
   module Graphics
     module Mixtures
       # DSL helpers for native SVG export formats.
+      # Export CSS is a late adjustment after document checks. Its supported XML endings and cascade limitations are
+      # documented in {Sevgi::Sundries::Export}. The source callback receives SVG after CSS insertion.
       module Export
         # Validates the closed export option channel before optional components load or rendering starts.
         # @api private
         module Options
-          KEYS = %i[css default dpi height width].freeze
+          KEYS = %i[css default dpi fallback height style width].freeze
           private_constant :KEYS
 
           # Returns validated export options.
@@ -34,6 +36,8 @@ module Sevgi
         # @option kwargs [Numeric, nil] :height finite positive target height in CSS pixels
         # @option kwargs [Numeric] :dpi (96.0) finite positive CSS pixel density
         # @option kwargs [String, nil] :css CSS inserted before rendering
+        # @option kwargs [Hash, nil] :style (document Style) producer declaration
+        # @option kwargs [Boolean] :fallback (true) warn and use ordinary PDF after preparation failure
         # @yield [svg] transforms SVG source before rendering
         # @yieldparam svg [String] rendered SVG source
         # @yieldreturn [String] transformed SVG source
@@ -44,6 +48,7 @@ module Sevgi
         # @raise [Sevgi::MissingComponentError] when sevgi/sundries is unavailable
         # @raise [Sevgi::MissingComponentError] when native export gems are unavailable
         # @raise [Sevgi::Sundries::Export::ExportError] when native export fails
+        # @raise [Sevgi::Sundries::Mainz::Error] when required preparation cannot complete
         # @raise [SystemCallError] when the output directory or file cannot be created or written
         def PDF(path = nil, **kwargs, &block)
           kwargs = Options.(kwargs)
@@ -56,6 +61,7 @@ module Sevgi
             MissingComponentError.("sevgi/sundries")
           end
 
+          kwargs[:style] = self.Style unless kwargs.key?(:style) || self.Style.nil?
           Export(path, **kwargs, format: :pdf, &block)
         end
 
@@ -102,7 +108,7 @@ module Sevgi
             default = F.subext(extension, caller_locations(2..2).first.path)
           end
 
-          path = Path.resolve(path, default:, context: "Export")
+          path = F.output_path(path, default:, context: "Export")
 
           Sundries::Export.(call, path, **kwargs, &block)
         end

data/lib/sevgi/graphics/mixtures/hatch.rb

@@ -6,10 +6,10 @@ module Sevgi
       # DSL helpers for drawing geometry values and geometry-derived hatch lines.
       #
       # `Draw` delegates to each geometry object's drawing protocol. `Hatch`
-      # first sweeps interior spans through a closed lined element, then draws
-      # them. Its `angle` describes line direction; `step` is perpendicular
+      # first sweeps interior spans through a closed geometry element, then draws
+      # them. Its `angle` describes line direction. `step` is perpendicular
       # spacing. The default initial line passes through `element.position`.
-      # The built-in `:inkscape` document profile includes this mixture;
+      # The built-in `:inkscape` document profile includes this mixture.
       # `:minimal`, `:default`, and `:html` do not.
       #
       # Hatch materializes separate finite SVG path elements. When only a repeated visual fill matters, use an SVG
@@ -52,7 +52,7 @@ module Sevgi
         #   Sevgi::Graphics.SVG(:inkscape) do
         #     Hatch region, initial: [2, 8], angle: 0, step: 3
         #   end
-        # @param element [Sevgi::Geometry::Element::Lined] lined geometry element to sweep
+        # @param element [Sevgi::Geometry::Element] geometry element to sweep
         # @param angle [Numeric] hatch angle in degrees
         # @param step [Numeric] distance between hatch lines
         # @param initial [Sevgi::Geometry::Point, Array<Numeric>, nil] initial sweep point, or nil for element.position
@@ -72,7 +72,7 @@ module Sevgi
             MissingComponentError.("sevgi/geometry")
           end
 
-          initial = element.position if initial.nil? && element.is_a?(Geometry::Element::Lined)
+          initial = element.position if initial.nil? && element.is_a?(Geometry::Element)
           Draw(Geometry::Operation.sweep!(element, initial:, angle:, step:), **kwargs)
         end
       end

data/lib/sevgi/graphics/mixtures/identify.rb

@@ -6,7 +6,7 @@ module Sevgi
       # DSL helpers for collecting and hiding SVG ids.
       module Identify
         # Immutable snapshot of every rendered element id under a subtree. Keys are the serialized id values, including
-        # `"false"` and the empty String. Keys and containers are owned by the index; values retain references to the
+        # `"false"` and the empty String. Keys and containers are owned by the index. Values retain references to the
         # elements present when the snapshot is built. Later tree changes require a new index.
         class Identifiers
           # @return [Sevgi::Graphics::Element] indexed root element

data/lib/sevgi/graphics/mixtures/inkscape.rb

@@ -48,7 +48,7 @@ module Sevgi
         #   Sevgi::Graphics.SVG(:inkscape) { Group drawing, attributes: {id: "drawing"} }
         # @param mod [Module] module extended with {Sevgi::Graphics::Module}
         # @param args [Array<Object>] callable arguments
-        # @param attributes [Hash] group attributes; String and Symbol names are normalized and must not collide
+        # @param attributes [Hash] group attributes. String and Symbol names are normalized and must not collide
         # @param kwargs [Hash] callable keyword arguments
         # @yield forwards customization to the callable module
         # @yieldreturn [Object] callable customization result
@@ -65,7 +65,7 @@ module Sevgi
         # Named modules default the layer id to their final constant name. Anonymous modules omit the id unless supplied.
         # @param mod [Module] module extended with {Sevgi::Graphics::Module}
         # @param args [Array<Object>] callable arguments
-        # @param attributes [Hash] layer attributes; String and Symbol names are normalized and must not collide
+        # @param attributes [Hash] layer attributes. String and Symbol names are normalized and must not collide
         # @param kwargs [Hash] callable keyword arguments
         # @yield forwards customization to the callable module
         # @yieldreturn [Object] callable customization result
@@ -82,7 +82,7 @@ module Sevgi
         # Named modules default the layer id to their final constant name. Anonymous modules omit the id unless supplied.
         # @param mod [Module] module extended with {Sevgi::Graphics::Module}
         # @param args [Array<Object>] callable arguments
-        # @param attributes [Hash] layer attributes; String and Symbol names are normalized and must not collide
+        # @param attributes [Hash] layer attributes. String and Symbol names are normalized and must not collide
         # @param kwargs [Hash] callable keyword arguments
         # @yield forwards customization to the callable module
         # @yieldreturn [Object] callable customization result
@@ -163,7 +163,7 @@ module Sevgi
             def channels(namedview, page)
               ArgumentError.("Namedview attributes must be a Hash") unless namedview.is_a?(::Hash)
               ArgumentError.("Page attributes must be a Hash") unless page.is_a?(::Hash)
-              [Attribute.defaults(namedview, id: "namedview"), Attribute.normalize(page)]
+              [Attribute.defaults(namedview, id: "namedview"), page_attributes(page)]
             end
 
             # Normalizes one explicit or generated page id.
@@ -181,7 +181,7 @@ module Sevgi
             # @api private
             def normalize(attributes, defaults, index)
               ArgumentError.("Page #{index + 1} must be a Hash") unless attributes.is_a?(::Hash)
-              attributes = defaults.merge(Attribute.normalize(attributes))
+              attributes = defaults.merge(page_attributes(attributes))
               %i[x y].each { number(attributes, it, index) }
               %i[width height].each do |field|
                 number(attributes, field, index, positive: true)
@@ -190,6 +190,19 @@ module Sevgi
               identify(attributes, index)
             end
 
+            # Coerces numeric page fields before attribute snapshots stringify mutable numeric subclasses.
+            def page_attributes(attributes)
+              Attribute.normalize(
+                attributes.to_h do |key, value|
+                  if %w[x y width height].include?(key.to_s) && value.is_a?(::Numeric)
+                    value = Scalar.number(value, context: "page", field: key)
+                  end
+
+                  [key, value]
+                end
+              )
+            end
+
             # Validates and normalizes page-grid arguments.
             # @return [Array<(Integer, Float)>] normalized width, height, and gap
             # @raise [Sevgi::ArgumentError] when a count, dimension, or gap is invalid
@@ -239,9 +252,9 @@ module Sevgi
         #       page: {class: "print"}
         #     )
         #   end
-        # @param pages [Array<Hash>] page attribute hashes; numeric page fields are normalized to SVG numbers
-        # @param namedview [Hash] namedview attributes; String and Symbol names are normalized and must not collide
-        # @param page [Hash] page defaults; normalized page attributes override these defaults by name
+        # @param pages [Array<Hash>] page attribute hashes. Numeric page fields are normalized to SVG numbers
+        # @param namedview [Hash] namedview attributes. String and Symbol names are normalized and must not collide
+        # @param page [Hash] page defaults. Normalized page attributes override these defaults by name
         # @yield [page] customizes each generated page element
         # @yieldparam page [Sevgi::Graphics::Element] generated page element
         # @yieldreturn [Object] ignored customization result
@@ -262,8 +275,8 @@ module Sevgi
         # @param width [Numeric] finite positive page width, normalized to an SVG number
         # @param height [Numeric] finite positive page height, normalized to an SVG number
         # @param gap [Numeric] finite non-negative gap, normalized to an SVG number
-        # @param namedview [Hash] namedview attributes; String and Symbol names are normalized and must not collide
-        # @param page [Hash] page defaults; normalized page attributes override these defaults by name
+        # @param namedview [Hash] namedview attributes. String and Symbol names are normalized and must not collide
+        # @param page [Hash] page defaults. Normalized page attributes override these defaults by name
         # @yield [page] customizes each generated page element
         # @yieldparam page [Sevgi::Graphics::Element] generated page element
         # @yieldreturn [Object] ignored customization result

data/lib/sevgi/graphics/mixtures/rdf.rb

@@ -114,7 +114,7 @@ module Sevgi
         def License_LAL(**kwargs, &block) = License(**kwargs, license: "https://artlibre.org/licence/lal/en/", &block)
 
         # Builds an RDF root element.
-        # @param kwargs [Hash] options; RDF currently accepts none
+        # @param kwargs [Hash] options. RDF currently accepts none
         # @yield evaluates the RDF drawing DSL
         # @yieldreturn [Object] ignored block result
         # @return [Sevgi::Graphics::Element] RDF element

data/lib/sevgi/graphics/mixtures/render.rb

@@ -13,68 +13,6 @@ module Sevgi
           STYLES = %i[hybrid inline block].freeze
           SVG_NAMESPACE = "http://www.w3.org/2000/svg"
 
-          # Attribute rendering strategies.
-          # @api private
-          module Attributes
-            # Block-style attribute renderer.
-            # @api private
-            module Block
-              # Renders attributes in block form.
-              # @param element [Sevgi::Graphics::Element] rendered element
-              # @param depth [Integer] element depth
-              # @return [void]
-              def attributes(element, depth)
-                attributes_block(element, depth, element.attributes.send(:xml_lines))
-              end
-            end
-
-            # Hybrid attribute renderer.
-            # @api private
-            module Hybrid
-              # Renders attributes inline or in block form according to line length.
-              # @param element [Sevgi::Graphics::Element] rendered element
-              # @param depth [Integer] element depth
-              # @return [void]
-              def attributes(element, depth)
-                if attributes_as_block?(lines = element.attributes.send(:xml_lines), depth)
-                  attributes_block(element, depth, lines)
-                else
-                  attributes_inline(element, depth, lines)
-                end
-              end
-
-              # Reports whether attributes should be rendered in block form.
-              # @param lines [Array<String>] rendered attribute lines
-              # @param depth [Integer] element depth
-              # @return [Boolean]
-              def attributes_as_block?(lines, depth)
-                linelength(lines, depth) > options[:linelength]
-              end
-
-              # Returns the effective inline line length.
-              # @param lines [Array<String>] rendered attribute lines
-              # @param depth [Integer] element depth
-              # @return [Integer]
-              def linelength(lines, depth)
-                indent(depth).length + lines.sum(&:length)
-              end
-            end
-
-            # Inline attribute renderer.
-            # @api private
-            module Inline
-              # Renders attributes inline.
-              # @param element [Sevgi::Graphics::Element] rendered element
-              # @param depth [Integer] element depth
-              # @return [void]
-              def attributes(element, depth)
-                attributes_inline(element, depth, element.attributes.send(:xml_lines))
-              end
-            end
-          end
-
-          private_constant :Attributes
-
           ELEMENTS_WITH_INLINE_CONTENT = %i[title].freeze
           ELEMENTS_WITH_BLOCK_CONTENT = %i[style].freeze
           SEPARATOR = "\n"
@@ -102,17 +40,11 @@ module Sevgi
             # Inline mark with start, stop, and depth.
             Mark = Struct.new(:start, :stop, :depth)
 
-            # Creates an inline splice tracker.
-            # @return [void]
             def initialize
               @marks = []
               @stack = []
             end
 
-            # Starts an inline splice range.
-            # @param index [Integer] output index
-            # @param depth [Integer] element depth
-            # @return [Sevgi::Graphics::Mixtures::Render::Renderer::Inlines::Mark] opened mark
             def start(index, depth)
               Mark.new(start: index, depth:).tap do |mark|
                 @marks << mark
@@ -120,10 +52,6 @@ module Sevgi
               end
             end
 
-            # Ends the innermost inline splice range.
-            # @param index [Integer] output index
-            # @return [Integer]
-            # @raise [Sevgi::PanicError] when no inline range is open
             def stop(index)
               mark = @stack.pop
               PanicError.("Inline content range was not opened") unless mark
@@ -131,12 +59,6 @@ module Sevgi
               mark.stop = index
             end
 
-            # Joins marked output ranges into inline content.
-            # @param output [Array<Array<String>, nil>] renderer output buffer
-            # @param indent [String] indentation unit
-            # @param separator [String] line separator
-            # @return [Array<Array<String>, nil>, nil]
-            # @raise [Sevgi::PanicError] when an inline range was not closed
             def join(output, indent:, separator:)
               return if @marks.empty?
 
@@ -175,8 +97,7 @@ module Sevgi
             @options = self.class.send(:validate, **)
             @output = []
             @inlines = Inlines.new
-
-            build
+            unclosed
           end
 
           # @overload call(root, **options)
@@ -246,6 +167,14 @@ module Sevgi
 
           attr_reader :inlines
 
+          def attributes(element, depth)
+            lines = element.attributes.send(:xml_lines)
+            block = options[:style] == :block ||
+              (options[:style] == :hybrid && indent(depth).length + lines.sum(&:length) > options[:linelength])
+
+            block ? attributes_block(element, depth, lines) : attributes_inline(element, depth, lines)
+          end
+
           def attributes_block(element, depth, lines)
             return attributes_inline(element, depth, lines) if lines.empty?
 
@@ -265,19 +194,6 @@ module Sevgi
             end
           end
 
-          def build
-            case options[:style]
-            when :hybrid
-              extend(Attributes::Hybrid)
-            when :inline
-              extend(Attributes::Inline)
-            when :block
-              extend(Attributes::Block)
-            end
-
-            unclosed
-          end
-
           def childless?(element)
             element.children.empty? && element.contents.empty?
           end
@@ -361,9 +277,9 @@ module Sevgi
 
         # @overload Render(**options)
         #   Renders this element as SVG source.
-        #   Elements with inline text content may also contain inline children such as `tspan`; the renderer keeps those
+        #   Elements with inline text content can also contain inline children such as `tspan`. The renderer keeps those
         #   descendants in the same text line. Whitespace inside content objects is preserved as given, and encoded
-        #   content is XML-escaped unless a verbatim content object is used. SVG `style` elements use block content;
+        #   content is XML-escaped unless a verbatim content object is used. SVG `style` elements use block content.
         #   same-named elements under a foreign default namespace retain ordinary inline text formatting.
         #   @example Keep every attribute on the element's opening line
         #     SVG(:minimal) { rect id: "card", width: 80, height: 40 }.Render(style: :inline)