uniword 1.2.5 → 1.3.0

data/lib/uniword/wordprocessingml/w14_attributes.rb

@@ -16,15 +16,43 @@ module Uniword
     # W16CID namespace for Word 2016+ citation identifiers
     W16CID_NAMESPACE = Uniword::Ooxml::Namespaces::Word2016Cid
 
-    # Typed attribute for w14:paraId
+    # ST_LongHexNumber (ECMA-376): exactly 8 hexadecimal digits
+    LONG_HEX_NUMBER_PATTERN = /\A[0-9A-Fa-f]{8}\z/
+
+    # Validate an ST_LongHexNumber value at cast time
+    #
+    # @param value [Object] the raw value
+    # @return [String, nil, Object] the validated value
+    # @raise [Lutaml::Model::Type::InvalidValueError] when the value is
+    #   not 8 hexadecimal digits
+    def self.cast_long_hex_number(value)
+      casted = Lutaml::Model::Type::String.cast(value)
+      return casted if casted.nil? ||
+        Lutaml::Model::Utils.uninitialized?(casted)
+      return casted if LONG_HEX_NUMBER_PATTERN.match?(casted)
+
+      raise Lutaml::Model::Type::InvalidValueError.new(
+        value, ["ST_LongHexNumber: 8 hexadecimal digits"]
+      )
+    end
+
+    # Typed attribute for w14:paraId (ST_LongHexNumber)
     class W14ParaId < Lutaml::Model::Type::String
+      def self.cast(value, _options = {})
+        Wordprocessingml.cast_long_hex_number(value)
+      end
+
       xml do
         namespace W14_NAMESPACE
       end
     end
 
-    # Typed attribute for w14:textId
+    # Typed attribute for w14:textId (ST_LongHexNumber)
     class W14TextId < Lutaml::Model::Type::String
+      def self.cast(value, _options = {})
+        Wordprocessingml.cast_long_hex_number(value)
+      end
+
       xml do
         namespace W14_NAMESPACE
       end

data/lib/uniword/wordprocessingml.rb

@@ -64,6 +64,7 @@ module Uniword
     # Structure and metadata
     autoload :Level, "uniword/wordprocessingml/level"
     autoload :Style, "uniword/wordprocessingml/style"
+    autoload :StyleCleanup, "uniword/wordprocessingml/style_cleanup"
     autoload :StructuredDocumentTag,
              "uniword/wordprocessingml/structured_document_tag"
     autoload :StructuredDocumentTagProperties,
@@ -72,6 +73,7 @@ module Uniword
     autoload :PageSize, "uniword/wordprocessingml/page_size"
     autoload :PageMargins, "uniword/wordprocessingml/page_margins"
     autoload :PageNumbering, "uniword/wordprocessingml/page_numbering"
+    autoload :PageSetup, "uniword/wordprocessingml/page_setup"
     autoload :Columns, "uniword/wordprocessingml/columns"
     autoload :HeaderReference, "uniword/wordprocessingml/header_reference"
     autoload :FooterReference, "uniword/wordprocessingml/footer_reference"
@@ -130,6 +132,7 @@ module Uniword
 
     # Fonts
     autoload :Font, "uniword/wordprocessingml/font"
+    autoload :FontReplacer, "uniword/wordprocessingml/font_replacer"
     autoload :Fonts, "uniword/wordprocessingml/fonts"
     autoload :FontTable, "uniword/wordprocessingml/font_table"
 
@@ -191,6 +194,7 @@ module Uniword
     autoload :Next, "uniword/wordprocessingml/next"
     autoload :Link, "uniword/wordprocessingml/link"
     autoload :UiPriority, "uniword/wordprocessingml/ui_priority"
+    autoload :UpdateFields, "uniword/wordprocessingml/update_fields"
     autoload :LatentStyles, "uniword/wordprocessingml/latent_styles"
     autoload :ParagraphStyle, "uniword/wordprocessingml/paragraph_style"
     autoload :CharacterStyle, "uniword/wordprocessingml/character_style"

data/lib/uniword.rb

@@ -101,7 +101,6 @@ module Uniword
   autoload :Template, "uniword/template"
   autoload :TemplateManager, "uniword/template_manager"
   autoload :Visitor, "uniword/visitor"
-  autoload :Validators, "uniword/validators"
   autoload :Stylesets, "uniword/stylesets"
   autoload :Infrastructure, "uniword/infrastructure"
   autoload :Accessibility, "uniword/accessibility"
@@ -114,7 +113,6 @@ module Uniword
   autoload :Configuration, "uniword/configuration"
   autoload :Transformation, "uniword/transformation"
   autoload :Validation, "uniword/validation"
-  autoload :Warnings, "uniword/warnings"
   autoload :Mhtml, "uniword/mhtml"
   autoload :Themes, "uniword/themes"
   autoload :Resource, "uniword/resource"
@@ -135,6 +133,9 @@ module Uniword
   # CLI
   autoload :CLI, "uniword/cli/main"
   autoload :GenerateCLI, "uniword/cli/generate_cli"
+  autoload :FontsCLI, "uniword/cli/fonts_cli"
+  autoload :PageCLI, "uniword/cli/page_cli"
+  autoload :StylesCLI, "uniword/cli/styles_cli"
   autoload :DiffCLI, "uniword/cli/diff_cli"
   autoload :TemplateCLI, "uniword/cli/template_cli"
   autoload :CLIHelpers, "uniword/cli/helpers"
@@ -250,6 +251,30 @@ module Uniword
       Wordprocessingml::DocumentRoot.new
     end
 
+    # Get the global runtime configuration (memoized)
+    #
+    # @return [Configuration] The global configuration instance
+    #
+    # @example
+    #   Uniword.configuration.validate_on_save # => true
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Configure global runtime policy
+    #
+    # @yieldparam config [Configuration] The global configuration instance
+    # @return [Configuration] The global configuration instance
+    #
+    # @example
+    #   Uniword.configure do |config|
+    #     config.xsd_validation = true
+    #   end
+    def configure
+      yield(configuration)
+      configuration
+    end
+
     # Load document from file
     #
     # @param path [String] File path

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: uniword
 version: !ruby/object:Gem::Version
-  version: 1.2.5
+  version: 1.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-17 00:00:00.000000000 Z
+date: 2026-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -182,8 +182,6 @@ files:
 - config/system_profiles.yml
 - config/theme_mapping.yml
 - config/transformation_rules.yml
-- config/validation_rules.yml
-- config/warning_rules.yml
 - data/color_schemes/amber.yml
 - data/color_schemes/azure.yml
 - data/color_schemes/burgundy.yml
@@ -476,10 +474,14 @@ files:
 - data/resources/document_elements/zh-TW/tables.yml
 - data/resources/document_elements/zh-TW/watermarks.yml
 - data/resources/font_registry.yml
+- data/schemas/ecma/dc.xsd
+- data/schemas/ecma/dcmitype.xsd
+- data/schemas/ecma/dcterms.xsd
 - data/schemas/ecma/opc-contentTypes.xsd
 - data/schemas/ecma/opc-coreProperties.xsd
 - data/schemas/ecma/opc-digSig.xsd
 - data/schemas/ecma/opc-relationships.xsd
+- data/schemas/ecma/xml.xsd
 - data/schemas/iso/dml-chart.xsd
 - data/schemas/iso/dml-chartDrawing.xsd
 - data/schemas/iso/dml-diagram.xsd
@@ -631,6 +633,7 @@ files:
 - lib/uniword/builder/base_builder.rb
 - lib/uniword/builder/bibliography_builder.rb
 - lib/uniword/builder/chart_builder.rb
+- lib/uniword/builder/comment_anchorer.rb
 - lib/uniword/builder/comment_builder.rb
 - lib/uniword/builder/deterministic_id.rb
 - lib/uniword/builder/document_builder.rb
@@ -728,15 +731,18 @@ files:
 - lib/uniword/chart/y_values.rb
 - lib/uniword/cli.rb
 - lib/uniword/cli/diff_cli.rb
+- lib/uniword/cli/fonts_cli.rb
 - lib/uniword/cli/generate_cli.rb
 - lib/uniword/cli/headers_cli.rb
 - lib/uniword/cli/helpers.rb
 - lib/uniword/cli/images_cli.rb
 - lib/uniword/cli/main.rb
+- lib/uniword/cli/page_cli.rb
 - lib/uniword/cli/protect_cli.rb
 - lib/uniword/cli/resources_cli.rb
 - lib/uniword/cli/review_cli.rb
 - lib/uniword/cli/spellcheck_cli.rb
+- lib/uniword/cli/styles_cli.rb
 - lib/uniword/cli/styleset_cli.rb
 - lib/uniword/cli/template_cli.rb
 - lib/uniword/cli/theme_cli.rb
@@ -809,14 +815,23 @@ files:
 - lib/uniword/document_variables/variable_scope.rb
 - lib/uniword/document_writer.rb
 - lib/uniword/docx.rb
+- lib/uniword/docx/chart_part.rb
+- lib/uniword/docx/custom_xml_item.rb
 - lib/uniword/docx/document_statistics.rb
+- lib/uniword/docx/header_footer_part.rb
+- lib/uniword/docx/header_footer_part_collection.rb
+- lib/uniword/docx/header_footer_view.rb
 - lib/uniword/docx/id_allocator.rb
 - lib/uniword/docx/package.rb
 - lib/uniword/docx/package_defaults.rb
+- lib/uniword/docx/package_integrity_checker.rb
 - lib/uniword/docx/package_serialization.rb
+- lib/uniword/docx/part.rb
+- lib/uniword/docx/part_collection.rb
 - lib/uniword/docx/profile.rb
 - lib/uniword/docx/reconciler.rb
 - lib/uniword/docx/reconciler/body.rb
+- lib/uniword/docx/reconciler/fix.rb
 - lib/uniword/docx/reconciler/fix_codes.rb
 - lib/uniword/docx/reconciler/helpers.rb
 - lib/uniword/docx/reconciler/notes.rb
@@ -1096,6 +1111,8 @@ files:
 - lib/uniword/ooxml/dotx_package.rb
 - lib/uniword/ooxml/namespaces.rb
 - lib/uniword/ooxml/package_file.rb
+- lib/uniword/ooxml/part_definition.rb
+- lib/uniword/ooxml/part_registry.rb
 - lib/uniword/ooxml/relationships.rb
 - lib/uniword/ooxml/relationships/hyperlink_relationship.rb
 - lib/uniword/ooxml/relationships/image_relationship.rb
@@ -1125,10 +1142,13 @@ files:
 - lib/uniword/ooxml/types/dcterms_created_type.rb
 - lib/uniword/ooxml/types/dcterms_modified_type.rb
 - lib/uniword/ooxml/types/dcterms_w3cdtf_type.rb
+- lib/uniword/ooxml/types/hex_color_value.rb
 - lib/uniword/ooxml/types/mc_ignorable_type.rb
 - lib/uniword/ooxml/types/ooxml_boolean.rb
 - lib/uniword/ooxml/types/ooxml_boolean_optional.rb
 - lib/uniword/ooxml/types/relationship_id.rb
+- lib/uniword/ooxml/types/theme_color_value.rb
+- lib/uniword/ooxml/types/unsigned_decimal_number.rb
 - lib/uniword/ooxml/types/variant_types.rb
 - lib/uniword/page_borders.rb
 - lib/uniword/paragraph_border.rb
@@ -1479,28 +1499,35 @@ files:
 - lib/uniword/validation/checkers/file_reference_checker.rb
 - lib/uniword/validation/checkers/footnote_reference_checker.rb
 - lib/uniword/validation/checkers/internal_link_checker.rb
-- lib/uniword/validation/document_validator.rb
+- lib/uniword/validation/engine.rb
 - lib/uniword/validation/layer_validation_result.rb
 - lib/uniword/validation/layer_validator.rb
 - lib/uniword/validation/link_checker.rb
 - lib/uniword/validation/link_validator.rb
 - lib/uniword/validation/opc_validator.rb
+- lib/uniword/validation/report.rb
 - lib/uniword/validation/report/layer_result.rb
 - lib/uniword/validation/report/terminal_formatter.rb
 - lib/uniword/validation/report/validation_issue.rb
 - lib/uniword/validation/report/verification_report.rb
 - lib/uniword/validation/rules.rb
 - lib/uniword/validation/rules/base.rb
+- lib/uniword/validation/rules/bookmark_pairing_rule.rb
+- lib/uniword/validation/rules/bookmark_uniqueness_rule.rb
 - lib/uniword/validation/rules/bookmarks_rule.rb
 - lib/uniword/validation/rules/content_types_coverage_rule.rb
 - lib/uniword/validation/rules/core_properties_namespace_rule.rb
+- lib/uniword/validation/rules/document_body_rule.rb
 - lib/uniword/validation/rules/document_context.rb
+- lib/uniword/validation/rules/empty_paragraphs_rule.rb
 - lib/uniword/validation/rules/font_table_signature_rule.rb
 - lib/uniword/validation/rules/fonts_rule.rb
 - lib/uniword/validation/rules/footnotes_rule.rb
 - lib/uniword/validation/rules/headers_footers_rule.rb
 - lib/uniword/validation/rules/images_rule.rb
 - lib/uniword/validation/rules/mc_ignorable_namespace_rule.rb
+- lib/uniword/validation/rules/model_context.rb
+- lib/uniword/validation/rules/model_rule.rb
 - lib/uniword/validation/rules/numbering_preservation_rule.rb
 - lib/uniword/validation/rules/numbering_rule.rb
 - lib/uniword/validation/rules/registry.rb
@@ -1510,26 +1537,18 @@ files:
 - lib/uniword/validation/rules/settings_rule.rb
 - lib/uniword/validation/rules/settings_values_rule.rb
 - lib/uniword/validation/rules/style_references_rule.rb
+- lib/uniword/validation/rules/table_grid_rule.rb
+- lib/uniword/validation/rules/table_properties_rule.rb
 - lib/uniword/validation/rules/tables_rule.rb
 - lib/uniword/validation/rules/theme_completeness_rule.rb
 - lib/uniword/validation/rules/theme_rule.rb
 - lib/uniword/validation/schema_registry.rb
-- lib/uniword/validation/structural_validator.rb
 - lib/uniword/validation/validation_report.rb
 - lib/uniword/validation/validation_result.rb
 - lib/uniword/validation/validators.rb
-- lib/uniword/validation/validators/content_type_validator.rb
 - lib/uniword/validation/validators/document_semantics_validator.rb
-- lib/uniword/validation/validators/file_structure_validator.rb
-- lib/uniword/validation/validators/ooxml_part_validator.rb
-- lib/uniword/validation/validators/relationship_validator.rb
 - lib/uniword/validation/validators/xml_schema_validator.rb
-- lib/uniword/validation/validators/zip_integrity_validator.rb
 - lib/uniword/validation/verify_orchestrator.rb
-- lib/uniword/validators.rb
-- lib/uniword/validators/element_validator.rb
-- lib/uniword/validators/paragraph_validator.rb
-- lib/uniword/validators/table_validator.rb
 - lib/uniword/version.rb
 - lib/uniword/visitor.rb
 - lib/uniword/visitor/base_visitor.rb
@@ -1594,10 +1613,6 @@ files:
 - lib/uniword/vml_word/border_left.rb
 - lib/uniword/vml_word/border_right.rb
 - lib/uniword/vml_word/border_top.rb
-- lib/uniword/warnings.rb
-- lib/uniword/warnings/warning.rb
-- lib/uniword/warnings/warning_collector.rb
-- lib/uniword/warnings/warning_report.rb
 - lib/uniword/watermark.rb
 - lib/uniword/watermark/manager.rb
 - lib/uniword/word2010_ext.rb
@@ -1666,6 +1681,7 @@ files:
 - lib/uniword/wordprocessingml/fallback.rb
 - lib/uniword/wordprocessingml/field_char.rb
 - lib/uniword/wordprocessingml/font.rb
+- lib/uniword/wordprocessingml/font_replacer.rb
 - lib/uniword/wordprocessingml/font_table.rb
 - lib/uniword/wordprocessingml/fonts.rb
 - lib/uniword/wordprocessingml/footer.rb
@@ -1727,6 +1743,7 @@ files:
 - lib/uniword/wordprocessingml/page_defaults.rb
 - lib/uniword/wordprocessingml/page_margins.rb
 - lib/uniword/wordprocessingml/page_numbering.rb
+- lib/uniword/wordprocessingml/page_setup.rb
 - lib/uniword/wordprocessingml/page_size.rb
 - lib/uniword/wordprocessingml/paragraph.rb
 - lib/uniword/wordprocessingml/paragraph_borders.rb
@@ -1782,6 +1799,7 @@ files:
 - lib/uniword/wordprocessingml/structured_document_tag/text.rb
 - lib/uniword/wordprocessingml/structured_document_tag_properties.rb
 - lib/uniword/wordprocessingml/style.rb
+- lib/uniword/wordprocessingml/style_cleanup.rb
 - lib/uniword/wordprocessingml/style_name.rb
 - lib/uniword/wordprocessingml/style_pane_format_filter.rb
 - lib/uniword/wordprocessingml/style_pane_sort_method.rb
@@ -1816,6 +1834,7 @@ files:
 - lib/uniword/wordprocessingml/title_pg.rb
 - lib/uniword/wordprocessingml/tr_height.rb
 - lib/uniword/wordprocessingml/ui_priority.rb
+- lib/uniword/wordprocessingml/update_fields.rb
 - lib/uniword/wordprocessingml/val_int.rb
 - lib/uniword/wordprocessingml/w14_attributes.rb
 - lib/uniword/wordprocessingml/w14_doc_id.rb

data/config/validation_rules.yml

@@ -1,60 +0,0 @@
-# Document Validation Configuration
-#
-# Defines rules and settings for the 7-layer document validation system.
-# Each layer validates one specific aspect of document integrity (MECE).
-
-document_validation:
-  # General settings
-  fail_fast: true              # Stop validation on first critical error
-  max_file_size: 104857600     # 100MB maximum file size
-
-  # Layer 1: File Structure Validation
-  file_structure:
-    enabled: true
-    check_extension: true
-    check_size: true
-    allowed_extensions:
-      - '.docx'
-      - '.doc'
-
-  # Layer 2: ZIP Integrity Validation
-  zip_integrity:
-    enabled: true
-    check_entries: true         # Verify required entries exist
-    check_corruption: true      # Test each entry for corruption
-    verify_compression: true    # Validate compression method
-
-  # Layer 3: OOXML Part Validation
-  ooxml_parts:
-    enabled: true
-    require_content_types: true       # [Content_Types].xml must exist
-    require_document: true            # word/document.xml must exist
-    require_relationships: true       # _rels/.rels must exist
-    warn_missing_optional: true       # Warn about missing optional parts
-
-  # Layer 4: XML Schema Validation
-  xml_schema:
-    enabled: true
-    strict_parsing: true        # Use strict XML parsing
-    check_encoding: true        # Validate XML encoding
-    validate_namespaces: true   # Check namespace declarations
-
-  # Layer 5: Relationship Validation
-  relationships:
-    enabled: true
-    check_targets_exist: true   # Verify relationship targets exist
-    check_circular_refs: false  # Check for circular references (expensive)
-    validate_types: true        # Validate relationship type URIs
-
-  # Layer 6: Content Type Validation
-  content_types:
-    enabled: true
-    check_consistency: true     # Verify content types are consistent
-    validate_extensions: true   # Check file extensions match declarations
-
-  # Layer 7: Document Semantics Validation
-  document_semantics:
-    enabled: true
-    check_required_elements: true   # Verify required elements (body, etc.)
-    validate_structure: true        # Check document hierarchy
-    check_style_references: true    # Validate style references (future)

data/config/warning_rules.yml

@@ -1,57 +0,0 @@
-# Warning System Configuration
-#
-# Defines rules for tracking unsupported elements and features during
-# document processing. Helps users understand what may be lost in round-trip.
-
-warning_system:
-  enabled: true
-  log_warnings: false      # Set to true to log warnings during processing
-  log_level: :warn         # Log level (:info, :warn, :error)
-
-  # Critical elements (data-bearing) - severity: error
-  # These elements contain important data that will be lost
-  critical_elements:
-    - chart              # Charts - data visualization
-    - smartArt           # SmartArt diagrams
-    - sdt                # Content controls - user data
-    - customXml          # Custom XML - data binding
-    - contentPart        # Content parts
-    - control            # ActiveX controls
-
-  # Warning elements (important but not critical) - severity: warning
-  # These elements affect formatting/structure but not core data
-  warning_elements:
-    - drawingML          # Complex drawings
-    - vmlDrawing         # Legacy VML drawings
-    - fldSimple          # Simple fields
-    - altChunk           # Alternative content chunks
-    - subDoc             # Subdocuments
-
-  # Element-specific suggestions for users
-  element_suggestions:
-    chart: "Chart elements are not yet supported. The chart will be preserved as-is but cannot be edited. Consider using image exports for charts. Support planned for v6.1."
-
-    smartArt: "SmartArt diagrams are not yet supported. Diagram will be preserved but cannot be modified. Consider converting to regular shapes. Support planned for v6.2."
-
-    sdt: "Content controls are not yet supported. Controls will be preserved but values cannot be updated programmatically. Support planned for v6.1."
-
-    customXml: "Custom XML data binding is not yet supported. XML data will be preserved but cannot be accessed or modified. Support planned for v6.3."
-
-    drawingML: "Complex DrawingML graphics may not be fully supported. Basic shapes work, but advanced features may be lost."
-
-    vmlDrawing: "Legacy VML drawings have limited support. Consider updating to modern DrawingML format."
-
-    fldSimple: "Some field types are not yet supported. Field will be preserved but may not update correctly."
-
-    control: "ActiveX controls are not supported. Controls will be preserved but not functional."
-
-    altChunk: "Alternative content chunks are not supported. Content may be lost."
-
-    subDoc: "Subdocuments are not supported. Consider consolidating into single document."
-
-  # Reporting options
-  reporting:
-    group_by_element: true      # Group warnings by element type
-    include_counts: true        # Include occurrence counts
-    include_suggestions: true   # Include suggestions in report
-    max_warnings: 100           # Maximum warnings to collect (prevent memory issues)