@hyperframes/lint 0.8.196 → 0.8.197

package/dist/browser.js

@@ -5788,6 +5788,37 @@ ${other.raw}`)
     }
     return findings;
   },
+  // svg_round_cap_hidden_dash — a round or square cap hides a path with dash == gap == pathLength and
+  // offset == dash. The next dash then starts exactly at the path end, and Chrome's float rounding
+  // leaves a sliver there that the cap paints as a dot, on some curves and not others.
+  ({ tags }) => {
+    const findings = [];
+    for (const tag of tags) {
+      const style = readAttr(tag.raw, "style") ?? "";
+      const read = (name) => readAttr(tag.raw, name) ?? readStyleProperty(style, name);
+      const cap = read("stroke-linecap");
+      if (cap !== "round" && cap !== "square") continue;
+      const pathLength = Number(readAttr(tag.raw, "pathLength"));
+      const offset = Number(read("stroke-dashoffset"));
+      const dashes = (read("stroke-dasharray") ?? "").split(/[\s,]+/).map(Number);
+      const [dash, gap = dash] = dashes;
+      if (dashes.length > 2 || dash === void 0 || gap === void 0) continue;
+      if (![pathLength, offset, dash, gap].every(Number.isFinite) || pathLength <= 0) continue;
+      const period = dash + gap;
+      if (period <= 0 || offset < 0) continue;
+      const nextDashAt = period - offset % period;
+      if (offset % period < dash || Math.abs(nextDashAt - pathLength) > pathLength * 1e-6) continue;
+      findings.push({
+        code: "svg_round_cap_hidden_dash",
+        severity: "warning",
+        message: `<${tag.name}> is hidden with stroke-dasharray ${dash}${dashes.length > 1 ? ` ${gap}` : ""} and stroke-dashoffset ${offset} on pathLength ${pathLength}, but its ${cap} cap can still paint a dot at the end of the path (Chrome rounds the zero-length dash differently per curve).`,
+        elementId: readAttr(tag.raw, "id") ?? void 0,
+        fixHint: `Make the gap longer than the path (stroke-dasharray "${pathLength} ${+(pathLength * 1.2).toFixed(3)}" with stroke-dashoffset ${+(pathLength * 1.1).toFixed(3)}), or keep the element visibility:hidden until its draw tween starts.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+    }
+    return findings;
+  },
   // svg_measure_before_path_d — getTotalLength() on a <path> that has no static `d`
   // attribute in the HTML. In Chrome getTotalLength() on a d-less path returns 0,
   // silently killing dash animations (offset 0 == length 0 == nothing to draw). If a

package/dist/index.js

@@ -5794,6 +5794,37 @@ ${other.raw}`)
     }
     return findings;
   },
+  // svg_round_cap_hidden_dash — a round or square cap hides a path with dash == gap == pathLength and
+  // offset == dash. The next dash then starts exactly at the path end, and Chrome's float rounding
+  // leaves a sliver there that the cap paints as a dot, on some curves and not others.
+  ({ tags }) => {
+    const findings = [];
+    for (const tag of tags) {
+      const style = readAttr(tag.raw, "style") ?? "";
+      const read = (name) => readAttr(tag.raw, name) ?? readStyleProperty(style, name);
+      const cap = read("stroke-linecap");
+      if (cap !== "round" && cap !== "square") continue;
+      const pathLength = Number(readAttr(tag.raw, "pathLength"));
+      const offset = Number(read("stroke-dashoffset"));
+      const dashes = (read("stroke-dasharray") ?? "").split(/[\s,]+/).map(Number);
+      const [dash, gap = dash] = dashes;
+      if (dashes.length > 2 || dash === void 0 || gap === void 0) continue;
+      if (![pathLength, offset, dash, gap].every(Number.isFinite) || pathLength <= 0) continue;
+      const period = dash + gap;
+      if (period <= 0 || offset < 0) continue;
+      const nextDashAt = period - offset % period;
+      if (offset % period < dash || Math.abs(nextDashAt - pathLength) > pathLength * 1e-6) continue;
+      findings.push({
+        code: "svg_round_cap_hidden_dash",
+        severity: "warning",
+        message: `<${tag.name}> is hidden with stroke-dasharray ${dash}${dashes.length > 1 ? ` ${gap}` : ""} and stroke-dashoffset ${offset} on pathLength ${pathLength}, but its ${cap} cap can still paint a dot at the end of the path (Chrome rounds the zero-length dash differently per curve).`,
+        elementId: readAttr(tag.raw, "id") ?? void 0,
+        fixHint: `Make the gap longer than the path (stroke-dasharray "${pathLength} ${+(pathLength * 1.2).toFixed(3)}" with stroke-dashoffset ${+(pathLength * 1.1).toFixed(3)}), or keep the element visibility:hidden until its draw tween starts.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+    }
+    return findings;
+  },
   // svg_measure_before_path_d — getTotalLength() on a <path> that has no static `d`
   // attribute in the HTML. In Chrome getTotalLength() on a d-less path returns 0,
   // silently killing dash animations (offset 0 == length 0 == nothing to draw). If a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.8.196",
+  "version": "0.8.197",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -35,7 +35,7 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.4",
-    "@hyperframes/parsers": "0.8.196"
+    "@hyperframes/parsers": "0.8.197"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",