svg_conform 0.1.12 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 162ed406493cfabb9a3cb94a3a6ba2ee3ed4ae95d3edf912034c17974d5cc496
-  data.tar.gz: 56cb8b2d5e94bcce3cc1e32b513a738ac2140f0e86848e6c101fc08ed16cfc7a
+  metadata.gz: 136c672fbb6005495a240d2d8b7f30000fae008cd16fff6bfe51a74e7dbe2262
+  data.tar.gz: 679452859b709b2e9ef78916918ea9e58040ebfb382291b8c6543b9062a5ee09
 SHA512:
-  metadata.gz: 1bcbdf1a7dbc43f044aa875d7a310b85064bcd47d5f227cf962303d1f3a0d024fe926b87ffc201fbf5256b0e150cfa71b5a8702e84b062b37d7935a50bc96b5b
-  data.tar.gz: 817c9ac5561b509c39e9f4d228b4165d3943a242bb83a88c77e8388bbce99c6746dc9c9df464a729ce44160c331b08ce9dfcc06e98c676c2944631eaf35346e5
+  metadata.gz: 26a32728202834b61e892d78ef87bb6bae0030e768414985cfe0bfa208da9fa21828035fe6f247225c6cd37a299dff6fe91863c70137c528d7e24a9aade3250e
+  data.tar.gz: 47b4ba1d348244438817269403a2b5b09019687024849e691ff6fe4dcbb9d4fed1a322f132758af38f8ba1310fb0666cc5d9dbaeef93192a8edaf19df66bb1c9

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

@@ -21,7 +21,7 @@ requirements:
     element_configs:
       # Direct encoding from svgcheck word_properties.py elements dictionary
       - tag: "svg"
-        attributes: ["version", "baseProfile", "width", "viewBox", "preserveAspectRatio", "snapshotTime", "height", "id", "role", "break", "color-rendering", "fill-rule", "overflow", "data-name"]
+        attributes: ["version", "baseProfile", "width", "viewBox", "preserveAspectRatio", "snapshotTime", "height", "id", "role", "break", "color-rendering", "fill-rule", "overflow", "data-name", "clip-path", "mask"]
         required_attributes: ["version", "baseProfile"]
         attribute_values:
           version: ["1.2"]
@@ -34,37 +34,37 @@ requirements:
         attributes: ["id", "role", "shape-rendering", "text-rendering", "buffered-rendering", "visibility", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "fill-rule"]
         allowed_children: ["text"]
       - tag: "path"
-        attributes: ["d", "pathLength", "stroke-miterlimit", "id", "role", "fill", "style", "transform", "font-size", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["d", "pathLength", "stroke-miterlimit", "id", "role", "fill", "style", "transform", "font-size", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "rect"
-        attributes: ["x", "y", "width", "height", "rx", "ry", "stroke-miterlimit", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["x", "y", "width", "height", "rx", "ry", "stroke-miterlimit", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "circle"
-        attributes: ["cx", "cy", "r", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["cx", "cy", "r", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "line"
-        attributes: ["x1", "y1", "x2", "y2", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["x1", "y1", "x2", "y2", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "ellipse"
-        attributes: ["cx", "cy", "rx", "ry", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["cx", "cy", "rx", "ry", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "polyline"
-        attributes: ["points", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["points", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "polygon"
-        attributes: ["points", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["points", "id", "role", "fill", "style", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "solidColor"
-        attributes: ["id", "role", "fill", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["id", "role", "fill", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "textArea"
-        attributes: ["x", "y", "width", "height", "auto", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["x", "y", "width", "height", "auto", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["desc", "title", "tspan", "text", "a"]
       - tag: "text"
-        attributes: ["x", "y", "rotate", "id", "role", "fill", "style", "transform", "font-size", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "font-stretch", "writing-mode", "text-decoration"]
+        attributes: ["x", "y", "rotate", "id", "role", "fill", "style", "transform", "font-size", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "font-stretch", "writing-mode", "text-decoration", "clip-path", "mask"]
         allowed_children: ["desc", "title", "tspan", "text", "a"]
       - tag: "g"
-        attributes: ["label", "class", "id", "role", "fill", "style", "transform", "fill-rule", "visibility", "base", "lang", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "data-name"]
+        attributes: ["label", "class", "id", "role", "fill", "style", "transform", "fill-rule", "visibility", "base", "lang", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "data-name", "clip-path", "mask"]
         allowed_children: ["title", "path", "rect", "circle", "line", "ellipse", "polyline", "polygon", "solidColor", "textArea", "text", "g", "defs", "use", "a", "tspan", "desc", "image"]
       - tag: "defs"
         attributes: ["id", "role", "fill", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
@@ -97,7 +97,7 @@ requirements:
         attributes: ["type", "media", "title", "id", "class"]
         allowed_children: []
       - tag: "use"
-        attributes: ["x", "y", "href", "xlink:href", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
+        attributes: ["x", "y", "href", "xlink:href", "id", "role", "fill", "transform", "fill-rule", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
       - tag: "a"
         attributes: ["id", "role", "fill", "transform", "fill-rule", "target", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
@@ -108,7 +108,7 @@ requirements:
       - tag: "tbreak"
         attributes: ["id", "role", "base", "lang", "class", "rel", "rev", "typeof", "content", "datatype", "resource", "about", "property", "space"]
       - tag: "image"
-        attributes: ["x", "y", "width", "height", "href", "xlink:href", "preserveAspectRatio", "id", "class", "style", "transform"]
+        attributes: ["x", "y", "width", "height", "href", "xlink:href", "preserveAspectRatio", "id", "class", "style", "transform", "clip-path", "mask"]
         allowed_children: ["title", "desc"]
     check_attributes: true
     check_invalid_attributes: true
@@ -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"