uniword 1.0.0

data/lib/uniword/properties/border.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Border style enumeration
+    #
+    # Represents border line styles from OOXML specification
+    class BorderStyleValue < Lutaml::Model::Type::String
+    end
+
+    # Individual border definition
+    #
+    # Represents a single border (top, bottom, left, right) with style,
+    # size, spacing, and color attributes.
+    #
+    # @example Creating a border
+    #   border = Border.new(
+    #     style: 'single',
+    #     size: 4,
+    #     space: 1,
+    #     color: 'auto'
+    #   )
+    class Border < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :style, BorderStyleValue
+      attribute :size, :integer      # Size in eighths of a point (1-96)
+      attribute :space, :integer     # Spacing offset in points (0-31)
+      attribute :color, :string      # RGB hex or 'auto'
+      attribute :theme_color, :string
+      attribute :theme_shade, :string
+
+      xml do
+        # Use 'border' as element name for standalone parsing
+        element 'border'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :style
+        map_attribute 'sz', to: :size
+        map_attribute 'space', to: :space
+        map_attribute 'color', to: :color
+        map_attribute 'themeColor', to: :theme_color
+        map_attribute 'themeShade', to: :theme_shade
+      end
+    end
+  end
+end

data/lib/uniword/properties/borders.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Paragraph borders container
+    #
+    # Represents <w:pBdr> element containing top, bottom, left, and right
+    # border definitions.
+    #
+    # @example Creating borders
+    #   borders = Borders.new(
+    #     top: Border.new(style: 'single', size: 4, color: 'auto'),
+    #     bottom: Border.new(style: 'single', size: 4, color: 'auto')
+    #   )
+    class Borders < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :top, Border
+      attribute :bottom, Border
+      attribute :left, Border
+      attribute :right, Border
+      attribute :between, Border
+      attribute :bar, Border
+
+      xml do
+        element 'pBdr'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_element 'top', to: :top, render_nil: false
+        map_element 'bottom', to: :bottom, render_nil: false
+        map_element 'left', to: :left, render_nil: false
+        map_element 'right', to: :right, render_nil: false
+        map_element 'between', to: :between, render_nil: false
+        map_element 'bar', to: :bar, render_nil: false
+      end
+    end
+  end
+end

data/lib/uniword/properties/cell_vertical_align.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Cell vertical alignment enumeration
+    #
+    # Represents vertical alignment types from OOXML specification
+    class CellVerticalAlignValue < Lutaml::Model::Type::String
+    end
+
+    # Table cell vertical alignment
+    #
+    # Represents <w:vAlign> element with alignment value.
+    # Used in table cell properties to specify vertical positioning of content.
+    #
+    # @example Creating vertical align
+    #   valign = CellVerticalAlign.new(value: 'center')
+    class CellVerticalAlign < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :value, CellVerticalAlignValue # Alignment: top, center, bottom
+
+      xml do
+        element 'vAlign'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/cell_width.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Table cell width specification
+    #
+    # Represents <w:tcW> element with width value and type.
+    # Used in table cell properties to specify cell dimensions.
+    #
+    # @example Creating cell width
+    #   width = CellWidth.new(w: 2500, type: 'pct')
+    class CellWidth < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :w, :integer        # Width value
+      attribute :type, :string      # Width type: auto, dxa (twips), pct (percentage), nil
+
+      xml do
+        element 'tcW'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'w', to: :w
+        map_attribute 'type', to: :type, render_nil: false
+      end
+    end
+  end
+end

data/lib/uniword/properties/character_spacing.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for character spacing value
+    class CharacterSpacingValue < Lutaml::Model::Type::Integer
+    end
+
+    # Character spacing element (expanded/condensed text)
+    #
+    # Represents <w:spacing w:val="..."/> in run properties where value is:
+    # - Integer in twips (1/1440 inch)
+    # - Positive values expand spacing between characters
+    # - Negative values condense spacing
+    # - Zero is normal spacing
+    class CharacterSpacing < Lutaml::Model::Serializable
+      attribute :value, CharacterSpacingValue
+
+      # Alias for XML attribute compatibility
+      def val
+        value
+      end
+
+      xml do
+        element 'spacing'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/color_value.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for color value
+    class ColorValueType < Lutaml::Model::Type::String
+    end
+
+    # Color value element
+    #
+    # Represents <w:color w:val="..." w:themeColor="..." w:themeShade="..."/>
+    # where value is RGB hex (e.g., "FF0000") and themeColor references theme (e.g., "background1")
+    # themeShade is a hex tint value (e.g., "BF")
+    class ColorValue < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :value, ColorValueType
+      attribute :theme_color, :string
+      attribute :theme_shade, :string
+      attribute :theme_tint, :string
+
+      xml do
+        element 'color'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+        map_attribute 'themeColor', to: :theme_color, render_nil: false
+        map_attribute 'themeShade', to: :theme_shade, render_nil: false
+        map_attribute 'themeTint', to: :theme_tint, render_nil: false
+      end
+
+      # Compare with another ColorValue or a string
+      def ==(other)
+        if other.is_a?(ColorValue)
+          value == other.value
+        elsif other.is_a?(String)
+          value == other
+        else
+          super
+        end
+      end
+
+      alias eql? ==
+
+      # For string interpolation
+      def to_s
+        value.to_s
+      end
+
+      # For hash key compatibility
+      def hash
+        value.hash
+      end
+    end
+  end
+end

data/lib/uniword/properties/contextual_spacing.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Contextual spacing property
+    #
+    # Represents w:contextualSpacing element in paragraph properties.
+    # This is a marker element - its presence means "true" (don't add space
+    # between paragraphs of the same style), absence means "false".
+    #
+    # Element: <w:contextualSpacing/> or <w:contextualSpacing w:val="false"/>
+    class ContextualSpacing < Lutaml::Model::Serializable
+      include BooleanElement
+
+      attribute :val, :string, default: nil
+      include BooleanValSetter
+
+      xml do
+        element 'contextualSpacing'
+        namespace Uniword::Ooxml::Namespaces::WordProcessingML
+        map_attribute 'val', to: :val, render_nil: false, render_default: false
+      end
+
+      # For truthiness check
+      def to_bool
+        [true, 1, '1', 'true'].include?(value)
+      end
+    end
+  end
+end

data/lib/uniword/properties/emphasis_mark.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for emphasis mark value
+    class EmphasisMarkValue < Lutaml::Model::Type::String
+    end
+
+    # Emphasis mark element (accent marks above/below text)
+    #
+    # Represents <w:em w:val="..."/> where value is:
+    # - "none" = no emphasis mark
+    # - "dot" = dot above text (most common)
+    # - "comma" = comma above text
+    # - "circle" = circle above text
+    # - "underDot" = dot below text
+    class EmphasisMark < Lutaml::Model::Serializable
+      attribute :value, EmphasisMarkValue
+
+      # Alias for XML attribute compatibility
+      def val
+        value
+      end
+
+      xml do
+        element 'em'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/font_size.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for font size value
+    class FontSizeValue < Lutaml::Model::Type::Integer
+    end
+
+    # Font size element
+    #
+    # Represents <w:sz w:val="..."/> or <w:szCs w:val="..."/>
+    # where value is font size in half-points (e.g., 32 = 16pt)
+    class FontSize < Lutaml::Model::Serializable
+      attribute :value, FontSizeValue
+
+      xml do
+        element 'sz'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/highlight.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for highlight value
+    class HighlightValue < Lutaml::Model::Type::String
+    end
+
+    # Text highlight element
+    #
+    # Represents <w:highlight w:val="..."/> where value is:
+    # - yellow, green, cyan, magenta, blue, red, darkBlue, darkCyan,
+    #   darkGreen, darkMagenta, darkRed, darkYellow, darkGray,
+    #   lightGray, black, white, none
+    class Highlight < Lutaml::Model::Serializable
+      attribute :value, HighlightValue
+
+      xml do
+        element 'highlight'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/indentation.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Paragraph indentation element
+    #
+    # Represents <w:ind> with left, right, firstLine, and hanging attributes
+    class Indentation < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :left, :integer
+      attribute :right, :integer
+      attribute :first_line, :integer
+      attribute :hanging, :integer
+
+      xml do
+        element 'ind'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'left', to: :left
+        map_attribute 'right', to: :right
+        map_attribute 'firstLine', to: :first_line
+        map_attribute 'hanging', to: :hanging
+      end
+    end
+  end
+end

data/lib/uniword/properties/italic.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Italic formatting element
+    #
+    # OOXML: <w:i/> means italic=true (absence of val= means true)
+    # <w:i w:val="false"/> means italic=false
+    #
+    # Model: nil = true (no val attribute), 'false' = explicit false
+    class Italic < Lutaml::Model::Serializable
+      include Uniword::Properties::BooleanElement
+
+      attribute :val, :string, default: nil
+      include Uniword::Properties::BooleanValSetter
+
+      xml do
+        element 'i'
+        namespace Uniword::Ooxml::Namespaces::WordProcessingML
+        map_attribute 'val', to: :val, render_nil: false, render_default: false
+      end
+    end
+
+    # Complex script italic
+    class ItalicCs < Lutaml::Model::Serializable
+      include Uniword::Properties::BooleanElement
+
+      attribute :val, :string, default: nil
+      include Uniword::Properties::BooleanValSetter
+
+      xml do
+        element 'iCs'
+        namespace Uniword::Ooxml::Namespaces::WordProcessingML
+        map_attribute 'val', to: :val, render_nil: false, render_default: false
+      end
+    end
+  end
+end

data/lib/uniword/properties/kerning.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for kerning value
+    class KerningValue < Lutaml::Model::Type::Integer
+    end
+
+    # Kerning threshold element
+    #
+    # Represents <w:kern w:val="..."/> where value is:
+    # - Integer in half-points
+    # - Specifies font size threshold for automatic kerning
+    # - 0 = kerning disabled
+    # - Typical values: 8-72 (4pt to 36pt threshold)
+    class Kerning < Lutaml::Model::Serializable
+      attribute :value, KerningValue
+
+      # Alias for XML attribute compatibility
+      def val
+        value
+      end
+
+      xml do
+        element 'kern'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/language.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Language code value
+    #
+    # Represents language codes (e.g., "en-US", "zh-CN", "ar-SA")
+    class LanguageValue < Lutaml::Model::Type::String
+    end
+
+    # Language settings for run text
+    #
+    # Represents <w:lang> element with language codes for different scripts.
+    #
+    # @example Creating language settings
+    #   lang = Language.new(
+    #     val: 'en-US',
+    #     east_asia: 'zh-CN',
+    #     bidi: 'ar-SA'
+    #   )
+    class Language < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :val, LanguageValue          # Latin/default script language
+      attribute :east_asia, LanguageValue    # East Asian script language
+      attribute :bidi, LanguageValue         # Bidirectional script language
+
+      xml do
+        element 'lang'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :val
+        map_attribute 'eastAsia', to: :east_asia
+        map_attribute 'bidi', to: :bidi
+      end
+    end
+  end
+end

data/lib/uniword/properties/margin.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Margin specification helper
+    # Represents individual margin with width and type
+    class Margin < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :w, :integer        # Width in twips
+      attribute :type, :string      # Type: dxa (twips)
+
+      xml do
+        # This is a helper class, child elements define root
+        namespace Ooxml::Namespaces::WordProcessingML
+        map_attribute 'w', to: :w
+        map_attribute 'type', to: :type, render_nil: false
+      end
+    end
+  end
+end

data/lib/uniword/properties/numbering_id.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for numbering ID value
+    class NumberingIdValue < Lutaml::Model::Type::Integer
+    end
+
+    # Numbering ID element
+    #
+    # Represents <w:numId w:val="..."/> where value references
+    # a numbering definition ID for lists (bullets, numbers)
+    class NumberingId < Lutaml::Model::Serializable
+      attribute :value, NumberingIdValue
+
+      xml do
+        element 'numId'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/numbering_level.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for numbering level value
+    class NumberingLevelValue < Lutaml::Model::Type::Integer
+    end
+
+    # Numbering level element
+    #
+    # Represents <w:ilvl w:val="..."/> where value is 0-8
+    # (9 levels of list nesting/indentation)
+    class NumberingLevel < Lutaml::Model::Serializable
+      attribute :value, NumberingLevelValue
+
+      xml do
+        element 'ilvl'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end

data/lib/uniword/properties/numbering_properties.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Numbering properties wrapper element
+    #
+    # Represents <w:numPr> containing <w:numId> and <w:ilvl> child elements.
+    # Used in paragraph properties for list item formatting.
+    class NumberingProperties < Lutaml::Model::Serializable
+      # Pattern 0: ATTRIBUTES FIRST
+      attribute :num_id, NumberingId
+      attribute :ilvl, NumberingLevel
+
+      xml do
+        element 'numPr'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_element 'numId', to: :num_id, render_nil: false
+        map_element 'ilvl', to: :ilvl, render_nil: false
+      end
+    end
+  end
+end

data/lib/uniword/properties/outline.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Outline text effect element
+    #
+    # Represents <w:outline/> or <w:outline w:val="false"/>
+    # Used in run properties (w:rPr) for outline text effect
+    class Outline < Lutaml::Model::Serializable
+      attribute :val, :string
+
+      xml do
+        element 'outline'
+        namespace Uniword::Ooxml::Namespaces::WordProcessingML
+        map_attribute 'val', to: :val, render_nil: false, render_default: false
+      end
+
+      # Handle boolean-like values for val attribute
+      # nil = true (element present without val means true)
+      # 'false' = false
+      def initialize(attrs = {})
+        if [true, 'true'].include?(attrs[:val])
+          attrs[:val] = nil # true = no val attribute
+        elsif [false, 'false'].include?(attrs[:val])
+          attrs[:val] = 'false'
+        end
+        super
+      end
+    end
+  end
+end

data/lib/uniword/properties/outline_level.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'lutaml/model'
+
+module Uniword
+  module Properties
+    # Namespaced custom type for outline level value
+    class OutlineLevelValue < Lutaml::Model::Type::Integer
+    end
+
+    # Outline level element
+    #
+    # Represents <w:outlineLvl w:val="..."/> where value is 0-9
+    # Used for table of contents generation
+    class OutlineLevel < Lutaml::Model::Serializable
+      attribute :value, OutlineLevelValue
+
+      xml do
+        element 'outlineLvl'
+        namespace Ooxml::Namespaces::WordProcessingML
+
+        map_attribute 'val', to: :value
+      end
+    end
+  end
+end