fix: align hue budget with supertensor — per-row instead if figure-wide

Adopt per-row ≤4 active hue families, matching supertensor's documented
behavior. Also changed tests/lint-invalid/hue-budget.tex to use \sfrow
so the per-row rule actually triggers.

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: superfig
-description: Create or refine clean paper-style figures for non-tensor concepts — architecture and block diagrams, pipelines and data flow, state/time flows, dependency graphs, and conceptual mechanism diagrams. Use whenever a paper idea should be explained with clear nodes, edges, grouping, captions, and a short meaning box in a muted slide-ready style. Not for tensor/matrix/shape semantics (use supertensor) or plotting numeric data.
+description: Create or refine clean paper-style figures for non-tensor concepts — architecture and block diagrams, pipelines and data flow, state/time flows, dependency graphs, and conceptual mechanism diagrams. Use whenever a paper idea should be explained with clear nodes, edges, grouping, captions, and a short meaning box in a muted slide-ready style, or the user runs $superfig. Not for tensor/matrix/shape semantics (use supertensor), stepwise rewrite figures (use superderive), full paper notes (use superpaper), or plotting numeric data.
 ---
 
 # superfig

scripts/lint.py

@@ -19,6 +19,7 @@ ROLE_KEY_RE = re.compile(r"role\s*=\s*([A-Za-z0-9_-]+)")
 RAW_TIKZ_RE = re.compile(r"\\(?:draw|fill|path)\b")
 ROW_NAME_RE = re.compile(r"\\sfrow\{([^{}]+)\}")
 CALLOUT_RE = re.compile(r"\\sfcallout\{([^{}]+)\}\{[^{}]+\}\{([^{}]+)\}")
+ROW_RE = re.compile(r"\\sfrow\{[^{}]+\}\{[^{}]+\}(.*?)\\sfrowend", re.DOTALL)
 GROUP_RE = re.compile(
     r"\\sfgroup(?:\[[^\]]*\])?\{([^{}]+)\}\{([^{}]*)\}\{([^{}]*)\}"
 )
@@ -57,7 +58,6 @@ def lint(path: Path) -> list[str]:
         else:
             declared[name] = color
 
-    used_colors = {"sfGray"}
     for match in ROLE_KEY_RE.finditer(source):
         role = match.group(1)
         color = declared.get(role)
@@ -66,13 +66,15 @@ def lint(path: Path) -> list[str]:
                 f"line {line_of(source, match.start())}: role {role!r} is used "
                 f"before \\sfsetrole"
             )
-        else:
-            used_colors.add(color)
 
-    active = used_colors - {"sfGray"}
+    for row_number, row in enumerate(ROW_RE.finditer(source), start=1):
+        row_roles = set(ROLE_KEY_RE.findall(row.group(1)))
+        colors = {declared.get(role, "<undeclared>") for role in row_roles}
+        active = colors - {"sfGray"}
         if len(active) > 4:
             errors.append(
-            f"figure uses {len(active)} active hue families "
+                f"line {line_of(source, row.start())}: row {row_number} uses "
+                f"{len(active)} active hue families "
                 f"({', '.join(sorted(active))}); maximum is 4 plus gray"
             )
 

tests/lint-invalid/hue-budget.tex

@@ -6,9 +6,11 @@
 \sfsetrole{d}{sfViolet}
 \sfsetrole{e}{sfInk}
 \begin{document}\begin{tikzpicture}
-\sfnode[role=a, at={(0,0)}]{A}{A}{8mm}{8mm}
-\sfnode[role=b, at={(12mm,0)}]{B}{B}{8mm}{8mm}
-\sfnode[role=c, at={(24mm,0)}]{C}{C}{8mm}{8mm}
-\sfnode[role=d, at={(36mm,0)}]{D}{D}{8mm}{8mm}
-\sfnode[role=e, at={(48mm,0)}]{E}{E}{8mm}{8mm}
+\sfrow{R1}{14mm}
+  \sfnode[role=a]{A}{A}{8mm}{8mm}
+  \sfnode[role=b]{B}{B}{8mm}{8mm}
+  \sfnode[role=c]{C}{C}{8mm}{8mm}
+  \sfnode[role=d]{D}{D}{8mm}{8mm}
+  \sfnode[role=e]{E}{E}{8mm}{8mm}
+\sfrowend
 \end{tikzpicture}\end{document}