@markuplint/ml-spec 5.3.0 → 5.5.0

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [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
+
+* **ml-spec:** keep roles that are not permitted and align the accessible name with AccName ([6c38c60](https://github.com/markuplint/markuplint/commit/6c38c60971690edec8b6453e50c76146eb10deb2)), closes [#4408](https://github.com/markuplint/markuplint/issues/4408)
+
+
 # [5.3.0](https://github.com/markuplint/markuplint/compare/v5.2.0...v5.3.0) (2026-10-21)
 
 ### 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 { AccnameElement, AccnameResolver, AccnameResult } from './types.js';
+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,14 +15,30 @@ import type { AccnameElement, AccnameResolver, AccnameResult } from './types.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 declare function resolveAriaLabelledby(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: AccnameComputeFn): AccnameResult | null;
+/**
+ * Computes the text alternative of a node directly referenced by
+ * `aria-labelledby` (Step 2B, LabelledBy Traversal).
+ *
+ * Step 2A is skipped for the whole subtree only when the referenced node is
+ * hidden; otherwise its hidden descendants contribute nothing.
+ *
+ * @see https://w3c.github.io/accname/#comp_hidden_not_referenced
+ *
+ * > If the current node is hidden and is: Not part of an aria-labelledby or aria-describedby traversal, where the node directly referenced by that relation was hidden.
  */
-export declare function resolveAriaLabelledby(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: (el: AccnameElement, resolver: AccnameResolver, inLabelledbyTraversal: boolean, visited: ReadonlySet<string>) => AccnameResult): AccnameResult | null;
+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 { flattenText, makeResult } from './helpers.js';
+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 './helpers.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');
@@ -52,7 +54,7 @@ export function resolveAriaLabelledby(el, resolver, visited, computeFn) {
         // Each branch gets its own visited set so that one IDREF's
         // traversal doesn't block resolution of a later IDREF.
         const innerVisited = new Set([...newVisited, id]);
-        const result = computeFn(referenced, resolver, true, innerVisited);
+        const result = computeReferenced(referenced, resolver, innerVisited, computeFn);
         if (result.name) {
             parts.push(result.name);
         }
@@ -63,14 +65,41 @@ export function resolveAriaLabelledby(el, resolver, visited, computeFn) {
     }
     return null;
 }
+/**
+ * Computes the text alternative of a node directly referenced by
+ * `aria-labelledby` (Step 2B, LabelledBy Traversal).
+ *
+ * Step 2A is skipped for the whole subtree only when the referenced node is
+ * hidden; otherwise its hidden descendants contribute nothing.
+ *
+ * @see https://w3c.github.io/accname/#comp_hidden_not_referenced
+ *
+ * > If the current node is hidden and is: Not part of an aria-labelledby or aria-describedby traversal, where the node directly referenced by that relation was hidden.
+ */
+export function computeReferenced(referenced, resolver, visited, computeFn) {
+    const traversalResolver = resolver.isHidden(referenced)
+        ? {
+            ...resolver,
+            isHidden: () => false,
+        }
+        : resolver;
+    return computeFn(referenced, traversalResolver, true, visited);
+}
 /**
  * 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

@@ -8,8 +8,9 @@ import type { AccnameElement, AccnameResolver, AccnameResult } from './types.js'
  *
  * Control flow (Steps map to AccName 1.2 §4.3.2):
  *
- * 1. **Step 2A — Hidden check** — If the element is hidden (per `isHidden`) and NOT
- *    referenced by `aria-labelledby`, return empty immediately.
+ * 1. **Step 2A — Hidden check** — If the element is hidden (per `isHidden`), return
+ *    empty immediately, unless it is in an `aria-labelledby` traversal whose
+ *    directly referenced node is hidden.
  * 2. **Pre-computed name** — (Implementation-specific extension) If the
  *    resolver provides `getPrecomputedName`, check it before standard steps.
  *    Used by ml-core's Pretender integration for framework components.
@@ -18,7 +19,9 @@ import type { AccnameElement, AccnameResolver, AccnameResult } from './types.js'
  *    labelledby traversal (`inLabelledbyTraversal`) to prevent re-entry.
  * 4. **Step 2D — `aria-label`** — Use the `aria-label` attribute value.
  * 5. **Step 2E — Element-specific name** — Dispatch to HTML-AAM §4.1
- *    element-specific rules (label association, alt, value, legend, caption, SVG title).
+ *    element-specific rules (label association, alt, value, legend, caption, SVG title),
+ *    skipped for an element the resolver reports as exposed as presentational
+ *    (`isExposedAsPresentational`).
  * 6. **Step 2F — Name from content** — If the element's role allows
  *    `nameFrom: ["content"]`, or the element is referenced by `aria-labelledby`
  *    (`inLabelledbyTraversal`), recursively collect child text (including
@@ -28,14 +31,43 @@ 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;
+/**
+ * Computes the text alternative of an element as a node referenced by
+ * `aria-labelledby` or `aria-describedby` (the LabelledBy Traversal of Step 2B,
+ * which the description computation also uses).
+ *
+ * @param el - The referenced element
+ * @param resolver - Environment-dependent resolver for DOM traversal and role queries
+ * @returns The computed text alternative and its source
+ * @see https://w3c.github.io/accname/#comp_labelledby_traversal
+ */
+export declare function computeReferencedTextAlternative(el: AccnameElement, resolver: AccnameResolver): AccnameResult;
+/**
+ * Computes the host language text alternative of an element (AccName §4.3.2
+ * Step 2E, HTML-AAM §4.1), such as the `alt` of an image or the `title` of an
+ * SVG element, whether or not the element is exposed as presentational.
+ *
+ * Tells what an explicit `none` or `presentation` role drops from the name:
+ * every source the HTML-AAM rules of Step 2E give (`label`, `alt`, `value`,
+ * `placeholder`, `legend`, `caption`, `svg-title`, and the `default` label of a
+ * submit, reset or image button). The sources that Step 2E shares with other
+ * steps (`content`, the `title` attribute) are not dropped by the role, and give
+ * `null`.
+ *
+ * @param el - The element
+ * @param resolver - Environment-dependent resolver for DOM traversal and role queries
+ * @returns The text alternative and its source, or `null` if the element has none
+ * @see https://w3c.github.io/accname/#comp_host_language_label
+ */
+export declare function computeHostLanguageLabel(el: AccnameElement, resolver: AccnameResolver): AccnameResult | null;
 /**
  * @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

@@ -1,7 +1,8 @@
 /* eslint-disable @typescript-eslint/prefer-readonly-parameter-types -- AccnameElement wraps mutable DOM types */
-import { resolveAriaLabel, resolveAriaLabelledby } from './aria-steps.js';
+import { computeReferenced, resolveAriaLabel, resolveAriaLabelledby } from './aria-steps.js';
 import { getElementSpecificName } from './element-names.js';
-import { makeResult, resolveNameFromContent } from './helpers.js';
+import { resolveNameFromContent } from './helpers.js';
+import { makeResult } from './result.js';
 const EMPTY_RESULT = { name: '', source: null };
 /**
  * Computes the accessible name for an element.
@@ -12,8 +13,9 @@ const EMPTY_RESULT = { name: '', source: null };
  *
  * Control flow (Steps map to AccName 1.2 §4.3.2):
  *
- * 1. **Step 2A — Hidden check** — If the element is hidden (per `isHidden`) and NOT
- *    referenced by `aria-labelledby`, return empty immediately.
+ * 1. **Step 2A — Hidden check** — If the element is hidden (per `isHidden`), return
+ *    empty immediately, unless it is in an `aria-labelledby` traversal whose
+ *    directly referenced node is hidden.
  * 2. **Pre-computed name** — (Implementation-specific extension) If the
  *    resolver provides `getPrecomputedName`, check it before standard steps.
  *    Used by ml-core's Pretender integration for framework components.
@@ -22,7 +24,9 @@ const EMPTY_RESULT = { name: '', source: null };
  *    labelledby traversal (`inLabelledbyTraversal`) to prevent re-entry.
  * 4. **Step 2D — `aria-label`** — Use the `aria-label` attribute value.
  * 5. **Step 2E — Element-specific name** — Dispatch to HTML-AAM §4.1
- *    element-specific rules (label association, alt, value, legend, caption, SVG title).
+ *    element-specific rules (label association, alt, value, legend, caption, SVG title),
+ *    skipped for an element the resolver reports as exposed as presentational
+ *    (`isExposedAsPresentational`).
  * 6. **Step 2F — Name from content** — If the element's role allows
  *    `nameFrom: ["content"]`, or the element is referenced by `aria-labelledby`
  *    (`inLabelledbyTraversal`), recursively collect child text (including
@@ -32,21 +36,62 @@ 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());
 }
+/**
+ * Computes the text alternative of an element as a node referenced by
+ * `aria-labelledby` or `aria-describedby` (the LabelledBy Traversal of Step 2B,
+ * which the description computation also uses).
+ *
+ * @param el - The referenced element
+ * @param resolver - Environment-dependent resolver for DOM traversal and role queries
+ * @returns The computed text alternative and its source
+ * @see https://w3c.github.io/accname/#comp_labelledby_traversal
+ */
+export function computeReferencedTextAlternative(el, resolver) {
+    return computeReferenced(el, resolver, new Set(el.id ? [el.id] : []), computeAccessibleNameInternal);
+}
+/**
+ * Computes the host language text alternative of an element (AccName §4.3.2
+ * Step 2E, HTML-AAM §4.1), such as the `alt` of an image or the `title` of an
+ * SVG element, whether or not the element is exposed as presentational.
+ *
+ * Tells what an explicit `none` or `presentation` role drops from the name:
+ * every source the HTML-AAM rules of Step 2E give (`label`, `alt`, `value`,
+ * `placeholder`, `legend`, `caption`, `svg-title`, and the `default` label of a
+ * submit, reset or image button). The sources that Step 2E shares with other
+ * steps (`content`, the `title` attribute) are not dropped by the role, and give
+ * `null`.
+ *
+ * @param el - The element
+ * @param resolver - Environment-dependent resolver for DOM traversal and role queries
+ * @returns The text alternative and its source, or `null` if the element has none
+ * @see https://w3c.github.io/accname/#comp_host_language_label
+ */
+export function computeHostLanguageLabel(el, resolver) {
+    const result = getElementSpecificName(el, resolver, new Set(), computeAccessibleNameInternal, false);
+    if (!result?.source || result.source === 'content' || result.source === 'title') {
+        return null;
+    }
+    return result;
+}
 /**
  * @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 unless referenced by aria-labelledby
-    if (!inLabelledbyTraversal && resolver.isHidden(el)) {
+    // AccName 1.2 §4.3.2 Step 2A: Hidden elements return empty. In an aria-labelledby
+    // traversal whose referenced node is hidden, `computeReferenced` passes a
+    // resolver that finds nothing hidden.
+    const hidden = resolver.isHidden(el);
+    resolver.onVisit?.(el, { hidden, embeddedControl: false, inLabelledbyTraversal });
+    if (hidden) {
         return EMPTY_RESULT;
     }
     // [Implementation-specific] Pre-computed name (e.g., Pretender integration) — checked after hidden check
@@ -68,8 +113,11 @@ export function computeAccessibleNameInternal(el, resolver, inLabelledbyTraversa
     if (ariaLabelResult) {
         return ariaLabelResult;
     }
-    // AccName 1.2 §4.3.2 Step 2E: Element-specific name (HTML-AAM §4.1)
-    const elementResult = getElementSpecificName(el, resolver, visited, computeAccessibleNameInternal, inLabelledbyTraversal);
+    // AccName 1.2 §4.3.2 Step 2E: Element-specific name (HTML-AAM §4.1),
+    // "unless the current node is exposed as presentational"
+    const elementResult = resolver.isExposedAsPresentational?.(el)
+        ? null
+        : getElementSpecificName(el, resolver, visited, computeAccessibleNameInternal, inLabelledbyTraversal);
     if (elementResult) {
         return elementResult;
     }

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

@@ -1,4 +1,4 @@
-import type { AccnameElement, AccnameResolver, AccnameResult } from './types.js';
+import type { AccnameComputeFn, AccnameElement, AccnameResolver, AccnameResult } from './types.js';
 /**
  * Implements AccName 1.2 §4.3.2 Step 2E: for elements that have a native
  * host language text alternative, use that alternative. The specific rules
@@ -7,7 +7,7 @@ import type { AccnameElement, AccnameResolver, AccnameResult } from './types.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 declare function getElementSpecificName(el: AccnameElement, resolver: AccnameResolver, visited: ReadonlySet<string>, computeFn: (el: AccnameElement, resolver: AccnameResolver, inLabelledbyTraversal: boolean, visited: ReadonlySet<string>) => AccnameResult, inLabelledbyTraversal: boolean): AccnameResult | null;
+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

@@ -1,7 +1,8 @@
 /* eslint-disable @typescript-eslint/prefer-readonly-parameter-types -- AccnameElement wraps mutable DOM types */
 import { DEFAULT_IMAGE_LABEL, DEFAULT_RESET_LABEL, DEFAULT_SUBMIT_LABEL, TEXT_INPUT_TYPES, } from '../../../const/index.js';
-import { findChildByLocalName, getInputType, getTextContent, isSvgElement, makeResult, resolveNameFromContent, } from './helpers.js';
+import { findChildByLocalName, getInputType, getTextContent, isSvgElement, resolveNameFromContent } from './helpers.js';
 import { resolveLabelText } from './label-steps.js';
+import { makeResult } from './result.js';
 /**
  * Implements AccName 1.2 §4.3.2 Step 2E: for elements that have a native
  * host language text alternative, use that alternative. The specific rules
@@ -10,8 +11,8 @@ import { resolveLabelText } from './label-steps.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)) {
@@ -67,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);
@@ -87,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);
@@ -113,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);
@@ -140,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);
@@ -160,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);
@@ -180,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);
@@ -199,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);
@@ -218,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')) {
@@ -235,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');
@@ -251,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');
@@ -264,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);
@@ -280,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);
@@ -296,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');
@@ -308,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);