@markuplint/rules 5.0.0-rc.5 → 5.0.0-rc.6

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.6](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.5...v5.0.0-rc.6) (2026-08-30)
+
+### Bug Fixes
+
+- add no-aria-hidden-on-hidden-until-found rule (closes [#3999](https://github.com/markuplint/markuplint/issues/3999)) ([#4017](https://github.com/markuplint/markuplint/issues/4017)) ([3dfb300](https://github.com/markuplint/markuplint/commit/3dfb3001dc66452918d5cebbb071244b68779b30))
+
 # [5.0.0-rc.5](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.4...v5.0.0-rc.5) (2026-08-28)
 
 ### Bug Fixes

package/lib/index.d.ts

@@ -43,6 +43,7 @@ declare const rules: {
     readonly 'no-abstract-role': Readonly<import("@markuplint/ml-core").RuleSeed<boolean, import("./wai-aria/types.js").Options>>;
     readonly 'no-always-matching-source': Readonly<import("@markuplint/ml-core").RuleSeed<boolean, undefined>>;
     readonly 'no-ambiguous-navigable-target-names': Readonly<import("@markuplint/ml-core").RuleSeed<boolean, undefined>>;
+    readonly 'no-aria-hidden-on-hidden-until-found': Readonly<import("@markuplint/ml-core").RuleSeed<boolean, import("./wai-aria/types.js").Options>>;
     readonly 'no-aria-on-presentational-children': Readonly<import("@markuplint/ml-core").RuleSeed<boolean, import("./wai-aria/types.js").Options>>;
     readonly 'no-aria-on-unsupported-element': Readonly<import("@markuplint/ml-core").RuleSeed<import("@markuplint/ml-core").RuleConfigValue, undefined>>;
     readonly 'no-boolean-attr-value': Readonly<import("@markuplint/ml-core").RuleSeed<import("@markuplint/ml-core").RuleConfigValue, undefined>>;

package/lib/index.js

@@ -29,6 +29,7 @@ import MeterValueBounds from './meter-value-bounds/index.js';
 import NoAbstractRole from './no-abstract-role/index.js';
 import NoAlwaysMatchingSource from './no-always-matching-source/index.js';
 import NoAmbiguousNavigableTargetNames from './no-ambiguous-navigable-target-names/index.js';
+import NoAriaHiddenOnHiddenUntilFound from './no-aria-hidden-on-hidden-until-found/index.js';
 import NoAriaOnPresentationalChildren from './no-aria-on-presentational-children/index.js';
 import NoAriaOnUnsupportedElement from './no-aria-on-unsupported-element/index.js';
 import NoBooleanAttrValue from './no-boolean-attr-value/index.js';
@@ -140,6 +141,7 @@ const rules = {
     'no-abstract-role': NoAbstractRole,
     'no-always-matching-source': NoAlwaysMatchingSource,
     'no-ambiguous-navigable-target-names': NoAmbiguousNavigableTargetNames,
+    'no-aria-hidden-on-hidden-until-found': NoAriaHiddenOnHiddenUntilFound,
     'no-aria-on-presentational-children': NoAriaOnPresentationalChildren,
     'no-aria-on-unsupported-element': NoAriaOnUnsupportedElement,
     'no-boolean-attr-value': NoBooleanAttrValue,

package/lib/no-aria-hidden-on-hidden-until-found/index.d.ts

@@ -0,0 +1,12 @@
+import type { Options } from '../wai-aria/types.js';
+/**
+ * ARIA in HTML §"Rules of ARIA attribute usage by HTML feature", the `hidden` row:
+ * "authors MUST NOT use `aria-hidden="true"` on any element which also has the
+ * `hidden` attribute specified in the Hidden Until Found state." Content revealed
+ * by the browser's find-in-page feature would otherwise stay excluded from the
+ * accessibility tree, silently breaking that reveal for assistive technology users.
+ *
+ * @see https://w3c.github.io/html-aria/#att-hidden
+ */
+declare const _default: Readonly<import("@markuplint/ml-core").RuleSeed<boolean, Options>>;
+export default _default;

package/lib/no-aria-hidden-on-hidden-until-found/index.js

@@ -0,0 +1,35 @@
+import { createRule } from '@markuplint/ml-core';
+import { defaultOptions } from '../wai-aria/default-options.js';
+import meta from './meta.js';
+/**
+ * ARIA in HTML §"Rules of ARIA attribute usage by HTML feature", the `hidden` row:
+ * "authors MUST NOT use `aria-hidden="true"` on any element which also has the
+ * `hidden` attribute specified in the Hidden Until Found state." Content revealed
+ * by the browser's find-in-page feature would otherwise stay excluded from the
+ * accessibility tree, silently breaking that reveal for assistive technology users.
+ *
+ * @see https://w3c.github.io/html-aria/#att-hidden
+ */
+export default createRule({
+    meta,
+    defaultSeverity: 'error',
+    defaultOptions,
+    async verify({ document, report, t }) {
+        await document.walkOn('Element', el => {
+            const ariaHidden = el.getAttributeNode('aria-hidden');
+            if (!ariaHidden || ariaHidden.isDynamicValue) {
+                return;
+            }
+            if (ariaHidden.value.trim().toLowerCase() !== 'true') {
+                return;
+            }
+            if (el.getAttribute('hidden')?.trim().toLowerCase() !== 'until-found') {
+                return;
+            }
+            report({
+                scope: ariaHidden,
+                message: t('"aria-hidden" must not be "{0}" on an element with "hidden" value "{1}"', 'true', 'until-found'),
+            });
+        });
+    },
+});

package/lib/no-aria-hidden-on-hidden-until-found/meta.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    readonly category: "a11y";
+    readonly specConformance: {
+        readonly sources: readonly ["aria-in-html"];
+        readonly level: "must";
+        readonly cites: readonly ["https://w3c.github.io/html-aria/#att-hidden"];
+    };
+};
+export default _default;

package/lib/no-aria-hidden-on-hidden-until-found/meta.js

@@ -0,0 +1,8 @@
+export default {
+    category: 'a11y',
+    specConformance: {
+        sources: ['aria-in-html'],
+        level: 'must',
+        cites: ['https://w3c.github.io/html-aria/#att-hidden'],
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/rules",
-	"version": "5.0.0-rc.5",
+	"version": "5.0.0-rc.6",
 	"description": "Built-in rules of markuplint",
 	"repository": {
 		"type": "git",
@@ -31,13 +31,13 @@
 		"./lib/permitted-contents/debug.js": "./lib/permitted-contents/debug.browser.js"
 	},
 	"dependencies": {
-		"@markuplint/html-spec": "5.0.0-rc.5",
-		"@markuplint/ml-config": "5.0.0-rc.5",
-		"@markuplint/ml-core": "5.0.0-rc.5",
-		"@markuplint/ml-spec": "5.0.0-rc.5",
-		"@markuplint/selector": "5.0.0-rc.5",
-		"@markuplint/shared": "5.0.0-rc.5",
-		"@markuplint/types": "5.0.0-rc.5",
+		"@markuplint/html-spec": "5.0.0-rc.6",
+		"@markuplint/ml-config": "5.0.0-rc.6",
+		"@markuplint/ml-core": "5.0.0-rc.6",
+		"@markuplint/ml-spec": "5.0.0-rc.6",
+		"@markuplint/selector": "5.0.0-rc.6",
+		"@markuplint/shared": "5.0.0-rc.6",
+		"@markuplint/types": "5.0.0-rc.6",
 		"@mdn/browser-compat-data": "^7.3.2",
 		"@types/debug": "4.1.13",
 		"ansi-colors": "4.1.3",
@@ -47,5 +47,5 @@
 		"image-size": "^2.0.2",
 		"type-fest": "5.6.0"
 	},
-	"gitHead": "8d87463af2ff3f1b83fb28da20f1819362cf3555"
+	"gitHead": "c02c3a0783eac6b2fb4707be2dc00b88f6219641"
 }

package/schema.json

@@ -99,6 +99,9 @@
 				"no-ambiguous-navigable-target-names": {
 					"$ref": "https://raw.githubusercontent.com/markuplint/markuplint/main/packages/%40markuplint/rules/src/no-ambiguous-navigable-target-names/schema.json"
 				},
+				"no-aria-hidden-on-hidden-until-found": {
+					"$ref": "https://raw.githubusercontent.com/markuplint/markuplint/main/packages/%40markuplint/rules/src/no-aria-hidden-on-hidden-until-found/schema.json"
+				},
 				"no-aria-on-presentational-children": {
 					"$ref": "https://raw.githubusercontent.com/markuplint/markuplint/main/packages/%40markuplint/rules/src/no-aria-on-presentational-children/schema.json"
 				},