openxml-docx 0.9.0 → 0.10.0

data/lib/openxml/drawingml/elements/round.rb

@@ -0,0 +1,10 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class Round < OpenXml::Docx::Elements::Element
+        namespace :a
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/shape_guide.rb

@@ -0,0 +1,40 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class ShapeGuide < OpenXml::Docx::Elements::Element
+        namespace :a
+        tag :gd
+
+        attribute :formula, expects: :valid_formula, displays_as: :fmla
+        attribute :guide_name, expects: :string, displays_as: :name
+
+      private
+
+        def valid_formula(value)
+          raise ArgumentError unless ok_formulae.any? { |f| value =~ f }
+        end
+
+        def ok_formulae # Office Open XML spec section 20.1.9.11
+          [ /^\*\/\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Multiply Divide formula "*/ x y z" = ((x * y) / z)
+            /^\+\-\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Add Subtract formula "+- x y z" = ((x + y) - z)
+            /^\+\/\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Add Divide formula "+/ x y z" = ((x + y) / z)
+            /^\?\:\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # If Else formula "?: x y z" = (x > 0) ? y : z
+            /^abs\s[0-9a-z\-]+$/i, # Absolute Value formula "abs x" = (x < 0) -1 * x : x
+            /^at2\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # ArcTan formula "at2 x y" = arctan(y / x)
+            /^cat2\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Cosine ArcTan formula "cat2 x y z" = (x * cos(arctan(z / y)))
+            /^cos\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Cosine formula "cos x y" = x * cos(y)
+            /^max\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Maximum Value formula "max x y" = (x > y) ? x : y
+            /^min\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Minimum Value formula "min x y" = (x < y) ? x : y
+            /^mod\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Modulo formula "mod x y z" = sqrt(x^2 + y^2 + z^2)
+            /^pin\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Pin To formula "pin x y z" = if(y < x) x elsif(y > z) z else y
+            /^sat2\s[0-9a-z\-]+\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Sine ArcTan formula "sat2 x y z" = (x * sin(arctan(z / y)))
+            /^sin\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Sine formula "sin x y" = x * sin(y)
+            /^sqrt\s[0-9a-z\-]+$/i, # Square Root formula "sqrt x" = sqrt(x)
+            /^tan\s[0-9a-z\-]+\s[0-9a-z\-]+$/i, # Tangent formula "tan x y" = x * tan(y)
+            /^val\s[0-9a-z\-]+$/i ]  # Literal Value formula "val x" = x
+        end
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/solid_fill.rb

@@ -0,0 +1,10 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class SolidFill < OpenXml::Docx::Elements::Container
+        namespace :a
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/srgb_color.rb

@@ -0,0 +1,14 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class SRGBColor < OpenXml::Docx::Elements::Element
+        namespace :a
+        tag :srgbClr
+        name "srgb_color"
+
+        attribute :value, expects: :hex_color, displays_as: :val
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/tail_end.rb

@@ -0,0 +1,28 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class TailEnd < OpenXml::Docx::Elements::Element
+        namespace :a
+
+        attribute :length, expects: :valid_end_size, displays_as: :len
+        attribute :type, expects: :valid_end_type
+        attribute :width, expects: :valid_end_size, displays_as: :w
+
+      private
+
+        def valid_end_size(value)
+          ok_values = %i(lg med sm)
+          message = "Invalid #{name} (#{value}). Valid values are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_end_type(value)
+          ok_values = %i(arrow diamond none oval stealth triangle)
+          message = "Invalid end type (#{value}). Valid values are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/transform_effect.rb

@@ -0,0 +1,18 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class TransformEffect < OpenXml::Docx::Elements::Container
+        namespace :a
+        tag :xfrm
+
+        attribute :horizontal_skew, expects: :integer, displays_as: :kx
+        attribute :vertical_skew, expects: :integer, displays_as: :ky
+        attribute :horizontal_ratio, expects: :percentage, displays_as: :sx
+        attribute :vertical_ratio, expects: :percentage, displays_as: :sy
+        attribute :horizontal_shift, expects: :integer, displays_as: :tx
+        attribute :vertical_shift, expects: :integer, displays_as: :ty
+
+      end
+    end
+  end
+end

data/lib/openxml/drawingml/elements/wordprocessing_shape_group.rb

@@ -0,0 +1,11 @@
+module OpenXml
+  module DrawingML
+    module Elements
+      class WordprocessingShapeGroup < OpenXml::Docx::Elements::Container
+        tag :wgp
+        namespace :wpg
+
+      end
+    end
+  end
+end

data/lib/openxml/vml.rb

@@ -0,0 +1,17 @@
+module OpenXml
+  module Vml
+  end
+end
+
+# For now, we'll rely on Docx's basic implementations
+require "openxml/docx/attribute_builder"
+require "openxml/docx/property_builder"
+require "openxml/docx/properties"
+require "openxml/docx/elements"
+require "openxml/docx/package"
+require "openxml/docx/parts"
+require "openxml/docx/section"
+require "openxml/docx/style"
+
+# And then add our own stuff
+require "openxml/vml/elements"

data/lib/openxml/vml/elements.rb

@@ -0,0 +1,13 @@
+module OpenXml
+  module Vml
+    module Elements
+    end
+  end
+end
+
+require "openxml/docx/elements/element"
+require "openxml/docx/elements/container"
+require "openxml/docx/elements/text"
+Dir.glob("#{File.join(File.dirname(__FILE__), "elements", "*.rb")}").each do |file|
+  require file
+end

data/lib/openxml/vml/elements/group.rb

@@ -0,0 +1,88 @@
+module OpenXml
+  module Vml
+    module Elements
+      class Group < OpenXml::Docx::Elements::Container
+        namespace :v
+
+        attribute :alt, expects: :string
+        attribute :css_class, expects: :string, displays_as: :class
+        attribute :coordinate_origin, expects: :valid_coordinate, displays_as: :coordorigin
+        attribute :coordinate_size, expects: :valid_coordinate, displays_as: :coordsize
+        attribute :edit_as, one_of: %i(bullseye canvas cycle orgchart radial stacked venn), displays_as: :editas
+        attribute :fill_color, expects: :valid_color, displays_as: :fillcolor
+        attribute :filled, expects: :explicit_true_false
+        attribute :href, expects: :string
+        attribute :id, expects: :string
+        attribute :print, expects: :explicit_true_false
+        attribute :style, expects: :string
+        attribute :target, expects: :string
+        attribute :title, expects: :string
+        attribute :wrap_coordinates, expects: :string, displays_as: :wrapcoords
+
+        with_namespace :o do
+          attribute :allow_in_cell, expects: :explicit_true_false, displays_as: :allowincell
+          attribute :allow_overlap, expects: :explicit_true_false, displays_as: :allowoverlap
+          attribute :border_bottom_color, expects: :string, displays_as: :borderbottomcolor
+          attribute :border_left_color, expects: :string, displays_as: :borderleftcolor
+          attribute :border_right_color, expects: :string, displays_as: :borderrightcolor
+          attribute :border_top_color, expects: :string, displays_as: :bordertopcolor
+          attribute :bullet, expects: :explicit_true_false
+          attribute :button, expects: :explicit_true_false
+          attribute :diagram_node_layout, expects: :valid_diagram_layout, displays_as: :dgmlayout
+          attribute :diagram_node_recent_layout, expects: :valid_diagram_layout, displays_as: :dgmlayoutmru
+          attribute :diagram_node_kind, expects: :integer, displays_as: :dgmnodekind
+          attribute :double_click_notify, expects: :explicit_true_false, displays_as: :doubleclicknotify
+          attribute :hr, expects: :explicit_true_false
+          attribute :hr_align, expects: :valid_hr_align, displays_as: :hralign
+          attribute :hr_no_shade, expects: :explicit_true_false, displays_as: :hrnoshade
+          attribute :hr_percent, expects: :integer, displays_as: :hrpct
+          attribute :hr_standard, expects: :explicit_true_false, displays_as: :hrstd
+          attribute :inset_mode, expects: :valid_inset_mode, displays_as: :insetmode
+          attribute :hide_extra_handles, expects: :explicit_true_false, displays_as: :oned
+          attribute :regroup_id, expects: :integer, displays_as: :regroupid
+          attribute :optional_string, expects: :string, displays_as: :spid
+          attribute :table_limits, expects: :string, displays_as: :tablelimits
+          attribute :table_properties, expects: :string, displays_as: :tableproperties
+          attribute :user_drawn, expects: :explicit_true_false, displays_as: :userdrawn
+          attribute :user_hidden, expects: :explicit_true_false, displays_as: :userhidden
+        end
+
+      private
+
+        def valid_color(value)
+          ok_color_names = %i(black silver gray white maroon red purple fuchsia green lime olive yellow navy blue teal aqua)
+          valid_hex = /#[0-9a-f]{6}/i
+          valid_palette_entry = /^\w+(?:\s\[[0-9]+\])?$/
+          message = "Invalid color. Please specify a color name, a hex value (with #), or a palette entry."
+          raise ArgumentError, message unless ok_color_names.include?(value) || value =~ valid_hex || value =~ valid_palette_entry
+        end
+
+        def valid_coordinate(value)
+          raise ArgumentError, "Invalid coordinates." unless value =~ /^[\-0-9]+,\s?[\-0-9]+$/
+        end
+
+        def valid_diagram_layout(value)
+          message = "Invalid diagram layout. Must be a single digit between 0 and 3 inclusive"
+          raise ArgumentError, message unless (value.is_a?(Fixnum) && (0..3).include?(value)) || value =~ /^[0-3]$/
+        end
+
+        def valid_hr_align(value)
+          ok_values = %i(center left right)
+          message = "Invalid hr alignment (#{value}). Valid values are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_inset_mode(value)
+          ok_values = %i(auto custom)
+          message = "Invalid inset mode (#{value}). Valid modes are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def explicit_true_false(value)
+          raise ArgumentError unless value.to_s =~ /^(?:[01tf]|true|false)$/
+        end
+
+      end
+    end
+  end
+end

data/lib/openxml/vml/elements/rectangle.rb

@@ -0,0 +1,115 @@
+module OpenXml
+  module Vml
+    module Elements
+      class Rectangle < OpenXml::Docx::Elements::Container
+        namespace :v
+        tag :rect
+
+        attribute :alt, expects: :string
+        attribute :chroma_key, expects: :valid_color, displays_as: :chromakey
+        attribute :css_class, expects: :string, displays_as: :class
+        attribute :coordinate_origin, expects: :valid_coordinate, displays_as: :coordorigin
+        attribute :coordinate_size, expects: :valid_coordinate, displays_as: :coordsize
+        attribute :fill_color, expects: :valid_color, displays_as: :fillcolor
+        attribute :filled, expects: :explicit_true_false
+        attribute :href, expects: :string
+        attribute :id, expects: :string
+        attribute :inset_pen, expects: :explicit_true_false, displays_as: :insetpen
+        attribute :opacity, expects: :string # Can be a float or 1/65536ths when followed by `f`
+        attribute :print, expects: :explicit_true_false
+        attribute :stroke_color, expects: :valid_color, displays_as: :strokecolor
+        attribute :stroked, expects: :explicit_true_false
+        attribute :stroke_weight, expects: :string, displays_as: :strokeweight # Expects number with units
+        attribute :style, expects: :string
+        attribute :target, expects: :string
+        attribute :title, expects: :string
+        attribute :wrap_coordinates, expects: :string, displays_as: :wrapcoords
+
+        with_namespace :o do
+          attribute :allow_in_cell, expects: :explicit_true_false, displays_as: :allowincell
+          attribute :allow_overlap, expects: :explicit_true_false, displays_as: :allowoverlap
+          attribute :border_bottom_color, expects: :string, displays_as: :borderbottomcolor
+          attribute :border_left_color, expects: :string, displays_as: :borderleftcolor
+          attribute :border_right_color, expects: :string, displays_as: :borderrightcolor
+          attribute :border_top_color, expects: :string, displays_as: :bordertopcolor
+          attribute :bullet, expects: :explicit_true_false
+          attribute :button, expects: :explicit_true_false
+          attribute :bw_mode, expects: :valid_bw_mode, displays_as: :bwmode
+          attribute :bw_normal, expects: :valid_bw_mode, displays_as: :bwnormal
+          attribute :bw_pure, expects: :valid_bw_mode, displays_as: :bwpure
+          attribute :clip, expects: :explicit_true_false
+          attribute :clip_to_wrap, expects: :explicit_true_false, displays_as: :cliptowrap
+          attribute :connector_type, expects: :valid_connector_type, displays_as: :connectortype
+          attribute :diagram_node_layout, expects: :valid_diagram_layout, displays_as: :dgmlayout
+          attribute :diagram_node_recent_layout, expects: :valid_diagram_layout, displays_as: :dgmlayoutmru
+          attribute :diagram_node_kind, expects: :integer, displays_as: :dgmnodekind
+          attribute :double_click_notify, expects: :explicit_true_false, displays_as: :doubleclicknotify
+          attribute :force_dash, expects: :explicit_true_false, displays_as: :forcedash
+          attribute :hr, expects: :explicit_true_false
+          attribute :hr_align, expects: :valid_hr_align, displays_as: :hralign
+          attribute :hr_no_shade, expects: :explicit_true_false, displays_as: :hrnoshade
+          attribute :hr_percent, expects: :integer, displays_as: :hrpct
+          attribute :hr_standard, expects: :explicit_true_false, displays_as: :hrstd
+          attribute :inset_mode, expects: :valid_inset_mode, displays_as: :insetmode
+          attribute :ole, expects: :explicit_true_false
+          attribute :ole_icon, expects: :explicit_true_false, displays_as: :oleicon
+          attribute :hide_extra_handles, expects: :explicit_true_false, displays_as: :oned
+          attribute :prefer_relative, expects: :explicit_true_false, displays_as: :preferrelative
+          attribute :regroup_id, expects: :integer, displays_as: :regroupid
+          attribute :optional_string, expects: :string, displays_as: :spid
+          attribute :optional_number, expects: :string, displays_as: :spt # Actually expects float
+          attribute :user_drawn, expects: :explicit_true_false, displays_as: :userdrawn
+          attribute :user_hidden, expects: :explicit_true_false, displays_as: :userhidden
+        end
+
+      private
+
+        def valid_bw_mode(value)
+          ok_values = %i(auto black blackTextAndLines color grayOutline grayScale hide highContrast inverseGray lightGrayscale undrawn white)
+          message = "Invalid black and white mode (#{value}). Valid options are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_color(value)
+          ok_color_names = %i(black silver gray white maroon red purple fuchsia green lime olive yellow navy blue teal aqua)
+          valid_hex = /#[0-9a-f]{6}/i
+          valid_palette_entry = /^\w+(?:\s\[[0-9]+\])?$/
+          message = "Invalid color. Please specify a color name, a hex value (with #), or a palette entry."
+          raise ArgumentError, message unless ok_color_names.include?(value) || value =~ valid_hex || value =~ valid_palette_entry
+        end
+
+        def valid_connector_type(value)
+          ok_values = %i(curved elbow none straight)
+          message = "Invalid connector type (#{value}). Valid types are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_coordinate(value)
+          raise ArgumentError, "Invalid coordinates." unless value =~ /^[\-0-9]+,\s?[\-0-9]+$/
+        end
+
+        def valid_diagram_layout(value)
+          message = "Invalid diagram layout. Must be a single digit between 0 and 3 inclusive"
+          raise ArgumentError, message unless (value.is_a?(Fixnum) && (0..3).include?(value)) || value =~ /^[0-3]$/
+        end
+
+        def valid_hr_align(value)
+          ok_values = %i(center left right)
+          message = "Invalid hr alignment (#{value}). Valid values are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_inset_mode(value)
+          ok_values = %i(auto custom)
+          message = "Invalid inset mode (#{value}). Valid modes are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def explicit_true_false(value)
+          raise ArgumentError unless value.to_s =~ /^(?:[01tf]|true|false)$/
+        end
+
+      end
+    end
+  end
+end

data/lib/openxml/vml/elements/rounded_rectangle.rb

@@ -0,0 +1,121 @@
+module OpenXml
+  module Vml
+    module Elements
+      class RoundedRectangle < OpenXml::Docx::Elements::Container
+        namespace :v
+        tag :roundrect
+
+        attribute :alt, expects: :string
+        attribute :arc_size, expects: :valid_arc_size, displays_as: :arcsize
+        attribute :chroma_key, expects: :valid_color, displays_as: :chromakey
+        attribute :css_class, expects: :string, displays_as: :class
+        attribute :coordinate_origin, expects: :valid_coordinate, displays_as: :coordorigin
+        attribute :coordinate_size, expects: :valid_coordinate, displays_as: :coordsize
+        attribute :fill_color, expects: :valid_color, displays_as: :fillcolor
+        attribute :filled, expects: :explicit_true_false
+        attribute :href, expects: :string
+        attribute :id, expects: :string
+        attribute :inset_pen, expects: :explicit_true_false, displays_as: :insetpen
+        attribute :opacity, expects: :string # Can be a float or 1/65536ths when followed by `f`
+        attribute :print, expects: :explicit_true_false
+        attribute :stroke_color, expects: :valid_color, displays_as: :strokecolor
+        attribute :stroked, expects: :explicit_true_false
+        attribute :stroke_weight, expects: :string, displays_as: :strokeweight # Expects number with units
+        attribute :style, expects: :string
+        attribute :target, expects: :string
+        attribute :title, expects: :string
+        attribute :wrap_coordinates, expects: :string, displays_as: :wrapcoords
+
+        with_namespace :o do
+          attribute :allow_in_cell, expects: :explicit_true_false, displays_as: :allowincell
+          attribute :allow_overlap, expects: :explicit_true_false, displays_as: :allowoverlap
+          attribute :border_bottom_color, expects: :string, displays_as: :borderbottomcolor
+          attribute :border_left_color, expects: :string, displays_as: :borderleftcolor
+          attribute :border_right_color, expects: :string, displays_as: :borderrightcolor
+          attribute :border_top_color, expects: :string, displays_as: :bordertopcolor
+          attribute :bullet, expects: :explicit_true_false
+          attribute :button, expects: :explicit_true_false
+          attribute :bw_mode, expects: :valid_bw_mode, displays_as: :bwmode
+          attribute :bw_normal, expects: :valid_bw_mode, displays_as: :bwnormal
+          attribute :bw_pure, expects: :valid_bw_mode, displays_as: :bwpure
+          attribute :clip, expects: :explicit_true_false
+          attribute :clip_to_wrap, expects: :explicit_true_false, displays_as: :cliptowrap
+          attribute :connector_type, expects: :valid_connector_type, displays_as: :connectortype
+          attribute :diagram_node_layout, expects: :valid_diagram_layout, displays_as: :dgmlayout
+          attribute :diagram_node_recent_layout, expects: :valid_diagram_layout, displays_as: :dgmlayoutmru
+          attribute :diagram_node_kind, expects: :integer, displays_as: :dgmnodekind
+          attribute :double_click_notify, expects: :explicit_true_false, displays_as: :doubleclicknotify
+          attribute :force_dash, expects: :explicit_true_false, displays_as: :forcedash
+          attribute :hr, expects: :explicit_true_false
+          attribute :hr_align, expects: :valid_hr_align, displays_as: :hralign
+          attribute :hr_no_shade, expects: :explicit_true_false, displays_as: :hrnoshade
+          attribute :hr_percent, expects: :integer, displays_as: :hrpct
+          attribute :hr_standard, expects: :explicit_true_false, displays_as: :hrstd
+          attribute :inset_mode, expects: :valid_inset_mode, displays_as: :insetmode
+          attribute :ole, expects: :explicit_true_false
+          attribute :ole_icon, expects: :explicit_true_false, displays_as: :oleicon
+          attribute :hide_extra_handles, expects: :explicit_true_false, displays_as: :oned
+          attribute :prefer_relative, expects: :explicit_true_false, displays_as: :preferrelative
+          attribute :regroup_id, expects: :integer, displays_as: :regroupid
+          attribute :optional_string, expects: :string, displays_as: :spid
+          attribute :optional_number, expects: :string, displays_as: :spt # Actually expects float
+          attribute :user_drawn, expects: :explicit_true_false, displays_as: :userdrawn
+          attribute :user_hidden, expects: :explicit_true_false, displays_as: :userhidden
+        end
+
+      private
+
+        def valid_arc_size(value)
+          message = "Invalid arc size. Requires a percent or value in terms of f."
+          raise ArgumentError, message unless value.is_a?(String) && value =~ /^[0-9]+[%f]$/
+        end
+
+        def valid_bw_mode(value)
+          ok_values = %i(auto black blackTextAndLines color grayOutline grayScale hide highContrast inverseGray lightGrayscale undrawn white)
+          message = "Invalid black and white mode (#{value}). Valid options are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_color(value)
+          ok_color_names = %i(black silver gray white maroon red purple fuchsia green lime olive yellow navy blue teal aqua)
+          valid_hex = /#[0-9a-f]{6}/i
+          valid_palette_entry = /^\w+(?:\s\[[0-9]+\])?$/
+          message = "Invalid color. Please specify a color name, a hex value (with #), or a palette entry."
+          raise ArgumentError, message unless ok_color_names.include?(value) || value =~ valid_hex || value =~ valid_palette_entry
+        end
+
+        def valid_connector_type(value)
+          ok_values = %i(curved elbow none straight)
+          message = "Invalid connector type (#{value}). Valid types are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_coordinate(value)
+          raise ArgumentError, "Invalid coordinates." unless value =~ /^[\-0-9]+,\s?[\-0-9]+$/
+        end
+
+        def valid_diagram_layout(value)
+          message = "Invalid diagram layout. Must be a single digit between 0 and 3 inclusive"
+          raise ArgumentError, message unless (value.is_a?(Fixnum) && (0..3).include?(value)) || value =~ /^[0-3]$/
+        end
+
+        def valid_hr_align(value)
+          ok_values = %i(center left right)
+          message = "Invalid hr alignment (#{value}). Valid values are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def valid_inset_mode(value)
+          ok_values = %i(auto custom)
+          message = "Invalid inset mode (#{value}). Valid modes are: #{ok_values.join(", ")}."
+          raise ArgumentError, message unless ok_values.include? value
+        end
+
+        def explicit_true_false(value)
+          raise ArgumentError unless value.to_s =~ /^(?:[01tf]|true|false)$/
+        end
+
+      end
+    end
+  end
+end