svg_conform 0.1.12 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 162ed406493cfabb9a3cb94a3a6ba2ee3ed4ae95d3edf912034c17974d5cc496
-  data.tar.gz: 56cb8b2d5e94bcce3cc1e32b513a738ac2140f0e86848e6c101fc08ed16cfc7a
+  metadata.gz: 2dd3f8b58d869e1375f4ec0e5c0c212d36dc5ae64ab91873ccc896acb9bd42b7
+  data.tar.gz: 184b07a501eb1bae6fc1691849df9f2fbb0693c340149822b35a0129b47ae2c0
 SHA512:
-  metadata.gz: 1bcbdf1a7dbc43f044aa875d7a310b85064bcd47d5f227cf962303d1f3a0d024fe926b87ffc201fbf5256b0e150cfa71b5a8702e84b062b37d7935a50bc96b5b
-  data.tar.gz: 817c9ac5561b509c39e9f4d228b4165d3943a242bb83a88c77e8388bbce99c6746dc9c9df464a729ce44160c331b08ce9dfcc06e98c676c2944631eaf35346e5
+  metadata.gz: 9db79546df082674dbfbe29bd010e7a676765bd08366e26af6da279d9b56d01a907e259178ef1b3009340aa22eb785098790b49aa1cb81525831d9b60ac8e962
+  data.tar.gz: '091d729bffcc2716bcce077e5509afbce8971329c1479e86bc8c2968ac540742c161f3a3f369c78fa0f76bdf6f5de84439b6c773349656f1466da4d3175e5ca5'

data/.rubocop_todo.yml

@@ -1,17 +1,11 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-04-04 08:57:24 UTC using RuboCop version 1.86.0.
+# on 2026-04-09 13:07:51 UTC using RuboCop version 1.86.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Gemspec/RequireMFA:
-  Exclude:
-    - 'svg_conform.gemspec'
-
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleAlignWith.
@@ -20,44 +14,19 @@ Layout/BlockAlignment:
   Exclude:
     - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: leading, trailing
-Layout/LineContinuationLeadingSpace:
-  Exclude:
-    - 'spec/svgcheck_compatibility_spec.rb'
-
-# Offense count: 5
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: aligned, indented
-Layout/LineEndStringConcatenationIndentation:
-  Exclude:
-    - 'lib/svg_conform/external_checkers/svgcheck/validation_pipeline.rb'
-    - 'spec/svgcheck_compatibility_spec.rb'
-
-# Offense count: 649
+# Offense count: 667
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 13
+# Offense count: 9
 # This cop supports safe autocorrection (--autocorrect).
-Lint/AmbiguousOperatorPrecedence:
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
   Exclude:
-    - 'lib/svg_conform/compatibility_analyzer.rb'
-    - 'lib/svg_conform/semantic_comparator.rb'
-    - 'lib/svg_conform/validation_result.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: RequireParenthesesForMethodChains.
-Lint/AmbiguousRange:
-  Exclude:
-    - 'lib/svg_conform/compatibility/report_formatter.rb'
+    - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
 
 # Offense count: 3
 # Configuration parameters: AllowedMethods.
@@ -91,7 +60,14 @@ Lint/DuplicateMethods:
     - 'lib/svg_conform/sax_validation_handler.rb'
     - 'spec/svg_conform/validation_context_spec.rb'
 
-# Offense count: 2
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowComments.
+Lint/EmptyConditionalBody:
+  Exclude:
+    - 'spec/svgcheck_compatibility_spec.rb'
+
+# Offense count: 1
 Lint/HashCompareByIdentity:
   Exclude:
     - 'lib/svg_conform/document_analyzer.rb'
@@ -104,24 +80,12 @@ Lint/MissingSuper:
     - 'lib/svg_conform/compatibility/validity_analysis.rb'
     - 'lib/svg_conform/sax_validation_handler.rb'
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Lint/RedundantDirGlobSort:
-  Exclude:
-    - 'lib/tasks/fixtures.rake'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Lint/SuppressedExceptionInNumberConversion:
-  Exclude:
-    - 'lib/svg_conform/remediations/viewbox_remediation.rb'
-
-# Offense count: 145
+# Offense count: 160
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 24
+# Offense count: 25
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
@@ -132,22 +96,22 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 125
+# Offense count: 138
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 256
+# Offense count: 276
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 154
 
-# Offense count: 6
+# Offense count: 8
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 9
 
-# Offense count: 99
+# Offense count: 112
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
@@ -171,12 +135,6 @@ Performance/CollectionLiteralInLoop:
     - 'lib/svg_conform/batch_report.rb'
     - 'lib/svg_conform/compatibility/pattern_discovery.rb'
 
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Performance/MapCompact:
-  Exclude:
-    - 'lib/svg_conform/remediations/viewbox_remediation.rb'
-
 # Offense count: 9
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
@@ -199,7 +157,7 @@ RSpec/DescribeClass:
 # Offense count: 157
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
-  Max: 53
+  Max: 43
 
 # Offense count: 3
 RSpec/LeakyConstantDeclaration:
@@ -226,10 +184,19 @@ RSpec/MultipleDescribes:
 RSpec/MultipleExpectations:
   Max: 8
 
-# Offense count: 44
+# Offense count: 11
 # This cop supports unsafe autocorrection (--autocorrect-all).
 RSpec/Output:
-  Enabled: false
+  Exclude:
+    - 'spec/svg_conform/profiles/svg_1_2_rfc_profile_spec.rb'
+    - 'spec/svg_conform/remediations/color_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/font_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/invalid_id_references_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/namespace_attribute_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/namespace_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/no_external_css_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/style_promotion_remediation_spec.rb'
+    - 'spec/svg_conform/remediations/viewbox_remediation_spec.rb'
 
 # Offense count: 1
 Rake/MethodDefinitionInTask:
@@ -251,20 +218,13 @@ Style/EmptyElse:
     - 'lib/svg_conform/remediations/namespace_remediation.rb'
     - 'lib/svg_conform/requirements/style_requirement.rb'
 
-# Offense count: 23
+# Offense count: 13
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: MaxUnannotatedPlaceholdersAllowed, Mode, AllowedMethods, AllowedPatterns.
 # SupportedStyles: annotated, template, unannotated
 Style/FormatStringToken:
   EnforcedStyle: unannotated
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowSplatArgument.
-Style/HashConversion:
-  Exclude:
-    - 'lib/svg_conform/sax_validation_handler.rb'
-
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
 Style/HashSlice:
@@ -289,18 +249,6 @@ Style/OptionalBooleanParameter:
   Exclude:
     - 'lib/svg_conform/semantic_comparator.rb'
 
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/PartitionInsteadOfDoubleSelect:
-  Exclude:
-    - 'lib/svg_conform/requirements/style_requirement.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/ReduceToHash:
-  Exclude:
-    - 'lib/svg_conform/requirements/base_requirement.rb'
-
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowedMethods.
@@ -308,27 +256,3 @@ Style/ReduceToHash:
 Style/RedundantCondition:
   Exclude:
     - 'lib/svg_conform/external_checkers/svgcheck/parser.rb'
-
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/RedundantFormat:
-  Exclude:
-    - 'lib/svg_conform/compatibility/report_formatter.rb'
-
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/SelectByKind:
-  Exclude:
-    - 'lib/svg_conform/sax_validation_handler.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/SelectByRegexp:
-  Exclude:
-    - 'lib/svg_conform/remediations/color_remediation.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/SuperArguments:
-  Exclude:
-    - 'lib/svg_conform/requirements/invalid_id_references_requirement.rb'

data/Gemfile

@@ -6,6 +6,8 @@ source "https://rubygems.org"
 gemspec
 
 gem "canon", "~>0.1.10"
+gem "lutaml-model", github: "lutaml/lutaml-model", branch: "main"
+gem "moxml", github: "lutaml/moxml", branch: "main"
 gem "openssl", "~> 3.0"
 gem "rake"
 gem "rspec"

data/README.adoc

@@ -33,6 +33,7 @@ SvgConform is distributed as a Ruby gem.
 * **100% SVGCheck compatibility**: Perfect error report matching with Python svgcheck tool
 * **Configurable RDF metadata support**: Choose strict or permissive RDF/Dublin Core handling
 * **Generic namespace handling**: Configuration-driven foreign namespace validation
+* **Text-as-path detection**: Warns when text is rendered as outlined path glyphs (quality check)
 
 
 == Concepts
@@ -360,6 +361,168 @@ SvgConform provides compatibility with existing SVG validation tools:
 See link:docs/compatibility.adoc[Compatibility Documentation] for details.
 
 
+[[image_quality]]
+== Image quality metric
+
+SvgConform provides a quality metric system for analyzing and scoring SVG files
+across multiple dimensions:
+
+* **Quality Score (0-100)**: Composite score based on error density, severity, and remediability
+* **Quality Level**: EXCELLENT, GOOD, FAIR, POOR, or CRITICAL
+* **Error Breakdown**: Counts by severity (critical, high, medium, low) and remediability
+* **Complexity Index**: 1-10 scale based on element count and advanced features
+* **Feature Detection**: Base64 images, foreign namespaces, masks, clip paths, external refs
+
+Reports are fully object-oriented: the same report object supports `to_yaml`, `to_json`,
+and colorful terminal rendering.
+
+[IMPORTANT]
+.Quality depends on validation profile
+====
+The quality score is calculated based on validation errors, which depend on the
+chosen profile. Different profiles have different rules, so the same SVG file
+may receive different quality scores under different profiles.
+
+Example: `colors.svg` scores 60 (FAIR) under `svg_1_2_rfc` but 100 (EXCELLENT)
+under `metanorma` because the profiles have different color restrictions.
+====
+
+[source,bash]
+----
+# Integrated into main CLI (svg_conform quality analyze)
+svg_conform quality analyze image.svg
+
+# Output as YAML
+svg_conform quality analyze image.svg -- --format yaml
+
+# Batch analyze a directory
+svg_conform quality batch ./svgs -- --output quality_report.csv
+
+# With different profile (affects quality score!)
+svg_conform quality analyze image.svg -- --profile metanorma
+----
+
+[source,ruby]
+----
+# Single file analysis - returns SvgQualityReport object
+analyzer = SvgConform::ImageQualityAnalyzer.new
+report = analyzer.analyze('image.svg')
+
+# Three output formats from the same object
+puts report.render      # Colorful terminal output
+puts report.to_yaml    # YAML serialization
+puts report.to_json    # JSON serialization
+
+# Access attributes directly
+puts "Quality: #{report.quality_score} (#{report.quality_level})"
+puts "Errors: #{report.error_count} (#{report.remediable_errors} remediable)"
+puts "Complexity: #{report.complexity_index}/10"
+
+# Batch analysis - returns SvgQualityBatchReport object
+batch = analyzer.analyze_batch('./svgs')
+puts batch.render        # Summary with distribution chart
+puts batch.to_yaml      # Full YAML with all reports
+
+# Filter and process reports
+poor_files = batch.reports.select { |r| r.quality_level == :poor }
+----
+
+For detailed documentation including custom configuration and CLI options, see
+link:docs/image_quality.adoc[Image Quality Metric Documentation].
+
+=== CLI output examples
+
+.Single file analysis with default profile (svg_1_2_rfc)
+[source,text]
+----
+$ svg_conform quality analyze spec/fixtures/svgcheck/inputs/colors.svg
+
+📊 SVG Quality Report: colors.svg
+
+  ⚠️ Quality: 60 (FAIR)
+  🔶 Content Health: moderate_issues
+
+  📁 File: 1.41 KB (small)
+  📐 Elements: 17
+  🔢 Complexity: 1.0/10
+
+Errors: 12
+  🔧 Remediable: 12
+  ⚠️  Non-remediable: 0
+
+  Breakdown:
+    ● Medium: 12
+----
+
+.Same file with metanorma profile (no color restrictions)
+[source,text]
+----
+$ svg_conform quality analyze spec/fixtures/svgcheck/inputs/colors.svg -- --profile metanorma
+
+📊 SVG Quality Report: colors.svg
+
+  ✨ Quality: 100 (EXCELLENT)
+  ✅ Content Health: good
+
+  📁 File: 1.41 KB (small)
+  📐 Elements: 17
+  🔢 Complexity: 1.0/10
+
+Errors: 0
+  🔧 Remediable: 0
+  ⚠️  Non-remediable: 0
+----
+
+.Single file analysis (YAML output)
+[source,yaml]
+----
+$ svg_conform quality analyze spec/fixtures/svgcheck/inputs/colors.svg -- --format yaml
+
+---
+file_path: spec/fixtures/svgcheck/inputs/colors.svg
+quality_score: 60
+quality_level: :fair
+error_count: 12
+remediable_errors: 12
+...
+----
+
+.Single file analysis (JSON output)
+[source,json]
+----
+$ svg_conform quality analyze spec/fixtures/svgcheck/inputs/colors.svg -- --format json
+
+{"file_path":"spec/fixtures/svgcheck/inputs/colors.svg","quality_score":60,...}
+----
+
+.Batch summary (terminal output with distribution chart)
+[source,text]
+----
+$ svg_conform quality batch spec/fixtures/svgcheck/inputs -- --summary-only
+
+📊 SVG Quality Batch Report
+
+  📁 Total Files: 19
+  ✅ Successful: 19
+
+Quality Distribution
+
+  ✨ EXCELLENT  ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    2 (10.5%)
+  👍 GOOD       ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    2 (10.5%)
+  ⚠️ FAIR       ████████████████████████████████████████   13 (68.4%)
+  😟 POOR       ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    2 (10.5%)
+  💥 CRITICAL   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    0 (0.0%)
+
+Summary
+
+  📈 Average Quality Score: 61.6/100
+  📊 Average Errors/File: 204.3
+
+  🔧 Total Remediable: 3872
+  ⚠️  Total Non-remediable: 10
+----
+
+
 == Documentation
 
 === User documentation
@@ -371,6 +534,7 @@ See link:docs/compatibility.adoc[Compatibility Documentation] for details.
 * link:docs/remediation.adoc[Remediation Reference] - All automatic remediations
 * link:docs/reference_manifest.adoc[Reference Manifest] - ID and reference tracking
 * link:docs/rdf_metadata_support.adoc[RDF Metadata Support] - RDF/Dublin Core configuration
+* link:docs/image_quality.adoc[Image Quality Metric] - Quality scoring and analysis
 
 === Developer documentation
 

data/config/profiles/metanorma.yml

@@ -187,6 +187,13 @@ requirements:
     check_image_elements: true
     check_style_images: true
 
+  # Text-as-path detection - warns when text is rendered as outlined paths
+  - id: "text_as_path"
+    type: "TextAsPathRequirement"
+    description: "Detects text rendered as outlined paths instead of native <text> elements"
+    min_d_length: 500
+    min_bezier: 5
+
 remediations:
   # ViewBox auto-generation
   - id: "viewbox_generation"

data/config/quality_metrics.yml

@@ -0,0 +1,212 @@
+# SVG Quality Metrics Configuration
+#
+# This file defines the quality scoring system for SVG files.
+# Customize these values to adjust how quality scores are calculated.
+#
+# The configuration supports:
+# - Severity level definitions for different violation types
+# - Remediation classification (remediable vs non-remediable errors)
+# - Quality score formula weights
+# - Quality level score thresholds
+# - Size category thresholds
+# - Complexity index calculation
+# - Feature detection patterns
+
+# ============================================================================
+# Severity Level Definitions
+# ============================================================================
+# Each severity level defines which violation types fall into it,
+# the default weight per error, and the maximum penalty for that level.
+#
+# Scores are calculated as: error_count * weight, capped at max_penalty
+
+severity_levels:
+  critical:
+    description: "Breaks document validity or breaks links (broken references, structural issues)"
+    violation_types:
+      - :reference_violation  # Broken ID references (xlink:href to missing IDs)
+      - :structural_violation  # Root element wrong, malformed XML, invalid document
+    default_weight: 5
+    max_penalty: 20
+
+  high:
+    description: "Breaks rendering or poses security risks"
+    violation_types:
+      - :viewbox_violation  # Missing or malformed viewBox
+      - :namespace_violation  # Invalid or disallowed namespaces
+      - :content_violation  # Forbidden elements (script, iframe, etc.)
+    default_weight: 3
+    max_penalty: 15
+
+  medium:
+    description: "Visual or formatting issues"
+    violation_types:
+      - :color_violation  # Non-standard colors
+      - :font_violation  # Non-standard fonts
+    default_weight: 1
+    max_penalty: 10
+
+  low:
+    description: "Informational - style promotion opportunities"
+    violation_types:
+      - :style_violation  # CSS properties that could be promoted to attributes
+    default_weight: 0
+    max_penalty: 0
+
+# ============================================================================
+# Remediation Classification
+# ============================================================================
+# Defines which violation types can be automatically fixed vs require human
+# intervention.
+
+# Violation types that can be auto-fixed
+remediable_types:
+  - :color_violation
+  - :font_violation
+  - :content_violation
+  - :reference_violation
+  - :namespace_violation
+  - :viewbox_violation
+  - :style_violation
+
+# Violation types that require manual intervention
+non_remediable_types:
+  - :structural_violation
+
+# ============================================================================
+# Quality Score Formula
+# ============================================================================
+# Weights used in the quality score calculation (0-100 scale)
+#
+# Formula:
+#   base_score = 100
+#   base_score -= (error_density * error_density_weight).clamp(0, error_density_max_penalty)
+#   base_score -= non_remediable_count * non_remediable_weight
+#   base_score -= critical_count * critical_weight
+#   base_score -= high_count * high_weight
+#   base_score += valid_structure_bonus if error_count == 0
+
+quality_formula:
+  # Error density penalty (errors per KB)
+  error_density_weight: 8
+  error_density_max_penalty: 40
+
+  # Per-error penalties
+  non_remediable_weight: 6
+  non_remediable_max_penalty: 30
+
+  critical_weight: 5
+  critical_max_penalty: 20
+
+  high_weight: 3
+  high_max_penalty: 15
+
+  # Bonus for error-free files
+  valid_structure_bonus: 10
+
+# ============================================================================
+# Quality Level Thresholds
+# ============================================================================
+# Score ranges for each quality level
+
+quality_levels:
+  excellent:
+    min_score: 90
+    max_score: 100
+    description: "No errors or minor style issues only"
+
+  good:
+    min_score: 70
+    max_score: 89
+    description: "Few easily fixable issues"
+
+  fair:
+    min_score: 50
+    max_score: 69
+    description: "Multiple remediable issues"
+
+  poor:
+    min_score: 30
+    max_score: 49
+    description: "Some non-remediable issues or many errors"
+
+  critical:
+    min_score: 0
+    max_score: 29
+    description: "Major structural problems or many critical errors"
+
+# ============================================================================
+# Size Category Thresholds
+# ============================================================================
+# File size thresholds in KB
+
+size_categories:
+  tiny: 5      # < 5 KB
+  small: 20     # 5-20 KB
+  medium: 100   # 20-100 KB
+  large: 500    # 100-500 KB
+  # > 500 KB = huge
+
+# ============================================================================
+# Complexity Index Calculation
+# ============================================================================
+# Complexity is scored on a 1-10 scale based on element count, nesting depth,
+# and use of advanced SVG features.
+
+complexity:
+  # Base multiplier for element count
+  base_element_multiplier: 0.5
+
+  # Weight for maximum nesting depth
+  depth_weight: 0.1
+
+  # Bonuses for using advanced features
+  feature_bonuses:
+    has_masks: 1.0
+    has_clip_paths: 0.5
+    has_base64: 1.5
+    has_foreign_ns: 0.5
+    has_external_refs: 0.5
+
+  # Maximum complexity score
+  max_index: 10
+
+# ============================================================================
+# Feature Detection Patterns
+# ============================================================================
+# Regex patterns for detecting SVG features in raw content.
+# Used for quick feature flags before full parsing.
+
+feature_patterns:
+  # Base64 encoded images
+  base64: "(?:data:image|ImageUri).*base64.*"
+
+  # Foreign namespaces (anything not svg/xlink)
+  foreign_ns: 'xmlns:(?!svg|xlink)'
+
+  # Mask elements
+  masks: "<[\\s]*mask[\\s\\S]*?>"
+
+  # Clip path elements
+  clip_paths: "<[\\s]*clipPath[\\s\\S]*?>"
+
+  # External references (http/https URLs in href/xlink:href)
+  external_refs: "(?:xlink:)?href.*https?://"
+
+# ============================================================================
+# Content Health Thresholds
+# ============================================================================
+# Rules for determining content health status
+
+content_health:
+  # Minor issues: few low/medium errors only
+  minor_issues_max_errors: 10
+  minor_issues_max_severity: medium
+
+  # Moderate issues: more errors OR any high-severity
+  moderate_issues_max_errors: 50
+  moderate_issues_any_high: true
+
+  # Severe issues: many errors OR any critical
+  severe_issues_min_errors: 50
+  severe_issues_any_critical: true