uniword 1.2.5 → 1.3.0

data/lib/uniword/ooxml/types/ooxml_boolean_optional.rb

@@ -9,34 +9,39 @@ module Uniword
       #
       # Key behavior:
       # - cast(nil) -> nil (doesn't convert to false like OoxmlBoolean)
-      # - cast("1") -> true, cast("0") -> false
+      # - cast("1"/"true"/"on") -> true, cast("0"/"false"/"off") -> false
+      # - cast of any other value raises
+      #   Lutaml::Model::Type::InvalidValueError instead of passing
+      #   through unchanged
       # - to_xml(true) -> "1"
       # - to_xml(false) -> "0" (explicit false in original)
       # - to_xml(nil) -> nil (attribute absent, omit from output)
       #
       # This is the right type for attributes like w:locked, w:semiHidden
-      # on lsdException where absent = false = omit, but explicit "0" = render "0".
-      # Note: Due to cast(nil) = nil, absent attributes also serialize as omitted.
+      # on lsdException where absent = false = omit, but explicit
+      # "0" = render "0".
+      # Note: Due to cast(nil) = nil, absent attributes also serialize
+      # as omitted.
       class OoxmlBooleanOptional < Lutaml::Model::Type::Boolean
         def self.cast(value, _options = {})
-          case value
-          when true, "1", 1
-            true
-          when false, "0", 0
-            false
-          when nil
-            nil
-          else
-            value
-          end
+          return value if Lutaml::Model::Utils.uninitialized?(value)
+          return nil if value.nil?
+          return true if OoxmlBoolean::TRUE_VALUES.include?(value)
+          return false if OoxmlBoolean::FALSE_VALUES.include?(value)
+
+          raise Lutaml::Model::Type::InvalidValueError.new(
+            value, OoxmlBoolean::ON_OFF_VALUES
+          )
         end
 
         def self.serialize(value)
           return nil if value.nil?
-          return "1" if value == true || value.to_s.match?(/^(true|t|yes|y|1)$/i)
-          return "0" if value == false || value.to_s.match?(/^(false|f|no|n|0)$/i)
+          return "1" if OoxmlBoolean::TRUE_VALUES.include?(value)
+          return "0" if OoxmlBoolean::FALSE_VALUES.include?(value)
 
-          value
+          raise Lutaml::Model::Type::InvalidValueError.new(
+            value, OoxmlBoolean::ON_OFF_VALUES
+          )
         end
 
         # Override instance to_xml:

data/lib/uniword/ooxml/types/theme_color_value.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Uniword
+  module Ooxml
+    module Types
+      # ST_ThemeColor (ECMA-376, wml.xsd): theme color reference
+      #
+      # Carries the full ST_ThemeColor enumeration so models can declare
+      # `values: ThemeColorValue::VALUES` on theme color attributes.
+      class ThemeColorValue < Lutaml::Model::Type::String
+        # Full ST_ThemeColor enumeration from ECMA-376 (wml.xsd)
+        VALUES = %w[
+          dark1 light1 dark2 light2 accent1 accent2 accent3 accent4
+          accent5 accent6 hyperlink followedHyperlink none background1
+          text1 background2 text2
+        ].freeze
+      end
+    end
+  end
+end

data/lib/uniword/ooxml/types/unsigned_decimal_number.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Uniword
+  module Ooxml
+    module Types
+      # ST_UnsignedDecimalNumber (ECMA-376): non-negative integer
+      #
+      # Constrained integer type shared by unsigned OOXML measures
+      # (ST_TwipsMeasure, ST_PointMeasure, ST_PixelsMeasure). Negative
+      # values raise Lutaml::Model::Type::MinBoundError at cast time
+      # (attribute assignment and XML parsing).
+      class UnsignedDecimalNumber < Lutaml::Model::Type::Integer
+        # Cast a value to a non-negative Integer
+        #
+        # @param value [Object] the raw value
+        # @param options [Hash] cast options (unused)
+        # @return [Integer, nil] the non-negative integer value
+        # @raise [Lutaml::Model::Type::MinBoundError] when negative
+        def self.cast(value, options = {})
+          casted = super
+          return casted unless casted.is_a?(::Integer) && casted.negative?
+
+          raise Lutaml::Model::Type::MinBoundError.new(casted, 0)
+        end
+      end
+    end
+  end
+end

data/lib/uniword/ooxml/types.rb

@@ -40,6 +40,16 @@ module Uniword
       # Serializes true -> "1", false/nil -> omitted
       autoload :OoxmlBooleanOptional, "#{__dir__}/types/ooxml_boolean_optional"
 
+      # ST_HexColor constrained string type ("auto" or 6 hex digits)
+      autoload :HexColorValue, "#{__dir__}/types/hex_color_value"
+
+      # ST_ThemeColor enumeration carrier type
+      autoload :ThemeColorValue, "#{__dir__}/types/theme_color_value"
+
+      # ST_UnsignedDecimalNumber constrained integer type (non-negative)
+      autoload :UnsignedDecimalNumber,
+               "#{__dir__}/types/unsigned_decimal_number"
+
       # Relationships namespace type for r:embed/r:link cross-namespace attrs
       autoload :RelationshipId, "#{__dir__}/types/relationship_id"
 

data/lib/uniword/ooxml.rb

@@ -29,6 +29,8 @@ module Uniword
     autoload :Types, "#{__dir__}/ooxml/types"
     autoload :PackageFile, "#{__dir__}/ooxml/package_file"
     autoload :ContentTypes, "#{__dir__}/content_types"
+    autoload :PartDefinition, "#{__dir__}/ooxml/part_definition"
+    autoload :PartRegistry, "#{__dir__}/ooxml/part_registry"
 
     # OOXML namespaces - autoload for runtime access
     autoload :Namespaces, "#{__dir__}/ooxml/namespaces"

data/lib/uniword/properties/alignment.rb

@@ -6,14 +6,19 @@ module Uniword
   module Properties
     # Namespaced custom type for alignment value
     class AlignmentValue < Lutaml::Model::Type::String
+      # Full ST_Jc enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[
+        start center end both mediumKashida distribute numTab
+        highKashida lowKashida thaiDistribute left right
+      ].freeze
     end
 
     # Paragraph alignment element
     #
-    # Represents <w:jc w:val="..."/> where value is:
-    # - left, center, right, both (justified), distribute
+    # Represents <w:jc w:val="..."/> where value is from ST_Jc
+    # (ECMA-376), e.g. left, center, right, both (justified), distribute
     class Alignment < Lutaml::Model::Serializable
-      attribute :value, AlignmentValue
+      attribute :value, AlignmentValue, values: AlignmentValue::VALUES
 
       xml do
         element "jc"

data/lib/uniword/properties/border.rb

@@ -8,31 +8,77 @@ module Uniword
     #
     # Represents border line styles from OOXML specification
     class BorderStyleValue < Lutaml::Model::Type::String
+      # Full ST_Border enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[nil none single thick double dotted dashed dotDash dotDotDash
+                  triple thinThickSmallGap thickThinSmallGap
+                  thinThickThinSmallGap thinThickMediumGap thickThinMediumGap
+                  thinThickThinMediumGap thinThickLargeGap thickThinLargeGap
+                  thinThickThinLargeGap wave doubleWave dashSmallGap
+                  dashDotStroked threeDEmboss threeDEngrave outset inset apples
+                  archedScallops babyPacifier babyRattle balloons3Colors
+                  balloonsHotAir basicBlackDashes basicBlackDots
+                  basicBlackSquares basicThinLines basicWhiteDashes
+                  basicWhiteDots basicWhiteSquares basicWideInline
+                  basicWideMidline basicWideOutline bats birds birdsFlight
+                  cabins cakeSlice candyCorn celticKnotwork certificateBanner
+                  chainLink champagneBottle checkedBarBlack checkedBarColor
+                  checkered christmasTree circlesLines circlesRectangles
+                  classicalWave clocks compass confetti confettiGrays
+                  confettiOutline confettiStreamers confettiWhite
+                  cornerTriangles couponCutoutDashes couponCutoutDots crazyMaze
+                  creaturesButterfly creaturesFish creaturesInsects
+                  creaturesLadyBug crossStitch cup decoArch decoArchColor
+                  decoBlocks diamondsGray doubleD doubleDiamonds earth1 earth2
+                  earth3 eclipsingSquares1 eclipsingSquares2 eggsBlack fans
+                  film firecrackers flowersBlockPrint flowersDaisies
+                  flowersModern1 flowersModern2 flowersPansy flowersRedRose
+                  flowersRoses flowersTeacup flowersTiny gems gingerbreadMan
+                  gradient handmade1 handmade2 heartBalloon heartGray hearts
+                  heebieJeebies holly houseFunky hypnotic iceCreamCones
+                  lightBulb lightning1 lightning2 mapPins mapleLeaf
+                  mapleMuffins marquee marqueeToothed moons mosaic musicNotes
+                  northwest ovals packages palmsBlack palmsColor paperClips
+                  papyrus partyFavor partyGlass pencils people peopleWaving
+                  peopleHats poinsettias postageStamp pumpkin1 pushPinNote2
+                  pushPinNote1 pyramids pyramidsAbove quadrants rings safari
+                  sawtooth sawtoothGray scaredCat seattle shadowedSquares
+                  sharksTeeth shorebirdTracks skyrocket snowflakeFancy
+                  snowflakes sombrero southwest stars starsTop stars3d
+                  starsBlack starsShadowed sun swirligig tornPaper
+                  tornPaperBlack trees triangleParty triangles triangle1
+                  triangle2 triangleCircle1 triangleCircle2 shapes1 shapes2
+                  twistedLines1 twistedLines2 vine waveline weavingAngles
+                  weavingBraid weavingRibbon weavingStrips whiteFlowers
+                  woodwork xIllusions zanyTriangles zigZag zigZagStitch
+                  custom].freeze
     end
 
     # Individual border definition
     #
     # Represents a single border (top, bottom, left, right) with style,
     # size, spacing, and color attributes.
+    # style is ST_Border, color is ST_HexColor, themeColor is
+    # ST_ThemeColor (ECMA-376).
     #
     # @example Creating a border
     #   border = Border.new(
-    #     style: 'single',
+    #     style: "single",
     #     size: 4,
     #     space: 1,
-    #     color: 'auto'
+    #     color: "auto"
     #   )
     class Border < Lutaml::Model::Serializable
       # Pattern 0: ATTRIBUTES FIRST
-      attribute :style, BorderStyleValue
+      attribute :style, BorderStyleValue, values: BorderStyleValue::VALUES
       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 :color, Ooxml::Types::HexColorValue
+      attribute :theme_color, Ooxml::Types::ThemeColorValue,
+                values: Ooxml::Types::ThemeColorValue::VALUES
       attribute :theme_shade, :string
 
       xml do
-        # Use 'border' as element name for standalone parsing
+        # Use "border" as element name for standalone parsing
         element "border"
         namespace Ooxml::Namespaces::WordProcessingML
 

data/lib/uniword/properties/cell_vertical_align.rb

@@ -8,6 +8,8 @@ module Uniword
     #
     # Represents vertical alignment types from OOXML specification
     class CellVerticalAlignValue < Lutaml::Model::Type::String
+      # Full ST_VerticalJc enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[top center both bottom].freeze
     end
 
     # Table cell vertical alignment
@@ -19,7 +21,8 @@ module Uniword
     #   valign = CellVerticalAlign.new(value: 'center')
     class CellVerticalAlign < Lutaml::Model::Serializable
       # Pattern 0: ATTRIBUTES FIRST
-      attribute :value, CellVerticalAlignValue # Alignment: top, center, bottom
+      attribute :value, CellVerticalAlignValue,
+                values: CellVerticalAlignValue::VALUES
 
       xml do
         element "vAlign"

data/lib/uniword/properties/color_value.rb

@@ -5,18 +5,23 @@ require "lutaml/model"
 module Uniword
   module Properties
     # Namespaced custom type for color value
-    class ColorValueType < Lutaml::Model::Type::String
+    #
+    # Inherits the ST_HexColor constraint ("auto" or six hex digits)
+    # from Ooxml::Types::HexColorValue.
+    class ColorValueType < Ooxml::Types::HexColorValue
     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")
+    # 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_color, Ooxml::Types::ThemeColorValue,
+                values: Ooxml::Types::ThemeColorValue::VALUES
       attribute :theme_shade, :string
       attribute :theme_tint, :string
 

data/lib/uniword/properties/highlight.rb

@@ -6,16 +6,20 @@ module Uniword
   module Properties
     # Namespaced custom type for highlight value
     class HighlightValue < Lutaml::Model::Type::String
+      # Full ST_HighlightColor enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[
+        black blue cyan green magenta red yellow white darkBlue
+        darkCyan darkGreen darkMagenta darkRed darkYellow darkGray
+        lightGray none
+      ].freeze
     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
+    # Represents <w:highlight w:val="..."/> where value is from
+    # ST_HighlightColor (ECMA-376)
     class Highlight < Lutaml::Model::Serializable
-      attribute :value, HighlightValue
+      attribute :value, HighlightValue, values: HighlightValue::VALUES
 
       xml do
         element "highlight"

data/lib/uniword/properties/shading.rb

@@ -23,9 +23,10 @@ module Uniword
     class Shading < Lutaml::Model::Serializable
       # Pattern 0: ATTRIBUTES FIRST
       attribute :pattern, ShadingPatternValue
-      attribute :color, :string      # Foreground color (RGB hex or 'auto')
-      attribute :fill, :string       # Background fill color (RGB hex)
-      attribute :theme_fill, :string # Theme color reference (e.g., 'accent1')
+      attribute :color, Ooxml::Types::HexColorValue
+      attribute :fill, Ooxml::Types::HexColorValue
+      attribute :theme_fill, Ooxml::Types::ThemeColorValue,
+                values: Ooxml::Types::ThemeColorValue::VALUES
 
       xml do
         element "shd"

data/lib/uniword/properties/tab_stop.rb

@@ -8,6 +8,10 @@ module Uniword
     #
     # Represents alignment types for tab stops
     class TabAlignmentValue < Lutaml::Model::Type::String
+      # Full ST_TabJc enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[
+        clear start center end decimal bar num left right
+      ].freeze
     end
 
     # Tab leader enumeration
@@ -28,7 +32,8 @@ module Uniword
     #   )
     class TabStop < Lutaml::Model::Serializable
       # Pattern 0: ATTRIBUTES FIRST
-      attribute :alignment, TabAlignmentValue
+      attribute :alignment, TabAlignmentValue,
+                values: TabAlignmentValue::VALUES
       attribute :position, :integer # Position in twips
       attribute :leader, TabLeaderValue
 

data/lib/uniword/properties/table_justification.rb

@@ -9,7 +9,10 @@ module Uniword
     # Represents <w:jc> element with val attribute for table alignment.
     # Used in table properties (w:tblPr) for table positioning.
     class TableJustification < Lutaml::Model::Serializable
-      attribute :value, :string
+      # Full ST_JcTable enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[center end left right start].freeze
+
+      attribute :value, :string, values: VALUES
 
       xml do
         element "jc"

data/lib/uniword/properties/underline.rb

@@ -12,10 +12,12 @@ module Uniword
     #
     # Represents <w:u w:val="..."/> where value is:
     # - single, double, thick, dotted, dashed, wave, none, etc.
+    # color is ST_HexColor, themeColor is ST_ThemeColor (ECMA-376)
     class Underline < Lutaml::Model::Serializable
       attribute :value, UnderlineValue
-      attribute :color, :string
-      attribute :theme_color, :string
+      attribute :color, Ooxml::Types::HexColorValue
+      attribute :theme_color, Ooxml::Types::ThemeColorValue,
+                values: Ooxml::Types::ThemeColorValue::VALUES
       attribute :theme_shade, :string
 
       xml do

data/lib/uniword/properties/vertical_align.rb

@@ -6,14 +6,17 @@ module Uniword
   module Properties
     # Namespaced custom type for vertical alignment value
     class VerticalAlignValue < Lutaml::Model::Type::String
+      # Full ST_VerticalAlignRun enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[baseline superscript subscript].freeze
     end
 
     # Text vertical alignment element
     #
-    # Represents <w:vertAlign w:val="..."/> where value is:
-    # - baseline, superscript, subscript
+    # Represents <w:vertAlign w:val="..."/> where value is from
+    # ST_VerticalAlignRun (ECMA-376): baseline, superscript, subscript
     class VerticalAlign < Lutaml::Model::Serializable
-      attribute :value, VerticalAlignValue
+      attribute :value, VerticalAlignValue,
+                values: VerticalAlignValue::VALUES
 
       xml do
         element "vertAlign"

data/lib/uniword/review/review_manager.rb

@@ -40,6 +40,10 @@ module Uniword
 
       # Add a new comment to the document.
       #
+      # The comment is registered in the document's CommentsPart, which
+      # the save path serializes to word/comments.xml. The collection
+      # assigns a sequential decimal ID (OOXML ST_DecimalNumber).
+      #
       # @param text [String] Comment text
       # @param author [String] Author name
       # @param initials [String, nil] Author initials
@@ -50,6 +54,7 @@ module Uniword
           author: author,
           initials: initials,
         )
+        comment.comment_id = nil
         comments_part.add_comment(comment)
       end
 
@@ -74,6 +79,7 @@ module Uniword
           text: text,
           author: author,
         )
+        comment.comment_id = nil
         comments_part.add_comment(comment)
       end
 
@@ -216,15 +222,23 @@ module Uniword
       #
       # @return [Uniword::CommentsPart] The comments collection
       def comments_part
-        @comments_part ||= begin
-          existing = document.comments
-          if existing.is_a?(CommentsPart)
-            existing
-          else
-            part = CommentsPart.new
-            document.comments = part
-            part
-          end
+        @comments_part ||= migrate_comments(document.comments)
+      end
+
+      # Migrate legacy Array storage into a CommentsPart, preserving
+      # its entries; initialize the collection when absent.
+      #
+      # @param existing [CommentsPart, Array, nil] current value
+      # @return [Uniword::CommentsPart] The comments collection
+      def migrate_comments(existing)
+        case existing
+        when CommentsPart then existing
+        when Array
+          part = CommentsPart.new
+          existing.each { |c| part.add_comment(c) }
+          document.comments = part
+        else
+          document.comments = CommentsPart.new
         end
       end
 

data/lib/uniword/revision.rb

@@ -34,6 +34,15 @@ module Uniword
   #
   # @see TrackedChanges For revision collection management
   class Revision < Lutaml::Model::Serializable
+    # Unique revision identifier
+    attribute :revision_id, :string
+
+    # Author name
+    attribute :author, :string
+
+    # Revision date/time
+    attribute :date, :string
+
     # OOXML namespace configuration
     xml do
       element "ins"
@@ -44,15 +53,6 @@ module Uniword
       map_attribute "date", to: :date
     end
 
-    # Unique revision identifier
-    attribute :revision_id, :string
-
-    # Author name
-    attribute :author, :string
-
-    # Revision date/time
-    attribute :date, :string
-
     # Revision type (:insert, :delete, :format_change)
     attr_accessor :type
 

data/lib/uniword/schema/model_generator.rb

@@ -62,8 +62,6 @@ module Uniword
         file_path
       end
 
-      private
-
       # Generate complete class code
       #
       # @param element_name [String] XML element name
@@ -97,6 +95,8 @@ module Uniword
         RUBY
       end
 
+      private
+
       # Generate attribute declarations
       # CRITICAL: These MUST come BEFORE xml mapping (Pattern 0)
       #
@@ -105,21 +105,37 @@ module Uniword
       def generate_attributes(attributes)
         return "" if attributes.empty?
 
-        lines = attributes.map do |attr|
-          # Convert type to symbol for primitive types
-          type_str = if %w[String
-                           Integer].include?(attr["type"])
-                       ":#{attr['type'].downcase}"
-                     else
-                       attr["type"]
-                     end
-          attr_code = "          attribute :#{attr['name']}, #{type_str}"
-          attr_code += ", collection: true" if attr["collection"]
-          attr_code += ", initialize_empty: true" if attr["collection"]
-          attr_code
+        attributes.map { |attr| generate_attribute(attr) }.join("\n")
+      end
+
+      # Generate one attribute declaration
+      #
+      # @param attr [Hash] Attribute definition
+      # @return [String] Attribute declaration code
+      def generate_attribute(attr)
+        attr_code = "          attribute :#{attr['name']}, " \
+                    "#{attribute_type(attr['type'])}"
+        attr_code += ", collection: true" if attr["collection"]
+        attr_code += ", initialize_empty: true" if attr["collection"]
+        if attr["values"]
+          attr_code += ", values: %w[#{attr['values'].join(' ')}]"
         end
+        attr_code += ", pattern: /#{attr['pattern']}/" if attr["pattern"]
+        attr_code
+      end
 
-        lines.join("\n")
+      # Normalize an attribute type from YAML to Ruby code
+      # Primitive types become symbols (":string"), custom type class
+      # names are passed through verbatim
+      #
+      # @param type [String, Symbol] Type from YAML attribute definition
+      # @return [String] Ruby type expression
+      def attribute_type(type)
+        type = type.to_s
+        return ":#{type.downcase}" if %w[String Integer].include?(type)
+        return type if type.start_with?(":") || type.include?("::")
+
+        ":#{type}"
       end
 
       # Generate XML mapping block

data/lib/uniword/shared_types/hex_color.rb

@@ -8,8 +8,11 @@ module Uniword
     #
     # Generated from OOXML schema: shared_types.yml
     # Element: <st:hex_color>
+    #
+    # Value constrained to ST_HexColor (ECMA-376): "auto" or six
+    # hexadecimal digits; see Ooxml::Types::HexColorValue.
     class HexColor < Lutaml::Model::Serializable
-      attribute :val, :string
+      attribute :val, Uniword::Ooxml::Types::HexColorValue
 
       xml do
         element "hex_color"

data/lib/uniword/shared_types/pixel_measure.rb

@@ -8,8 +8,11 @@ module Uniword
     #
     # Generated from OOXML schema: shared_types.yml
     # Element: <st:pixel_measure>
+    #
+    # Value constrained to ST_PixelsMeasure (ECMA-376): non-negative
+    # integer; see Ooxml::Types::UnsignedDecimalNumber.
     class PixelMeasure < Lutaml::Model::Serializable
-      attribute :val, :integer
+      attribute :val, Uniword::Ooxml::Types::UnsignedDecimalNumber
 
       xml do
         element "pixel_measure"

data/lib/uniword/shared_types/point_measure.rb

@@ -8,8 +8,11 @@ module Uniword
     #
     # Generated from OOXML schema: shared_types.yml
     # Element: <st:point_measure>
+    #
+    # Value constrained to ST_PointMeasure (ECMA-376): non-negative
+    # integer; see Ooxml::Types::UnsignedDecimalNumber.
     class PointMeasure < Lutaml::Model::Serializable
-      attribute :val, :integer
+      attribute :val, Uniword::Ooxml::Types::UnsignedDecimalNumber
 
       xml do
         element "point_measure"

data/lib/uniword/shared_types/text_alignment.rb

@@ -8,8 +8,13 @@ module Uniword
     #
     # Generated from OOXML schema: shared_types.yml
     # Element: <st:text_alignment>
+    #
+    # Value constrained to ST_TextAlignment (ECMA-376, wml.xsd).
     class TextAlignment < Lutaml::Model::Serializable
-      attribute :val, :string
+      # Full ST_TextAlignment enumeration from ECMA-376 (wml.xsd)
+      VALUES = %w[top center baseline bottom auto].freeze
+
+      attribute :val, :string, values: VALUES
 
       xml do
         element "text_alignment"

data/lib/uniword/shared_types/twips_measure.rb

@@ -8,8 +8,11 @@ module Uniword
     #
     # Generated from OOXML schema: shared_types.yml
     # Element: <st:twips_measure>
+    #
+    # Value constrained to ST_TwipsMeasure (ECMA-376): non-negative
+    # integer; see Ooxml::Types::UnsignedDecimalNumber.
     class TwipsMeasure < Lutaml::Model::Serializable
-      attribute :val, :integer
+      attribute :val, Uniword::Ooxml::Types::UnsignedDecimalNumber
 
       xml do
         element "twips_measure"

data/lib/uniword/spreadsheetml/phonetic_pr.rb

@@ -26,7 +26,7 @@ module Uniword
         map_attribute "panose", to: :panose, render_nil: false
         map_attribute "pitchFamily", to: :pitch_family, render_nil: false
         map_attribute "charset", to: :charset, render_nil: false
-        map_attribute "altText", to: :AltText, render_nil: false
+        map_attribute "altText", to: :alt_text, render_nil: false
         map_attribute "combinationId", to: :combination_id, render_nil: false
         map_attribute "growingEditing", to: :growing_editing, render_nil: false
       end