v2.0.0: Update rules to match HTML Academy codeguide by meritt · Pull Request #28 · htmlacademy/linthtml-config-htmlacademy

meritt · 2026-01-25T18:20:44Z

Synchronised with linthtml-rules-htmlacademy#115 and codeguide#75. This is the config side of the joint 2.0.0 release — what the default preset now expects from HTML.

The package has been migrated to ESM (type: "module", configuration file renamed index.js → linthtml.config.js). Node.js requirement is now >=24. Everything below describes how the default preset has changed.

Newly activated rules

Ten plugin rules joined the preset, expanding its coverage of forms, accessibility, and modern HTML:

htmlacademy/a-target-rel — <a target="_blank"> must declare rel="noreferrer". Per the HTML spec, noreferrer implicitly enables noopener, so one keyword covers both privacy (no Referer header) and security (no window.opener).
htmlacademy/attr-order — enforces the codeguide attribute order `class → src/href → data-* → others`.
htmlacademy/boolean-attr-no-value — boolean attributes (disabled, checked, required, autofocus, hidden, open, async, defer, autoplay, controls, loop, muted, …) must be written without a value. <input disabled> — yes, <input disabled="disabled"> — no.
htmlacademy/heading-level — heading levels must not skip (<h1> → <h3> is flagged) and the document must start with <h1>.
htmlacademy/icon-button-aria-label — <button> without visible text must declare an accessible name via aria-label, aria-labelledby, or title.
htmlacademy/input-name-unique — duplicate <input name> within the same <form> is flagged; radio and checkbox groups are exempt.
htmlacademy/label-req-for — every <label> must be associated with a form control either through for/id or through a nested control.
htmlacademy/label-req-text — <label> must contain visible text content (or aria-label). Closes the <label for="x"><input id="x"></label> no-text loophole.
htmlacademy/req-submit-button — every <form> must contain a submit button.
htmlacademy/svg-role-img — inline <svg> must declare itself either as content (role="img" + aria-label/aria-labelledby) or as decorative (aria-hidden="true").
htmlacademy/tag-forbid-attr activated with the redundant-type rule: <link type="text/css"> and <script type="text/javascript"> are flagged (these HTML4 defaults have not been required since HTML5).

Replaced / removed

htmlacademy/img-svg-req-dimensions → htmlacademy/replaced-elements-req-dimensions — the renamed rule now covers <img>, <svg>, <video>, and <iframe>.
htmlacademy/class-first removed from the preset — fully subsumed by htmlacademy/attr-order (which checks the full attribute order, not only the position of class).
button-req-content (base linthtml rule) removed from the preset — replaced by htmlacademy/icon-button-aria-label, which is broader: it recognises aria-label, aria-labelledby, and title, not just text content or aria-label. Eliminates the duplicate report on empty/icon-only buttons.

Configuration adjustments to existing rules

htmlacademy/attribute-allowed-values.input.type — whitelist expanded from 11 to 22 entries, covering every HTML5 <input type> value. The previous list was effectively a no-op because the rule itself was broken in the previous release (see linthtml-rules-htmlacademy#115); now that the rule actually executes, the policy is to allow every spec value and rely on other rules for narrower constraints.
htmlacademy/tag-req-attr.form — added requirement for the method attribute on <form>. Forms must now declare method="get" or method="post".
htmlacademy/tag-self-close — set to [true, 'never']. In the previous release the rule was activated as true (no option), which left it silent due to a missing-option early return in the rule body. The preset now actually flags <br/>, <img/>, and similar void self-closers.
htmlacademy/no-px-size — extended to <video> and <iframe> (was <img> and <svg> only).
htmlacademy/charset-position — fixed so it actually requires the first <head> child to be <meta charset>. Previously any first <meta> (e.g. <meta name="viewport">) passed silently because of inverted logic.
htmlacademy/aria-label-misuse — aria-label on <svg role="img"> is no longer flagged. Content SVG legitimately uses this pattern.
attr-name-ignore-regex (top-level option) — expanded to cover 42 camelCase SVG attributes (viewBox, preserveAspectRatio, xlink:href, gradientTransform, patternUnits, markerWidth, attributeName, stdDeviation, baseFrequency, …). Without this, the attr-name-style: dash rule reports valid SVG markup. Closes Актуализировать список атрибутов исключений SVG #19.
htmlacademy/tag-name-lowercase.ignore — expanded to all SVG filter primitives (feBlend, feColorMatrix, feGaussianBlur, …) and other camelCase SVG tags (foreignObject, animateTransform, animateMotion).

Behavioural summary

What used to pass on main but no longer passes:

<a href="/x" target="_blank">External</a>            <!-- needs rel="noreferrer" -->
<form action="/api"><input type="text"></form>      <!-- needs method + submit -->
<button type="button"><svg></svg></button>           <!-- needs aria-label -->
<h1>x</h1><h3>y</h3>                                <!-- no heading-level skip -->
<input type="checkbox" checked="checked">            <!-- write just "checked" -->
<label for="q"><input id="q"></label>               <!-- label needs visible text -->
<svg width="20" height="20"></svg>                    <!-- needs role or aria-hidden -->
<input type="text" name="q"><input name="q">      <!-- duplicate non-radio name -->
<br/>                                               <!-- void elements must not self-close -->
<link rel="stylesheet" href="s.css" type="text/css"> <!-- redundant type -->

What used to fail on main but now passes:

<picture><source type="image/avif" srcset="p.avif"><img src="p.jpg"></picture>
<!-- AVIF is now an accepted modern alternative to WebP in <picture> -->

Cleanup

linthtml.config.js was rewritten as a clean default preset. Dead *: false entries for base rules that simply are not listed (linthtml ignores unlisted rules), redundant top-level options (id-class-ignore-regex, line-max-len-ignore-regex, stray spec-char-escape), and explanatory comments were removed. SVG tag/attribute lists and the input-type whitelist were extracted into named constants. Rules are sorted alphabetically inside each block. The file went from 180 to 116 lines.

Closes

Актуализировать список атрибутов исключений SVG #19 (SVG ignore lists)

meritt · 2026-01-25T18:35:34Z

@nikolai-shabalin ну гулять дк гулять

nikolai-shabalin · 2026-05-09T10:45:40Z

  'rules': {
    'htmlacademy/space-between-comments': [true, 'space'],
-    'htmlacademy/a-target-rel': true,
+    'htmlacademy/a-target-rel': false, // browsers add rel="noopener" automatically since 2020


Вернуть как было

nikolai-shabalin · 2026-05-09T10:51:25Z

+    "linthtml"
+  ],
+  "license": "MIT",
+  "author": {


Авторов можно указать несколько в массиве через запятую

meritt added 6 commits January 25, 2026 21:13

Update ISSUE TEMPLATE

0c1e434

Update .gitignore and add .editroconfig

7af20b8

Update linting rules

47f8a09

Update package.json, readme and changelog

8a0f352

Bump deps

f435acb

Update changelog

66df2de

meritt self-assigned this Jan 25, 2026

meritt mentioned this pull request Jan 25, 2026

v2.0.0: Update custom rules to match HTML Academy codeguide htmlacademy/linthtml-rules-htmlacademy#115

Merged

meritt added 7 commits April 8, 2026 15:49

Фиксирует версию Node.js

a2629bf

Чистит, обновляет и выравнивает синтаксис package.json

1ce9339

Обновляет файлы конфигурации GitHub Actions

078f52b

Убирает проверку noopener, уже неактуально

98add70

Обновляет README.md

a612ce2

Обновляет actions, приводит к единому .gitignore и package.json

74a5f19

Убирает ISSUE_TEMPLATE из проекта

1fc7aed

nikolai-shabalin reviewed May 9, 2026

View reviewed changes

meritt added 8 commits May 19, 2026 18:02

Migrate to ESM

c72d23e

Update tests

255f1d0

Remove old file

b42a96a

Update docs

62b159f

Update default preset

470965c

Возвращает a-target-rel в дефолты

93f6948

Bump deps

0958a29

Add release date

b979c40

meritt merged commit a4c992c into main May 20, 2026
1 check passed

meritt deleted the next branch May 20, 2026 17:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

v2.0.0: Update rules to match HTML Academy codeguide#28

v2.0.0: Update rules to match HTML Academy codeguide#28
meritt merged 21 commits into
mainfrom
next

meritt commented Jan 25, 2026 •

edited

Loading

Uh oh!

meritt commented Jan 25, 2026

Uh oh!

nikolai-shabalin May 9, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nikolai-shabalin May 9, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

meritt commented Jan 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Newly activated rules

Replaced / removed

Configuration adjustments to existing rules

Behavioural summary

Cleanup

Closes

Uh oh!

meritt commented Jan 25, 2026

Uh oh!

nikolai-shabalin May 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nikolai-shabalin May 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

meritt commented Jan 25, 2026 •

edited

Loading