@markuplint/ml-spec 5.4.0 → 5.6.0

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.6.0](https://github.com/markuplint/markuplint/compare/v5.5.0...v5.6.0) (2026-11-12)
+
+### Bug Fixes
+
+* do not report an area element that has no parent node in the file ([916a166](https://github.com/markuplint/markuplint/commit/916a166916e4efd5292402abcd293927605ff799)), closes [#4528](https://github.com/markuplint/markuplint/issues/4528)
+* **ml-spec:** follow a light child to the slot that takes it ([5269f1f](https://github.com/markuplint/markuplint/commit/5269f1f3892df6e383a9f08de6ccb07f71b5cfb9))
+
+
+# [5.5.0](https://github.com/markuplint/markuplint/compare/v5.4.0...v5.5.0) (2026-11-10)
+
+### Bug Fixes
+
+* **html-spec:** allow script-supporting elements in table sections, colgroup and dl ([197176a](https://github.com/markuplint/markuplint/commit/197176a7aae805e2949f9b96c6a27f39d478d261)), closes [#3591](https://github.com/markuplint/markuplint/issues/3591) [#4492](https://github.com/markuplint/markuplint/issues/4492)
+* **ml-spec:** skip aria-label on a slot element and cite the current accname and ARIA text ([57fe6a6](https://github.com/markuplint/markuplint/commit/57fe6a6f9ac2cdc7afda7595b67c4c9392a1c073))
+* **ml-spec:** stop the ancestor walks at the boundary of template content ([37d66d9](https://github.com/markuplint/markuplint/commit/37d66d99ac4b6b85f12df6a0cd32aa39cf27d901))
+* report a main element that is not hierarchically correct ([b44c936](https://github.com/markuplint/markuplint/commit/b44c936cf2e40c8142f88fe6b503af6f437cd341))
+
+### Features
+
+* **ml-spec:** add getSelectDisplaySize ([9788707](https://github.com/markuplint/markuplint/commit/9788707dbefa096d15be09e6baf0657e940400eb))
+* **ml-spec:** add movedToHead to the spec for elements a framework places in the head ([c78991c](https://github.com/markuplint/markuplint/commit/c78991c612ed038f6e597a3cc3c06e80d31c47f6))
+* **ml-spec:** declare where a template keeps its children, and resolve aria-labelledby per token ([5534b91](https://github.com/markuplint/markuplint/commit/5534b9149db8f7297e50bb4afadab0749c46ff33)), closes [#104](https://github.com/markuplint/markuplint/issues/104)
+* **ml-spec:** merge how a framework renders a literal, and skip attributes not output ([1f6b61c](https://github.com/markuplint/markuplint/commit/1f6b61cb5137f4409bd10522c44cd5bff7c6f688))
+
+
 # [5.4.0](https://github.com/markuplint/markuplint/compare/v5.3.0...v5.4.0) (2026-10-29)
 
 ### Bug Fixes

package/README.md

@@ -52,6 +52,10 @@ Generated TypeScript types (do not edit directly):
 - Interactive Content classification
 - Content Model validation (`src/algorithm/html/get-content-model.ts`)
 
+**DOM Tree Algorithms**:
+
+- Parent element in a tree and in the accessibility tree (`getTreeParentElement`, `getComposedParentElement`, `isShadowRoot` in `src/algorithm/dom/tree-boundary.ts`)
+
 **WAI-ARIA Specification Algorithms**:
 
 - **Accessible Name Computation** - W3C AccName 1.2 / HTML-AAM §4.1 compliant (`src/algorithm/aria/accname/`)

package/lib/algorithm/aria/accname/aria-steps.d.ts

@@ -1,9 +1,10 @@
 import type { AccnameComputeFn, AccnameElement, AccnameResolver, AccnameResult } from './types.js';
 /**
  * Implements AccName 1.2 §4.3.2 Step 2B:
- * "If the current node has an `aria-labelledby` attribute that contains
- * at least one valid IDREF, and the current node is not already part of
- * an ongoing `aria-labelledby` traversal, process its IDREFs [...]"
+ *
+ * > Otherwise, if the current node has an aria-labelledby attribute that contains at least one valid IDREF,
+ * > and the current node is not already part of an ongoing aria-labelledby or aria-describedby traversal,
+ * > process its IDREFs in the order they occur:
  *
  * **Self-reference handling** (spec-defined, not a custom extension):
  * An element may reference its own ID in `aria-labelledby` to include its
@@ -14,7 +15,7 @@ import type { AccnameComputeFn, AccnameElement, AccnameResolver, AccnameResult }
  * visited set — `computeFn` is called with `inLabelledbyTraversal=true`,
  * which causes `compute.ts` to skip Step 2B on the referenced element.
  *
- * @see https://www.w3.org/TR/accname-1.2/#comp_labelledby_traversal — AccName 1.2 §4.3.2 Step 2B
+ * @see https://w3c.github.io/accname/#comp_labelledby_traversal — AccName 1.2 §4.3.2 Step 2B
  */
 export declare function resolveAriaLabelledby(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn): AccnameResult | null;
 /**
@@ -31,9 +32,13 @@ export declare function resolveAriaLabelledby(el: AccnameElement, resolver: Accn
 export declare function computeReferenced(referenced: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn): AccnameResult;
 /**
  * Implements AccName 1.2 §4.3.2 Step 2D:
- * "If the current node has an `aria-label` attribute whose value is
- * not undefined, not the empty string, and not a string of whitespace [...]"
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2D
+ * > Otherwise, if the current node is not a slot element and has an aria-label attribute whose value is not undefined,
+ * > not the empty string, nor, when trimmed of whitespace, is not the empty string:
+ *
+ * The `slot` element is the HTML one (the XHTML namespace): the `aria-label` on it is skipped and the
+ * computation goes on to the following steps. A `slot` of another namespace is not the HTML `slot` element.
+ *
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2D
  */
 export declare function resolveAriaLabel(el: AccnameElement): AccnameResult | null;

package/lib/algorithm/aria/accname/aria-steps.js

@@ -1,10 +1,12 @@
 /* eslint-disable @typescript-eslint/prefer-readonly-parameter-types -- AccnameElement wraps mutable DOM types */
+import { XHTML_NAMESPACE } from '../../../const/index.js';
 import { flattenText, makeResult } from './result.js';
 /**
  * Implements AccName 1.2 §4.3.2 Step 2B:
- * "If the current node has an `aria-labelledby` attribute that contains
- * at least one valid IDREF, and the current node is not already part of
- * an ongoing `aria-labelledby` traversal, process its IDREFs [...]"
+ *
+ * > Otherwise, if the current node has an aria-labelledby attribute that contains at least one valid IDREF,
+ * > and the current node is not already part of an ongoing aria-labelledby or aria-describedby traversal,
+ * > process its IDREFs in the order they occur:
  *
  * **Self-reference handling** (spec-defined, not a custom extension):
  * An element may reference its own ID in `aria-labelledby` to include its
@@ -15,7 +17,7 @@ import { flattenText, makeResult } from './result.js';
  * visited set — `computeFn` is called with `inLabelledbyTraversal=true`,
  * which causes `compute.ts` to skip Step 2B on the referenced element.
  *
- * @see https://www.w3.org/TR/accname-1.2/#comp_labelledby_traversal — AccName 1.2 §4.3.2 Step 2B
+ * @see https://w3c.github.io/accname/#comp_labelledby_traversal — AccName 1.2 §4.3.2 Step 2B
  */
 export function resolveAriaLabelledby(el, resolver, visited, computeFn) {
     const labelledbyAttr = el.getAttribute('aria-labelledby');
@@ -85,12 +87,19 @@ export function computeReferenced(referenced, resolver, visited, computeFn) {
 }
 /**
  * Implements AccName 1.2 §4.3.2 Step 2D:
- * "If the current node has an `aria-label` attribute whose value is
- * not undefined, not the empty string, and not a string of whitespace [...]"
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2D
+ * > Otherwise, if the current node is not a slot element and has an aria-label attribute whose value is not undefined,
+ * > not the empty string, nor, when trimmed of whitespace, is not the empty string:
+ *
+ * The `slot` element is the HTML one (the XHTML namespace): the `aria-label` on it is skipped and the
+ * computation goes on to the following steps. A `slot` of another namespace is not the HTML `slot` element.
+ *
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2D
  */
 export function resolveAriaLabel(el) {
+    if (el.localName === 'slot' && el.namespaceURI === XHTML_NAMESPACE) {
+        return null;
+    }
     const label = el.getAttribute('aria-label');
     if (label?.trim()) {
         return makeResult(label, 'aria-label');

package/lib/algorithm/aria/accname/compute.d.ts

@@ -31,8 +31,8 @@ import type { AccnameElement, AccnameResolver, AccnameResult } from './types.js'
  * @param el - The element to compute the accessible name for
  * @param resolver - Environment-dependent resolver for DOM traversal and role queries
  * @returns The computed name and its source
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2
- * @see https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation — HTML-AAM §4.1
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2
+ * @see https://www.w3.org/TR/html-aam/#accessible-name-and-description-computation — HTML-AAM §4
  */
 export declare function computeAccessibleName(el: AccnameElement, resolver: AccnameResolver): AccnameResult;
 /**
@@ -68,6 +68,6 @@ export declare function computeHostLanguageLabel(el: AccnameElement, resolver: A
  * @param inLabelledbyTraversal - When true, Step 2B is skipped to prevent re-entry
  *   into `resolveAriaLabelledby`, and Step 2F name-from-content is enabled regardless
  *   of role. This is set by Step 2B when processing each IDREF.
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2
  */
 export declare function computeAccessibleNameInternal(el: AccnameElement, resolver: AccnameResolver, inLabelledbyTraversal: boolean, visited: ReadonlySet<string>): AccnameResult;

package/lib/algorithm/aria/accname/compute.js

@@ -36,8 +36,8 @@ const EMPTY_RESULT = { name: '', source: null };
  * @param el - The element to compute the accessible name for
  * @param resolver - Environment-dependent resolver for DOM traversal and role queries
  * @returns The computed name and its source
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2
- * @see https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation — HTML-AAM §4.1
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2
+ * @see https://www.w3.org/TR/html-aam/#accessible-name-and-description-computation — HTML-AAM §4
  */
 export function computeAccessibleName(el, resolver) {
     return computeAccessibleNameInternal(el, resolver, false, new Set());
@@ -83,7 +83,7 @@ export function computeHostLanguageLabel(el, resolver) {
  * @param inLabelledbyTraversal - When true, Step 2B is skipped to prevent re-entry
  *   into `resolveAriaLabelledby`, and Step 2F name-from-content is enabled regardless
  *   of role. This is set by Step 2B when processing each IDREF.
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2
  */
 export function computeAccessibleNameInternal(el, resolver, inLabelledbyTraversal, visited) {
     // AccName 1.2 §4.3.2 Step 2A: Hidden elements return empty. In an aria-labelledby

package/lib/algorithm/aria/accname/element-names.d.ts

@@ -7,7 +7,7 @@ import type { AccnameComputeFn, AccnameElement, AccnameResolver, AccnameResult }
  * Returns null if no element-specific rule applies, letting the caller
  * fall through to name-from-content (Step 2F) or title fallback (Step 2I).
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2E
- * @see https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation — HTML-AAM §4.1
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2E
+ * @see https://www.w3.org/TR/html-aam/#accessible-name-and-description-computation — HTML-AAM §4
  */
 export declare function getElementSpecificName(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn, inLabelledbyTraversal: boolean): AccnameResult | null;

package/lib/algorithm/aria/accname/element-names.js

@@ -11,8 +11,8 @@ import { makeResult } from './result.js';
  * Returns null if no element-specific rule applies, letting the caller
  * fall through to name-from-content (Step 2F) or title fallback (Step 2I).
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2E
- * @see https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation — HTML-AAM §4.1
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2E
+ * @see https://www.w3.org/TR/html-aam/#accessible-name-and-description-computation — HTML-AAM §4
  */
 export function getElementSpecificName(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     if (isSvgElement(el)) {
@@ -68,9 +68,9 @@ export function getElementSpecificName(el, resolver, visited, computeFn, inLabel
     }
 }
 /**
- * HTML-AAM §4.1 (input[text-like], textarea, select, meter, progress, output).
+ * HTML-AAM §3.5.76 (input[text-like], textarea, select, meter, progress, output).
  * Name sources: label → title → placeholder.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-text
+ * @see https://www.w3.org/TR/html-aam/#el-input-text
  */
 function handleLabelableWithTitle(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const labelResult = resolveLabelText(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -88,13 +88,13 @@ function handleLabelableWithTitle(el, resolver, visited, computeFn, inLabelledby
     return null;
 }
 /**
- * HTML-AAM §4.1 (input — dispatches by type).
+ * HTML-AAM §3.5.76 (input — dispatches by type).
  * Text-like types: label → title → placeholder.
  * Button/submit/reset: label → value → default label.
  * Image: label → alt → title → default label.
  * Hidden: always empty.
  * Checkbox/radio: label → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-text
+ * @see https://www.w3.org/TR/html-aam/#el-input-text
  */
 function handleInput(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const type = getInputType(el);
@@ -114,9 +114,9 @@ function handleInput(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     return handleLabelableWithTitle(el, resolver, visited, computeFn, inLabelledbyTraversal);
 }
 /**
- * HTML-AAM §4.1 (input[type=button/submit/reset]).
+ * HTML-AAM §3.5.58 (input[type=button/submit/reset]).
  * Name sources: label → value → title → default label (submit="Submit", reset="Reset").
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-button
+ * @see https://www.w3.org/TR/html-aam/#el-input-button
  */
 function handleInputButton(el, type, resolver, visited, computeFn, inLabelledbyTraversal) {
     const labelResult = resolveLabelText(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -141,9 +141,9 @@ function handleInputButton(el, type, resolver, visited, computeFn, inLabelledbyT
     return null;
 }
 /**
- * HTML-AAM §4.1 (input[type=image]).
+ * HTML-AAM §3.5.66 (input[type=image]).
  * Name sources: label → alt → title → default ("Submit Query").
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-image
+ * @see https://www.w3.org/TR/html-aam/#el-input-image
  */
 function handleInputImage(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const labelResult = resolveLabelText(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -161,9 +161,9 @@ function handleInputImage(el, resolver, visited, computeFn, inLabelledbyTraversa
     return makeResult(DEFAULT_IMAGE_LABEL, 'default');
 }
 /**
- * HTML-AAM §4.1 (button).
+ * HTML-AAM §3.5.20 (button).
  * Name sources: label → content → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-button
+ * @see https://www.w3.org/TR/html-aam/#el-button
  */
 function handleButton(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const labelResult = resolveLabelText(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -181,9 +181,9 @@ function handleButton(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (fieldset).
+ * HTML-AAM §3.5.40 (fieldset).
  * Name sources: legend (content) → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-fieldset
+ * @see https://www.w3.org/TR/html-aam/#el-fieldset
  */
 function handleFieldset(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const legend = findChildByLocalName(el, 'legend', resolver);
@@ -200,9 +200,9 @@ function handleFieldset(el, resolver, visited, computeFn, inLabelledbyTraversal)
     return null;
 }
 /**
- * HTML-AAM §4.1 (table).
+ * HTML-AAM §3.5.127 (table).
  * Name sources: caption (content) → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-table
+ * @see https://www.w3.org/TR/html-aam/#el-table
  */
 function handleTable(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const caption = findChildByLocalName(el, 'caption', resolver);
@@ -219,10 +219,10 @@ function handleTable(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (img).
+ * HTML-AAM §3.5.56 (img).
  * Name sources: alt → title (only when alt is not specified).
  * When alt="" (empty), returns empty name with null source (decorative image).
- * @see https://www.w3.org/TR/html-aam-1.0/#el-img
+ * @see https://www.w3.org/TR/html-aam/#el-img
  */
 function handleImg(el) {
     if (el.hasAttribute('alt')) {
@@ -236,9 +236,9 @@ function handleImg(el) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (area).
+ * HTML-AAM §3.5.6 (area).
  * Name sources: alt → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-area
+ * @see https://www.w3.org/TR/html-aam/#el-area
  */
 function handleArea(el) {
     const alt = el.getAttribute('alt');
@@ -252,10 +252,10 @@ function handleArea(el) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (figure).
+ * HTML-AAM §3.5.42 (figure).
  * Name sources: title only. Note: figcaption provides the accessible
  * *description*, not the name, per HTML-AAM.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-figure
+ * @see https://www.w3.org/TR/html-aam/#el-figure
  */
 function handleFigure(el) {
     const title = el.getAttribute('title');
@@ -265,9 +265,9 @@ function handleFigure(el) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (summary).
+ * HTML-AAM §3.5.124 (summary).
  * Name sources: content → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-summary
+ * @see https://www.w3.org/TR/html-aam/#el-summary
  */
 function handleSummary(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const content = resolveNameFromContent(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -281,9 +281,9 @@ function handleSummary(el, resolver, visited, computeFn, inLabelledbyTraversal)
     return null;
 }
 /**
- * HTML-AAM §4.1 (a[href]).
+ * HTML-AAM §3.5.2 (a[href]).
  * Name sources: content → title.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-a
+ * @see https://www.w3.org/TR/html-aam/#el-a
  */
 function handleAnchor(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const content = resolveNameFromContent(el, resolver, visited, computeFn, inLabelledbyTraversal);
@@ -297,8 +297,8 @@ function handleAnchor(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     return null;
 }
 /**
- * HTML-AAM §4.1 (iframe) — name from title attribute only.
- * @see https://www.w3.org/TR/html-aam-1.0/#el-iframe
+ * HTML-AAM §3.5.55 (iframe) — name from title attribute only.
+ * @see https://www.w3.org/TR/html-aam/#el-iframe
  */
 function handleTitleOnly(el) {
     const title = el.getAttribute('title');
@@ -309,7 +309,7 @@ function handleTitleOnly(el) {
 }
 /**
  * SVG-AAM: SVG elements get name from `<title>` child element.
- * @see https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd — SVG-AAM §8.1
+ * @see https://www.w3.org/TR/svg-aam/#mapping_additional_nd — SVG-AAM §7.1
  */
 function handleSvgElement(el, resolver) {
     const titleEl = findChildByLocalName(el, 'title', resolver);

package/lib/algorithm/aria/accname/helpers.d.ts

@@ -3,12 +3,22 @@ export { EMBEDDED_CONTROL_ROLES } from '../../../const/index.js';
 /**
  * Implements AccName 1.2 §4.3.2 Steps 2F and 2C:
  *
- * - **Step 2F**: "If the current node's role allows name from content [...],
- *   return the accumulated text of the current node's descendant nodes."
- * - **Step 2C (Embedded Controls)**: "If the current node is a descendant of
- *   an `aria-labelledby` or `aria-label` reference AND the current node is
- *   an embedded control, return the embedded control's value." Per spec,
- *   `aria-label` is ignored for embedded controls during this traversal.
+ * **Step 2F**, the name from content:
+ *
+ * > Otherwise, if the current node's role allows name from content, or if the current node is referenced by
+ * > aria-labelledby, aria-describedby, or is a native host language text alternative element (e.g. label in HTML),
+ * > or is a descendant of a native host language text alternative element:
+ *
+ * **Step 2C**, the embedded controls:
+ *
+ * > Otherwise, if the current node is a control embedded within the label (e.g. any element directly referenced by
+ * > aria-labelledby) for another widget, where the user can adjust the embedded control's value, then return the
+ * > embedded control as part of the text alternative in the following manner:
+ *
+ * `aria-label` is ignored for an embedded control during this traversal:
+ *
+ * > If traversal of the current node is due to Name From Content descendant node recursion and the current node is an
+ * > embedded control, ignore aria-label and skip to rule Embedded Control.
  *
  * **Limitation:** CSS-generated content (`::before`/`::after` with the `content`
  * property) is not included. AccName 1.2 §4.3.2 Step 2G specifies that CSS
@@ -16,8 +26,8 @@ export { EMBEDDED_CONTROL_ROLES } from '../../../const/index.js';
  * performs static HTML analysis without CSS processing, so this content is
  * unavailable at lint time.
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2F
- * @see https://www.w3.org/TR/accname-1.2/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2F
+ * @see https://w3c.github.io/accname/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
  */
 export declare function resolveNameFromContent(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn, inLabelledbyTraversal: boolean): string;
 /**
@@ -44,6 +54,17 @@ export declare function getChildNodes(el: AccnameElement, resolver: AccnameResol
  */
 export declare function getTextContent(el: AccnameElement, resolver: AccnameResolver): string;
 export declare function findChildByLocalName(el: AccnameElement, localName: string, resolver?: AccnameResolver): AccnameElement | null;
+/**
+ * The closest `label` element among the ancestors of the element, which names the element when it is
+ * its labeled control. The ancestors are those of its own tree, as the HTML Standard defines the
+ * relation between a `label` and its labeled control by ancestors in the tree, so a `label` that
+ * wraps a `template` element does not label a control in its content.
+ *
+ * @see https://html.spec.whatwg.org/multipage/forms.html#labeled-control
+ *
+ * @param el - The element to start from
+ * @returns The closest `label` ancestor, or `null`
+ */
 export declare function findAncestorLabel(el: AccnameElement): AccnameElement | null;
 export declare function resolveLabel(el: AccnameElement, resolver: AccnameResolver): readonly AccnameElement[];
 export declare function getInputType(el: AccnameElement): string;
@@ -54,7 +75,7 @@ export declare function isSvgElement(el: AccnameElement): boolean;
  * through Step 2E of its parent (`handleSvgElement`), which an element exposed
  * as presentational skips.
  *
- * @see https://w3c.github.io/svgwg/svg2-draft/struct.html#TermNeverRenderedElement
+ * @see https://svgwg.org/svg2-draft/render.html#TermNeverRenderedElement
  */
 export declare function isSvgDescriptiveElement(el: AccnameElement): boolean;
 /**

package/lib/algorithm/aria/accname/helpers.js

@@ -1,16 +1,27 @@
 /* eslint-disable @typescript-eslint/prefer-readonly-parameter-types -- AccnameElement wraps mutable DOM types */
 import { ELEMENT_NODE, SVG_NAMESPACE, TEXT_NODE, TEXT_LIKE_INPUT_TYPES } from '../../../const/index.js';
+import { getTreeParentElement } from '../../dom/tree-boundary.js';
 import { resolveAriaLabelledby } from './aria-steps.js';
 export { EMBEDDED_CONTROL_ROLES } from '../../../const/index.js';
 /**
  * Implements AccName 1.2 §4.3.2 Steps 2F and 2C:
  *
- * - **Step 2F**: "If the current node's role allows name from content [...],
- *   return the accumulated text of the current node's descendant nodes."
- * - **Step 2C (Embedded Controls)**: "If the current node is a descendant of
- *   an `aria-labelledby` or `aria-label` reference AND the current node is
- *   an embedded control, return the embedded control's value." Per spec,
- *   `aria-label` is ignored for embedded controls during this traversal.
+ * **Step 2F**, the name from content:
+ *
+ * > Otherwise, if the current node's role allows name from content, or if the current node is referenced by
+ * > aria-labelledby, aria-describedby, or is a native host language text alternative element (e.g. label in HTML),
+ * > or is a descendant of a native host language text alternative element:
+ *
+ * **Step 2C**, the embedded controls:
+ *
+ * > Otherwise, if the current node is a control embedded within the label (e.g. any element directly referenced by
+ * > aria-labelledby) for another widget, where the user can adjust the embedded control's value, then return the
+ * > embedded control as part of the text alternative in the following manner:
+ *
+ * `aria-label` is ignored for an embedded control during this traversal:
+ *
+ * > If traversal of the current node is due to Name From Content descendant node recursion and the current node is an
+ * > embedded control, ignore aria-label and skip to rule Embedded Control.
  *
  * **Limitation:** CSS-generated content (`::before`/`::after` with the `content`
  * property) is not included. AccName 1.2 §4.3.2 Step 2G specifies that CSS
@@ -18,8 +29,8 @@ export { EMBEDDED_CONTROL_ROLES } from '../../../const/index.js';
  * performs static HTML analysis without CSS processing, so this content is
  * unavailable at lint time.
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2F
- * @see https://www.w3.org/TR/accname-1.2/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2F
+ * @see https://w3c.github.io/accname/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
  */
 export function resolveNameFromContent(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const parts = [];
@@ -130,7 +141,7 @@ export function embeddedControlText(el, resolver, visited, computeFn, inLabelled
  *   value attr → textContent
  * - **Listbox** (select): selected option text (static analysis approximation)
  *
- * @see https://www.w3.org/TR/accname-1.2/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
+ * @see https://w3c.github.io/accname/#comp_embedded_control — AccName 1.2 §4.3.2 Step 2C
  */
 function getEmbeddedControlValue(el, resolver) {
     const role = el.getAttribute('role')?.trim().split(/\s+/)[0];
@@ -276,13 +287,24 @@ export function findChildByLocalName(el, localName, resolver) {
     }
     return null;
 }
+/**
+ * The closest `label` element among the ancestors of the element, which names the element when it is
+ * its labeled control. The ancestors are those of its own tree, as the HTML Standard defines the
+ * relation between a `label` and its labeled control by ancestors in the tree, so a `label` that
+ * wraps a `template` element does not label a control in its content.
+ *
+ * @see https://html.spec.whatwg.org/multipage/forms.html#labeled-control
+ *
+ * @param el - The element to start from
+ * @returns The closest `label` ancestor, or `null`
+ */
 export function findAncestorLabel(el) {
-    let current = el.parentElement;
+    let current = getTreeParentElement(el);
     while (current) {
         if (current.localName === 'label') {
             return current;
         }
-        current = current.parentElement;
+        current = getTreeParentElement(current);
     }
     return null;
 }
@@ -315,7 +337,7 @@ export function isSvgElement(el) {
  * through Step 2E of its parent (`handleSvgElement`), which an element exposed
  * as presentational skips.
  *
- * @see https://w3c.github.io/svgwg/svg2-draft/struct.html#TermNeverRenderedElement
+ * @see https://svgwg.org/svg2-draft/render.html#TermNeverRenderedElement
  */
 export function isSvgDescriptiveElement(el) {
     return isSvgElement(el) && (el.localName === 'title' || el.localName === 'desc');

package/lib/algorithm/aria/accname/label-steps.d.ts

@@ -3,7 +3,7 @@ import type { AccnameComputeFn, AccnameElement, AccnameResolver, AccnameResult }
  * Part of AccName 1.2 §4.3.2 Step 2E — for labelable elements, the HTML label
  * association is checked before other element-specific rules.
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2E
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-text — HTML-AAM label association
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2E
+ * @see https://www.w3.org/TR/html-aam/#el-input-text — HTML-AAM label association
  */
 export declare function resolveLabelText(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn, inLabelledbyTraversal: boolean): AccnameResult | null;

package/lib/algorithm/aria/accname/label-steps.js

@@ -6,8 +6,8 @@ import { flattenText, makeResult } from './result.js';
  * Part of AccName 1.2 §4.3.2 Step 2E — for labelable elements, the HTML label
  * association is checked before other element-specific rules.
  *
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2 Step 2E
- * @see https://www.w3.org/TR/html-aam-1.0/#el-input-text — HTML-AAM label association
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2 Step 2E
+ * @see https://www.w3.org/TR/html-aam/#el-input-text — HTML-AAM label association
  */
 export function resolveLabelText(el, resolver, visited, computeFn, inLabelledbyTraversal) {
     const labels = resolveLabel(el, resolver);

package/lib/algorithm/aria/accname/svg-helpers.d.ts

@@ -4,7 +4,7 @@ import type { AccnameElement } from './types.js';
  * the full name computation.
  *
  * Used by `get-computed-role.ts` for SVG accessibility tree inclusion decisions
- * per SVG-AAM §5.1.1. This is a lightweight check that avoids the full AccName
+ * per SVG-AAM §4.1.2. This is a lightweight check that avoids the full AccName
  * algorithm, breaking the circular dependency between role computation and
  * name computation.
  *
@@ -19,6 +19,6 @@ import type { AccnameElement } from './types.js';
  *
  * @param el - The SVG element to check for accessible name sources
  * @returns True if the element has aria-label, aria-labelledby, or a title/desc child
- * @see https://www.w3.org/TR/svg-aam-1.0/#include_elements — SVG-AAM §5.1.1
+ * @see https://www.w3.org/TR/svg-aam/#include_elements — SVG-AAM §4.1.2
  */
 export declare function hasSvgAccessibleNameSource(el: AccnameElement): boolean;

package/lib/algorithm/aria/accname/svg-helpers.js

@@ -4,7 +4,7 @@
  * the full name computation.
  *
  * Used by `get-computed-role.ts` for SVG accessibility tree inclusion decisions
- * per SVG-AAM §5.1.1. This is a lightweight check that avoids the full AccName
+ * per SVG-AAM §4.1.2. This is a lightweight check that avoids the full AccName
  * algorithm, breaking the circular dependency between role computation and
  * name computation.
  *
@@ -19,7 +19,7 @@
  *
  * @param el - The SVG element to check for accessible name sources
  * @returns True if the element has aria-label, aria-labelledby, or a title/desc child
- * @see https://www.w3.org/TR/svg-aam-1.0/#include_elements — SVG-AAM §5.1.1
+ * @see https://www.w3.org/TR/svg-aam/#include_elements — SVG-AAM §4.1.2
  */
 export function hasSvgAccessibleNameSource(el) {
     if (el.getAttribute('aria-label')?.trim()) {

package/lib/algorithm/aria/accname/types.d.ts

@@ -20,6 +20,13 @@ export interface AccnameElement extends AccnameNode {
     getAttribute(name: string): string | null;
     hasAttribute(name: string): boolean;
     readonly parentElement: AccnameElement | null;
+    /**
+     * The root of the tree of the element. An element and its parent element are in the same tree,
+     * unless the parent element is only the syntactical parent, as `MLElement#parentElement` is for the
+     * top of the content of a `template` element: see `getTreeParentElement`. An implementation without
+     * it has no tree boundary.
+     */
+    getRootNode?(): unknown;
     readonly children: Iterable<AccnameElement>;
     readonly childNodes: Iterable<AccnameNode>;
 }
@@ -66,6 +73,11 @@ export interface AccnameResolver {
      * Used by ml-core for a pretended component: it renders its own elements around
      * the children given at the usage site (`contents` of the pretender), and those
      * can carry the accessible name (`<button><img alt="Save"></button>`).
+     * Also the rendered children, when they are not the syntactical ones: the
+     * child nodes of an attached shadow root, and none for an ordinary
+     * `template` element, whose content is not rendered where it is written.
+     * An element whose shadow root is only maybe attached is given none as
+     * well, because that root is not there to read.
      * Consulted by name-from-content, label text, the legend/caption/SVG `title`
      * lookups, the `<select>` options, and wherever the computation reads an
      * element's text (`getTextContent`): an option, an SVG `title`, the value of

package/lib/algorithm/aria/accname-computation.d.ts

@@ -14,6 +14,6 @@ import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
  * @param specs - The ML specification data for role resolution
  * @param version - The ARIA version to use for role computation
  * @returns The computed accessible name string, or an empty string if none is found
- * @see https://www.w3.org/TR/accname-1.2/#computation-steps — AccName 1.2 §4.3.2
+ * @see https://w3c.github.io/accname/#computation-steps — AccName 1.2 §4.3.2
  */
 export declare function getAccname(el: Element, specs: MLMLSpec, version: ARIAVersion): string;