svgom: introduce the SVGGraphicsElement and SVGGeometryElement interfaces

The interfaces do not have all their SVG2 methods, looking for compatibility with SVG 1.1.

Author: carlosame

svgom-api/src/main/java/org/w3c/dom/svg/SVGCircleElement.java

@@ -14,8 +14,8 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGCircleElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGStylable,
-		SVGTransformable, EventTarget {
+public interface SVGCircleElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget {
 	SVGAnimatedLength getCx();
 
 	SVGAnimatedLength getCy();

svgom-api/src/main/java/org/w3c/dom/svg/SVGClipPathElement.java

@@ -12,7 +12,7 @@
 
 package org.w3c.dom.svg;
 
-public interface SVGClipPathElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired,
-		SVGStylable, SVGTransformable, SVGUnitTypes {
+public interface SVGClipPathElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		SVGUnitTypes {
 	SVGAnimatedEnumeration getClipPathUnits();
 }

svgom-api/src/main/java/org/w3c/dom/svg/SVGEllipseElement.java

@@ -14,8 +14,8 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGEllipseElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired,
-		SVGStylable, SVGTransformable, EventTarget {
+public interface SVGEllipseElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget {
 	SVGAnimatedLength getCx();
 
 	SVGAnimatedLength getCy();

svgom-api/src/main/java/org/w3c/dom/svg/SVGGeometryElement.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright © 2023 W3C®.
+ * 
+ * This software or document includes material copied from or derived from
+ * https://svgwg.org/specs/animations/
+ *
+ * [1] https://www.w3.org/copyright/software-license-2023/
+ */
+
+// SPDX-License-Identifier: W3C-20150513
+
+package org.w3c.dom.svg;
+
+/**
+ * Represents SVG elements whose rendering is defined by geometry with an
+ * equivalent path, and which can be filled and stroked.
+ */
+public interface SVGGeometryElement extends SVGGraphicsElement {
+
+	/**
+	 * Gets the read-only {@code pathLength} attribute, which is the author's
+	 * computation of the total length of the path, in user units.
+	 * <p>
+	 * The {@code pathLength} attribute has no effect on percentage
+	 * distance-along-a-path calculations.
+	 * </p>
+	 * 
+	 * @return the total length of the path, in user units.
+	 */
+	SVGAnimatedNumber getPathLength();
+
+	/**
+	 * Get the length of the path.
+	 * 
+	 * @return the length of the path, in user units.
+	 */
+	float getTotalLength();
+
+	/**
+	 * Gets the point at a given distance along the path.
+	 * <p>
+	 * When getPointAtLength(distance) is called, the following steps are run:
+	 * </p>
+	 * <ol>
+	 * <li>If current element is a non-rendered element, and the UA is not able to
+	 * compute the total length of the path, then throw an InvalidStateError.</li>
+	 * <li>Let length be the user agent's computed value for the total length of the
+	 * path, in user units.
+	 * <p>
+	 * As with getTotalLength, this does not take into account the
+	 * {@code pathLength} attribute.
+	 * </p>
+	 * </li>
+	 * <li>Clamp distance to [0, length].</li>
+	 * <li>Let (x, y) be the point on the path at distance distance.</li>
+	 * <li>Return a newly created, detached DOMPoint object representing the point
+	 * (x, y).</li>
+	 * </ol>
+	 * </p>
+	 * 
+	 * @param distance the distance.
+	 * @return the point at a given distance along the path.
+	 */
+	SVGPoint getPointAtLength(float distance);
+
+}

svgom-api/src/main/java/org/w3c/dom/svg/SVGGraphicsElement.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright © 2023 W3C®.
+ * 
+ * This software or document includes material copied from or derived from
+ * https://svgwg.org/specs/animations/
+ *
+ * [1] https://www.w3.org/copyright/software-license-2023/
+ */
+
+// SPDX-License-Identifier: W3C-20150513
+
+package org.w3c.dom.svg;
+
+/**
+ * Represents SVG elements whose primary purpose is to directly render graphics
+ * into a group.
+ */
+public interface SVGGraphicsElement extends SVGElement, SVGStylable, SVGTests, SVGTransformable {
+}

svgom-api/src/main/java/org/w3c/dom/svg/SVGLineElement.java

@@ -14,8 +14,8 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGLineElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGStylable,
-		SVGTransformable, EventTarget {
+public interface SVGLineElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget {
 	SVGAnimatedLength getX1();
 
 	SVGAnimatedLength getY1();

svgom-api/src/main/java/org/w3c/dom/svg/SVGPathElement.java

@@ -14,14 +14,8 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGPathElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGStylable,
-		SVGTransformable, EventTarget, SVGAnimatedPathData {
-	SVGAnimatedNumber getPathLength();
-
-	float getTotalLength();
-
-	SVGPoint getPointAtLength(float distance);
-
+public interface SVGPathElement extends SVGGeometryElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget, SVGAnimatedPathData {
 	int getPathSegAtLength(float distance);
 
 	SVGPathSegClosePath createSVGPathSegClosePath();

svgom-api/src/main/java/org/w3c/dom/svg/SVGPolygonElement.java

@@ -14,6 +14,6 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGPolygonElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired,
-		SVGStylable, SVGTransformable, EventTarget, SVGAnimatedPoints {
+public interface SVGPolygonElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget, SVGAnimatedPoints {
 }

svgom-api/src/main/java/org/w3c/dom/svg/SVGRectElement.java

@@ -14,8 +14,8 @@
 
 import org.w3c.dom.events.EventTarget;
 
-public interface SVGRectElement extends SVGElement, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGStylable,
-		SVGTransformable, EventTarget {
+public interface SVGRectElement extends SVGGraphicsElement, SVGLangSpace, SVGExternalResourcesRequired,
+		EventTarget {
 	SVGAnimatedLength getX();
 
 	SVGAnimatedLength getY();