From 6188372b6168557d59146255db9ebef6cbafbf93 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Wed, 22 Jul 2026 18:26:10 +0000
Subject: [PATCH 01/19] Make the a11y linter aware of child templates

The axe-core HTML plugin previously replaced every custom tag with a
bare <div> wrapper, so it could never see what a child template renders
and any component usage suppressed most content rules on its ancestors
(via the unknownBody exception). Extraction now inlines the extracted
skeleton of resolvable child templates at the usage site, guarded so a
diagnostic is only ever produced when it is provably true for rendered
output:

- Child skeletons are resolved through the taglib lookup, cached per
  template and project version, and bounded by cycle detection, a depth
  limit, and a byte budget; anything unresolvable falls back to the old
  <div> behavior.
- A template's default body slot (`<${input.renderBody}/>`) is detected
  so usage-site body content is spliced into the child's true position;
  templates without a single known slot keep the previous behavior.
- Any uncertainty inside a child (unescaped placeholders, unresolvable
  tags, dynamic body content) propagates to the usage site so existing
  unknownBody suppression still applies.
- Diagnostics on a child skeleton's top-level elements are re-anchored
  to the tag name at the usage site; deeper elements are left to the
  child template's own validation.
- Control flow tags (if/else/for/while) emit their body directly
  instead of a fabricated <div>, so structural rules see real
  parent/child relationships.
- listitem and dlitem are un-blacklisted, gated by a new
  requiresKnownParent exception that mirrors exactly the ancestor chain
  axe consults (including dlitem's presentational-div lookthrough), and
  never fires for elements whose rendered parent is unknown.
- Duplicate-detection rules (accesskeys, landmark-unique, ...) are
  suppressed for elements in control flow branches, removing a class of
  pre-existing false positives from mutually exclusive branches.

No diagnostics changed on the existing fixture corpus; new fixtures
cover inlined context, slot splicing, uncertainty suppression,
recursion, control flow, and dlitem gating.
---
 .changeset/spotty-moons-repeat.md             |  11 +
 agent-feedback/bugs.md                        |  12 +
 cspell.json                                   |   2 +
 .../components/fancy-item.html                |   1 +
 .../components/fancy-item.md                  |   0
 .../components/fancy-item.ts                  |  61 ++++
 .../index.html                                |   5 +
 .../child-template-context.expected/index.md  |  12 +
 .../child-template-context.expected/index.ts  |  75 +++++
 .../components/fancy-item.marko               |   1 +
 .../html/child-template-context/index.marko   |   7 +
 .../components/icon-arrow.html                |   1 +
 .../components/icon-arrow.md                  |   0
 .../components/icon-arrow.ts                  |  62 +++++
 .../components/text-label.html                |   1 +
 .../components/text-label.md                  |   0
 .../components/text-label.ts                  |  61 ++++
 .../index.html                                |   5 +
 .../index.md                                  |  17 ++
 .../index.ts                                  |  77 +++++
 .../components/icon-arrow.marko               |   1 +
 .../components/text-label.marko               |   1 +
 .../html/child-template-link-name/index.marko |   7 +
 .../components/tree-item.html                 |   6 +
 .../components/tree-item.md                   |   0
 .../components/tree-item.ts                   |  72 +++++
 .../index.html                                |   8 +
 .../index.md                                  |   0
 .../index.ts                                  |  64 +++++
 .../components/tree-item.marko                |   6 +
 .../html/child-template-recursive/index.marko |   3 +
 .../components/my-card.html                   |   1 +
 .../components/my-card.md                     |   0
 .../components/my-card.ts                     |  66 +++++
 .../components/my-list.html                   |   1 +
 .../components/my-list.md                     |   0
 .../components/my-list.ts                     |  66 +++++
 .../child-template-slot.expected/index.html   |   6 +
 .../child-template-slot.expected/index.md     |  12 +
 .../child-template-slot.expected/index.ts     |  94 +++++++
 .../components/my-card.marko                  |   5 +
 .../components/my-list.marko                  |   5 +
 .../html/child-template-slot/index.marko      |   8 +
 .../components/raw-html.html                  |   1 +
 .../components/raw-html.md                    |   0
 .../components/raw-html.ts                    |  64 +++++
 .../index.html                                |   3 +
 .../index.md                                  |  11 +
 .../index.ts                                  |  64 +++++
 .../components/raw-html.marko                 |   5 +
 .../html/child-template-uncertain/index.marko |   3 +
 .../index.html                                |  15 +
 .../index.md                                  |  13 +
 .../index.ts                                  | 116 ++++++++
 .../html/control-flow-conditional/index.marko |  25 ++
 .../dlitem-context.expected/index.html        |   8 +
 .../dlitem-context.expected/index.md          |  12 +
 .../dlitem-context.expected/index.ts          |  95 +++++++
 .../fixtures/html/dlitem-context/index.marko  |  10 +
 .../index.html                                |   2 +-
 .../index.html                                |   2 +-
 .../index.html                                |   8 +-
 .../tags/my-menu/index.html                   |   3 +-
 .../attr-tags-dynamic-for.expected/index.html |  44 +--
 .../attr-tags-dynamic-if.expected/index.html  |  64 ++---
 .../index.html                                |  16 +-
 .../index.html                                |  20 +-
 .../index.html                                |   8 +-
 .../attr-tags-generic.expected/index.html     |   4 +-
 .../index.html                                |   8 +-
 .../tags/my-layout/index.html                 |   7 +-
 .../attr-tags-nested-type.expected/index.html |   4 +-
 .../index.html                                |   6 +-
 .../bound-attr-mut-ident.expected/index.html  |   2 +-
 .../class-api-basic.expected/index.html       |  20 +-
 .../custom-tag-args.expected/index.html       |   1 +
 .../el-ref-hoist.expected/index.html          |   2 +-
 .../for-tag-attr-tags.expected/index.html     |   8 +-
 .../for-tag-input.expected/index.html         |  20 +-
 .../__snapshots__/for-tag.expected/index.html |  37 ++-
 .../__snapshots__/if-tag.expected/index.html  |  59 ++--
 .../index.html                                |   6 +-
 .../recursive-define-tag.expected/index.html  |   7 +-
 .../render-body-basic.expected/index.html     |   3 +-
 .../return-tag-basic.expected/index.html      |   2 +-
 .../return-tag-nested.expected/index.html     |  12 +-
 .../simple-hoist.expected/index.html          |   2 +-
 .../tag-param-mutation.expected/index.html    |  10 +-
 .../index.html                                |  12 +-
 .../index.html                                |   5 +-
 .../index.html                                |   2 +-
 .../index.html                                |   4 +-
 .../tag-var-mutations.expected/index.html     |   2 +-
 .../tags-api-basic.expected/index.html        |  24 +-
 .../while-tag.expected/index.html             |  11 +-
 .../service/html/axe-rules/rule-exceptions.ts |  52 +++-
 .../language-server/src/service/html/index.ts | 263 ++++++++++++++++--
 .../src/extractors/html/index.ts              | 257 ++++++++++++++---
 packages/language-tools/src/util/extractor.ts |   5 +
 99 files changed, 2020 insertions(+), 292 deletions(-)
 create mode 100644 .changeset/spotty-moons-repeat.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-context/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/icon-arrow.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/text-label.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-link-name/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/components/tree-item.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-recursive/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-card.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-list.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-slot/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/dlitem-context/index.marko

diff --git a/.changeset/spotty-moons-repeat.md b/.changeset/spotty-moons-repeat.md
new file mode 100644
index 00000000..9e74a5fb
--- /dev/null
+++ b/.changeset/spotty-moons-repeat.md
@@ -0,0 +1,11 @@
+---
+"@marko/language-tools": minor
+"@marko/language-server": minor
+---
+
+Improve the axe-core accessibility linter's awareness of child templates:
+
+- Custom tags that resolve to a `.marko` template now inline that template's extracted HTML at the usage site (with cycle, depth, and size guards), so rules can evaluate a tag's rendered output in context — eg `<a href><my-icon/></a>` now reports `link-name` when the icon renders `aria-hidden` content, and diagnostics for a template's top-level elements are re-anchored to the tag usage (`<my-item/>` inside `<div>` reports `listitem`).
+- Control flow tags (`<if>`, `<else>`, `<for>`, `<while>`) no longer fabricate `<div>` wrappers around their body, so structural rules see true parent/child relationships.
+- The `listitem` and `dlitem` rules are now enabled, gated so they only report when the parent chain axe consults is fully known (never for a template's own top-level elements, whose parent comes from the usage site).
+- Duplicate-detection rules (`accesskeys`, `landmark-unique`, `identical-links-same-purpose`, ...) are suppressed for elements inside control flow branches, since only one branch renders at a time.
diff --git a/agent-feedback/bugs.md b/agent-feedback/bugs.md
index bb895850..fd6a8167 100644
--- a/agent-feedback/bugs.md
+++ b/agent-feedback/bugs.md
@@ -23,3 +23,15 @@ The runtime accepts a string OR number loop key — `assertValidLoopKey` throws
 `packages/language-tools/src/extractors/script/index.ts` › `#writeTag` | 2026-07-19 | impact:high | effort:med
 
 A custom tag that fails to resolve (a component referenced by kebab tag name with no `import`, or a typo'd tag name) is a hard build error but produces ZERO diagnostics under `mtc` — the type-check tool agents are told to run. Reproduced in a real @marko/run scaffold: Marko 6 auto-discovers only `tags/` dirs (`runtime-tags` sets `tagDiscoveryDirs = ["tags"]` at `packages/runtime-tags/src/translator/index.ts:40`), so `src/components/*.marko` is NOT auto-registered — `<user-card name="X" age="alsoWrong" bogus=true/>` (no import) and the typo `<char-cont max="wrong" nope=1/>` both pass `mtc` with exit 0, while `npm run compile -o html` / `marko-run build` throw `Unable to find entry point for custom tag <user-card>` (`resolveTagImport` at `tags.js:353`; `tagNotFoundError` at `packages/runtime-tags/src/translator/visitors/tag/custom-tag.ts:411`). The identical wrong attr on a RESOLVED tag correctly errors TS2322 (verified against `<char-count max="not-a-number">`), proving tag resolution — not the attribute — is the gate: `#writeTag` lowers an unresolvable tag to `renderDynamicTag(...)` whose input is `Record<string, unknown>`, so every attribute and callback param goes unchecked. This is the worst shape for an agent whose deterministic verify loop is `mtc`: it creates a component, references it by tag (natural for anyone used to auto-registering `components/` dirs), sees a clean type-check, and ships wrong props or a misspelled tag; the build then fails with an "entry point" error that looks unrelated to the type loop. Direction: have @marko/language-tools emit a distinct "cannot resolve tag `<x>`" diagnostic mirroring the compiler instead of degrading to an untyped dynamic tag. The compiler-side authority is marko-js/marko's `packages/compiler/src/babel-utils/tags.js` › `resolveTagImport` and `custom-tag.ts` › `tagNotFoundError`. Distinct from the run dx.md route-types entries (missing `Run` global / stale `routes.d.ts`), which concern generated route types, not custom-tag resolution.
+
+## Propagate descendant dynamic attribute values into `hasDynamicBody` for a11y rule suppression
+
+`packages/language-tools/src/extractors/html/index.ts` › `HTMLExtractor.#visitNode` | 2026-07-22 | impact:med | effort:med
+
+Dynamic _attribute_ values on descendants do not propagate into an ancestor's `hasDynamicBody`, so `unknownBody` rule exceptions can miss. Example: `<div role="list"><div role=input.x></div></div>` extracts the child as `role="dynamic"` (an invalid role) while the outer element's `hasDynamicBody` stays false, so axe's `aria-required-children` reports a violation even though the runtime role could be `listitem` — a false positive that predates child-template inlining. `#visitNode` returns `isDynamic || hasDynamicBody` and deliberately ignores `hasDynamicAttrs`; a fix could propagate a separate "semantics-affecting dynamic attr" flag (role/aria-\*/tabindex only, to avoid over-suppressing on eg dynamic `class`) into ancestors. Re-verify: `<div role="list"><div role=input.x></div></div>` in an html fixture produces an `aria-required-children` diagnostic.
+
+## Suppress duplicate-detection a11y rules when the duplicate _counterpart_ is conditional, via axe relatedNodes
+
+`packages/language-server/src/service/html/index.ts` › `doValidate` | 2026-07-22 | impact:low | effort:med
+
+The `conditionalContent` exception only suppresses duplicate-detection rules (accesskeys, landmark-unique, identical-links-same-purpose, ...) when the _violating_ element is inside a control flow branch. When the violating element is unconditional but its duplicate counterpart is conditional (eg a static `<label>` plus a second `<label>` inside `<if>` for `form-field-multiple-labels`), the false positive remains. axe exposes the counterparts via each check's `relatedNodes`; suppressing when any related node maps to an `inConditional` element would close the gap. Re-verify: fixture with `<main>` plus `<if=x><main></if>` — the unconditional `<main>` may still be reported by `landmark-no-duplicate-main`.
diff --git a/cspell.json b/cspell.json
index fcc0951c..0f6eb819 100644
--- a/cspell.json
+++ b/cspell.json
@@ -5,9 +5,11 @@
     "accesskey",
     "accesskeys",
     "Berrocal",
+    "bodyless",
     "braillelabel",
     "brailleroledescription",
     "codegen",
+    "dedup",
     "Commentable",
     "contenteditable",
     "contentinfo",
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html
new file mode 100644
index 00000000..7a45c67c
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html
@@ -0,0 +1 @@
+<li data-marko-node-id="0">fancy</li>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.md b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts
new file mode 100644
index 00000000..d80186d0
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts
@@ -0,0 +1,61 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("li")()()({
+    [Marko._.content]: (() => {
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const FancyItem = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default FancyItem;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.html
new file mode 100644
index 00000000..49c7d560
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.html
@@ -0,0 +1,5 @@
+<ul data-marko-node-id="0">
+  <li data-marko-node-id="fancy-item.marko#0">fancy</li>
+</ul><div data-marko-node-id="1">
+  <li data-marko-node-id="fancy-item.marko#0">fancy</li>
+</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
new file mode 100644
index 00000000..6f4f11eb
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
@@ -0,0 +1,12 @@
+## Diagnostics
+### Ln 6, Col 4
+```marko
+  4 |
+  5 | <div>
+> 6 |   <fancy-item/>
+    |    ^^^^^^^^^^ Fix any of the following:
+  List item does not have a <ul>, <ol> parent element
+  7 | </div>
+  8 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
new file mode 100644
index 00000000..294e4a1b
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
@@ -0,0 +1,75 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("ul")()()({
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = Marko._.resolveTemplate(
+        import("./components/fancy-item.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.renderNativeTag("div")()()({
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_2 = Marko._.resolveTemplate(
+        import("./components/fancy-item.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_2)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko
new file mode 100644
index 00000000..d8e059a0
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko
@@ -0,0 +1 @@
+<li>fancy</li>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-context/index.marko
new file mode 100644
index 00000000..1a5efaf9
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/index.marko
@@ -0,0 +1,7 @@
+<ul>
+  <fancy-item/>
+</ul>
+
+<div>
+  <fancy-item/>
+</div>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.html b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.html
new file mode 100644
index 00000000..43f88a7b
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.html
@@ -0,0 +1 @@
+<span data-marko-node-id="0" aria-hidden="true">x</span>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.md b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.ts
new file mode 100644
index 00000000..3d238fd0
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/icon-arrow.ts
@@ -0,0 +1,62 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("span")()()({
+    "aria-hidden": "true",
+    [Marko._.content]: (() => {
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const IconArrow = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default IconArrow;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.html b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.html
new file mode 100644
index 00000000..69831b5f
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.html
@@ -0,0 +1 @@
+<span data-marko-node-id="0">Read more</span>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.md b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.ts
new file mode 100644
index 00000000..f200fcde
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/components/text-label.ts
@@ -0,0 +1,61 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("span")()()({
+    [Marko._.content]: (() => {
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const TextLabel = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default TextLabel;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.html
new file mode 100644
index 00000000..f28b82cb
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.html
@@ -0,0 +1,5 @@
+<a data-marko-node-id="0" href="/bad">
+  <span data-marko-node-id="icon-arrow.marko#0" aria-hidden="true">x</span>
+</a><a data-marko-node-id="1" href="/good">
+  <span data-marko-node-id="text-label.marko#0">Read more</span>
+</a>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.md
new file mode 100644
index 00000000..1bbab42e
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.md
@@ -0,0 +1,17 @@
+## Diagnostics
+### Ln 1, Col 2
+```marko
+> 1 | <a href="/bad">
+    |  ^ Fix all of the following:
+  Element is in tab order and does not have accessible text
+
+Fix any of the following:
+  Element does not have text that is visible to screen readers
+  aria-label attribute does not exist or is empty
+  aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
+  Element has no title attribute
+  2 |   <icon-arrow/>
+  3 | </a>
+  4 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.ts
new file mode 100644
index 00000000..d59965f9
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/__snapshots__/child-template-link-name.expected/index.ts
@@ -0,0 +1,77 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("a")()()({
+    href: "/bad",
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = Marko._.resolveTemplate(
+        import("./components/icon-arrow.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.renderNativeTag("a")()()({
+    href: "/good",
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_2 = Marko._.resolveTemplate(
+        import("./components/text-label.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_2)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/icon-arrow.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/icon-arrow.marko
new file mode 100644
index 00000000..29349c40
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/icon-arrow.marko
@@ -0,0 +1 @@
+<span aria-hidden="true">x</span>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/text-label.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/text-label.marko
new file mode 100644
index 00000000..b531e7fd
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/components/text-label.marko
@@ -0,0 +1 @@
+<span>Read more</span>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/index.marko
new file mode 100644
index 00000000..0c1cf94e
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-link-name/index.marko
@@ -0,0 +1,7 @@
+<a href="/bad">
+  <icon-arrow/>
+</a>
+
+<a href="/good">
+  <text-label/>
+</a>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.html b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.html
new file mode 100644
index 00000000..bf9ed415
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.html
@@ -0,0 +1,6 @@
+<li data-marko-node-id="0">
+  node
+  <ul data-marko-node-id="1">
+    
+  </ul>
+</li>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.md b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.ts
new file mode 100644
index 00000000..eb5a966b
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/components/tree-item.ts
@@ -0,0 +1,72 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("li")()()({
+    [Marko._.content]: (() => {
+      Marko._.renderNativeTag("ul")()()({
+        [Marko._.content]: (() => {
+          const __marko_internal_tag_1 = Marko._.resolveTemplate(
+            import("./tree-item.marko"),
+          );
+          Marko._.renderTemplate(__marko_internal_tag_1)()()({});
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const TreeItem = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default TreeItem;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.html
new file mode 100644
index 00000000..9c4b9feb
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.html
@@ -0,0 +1,8 @@
+<ul data-marko-node-id="0">
+  <li data-marko-node-id="tree-item.marko#0">
+  node
+  <ul data-marko-node-id="tree-item.marko#1">
+    
+  </ul>
+</li>
+</ul>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.ts
new file mode 100644
index 00000000..eb6acf23
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/__snapshots__/child-template-recursive.expected/index.ts
@@ -0,0 +1,64 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("ul")()()({
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = Marko._.resolveTemplate(
+        import("./components/tree-item.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/components/tree-item.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/components/tree-item.marko
new file mode 100644
index 00000000..7d5c63ea
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/components/tree-item.marko
@@ -0,0 +1,6 @@
+<li>
+  node
+  <ul>
+    <tree-item/>
+  </ul>
+</li>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/index.marko
new file mode 100644
index 00000000..b16a13d3
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-recursive/index.marko
@@ -0,0 +1,3 @@
+<ul>
+  <tree-item/>
+</ul>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.html b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.html
new file mode 100644
index 00000000..df3a8c50
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.html
@@ -0,0 +1 @@
+<div data-marko-node-id="0" class="card"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.md b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.ts
new file mode 100644
index 00000000..d897af64
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-card.ts
@@ -0,0 +1,66 @@
+export interface Input {
+  renderBody: Marko.Body;
+}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("div")()()({
+    class: "card",
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = input.renderBody;
+      Marko._.renderDynamicTag(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const MyCard = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default MyCard;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.html b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.html
new file mode 100644
index 00000000..014af88c
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.html
@@ -0,0 +1 @@
+<ul data-marko-node-id="0" class="fancy"></ul>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.md b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.ts
new file mode 100644
index 00000000..d3c38183
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/components/my-list.ts
@@ -0,0 +1,66 @@
+export interface Input {
+  renderBody: Marko.Body;
+}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("ul")()()({
+    class: "fancy",
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = input.renderBody;
+      Marko._.renderDynamicTag(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const MyList = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default MyList;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.html
new file mode 100644
index 00000000..b2701cfd
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.html
@@ -0,0 +1,6 @@
+<ul data-marko-node-id="my-list.marko#0" class="fancy">
+  <li data-marko-node-id="0">one</li>
+  <li data-marko-node-id="1">two</li>
+</ul><div data-marko-node-id="my-card.marko#0" class="card">
+  <li data-marko-node-id="2">stray</li>
+</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.md
new file mode 100644
index 00000000..0e6a22d2
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.md
@@ -0,0 +1,12 @@
+## Diagnostics
+### Ln 7, Col 4
+```marko
+  5 |
+  6 | <my-card>
+> 7 |   <li>stray</li>
+    |    ^^ Fix any of the following:
+  List item does not have a <ul>, <ol> parent element
+  8 | </my-card>
+  9 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.ts
new file mode 100644
index 00000000..5e5823b2
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/__snapshots__/child-template-slot.expected/index.ts
@@ -0,0 +1,94 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  const __marko_internal_tag_1 = Marko._.resolveTemplate(
+    import("./components/my-list.marko"),
+  );
+  Marko._.renderTemplate(__marko_internal_tag_1)()()({
+    [Marko._.contentFor(__marko_internal_tag_1)]: (() => {
+      Marko._.renderNativeTag("li")()()({
+        [Marko._.content]: (() => {
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      Marko._.renderNativeTag("li")()()({
+        [Marko._.content]: (() => {
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  const __marko_internal_tag_2 = Marko._.resolveTemplate(
+    import("./components/my-card.marko"),
+  );
+  Marko._.renderTemplate(__marko_internal_tag_2)()()({
+    [Marko._.contentFor(__marko_internal_tag_2)]: (() => {
+      Marko._.renderNativeTag("li")()()({
+        [Marko._.content]: (() => {
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-card.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-card.marko
new file mode 100644
index 00000000..75f47054
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-card.marko
@@ -0,0 +1,5 @@
+export interface Input {
+  renderBody: Marko.Body;
+}
+
+<div class="card"><${input.renderBody}/></div>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-list.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-list.marko
new file mode 100644
index 00000000..5dce00f3
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/components/my-list.marko
@@ -0,0 +1,5 @@
+export interface Input {
+  renderBody: Marko.Body;
+}
+
+<ul class="fancy"><${input.renderBody}/></ul>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-slot/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/index.marko
new file mode 100644
index 00000000..f20ca1d2
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-slot/index.marko
@@ -0,0 +1,8 @@
+<my-list>
+  <li>one</li>
+  <li>two</li>
+</my-list>
+
+<my-card>
+  <li>stray</li>
+</my-card>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.html b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.html
new file mode 100644
index 00000000..7693b577
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.html
@@ -0,0 +1 @@
+<div data-marko-node-id="0">placeholder</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.md b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
new file mode 100644
index 00000000..38e4ab85
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
@@ -0,0 +1,64 @@
+export interface Input {
+  html: string;
+}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("div")()()({
+    [Marko._.content]: (() => {
+      input.html;
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const RawHtml = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default RawHtml;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
new file mode 100644
index 00000000..795efae6
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
@@ -0,0 +1,3 @@
+<ul data-marko-node-id="0">
+  <div data-marko-node-id="raw-html.marko#0">placeholder</div>
+</ul>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
new file mode 100644
index 00000000..fbf9b645
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
@@ -0,0 +1,11 @@
+## Diagnostics
+### Ln 2, Col 4
+```marko
+  1 | <ul>
+> 2 |   <raw-html/>
+    |    ^^^^^^^^ Argument of type '{}' is not assignable to parameter of type 'Directives & Input'.
+  Property 'html' is missing in type '{}' but required in type 'Input'.
+  3 | </ul>
+  4 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
new file mode 100644
index 00000000..200b00a2
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
@@ -0,0 +1,64 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("ul")()()({
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_1 = Marko._.resolveTemplate(
+        import("./components/raw-html.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_1)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
new file mode 100644
index 00000000..9e7514cd
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
@@ -0,0 +1,5 @@
+export interface Input {
+  html: string;
+}
+
+<div>$!{input.html}</div>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
new file mode 100644
index 00000000..e9ff1f2a
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
@@ -0,0 +1,3 @@
+<ul>
+  <raw-html/>
+</ul>
diff --git a/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.html
new file mode 100644
index 00000000..365becd3
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.html
@@ -0,0 +1,15 @@
+<ul data-marko-node-id="0">
+  
+    <li data-marko-node-id="1">a</li>
+  
+  
+    <li data-marko-node-id="2">b</li>
+  
+</ul><div data-marko-node-id="3">
+  
+    <li data-marko-node-id="4">stray</li>
+  
+</div>
+  <a data-marko-node-id="5" href="/first" accesskey="q">First</a>
+
+  <a data-marko-node-id="6" href="/second" accesskey="q">Second</a>
diff --git a/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.md
new file mode 100644
index 00000000..1ee59090
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.md
@@ -0,0 +1,13 @@
+## Diagnostics
+### Ln 16, Col 6
+```marko
+  14 | <div>
+  15 |   <if=input.a>
+> 16 |     <li>stray</li>
+     |      ^^ Fix any of the following:
+  List item does not have a <ul>, <ol> parent element
+  17 |   </if>
+  18 | </div>
+  19 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.ts
new file mode 100644
index 00000000..3e55d143
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/__snapshots__/control-flow-conditional.expected/index.ts
@@ -0,0 +1,116 @@
+export interface Input {
+  a: boolean;
+}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("ul")()()({
+    [Marko._.content]: (() => {
+      if (input.a) {
+        Marko._.renderNativeTag("li")()()({
+          [Marko._.content]: (() => {
+            return () => {
+              return Marko._.voidReturn;
+            };
+          })(),
+        });
+      } else {
+        Marko._.renderNativeTag("li")()()({
+          [Marko._.content]: (() => {
+            return () => {
+              return Marko._.voidReturn;
+            };
+          })(),
+        });
+      }
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.renderNativeTag("div")()()({
+    [Marko._.content]: (() => {
+      if (input.a) {
+        Marko._.renderNativeTag("li")()()({
+          [Marko._.content]: (() => {
+            return () => {
+              return Marko._.voidReturn;
+            };
+          })(),
+        });
+      }
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  if (input.a) {
+    Marko._.renderNativeTag("a")()()({
+      href: "/first",
+      accesskey: "q",
+      [Marko._.content]: (() => {
+        return () => {
+          return Marko._.voidReturn;
+        };
+      })(),
+    });
+  } else {
+    Marko._.renderNativeTag("a")()()({
+      href: "/second",
+      accesskey: "q",
+      [Marko._.content]: (() => {
+        return () => {
+          return Marko._.voidReturn;
+        };
+      })(),
+    });
+  }
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/index.marko b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/index.marko
new file mode 100644
index 00000000..2cf3771b
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/control-flow-conditional/index.marko
@@ -0,0 +1,25 @@
+export interface Input {
+  a: boolean;
+}
+
+<ul>
+  <if=input.a>
+    <li>a</li>
+  </if>
+  <else>
+    <li>b</li>
+  </else>
+</ul>
+
+<div>
+  <if=input.a>
+    <li>stray</li>
+  </if>
+</div>
+
+<if=input.a>
+  <a href="/first" accesskey="q">First</a>
+</if>
+<else>
+  <a href="/second" accesskey="q">Second</a>
+</else>
diff --git a/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.html
new file mode 100644
index 00000000..fa2e2595
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.html
@@ -0,0 +1,8 @@
+<dl data-marko-node-id="0">
+  <div data-marko-node-id="1">
+    <dt data-marko-node-id="2">term</dt>
+    <dd data-marko-node-id="3">definition</dd>
+  </div>
+</dl><section data-marko-node-id="4">
+  <dt data-marko-node-id="5">stray term</dt>
+</section>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.md
new file mode 100644
index 00000000..7298d69e
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.md
@@ -0,0 +1,12 @@
+## Diagnostics
+### Ln 9, Col 4
+```marko
+   7 |
+   8 | <section>
+>  9 |   <dt>stray term</dt>
+     |    ^^ Fix any of the following:
+  Description list item does not have a <dl> parent element
+  10 | </section>
+  11 |
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.ts
new file mode 100644
index 00000000..7945b1a2
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/__snapshots__/dlitem-context.expected/index.ts
@@ -0,0 +1,95 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("dl")()()({
+    [Marko._.content]: (() => {
+      Marko._.renderNativeTag("div")()()({
+        [Marko._.content]: (() => {
+          Marko._.renderNativeTag("dt")()()({
+            [Marko._.content]: (() => {
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          Marko._.renderNativeTag("dd")()()({
+            [Marko._.content]: (() => {
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.renderNativeTag("section")()()({
+    [Marko._.content]: (() => {
+      Marko._.renderNativeTag("dt")()()({
+        [Marko._.content]: (() => {
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/dlitem-context/index.marko b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/index.marko
new file mode 100644
index 00000000..73661c84
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/dlitem-context/index.marko
@@ -0,0 +1,10 @@
+<dl>
+  <div>
+    <dt>term</dt>
+    <dd>definition</dd>
+  </div>
+</dl>
+
+<section>
+  <dt>stray term</dt>
+</section>
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
index b987c922..12c87bce 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="1"></div><div data-marko-node-id="2"></div><div data-marko-node-id="3"></div><div data-marko-node-id="4"></div><div data-marko-node-id="5"></div><div data-marko-node-id="6"></div><div data-marko-node-id="7"></div><div data-marko-node-id="8"></div><div data-marko-node-id="9"></div>
\ No newline at end of file
+<div data-marko-node-id="0"></div><div data-marko-node-id="1"></div><div data-marko-node-id="2"></div><div data-marko-node-id="3"></div><div data-marko-node-id="4"></div><div data-marko-node-id="5"></div><div data-marko-node-id="6"></div><div data-marko-node-id="7"></div><div data-marko-node-id="8"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
index e7909005..f806b688 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="1" class="foo"></div><div data-marko-node-id="2" class="foo"></div><div data-marko-node-id="3" class="dynamic"></div><div data-marko-node-id="4" class="dynamic"></div><div data-marko-node-id="5" class="dynamic"></div><div data-marko-node-id="6" class="foo"></div><div data-marko-node-id="7" class="dynamic"></div><div data-marko-node-id="8" class="123"></div>
\ No newline at end of file
+<div data-marko-node-id="0" class="foo"></div><div data-marko-node-id="1" class="foo"></div><div data-marko-node-id="2" class="dynamic"></div><div data-marko-node-id="3" class="dynamic"></div><div data-marko-node-id="4" class="dynamic"></div><div data-marko-node-id="5" class="foo"></div><div data-marko-node-id="6" class="dynamic"></div><div data-marko-node-id="7" class="123"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/index.html
index 874e6c13..fcda88c8 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/index.html
@@ -1,13 +1,13 @@
 <div>
-  <div>
+  
     
-      <div data-marko-node-id="2">placeholder placeholder</div>
+      <div data-marko-node-id="0">placeholder placeholder</div>
 
     
-  </div>
+  
 </div><div>
   
-    <div data-marko-node-id="4">placeholder</div>
+    <div data-marko-node-id="1">placeholder</div>
 
   
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/tags/my-menu/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/tags/my-menu/index.html
index 5d02baf1..c0f4529d 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/tags/my-menu/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for-typed/__snapshots__/attr-tags-dynamic-for-typed.expected/tags/my-menu/index.html
@@ -1,3 +1,2 @@
-<div>
+
   
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for/__snapshots__/attr-tags-dynamic-for.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for/__snapshots__/attr-tags-dynamic-for.expected/index.html
index c01b8241..98619eff 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for/__snapshots__/attr-tags-dynamic-for.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-for/__snapshots__/attr-tags-dynamic-for.expected/index.html
@@ -1,20 +1,20 @@
 <div>
-  <div>
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder placeholder placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder
 
@@ -23,51 +23,51 @@
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-if/__snapshots__/attr-tags-dynamic-if.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-if/__snapshots__/attr-tags-dynamic-if.expected/index.html
index fde6ccb9..ee072cf0 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-if/__snapshots__/attr-tags-dynamic-if.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-if/__snapshots__/attr-tags-dynamic-if.expected/index.html
@@ -1,55 +1,55 @@
 <div>
-  <div>
+  
     
-  </div>
+  
 </div><div>
   
-  <div>
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
-  <div>
+  
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
-  <div>
+  
+  
     
-  </div>
-  <div>
+  
+  
     
-  </div>
-  <div>
+  
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
-  <div>
+  
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
-  </div>
+  
 
-  <div>
+  
     
-  </div>
+  
 </div><div>
   
   
@@ -59,13 +59,13 @@
 
   
 
-  <div>
+  
     
       
     
-  </div>
+  
 
-  <div>
+  
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-while/__snapshots__/attr-tags-dynamic-while.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-while/__snapshots__/attr-tags-dynamic-while.expected/index.html
index 2f8ae3c0..c3550c70 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-while/__snapshots__/attr-tags-dynamic-while.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-while/__snapshots__/attr-tags-dynamic-while.expected/index.html
@@ -1,26 +1,26 @@
 <div>
-  <div>
+  
 
     
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
 
     
       placeholder
 
-      <div>
+      
         
-      </div>
+      
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
       No Condition.
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-with-scriptlets/__snapshots__/attr-tags-dynamic-with-scriptlets.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-with-scriptlets/__snapshots__/attr-tags-dynamic-with-scriptlets.expected/index.html
index 53568934..c5ce6829 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-with-scriptlets/__snapshots__/attr-tags-dynamic-with-scriptlets.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-dynamic-with-scriptlets/__snapshots__/attr-tags-dynamic-with-scriptlets.expected/index.html
@@ -1,34 +1,34 @@
 <div>
-  <div>
+  
 
     
 
     
       placeholder
 
-      <div>
+      
         
-      </div>
+      
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
 
     
       placeholder
 
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
 
     
-  </div>
-  <div>
+  
+  
     
 
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-for-narrowing/__snapshots__/attr-tags-for-narrowing.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-for-narrowing/__snapshots__/attr-tags-for-narrowing.expected/index.html
index 6003ce26..8f9fb8fd 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-for-narrowing/__snapshots__/attr-tags-for-narrowing.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-for-narrowing/__snapshots__/attr-tags-for-narrowing.expected/index.html
@@ -1,12 +1,12 @@
 <div>
-  <div>
+  
     
           
-  </div>
-  <div>
+  
+  
     
           
     
           
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-generic/__snapshots__/attr-tags-generic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-generic/__snapshots__/attr-tags-generic.expected/index.html
index 3d702db5..31ea2040 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-generic/__snapshots__/attr-tags-generic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-generic/__snapshots__/attr-tags-generic.expected/index.html
@@ -4,7 +4,7 @@
     placeholder
   
 </div><div>
-  <div>
+  
     
       
       placeholder
@@ -12,5 +12,5 @@
       placeholder
       
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/index.html
index e7c0b20f..76b4b201 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/index.html
@@ -1,16 +1,16 @@
 <div>
   
-    <div>
+    
       
-        <div data-marko-node-id="2">placeholder placeholder</div>
+        <div data-marko-node-id="0">placeholder placeholder</div>
 
       
-    </div>
+    
   
 </div><div>
   
     
-      <div data-marko-node-id="4">placeholder</div>
+      <div data-marko-node-id="1">placeholder</div>
 
     
   
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/tags/my-layout/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/tags/my-layout/index.html
index 7e3c33c3..fc25e535 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/tags/my-layout/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-dynamic-for-typed/__snapshots__/attr-tags-nested-dynamic-for-typed.expected/tags/my-layout/index.html
@@ -1,5 +1,4 @@
-<div>
-  <div>
+
+  
     
-  </div>
-</div>
\ No newline at end of file
+  
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-type/__snapshots__/attr-tags-nested-type.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-type/__snapshots__/attr-tags-nested-type.expected/index.html
index d84d1a16..ef0af866 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-type/__snapshots__/attr-tags-nested-type.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-nested-type/__snapshots__/attr-tags-nested-type.expected/index.html
@@ -1,8 +1,8 @@
 <div>
   
-    <div>
+    
       
       
-    </div>
+    
   
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-tags-static-dynamic-renderbody/__snapshots__/attr-tags-static-dynamic-renderbody.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-tags-static-dynamic-renderbody/__snapshots__/attr-tags-static-dynamic-renderbody.expected/index.html
index 7aba471a..aebed217 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-tags-static-dynamic-renderbody/__snapshots__/attr-tags-static-dynamic-renderbody.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-tags-static-dynamic-renderbody/__snapshots__/attr-tags-static-dynamic-renderbody.expected/index.html
@@ -1,9 +1,9 @@
 <div>
     ...
-   <div>
+   
       
       ...
-    </div>
-    <div>placeholder</div>
+    
+    placeholder
     
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/bound-attr-mut-ident/__snapshots__/bound-attr-mut-ident.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/bound-attr-mut-ident/__snapshots__/bound-attr-mut-ident.expected/index.html
index d9fbdcc1..6f0c9f31 100644
--- a/packages/language-server/src/__tests__/fixtures/script/bound-attr-mut-ident/__snapshots__/bound-attr-mut-ident.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/bound-attr-mut-ident/__snapshots__/bound-attr-mut-ident.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="2" onClick></div>
\ No newline at end of file
+<div data-marko-node-id="0" onClick></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
index 8861aef5..0f5056d0 100644
--- a/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
@@ -1,23 +1,23 @@
 <div data-marko-node-id="0" class="mobiles__list" onClick>
     <p data-marko-node-id="1" id="p">Year: placeholder</p>
 
-    <div>
-      <span data-marko-node-id="3" class="sub-note">isSmartPhone: placeholder</span>
-    </div>
+    
+      <span data-marko-node-id="2" class="sub-note">isSmartPhone: placeholder</span>
+    
 
-    <span data-marko-node-id="4" class="sub-note">phoneType: placeholder</span>
+    <span data-marko-node-id="3" class="sub-note">phoneType: placeholder</span>
     
 
-    <div>
-      <span data-marko-node-id="6" id="dynamic">placeholder placeholder placeholder</span>
-    </div>
+    
+      <span data-marko-node-id="4" id="dynamic">placeholder placeholder placeholder</span>
+    
 
-    <div data-marko-node-id="7">
+    <div data-marko-node-id="5">
         
     </div>
     <div>placeholder</div>
-    <div data-marko-node-id="10">Hello placeholder</div>
-    <div data-marko-node-id="11">Placeholder example: <code data-marko-node-id="12">${someValue}</code></div>
+    <div data-marko-node-id="6">Hello placeholder</div>
+    <div data-marko-node-id="7">Placeholder example: <code data-marko-node-id="8">${someValue}</code></div>
 
     
     
diff --git a/packages/language-server/src/__tests__/fixtures/script/custom-tag-args/__snapshots__/custom-tag-args.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/custom-tag-args/__snapshots__/custom-tag-args.expected/index.html
index e69de29b..acda27bc 100644
--- a/packages/language-server/src/__tests__/fixtures/script/custom-tag-args/__snapshots__/custom-tag-args.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/custom-tag-args/__snapshots__/custom-tag-args.expected/index.html
@@ -0,0 +1 @@
+<div data-marko-node-id="test-tag.marko~2#0"></div><div data-marko-node-id="test-tag.marko~2#0"></div><div data-marko-node-id="test-tag.marko~2#0"></div><div data-marko-node-id="test-tag.marko~2#0"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/el-ref-hoist/__snapshots__/el-ref-hoist.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/el-ref-hoist/__snapshots__/el-ref-hoist.expected/index.html
index 6a018112..3143e0dc 100644
--- a/packages/language-server/src/__tests__/fixtures/script/el-ref-hoist/__snapshots__/el-ref-hoist.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/el-ref-hoist/__snapshots__/el-ref-hoist.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="1"></div>
\ No newline at end of file
+<div data-marko-node-id="0"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/for-tag-attr-tags/__snapshots__/for-tag-attr-tags.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/for-tag-attr-tags/__snapshots__/for-tag-attr-tags.expected/index.html
index 4ecd3f89..4575e0e3 100644
--- a/packages/language-server/src/__tests__/fixtures/script/for-tag-attr-tags/__snapshots__/for-tag-attr-tags.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/for-tag-attr-tags/__snapshots__/for-tag-attr-tags.expected/index.html
@@ -1,19 +1,19 @@
 <div>
-  <div>
+  
     
     
       placeholder
       
       placeholder
     
-  </div>
+  
 </div><div>
-  <div>
+  
     
     
       placeholder
       
       placeholder
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/for-tag-input/__snapshots__/for-tag-input.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/for-tag-input/__snapshots__/for-tag-input.expected/index.html
index 9b65e337..f6527a8f 100644
--- a/packages/language-server/src/__tests__/fixtures/script/for-tag-input/__snapshots__/for-tag-input.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/for-tag-input/__snapshots__/for-tag-input.expected/index.html
@@ -1,30 +1,30 @@
-<div>
+
     
-  <a data-marko-node-id="1" href="dynamic">
+  <a data-marko-node-id="0" href="dynamic">
     placeholder
     
   </a>
-</div><select data-marko-node-id="2">
-  <div>
+<select data-marko-node-id="1">
+  
       
-    <option data-marko-node-id="4" value="dynamic">
+    <option data-marko-node-id="2" value="dynamic">
       placeholder
       
     </option>
-  </div>
+  
 </select><div>
-  <div>
+  
       
     
       
       placeholder
     
-  </div>
-  <div>
+  
+  
       
     
       
       placeholder
     
-  </div>
+  
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/for-tag/__snapshots__/for-tag.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/for-tag/__snapshots__/for-tag.expected/index.html
index 9b7da9ff..78bd7a98 100644
--- a/packages/language-server/src/__tests__/fixtures/script/for-tag/__snapshots__/for-tag.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/for-tag/__snapshots__/for-tag.expected/index.html
@@ -1,45 +1,44 @@
-<div>
+
   Repeated!
-</div><div>
+
   placeholder placeholder placeholder
 
-</div><div>
 
-</div><div>
+
+
   
-</div><div>
+
   placeholder placeholder
 
-</div><div>
 
-</div><div>
+
+
   
-</div><div>
+
   placeholder
 
-</div><div>
 
-</div><div>
+
+
   placeholder
 
-</div><div>
+
   placeholder
 
-</div><div>
+
   
-</div><div>
+
   placeholder
 
-</div><div>
 
-</div><div>
+
+
   placeholder
 
-</div><div>
+
   placeholder
 
-</div><div>
+
   
-</div><div>
+
   Should error
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/if-tag/__snapshots__/if-tag.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/if-tag/__snapshots__/if-tag.expected/index.html
index dcae09d7..a6d81858 100644
--- a/packages/language-server/src/__tests__/fixtures/script/if-tag/__snapshots__/if-tag.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/if-tag/__snapshots__/if-tag.expected/index.html
@@ -1,53 +1,52 @@
-<div>
+
   Hi
-</div><div>
+
   Hi
-</div><div>
+
   Hi
-</div><div data-marko-node-id="5">
-  <div>
+<div data-marko-node-id="0">
+  
     Hello
-  </div>
+  
   World
-</div><div>
+</div>
   Hi
-</div><div>
+
   Goodbye
-</div><div>
+
+  
+
+  
+
   
-</div><div>
+
   
-</div><div>
+
   
-</div><div>
+
   
-</div><div>
+
   
-</div><div>
+
+  
+
   
-</div><div>
   
-</div><div>
   
-</div><div>
-  <div>
-  </div>
-  <div>
     
-  </div>
-  <div>
+  
+  
     
-  </div>
-</div><div>
+  
+
   Hi
-</div><div>
+
   Hi
-</div><div>
+
   Hi
-</div><div>
+
   Hi
-</div><div>
+
   Hi
-</div><div>
+
   Hi
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/prefer-local-identifier-tag-name/__snapshots__/prefer-local-identifier-tag-name.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/prefer-local-identifier-tag-name/__snapshots__/prefer-local-identifier-tag-name.expected/index.html
index 3c0e3fb6..3e1911be 100644
--- a/packages/language-server/src/__tests__/fixtures/script/prefer-local-identifier-tag-name/__snapshots__/prefer-local-identifier-tag-name.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/prefer-local-identifier-tag-name/__snapshots__/prefer-local-identifier-tag-name.expected/index.html
@@ -1,4 +1,4 @@
-<div data-marko-node-id="3">
+<div data-marko-node-id="TestTagA.marko#0"></div><div data-marko-node-id="TestTagB.marko#0"></div><div data-marko-node-id="0">
   
-  
-</div>
\ No newline at end of file
+  <div data-marko-node-id="TestTagA.marko#0"></div>
+</div><div data-marko-node-id="TestTagA.marko#0"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/recursive-define-tag/__snapshots__/recursive-define-tag.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/recursive-define-tag/__snapshots__/recursive-define-tag.expected/index.html
index 024dc4b2..06ef31bc 100644
--- a/packages/language-server/src/__tests__/fixtures/script/recursive-define-tag/__snapshots__/recursive-define-tag.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/recursive-define-tag/__snapshots__/recursive-define-tag.expected/index.html
@@ -1,10 +1,9 @@
 <div>
         
-  <div>
+  
     
     
-  </div>
-</div><div>
+  
+</div>
   
   
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/render-body-basic/__snapshots__/render-body-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/render-body-basic/__snapshots__/render-body-basic.expected/index.html
index 1db6f2e9..ecd622fb 100644
--- a/packages/language-server/src/__tests__/fixtures/script/render-body-basic/__snapshots__/render-body-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/render-body-basic/__snapshots__/render-body-basic.expected/index.html
@@ -1,4 +1,3 @@
-<div>
+
 
   Hi placeholder
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/return-tag-basic/__snapshots__/return-tag-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/return-tag-basic/__snapshots__/return-tag-basic.expected/index.html
index 94500271..04b617c5 100644
--- a/packages/language-server/src/__tests__/fixtures/script/return-tag-basic/__snapshots__/return-tag-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/return-tag-basic/__snapshots__/return-tag-basic.expected/index.html
@@ -1 +1 @@
-<button data-marko-node-id="1" onClick></button>
\ No newline at end of file
+<button data-marko-node-id="0" onClick></button>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/return-tag-nested/__snapshots__/return-tag-nested.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/return-tag-nested/__snapshots__/return-tag-nested.expected/index.html
index ab956d9a..7b5869b6 100644
--- a/packages/language-server/src/__tests__/fixtures/script/return-tag-nested/__snapshots__/return-tag-nested.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/return-tag-nested/__snapshots__/return-tag-nested.expected/index.html
@@ -1,13 +1,13 @@
-<div>
+
   placeholder
 
-</div><div>
+
   
-</div><div>
+
   
-</div><div>
+
   
-</div><div>
+
   
   
-</div>placeholder
\ No newline at end of file
+placeholder
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/simple-hoist/__snapshots__/simple-hoist.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/simple-hoist/__snapshots__/simple-hoist.expected/index.html
index 6386858d..a8ff6359 100644
--- a/packages/language-server/src/__tests__/fixtures/script/simple-hoist/__snapshots__/simple-hoist.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/simple-hoist/__snapshots__/simple-hoist.expected/index.html
@@ -1,7 +1,7 @@
 <div data-marko-node-id="0">
   
   placeholder
-  <button data-marko-node-id="2" onClick>
+  <button data-marko-node-id="1" onClick>
     
   </button>
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-param-mutation/__snapshots__/tag-param-mutation.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-param-mutation/__snapshots__/tag-param-mutation.expected/index.html
index 79fb6b87..df4df09d 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-param-mutation/__snapshots__/tag-param-mutation.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-param-mutation/__snapshots__/tag-param-mutation.expected/index.html
@@ -1,9 +1,9 @@
-<div>
-  <button data-marko-node-id="2" onClick>
+
+  <button data-marko-node-id="0" onClick>
                   
     placeholder
   </button>
-</div><div>
+
   
-  <input data-marko-node-id="5" id="dynamic">
-</div><button data-marko-node-id="6" onClick>Body to prevent a11y error</button>
\ No newline at end of file
+  <input data-marko-node-id="1" id="dynamic">
+<button data-marko-node-id="2" onClick>Body to prevent a11y error</button>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-var-hoisting-from-control-flow/__snapshots__/tag-var-hoisting-from-control-flow.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-var-hoisting-from-control-flow/__snapshots__/tag-var-hoisting-from-control-flow.expected/index.html
index d77dcb1c..0bda8f14 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-var-hoisting-from-control-flow/__snapshots__/tag-var-hoisting-from-control-flow.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-var-hoisting-from-control-flow/__snapshots__/tag-var-hoisting-from-control-flow.expected/index.html
@@ -1,15 +1,15 @@
-<div>
+
   
       
   
       
-  <div>
+  
     
     placeholder
 
-  </div>
-</div><div>
   
-</div><div>
+
+  
+
   
-</div>placeholder
\ No newline at end of file
+placeholder
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-patterns/__snapshots__/tag-var-mutation-patterns.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-patterns/__snapshots__/tag-var-mutation-patterns.expected/index.html
index ede28a2a..a51f747c 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-patterns/__snapshots__/tag-var-mutation-patterns.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-patterns/__snapshots__/tag-var-mutation-patterns.expected/index.html
@@ -1,4 +1,3 @@
-<button data-marko-node-id="2" onClick>patterns</button><div>
+<button data-marko-node-id="0" onClick>patterns</button>
   
-  <button data-marko-node-id="4" onClick>shadowed</button>
-</div>
\ No newline at end of file
+  <button data-marko-node-id="1" onClick>shadowed</button>
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-shadowing/__snapshots__/tag-var-mutation-shadowing.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-shadowing/__snapshots__/tag-var-mutation-shadowing.expected/index.html
index fb0a7db5..6f0c9f31 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-shadowing/__snapshots__/tag-var-mutation-shadowing.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutation-shadowing/__snapshots__/tag-var-mutation-shadowing.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="1" onClick></div>
\ No newline at end of file
+<div data-marko-node-id="0" onClick></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations-nested/__snapshots__/tag-var-mutations-nested.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations-nested/__snapshots__/tag-var-mutations-nested.expected/index.html
index 2df50131..f046ad6f 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations-nested/__snapshots__/tag-var-mutations-nested.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations-nested/__snapshots__/tag-var-mutations-nested.expected/index.html
@@ -1,4 +1,4 @@
-<button data-marko-node-id="1" onClick>Click me</button><div>
+<button data-marko-node-id="0" onClick>Click me</button><div>
   
-  <button data-marko-node-id="4" onClick>Click me</button>
+  <button data-marko-node-id="1" onClick>Click me</button>
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations/__snapshots__/tag-var-mutations.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations/__snapshots__/tag-var-mutations.expected/index.html
index 408f5eeb..2be7abbe 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations/__snapshots__/tag-var-mutations.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tag-var-mutations/__snapshots__/tag-var-mutations.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="1" data-function></div><div data-marko-node-id="2" data-function></div><div data-marko-node-id="3" data-function="dynamic"></div><div data-marko-node-id="4" data-function="dynamic"></div><div data-marko-node-id="5" data-function="dynamic"></div><div data-marko-node-id="6" data-function="dynamic"></div><div data-marko-node-id="7" data-function></div>
\ No newline at end of file
+<div data-marko-node-id="0" data-function></div><div data-marko-node-id="1" data-function></div><div data-marko-node-id="2" data-function="dynamic"></div><div data-marko-node-id="3" data-function="dynamic"></div><div data-marko-node-id="4" data-function="dynamic"></div><div data-marko-node-id="5" data-function="dynamic"></div><div data-marko-node-id="6" data-function></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
index 6b2284f8..512c3fde 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
@@ -1,22 +1,22 @@
-<div data-marko-node-id="1" class="mobiles__list">
-    <p data-marko-node-id="2" id="p">Year: placeholder</p>
+<div data-marko-node-id="0" class="mobiles__list">
+    <p data-marko-node-id="1" id="p">Year: placeholder</p>
 
-    <div>
-      <span data-marko-node-id="4" class="sub-note">isSmartPhone: placeholder</span>
-    </div>
+    
+      <span data-marko-node-id="2" class="sub-note">isSmartPhone: placeholder</span>
+    
 
-    <span data-marko-node-id="5" class="sub-note">phoneType: placeholder</span>
+    <span data-marko-node-id="3" class="sub-note">phoneType: placeholder</span>
 
-    <div>
+    
 
-      <span data-marko-node-id="7" id="dynamic">placeholder placeholder placeholder</span>
+      <span data-marko-node-id="4" id="dynamic">placeholder placeholder placeholder</span>
 
-    </div>
+    
 
-    <div data-marko-node-id="8">
+    <div data-marko-node-id="5">
         
     </div>
     <div>placeholder</div>
-    <div data-marko-node-id="11">Hello placeholder</div>
-    <div data-marko-node-id="12">Placeholder example: <code data-marko-node-id="13">${someValue}</code></div>
+    <div data-marko-node-id="6">Hello placeholder</div>
+    <div data-marko-node-id="7">Placeholder example: <code data-marko-node-id="8">${someValue}</code></div>
 </div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/while-tag/__snapshots__/while-tag.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/while-tag/__snapshots__/while-tag.expected/index.html
index 91d9e2a5..15c9fc06 100644
--- a/packages/language-server/src/__tests__/fixtures/script/while-tag/__snapshots__/while-tag.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/while-tag/__snapshots__/while-tag.expected/index.html
@@ -1,14 +1,13 @@
-<div>
+
 
   placeholder
 
-</div><div>
+
 
   placeholder
 
-  <div>
+  
     
-  </div>
-</div><div>
+  
+
   No Condition.
-</div>
\ No newline at end of file
diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index c1a5ae2a..6e372052 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -21,12 +21,35 @@ export interface Exceptions {
    * Exclude if the body content can't be determined
    */
   unknownBody?: boolean;
+  /**
+   * Exclude if the element is inside a control flow branch (`<if>`, `<for>`,
+   * ...). For rules that flag duplicated content across the document:
+   * branches are mutually exclusive at runtime, so apparent duplicates may
+   * never coexist in rendered output.
+   */
+  conditionalContent?: boolean;
+  /**
+   * Only report when the parent chain axe consults for the rule is fully
+   * known. This suppresses elements whose rendered parent comes from a usage
+   * site we can't see (top-level elements of a template) and elements under
+   * fabricated `<div>` placeholders. `"div-wrapped"` also requires a known
+   * grandparent when the direct parent is a presentational `<div>` (matching
+   * axe's `dlitem` semantics).
+   */
+  requiresKnownParent?: true | "div-wrapped";
 }
 
 type Blacklist =
   // Explicitly blacklisted for Marko Language Server
   | typeof r.structure.frameTested
-  // Requires a parent component to validate; we can potentially add support with child component analysis
+  // Requires context that may live in an *ancestor* template we can't see.
+  // `aria-required-parent` passes if any ancestor supplies the required role,
+  // so a component whose usage sites provide that ancestor would always be a
+  // false positive. Labels/names can be associated from the usage site (eg a
+  // wrapping `<label>` or cross-file id references). Page-level rules
+  // (landmarks, headings, region, bypass) only make sense for a full page.
+  // Unlike these, `listitem`/`dlitem` only consult the direct parent chain
+  // and are enabled with the `requiresKnownParent` exception.
   | typeof r.aria.ariaRequiredParent
   | typeof r.forms.label
   | typeof r.forms.labelTitleOnly
@@ -41,8 +64,6 @@ type Blacklist =
   | typeof r.semantics.landmarkMainIsTopLevel
   | typeof r.semantics.landmarkOneMain
   | typeof r.semantics.pageHasHeadingOne
-  | typeof r.structure.dlitem
-  | typeof r.structure.listitem
   | typeof r.tables.tdHeadersAttr
   // Seemingly broken in axe-core or JSDom
   | typeof r.aria.ariaRoledescription
@@ -73,6 +94,7 @@ type Whitelist = Exclude<RuleId, Blacklist>;
 // utility variables so the objects don't all need `: true` everywhere
 const unknownBody = true;
 const attrSpread = true;
+const conditionalContent = true;
 
 export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.ariaAllowedRole]: { dynamicAttrs: ["role"] },
@@ -96,7 +118,7 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.presentationRoleConflict]: {},
   [r.forms.autocompleteValid]: {},
   [r.forms.formFieldMultipleLabels]: {},
-  [r.keyboard.accesskeys]: {},
+  [r.keyboard.accesskeys]: { conditionalContent },
   [r.keyboard.frameFocusableContent]: { unknownBody },
   [r.keyboard.skipLink]: { unknownBody },
   [r.keyboard.tabindex]: {},
@@ -115,22 +137,32 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.nameRoleValue.linkName]: { unknownBody, attrSpread },
   [r.nameRoleValue.summaryName]: { unknownBody, attrSpread },
   [r.parsing.marquee]: {},
-  [r.semantics.identicalLinksSamePurpose]: {},
-  [r.semantics.landmarkNoDuplicateBanner]: {},
-  [r.semantics.landmarkNoDuplicateContentinfo]: {},
-  [r.semantics.landmarkNoDuplicateMain]: {},
-  [r.semantics.landmarkUnique]: {},
+  [r.semantics.identicalLinksSamePurpose]: { conditionalContent },
+  [r.semantics.landmarkNoDuplicateBanner]: { conditionalContent },
+  [r.semantics.landmarkNoDuplicateContentinfo]: { conditionalContent },
+  [r.semantics.landmarkNoDuplicateMain]: { conditionalContent },
+  [r.semantics.landmarkUnique]: { conditionalContent },
   [r.sensoryAndVisualCues.metaViewport]: {},
   [r.sensoryAndVisualCues.metaViewportLarge]: {},
   [r.structure.definitionList]: { unknownBody },
+  [r.structure.dlitem]: {
+    requiresKnownParent: "div-wrapped",
+    dynamicAttrs: ["role"],
+    attrSpread,
+  },
   [r.structure.list]: { unknownBody },
+  [r.structure.listitem]: {
+    requiresKnownParent: true,
+    dynamicAttrs: ["role"],
+    attrSpread,
+  },
   [r.tables.scopeAttrValid]: {},
   [r.tables.tableDuplicateName]: { unknownBody },
   [r.tables.thHasDataCells]: { unknownBody },
   [r.textAlternatives.areaAlt]: { attrSpread },
   [r.textAlternatives.documentTitle]: { unknownBody },
   [r.textAlternatives.frameTitle]: { unknownBody },
-  [r.textAlternatives.frameTitleUnique]: { unknownBody },
+  [r.textAlternatives.frameTitleUnique]: { unknownBody, conditionalContent },
   [r.textAlternatives.imageAlt]: { attrSpread },
   [r.textAlternatives.imageRedundantAlt]: { attrSpread },
   [r.textAlternatives.inputImageAlt]: { attrSpread },
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 908210a4..0c11314b 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -1,14 +1,56 @@
-import { extractHTML, type Parsed } from "@marko/language-tools";
+import {
+  extractHTML,
+  type InlineChildTemplate,
+  type InlineRegion,
+  type Parsed,
+} from "@marko/language-tools";
 import axe from "axe-core";
 import { JSDOM } from "jsdom";
+import path from "path";
 import type { TextDocument } from "vscode-languageserver-textdocument";
+import { URI } from "vscode-uri";
 
-import { getMarkoFile } from "../../utils/file";
-import { get } from "../../utils/text-documents";
+import { getMarkoFile, type MarkoFile } from "../../utils/file";
+import { get, projectVersion } from "../../utils/text-documents";
 import type { Plugin } from "../types";
-import { ruleExceptions } from "./axe-rules/rule-exceptions";
+import { type Exceptions, ruleExceptions } from "./axe-rules/rule-exceptions";
 
-const extractCache = new WeakMap<Parsed, ReturnType<typeof extractHTML>>();
+/** Limits for inlining child templates into the extracted HTML. */
+const MAX_INLINE_DEPTH = 3;
+const MAX_INLINE_BYTES = 100_000;
+
+type Extraction = ReturnType<typeof extractHTML>;
+type NodeDetails = Extraction["nodeDetails"];
+
+// Extractions splice in cached child template skeletons, so they must be
+// invalidated when *any* file changes (a child template may have changed even
+// though this document's parse is unchanged). `projectVersion` bumps on every
+// document/watched-file change; extraction itself is cheap relative to the
+// jsdom + axe run below, so recomputing per version is fine.
+const extractCache = new WeakMap<
+  Parsed,
+  { version: number; result: Extraction }
+>();
+let skeletonCacheVersion = -1;
+let skeletonCache = new Map<Parsed, InlineChildTemplate | undefined>();
+
+// Node ids of inlined skeletons are namespaced per template file so details
+// from multiple templates can be merged without collisions. The prefix is
+// path-independent (template basename + a dedup counter) so it stays stable
+// across machines.
+const templatePrefixes = new Map<string, string>();
+const basenameCounts = new Map<string, number>();
+function getNodeIdPrefix(template: string) {
+  let prefix = templatePrefixes.get(template);
+  if (prefix === undefined) {
+    const base = path.basename(template);
+    const count = basenameCounts.get(base) ?? 0;
+    basenameCounts.set(base, count + 1);
+    prefix = `${count === 0 ? base : `${base}~${count}`}#`;
+    templatePrefixes.set(template, prefix);
+  }
+  return prefix;
+}
 
 // const axeViolationImpact: {
 //   [impact in NonNullable<axe.ImpactValue>]: DiagnosticSeverity;
@@ -34,7 +76,7 @@ const HTMLService: Partial<Plugin> = {
     },
   },
   async doValidate(doc) {
-    const { extracted, nodeDetails } = extract(doc);
+    const { extracted, nodeDetails, inlineRegions } = extract(doc);
 
     const jsdom = new JSDOM(extracted.toString(), {
       includeNodeLocations: true,
@@ -63,28 +105,57 @@ const HTMLService: Partial<Plugin> = {
       const { element } = result;
       if (!element) return [];
       const ruleId = result.ruleId as keyof typeof ruleExceptions;
+      const exceptions = ruleExceptions[ruleId];
+      const nodeId = element.dataset.markoNodeId;
+      const details = nodeId ? nodeDetails[nodeId] : undefined;
 
-      if (element.dataset.markoNodeId) {
-        const details = nodeDetails[element.dataset.markoNodeId];
-        if (
-          (ruleExceptions[ruleId].attrSpread && details.hasDynamicAttrs) ||
-          (ruleExceptions[ruleId].unknownBody && details.hasDynamicBody) ||
-          ruleExceptions[ruleId].dynamicAttrs?.some(
+      if (
+        details &&
+        ((exceptions.attrSpread && details.hasDynamicAttrs) ||
+          (exceptions.unknownBody && details.hasDynamicBody) ||
+          (exceptions.conditionalContent && details.inConditional) ||
+          exceptions.dynamicAttrs?.some(
             (attr) => element.getAttribute(attr) === "dynamic",
-          )
-        ) {
-          return [];
-        }
+          ))
+      ) {
+        return [];
+      }
+
+      if (
+        exceptions.requiresKnownParent &&
+        !hasKnownParent(element, exceptions.requiresKnownParent, nodeDetails)
+      ) {
+        return [];
       }
 
       const generatedLoc = jsdom.nodeLocation(element);
       if (!generatedLoc) return [];
 
-      const sourceRange = extracted.sourceLocationAt(
+      let sourceRange = extracted.sourceLocationAt(
         generatedLoc.startOffset + 1,
         generatedLoc.startOffset + 1 + element.tagName.length,
       );
-      if (!sourceRange) return [];
+
+      if (!sourceRange) {
+        // The element came from an inlined child template and has no mapping
+        // into this document. Diagnostics on the *top-level* elements of the
+        // inlined skeleton describe the tag's rendered output as used here,
+        // so they are re-anchored to the tag name at the usage site. Anything
+        // nested deeper is the child template's own concern and is reported
+        // when the child template itself is validated.
+        const region = regionAt(inlineRegions, generatedLoc.startOffset);
+        if (
+          !region ||
+          !nodeId ||
+          !region.rootIds.includes(nodeId) ||
+          (exceptions.unknownBody && region.bodyUncertain) ||
+          (exceptions.conditionalContent && region.inConditional)
+        ) {
+          return [];
+        }
+
+        sourceRange = extracted.parsed.locationAt(region.tagName);
+      }
 
       return [
         {
@@ -99,15 +170,159 @@ const HTMLService: Partial<Plugin> = {
 };
 
 function extract(doc: TextDocument) {
-  const { parsed } = getMarkoFile(doc);
-  let cached = extractCache.get(parsed);
+  const file = getMarkoFile(doc);
+  const cached = extractCache.get(file.parsed);
+  if (cached && cached.version === projectVersion) return cached.result;
+
+  const result = extractHTML(file.parsed, {
+    resolveChild: createChildResolver(
+      file,
+      new Set(file.filename ? [file.filename] : []),
+      { remaining: MAX_INLINE_BYTES },
+    ),
+  });
+  extractCache.set(file.parsed, { version: projectVersion, result });
+  return result;
+}
+
+/**
+ * Resolves a custom tag to the extracted skeleton of its template so it can
+ * be inlined at the usage site. Returns undefined (falling back to the
+ * previous `<div>` placeholder behavior) for anything that can't be resolved
+ * confidently: non-template tags, cycles, or when the depth/size limits are
+ * reached.
+ */
+function createChildResolver(
+  file: MarkoFile,
+  stack: Set<string>,
+  budget: { remaining: number },
+) {
+  return (tagName: string): InlineChildTemplate | undefined => {
+    if (stack.size > MAX_INLINE_DEPTH) return;
+
+    let template: string | undefined;
+    try {
+      template = file.lookup.getTag(tagName)?.template;
+    } catch {
+      return;
+    }
 
-  if (!cached) {
-    cached = extractHTML(parsed);
-    extractCache.set(parsed, cached);
+    if (!template || !template.endsWith(".marko") || stack.has(template)) {
+      return;
+    }
+
+    const skeleton = getSkeleton(template, stack);
+    if (!skeleton) return;
+
+    const size =
+      skeleton.segments[0].length + (skeleton.segments[1]?.length ?? 0);
+    if (size > budget.remaining) return;
+    budget.remaining -= size;
+
+    return skeleton;
+  };
+}
+
+function getSkeleton(
+  template: string,
+  stack: Set<string>,
+): InlineChildTemplate | undefined {
+  const doc = get(URI.file(template).toString());
+  if (!doc) return;
+  const file = getMarkoFile(doc);
+
+  if (skeletonCacheVersion !== projectVersion) {
+    skeletonCacheVersion = projectVersion;
+    skeletonCache = new Map();
   }
+  if (skeletonCache.has(file.parsed)) return skeletonCache.get(file.parsed);
+  // Guard against re-entering while this skeleton is being built.
+  skeletonCache.set(file.parsed, undefined);
+
+  const { extracted, nodeDetails, uncertain, bodySlots, rootIds } = extractHTML(
+    file.parsed,
+    {
+      nodeIdPrefix: getNodeIdPrefix(template),
+      trackBodySlot: true,
+      resolveChild: createChildResolver(file, new Set(stack).add(template), {
+        remaining: MAX_INLINE_BYTES,
+      }),
+    },
+  );
+
+  const html = extracted.toString();
+  let skeleton: InlineChildTemplate | undefined;
+  if (html.length <= MAX_INLINE_BYTES) {
+    const slot = bodySlots.length === 1 ? bodySlots[0] : undefined;
+    skeleton = {
+      segments: slot
+        ? [html.slice(0, slot.offset), html.slice(slot.offset)]
+        : [html],
+      bodySlotDepth: slot?.depth ?? 0,
+      bodySlotConditional: slot?.inConditional ?? false,
+      uncertain,
+      nodeDetails,
+      rootIds,
+    };
+  }
+
+  skeletonCache.set(file.parsed, skeleton);
+  return skeleton;
+}
+
+/** The innermost inlined region containing a generated offset, if any. */
+function regionAt(regions: InlineRegion[], offset: number) {
+  let match: InlineRegion | undefined;
+  for (const region of regions) {
+    if (
+      region.start <= offset &&
+      offset < region.end &&
+      (!match || region.start >= match.start)
+    ) {
+      match = region;
+    }
+  }
+  return match;
+}
+
+/**
+ * True when the parent chain axe consults for a parent-context rule is fully
+ * known — every consulted ancestor is a real extracted element (not the
+ * document body, and not a fabricated placeholder) with static semantics.
+ */
+function hasKnownParent(
+  element: HTMLElement,
+  mode: NonNullable<Exceptions["requiresKnownParent"]>,
+  nodeDetails: NodeDetails,
+) {
+  // An element with an id could be re-parented in the accessibility tree via
+  // `aria-owns` from a template we can't see; don't judge it by DOM position.
+  if (element.hasAttribute("id")) return false;
+
+  const parent = element.parentElement;
+  if (!isKnownElement(parent, nodeDetails)) return false;
+
+  if (mode === "div-wrapped" && parent!.tagName === "DIV") {
+    const role = parent!.getAttribute("role");
+    if (!role || role === "presentation" || role === "none") {
+      // axe looks through presentational div wrappers to the grandparent.
+      return isKnownElement(parent!.parentElement, nodeDetails);
+    }
+  }
+
+  return true;
+}
 
-  return cached;
+function isKnownElement(element: HTMLElement | null, nodeDetails: NodeDetails) {
+  if (!element) return false;
+  const nodeId = element.dataset.markoNodeId;
+  if (!nodeId) return false;
+  const details = nodeDetails[nodeId];
+  return (
+    !!details &&
+    !details.hasDynamicAttrs &&
+    element.getAttribute("role") !== "dynamic"
+  );
 }
 
 let lock: Promise<void> | undefined;
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index 3896b3ac..2383bee4 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -1,4 +1,10 @@
-import { type Node, NodeType, type Parsed, type Range } from "../../parser";
+import {
+  isControlFlowTag,
+  type Node,
+  NodeType,
+  type Parsed,
+  type Range,
+} from "../../parser";
 import { Extractor } from "../../util/extractor";
 import {
   AttributeValueType,
@@ -6,31 +12,131 @@ import {
   isHTMLTag,
 } from "./keywords";
 
-export function extractHTML(parsed: Parsed) {
-  return new HTMLExtractor(parsed).end();
+export interface HTMLNodeDetails {
+  hasDynamicAttrs: boolean;
+  hasDynamicBody: boolean;
+  /**
+   * True when the element is inside a control flow branch (`<if>`, `<for>`,
+   * ...) and so may render zero or multiple times.
+   */
+  inConditional: boolean;
+}
+
+export interface HTMLBodySlot {
+  /** Offset in the generated HTML where default body content is rendered. */
+  offset: number;
+  /** Number of elements the slot is nested under within the template. */
+  depth: number;
+  /** True when the slot itself is inside a control flow branch. */
+  inConditional: boolean;
+}
+
+/**
+ * A pre-extracted child template that can be inlined where a custom tag is
+ * used, so rules can evaluate the tag's rendered output in context.
+ */
+export interface InlineChildTemplate {
+  /**
+   * The generated HTML skeleton, split at the default body slot when the
+   * template renders its default body content in exactly one known location.
+   */
+  segments: [string] | [string, string];
+  /** Element depth of the body slot (only when `segments.length === 2`). */
+  bodySlotDepth: number;
+  /** True when the body slot is inside a control flow branch. */
+  bodySlotConditional: boolean;
+  /**
+   * True when any part of the skeleton may not match the rendered output
+   * (dynamic content, unresolved tags, ...). Propagated to ancestors of the
+   * usage site so `unknownBody` rule exceptions still apply.
+   */
+  uncertain: boolean;
+  /** Details for elements of the skeleton, keyed by (prefixed) node id. */
+  nodeDetails: Record<string, HTMLNodeDetails>;
+  /** Node ids of the top-level elements of the skeleton. */
+  rootIds: string[];
+}
+
+/** A generated range produced by inlining a child template. */
+export interface InlineRegion {
+  start: number;
+  end: number;
+  /** Source range of the custom tag name, used to re-anchor diagnostics. */
+  tagName: Range;
+  /** True when body content spliced into this instance is dynamic. */
+  bodyUncertain: boolean;
+  /** True when the usage site is inside a control flow branch. */
+  inConditional: boolean;
+  /** Top-level element node ids of the inlined skeleton. */
+  rootIds: string[];
+}
+
+export interface ExtractHTMLOptions {
+  /**
+   * Prefix applied to generated node ids; must be unique per template file so
+   * details of inlined templates can be merged without collisions.
+   */
+  nodeIdPrefix?: string;
+  /**
+   * When true, a bodyless `<${input.renderBody}/>` (or `input.content`) tag
+   * is reported as a body slot instead of being treated as unknown dynamic
+   * content. Only enable when extracting a template for inlining, where the
+   * usage site determines what renders at the slot.
+   */
+  trackBodySlot?: boolean;
+  /** Resolve a custom tag to a child template skeleton to inline. */
+  resolveChild?(tagName: string): InlineChildTemplate | undefined;
+}
+
+const bodySlotReg = /^\$\{\s*input\.(?:renderBody|content)\s*\}$/;
+
+export function extractHTML(parsed: Parsed, options: ExtractHTMLOptions = {}) {
+  return new HTMLExtractor(parsed, options).end();
 }
 
 class HTMLExtractor {
   #extractor: Extractor;
   #read: Parsed["read"];
-  #nodeDetails: {
-    [id: string]: { hasDynamicAttrs: boolean; hasDynamicBody: boolean };
-  };
+  #options: ExtractHTMLOptions;
+  #nodeDetails: Record<string, HTMLNodeDetails>;
   #nodeIdCounter: number;
+  #domDepth: number;
+  #conditionalDepth: number;
+  #uncertain: boolean;
+  #rootIds: string[];
+  #bodySlots: HTMLBodySlot[];
+  #inlineRegions: InlineRegion[];
 
-  constructor(parsed: Parsed) {
+  constructor(parsed: Parsed, options: ExtractHTMLOptions) {
     this.#extractor = new Extractor(parsed);
     this.#read = parsed.read.bind(parsed);
+    this.#options = options;
     this.#nodeDetails = {};
     this.#nodeIdCounter = 0;
-    parsed.program.body.forEach((node) => this.#visitNode(node));
+    this.#domDepth = 0;
+    this.#conditionalDepth = 0;
+    this.#uncertain = false;
+    this.#rootIds = [];
+    this.#bodySlots = [];
+    this.#inlineRegions = [];
+    parsed.program.body.forEach((node) => {
+      if (this.#visitNode(node)) this.#uncertain = true;
+    });
   }
 
   end() {
-    return { extracted: this.#extractor.end(), nodeDetails: this.#nodeDetails };
+    return {
+      extracted: this.#extractor.end(),
+      nodeDetails: this.#nodeDetails,
+      /** True when any content may not match rendered output. */
+      uncertain: this.#uncertain,
+      bodySlots: this.#bodySlots,
+      inlineRegions: this.#inlineRegions,
+      rootIds: this.#rootIds,
+    };
   }
 
-  #visitNode(node: Node.ChildNode) {
+  #visitNode(node: Node.ChildNode): boolean {
     let hasDynamicBody = false,
       hasDynamicAttrs = false,
       isDynamic = false;
@@ -44,12 +150,35 @@ class HTMLExtractor {
         if (node.nameText === "script" || node.nameText === "style") {
           break;
         }
-        const nodeId = `${this.#nodeIdCounter++}`;
-        ({ isDynamic, hasDynamicAttrs, hasDynamicBody } = this.#writeTag(
+
+        if (isControlFlowTag(node)) {
+          // Control flow renders no element of its own; emit the body
+          // directly (rather than a fabricated `<div>`) so structural rules
+          // see the true parent/child relationships. The content is still
+          // dynamic: it may render zero or multiple times.
+          this.#conditionalDepth++;
+          node.body?.forEach((child) => this.#visitNode(child));
+          this.#conditionalDepth--;
+          isDynamic = true;
+          break;
+        }
+
+        if (!node.nameText || !isHTMLTag(node.nameText)) {
+          isDynamic = this.#writeDynamicTag(node);
+          break;
+        }
+
+        const nodeId = `${this.#options.nodeIdPrefix ?? ""}${this
+          .#nodeIdCounter++}`;
+        ({ hasDynamicAttrs, hasDynamicBody } = this.#writeHTMLTag(
           node,
           nodeId,
         ));
-        this.#nodeDetails[nodeId] = { hasDynamicAttrs, hasDynamicBody };
+        this.#nodeDetails[nodeId] = {
+          hasDynamicAttrs,
+          hasDynamicBody,
+          inConditional: this.#conditionalDepth > 0,
+        };
         break;
       }
       case NodeType.Text:
@@ -68,21 +197,94 @@ class HTMLExtractor {
     return isDynamic || hasDynamicBody;
   }
 
-  #writeTag(node: Node.Tag, id: string) {
-    const isDynamic = !node.nameText || !isHTMLTag(node.nameText);
-    let hasDynamicAttrs = false,
-      hasDynamicBody = false;
-    if (isDynamic) {
-      this.#writeCustomTag(node);
-    } else {
-      ({ hasDynamicAttrs, hasDynamicBody } = this.#writeHTMLTag(node, id));
+  /** Handles tags that are not plain HTML elements (custom/dynamic tags). */
+  #writeDynamicTag(node: Node.Tag): boolean {
+    // `<${input.renderBody}/>` — where a template renders its default body.
+    if (
+      !node.nameText &&
+      !node.body &&
+      bodySlotReg.test(this.#read(node.name))
+    ) {
+      if (this.#options.trackBodySlot) {
+        this.#bodySlots.push({
+          offset: this.#extractor.length,
+          depth: this.#domDepth,
+          inConditional: this.#conditionalDepth > 0,
+        });
+        // The usage site determines what renders here; certainty is decided
+        // when (and if) content is spliced in.
+        return false;
+      }
+
+      // Standalone validation of a template: the body is unknown content.
+      return true;
+    }
+
+    const child =
+      node.nameText && this.#options.resolveChild
+        ? this.#options.resolveChild(node.nameText)
+        : undefined;
+
+    if (
+      child &&
+      // Named content (`<@foo>`) can't be placed within the child skeleton.
+      !node.hasAttrTags &&
+      // A body needs a known slot to splice into; otherwise fall through so
+      // the body content is still emitted (and validated) below.
+      (!node.body || child.segments.length === 2)
+    ) {
+      return this.#inlineChild(node, child);
+    }
+
+    // Fallback: replace unknown and unresolvable tags with a `div` wrapping
+    // their body.
+    if (node.body) {
+      this.#extractor.write("<div>");
+      this.#domDepth++;
+      node.body.forEach((child) => this.#visitNode(child));
+      this.#domDepth--;
+      this.#extractor.write("</div>");
+    }
+
+    return true;
+  }
+
+  #inlineChild(node: Node.Tag, child: InlineChildTemplate): boolean {
+    const start = this.#extractor.length;
+    if (this.#domDepth === 0) this.#rootIds.push(...child.rootIds);
+    Object.assign(this.#nodeDetails, child.nodeDetails);
+
+    this.#extractor.write(child.segments[0]);
+
+    let bodyUncertain = false;
+    if (node.body && child.segments.length === 2) {
+      this.#domDepth += child.bodySlotDepth;
+      if (child.bodySlotConditional) this.#conditionalDepth++;
+      node.body.forEach((c) => {
+        if (this.#visitNode(c)) bodyUncertain = true;
+      });
+      if (child.bodySlotConditional) this.#conditionalDepth--;
+      this.#domDepth -= child.bodySlotDepth;
     }
-    return { isDynamic, hasDynamicAttrs, hasDynamicBody };
+
+    if (child.segments.length === 2) this.#extractor.write(child.segments[1]);
+
+    this.#inlineRegions.push({
+      start,
+      end: this.#extractor.length,
+      tagName: node.name,
+      bodyUncertain,
+      inConditional: this.#conditionalDepth > 0,
+      rootIds: child.rootIds,
+    });
+
+    return child.uncertain || bodyUncertain;
   }
 
   #writeHTMLTag(node: Node.Tag, id: string) {
     let hasDynamicAttrs = false,
       hasDynamicBody = false;
+    if (this.#domDepth === 0) this.#rootIds.push(id);
     // <[node name]
     this.#extractor.write("<");
     this.#extractor.copy(isEmptyRange(node.name) ? node.nameText : node.name);
@@ -97,24 +299,17 @@ class HTMLExtractor {
     this.#extractor.write(">");
 
     if (!isVoidTag(node.nameText)) {
+      this.#domDepth++;
       node.body?.forEach((child) => {
         if (this.#visitNode(child)) hasDynamicBody = true;
       });
+      this.#domDepth--;
       this.#extractor.write(`</${node.nameText}>`);
     }
 
     return { hasDynamicAttrs, hasDynamicBody };
   }
 
-  #writeCustomTag(node: Node.Tag) {
-    if (node.body) {
-      // Replace all unknown and undefined tag names with `div`s
-      this.#extractor.write("<div>");
-      node.body.forEach((node) => this.#visitNode(node));
-      this.#extractor.write("</div>");
-    }
-  }
-
   #writeAttrNamed(attr: Node.AttrNamed) {
     this.#extractor.write(" ");
     const nameString = this.#read(attr.name);
diff --git a/packages/language-tools/src/util/extractor.ts b/packages/language-tools/src/util/extractor.ts
index 41abb916..575893ea 100644
--- a/packages/language-tools/src/util/extractor.ts
+++ b/packages/language-tools/src/util/extractor.ts
@@ -65,6 +65,11 @@ export class Extractor {
     return this;
   }
 
+  /** Current length of the generated output. */
+  get length() {
+    return this.#generated.length;
+  }
+
   copy(range: Range | Range[] | string | false | void | undefined | null) {
     if (range) {
       if (typeof range === "string") {

From 237c81a85bac3d60ca4212904ca33c61caf6d971 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 14:48:52 +0000
Subject: [PATCH 02/19] Make the uncertain-child fixture actually exercise a11y
 suppression

The child-template-uncertain fixture's only diagnostic was an
accidental TypeScript error (raw-html required an input the fixture
never passed), so nothing in its snapshots demonstrated accessibility
behavior. The input is now optional, and the fixture gained a
contrasting certain child (plain-box rendering a <div>) so the
snapshot shows the `list` rule firing for the known child while the
uncertain child stays suppressed.
---
 .../components/plain-box.html                 |  1 +
 .../components/plain-box.md                   |  0
 .../components/plain-box.ts                   | 61 +++++++++++++++++++
 .../components/raw-html.ts                    |  2 +-
 .../index.html                                |  2 +
 .../index.md                                  | 12 ++--
 .../index.ts                                  | 11 ++++
 .../components/plain-box.marko                |  1 +
 .../components/raw-html.marko                 |  2 +-
 .../html/child-template-uncertain/index.marko |  4 ++
 10 files changed, 89 insertions(+), 7 deletions(-)
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/plain-box.marko

diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.html b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.html
new file mode 100644
index 00000000..8c3a4459
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.html
@@ -0,0 +1 @@
+<div data-marko-node-id="0">box</div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.md b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.ts
new file mode 100644
index 00000000..e0338f13
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/plain-box.ts
@@ -0,0 +1,61 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("div")()()({
+    [Marko._.content]: (() => {
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+const PlainBox = new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
+export default PlainBox;
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
index 38e4ab85..448b9f43 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/components/raw-html.ts
@@ -1,5 +1,5 @@
 export interface Input {
-  html: string;
+  html?: string;
 }
 abstract class Component extends Marko.Component<Input> {}
 export { type Component };
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
index 795efae6..48b4bdfb 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.html
@@ -1,3 +1,5 @@
 <ul data-marko-node-id="0">
   <div data-marko-node-id="raw-html.marko#0">placeholder</div>
+</ul><ul data-marko-node-id="1">
+  <div data-marko-node-id="plain-box.marko#0">box</div>
 </ul>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
index fbf9b645..138646c1 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.md
@@ -1,11 +1,13 @@
 ## Diagnostics
-### Ln 2, Col 4
+### Ln 5, Col 2
 ```marko
-  1 | <ul>
-> 2 |   <raw-html/>
-    |    ^^^^^^^^ Argument of type '{}' is not assignable to parameter of type 'Directives & Input'.
-  Property 'html' is missing in type '{}' but required in type 'Input'.
   3 | </ul>
   4 |
+> 5 | <ul>
+    |  ^^ Fix all of the following:
+  List element has direct children that are not allowed: div
+  6 |   <plain-box/>
+  7 | </ul>
+  8 |
 ```
 
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
index 200b00a2..81da6786 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/__snapshots__/child-template-uncertain.expected/index.ts
@@ -22,6 +22,17 @@ export { type Component };
       };
     })(),
   });
+  Marko._.renderNativeTag("ul")()()({
+    [Marko._.content]: (() => {
+      const __marko_internal_tag_2 = Marko._.resolveTemplate(
+        import("./components/plain-box.marko"),
+      );
+      Marko._.renderTemplate(__marko_internal_tag_2)()()({});
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
   Marko._.noop({ component, state, out, input, $global, $signal });
   return;
 })();
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/plain-box.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/plain-box.marko
new file mode 100644
index 00000000..b97ad6f0
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/plain-box.marko
@@ -0,0 +1 @@
+<div>box</div>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
index 9e7514cd..b594f7e3 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/components/raw-html.marko
@@ -1,5 +1,5 @@
 export interface Input {
-  html: string;
+  html?: string;
 }
 
 <div>$!{input.html}</div>
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
index e9ff1f2a..7334501b 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-uncertain/index.marko
@@ -1,3 +1,7 @@
 <ul>
   <raw-html/>
 </ul>
+
+<ul>
+  <plain-box/>
+</ul>

From 15787cb4ee94d7d79052dc947e425099b3e19496 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 14:56:57 +0000
Subject: [PATCH 03/19] Clarify re-anchored diagnostics with the rendered
 element

A diagnostic re-anchored from an inlined child template's root element
to the usage site read as if it were about the tag itself (eg "List
item does not have a <ul>, <ol> parent element" pointing at
<fancy-item/>). The message now leads with which element the tag
renders, found during a self-audit of the child template inlining
work.
---
 .../__snapshots__/child-template-context.expected/index.md  | 2 +-
 packages/language-server/src/service/html/index.ts          | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
index 6f4f11eb..0fbb5f43 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.md
@@ -4,7 +4,7 @@
   4 |
   5 | <div>
 > 6 |   <fancy-item/>
-    |    ^^^^^^^^^^ Fix any of the following:
+    |    ^^^^^^^^^^ This tag renders a `<li>` element here — Fix any of the following:
   List item does not have a <ul>, <ol> parent element
   7 | </div>
   8 |
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 0c11314b..6f0edcfc 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -131,6 +131,7 @@ const HTMLService: Partial<Plugin> = {
       const generatedLoc = jsdom.nodeLocation(element);
       if (!generatedLoc) return [];
 
+      let messagePrefix = "";
       let sourceRange = extracted.sourceLocationAt(
         generatedLoc.startOffset + 1,
         generatedLoc.startOffset + 1 + element.tagName.length,
@@ -155,6 +156,7 @@ const HTMLService: Partial<Plugin> = {
         }
 
         sourceRange = extracted.parsed.locationAt(region.tagName);
+        messagePrefix = `This tag renders a \`<${element.tagName.toLowerCase()}>\` element here — `;
       }
 
       return [
@@ -162,7 +164,9 @@ const HTMLService: Partial<Plugin> = {
           range: sourceRange,
           severity: 3,
           source: `axe-core(${ruleId})`,
-          message: result.failureSummary ?? "unknown accessibility issue",
+          message:
+            messagePrefix +
+            (result.failureSummary ?? "unknown accessibility issue"),
         },
       ];
     });

From 3a9ad447bcadf6969d96220558cde60d238ead17 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 15:09:47 +0000
Subject: [PATCH 04/19] Trim comments to at most two lines

Condense the JSDoc and inline commentary added with child template
inlining, and drop the long-dead commented-out severity mapping.
---
 .../service/html/axe-rules/rule-exceptions.ts | 24 +++------
 .../language-server/src/service/html/index.ts | 49 ++++-------------
 .../src/extractors/html/index.ts              | 52 +++++--------------
 3 files changed, 30 insertions(+), 95 deletions(-)

diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index 6e372052..c2a6592f 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -22,19 +22,13 @@ export interface Exceptions {
    */
   unknownBody?: boolean;
   /**
-   * Exclude if the element is inside a control flow branch (`<if>`, `<for>`,
-   * ...). For rules that flag duplicated content across the document:
-   * branches are mutually exclusive at runtime, so apparent duplicates may
-   * never coexist in rendered output.
+   * Exclude duplicate-content rules inside control flow branches, which are
+   * mutually exclusive at runtime
    */
   conditionalContent?: boolean;
   /**
-   * Only report when the parent chain axe consults for the rule is fully
-   * known. This suppresses elements whose rendered parent comes from a usage
-   * site we can't see (top-level elements of a template) and elements under
-   * fabricated `<div>` placeholders. `"div-wrapped"` also requires a known
-   * grandparent when the direct parent is a presentational `<div>` (matching
-   * axe's `dlitem` semantics).
+   * Only report when the parent chain axe consults is fully known;
+   * "div-wrapped" also checks the grandparent through presentational `<div>`s
    */
   requiresKnownParent?: true | "div-wrapped";
 }
@@ -42,14 +36,8 @@ export interface Exceptions {
 type Blacklist =
   // Explicitly blacklisted for Marko Language Server
   | typeof r.structure.frameTested
-  // Requires context that may live in an *ancestor* template we can't see.
-  // `aria-required-parent` passes if any ancestor supplies the required role,
-  // so a component whose usage sites provide that ancestor would always be a
-  // false positive. Labels/names can be associated from the usage site (eg a
-  // wrapping `<label>` or cross-file id references). Page-level rules
-  // (landmarks, headings, region, bypass) only make sense for a full page.
-  // Unlike these, `listitem`/`dlitem` only consult the direct parent chain
-  // and are enabled with the `requiresKnownParent` exception.
+  // Requires context that may live in an *ancestor* template we can't see
+  // (unlike listitem/dlitem, which only consult the known direct parent chain)
   | typeof r.aria.ariaRequiredParent
   | typeof r.forms.label
   | typeof r.forms.labelTitleOnly
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 6f0edcfc..cfaf36ab 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -22,11 +22,8 @@ const MAX_INLINE_BYTES = 100_000;
 type Extraction = ReturnType<typeof extractHTML>;
 type NodeDetails = Extraction["nodeDetails"];
 
-// Extractions splice in cached child template skeletons, so they must be
-// invalidated when *any* file changes (a child template may have changed even
-// though this document's parse is unchanged). `projectVersion` bumps on every
-// document/watched-file change; extraction itself is cheap relative to the
-// jsdom + axe run below, so recomputing per version is fine.
+// Keyed on projectVersion (not just the parse): an inlined child template may
+// change without this document re-parsing. Extraction is cheap next to axe.
 const extractCache = new WeakMap<
   Parsed,
   { version: number; result: Extraction }
@@ -34,10 +31,8 @@ const extractCache = new WeakMap<
 let skeletonCacheVersion = -1;
 let skeletonCache = new Map<Parsed, InlineChildTemplate | undefined>();
 
-// Node ids of inlined skeletons are namespaced per template file so details
-// from multiple templates can be merged without collisions. The prefix is
-// path-independent (template basename + a dedup counter) so it stays stable
-// across machines.
+// Per-template node id namespaces, path-independent (basename + dedup
+// counter) so extracted output stays stable across machines.
 const templatePrefixes = new Map<string, string>();
 const basenameCounts = new Map<string, number>();
 function getNodeIdPrefix(template: string) {
@@ -52,15 +47,6 @@ function getNodeIdPrefix(template: string) {
   return prefix;
 }
 
-// const axeViolationImpact: {
-//   [impact in NonNullable<axe.ImpactValue>]: DiagnosticSeverity;
-// } = {
-//   minor: 1,
-//   moderate: 2,
-//   serious: 3,
-//   critical: 4,
-// };
-
 const HTMLService: Partial<Plugin> = {
   commands: {
     "$/showHtmlOutput": async (uri: string) => {
@@ -138,12 +124,8 @@ const HTMLService: Partial<Plugin> = {
       );
 
       if (!sourceRange) {
-        // The element came from an inlined child template and has no mapping
-        // into this document. Diagnostics on the *top-level* elements of the
-        // inlined skeleton describe the tag's rendered output as used here,
-        // so they are re-anchored to the tag name at the usage site. Anything
-        // nested deeper is the child template's own concern and is reported
-        // when the child template itself is validated.
+        // Unmapped elements come from an inlined child: re-anchor skeleton
+        // roots to the tag usage; deeper ones are the child's own concern.
         const region = regionAt(inlineRegions, generatedLoc.startOffset);
         if (
           !region ||
@@ -189,13 +171,8 @@ function extract(doc: TextDocument) {
   return result;
 }
 
-/**
- * Resolves a custom tag to the extracted skeleton of its template so it can
- * be inlined at the usage site. Returns undefined (falling back to the
- * previous `<div>` placeholder behavior) for anything that can't be resolved
- * confidently: non-template tags, cycles, or when the depth/size limits are
- * reached.
- */
+/** Undefined (the legacy `<div>` fallback) for non-template tags, cycles, and
+ * anything past the depth/size limits. */
 function createChildResolver(
   file: MarkoFile,
   stack: Set<string>,
@@ -289,18 +266,14 @@ function regionAt(regions: InlineRegion[], offset: number) {
   return match;
 }
 
-/**
- * True when the parent chain axe consults for a parent-context rule is fully
- * known — every consulted ancestor is a real extracted element (not the
- * document body, and not a fabricated placeholder) with static semantics.
- */
+/** True when every ancestor axe consults for the rule is a real extracted
+ * element with static semantics. */
 function hasKnownParent(
   element: HTMLElement,
   mode: NonNullable<Exceptions["requiresKnownParent"]>,
   nodeDetails: NodeDetails,
 ) {
-  // An element with an id could be re-parented in the accessibility tree via
-  // `aria-owns` from a template we can't see; don't judge it by DOM position.
+  // An id could be `aria-owns` re-parented from a template we can't see.
   if (element.hasAttribute("id")) return false;
 
   const parent = element.parentElement;
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index 2383bee4..a47d2e4b 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -15,10 +15,7 @@ import {
 export interface HTMLNodeDetails {
   hasDynamicAttrs: boolean;
   hasDynamicBody: boolean;
-  /**
-   * True when the element is inside a control flow branch (`<if>`, `<for>`,
-   * ...) and so may render zero or multiple times.
-   */
+  /** True inside a control flow branch, which may render zero or many times. */
   inConditional: boolean;
 }
 
@@ -31,25 +28,16 @@ export interface HTMLBodySlot {
   inConditional: boolean;
 }
 
-/**
- * A pre-extracted child template that can be inlined where a custom tag is
- * used, so rules can evaluate the tag's rendered output in context.
- */
+/** A pre-extracted child template that can be inlined where a custom tag is used. */
 export interface InlineChildTemplate {
-  /**
-   * The generated HTML skeleton, split at the default body slot when the
-   * template renders its default body content in exactly one known location.
-   */
+  /** The HTML skeleton, split at the default body slot when exactly one exists. */
   segments: [string] | [string, string];
   /** Element depth of the body slot (only when `segments.length === 2`). */
   bodySlotDepth: number;
   /** True when the body slot is inside a control flow branch. */
   bodySlotConditional: boolean;
-  /**
-   * True when any part of the skeleton may not match the rendered output
-   * (dynamic content, unresolved tags, ...). Propagated to ancestors of the
-   * usage site so `unknownBody` rule exceptions still apply.
-   */
+  /** True when the skeleton may not match rendered output; propagated to the
+   * usage site's ancestors so `unknownBody` rule exceptions still apply. */
   uncertain: boolean;
   /** Details for elements of the skeleton, keyed by (prefixed) node id. */
   nodeDetails: Record<string, HTMLNodeDetails>;
@@ -72,17 +60,10 @@ export interface InlineRegion {
 }
 
 export interface ExtractHTMLOptions {
-  /**
-   * Prefix applied to generated node ids; must be unique per template file so
-   * details of inlined templates can be merged without collisions.
-   */
+  /** Unique-per-template prefix for node ids so merged details can't collide. */
   nodeIdPrefix?: string;
-  /**
-   * When true, a bodyless `<${input.renderBody}/>` (or `input.content`) tag
-   * is reported as a body slot instead of being treated as unknown dynamic
-   * content. Only enable when extracting a template for inlining, where the
-   * usage site determines what renders at the slot.
-   */
+  /** Report bodyless `<${input.renderBody}/>` tags as body slots instead of
+   * unknown content; enable only when extracting a template for inlining. */
   trackBodySlot?: boolean;
   /** Resolve a custom tag to a child template skeleton to inline. */
   resolveChild?(tagName: string): InlineChildTemplate | undefined;
@@ -128,7 +109,6 @@ class HTMLExtractor {
     return {
       extracted: this.#extractor.end(),
       nodeDetails: this.#nodeDetails,
-      /** True when any content may not match rendered output. */
       uncertain: this.#uncertain,
       bodySlots: this.#bodySlots,
       inlineRegions: this.#inlineRegions,
@@ -152,10 +132,8 @@ class HTMLExtractor {
         }
 
         if (isControlFlowTag(node)) {
-          // Control flow renders no element of its own; emit the body
-          // directly (rather than a fabricated `<div>`) so structural rules
-          // see the true parent/child relationships. The content is still
-          // dynamic: it may render zero or multiple times.
+          // Control flow renders no element of its own; emit the body directly
+          // so structural rules see the true parent/child relationships.
           this.#conditionalDepth++;
           node.body?.forEach((child) => this.#visitNode(child));
           this.#conditionalDepth--;
@@ -211,12 +189,10 @@ class HTMLExtractor {
           depth: this.#domDepth,
           inConditional: this.#conditionalDepth > 0,
         });
-        // The usage site determines what renders here; certainty is decided
-        // when (and if) content is spliced in.
         return false;
       }
 
-      // Standalone validation of a template: the body is unknown content.
+      // Without a usage site the body is unknown content.
       return true;
     }
 
@@ -229,15 +205,13 @@ class HTMLExtractor {
       child &&
       // Named content (`<@foo>`) can't be placed within the child skeleton.
       !node.hasAttrTags &&
-      // A body needs a known slot to splice into; otherwise fall through so
-      // the body content is still emitted (and validated) below.
+      // A body needs a known slot to splice into.
       (!node.body || child.segments.length === 2)
     ) {
       return this.#inlineChild(node, child);
     }
 
-    // Fallback: replace unknown and unresolvable tags with a `div` wrapping
-    // their body.
+    // Replace unknown and unresolvable tags with a `div` wrapping their body.
     if (node.body) {
       this.#extractor.write("<div>");
       this.#domDepth++;

From 4a9906abdff40a782b1c950a1aae1371bd54b3e4 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 15:14:26 +0000
Subject: [PATCH 05/19] Strip comments down to load-bearing one-liners

Delete interface JSDoc and narration that restated the code; rename
regionAt to innermostRegionAt so the selection rule is in the name.
---
 .../service/html/axe-rules/rule-exceptions.ts |  6 ++--
 .../language-server/src/service/html/index.ts | 24 ++++++----------
 .../src/extractors/html/index.ts              | 28 +------------------
 packages/language-tools/src/util/extractor.ts |  1 -
 4 files changed, 12 insertions(+), 47 deletions(-)

diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index c2a6592f..c804d7c1 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -22,13 +22,11 @@ export interface Exceptions {
    */
   unknownBody?: boolean;
   /**
-   * Exclude duplicate-content rules inside control flow branches, which are
-   * mutually exclusive at runtime
+   * Exclude if inside a control flow branch (branches never coexist)
    */
   conditionalContent?: boolean;
   /**
-   * Only report when the parent chain axe consults is fully known;
-   * "div-wrapped" also checks the grandparent through presentational `<div>`s
+   * Exclude unless the parent chain axe consults is fully known
    */
   requiresKnownParent?: true | "div-wrapped";
 }
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index cfaf36ab..5b82a474 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -15,15 +15,13 @@ import { get, projectVersion } from "../../utils/text-documents";
 import type { Plugin } from "../types";
 import { type Exceptions, ruleExceptions } from "./axe-rules/rule-exceptions";
 
-/** Limits for inlining child templates into the extracted HTML. */
 const MAX_INLINE_DEPTH = 3;
 const MAX_INLINE_BYTES = 100_000;
 
 type Extraction = ReturnType<typeof extractHTML>;
 type NodeDetails = Extraction["nodeDetails"];
 
-// Keyed on projectVersion (not just the parse): an inlined child template may
-// change without this document re-parsing. Extraction is cheap next to axe.
+// Keyed on projectVersion: inlined children can change without a re-parse.
 const extractCache = new WeakMap<
   Parsed,
   { version: number; result: Extraction }
@@ -31,8 +29,7 @@ const extractCache = new WeakMap<
 let skeletonCacheVersion = -1;
 let skeletonCache = new Map<Parsed, InlineChildTemplate | undefined>();
 
-// Per-template node id namespaces, path-independent (basename + dedup
-// counter) so extracted output stays stable across machines.
+// Path-independent so extracted output is stable across machines.
 const templatePrefixes = new Map<string, string>();
 const basenameCounts = new Map<string, number>();
 function getNodeIdPrefix(template: string) {
@@ -124,9 +121,12 @@ const HTMLService: Partial<Plugin> = {
       );
 
       if (!sourceRange) {
-        // Unmapped elements come from an inlined child: re-anchor skeleton
-        // roots to the tag usage; deeper ones are the child's own concern.
-        const region = regionAt(inlineRegions, generatedLoc.startOffset);
+        // Unmapped elements come from an inlined child; only its top-level
+        // elements re-anchor to the usage site.
+        const region = innermostRegionAt(
+          inlineRegions,
+          generatedLoc.startOffset,
+        );
         if (
           !region ||
           !nodeId ||
@@ -171,8 +171,6 @@ function extract(doc: TextDocument) {
   return result;
 }
 
-/** Undefined (the legacy `<div>` fallback) for non-template tags, cycles, and
- * anything past the depth/size limits. */
 function createChildResolver(
   file: MarkoFile,
   stack: Set<string>,
@@ -217,7 +215,6 @@ function getSkeleton(
     skeletonCache = new Map();
   }
   if (skeletonCache.has(file.parsed)) return skeletonCache.get(file.parsed);
-  // Guard against re-entering while this skeleton is being built.
   skeletonCache.set(file.parsed, undefined);
 
   const { extracted, nodeDetails, uncertain, bodySlots, rootIds } = extractHTML(
@@ -251,8 +248,7 @@ function getSkeleton(
   return skeleton;
 }
 
-/** The innermost inlined region containing a generated offset, if any. */
-function regionAt(regions: InlineRegion[], offset: number) {
+function innermostRegionAt(regions: InlineRegion[], offset: number) {
   let match: InlineRegion | undefined;
   for (const region of regions) {
     if (
@@ -266,8 +262,6 @@ function regionAt(regions: InlineRegion[], offset: number) {
   return match;
 }
 
-/** True when every ancestor axe consults for the rule is a real extracted
- * element with static semantics. */
 function hasKnownParent(
   element: HTMLElement,
   mode: NonNullable<Exceptions["requiresKnownParent"]>,
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index a47d2e4b..ac9dffcb 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -15,57 +15,37 @@ import {
 export interface HTMLNodeDetails {
   hasDynamicAttrs: boolean;
   hasDynamicBody: boolean;
-  /** True inside a control flow branch, which may render zero or many times. */
   inConditional: boolean;
 }
 
 export interface HTMLBodySlot {
-  /** Offset in the generated HTML where default body content is rendered. */
   offset: number;
-  /** Number of elements the slot is nested under within the template. */
   depth: number;
-  /** True when the slot itself is inside a control flow branch. */
   inConditional: boolean;
 }
 
-/** A pre-extracted child template that can be inlined where a custom tag is used. */
 export interface InlineChildTemplate {
   /** The HTML skeleton, split at the default body slot when exactly one exists. */
   segments: [string] | [string, string];
-  /** Element depth of the body slot (only when `segments.length === 2`). */
   bodySlotDepth: number;
-  /** True when the body slot is inside a control flow branch. */
   bodySlotConditional: boolean;
-  /** True when the skeleton may not match rendered output; propagated to the
-   * usage site's ancestors so `unknownBody` rule exceptions still apply. */
   uncertain: boolean;
-  /** Details for elements of the skeleton, keyed by (prefixed) node id. */
   nodeDetails: Record<string, HTMLNodeDetails>;
-  /** Node ids of the top-level elements of the skeleton. */
   rootIds: string[];
 }
 
-/** A generated range produced by inlining a child template. */
 export interface InlineRegion {
   start: number;
   end: number;
-  /** Source range of the custom tag name, used to re-anchor diagnostics. */
   tagName: Range;
-  /** True when body content spliced into this instance is dynamic. */
   bodyUncertain: boolean;
-  /** True when the usage site is inside a control flow branch. */
   inConditional: boolean;
-  /** Top-level element node ids of the inlined skeleton. */
   rootIds: string[];
 }
 
 export interface ExtractHTMLOptions {
-  /** Unique-per-template prefix for node ids so merged details can't collide. */
   nodeIdPrefix?: string;
-  /** Report bodyless `<${input.renderBody}/>` tags as body slots instead of
-   * unknown content; enable only when extracting a template for inlining. */
   trackBodySlot?: boolean;
-  /** Resolve a custom tag to a child template skeleton to inline. */
   resolveChild?(tagName: string): InlineChildTemplate | undefined;
 }
 
@@ -132,8 +112,7 @@ class HTMLExtractor {
         }
 
         if (isControlFlowTag(node)) {
-          // Control flow renders no element of its own; emit the body directly
-          // so structural rules see the true parent/child relationships.
+          // Emitted inline: control flow renders no element of its own.
           this.#conditionalDepth++;
           node.body?.forEach((child) => this.#visitNode(child));
           this.#conditionalDepth--;
@@ -175,9 +154,7 @@ class HTMLExtractor {
     return isDynamic || hasDynamicBody;
   }
 
-  /** Handles tags that are not plain HTML elements (custom/dynamic tags). */
   #writeDynamicTag(node: Node.Tag): boolean {
-    // `<${input.renderBody}/>` — where a template renders its default body.
     if (
       !node.nameText &&
       !node.body &&
@@ -192,7 +169,6 @@ class HTMLExtractor {
         return false;
       }
 
-      // Without a usage site the body is unknown content.
       return true;
     }
 
@@ -203,9 +179,7 @@ class HTMLExtractor {
 
     if (
       child &&
-      // Named content (`<@foo>`) can't be placed within the child skeleton.
       !node.hasAttrTags &&
-      // A body needs a known slot to splice into.
       (!node.body || child.segments.length === 2)
     ) {
       return this.#inlineChild(node, child);
diff --git a/packages/language-tools/src/util/extractor.ts b/packages/language-tools/src/util/extractor.ts
index 575893ea..8eb57d16 100644
--- a/packages/language-tools/src/util/extractor.ts
+++ b/packages/language-tools/src/util/extractor.ts
@@ -65,7 +65,6 @@ export class Extractor {
     return this;
   }
 
-  /** Current length of the generated output. */
   get length() {
     return this.#generated.length;
   }

From 14a0504f90b5088e15bcb0a892a4b0683c5b820a Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:04:54 +0000
Subject: [PATCH 06/19] Note axe version coupling and sanitize node id prefixes

The requiresKnownParent gates mirror axe-core 4.12's parent checks, so
flag that for future axe upgrades, and strip attribute-unsafe
characters from template basenames used in data-marko-node-id.
---
 .../src/service/html/axe-rules/rule-exceptions.ts              | 3 ++-
 packages/language-server/src/service/html/index.ts             | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index c804d7c1..a8fde78b 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -26,7 +26,8 @@ export interface Exceptions {
    */
   conditionalContent?: boolean;
   /**
-   * Exclude unless the parent chain axe consults is fully known
+   * Exclude unless the parent chain axe consults is fully known; written
+   * against axe-core 4.12's checks — re-verify on axe upgrades
    */
   requiresKnownParent?: true | "div-wrapped";
 }
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 5b82a474..64be2328 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -35,7 +35,7 @@ const basenameCounts = new Map<string, number>();
 function getNodeIdPrefix(template: string) {
   let prefix = templatePrefixes.get(template);
   if (prefix === undefined) {
-    const base = path.basename(template);
+    const base = path.basename(template).replace(/[^\w.-]/g, "_");
     const count = basenameCounts.get(base) ?? 0;
     basenameCounts.set(base, count + 1);
     prefix = `${count === 0 ? base : `${base}~${count}`}#`;

From 322e78e6ac4717424a1416ab1b025d8ca688ff2c Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:15:29 +0000
Subject: [PATCH 07/19] Shorten the changeset description

---
 .changeset/spotty-moons-repeat.md | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/.changeset/spotty-moons-repeat.md b/.changeset/spotty-moons-repeat.md
index 9e74a5fb..df997750 100644
--- a/.changeset/spotty-moons-repeat.md
+++ b/.changeset/spotty-moons-repeat.md
@@ -3,9 +3,4 @@
 "@marko/language-server": minor
 ---
 
-Improve the axe-core accessibility linter's awareness of child templates:
-
-- Custom tags that resolve to a `.marko` template now inline that template's extracted HTML at the usage site (with cycle, depth, and size guards), so rules can evaluate a tag's rendered output in context — eg `<a href><my-icon/></a>` now reports `link-name` when the icon renders `aria-hidden` content, and diagnostics for a template's top-level elements are re-anchored to the tag usage (`<my-item/>` inside `<div>` reports `listitem`).
-- Control flow tags (`<if>`, `<else>`, `<for>`, `<while>`) no longer fabricate `<div>` wrappers around their body, so structural rules see true parent/child relationships.
-- The `listitem` and `dlitem` rules are now enabled, gated so they only report when the parent chain axe consults is fully known (never for a template's own top-level elements, whose parent comes from the usage site).
-- Duplicate-detection rules (`accesskeys`, `landmark-unique`, `identical-links-same-purpose`, ...) are suppressed for elements inside control flow branches, since only one branch renders at a time.
+Take child templates into account in the accessibility linter.

From f0812f8149808f58a9924012e306917effcd727d Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:27:23 +0000
Subject: [PATCH 08/19] Regenerate axe rules and enable page rules for static
 documents

Regenerating axe-rules.ts against the installed axe-core 4.12.1 (the
file was generated from 4.10) picks up the new aria-tab-name rule,
whitelisted with the same exceptions as its sibling name rules.

The extracted HTML is now exact enough for a stronger guarantee: when a
file renders an authored <html> containing no dynamic attributes,
placeholders, or unresolvable content, the extraction IS the rendered
page. A new requiresFullDocument exception runs rules gated on that
exactness, re-enabling all fifteen previously blacklisted
page/ancestor-context rules (label, region, bypass, heading-order,
nested-interactive, aria-required-parent, landmark placement, and
friends) for fully static documents while suppressing them everywhere
else.

Extraction also now emits static shorthand ids/classes (dynamic ones
become "dynamic" like other attribute values) and tracks whether any
placeholders exist, both feeding the exactness check.
---
 .changeset/plenty-pages-audit.md              |   6 +
 .../full-document-dynamic.expected/index.html |  13 +
 .../full-document-dynamic.expected/index.md   |   0
 .../full-document-dynamic.expected/index.ts   | 117 +++++++++
 .../html/full-document-dynamic/index.marko    |  17 ++
 .../full-document.expected/index.html         |  13 +
 .../full-document.expected/index.md           |  43 ++++
 .../full-document.expected/index.ts           | 114 +++++++++
 .../fixtures/html/full-document/index.marko   |  13 +
 .../index.html                                |   2 +-
 .../index.html                                |   2 +-
 .../class-api-basic.expected/index.html       |   2 +-
 .../empty-tagname.expected/index.html         |   2 +-
 .../tags-api-basic.expected/index.html        |   2 +-
 .../src/service/html/axe-rules/axe-rules.ts   | 233 +++++++++---------
 .../service/html/axe-rules/rule-exceptions.ts |  39 +--
 .../language-server/src/service/html/index.ts |  48 +++-
 .../src/extractors/html/index.ts              |  39 +++
 18 files changed, 556 insertions(+), 149 deletions(-)
 create mode 100644 .changeset/plenty-pages-audit.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/index.marko
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.html
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.md
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.ts
 create mode 100644 packages/language-server/src/__tests__/fixtures/html/full-document/index.marko

diff --git a/.changeset/plenty-pages-audit.md b/.changeset/plenty-pages-audit.md
new file mode 100644
index 00000000..fc93d2ea
--- /dev/null
+++ b/.changeset/plenty-pages-audit.md
@@ -0,0 +1,6 @@
+---
+"@marko/language-tools": minor
+"@marko/language-server": minor
+---
+
+Enable page-scoped accessibility rules for fully static documents.
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.html
new file mode 100644
index 00000000..a2365eed
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.html
@@ -0,0 +1,13 @@
+<html data-marko-node-id="0" lang="en">
+  <head data-marko-node-id="1">
+    <title data-marko-node-id="2">Dynamic page</title>
+  </head>
+  <body data-marko-node-id="3" class="dynamic">
+    <main data-marko-node-id="4">
+      <h1 data-marko-node-id="5">Welcome</h1>
+      <h4 data-marko-node-id="6">Skipped a level</h4>
+      <div data-marko-node-id="7" role="tab">Orphan tab</div>
+      <input data-marko-node-id="8" type="text">
+    </main>
+  </body>
+</html>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.md
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.ts
new file mode 100644
index 00000000..53f92363
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/__snapshots__/full-document-dynamic.expected/index.ts
@@ -0,0 +1,117 @@
+export interface Input {
+  theme: string;
+}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("html")()()({
+    lang: "en",
+    [Marko._.content]: (() => {
+      Marko._.renderNativeTag("head")()()({
+        [Marko._.content]: (() => {
+          Marko._.renderNativeTag("title")()()({
+            [Marko._.content]: (() => {
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      Marko._.renderNativeTag("body")()()({
+        class: input.theme,
+        [Marko._.content]: (() => {
+          Marko._.renderNativeTag("main")()()({
+            [Marko._.content]: (() => {
+              Marko._.renderNativeTag("h1")()()({
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("h4")()()({
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("div")()()({
+                role: "tab",
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("input")()()({
+                type: "text",
+              });
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/index.marko b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/index.marko
new file mode 100644
index 00000000..2f7c357d
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document-dynamic/index.marko
@@ -0,0 +1,17 @@
+export interface Input {
+  theme: string;
+}
+
+<html lang="en">
+  <head>
+    <title>Dynamic page</title>
+  </head>
+  <body class=input.theme>
+    <main>
+      <h1>Welcome</h1>
+      <h4>Skipped a level</h4>
+      <div role="tab">Orphan tab</div>
+      <input type="text">
+    </main>
+  </body>
+</html>
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.html b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.html
new file mode 100644
index 00000000..561c46cd
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.html
@@ -0,0 +1,13 @@
+<html data-marko-node-id="0" lang="en">
+  <head data-marko-node-id="1">
+    <title data-marko-node-id="2">Static page</title>
+  </head>
+  <body data-marko-node-id="3">
+    <main data-marko-node-id="4">
+      <h1 data-marko-node-id="5">Welcome</h1>
+      <h4 data-marko-node-id="6">Skipped a level</h4>
+      <div data-marko-node-id="7" role="tab">Orphan tab</div>
+      <input data-marko-node-id="8" type="text">
+    </main>
+  </body>
+</html>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.md b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.md
new file mode 100644
index 00000000..4234d37d
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.md
@@ -0,0 +1,43 @@
+## Diagnostics
+### Ln 9, Col 8
+```marko
+   7 |       <h1>Welcome</h1>
+   8 |       <h4>Skipped a level</h4>
+>  9 |       <div role="tab">Orphan tab</div>
+     |        ^^^ Fix any of the following:
+  Required ARIA parent role not present: tablist
+  10 |       <input type="text">
+  11 |     </main>
+  12 |   </body>
+```
+
+### Ln 8, Col 8
+```marko
+   6 |     <main>
+   7 |       <h1>Welcome</h1>
+>  8 |       <h4>Skipped a level</h4>
+     |        ^^ Fix any of the following:
+  Heading order invalid
+   9 |       <div role="tab">Orphan tab</div>
+  10 |       <input type="text">
+  11 |     </main>
+```
+
+### Ln 10, Col 8
+```marko
+   8 |       <h4>Skipped a level</h4>
+   9 |       <div role="tab">Orphan tab</div>
+> 10 |       <input type="text">
+     |        ^^^^^ Fix any of the following:
+  Element does not have an implicit (wrapped) <label>
+  Element does not have an explicit <label>
+  aria-label attribute does not exist or is empty
+  aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
+  Element has no title attribute
+  Element has no placeholder attribute
+  Element's default semantics were not overridden with role="none" or role="presentation"
+  11 |     </main>
+  12 |   </body>
+  13 | </html>
+```
+
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.ts
new file mode 100644
index 00000000..cbc82866
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document/__snapshots__/full-document.expected/index.ts
@@ -0,0 +1,114 @@
+export interface Input {}
+abstract class Component extends Marko.Component<Input> {}
+export { type Component };
+(function (this: void) {
+  const input = Marko._.any as Input;
+  const component = Marko._.any as Component;
+  const state = Marko._.state(component);
+  const out = Marko._.any as Marko.Out;
+  const $signal = Marko._.any as AbortSignal;
+  const $global = Marko._.getGlobal(
+    // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
+    (Marko._.error, Marko._.any as MarkoRun.Context),
+  );
+  Marko._.renderNativeTag("html")()()({
+    lang: "en",
+    [Marko._.content]: (() => {
+      Marko._.renderNativeTag("head")()()({
+        [Marko._.content]: (() => {
+          Marko._.renderNativeTag("title")()()({
+            [Marko._.content]: (() => {
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      Marko._.renderNativeTag("body")()()({
+        [Marko._.content]: (() => {
+          Marko._.renderNativeTag("main")()()({
+            [Marko._.content]: (() => {
+              Marko._.renderNativeTag("h1")()()({
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("h4")()()({
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("div")()()({
+                role: "tab",
+                [Marko._.content]: (() => {
+                  return () => {
+                    return Marko._.voidReturn;
+                  };
+                })(),
+              });
+              Marko._.renderNativeTag("input")()()({
+                type: "text",
+              });
+              return () => {
+                return Marko._.voidReturn;
+              };
+            })(),
+          });
+          return () => {
+            return Marko._.voidReturn;
+          };
+        })(),
+      });
+      return () => {
+        return Marko._.voidReturn;
+      };
+    })(),
+  });
+  Marko._.noop({ component, state, out, input, $global, $signal });
+  return;
+})();
+const __marko_internal_api = "class";
+export { __marko_internal_api as "~api" };
+export default new (class Template extends Marko._.Template<{
+  render(
+    input: Marko.TemplateInput<Input>,
+    stream?: {
+      write: (chunk: string) => void;
+      end: (chunk?: string) => void;
+    },
+  ): Marko.Out<Component>;
+
+  render(
+    input: Marko.TemplateInput<Input>,
+    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
+  ): Marko.Out<Component>;
+
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+
+  renderToString(input: Marko.TemplateInput<Input>): string;
+
+  stream(
+    input: Marko.TemplateInput<Input>,
+  ): ReadableStream<string> & NodeJS.ReadableStream;
+
+  mount(
+    input: Marko.TemplateInput<Input>,
+    reference: Node,
+    position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+  ): Marko.MountedTemplate<typeof input>;
+
+  api: typeof __marko_internal_api;
+  _(): () => <__marko_internal_input extends unknown>(
+    input: Marko.Directives &
+      Input &
+      Marko._.Relate<__marko_internal_input, Marko.Directives & Input>,
+  ) => Marko._.ReturnWithScope<__marko_internal_input, void>;
+}> {})();
diff --git a/packages/language-server/src/__tests__/fixtures/html/full-document/index.marko b/packages/language-server/src/__tests__/fixtures/html/full-document/index.marko
new file mode 100644
index 00000000..f4b5ed28
--- /dev/null
+++ b/packages/language-server/src/__tests__/fixtures/html/full-document/index.marko
@@ -0,0 +1,13 @@
+<html lang="en">
+  <head>
+    <title>Static page</title>
+  </head>
+  <body>
+    <main>
+      <h1>Welcome</h1>
+      <h4>Skipped a level</h4>
+      <div role="tab">Orphan tab</div>
+      <input type="text">
+    </main>
+  </body>
+</html>
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
index 12c87bce..650b9c04 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-class-id-shorthands/__snapshots__/attr-class-id-shorthands.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="0"></div><div data-marko-node-id="1"></div><div data-marko-node-id="2"></div><div data-marko-node-id="3"></div><div data-marko-node-id="4"></div><div data-marko-node-id="5"></div><div data-marko-node-id="6"></div><div data-marko-node-id="7"></div><div data-marko-node-id="8"></div>
\ No newline at end of file
+<div data-marko-node-id="0" id="test"></div><div data-marko-node-id="1" id="dynamic"></div><div data-marko-node-id="2" id="dynamic"></div><div data-marko-node-id="3" id="dynamic"></div><div data-marko-node-id="4" class="test"></div><div data-marko-node-id="5" class="hello world"></div><div data-marko-node-id="6" class="dynamic"></div><div data-marko-node-id="7" class="dynamic"></div><div data-marko-node-id="8" class="dynamic"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
index f806b688..864751a4 100644
--- a/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/attr-class-shorthand-merge/__snapshots__/attr-class-shorthand-merge.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="0" class="foo"></div><div data-marko-node-id="1" class="foo"></div><div data-marko-node-id="2" class="dynamic"></div><div data-marko-node-id="3" class="dynamic"></div><div data-marko-node-id="4" class="dynamic"></div><div data-marko-node-id="5" class="foo"></div><div data-marko-node-id="6" class="dynamic"></div><div data-marko-node-id="7" class="123"></div>
\ No newline at end of file
+<div data-marko-node-id="0" class="btn" class="foo"></div><div data-marko-node-id="1" class="btn other" class="foo"></div><div data-marko-node-id="2" class="btn" class="dynamic"></div><div data-marko-node-id="3" class="btn" class="dynamic"></div><div data-marko-node-id="4" class="btn" class="dynamic"></div><div data-marko-node-id="5" class="dynamic" class="foo"></div><div data-marko-node-id="6" class="dynamic other" class="dynamic"></div><div data-marko-node-id="7" class="btn" class="123"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
index 0f5056d0..82157cc2 100644
--- a/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/class-api-basic/__snapshots__/class-api-basic.expected/index.html
@@ -12,7 +12,7 @@
       <span data-marko-node-id="4" id="dynamic">placeholder placeholder placeholder</span>
     
 
-    <div data-marko-node-id="5">
+    <div data-marko-node-id="5" class="container">
         
     </div>
     <div>placeholder</div>
diff --git a/packages/language-server/src/__tests__/fixtures/script/empty-tagname/__snapshots__/empty-tagname.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/empty-tagname/__snapshots__/empty-tagname.expected/index.html
index 3143e0dc..c975e136 100644
--- a/packages/language-server/src/__tests__/fixtures/script/empty-tagname/__snapshots__/empty-tagname.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/empty-tagname/__snapshots__/empty-tagname.expected/index.html
@@ -1 +1 @@
-<div data-marko-node-id="0"></div>
\ No newline at end of file
+<div data-marko-node-id="0" class="hello"></div>
\ No newline at end of file
diff --git a/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html b/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
index 512c3fde..c87be2d4 100644
--- a/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
+++ b/packages/language-server/src/__tests__/fixtures/script/tags-api-basic/__snapshots__/tags-api-basic.expected/index.html
@@ -13,7 +13,7 @@
 
     
 
-    <div data-marko-node-id="5">
+    <div data-marko-node-id="5" class="container">
         
     </div>
     <div>placeholder</div>
diff --git a/packages/language-server/src/service/html/axe-rules/axe-rules.ts b/packages/language-server/src/service/html/axe-rules/axe-rules.ts
index 62a932bf..809581b5 100644
--- a/packages/language-server/src/service/html/axe-rules/axe-rules.ts
+++ b/packages/language-server/src/service/html/axe-rules/axe-rules.ts
@@ -1,110 +1,110 @@
 export const keyboard = {
   /**
    * - Ensure every accesskey attribute value is unique
-   * - accesskey attribute value should be unique ([url](https://dequeuniversity.com/rules/axe/4.10/accesskeys?application=axeAPI))
+   * - accesskey attribute value should be unique ([url](https://dequeuniversity.com/rules/axe/4.12/accesskeys?application=axeAPI))
    */
   accesskeys: "accesskeys",
   /**
    * - Ensure each page has at least one mechanism for a user to bypass navigation and jump straight to the content
-   * - Page must have means to bypass repeated blocks ([url](https://dequeuniversity.com/rules/axe/4.10/bypass?application=axeAPI))
+   * - Page must have means to bypass repeated blocks ([url](https://dequeuniversity.com/rules/axe/4.12/bypass?application=axeAPI))
    */
   bypass: "bypass",
   /**
    * - Ensure elements in the focus order have a role appropriate for interactive content
-   * - Elements in the focus order should have an appropriate role ([url](https://dequeuniversity.com/rules/axe/4.10/focus-order-semantics?application=axeAPI))
+   * - Elements in the focus order should have an appropriate role ([url](https://dequeuniversity.com/rules/axe/4.12/focus-order-semantics?application=axeAPI))
    */
   focusOrderSemantics: "focus-order-semantics",
   /**
    * - Ensure `<frame>` and `<iframe>` elements with focusable content do not have tabindex=-1
-   * - Frames with focusable content must not have tabindex=-1 ([url](https://dequeuniversity.com/rules/axe/4.10/frame-focusable-content?application=axeAPI))
+   * - Frames with focusable content must not have tabindex=-1 ([url](https://dequeuniversity.com/rules/axe/4.12/frame-focusable-content?application=axeAPI))
    */
   frameFocusableContent: "frame-focusable-content",
   /**
    * - Ensure interactive controls are not nested as they are not always announced by screen readers or can cause focus problems for assistive technologies
-   * - Interactive controls must not be nested ([url](https://dequeuniversity.com/rules/axe/4.10/nested-interactive?application=axeAPI))
+   * - Interactive controls must not be nested ([url](https://dequeuniversity.com/rules/axe/4.12/nested-interactive?application=axeAPI))
    */
   nestedInteractive: "nested-interactive",
   /**
    * - Ensure all page content is contained by landmarks
-   * - All page content should be contained by landmarks ([url](https://dequeuniversity.com/rules/axe/4.10/region?application=axeAPI))
+   * - All page content should be contained by landmarks ([url](https://dequeuniversity.com/rules/axe/4.12/region?application=axeAPI))
    */
   region: "region",
   /**
-   * - Ensure elements that have scrollable content are accessible by keyboard
-   * - Scrollable region must have keyboard access ([url](https://dequeuniversity.com/rules/axe/4.10/scrollable-region-focusable?application=axeAPI))
+   * - Ensure elements that have scrollable content are accessible by keyboard in Safari
+   * - Scrollable region must have keyboard access ([url](https://dequeuniversity.com/rules/axe/4.12/scrollable-region-focusable?application=axeAPI))
    */
   scrollableRegionFocusable: "scrollable-region-focusable",
   /**
    * - Ensure all skip links have a focusable target
-   * - The skip-link target should exist and be focusable ([url](https://dequeuniversity.com/rules/axe/4.10/skip-link?application=axeAPI))
+   * - The skip-link target should exist and be focusable ([url](https://dequeuniversity.com/rules/axe/4.12/skip-link?application=axeAPI))
    */
   skipLink: "skip-link",
   /**
    * - Ensure tabindex attribute values are not greater than 0
-   * - Elements should not have tabindex greater than zero ([url](https://dequeuniversity.com/rules/axe/4.10/tabindex?application=axeAPI))
+   * - Elements should not have tabindex greater than zero ([url](https://dequeuniversity.com/rules/axe/4.12/tabindex?application=axeAPI))
    */
   tabindex: "tabindex",
 } as const;
 
 export const textAlternatives = {
   /**
-   * - Ensure `<area>` elements of image maps have alternate text
-   * - Active `<area>` elements must have alternate text ([url](https://dequeuniversity.com/rules/axe/4.10/area-alt?application=axeAPI))
+   * - Ensure `<area>` elements of image maps have alternative text
+   * - Active `<area>` elements must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/area-alt?application=axeAPI))
    */
   areaAlt: "area-alt",
   /**
    * - Ensure each HTML document contains a non-empty `<title>` element
-   * - Documents must have `<title>` element to aid in navigation ([url](https://dequeuniversity.com/rules/axe/4.10/document-title?application=axeAPI))
+   * - Documents must have `<title>` element to aid in navigation ([url](https://dequeuniversity.com/rules/axe/4.12/document-title?application=axeAPI))
    */
   documentTitle: "document-title",
   /**
    * - Ensure `<iframe>` and `<frame>` elements contain a unique title attribute
-   * - Frames must have a unique title attribute ([url](https://dequeuniversity.com/rules/axe/4.10/frame-title-unique?application=axeAPI))
+   * - Frames must have a unique title attribute ([url](https://dequeuniversity.com/rules/axe/4.12/frame-title-unique?application=axeAPI))
    */
   frameTitleUnique: "frame-title-unique",
   /**
    * - Ensure `<iframe>` and `<frame>` elements have an accessible name
-   * - Frames must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/frame-title?application=axeAPI))
+   * - Frames must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/frame-title?application=axeAPI))
    */
   frameTitle: "frame-title",
   /**
-   * - Ensure `<img>` elements have alternate text or a role of none or presentation
-   * - Images must have alternate text ([url](https://dequeuniversity.com/rules/axe/4.10/image-alt?application=axeAPI))
+   * - Ensure `<img>` elements have alternative text or a role of none or presentation
+   * - Images must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/image-alt?application=axeAPI))
    */
   imageAlt: "image-alt",
   /**
    * - Ensure image alternative is not repeated as text
-   * - Alternative text of images should not be repeated as text ([url](https://dequeuniversity.com/rules/axe/4.10/image-redundant-alt?application=axeAPI))
+   * - Alternative text of images should not be repeated as text ([url](https://dequeuniversity.com/rules/axe/4.12/image-redundant-alt?application=axeAPI))
    */
   imageRedundantAlt: "image-redundant-alt",
   /**
-   * - Ensure `<input type="image">` elements have alternate text
-   * - Image buttons must have alternate text ([url](https://dequeuniversity.com/rules/axe/4.10/input-image-alt?application=axeAPI))
+   * - Ensure `<input type="image">` elements have alternative text
+   * - Image buttons must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/input-image-alt?application=axeAPI))
    */
   inputImageAlt: "input-image-alt",
   /**
-   * - Ensure `<object>` elements have alternate text
-   * - `<object>` elements must have alternate text ([url](https://dequeuniversity.com/rules/axe/4.10/object-alt?application=axeAPI))
+   * - Ensure `<object>` elements have alternative text
+   * - `<object>` elements must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/object-alt?application=axeAPI))
    */
   objectAlt: "object-alt",
   /**
-   * - Ensure [role="img"] elements have alternate text
-   * - [role="img"] elements must have an alternative text ([url](https://dequeuniversity.com/rules/axe/4.10/role-img-alt?application=axeAPI))
+   * - Ensure [role="img"] elements have alternative text
+   * - [role="img"] elements must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/role-img-alt?application=axeAPI))
    */
   roleImgAlt: "role-img-alt",
   /**
    * - Ensure that server-side image maps are not used
-   * - Server-side image maps must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/server-side-image-map?application=axeAPI))
+   * - Server-side image maps must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/server-side-image-map?application=axeAPI))
    */
   serverSideImageMap: "server-side-image-map",
   /**
-   * - Ensure `<svg>` elements with an img, graphics-document or graphics-symbol role have an accessible text
-   * - `<svg>` elements with an img role must have an alternative text ([url](https://dequeuniversity.com/rules/axe/4.10/svg-img-alt?application=axeAPI))
+   * - Ensure `<svg>` elements with an img, graphics-document or graphics-symbol role have accessible text
+   * - `<svg>` elements with an img role must have alternative text ([url](https://dequeuniversity.com/rules/axe/4.12/svg-img-alt?application=axeAPI))
    */
   svgImgAlt: "svg-img-alt",
   /**
    * - Ensure `<video>` elements have captions
-   * - `<video>` elements must have captions ([url](https://dequeuniversity.com/rules/axe/4.10/video-caption?application=axeAPI))
+   * - `<video>` elements must have captions ([url](https://dequeuniversity.com/rules/axe/4.12/video-caption?application=axeAPI))
    */
   videoCaption: "video-caption",
 } as const;
@@ -112,122 +112,127 @@ export const textAlternatives = {
 export const aria = {
   /**
    * - Ensure an element's role supports its ARIA attributes
-   * - Elements must only use supported ARIA attributes ([url](https://dequeuniversity.com/rules/axe/4.10/aria-allowed-attr?application=axeAPI))
+   * - Elements must only use supported ARIA attributes ([url](https://dequeuniversity.com/rules/axe/4.12/aria-allowed-attr?application=axeAPI))
    */
   ariaAllowedAttr: "aria-allowed-attr",
   /**
    * - Ensure role attribute has an appropriate value for the element
-   * - ARIA role should be appropriate for the element ([url](https://dequeuniversity.com/rules/axe/4.10/aria-allowed-role?application=axeAPI))
+   * - ARIA role should be appropriate for the element ([url](https://dequeuniversity.com/rules/axe/4.12/aria-allowed-role?application=axeAPI))
    */
   ariaAllowedRole: "aria-allowed-role",
   /**
    * - Ensure aria-braillelabel and aria-brailleroledescription have a non-braille equivalent
-   * - aria-braille attributes must have a non-braille equivalent ([url](https://dequeuniversity.com/rules/axe/4.10/aria-braille-equivalent?application=axeAPI))
+   * - aria-braille attributes must have a non-braille equivalent ([url](https://dequeuniversity.com/rules/axe/4.12/aria-braille-equivalent?application=axeAPI))
    */
   ariaBrailleEquivalent: "aria-braille-equivalent",
   /**
    * - Ensure every ARIA button, link and menuitem has an accessible name
-   * - ARIA commands must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-command-name?application=axeAPI))
+   * - ARIA commands must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-command-name?application=axeAPI))
    */
   ariaCommandName: "aria-command-name",
   /**
    * - Ensure ARIA attributes are used as described in the specification of the element's role
-   * - ARIA attributes must be used as specified for the element's role ([url](https://dequeuniversity.com/rules/axe/4.10/aria-conditional-attr?application=axeAPI))
+   * - ARIA attributes must be used as specified for the element's role ([url](https://dequeuniversity.com/rules/axe/4.12/aria-conditional-attr?application=axeAPI))
    */
   ariaConditionalAttr: "aria-conditional-attr",
   /**
    * - Ensure elements do not use deprecated roles
-   * - Deprecated ARIA roles must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/aria-deprecated-role?application=axeAPI))
+   * - Deprecated ARIA roles must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/aria-deprecated-role?application=axeAPI))
    */
   ariaDeprecatedRole: "aria-deprecated-role",
   /**
    * - Ensure every ARIA dialog and alertdialog node has an accessible name
-   * - ARIA dialog and alertdialog nodes should have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-dialog-name?application=axeAPI))
+   * - ARIA dialog and alertdialog nodes should have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-dialog-name?application=axeAPI))
    */
   ariaDialogName: "aria-dialog-name",
   /**
    * - Ensure aria-hidden="true" is not present on the document body.
-   * - aria-hidden="true" must not be present on the document body ([url](https://dequeuniversity.com/rules/axe/4.10/aria-hidden-body?application=axeAPI))
+   * - aria-hidden="true" must not be present on the document body ([url](https://dequeuniversity.com/rules/axe/4.12/aria-hidden-body?application=axeAPI))
    */
   ariaHiddenBody: "aria-hidden-body",
   /**
    * - Ensure every ARIA input field has an accessible name
-   * - ARIA input fields must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-input-field-name?application=axeAPI))
+   * - ARIA input fields must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-input-field-name?application=axeAPI))
    */
   ariaInputFieldName: "aria-input-field-name",
   /**
    * - Ensure every ARIA meter node has an accessible name
-   * - ARIA meter nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-meter-name?application=axeAPI))
+   * - ARIA meter nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-meter-name?application=axeAPI))
    */
   ariaMeterName: "aria-meter-name",
   /**
    * - Ensure every ARIA progressbar node has an accessible name
-   * - ARIA progressbar nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-progressbar-name?application=axeAPI))
+   * - ARIA progressbar nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-progressbar-name?application=axeAPI))
    */
   ariaProgressbarName: "aria-progressbar-name",
   /**
    * - Ensure ARIA attributes are not prohibited for an element's role
-   * - Elements must only use permitted ARIA attributes ([url](https://dequeuniversity.com/rules/axe/4.10/aria-prohibited-attr?application=axeAPI))
+   * - Elements must only use permitted ARIA attributes ([url](https://dequeuniversity.com/rules/axe/4.12/aria-prohibited-attr?application=axeAPI))
    */
   ariaProhibitedAttr: "aria-prohibited-attr",
   /**
    * - Ensure elements with ARIA roles have all required ARIA attributes
-   * - Required ARIA attributes must be provided ([url](https://dequeuniversity.com/rules/axe/4.10/aria-required-attr?application=axeAPI))
+   * - Required ARIA attributes must be provided ([url](https://dequeuniversity.com/rules/axe/4.12/aria-required-attr?application=axeAPI))
    */
   ariaRequiredAttr: "aria-required-attr",
   /**
    * - Ensure elements with an ARIA role that require child roles contain them
-   * - Certain ARIA roles must contain particular children ([url](https://dequeuniversity.com/rules/axe/4.10/aria-required-children?application=axeAPI))
+   * - Certain ARIA roles must contain particular children ([url](https://dequeuniversity.com/rules/axe/4.12/aria-required-children?application=axeAPI))
    */
   ariaRequiredChildren: "aria-required-children",
   /**
    * - Ensure elements with an ARIA role that require parent roles are contained by them
-   * - Certain ARIA roles must be contained by particular parents ([url](https://dequeuniversity.com/rules/axe/4.10/aria-required-parent?application=axeAPI))
+   * - Certain ARIA roles must be contained by particular parents ([url](https://dequeuniversity.com/rules/axe/4.12/aria-required-parent?application=axeAPI))
    */
   ariaRequiredParent: "aria-required-parent",
   /**
    * - Ensure aria-roledescription is only used on elements with an implicit or explicit role
-   * - aria-roledescription must be on elements with a semantic role ([url](https://dequeuniversity.com/rules/axe/4.10/aria-roledescription?application=axeAPI))
+   * - aria-roledescription must be on elements with a semantic role ([url](https://dequeuniversity.com/rules/axe/4.12/aria-roledescription?application=axeAPI))
    */
   ariaRoledescription: "aria-roledescription",
   /**
    * - Ensure all elements with a role attribute use a valid value
-   * - ARIA roles used must conform to valid values ([url](https://dequeuniversity.com/rules/axe/4.10/aria-roles?application=axeAPI))
+   * - ARIA roles used must conform to valid values ([url](https://dequeuniversity.com/rules/axe/4.12/aria-roles?application=axeAPI))
    */
   ariaRoles: "aria-roles",
+  /**
+   * - Ensure every ARIA tab node has an accessible name
+   * - ARIA tab nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-tab-name?application=axeAPI))
+   */
+  ariaTabName: "aria-tab-name",
   /**
    * - Ensure role="text" is used on elements with no focusable descendants
-   * - "role=text" should have no focusable descendants ([url](https://dequeuniversity.com/rules/axe/4.10/aria-text?application=axeAPI))
+   * - "role=text" should have no focusable descendants ([url](https://dequeuniversity.com/rules/axe/4.12/aria-text?application=axeAPI))
    */
   ariaText: "aria-text",
   /**
    * - Ensure every ARIA toggle field has an accessible name
-   * - ARIA toggle fields must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-toggle-field-name?application=axeAPI))
+   * - ARIA toggle fields must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-toggle-field-name?application=axeAPI))
    */
   ariaToggleFieldName: "aria-toggle-field-name",
   /**
    * - Ensure every ARIA tooltip node has an accessible name
-   * - ARIA tooltip nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-tooltip-name?application=axeAPI))
+   * - ARIA tooltip nodes must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-tooltip-name?application=axeAPI))
    */
   ariaTooltipName: "aria-tooltip-name",
   /**
    * - Ensure every ARIA treeitem node has an accessible name
-   * - ARIA treeitem nodes should have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/aria-treeitem-name?application=axeAPI))
+   * - ARIA treeitem nodes should have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/aria-treeitem-name?application=axeAPI))
    */
   ariaTreeitemName: "aria-treeitem-name",
   /**
    * - Ensure all ARIA attributes have valid values
-   * - ARIA attributes must conform to valid values ([url](https://dequeuniversity.com/rules/axe/4.10/aria-valid-attr-value?application=axeAPI))
+   * - ARIA attributes must conform to valid values ([url](https://dequeuniversity.com/rules/axe/4.12/aria-valid-attr-value?application=axeAPI))
    */
   ariaValidAttrValue: "aria-valid-attr-value",
   /**
    * - Ensure attributes that begin with aria- are valid ARIA attributes
-   * - ARIA attributes must conform to valid names ([url](https://dequeuniversity.com/rules/axe/4.10/aria-valid-attr?application=axeAPI))
+   * - ARIA attributes must conform to valid names ([url](https://dequeuniversity.com/rules/axe/4.12/aria-valid-attr?application=axeAPI))
    */
   ariaValidAttr: "aria-valid-attr",
   /**
-   * - Elements marked as presentational should not have global ARIA or tabindex to ensure all screen readers ignore them
-   * - Ensure elements marked as presentational are consistently ignored ([url](https://dequeuniversity.com/rules/axe/4.10/presentation-role-conflict?application=axeAPI))
+   * - Ensure elements marked as presentational do not have global ARIA or tabindex so that all screen readers ignore them
+   * - Elements marked as presentational should be consistently ignored ([url](https://dequeuniversity.com/rules/axe/4.12/presentation-role-conflict?application=axeAPI))
    */
   presentationRoleConflict: "presentation-role-conflict",
 } as const;
@@ -235,37 +240,37 @@ export const aria = {
 export const nameRoleValue = {
   /**
    * - Ensure aria-hidden elements are not focusable nor contain focusable elements
-   * - ARIA hidden element must not be focusable or contain focusable elements ([url](https://dequeuniversity.com/rules/axe/4.10/aria-hidden-focus?application=axeAPI))
+   * - ARIA hidden element must not be focusable or contain focusable elements ([url](https://dequeuniversity.com/rules/axe/4.12/aria-hidden-focus?application=axeAPI))
    */
   ariaHiddenFocus: "aria-hidden-focus",
   /**
    * - Ensure buttons have discernible text
-   * - Buttons must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.10/button-name?application=axeAPI))
+   * - Buttons must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.12/button-name?application=axeAPI))
    */
   buttonName: "button-name",
   /**
    * - Ensure headings have discernible text
-   * - Headings should not be empty ([url](https://dequeuniversity.com/rules/axe/4.10/empty-heading?application=axeAPI))
+   * - Headings should not be empty ([url](https://dequeuniversity.com/rules/axe/4.12/empty-heading?application=axeAPI))
    */
   emptyHeading: "empty-heading",
   /**
    * - Ensure table headers have discernible text
-   * - Table header text should not be empty ([url](https://dequeuniversity.com/rules/axe/4.10/empty-table-header?application=axeAPI))
+   * - Table header text should not be empty ([url](https://dequeuniversity.com/rules/axe/4.12/empty-table-header?application=axeAPI))
    */
   emptyTableHeader: "empty-table-header",
   /**
    * - Ensure input buttons have discernible text
-   * - Input buttons must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.10/input-button-name?application=axeAPI))
+   * - Input buttons must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.12/input-button-name?application=axeAPI))
    */
   inputButtonName: "input-button-name",
   /**
    * - Ensure links have discernible text
-   * - Links must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.10/link-name?application=axeAPI))
+   * - Links must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.12/link-name?application=axeAPI))
    */
   linkName: "link-name",
   /**
    * - Ensure summary elements have discernible text
-   * - Summary elements must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.10/summary-name?application=axeAPI))
+   * - Summary elements must have discernible text ([url](https://dequeuniversity.com/rules/axe/4.12/summary-name?application=axeAPI))
    */
   summaryName: "summary-name",
 } as const;
@@ -273,27 +278,27 @@ export const nameRoleValue = {
 export const timeAndMedia = {
   /**
    * - Ensure `<audio>` elements have captions
-   * - `<audio>` elements must have a captions track ([url](https://dequeuniversity.com/rules/axe/4.10/audio-caption?application=axeAPI))
+   * - `<audio>` elements must have a captions track ([url](https://dequeuniversity.com/rules/axe/4.12/audio-caption?application=axeAPI))
    */
   audioCaption: "audio-caption",
   /**
    * - Ensure `<blink>` elements are not used
-   * - `<blink>` elements are deprecated and must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/blink?application=axeAPI))
+   * - `<blink>` elements are deprecated and must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/blink?application=axeAPI))
    */
   blink: "blink",
   /**
    * - Ensure `<meta http-equiv="refresh">` is not used for delayed refresh
-   * - Delayed refresh must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/meta-refresh-no-exceptions?application=axeAPI))
+   * - Delayed refresh must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/meta-refresh-no-exceptions?application=axeAPI))
    */
   metaRefreshNoExceptions: "meta-refresh-no-exceptions",
   /**
    * - Ensure `<meta http-equiv="refresh">` is not used for delayed refresh
-   * - Delayed refresh under 20 hours must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/meta-refresh?application=axeAPI))
+   * - Delayed refresh under 20 hours must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/meta-refresh?application=axeAPI))
    */
   metaRefresh: "meta-refresh",
   /**
    * - Ensure `<video>` or `<audio>` elements do not autoplay audio for more than 3 seconds without a control mechanism to stop or mute the audio
-   * - `<video>` or `<audio>` elements must not play automatically ([url](https://dequeuniversity.com/rules/axe/4.10/no-autoplay-audio?application=axeAPI))
+   * - `<video>` or `<audio>` elements must not play automatically ([url](https://dequeuniversity.com/rules/axe/4.12/no-autoplay-audio?application=axeAPI))
    */
   noAutoplayAudio: "no-autoplay-audio",
 } as const;
@@ -301,27 +306,27 @@ export const timeAndMedia = {
 export const forms = {
   /**
    * - Ensure the autocomplete attribute is correct and suitable for the form field
-   * - autocomplete attribute must be used correctly ([url](https://dequeuniversity.com/rules/axe/4.10/autocomplete-valid?application=axeAPI))
+   * - autocomplete attribute must be used correctly ([url](https://dequeuniversity.com/rules/axe/4.12/autocomplete-valid?application=axeAPI))
    */
   autocompleteValid: "autocomplete-valid",
   /**
    * - Ensure form field does not have multiple label elements
-   * - Form field must not have multiple label elements ([url](https://dequeuniversity.com/rules/axe/4.10/form-field-multiple-labels?application=axeAPI))
+   * - Form field must not have multiple label elements ([url](https://dequeuniversity.com/rules/axe/4.12/form-field-multiple-labels?application=axeAPI))
    */
   formFieldMultipleLabels: "form-field-multiple-labels",
   /**
    * - Ensure that every form element has a visible label and is not solely labeled using hidden labels, or the title or aria-describedby attributes
-   * - Form elements should have a visible label ([url](https://dequeuniversity.com/rules/axe/4.10/label-title-only?application=axeAPI))
+   * - Form elements should have a visible label ([url](https://dequeuniversity.com/rules/axe/4.12/label-title-only?application=axeAPI))
    */
   labelTitleOnly: "label-title-only",
   /**
    * - Ensure every form element has a label
-   * - Form elements must have labels ([url](https://dequeuniversity.com/rules/axe/4.10/label?application=axeAPI))
+   * - Form elements must have labels ([url](https://dequeuniversity.com/rules/axe/4.12/label?application=axeAPI))
    */
   label: "label",
   /**
    * - Ensure select element has an accessible name
-   * - Select element must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/select-name?application=axeAPI))
+   * - Select element must have an accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/select-name?application=axeAPI))
    */
   selectName: "select-name",
 } as const;
@@ -329,42 +334,42 @@ export const forms = {
 export const structure = {
   /**
    * - Ensure that text spacing set through style attributes can be adjusted with custom stylesheets
-   * - Inline text spacing must be adjustable with custom stylesheets ([url](https://dequeuniversity.com/rules/axe/4.10/avoid-inline-spacing?application=axeAPI))
+   * - Inline text spacing must be adjustable with custom stylesheets ([url](https://dequeuniversity.com/rules/axe/4.12/avoid-inline-spacing?application=axeAPI))
    */
   avoidInlineSpacing: "avoid-inline-spacing",
   /**
    * - Ensure content is not locked to any specific display orientation, and the content is operable in all display orientations
-   * - CSS Media queries must not lock display orientation ([url](https://dequeuniversity.com/rules/axe/4.10/css-orientation-lock?application=axeAPI))
+   * - CSS Media queries must not lock display orientation ([url](https://dequeuniversity.com/rules/axe/4.12/css-orientation-lock?application=axeAPI))
    */
   cssOrientationLock: "css-orientation-lock",
   /**
    * - Ensure `<dl>` elements are structured correctly
-   * - `<dl>` elements must only directly contain properly-ordered `<dt>` and `<dd>` groups, `<script>`, `<template>` or `<div>` elements ([url](https://dequeuniversity.com/rules/axe/4.10/definition-list?application=axeAPI))
+   * - `<dl>` elements must only directly contain properly-ordered `<dt>` and `<dd>` groups, `<script>`, `<template>` or `<div>` elements ([url](https://dequeuniversity.com/rules/axe/4.12/definition-list?application=axeAPI))
    */
   definitionList: "definition-list",
   /**
    * - Ensure `<dt>` and `<dd>` elements are contained by a `<dl>`
-   * - `<dt>` and `<dd>` elements must be contained by a `<dl>` ([url](https://dequeuniversity.com/rules/axe/4.10/dlitem?application=axeAPI))
+   * - `<dt>` and `<dd>` elements must be contained by a `<dl>` ([url](https://dequeuniversity.com/rules/axe/4.12/dlitem?application=axeAPI))
    */
   dlitem: "dlitem",
   /**
    * - Ensure `<iframe>` and `<frame>` elements contain the axe-core script
-   * - Frames should be tested with axe-core ([url](https://dequeuniversity.com/rules/axe/4.10/frame-tested?application=axeAPI))
+   * - Frames should be tested with axe-core ([url](https://dequeuniversity.com/rules/axe/4.12/frame-tested?application=axeAPI))
    */
   frameTested: "frame-tested",
   /**
-   * - Informs users about hidden content.
-   * - Hidden content on the page should be analyzed ([url](https://dequeuniversity.com/rules/axe/4.10/hidden-content?application=axeAPI))
+   * - Inform users about hidden content.
+   * - Hidden content on the page should be analyzed ([url](https://dequeuniversity.com/rules/axe/4.12/hidden-content?application=axeAPI))
    */
   hiddenContent: "hidden-content",
   /**
    * - Ensure that lists are structured correctly
-   * - `<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements ([url](https://dequeuniversity.com/rules/axe/4.10/list?application=axeAPI))
+   * - `<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements ([url](https://dequeuniversity.com/rules/axe/4.12/list?application=axeAPI))
    */
   list: "list",
   /**
    * - Ensure `<li>` elements are used semantically
-   * - `<li>` elements must be contained in a `<ul>` or `<ol>` ([url](https://dequeuniversity.com/rules/axe/4.10/listitem?application=axeAPI))
+   * - `<li>` elements must be contained in a `<ul>` or `<ol>` ([url](https://dequeuniversity.com/rules/axe/4.12/listitem?application=axeAPI))
    */
   listitem: "listitem",
 } as const;
@@ -372,17 +377,17 @@ export const structure = {
 export const color = {
   /**
    * - Ensure the contrast between foreground and background colors meets WCAG 2 AAA enhanced contrast ratio thresholds
-   * - Elements must meet enhanced color contrast ratio thresholds ([url](https://dequeuniversity.com/rules/axe/4.10/color-contrast-enhanced?application=axeAPI))
+   * - Elements must meet enhanced color contrast ratio thresholds ([url](https://dequeuniversity.com/rules/axe/4.12/color-contrast-enhanced?application=axeAPI))
    */
   colorContrastEnhanced: "color-contrast-enhanced",
   /**
    * - Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
-   * - Elements must meet minimum color contrast ratio thresholds ([url](https://dequeuniversity.com/rules/axe/4.10/color-contrast?application=axeAPI))
+   * - Elements must meet minimum color contrast ratio thresholds ([url](https://dequeuniversity.com/rules/axe/4.12/color-contrast?application=axeAPI))
    */
   colorContrast: "color-contrast",
   /**
    * - Ensure links are distinguished from surrounding text in a way that does not rely on color
-   * - Links must be distinguishable without relying on color ([url](https://dequeuniversity.com/rules/axe/4.10/link-in-text-block?application=axeAPI))
+   * - Links must be distinguishable without relying on color ([url](https://dequeuniversity.com/rules/axe/4.12/link-in-text-block?application=axeAPI))
    */
   linkInTextBlock: "link-in-text-block",
 } as const;
@@ -390,22 +395,22 @@ export const color = {
 export const parsing = {
   /**
    * - Ensure every id attribute value of active elements is unique
-   * - IDs of active elements must be unique ([url](https://dequeuniversity.com/rules/axe/4.10/duplicate-id-active?application=axeAPI))
+   * - IDs of active elements must be unique ([url](https://dequeuniversity.com/rules/axe/4.12/duplicate-id-active?application=axeAPI))
    */
   duplicateIdActive: "duplicate-id-active",
   /**
    * - Ensure every id attribute value used in ARIA and in labels is unique
-   * - IDs used in ARIA and labels must be unique ([url](https://dequeuniversity.com/rules/axe/4.10/duplicate-id-aria?application=axeAPI))
+   * - IDs used in ARIA and labels must be unique ([url](https://dequeuniversity.com/rules/axe/4.12/duplicate-id-aria?application=axeAPI))
    */
   duplicateIdAria: "duplicate-id-aria",
   /**
    * - Ensure every id attribute value is unique
-   * - id attribute value must be unique ([url](https://dequeuniversity.com/rules/axe/4.10/duplicate-id?application=axeAPI))
+   * - id attribute value must be unique ([url](https://dequeuniversity.com/rules/axe/4.12/duplicate-id?application=axeAPI))
    */
   duplicateId: "duplicate-id",
   /**
    * - Ensure `<marquee>` elements are not used
-   * - `<marquee>` elements are deprecated and must not be used ([url](https://dequeuniversity.com/rules/axe/4.10/marquee?application=axeAPI))
+   * - `<marquee>` elements are deprecated and must not be used ([url](https://dequeuniversity.com/rules/axe/4.12/marquee?application=axeAPI))
    */
   marquee: "marquee",
 } as const;
@@ -413,72 +418,72 @@ export const parsing = {
 export const semantics = {
   /**
    * - Ensure the order of headings is semantically correct
-   * - Heading levels should only increase by one ([url](https://dequeuniversity.com/rules/axe/4.10/heading-order?application=axeAPI))
+   * - Heading levels should only increase by one ([url](https://dequeuniversity.com/rules/axe/4.12/heading-order?application=axeAPI))
    */
   headingOrder: "heading-order",
   /**
    * - Ensure that links with the same accessible name serve a similar purpose
-   * - Links with the same name must have a similar purpose ([url](https://dequeuniversity.com/rules/axe/4.10/identical-links-same-purpose?application=axeAPI))
+   * - Links with the same name must have a similar purpose ([url](https://dequeuniversity.com/rules/axe/4.12/identical-links-same-purpose?application=axeAPI))
    */
   identicalLinksSamePurpose: "identical-links-same-purpose",
   /**
    * - Ensure that elements labelled through their content must have their visible text as part of their accessible name
-   * - Elements must have their visible text as part of their accessible name ([url](https://dequeuniversity.com/rules/axe/4.10/label-content-name-mismatch?application=axeAPI))
+   * - Elements must have their visible text as part of their accessible name ([url](https://dequeuniversity.com/rules/axe/4.12/label-content-name-mismatch?application=axeAPI))
    */
   labelContentNameMismatch: "label-content-name-mismatch",
   /**
    * - Ensure the banner landmark is at top level
-   * - Banner landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-banner-is-top-level?application=axeAPI))
+   * - Banner landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-banner-is-top-level?application=axeAPI))
    */
   landmarkBannerIsTopLevel: "landmark-banner-is-top-level",
   /**
    * - Ensure the complementary landmark or aside is at top level
-   * - Aside should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-complementary-is-top-level?application=axeAPI))
+   * - Aside should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-complementary-is-top-level?application=axeAPI))
    */
   landmarkComplementaryIsTopLevel: "landmark-complementary-is-top-level",
   /**
    * - Ensure the contentinfo landmark is at top level
-   * - Contentinfo landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-contentinfo-is-top-level?application=axeAPI))
+   * - Contentinfo landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-contentinfo-is-top-level?application=axeAPI))
    */
   landmarkContentinfoIsTopLevel: "landmark-contentinfo-is-top-level",
   /**
    * - Ensure the main landmark is at top level
-   * - Main landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-main-is-top-level?application=axeAPI))
+   * - Main landmark should not be contained in another landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-main-is-top-level?application=axeAPI))
    */
   landmarkMainIsTopLevel: "landmark-main-is-top-level",
   /**
    * - Ensure the document has at most one banner landmark
-   * - Document should not have more than one banner landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-no-duplicate-banner?application=axeAPI))
+   * - Document should not have more than one banner landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-no-duplicate-banner?application=axeAPI))
    */
   landmarkNoDuplicateBanner: "landmark-no-duplicate-banner",
   /**
    * - Ensure the document has at most one contentinfo landmark
-   * - Document should not have more than one contentinfo landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-no-duplicate-contentinfo?application=axeAPI))
+   * - Document should not have more than one contentinfo landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-no-duplicate-contentinfo?application=axeAPI))
    */
   landmarkNoDuplicateContentinfo: "landmark-no-duplicate-contentinfo",
   /**
    * - Ensure the document has at most one main landmark
-   * - Document should not have more than one main landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-no-duplicate-main?application=axeAPI))
+   * - Document should not have more than one main landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-no-duplicate-main?application=axeAPI))
    */
   landmarkNoDuplicateMain: "landmark-no-duplicate-main",
   /**
    * - Ensure the document has a main landmark
-   * - Document should have one main landmark ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-one-main?application=axeAPI))
+   * - Document should have one main landmark ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-one-main?application=axeAPI))
    */
   landmarkOneMain: "landmark-one-main",
   /**
    * - Ensure landmarks are unique
-   * - Landmarks should have a unique role or role/label/title (i.e. accessible name) combination ([url](https://dequeuniversity.com/rules/axe/4.10/landmark-unique?application=axeAPI))
+   * - Landmarks should have a unique role or role/label/title (i.e. accessible name) combination ([url](https://dequeuniversity.com/rules/axe/4.12/landmark-unique?application=axeAPI))
    */
   landmarkUnique: "landmark-unique",
   /**
    * - Ensure bold, italic text and font-size is not used to style `<p>` elements as a heading
-   * - Styled `<p>` elements must not be used as headings ([url](https://dequeuniversity.com/rules/axe/4.10/p-as-heading?application=axeAPI))
+   * - Styled `<p>` elements must not be used as headings ([url](https://dequeuniversity.com/rules/axe/4.12/p-as-heading?application=axeAPI))
    */
   pAsHeading: "p-as-heading",
   /**
    * - Ensure that the page, or at least one of its frames contains a level-one heading
-   * - Page should contain a level-one heading ([url](https://dequeuniversity.com/rules/axe/4.10/page-has-heading-one?application=axeAPI))
+   * - Page should contain a level-one heading ([url](https://dequeuniversity.com/rules/axe/4.12/page-has-heading-one?application=axeAPI))
    */
   pageHasHeadingOne: "page-has-heading-one",
 } as const;
@@ -486,22 +491,22 @@ export const semantics = {
 export const language = {
   /**
    * - Ensure every HTML document has a lang attribute
-   * - `<html>` element must have a lang attribute ([url](https://dequeuniversity.com/rules/axe/4.10/html-has-lang?application=axeAPI))
+   * - `<html>` element must have a lang attribute ([url](https://dequeuniversity.com/rules/axe/4.12/html-has-lang?application=axeAPI))
    */
   htmlHasLang: "html-has-lang",
   /**
    * - Ensure the lang attribute of the `<html>` element has a valid value
-   * - `<html>` element must have a valid value for the lang attribute ([url](https://dequeuniversity.com/rules/axe/4.10/html-lang-valid?application=axeAPI))
+   * - `<html>` element must have a valid value for the lang attribute ([url](https://dequeuniversity.com/rules/axe/4.12/html-lang-valid?application=axeAPI))
    */
   htmlLangValid: "html-lang-valid",
   /**
    * - Ensure that HTML elements with both valid lang and xml:lang attributes agree on the base language of the page
-   * - HTML elements with lang and xml:lang must have the same base language ([url](https://dequeuniversity.com/rules/axe/4.10/html-xml-lang-mismatch?application=axeAPI))
+   * - HTML elements with lang and xml:lang must have the same base language ([url](https://dequeuniversity.com/rules/axe/4.12/html-xml-lang-mismatch?application=axeAPI))
    */
   htmlXmlLangMismatch: "html-xml-lang-mismatch",
   /**
    * - Ensure lang attributes have valid values
-   * - lang attribute must have a valid value ([url](https://dequeuniversity.com/rules/axe/4.10/valid-lang?application=axeAPI))
+   * - lang attribute must have a valid value ([url](https://dequeuniversity.com/rules/axe/4.12/valid-lang?application=axeAPI))
    */
   validLang: "valid-lang",
 } as const;
@@ -509,17 +514,17 @@ export const language = {
 export const sensoryAndVisualCues = {
   /**
    * - Ensure `<meta name="viewport">` can scale a significant amount
-   * - Users should be able to zoom and scale the text up to 500% ([url](https://dequeuniversity.com/rules/axe/4.10/meta-viewport-large?application=axeAPI))
+   * - Users should be able to zoom and scale the text up to 500% ([url](https://dequeuniversity.com/rules/axe/4.12/meta-viewport-large?application=axeAPI))
    */
   metaViewportLarge: "meta-viewport-large",
   /**
    * - Ensure `<meta name="viewport">` does not disable text scaling and zooming
-   * - Zooming and scaling must not be disabled ([url](https://dequeuniversity.com/rules/axe/4.10/meta-viewport?application=axeAPI))
+   * - Zooming and scaling must not be disabled ([url](https://dequeuniversity.com/rules/axe/4.12/meta-viewport?application=axeAPI))
    */
   metaViewport: "meta-viewport",
   /**
    * - Ensure touch targets have sufficient size and space
-   * - All touch targets must be 24px large, or leave sufficient space ([url](https://dequeuniversity.com/rules/axe/4.10/target-size?application=axeAPI))
+   * - All touch targets must be 24px large, or leave sufficient space ([url](https://dequeuniversity.com/rules/axe/4.12/target-size?application=axeAPI))
    */
   targetSize: "target-size",
 } as const;
@@ -527,32 +532,32 @@ export const sensoryAndVisualCues = {
 export const tables = {
   /**
    * - Ensure the scope attribute is used correctly on tables
-   * - scope attribute should be used correctly ([url](https://dequeuniversity.com/rules/axe/4.10/scope-attr-valid?application=axeAPI))
+   * - scope attribute should be used correctly ([url](https://dequeuniversity.com/rules/axe/4.12/scope-attr-valid?application=axeAPI))
    */
   scopeAttrValid: "scope-attr-valid",
   /**
    * - Ensure the `<caption>` element does not contain the same text as the summary attribute
-   * - Tables should not have the same summary and caption ([url](https://dequeuniversity.com/rules/axe/4.10/table-duplicate-name?application=axeAPI))
+   * - Tables should not have the same summary and caption ([url](https://dequeuniversity.com/rules/axe/4.12/table-duplicate-name?application=axeAPI))
    */
   tableDuplicateName: "table-duplicate-name",
   /**
    * - Ensure that tables with a caption use the `<caption>` element.
-   * - Data or header cells must not be used to give caption to a data table. ([url](https://dequeuniversity.com/rules/axe/4.10/table-fake-caption?application=axeAPI))
+   * - Data or header cells must not be used to give caption to a data table. ([url](https://dequeuniversity.com/rules/axe/4.12/table-fake-caption?application=axeAPI))
    */
   tableFakeCaption: "table-fake-caption",
   /**
    * - Ensure that each non-empty data cell in a `<table>` larger than 3 by 3  has one or more table headers
-   * - Non-empty `<td>` elements in larger `<table>` must have an associated table header ([url](https://dequeuniversity.com/rules/axe/4.10/td-has-header?application=axeAPI))
+   * - Non-empty `<td>` elements in larger `<table>` must have an associated table header ([url](https://dequeuniversity.com/rules/axe/4.12/td-has-header?application=axeAPI))
    */
   tdHasHeader: "td-has-header",
   /**
-   * - Ensure that each cell in a table that uses the headers attribute refers only to other cells in that table
-   * - Table cells that use the headers attribute must only refer to cells in the same table ([url](https://dequeuniversity.com/rules/axe/4.10/td-headers-attr?application=axeAPI))
+   * - Ensure that each cell in a table that uses the headers attribute refers only to other `<th>` elements in that table
+   * - Table cell headers attributes must refer to other `<th>` elements in the same table ([url](https://dequeuniversity.com/rules/axe/4.12/td-headers-attr?application=axeAPI))
    */
   tdHeadersAttr: "td-headers-attr",
   /**
    * - Ensure that `<th>` elements and elements with role=columnheader/rowheader have data cells they describe
-   * - Table headers in a data table must refer to data cells ([url](https://dequeuniversity.com/rules/axe/4.10/th-has-data-cells?application=axeAPI))
+   * - Table headers in a data table must refer to data cells ([url](https://dequeuniversity.com/rules/axe/4.12/th-has-data-cells?application=axeAPI))
    */
   thHasDataCells: "th-has-data-cells",
 } as const;
diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index a8fde78b..937a360d 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -30,28 +30,16 @@ export interface Exceptions {
    * against axe-core 4.12's checks — re-verify on axe upgrades
    */
   requiresKnownParent?: true | "div-wrapped";
+  /**
+   * Exclude unless the file renders a complete document (authored `<html>`)
+   * whose extraction is exact, with nothing dynamic anywhere
+   */
+  requiresFullDocument?: boolean;
 }
 
 type Blacklist =
   // Explicitly blacklisted for Marko Language Server
   | typeof r.structure.frameTested
-  // Requires context that may live in an *ancestor* template we can't see
-  // (unlike listitem/dlitem, which only consult the known direct parent chain)
-  | typeof r.aria.ariaRequiredParent
-  | typeof r.forms.label
-  | typeof r.forms.labelTitleOnly
-  | typeof r.forms.selectName
-  | typeof r.keyboard.bypass
-  | typeof r.keyboard.nestedInteractive
-  | typeof r.keyboard.region
-  | typeof r.semantics.headingOrder
-  | typeof r.semantics.landmarkBannerIsTopLevel
-  | typeof r.semantics.landmarkComplementaryIsTopLevel
-  | typeof r.semantics.landmarkContentinfoIsTopLevel
-  | typeof r.semantics.landmarkMainIsTopLevel
-  | typeof r.semantics.landmarkOneMain
-  | typeof r.semantics.pageHasHeadingOne
-  | typeof r.tables.tdHeadersAttr
   // Seemingly broken in axe-core or JSDom
   | typeof r.aria.ariaRoledescription
   | typeof r.aria.ariaValidAttr
@@ -82,6 +70,7 @@ type Whitelist = Exclude<RuleId, Blacklist>;
 const unknownBody = true;
 const attrSpread = true;
 const conditionalContent = true;
+const requiresFullDocument = true;
 
 export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.ariaAllowedRole]: { dynamicAttrs: ["role"] },
@@ -97,7 +86,9 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.ariaProhibitedAttr]: { dynamicAttrs: ["role"] },
   [r.aria.ariaRequiredAttr]: { attrSpread },
   [r.aria.ariaRequiredChildren]: { unknownBody },
+  [r.aria.ariaRequiredParent]: { requiresFullDocument },
   [r.aria.ariaRoles]: { dynamicAttrs: ["role"] },
+  [r.aria.ariaTabName]: { unknownBody, attrSpread },
   [r.aria.ariaText]: { unknownBody },
   [r.aria.ariaToggleFieldName]: { unknownBody, attrSpread },
   [r.aria.ariaTooltipName]: { unknownBody, attrSpread },
@@ -105,8 +96,14 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.presentationRoleConflict]: {},
   [r.forms.autocompleteValid]: {},
   [r.forms.formFieldMultipleLabels]: {},
+  [r.forms.label]: { requiresFullDocument },
+  [r.forms.labelTitleOnly]: { requiresFullDocument },
+  [r.forms.selectName]: { requiresFullDocument },
   [r.keyboard.accesskeys]: { conditionalContent },
+  [r.keyboard.bypass]: { requiresFullDocument },
   [r.keyboard.frameFocusableContent]: { unknownBody },
+  [r.keyboard.nestedInteractive]: { requiresFullDocument },
+  [r.keyboard.region]: { requiresFullDocument },
   [r.keyboard.skipLink]: { unknownBody },
   [r.keyboard.tabindex]: {},
   [r.language.htmlHasLang]: { attrSpread },
@@ -124,11 +121,18 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.nameRoleValue.linkName]: { unknownBody, attrSpread },
   [r.nameRoleValue.summaryName]: { unknownBody, attrSpread },
   [r.parsing.marquee]: {},
+  [r.semantics.headingOrder]: { requiresFullDocument },
   [r.semantics.identicalLinksSamePurpose]: { conditionalContent },
+  [r.semantics.landmarkBannerIsTopLevel]: { requiresFullDocument },
+  [r.semantics.landmarkComplementaryIsTopLevel]: { requiresFullDocument },
+  [r.semantics.landmarkContentinfoIsTopLevel]: { requiresFullDocument },
+  [r.semantics.landmarkMainIsTopLevel]: { requiresFullDocument },
   [r.semantics.landmarkNoDuplicateBanner]: { conditionalContent },
   [r.semantics.landmarkNoDuplicateContentinfo]: { conditionalContent },
   [r.semantics.landmarkNoDuplicateMain]: { conditionalContent },
   [r.semantics.landmarkUnique]: { conditionalContent },
+  [r.semantics.landmarkOneMain]: { requiresFullDocument },
+  [r.semantics.pageHasHeadingOne]: { requiresFullDocument },
   [r.sensoryAndVisualCues.metaViewport]: {},
   [r.sensoryAndVisualCues.metaViewportLarge]: {},
   [r.structure.definitionList]: { unknownBody },
@@ -145,6 +149,7 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   },
   [r.tables.scopeAttrValid]: {},
   [r.tables.tableDuplicateName]: { unknownBody },
+  [r.tables.tdHeadersAttr]: { requiresFullDocument },
   [r.tables.thHasDataCells]: { unknownBody },
   [r.textAlternatives.areaAlt]: { attrSpread },
   [r.textAlternatives.documentTitle]: { unknownBody },
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 64be2328..7b5d7049 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -59,12 +59,14 @@ const HTMLService: Partial<Plugin> = {
     },
   },
   async doValidate(doc) {
-    const { extracted, nodeDetails, inlineRegions } = extract(doc);
+    const extraction = extract(doc);
+    const { extracted, nodeDetails, inlineRegions } = extraction;
 
     const jsdom = new JSDOM(extracted.toString(), {
       includeNodeLocations: true,
     });
     const { documentElement } = jsdom.window.document;
+    const exactDocument = isExactFullDocument(extraction, documentElement);
 
     const getViolationNodes = async (runOnly: string[]) =>
       (
@@ -105,8 +107,9 @@ const HTMLService: Partial<Plugin> = {
       }
 
       if (
-        exceptions.requiresKnownParent &&
-        !hasKnownParent(element, exceptions.requiresKnownParent, nodeDetails)
+        (exceptions.requiresFullDocument && !exactDocument) ||
+        (exceptions.requiresKnownParent &&
+          !hasKnownParent(element, exceptions.requiresKnownParent, nodeDetails))
       ) {
         return [];
       }
@@ -217,16 +220,20 @@ function getSkeleton(
   if (skeletonCache.has(file.parsed)) return skeletonCache.get(file.parsed);
   skeletonCache.set(file.parsed, undefined);
 
-  const { extracted, nodeDetails, uncertain, bodySlots, rootIds } = extractHTML(
-    file.parsed,
-    {
-      nodeIdPrefix: getNodeIdPrefix(template),
-      trackBodySlot: true,
-      resolveChild: createChildResolver(file, new Set(stack).add(template), {
-        remaining: MAX_INLINE_BYTES,
-      }),
-    },
-  );
+  const {
+    extracted,
+    nodeDetails,
+    uncertain,
+    hasPlaceholders,
+    bodySlots,
+    rootIds,
+  } = extractHTML(file.parsed, {
+    nodeIdPrefix: getNodeIdPrefix(template),
+    trackBodySlot: true,
+    resolveChild: createChildResolver(file, new Set(stack).add(template), {
+      remaining: MAX_INLINE_BYTES,
+    }),
+  });
 
   const html = extracted.toString();
   let skeleton: InlineChildTemplate | undefined;
@@ -239,6 +246,7 @@ function getSkeleton(
       bodySlotDepth: slot?.depth ?? 0,
       bodySlotConditional: slot?.inConditional ?? false,
       uncertain,
+      hasPlaceholders,
       nodeDetails,
       rootIds,
     };
@@ -248,6 +256,20 @@ function getSkeleton(
   return skeleton;
 }
 
+// The extraction is exact when the file renders a whole document (an authored
+// `<html>`) containing nothing dynamic; page-scoped rules can then run safely.
+function isExactFullDocument(extraction: Extraction, documentElement: Element) {
+  return (
+    !extraction.uncertain &&
+    !extraction.hasPlaceholders &&
+    (documentElement as HTMLElement).dataset.markoNodeId !== undefined &&
+    !extraction.extracted.toString().includes('="dynamic"') &&
+    Object.values(extraction.nodeDetails).every(
+      (details) => !details.hasDynamicAttrs,
+    )
+  );
+}
+
 function innermostRegionAt(regions: InlineRegion[], offset: number) {
   let match: InlineRegion | undefined;
   for (const region of regions) {
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index ac9dffcb..97a0d74e 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -30,6 +30,7 @@ export interface InlineChildTemplate {
   bodySlotDepth: number;
   bodySlotConditional: boolean;
   uncertain: boolean;
+  hasPlaceholders: boolean;
   nodeDetails: Record<string, HTMLNodeDetails>;
   rootIds: string[];
 }
@@ -67,6 +68,7 @@ class HTMLExtractor {
   #rootIds: string[];
   #bodySlots: HTMLBodySlot[];
   #inlineRegions: InlineRegion[];
+  #hasPlaceholders: boolean;
 
   constructor(parsed: Parsed, options: ExtractHTMLOptions) {
     this.#extractor = new Extractor(parsed);
@@ -80,6 +82,7 @@ class HTMLExtractor {
     this.#rootIds = [];
     this.#bodySlots = [];
     this.#inlineRegions = [];
+    this.#hasPlaceholders = false;
     parsed.program.body.forEach((node) => {
       if (this.#visitNode(node)) this.#uncertain = true;
     });
@@ -93,6 +96,7 @@ class HTMLExtractor {
       bodySlots: this.#bodySlots,
       inlineRegions: this.#inlineRegions,
       rootIds: this.#rootIds,
+      hasPlaceholders: this.#hasPlaceholders,
     };
   }
 
@@ -142,6 +146,7 @@ class HTMLExtractor {
         this.#extractor.copy(node);
         break;
       case NodeType.Placeholder:
+        this.#hasPlaceholders = true;
         isDynamic =
           this.#read({
             start: node.start + 1,
@@ -199,6 +204,7 @@ class HTMLExtractor {
 
   #inlineChild(node: Node.Tag, child: InlineChildTemplate): boolean {
     const start = this.#extractor.length;
+    if (child.hasPlaceholders) this.#hasPlaceholders = true;
     if (this.#domDepth === 0) this.#rootIds.push(...child.rootIds);
     Object.assign(this.#nodeDetails, child.nodeDetails);
 
@@ -238,6 +244,7 @@ class HTMLExtractor {
     this.#extractor.copy(isEmptyRange(node.name) ? node.nameText : node.name);
 
     this.#extractor.write(` data-marko-node-id="${id}"`);
+    this.#writeShorthands(node);
     // [node attributes]
     node.attrs?.forEach((attr) => {
       if (attr.type === NodeType.AttrNamed) this.#writeAttrNamed(attr);
@@ -258,6 +265,38 @@ class HTMLExtractor {
     return { hasDynamicAttrs, hasDynamicBody };
   }
 
+  #writeShorthands(node: Node.Tag) {
+    const { shorthandId, shorthandClassNames } = node;
+    if (shorthandId) {
+      this.#extractor.write(' id="');
+      if (shorthandId.expressions.length) {
+        this.#extractor.write("dynamic");
+      } else {
+        this.#extractor.copy({
+          start: shorthandId.start + 1,
+          end: shorthandId.end,
+        });
+      }
+      this.#extractor.write('"');
+    }
+
+    if (shorthandClassNames) {
+      this.#extractor.write(' class="');
+      shorthandClassNames.forEach((shorthandClass, i) => {
+        if (i) this.#extractor.write(" ");
+        if (shorthandClass.expressions.length) {
+          this.#extractor.write("dynamic");
+        } else {
+          this.#extractor.copy({
+            start: shorthandClass.start + 1,
+            end: shorthandClass.end,
+          });
+        }
+      });
+      this.#extractor.write('"');
+    }
+  }
+
   #writeAttrNamed(attr: Node.AttrNamed) {
     this.#extractor.write(" ");
     const nameString = this.#read(attr.name);

From a8ced57903ab07826c7062244515aa4de3e0a892 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:45:08 +0000
Subject: [PATCH 09/19] Merge into a single changeset

---
 .changeset/plenty-pages-audit.md  | 6 ------
 .changeset/spotty-moons-repeat.md | 2 +-
 2 files changed, 1 insertion(+), 7 deletions(-)
 delete mode 100644 .changeset/plenty-pages-audit.md

diff --git a/.changeset/plenty-pages-audit.md b/.changeset/plenty-pages-audit.md
deleted file mode 100644
index fc93d2ea..00000000
--- a/.changeset/plenty-pages-audit.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@marko/language-tools": minor
-"@marko/language-server": minor
----
-
-Enable page-scoped accessibility rules for fully static documents.
diff --git a/.changeset/spotty-moons-repeat.md b/.changeset/spotty-moons-repeat.md
index df997750..0a17d6d1 100644
--- a/.changeset/spotty-moons-repeat.md
+++ b/.changeset/spotty-moons-repeat.md
@@ -3,4 +3,4 @@
 "@marko/language-server": minor
 ---
 
-Take child templates into account in the accessibility linter.
+Take child templates into account in the accessibility linter, and enable page-scoped rules for fully static documents.

From 72f9350cee34f92fbadc4a4b07b4ae1133d047dd Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:53:00 +0000
Subject: [PATCH 10/19] Downgrade quoted attribute values containing a raw
 quote
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A single-quoted (or escape-containing) attribute value with an embedded
double quote was copied verbatim between double quotes, garbling the
generated attribute — which the new full-document exactness gate would
then wrongly trust. Such values now extract as "dynamic", which both
keeps the attribute well-formed and blocks the gate. Also drops two
cspell words orphaned by earlier comment trims.
---
 cspell.json                                          |  2 --
 packages/language-tools/src/extractors/html/index.ts | 11 +++++++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/cspell.json b/cspell.json
index 0f6eb819..fcc0951c 100644
--- a/cspell.json
+++ b/cspell.json
@@ -5,11 +5,9 @@
     "accesskey",
     "accesskeys",
     "Berrocal",
-    "bodyless",
     "braillelabel",
     "brailleroledescription",
     "codegen",
-    "dedup",
     "Commentable",
     "contenteditable",
     "contentinfo",
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index 97a0d74e..b8d00609 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -332,14 +332,21 @@ class HTMLExtractor {
         });
         this.#extractor.write('"');
         break;
-      case AttributeValueType.QuotedString:
+      case AttributeValueType.QuotedString: {
+        const start = valueString.search(/[^=\s]/g) + 1;
+        // A raw `"` in the value would terminate the generated attribute.
+        if (valueString.slice(start, -1).includes('"')) {
+          this.#extractor.write(`="dynamic"`);
+          break;
+        }
         this.#extractor.write('="');
         this.#extractor.copy({
-          start: attr.value.start + valueString.search(/[^=\s]/g) + 1,
+          start: attr.value.start + start,
           end: attr.value.end - 1,
         });
         this.#extractor.write('"');
         break;
+      }
       case AttributeValueType.Dynamic:
         // Replace all dynamic values with the string "dynamic" with a counter instead of removing them
         // Subject to change-- axe-core might require "true" for aria attributes or something

From 3418d8b0dc88af0cc660b0028d75f132d295e7d9 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 16:58:40 +0000
Subject: [PATCH 11/19] Contain extraction knowledge inside the HTML extractor
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The language server was slicing skeleton strings at body-slot offsets
and re-deriving extraction exactness by scanning generated HTML — both
extraction-domain work. The extractor now assembles inline child
templates itself (extractChildTemplate) and reports a single `exact`
flag computed where dynamic values are written, which is also more
precise than the string scan (an authored literal "dynamic" no longer
blocks the full-document gate). The public extractHTML result shrinks
to what hosts consume: extracted, nodeDetails, inlineRegions, exact.
---
 .../language-server/src/service/html/index.ts | 52 +++---------
 .../src/extractors/html/index.ts              | 82 ++++++++++++++-----
 2 files changed, 72 insertions(+), 62 deletions(-)

diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 7b5d7049..89c8f798 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -1,4 +1,5 @@
 import {
+  extractChildTemplate,
   extractHTML,
   type InlineChildTemplate,
   type InlineRegion,
@@ -66,7 +67,10 @@ const HTMLService: Partial<Plugin> = {
       includeNodeLocations: true,
     });
     const { documentElement } = jsdom.window.document;
-    const exactDocument = isExactFullDocument(extraction, documentElement);
+    // Page-scoped rules only run when the extraction is exactly the rendered
+    // output and covers the whole document (an authored `<html>`).
+    const exactDocument =
+      extraction.exact && documentElement.dataset.markoNodeId !== undefined;
 
     const getViolationNodes = async (runOnly: string[]) =>
       (
@@ -196,8 +200,7 @@ function createChildResolver(
     const skeleton = getSkeleton(template, stack);
     if (!skeleton) return;
 
-    const size =
-      skeleton.segments[0].length + (skeleton.segments[1]?.length ?? 0);
+    const size = skeletonSize(skeleton);
     if (size > budget.remaining) return;
     budget.remaining -= size;
 
@@ -220,54 +223,21 @@ function getSkeleton(
   if (skeletonCache.has(file.parsed)) return skeletonCache.get(file.parsed);
   skeletonCache.set(file.parsed, undefined);
 
-  const {
-    extracted,
-    nodeDetails,
-    uncertain,
-    hasPlaceholders,
-    bodySlots,
-    rootIds,
-  } = extractHTML(file.parsed, {
+  const candidate = extractChildTemplate(file.parsed, {
     nodeIdPrefix: getNodeIdPrefix(template),
-    trackBodySlot: true,
     resolveChild: createChildResolver(file, new Set(stack).add(template), {
       remaining: MAX_INLINE_BYTES,
     }),
   });
-
-  const html = extracted.toString();
-  let skeleton: InlineChildTemplate | undefined;
-  if (html.length <= MAX_INLINE_BYTES) {
-    const slot = bodySlots.length === 1 ? bodySlots[0] : undefined;
-    skeleton = {
-      segments: slot
-        ? [html.slice(0, slot.offset), html.slice(slot.offset)]
-        : [html],
-      bodySlotDepth: slot?.depth ?? 0,
-      bodySlotConditional: slot?.inConditional ?? false,
-      uncertain,
-      hasPlaceholders,
-      nodeDetails,
-      rootIds,
-    };
-  }
+  const skeleton =
+    skeletonSize(candidate) <= MAX_INLINE_BYTES ? candidate : undefined;
 
   skeletonCache.set(file.parsed, skeleton);
   return skeleton;
 }
 
-// The extraction is exact when the file renders a whole document (an authored
-// `<html>`) containing nothing dynamic; page-scoped rules can then run safely.
-function isExactFullDocument(extraction: Extraction, documentElement: Element) {
-  return (
-    !extraction.uncertain &&
-    !extraction.hasPlaceholders &&
-    (documentElement as HTMLElement).dataset.markoNodeId !== undefined &&
-    !extraction.extracted.toString().includes('="dynamic"') &&
-    Object.values(extraction.nodeDetails).every(
-      (details) => !details.hasDynamicAttrs,
-    )
-  );
+function skeletonSize(skeleton: InlineChildTemplate) {
+  return skeleton.segments[0].length + (skeleton.segments[1]?.length ?? 0);
 }
 
 function innermostRegionAt(regions: InlineRegion[], offset: number) {
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index b8d00609..f4b33edd 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -18,7 +18,7 @@ export interface HTMLNodeDetails {
   inConditional: boolean;
 }
 
-export interface HTMLBodySlot {
+interface HTMLBodySlot {
   offset: number;
   depth: number;
   inConditional: boolean;
@@ -30,7 +30,8 @@ export interface InlineChildTemplate {
   bodySlotDepth: number;
   bodySlotConditional: boolean;
   uncertain: boolean;
-  hasPlaceholders: boolean;
+  /** True when the skeleton is exactly what the template renders. */
+  exact: boolean;
   nodeDetails: Record<string, HTMLNodeDetails>;
   rootIds: string[];
 }
@@ -46,14 +47,21 @@ export interface InlineRegion {
 
 export interface ExtractHTMLOptions {
   nodeIdPrefix?: string;
-  trackBodySlot?: boolean;
   resolveChild?(tagName: string): InlineChildTemplate | undefined;
 }
 
 const bodySlotReg = /^\$\{\s*input\.(?:renderBody|content)\s*\}$/;
 
 export function extractHTML(parsed: Parsed, options: ExtractHTMLOptions = {}) {
-  return new HTMLExtractor(parsed, options).end();
+  return new HTMLExtractor(parsed, options, false).end();
+}
+
+/** Extracts a template as a skeleton that can be inlined at its usage sites. */
+export function extractChildTemplate(
+  parsed: Parsed,
+  options: ExtractHTMLOptions = {},
+) {
+  return new HTMLExtractor(parsed, options, true).endChildTemplate();
 }
 
 class HTMLExtractor {
@@ -68,9 +76,14 @@ class HTMLExtractor {
   #rootIds: string[];
   #bodySlots: HTMLBodySlot[];
   #inlineRegions: InlineRegion[];
-  #hasPlaceholders: boolean;
-
-  constructor(parsed: Parsed, options: ExtractHTMLOptions) {
+  #exact: boolean;
+  #trackBodySlot: boolean;
+
+  constructor(
+    parsed: Parsed,
+    options: ExtractHTMLOptions,
+    trackBodySlot: boolean,
+  ) {
     this.#extractor = new Extractor(parsed);
     this.#read = parsed.read.bind(parsed);
     this.#options = options;
@@ -82,7 +95,8 @@ class HTMLExtractor {
     this.#rootIds = [];
     this.#bodySlots = [];
     this.#inlineRegions = [];
-    this.#hasPlaceholders = false;
+    this.#exact = true;
+    this.#trackBodySlot = trackBodySlot;
     parsed.program.body.forEach((node) => {
       if (this.#visitNode(node)) this.#uncertain = true;
     });
@@ -92,11 +106,25 @@ class HTMLExtractor {
     return {
       extracted: this.#extractor.end(),
       nodeDetails: this.#nodeDetails,
-      uncertain: this.#uncertain,
-      bodySlots: this.#bodySlots,
       inlineRegions: this.#inlineRegions,
+      /** True when the output is exactly what the template renders. */
+      exact: !this.#uncertain && this.#exact,
+    };
+  }
+
+  endChildTemplate(): InlineChildTemplate {
+    const html = this.#extractor.end().toString();
+    const slot = this.#bodySlots.length === 1 ? this.#bodySlots[0] : undefined;
+    return {
+      segments: slot
+        ? [html.slice(0, slot.offset), html.slice(slot.offset)]
+        : [html],
+      bodySlotDepth: slot?.depth ?? 0,
+      bodySlotConditional: slot?.inConditional ?? false,
+      uncertain: this.#uncertain,
+      exact: !this.#uncertain && this.#exact,
+      nodeDetails: this.#nodeDetails,
       rootIds: this.#rootIds,
-      hasPlaceholders: this.#hasPlaceholders,
     };
   }
 
@@ -146,7 +174,8 @@ class HTMLExtractor {
         this.#extractor.copy(node);
         break;
       case NodeType.Placeholder:
-        this.#hasPlaceholders = true;
+        // Placeholder text stands in for unknown (possibly empty) content.
+        this.#exact = false;
         isDynamic =
           this.#read({
             start: node.start + 1,
@@ -165,7 +194,7 @@ class HTMLExtractor {
       !node.body &&
       bodySlotReg.test(this.#read(node.name))
     ) {
-      if (this.#options.trackBodySlot) {
+      if (this.#trackBodySlot) {
         this.#bodySlots.push({
           offset: this.#extractor.length,
           depth: this.#domDepth,
@@ -204,7 +233,7 @@ class HTMLExtractor {
 
   #inlineChild(node: Node.Tag, child: InlineChildTemplate): boolean {
     const start = this.#extractor.length;
-    if (child.hasPlaceholders) this.#hasPlaceholders = true;
+    if (!child.exact) this.#exact = false;
     if (this.#domDepth === 0) this.#rootIds.push(...child.rootIds);
     Object.assign(this.#nodeDetails, child.nodeDetails);
 
@@ -248,7 +277,10 @@ class HTMLExtractor {
     // [node attributes]
     node.attrs?.forEach((attr) => {
       if (attr.type === NodeType.AttrNamed) this.#writeAttrNamed(attr);
-      else if (attr.type === NodeType.AttrSpread) hasDynamicAttrs = true;
+      else if (attr.type === NodeType.AttrSpread) {
+        hasDynamicAttrs = true;
+        this.#exact = false;
+      }
     });
     // [body or self-closing `/`]
     this.#extractor.write(">");
@@ -270,7 +302,7 @@ class HTMLExtractor {
     if (shorthandId) {
       this.#extractor.write(' id="');
       if (shorthandId.expressions.length) {
-        this.#extractor.write("dynamic");
+        this.#writeDynamic();
       } else {
         this.#extractor.copy({
           start: shorthandId.start + 1,
@@ -285,7 +317,7 @@ class HTMLExtractor {
       shorthandClassNames.forEach((shorthandClass, i) => {
         if (i) this.#extractor.write(" ");
         if (shorthandClass.expressions.length) {
-          this.#extractor.write("dynamic");
+          this.#writeDynamic();
         } else {
           this.#extractor.copy({
             start: shorthandClass.start + 1,
@@ -336,7 +368,9 @@ class HTMLExtractor {
         const start = valueString.search(/[^=\s]/g) + 1;
         // A raw `"` in the value would terminate the generated attribute.
         if (valueString.slice(start, -1).includes('"')) {
-          this.#extractor.write(`="dynamic"`);
+          this.#extractor.write('="');
+          this.#writeDynamic();
+          this.#extractor.write('"');
           break;
         }
         this.#extractor.write('="');
@@ -348,12 +382,18 @@ class HTMLExtractor {
         break;
       }
       case AttributeValueType.Dynamic:
-        // Replace all dynamic values with the string "dynamic" with a counter instead of removing them
-        // Subject to change-- axe-core might require "true" for aria attributes or something
-        this.#extractor.write(`="dynamic"`);
+        this.#extractor.write('="');
+        this.#writeDynamic();
+        this.#extractor.write('"');
         break;
     }
   }
+
+  /** Stands in for values only known at runtime (vs removing the attribute). */
+  #writeDynamic() {
+    this.#extractor.write("dynamic");
+    this.#exact = false;
+  }
 }
 
 function isVoidTag(tagName: string | undefined) {

From c140c404b8928c89e36be935546085d899ed0695 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 17:20:15 +0000
Subject: [PATCH 12/19] Apply code-smell probe findings

- Collapse the uncertain/exact flag pair into a single three-state
  fidelity (exact | approximate | uncertain), removing a representable
  illegal state and the confusing dual-flag computation.
- Group the body-slot metadata into an optional bodySlot object so the
  fields can't outlive the slot they describe.
- Unify the server's "skeleton" vocabulary with language-tools'
  "child template", and rename requiresFullDocument to
  requiresExactDocument to match the gate it feeds.
- Make isKnownElement a type guard (drops the parent! assertions),
  extract violation anchoring out of the doValidate callback, and
  invert the body-slot branch for a linear early return.
---
 .../service/html/axe-rules/rule-exceptions.ts |  36 ++---
 .../language-server/src/service/html/index.ts | 127 +++++++++++-------
 .../src/extractors/html/index.ts              |  70 +++++-----
 3 files changed, 131 insertions(+), 102 deletions(-)

diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index 937a360d..e6ae6705 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -32,9 +32,9 @@ export interface Exceptions {
   requiresKnownParent?: true | "div-wrapped";
   /**
    * Exclude unless the file renders a complete document (authored `<html>`)
-   * whose extraction is exact, with nothing dynamic anywhere
+   * whose extraction exactly matches rendered output
    */
-  requiresFullDocument?: boolean;
+  requiresExactDocument?: boolean;
 }
 
 type Blacklist =
@@ -70,7 +70,7 @@ type Whitelist = Exclude<RuleId, Blacklist>;
 const unknownBody = true;
 const attrSpread = true;
 const conditionalContent = true;
-const requiresFullDocument = true;
+const requiresExactDocument = true;
 
 export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.ariaAllowedRole]: { dynamicAttrs: ["role"] },
@@ -86,7 +86,7 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.ariaProhibitedAttr]: { dynamicAttrs: ["role"] },
   [r.aria.ariaRequiredAttr]: { attrSpread },
   [r.aria.ariaRequiredChildren]: { unknownBody },
-  [r.aria.ariaRequiredParent]: { requiresFullDocument },
+  [r.aria.ariaRequiredParent]: { requiresExactDocument },
   [r.aria.ariaRoles]: { dynamicAttrs: ["role"] },
   [r.aria.ariaTabName]: { unknownBody, attrSpread },
   [r.aria.ariaText]: { unknownBody },
@@ -96,14 +96,14 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.aria.presentationRoleConflict]: {},
   [r.forms.autocompleteValid]: {},
   [r.forms.formFieldMultipleLabels]: {},
-  [r.forms.label]: { requiresFullDocument },
-  [r.forms.labelTitleOnly]: { requiresFullDocument },
-  [r.forms.selectName]: { requiresFullDocument },
+  [r.forms.label]: { requiresExactDocument },
+  [r.forms.labelTitleOnly]: { requiresExactDocument },
+  [r.forms.selectName]: { requiresExactDocument },
   [r.keyboard.accesskeys]: { conditionalContent },
-  [r.keyboard.bypass]: { requiresFullDocument },
+  [r.keyboard.bypass]: { requiresExactDocument },
   [r.keyboard.frameFocusableContent]: { unknownBody },
-  [r.keyboard.nestedInteractive]: { requiresFullDocument },
-  [r.keyboard.region]: { requiresFullDocument },
+  [r.keyboard.nestedInteractive]: { requiresExactDocument },
+  [r.keyboard.region]: { requiresExactDocument },
   [r.keyboard.skipLink]: { unknownBody },
   [r.keyboard.tabindex]: {},
   [r.language.htmlHasLang]: { attrSpread },
@@ -121,18 +121,18 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.nameRoleValue.linkName]: { unknownBody, attrSpread },
   [r.nameRoleValue.summaryName]: { unknownBody, attrSpread },
   [r.parsing.marquee]: {},
-  [r.semantics.headingOrder]: { requiresFullDocument },
+  [r.semantics.headingOrder]: { requiresExactDocument },
   [r.semantics.identicalLinksSamePurpose]: { conditionalContent },
-  [r.semantics.landmarkBannerIsTopLevel]: { requiresFullDocument },
-  [r.semantics.landmarkComplementaryIsTopLevel]: { requiresFullDocument },
-  [r.semantics.landmarkContentinfoIsTopLevel]: { requiresFullDocument },
-  [r.semantics.landmarkMainIsTopLevel]: { requiresFullDocument },
+  [r.semantics.landmarkBannerIsTopLevel]: { requiresExactDocument },
+  [r.semantics.landmarkComplementaryIsTopLevel]: { requiresExactDocument },
+  [r.semantics.landmarkContentinfoIsTopLevel]: { requiresExactDocument },
+  [r.semantics.landmarkMainIsTopLevel]: { requiresExactDocument },
   [r.semantics.landmarkNoDuplicateBanner]: { conditionalContent },
   [r.semantics.landmarkNoDuplicateContentinfo]: { conditionalContent },
   [r.semantics.landmarkNoDuplicateMain]: { conditionalContent },
   [r.semantics.landmarkUnique]: { conditionalContent },
-  [r.semantics.landmarkOneMain]: { requiresFullDocument },
-  [r.semantics.pageHasHeadingOne]: { requiresFullDocument },
+  [r.semantics.landmarkOneMain]: { requiresExactDocument },
+  [r.semantics.pageHasHeadingOne]: { requiresExactDocument },
   [r.sensoryAndVisualCues.metaViewport]: {},
   [r.sensoryAndVisualCues.metaViewportLarge]: {},
   [r.structure.definitionList]: { unknownBody },
@@ -149,7 +149,7 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   },
   [r.tables.scopeAttrValid]: {},
   [r.tables.tableDuplicateName]: { unknownBody },
-  [r.tables.tdHeadersAttr]: { requiresFullDocument },
+  [r.tables.tdHeadersAttr]: { requiresExactDocument },
   [r.tables.thHasDataCells]: { unknownBody },
   [r.textAlternatives.areaAlt]: { attrSpread },
   [r.textAlternatives.documentTitle]: { unknownBody },
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 89c8f798..c7da94ca 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -27,8 +27,8 @@ const extractCache = new WeakMap<
   Parsed,
   { version: number; result: Extraction }
 >();
-let skeletonCacheVersion = -1;
-let skeletonCache = new Map<Parsed, InlineChildTemplate | undefined>();
+let childTemplateCacheVersion = -1;
+let childTemplateCache = new Map<Parsed, InlineChildTemplate | undefined>();
 
 // Path-independent so extracted output is stable across machines.
 const templatePrefixes = new Map<string, string>();
@@ -61,7 +61,7 @@ const HTMLService: Partial<Plugin> = {
   },
   async doValidate(doc) {
     const extraction = extract(doc);
-    const { extracted, nodeDetails, inlineRegions } = extraction;
+    const { extracted, nodeDetails } = extraction;
 
     const jsdom = new JSDOM(extracted.toString(), {
       includeNodeLocations: true,
@@ -70,7 +70,8 @@ const HTMLService: Partial<Plugin> = {
     // Page-scoped rules only run when the extraction is exactly the rendered
     // output and covers the whole document (an authored `<html>`).
     const exactDocument =
-      extraction.exact && documentElement.dataset.markoNodeId !== undefined;
+      extraction.fidelity === "exact" &&
+      documentElement.dataset.markoNodeId !== undefined;
 
     const getViolationNodes = async (runOnly: string[]) =>
       (
@@ -111,7 +112,7 @@ const HTMLService: Partial<Plugin> = {
       }
 
       if (
-        (exceptions.requiresFullDocument && !exactDocument) ||
+        (exceptions.requiresExactDocument && !exactDocument) ||
         (exceptions.requiresKnownParent &&
           !hasKnownParent(element, exceptions.requiresKnownParent, nodeDetails))
       ) {
@@ -121,40 +122,21 @@ const HTMLService: Partial<Plugin> = {
       const generatedLoc = jsdom.nodeLocation(element);
       if (!generatedLoc) return [];
 
-      let messagePrefix = "";
-      let sourceRange = extracted.sourceLocationAt(
-        generatedLoc.startOffset + 1,
-        generatedLoc.startOffset + 1 + element.tagName.length,
+      const anchor = anchorViolation(
+        extraction,
+        element,
+        generatedLoc.startOffset,
+        exceptions,
       );
-
-      if (!sourceRange) {
-        // Unmapped elements come from an inlined child; only its top-level
-        // elements re-anchor to the usage site.
-        const region = innermostRegionAt(
-          inlineRegions,
-          generatedLoc.startOffset,
-        );
-        if (
-          !region ||
-          !nodeId ||
-          !region.rootIds.includes(nodeId) ||
-          (exceptions.unknownBody && region.bodyUncertain) ||
-          (exceptions.conditionalContent && region.inConditional)
-        ) {
-          return [];
-        }
-
-        sourceRange = extracted.parsed.locationAt(region.tagName);
-        messagePrefix = `This tag renders a \`<${element.tagName.toLowerCase()}>\` element here — `;
-      }
+      if (!anchor) return [];
 
       return [
         {
-          range: sourceRange,
+          range: anchor.range,
           severity: 3,
           source: `axe-core(${ruleId})`,
           message:
-            messagePrefix +
+            anchor.messagePrefix +
             (result.failureSummary ?? "unknown accessibility issue"),
         },
       ];
@@ -197,18 +179,18 @@ function createChildResolver(
       return;
     }
 
-    const skeleton = getSkeleton(template, stack);
-    if (!skeleton) return;
+    const childTemplate = getChildTemplate(template, stack);
+    if (!childTemplate) return;
 
-    const size = skeletonSize(skeleton);
+    const size = childTemplateSize(childTemplate);
     if (size > budget.remaining) return;
     budget.remaining -= size;
 
-    return skeleton;
+    return childTemplate;
   };
 }
 
-function getSkeleton(
+function getChildTemplate(
   template: string,
   stack: Set<string>,
 ): InlineChildTemplate | undefined {
@@ -216,28 +198,66 @@ function getSkeleton(
   if (!doc) return;
   const file = getMarkoFile(doc);
 
-  if (skeletonCacheVersion !== projectVersion) {
-    skeletonCacheVersion = projectVersion;
-    skeletonCache = new Map();
+  if (childTemplateCacheVersion !== projectVersion) {
+    childTemplateCacheVersion = projectVersion;
+    childTemplateCache = new Map();
   }
-  if (skeletonCache.has(file.parsed)) return skeletonCache.get(file.parsed);
-  skeletonCache.set(file.parsed, undefined);
+  if (childTemplateCache.has(file.parsed))
+    return childTemplateCache.get(file.parsed);
+  childTemplateCache.set(file.parsed, undefined);
 
   const candidate = extractChildTemplate(file.parsed, {
     nodeIdPrefix: getNodeIdPrefix(template),
+    // Each cached template gets its own budget; usage sites re-check the
+    // composed size against theirs.
     resolveChild: createChildResolver(file, new Set(stack).add(template), {
       remaining: MAX_INLINE_BYTES,
     }),
   });
-  const skeleton =
-    skeletonSize(candidate) <= MAX_INLINE_BYTES ? candidate : undefined;
+  const childTemplate =
+    childTemplateSize(candidate) <= MAX_INLINE_BYTES ? candidate : undefined;
 
-  skeletonCache.set(file.parsed, skeleton);
-  return skeleton;
+  childTemplateCache.set(file.parsed, childTemplate);
+  return childTemplate;
 }
 
-function skeletonSize(skeleton: InlineChildTemplate) {
-  return skeleton.segments[0].length + (skeleton.segments[1]?.length ?? 0);
+function childTemplateSize(childTemplate: InlineChildTemplate) {
+  return (
+    childTemplate.segments[0].length + (childTemplate.segments[1]?.length ?? 0)
+  );
+}
+
+// Source anchor for a violation: the element itself when it maps into this
+// document, else the usage site of the inlined child whose root rendered it.
+function anchorViolation(
+  extraction: Extraction,
+  element: HTMLElement,
+  generatedOffset: number,
+  exceptions: Exceptions,
+) {
+  const { extracted, inlineRegions } = extraction;
+  const range = extracted.sourceLocationAt(
+    generatedOffset + 1,
+    generatedOffset + 1 + element.tagName.length,
+  );
+  if (range) return { range, messagePrefix: "" };
+
+  const region = innermostRegionAt(inlineRegions, generatedOffset);
+  const nodeId = element.dataset.markoNodeId;
+  if (
+    !region ||
+    !nodeId ||
+    !region.rootIds.includes(nodeId) ||
+    (exceptions.unknownBody && region.bodyUncertain) ||
+    (exceptions.conditionalContent && region.inConditional)
+  ) {
+    return;
+  }
+
+  return {
+    range: extracted.parsed.locationAt(region.tagName),
+    messagePrefix: `This tag renders a \`<${element.tagName.toLowerCase()}>\` element here — `,
+  };
 }
 
 function innermostRegionAt(regions: InlineRegion[], offset: number) {
@@ -265,18 +285,21 @@ function hasKnownParent(
   const parent = element.parentElement;
   if (!isKnownElement(parent, nodeDetails)) return false;
 
-  if (mode === "div-wrapped" && parent!.tagName === "DIV") {
-    const role = parent!.getAttribute("role");
+  if (mode === "div-wrapped" && parent.tagName === "DIV") {
+    const role = parent.getAttribute("role");
     if (!role || role === "presentation" || role === "none") {
       // axe looks through presentational div wrappers to the grandparent.
-      return isKnownElement(parent!.parentElement, nodeDetails);
+      return isKnownElement(parent.parentElement, nodeDetails);
     }
   }
 
   return true;
 }
 
-function isKnownElement(element: HTMLElement | null, nodeDetails: NodeDetails) {
+function isKnownElement(
+  element: HTMLElement | null,
+  nodeDetails: NodeDetails,
+): element is HTMLElement {
   if (!element) return false;
   const nodeId = element.dataset.markoNodeId;
   if (!nodeId) return false;
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index f4b33edd..49e6d429 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -24,14 +24,15 @@ interface HTMLBodySlot {
   inConditional: boolean;
 }
 
+/** How faithfully extracted HTML reflects rendered output, best to worst:
+ * exact match; right structure with stand-in values; unknown structure. */
+export type ExtractionFidelity = "exact" | "approximate" | "uncertain";
+
 export interface InlineChildTemplate {
   /** The HTML skeleton, split at the default body slot when exactly one exists. */
   segments: [string] | [string, string];
-  bodySlotDepth: number;
-  bodySlotConditional: boolean;
-  uncertain: boolean;
-  /** True when the skeleton is exactly what the template renders. */
-  exact: boolean;
+  bodySlot?: { depth: number; inConditional: boolean };
+  fidelity: ExtractionFidelity;
   nodeDetails: Record<string, HTMLNodeDetails>;
   rootIds: string[];
 }
@@ -76,7 +77,7 @@ class HTMLExtractor {
   #rootIds: string[];
   #bodySlots: HTMLBodySlot[];
   #inlineRegions: InlineRegion[];
-  #exact: boolean;
+  #approximate: boolean;
   #trackBodySlot: boolean;
 
   constructor(
@@ -95,7 +96,7 @@ class HTMLExtractor {
     this.#rootIds = [];
     this.#bodySlots = [];
     this.#inlineRegions = [];
-    this.#exact = true;
+    this.#approximate = false;
     this.#trackBodySlot = trackBodySlot;
     parsed.program.body.forEach((node) => {
       if (this.#visitNode(node)) this.#uncertain = true;
@@ -107,8 +108,7 @@ class HTMLExtractor {
       extracted: this.#extractor.end(),
       nodeDetails: this.#nodeDetails,
       inlineRegions: this.#inlineRegions,
-      /** True when the output is exactly what the template renders. */
-      exact: !this.#uncertain && this.#exact,
+      fidelity: this.#fidelity(),
     };
   }
 
@@ -119,15 +119,21 @@ class HTMLExtractor {
       segments: slot
         ? [html.slice(0, slot.offset), html.slice(slot.offset)]
         : [html],
-      bodySlotDepth: slot?.depth ?? 0,
-      bodySlotConditional: slot?.inConditional ?? false,
-      uncertain: this.#uncertain,
-      exact: !this.#uncertain && this.#exact,
+      bodySlot: slot && {
+        depth: slot.depth,
+        inConditional: slot.inConditional,
+      },
+      fidelity: this.#fidelity(),
       nodeDetails: this.#nodeDetails,
       rootIds: this.#rootIds,
     };
   }
 
+  #fidelity(): ExtractionFidelity {
+    if (this.#uncertain) return "uncertain";
+    return this.#approximate ? "approximate" : "exact";
+  }
+
   #visitNode(node: Node.ChildNode): boolean {
     let hasDynamicBody = false,
       hasDynamicAttrs = false,
@@ -175,7 +181,7 @@ class HTMLExtractor {
         break;
       case NodeType.Placeholder:
         // Placeholder text stands in for unknown (possibly empty) content.
-        this.#exact = false;
+        this.#approximate = true;
         isDynamic =
           this.#read({
             start: node.start + 1,
@@ -194,16 +200,15 @@ class HTMLExtractor {
       !node.body &&
       bodySlotReg.test(this.#read(node.name))
     ) {
-      if (this.#trackBodySlot) {
-        this.#bodySlots.push({
-          offset: this.#extractor.length,
-          depth: this.#domDepth,
-          inConditional: this.#conditionalDepth > 0,
-        });
-        return false;
-      }
+      // Without a usage site the default body is unknown content.
+      if (!this.#trackBodySlot) return true;
 
-      return true;
+      this.#bodySlots.push({
+        offset: this.#extractor.length,
+        depth: this.#domDepth,
+        inConditional: this.#conditionalDepth > 0,
+      });
+      return false;
     }
 
     const child =
@@ -233,21 +238,22 @@ class HTMLExtractor {
 
   #inlineChild(node: Node.Tag, child: InlineChildTemplate): boolean {
     const start = this.#extractor.length;
-    if (!child.exact) this.#exact = false;
+    if (child.fidelity !== "exact") this.#approximate = true;
     if (this.#domDepth === 0) this.#rootIds.push(...child.rootIds);
     Object.assign(this.#nodeDetails, child.nodeDetails);
 
     this.#extractor.write(child.segments[0]);
 
     let bodyUncertain = false;
-    if (node.body && child.segments.length === 2) {
-      this.#domDepth += child.bodySlotDepth;
-      if (child.bodySlotConditional) this.#conditionalDepth++;
+    if (node.body && child.bodySlot) {
+      const { depth, inConditional } = child.bodySlot;
+      this.#domDepth += depth;
+      if (inConditional) this.#conditionalDepth++;
       node.body.forEach((c) => {
         if (this.#visitNode(c)) bodyUncertain = true;
       });
-      if (child.bodySlotConditional) this.#conditionalDepth--;
-      this.#domDepth -= child.bodySlotDepth;
+      if (inConditional) this.#conditionalDepth--;
+      this.#domDepth -= depth;
     }
 
     if (child.segments.length === 2) this.#extractor.write(child.segments[1]);
@@ -261,7 +267,7 @@ class HTMLExtractor {
       rootIds: child.rootIds,
     });
 
-    return child.uncertain || bodyUncertain;
+    return child.fidelity === "uncertain" || bodyUncertain;
   }
 
   #writeHTMLTag(node: Node.Tag, id: string) {
@@ -279,7 +285,7 @@ class HTMLExtractor {
       if (attr.type === NodeType.AttrNamed) this.#writeAttrNamed(attr);
       else if (attr.type === NodeType.AttrSpread) {
         hasDynamicAttrs = true;
-        this.#exact = false;
+        this.#approximate = true;
       }
     });
     // [body or self-closing `/`]
@@ -392,7 +398,7 @@ class HTMLExtractor {
   /** Stands in for values only known at runtime (vs removing the attribute). */
   #writeDynamic() {
     this.#extractor.write("dynamic");
-    this.#exact = false;
+    this.#approximate = true;
   }
 }
 

From e2af740258cefd228f5b4bc9c016dabbe4bdce3f Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 17:28:39 +0000
Subject: [PATCH 13/19] Apply second-round probe findings

Name the extractHTML result (HTMLExtraction) instead of ReturnType
indirection in the server, rename #writeDynamicTag to #visitNonHTMLTag
to match its dispatch role, and restore the in-progress cache marker
comment a fresh reader flagged as missing.
---
 .../language-server/src/service/html/index.ts |  9 +++++----
 .../src/extractors/html/index.ts              | 20 ++++++++++++++-----
 2 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index c7da94ca..02e4db18 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -1,6 +1,7 @@
 import {
   extractChildTemplate,
   extractHTML,
+  type HTMLExtraction,
   type InlineChildTemplate,
   type InlineRegion,
   type Parsed,
@@ -19,13 +20,12 @@ import { type Exceptions, ruleExceptions } from "./axe-rules/rule-exceptions";
 const MAX_INLINE_DEPTH = 3;
 const MAX_INLINE_BYTES = 100_000;
 
-type Extraction = ReturnType<typeof extractHTML>;
-type NodeDetails = Extraction["nodeDetails"];
+type NodeDetails = HTMLExtraction["nodeDetails"];
 
 // Keyed on projectVersion: inlined children can change without a re-parse.
 const extractCache = new WeakMap<
   Parsed,
-  { version: number; result: Extraction }
+  { version: number; result: HTMLExtraction }
 >();
 let childTemplateCacheVersion = -1;
 let childTemplateCache = new Map<Parsed, InlineChildTemplate | undefined>();
@@ -204,6 +204,7 @@ function getChildTemplate(
   }
   if (childTemplateCache.has(file.parsed))
     return childTemplateCache.get(file.parsed);
+  // In-progress marker; breaks the recursion for circular templates.
   childTemplateCache.set(file.parsed, undefined);
 
   const candidate = extractChildTemplate(file.parsed, {
@@ -230,7 +231,7 @@ function childTemplateSize(childTemplate: InlineChildTemplate) {
 // Source anchor for a violation: the element itself when it maps into this
 // document, else the usage site of the inlined child whose root rendered it.
 function anchorViolation(
-  extraction: Extraction,
+  extraction: HTMLExtraction,
   element: HTMLElement,
   generatedOffset: number,
   exceptions: Exceptions,
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index 49e6d429..0c3986fd 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -5,7 +5,7 @@ import {
   type Parsed,
   type Range,
 } from "../../parser";
-import { Extractor } from "../../util/extractor";
+import { Extracted, Extractor } from "../../util/extractor";
 import {
   AttributeValueType,
   getAttributeValueType,
@@ -53,7 +53,17 @@ export interface ExtractHTMLOptions {
 
 const bodySlotReg = /^\$\{\s*input\.(?:renderBody|content)\s*\}$/;
 
-export function extractHTML(parsed: Parsed, options: ExtractHTMLOptions = {}) {
+export interface HTMLExtraction {
+  extracted: Extracted;
+  nodeDetails: Record<string, HTMLNodeDetails>;
+  inlineRegions: InlineRegion[];
+  fidelity: ExtractionFidelity;
+}
+
+export function extractHTML(
+  parsed: Parsed,
+  options: ExtractHTMLOptions = {},
+): HTMLExtraction {
   return new HTMLExtractor(parsed, options, false).end();
 }
 
@@ -103,7 +113,7 @@ class HTMLExtractor {
     });
   }
 
-  end() {
+  end(): HTMLExtraction {
     return {
       extracted: this.#extractor.end(),
       nodeDetails: this.#nodeDetails,
@@ -159,7 +169,7 @@ class HTMLExtractor {
         }
 
         if (!node.nameText || !isHTMLTag(node.nameText)) {
-          isDynamic = this.#writeDynamicTag(node);
+          isDynamic = this.#visitNonHTMLTag(node);
           break;
         }
 
@@ -194,7 +204,7 @@ class HTMLExtractor {
     return isDynamic || hasDynamicBody;
   }
 
-  #writeDynamicTag(node: Node.Tag): boolean {
+  #visitNonHTMLTag(node: Node.Tag): boolean {
     if (
       !node.nameText &&
       !node.body &&

From dd6536544deec9108859395d1f54a28ad4ebb727 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 17:36:37 +0000
Subject: [PATCH 14/19] Remove comments that restate the code

---
 packages/language-server/src/service/html/index.ts   |  8 ++------
 packages/language-tools/src/extractors/html/index.ts | 12 ------------
 2 files changed, 2 insertions(+), 18 deletions(-)

diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 02e4db18..d61c1fef 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -67,8 +67,7 @@ const HTMLService: Partial<Plugin> = {
       includeNodeLocations: true,
     });
     const { documentElement } = jsdom.window.document;
-    // Page-scoped rules only run when the extraction is exactly the rendered
-    // output and covers the whole document (an authored `<html>`).
+    // jsdom-fabricated `<html>` elements carry no node id.
     const exactDocument =
       extraction.fidelity === "exact" &&
       documentElement.dataset.markoNodeId !== undefined;
@@ -209,8 +208,7 @@ function getChildTemplate(
 
   const candidate = extractChildTemplate(file.parsed, {
     nodeIdPrefix: getNodeIdPrefix(template),
-    // Each cached template gets its own budget; usage sites re-check the
-    // composed size against theirs.
+    // Fresh budget: cached templates are shared, usage sites re-check size.
     resolveChild: createChildResolver(file, new Set(stack).add(template), {
       remaining: MAX_INLINE_BYTES,
     }),
@@ -228,8 +226,6 @@ function childTemplateSize(childTemplate: InlineChildTemplate) {
   );
 }
 
-// Source anchor for a violation: the element itself when it maps into this
-// document, else the usage site of the inlined child whose root rendered it.
 function anchorViolation(
   extraction: HTMLExtraction,
   element: HTMLElement,
diff --git a/packages/language-tools/src/extractors/html/index.ts b/packages/language-tools/src/extractors/html/index.ts
index 0c3986fd..b5292c55 100644
--- a/packages/language-tools/src/extractors/html/index.ts
+++ b/packages/language-tools/src/extractors/html/index.ts
@@ -24,12 +24,9 @@ interface HTMLBodySlot {
   inConditional: boolean;
 }
 
-/** How faithfully extracted HTML reflects rendered output, best to worst:
- * exact match; right structure with stand-in values; unknown structure. */
 export type ExtractionFidelity = "exact" | "approximate" | "uncertain";
 
 export interface InlineChildTemplate {
-  /** The HTML skeleton, split at the default body slot when exactly one exists. */
   segments: [string] | [string, string];
   bodySlot?: { depth: number; inConditional: boolean };
   fidelity: ExtractionFidelity;
@@ -67,7 +64,6 @@ export function extractHTML(
   return new HTMLExtractor(parsed, options, false).end();
 }
 
-/** Extracts a template as a skeleton that can be inlined at its usage sites. */
 export function extractChildTemplate(
   parsed: Parsed,
   options: ExtractHTMLOptions = {},
@@ -160,7 +156,6 @@ class HTMLExtractor {
         }
 
         if (isControlFlowTag(node)) {
-          // Emitted inline: control flow renders no element of its own.
           this.#conditionalDepth++;
           node.body?.forEach((child) => this.#visitNode(child));
           this.#conditionalDepth--;
@@ -190,7 +185,6 @@ class HTMLExtractor {
         this.#extractor.copy(node);
         break;
       case NodeType.Placeholder:
-        // Placeholder text stands in for unknown (possibly empty) content.
         this.#approximate = true;
         isDynamic =
           this.#read({
@@ -210,7 +204,6 @@ class HTMLExtractor {
       !node.body &&
       bodySlotReg.test(this.#read(node.name))
     ) {
-      // Without a usage site the default body is unknown content.
       if (!this.#trackBodySlot) return true;
 
       this.#bodySlots.push({
@@ -234,7 +227,6 @@ class HTMLExtractor {
       return this.#inlineChild(node, child);
     }
 
-    // Replace unknown and unresolvable tags with a `div` wrapping their body.
     if (node.body) {
       this.#extractor.write("<div>");
       this.#domDepth++;
@@ -284,13 +276,11 @@ class HTMLExtractor {
     let hasDynamicAttrs = false,
       hasDynamicBody = false;
     if (this.#domDepth === 0) this.#rootIds.push(id);
-    // <[node name]
     this.#extractor.write("<");
     this.#extractor.copy(isEmptyRange(node.name) ? node.nameText : node.name);
 
     this.#extractor.write(` data-marko-node-id="${id}"`);
     this.#writeShorthands(node);
-    // [node attributes]
     node.attrs?.forEach((attr) => {
       if (attr.type === NodeType.AttrNamed) this.#writeAttrNamed(attr);
       else if (attr.type === NodeType.AttrSpread) {
@@ -298,7 +288,6 @@ class HTMLExtractor {
         this.#approximate = true;
       }
     });
-    // [body or self-closing `/`]
     this.#extractor.write(">");
 
     if (!isVoidTag(node.nameText)) {
@@ -405,7 +394,6 @@ class HTMLExtractor {
     }
   }
 
-  /** Stands in for values only known at runtime (vs removing the attribute). */
   #writeDynamic() {
     this.#extractor.write("dynamic");
     this.#approximate = true;

From 7750a72bb74abda33c0f8336137c25545b055b73 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Thu, 23 Jul 2026 20:36:33 +0000
Subject: [PATCH 15/19] Cover tags/ discovery in a child template fixture

Child template resolution goes through the compiler's TaglibLookup, so
directory conventions are the compiler's concern; converting one
fixture from components/ to tags/ locks that in without growing the
suite.
---
 .../child-template-context.expected/index.ts    |  4 ++--
 .../{components => tags}/fancy-item.html        |  0
 .../{components => tags}/fancy-item.md          |  0
 .../{components => tags}/fancy-item.ts          | 17 ++++++-----------
 .../{components => tags}/fancy-item.marko       |  0
 5 files changed, 8 insertions(+), 13 deletions(-)
 rename packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/{components => tags}/fancy-item.html (100%)
 rename packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/{components => tags}/fancy-item.md (100%)
 rename packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/{components => tags}/fancy-item.ts (76%)
 rename packages/language-server/src/__tests__/fixtures/html/child-template-context/{components => tags}/fancy-item.marko (100%)

diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
index 294e4a1b..beaf678b 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/index.ts
@@ -14,7 +14,7 @@ export { type Component };
   Marko._.renderNativeTag("ul")()()({
     [Marko._.content]: (() => {
       const __marko_internal_tag_1 = Marko._.resolveTemplate(
-        import("./components/fancy-item.marko"),
+        import("./tags/fancy-item.marko"),
       );
       Marko._.renderTemplate(__marko_internal_tag_1)()()({});
       return () => {
@@ -25,7 +25,7 @@ export { type Component };
   Marko._.renderNativeTag("div")()()({
     [Marko._.content]: (() => {
       const __marko_internal_tag_2 = Marko._.resolveTemplate(
-        import("./components/fancy-item.marko"),
+        import("./tags/fancy-item.marko"),
       );
       Marko._.renderTemplate(__marko_internal_tag_2)()()({});
       return () => {
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.html
similarity index 100%
rename from packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.html
rename to packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.html
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.md b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.md
similarity index 100%
rename from packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.md
rename to packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.md
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.ts
similarity index 76%
rename from packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts
rename to packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.ts
index d80186d0..2bea0236 100644
--- a/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/components/fancy-item.ts
+++ b/packages/language-server/src/__tests__/fixtures/html/child-template-context/__snapshots__/child-template-context.expected/tags/fancy-item.ts
@@ -1,11 +1,6 @@
 export interface Input {}
-abstract class Component extends Marko.Component<Input> {}
-export { type Component };
 (function (this: void) {
   const input = Marko._.any as Input;
-  const component = Marko._.any as Component;
-  const state = Marko._.state(component);
-  const out = Marko._.any as Marko.Out;
   const $signal = Marko._.any as AbortSignal;
   const $global = Marko._.getGlobal(
     // @ts-expect-error We expect the compiler to error because we are checking if the MarkoRun.Context is defined.
@@ -18,10 +13,10 @@ export { type Component };
       };
     })(),
   });
-  Marko._.noop({ component, state, out, input, $global, $signal });
+  Marko._.noop({ input, $global, $signal });
   return;
 })();
-const __marko_internal_api = "class";
+const __marko_internal_api = "tags";
 export { __marko_internal_api as "~api" };
 const FancyItem = new (class Template extends Marko._.Template<{
   render(
@@ -30,14 +25,14 @@ const FancyItem = new (class Template extends Marko._.Template<{
       write: (chunk: string) => void;
       end: (chunk?: string) => void;
     },
-  ): Marko.Out<Component>;
+  ): Marko.Out<never>;
 
   render(
     input: Marko.TemplateInput<Input>,
-    cb?: (err: Error | null, result: Marko.RenderResult<Component>) => void,
-  ): Marko.Out<Component>;
+    cb?: (err: Error | null, result: Marko.RenderResult<never>) => void,
+  ): Marko.Out<never>;
 
-  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<Component>;
+  renderSync(input: Marko.TemplateInput<Input>): Marko.RenderResult<never>;
 
   renderToString(input: Marko.TemplateInput<Input>): string;
 
diff --git a/packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko b/packages/language-server/src/__tests__/fixtures/html/child-template-context/tags/fancy-item.marko
similarity index 100%
rename from packages/language-server/src/__tests__/fixtures/html/child-template-context/components/fancy-item.marko
rename to packages/language-server/src/__tests__/fixtures/html/child-template-context/tags/fancy-item.marko

From 265e1fcc32c522f909677c22f29c6fd914045cc3 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Fri, 24 Jul 2026 13:06:52 +0000
Subject: [PATCH 16/19] Rename requiresKnownParent modes to a generic
 convention

---
 .../src/service/html/axe-rules/rule-exceptions.ts           | 6 +++---
 packages/language-server/src/service/html/index.ts          | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
index e6ae6705..61f8cd80 100644
--- a/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
+++ b/packages/language-server/src/service/html/axe-rules/rule-exceptions.ts
@@ -29,7 +29,7 @@ export interface Exceptions {
    * Exclude unless the parent chain axe consults is fully known; written
    * against axe-core 4.12's checks — re-verify on axe upgrades
    */
-  requiresKnownParent?: true | "div-wrapped";
+  requiresKnownParent?: "direct" | "through-presentational-wrappers";
   /**
    * Exclude unless the file renders a complete document (authored `<html>`)
    * whose extraction exactly matches rendered output
@@ -137,13 +137,13 @@ export const ruleExceptions: { [id in Whitelist]: Exceptions } = {
   [r.sensoryAndVisualCues.metaViewportLarge]: {},
   [r.structure.definitionList]: { unknownBody },
   [r.structure.dlitem]: {
-    requiresKnownParent: "div-wrapped",
+    requiresKnownParent: "through-presentational-wrappers",
     dynamicAttrs: ["role"],
     attrSpread,
   },
   [r.structure.list]: { unknownBody },
   [r.structure.listitem]: {
-    requiresKnownParent: true,
+    requiresKnownParent: "direct",
     dynamicAttrs: ["role"],
     attrSpread,
   },
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index d61c1fef..22b8bfaf 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -282,7 +282,7 @@ function hasKnownParent(
   const parent = element.parentElement;
   if (!isKnownElement(parent, nodeDetails)) return false;
 
-  if (mode === "div-wrapped" && parent.tagName === "DIV") {
+  if (mode === "through-presentational-wrappers" && parent.tagName === "DIV") {
     const role = parent.getAttribute("role");
     if (!role || role === "presentation" || role === "none") {
       // axe looks through presentational div wrappers to the grandparent.

From 71409e2c3fa1b260e0756a9198f4c090d73549da Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Fri, 24 Jul 2026 14:48:21 +0000
Subject: [PATCH 17/19] Skip axe when an edit leaves the extraction unchanged

Validation results are now cached per document, keyed on the
extraction's semantic content (generated HTML, node details, inline
regions, fidelity); a cache hit re-maps stored generated-space anchors
through the fresh extraction instead of re-running jsdom and axe.
Edits inside scriptlets, event handlers, styles, or placeholder
expressions hit this path, dropping revalidation from ~200ms to ~2ms
on a 24-section benchmark page.

Adds a BENCH-gated perf suite (pnpm --filter @marko/language-server
run bench) that generates a synthetic component-heavy app, guards
against benching a broken page, and measures cold/warm validation and
extraction with and without inlining, plus a regression test proving
cache hits re-map diagnostic ranges after extraction-neutral edits.
---
 packages/language-server/package.json         |   1 +
 .../__tests__/a11y-validation-cache.test.ts   |  60 ++++++
 .../src/__tests__/bench.test.ts               | 201 ++++++++++++++++++
 .../language-server/src/service/html/index.ts |  94 ++++++--
 4 files changed, 341 insertions(+), 15 deletions(-)
 create mode 100644 packages/language-server/src/__tests__/a11y-validation-cache.test.ts
 create mode 100644 packages/language-server/src/__tests__/bench.test.ts

diff --git a/packages/language-server/package.json b/packages/language-server/package.json
index db4b04b4..93616009 100644
--- a/packages/language-server/package.json
+++ b/packages/language-server/package.json
@@ -38,6 +38,7 @@
     "!**/*.tsbuildinfo"
   ],
   "scripts": {
+    "bench": "BENCH=1 mocha './src/__tests__/bench.test.ts'",
     "build": "tsx build.mts",
     "test": "mocha './src/**/__tests__/*.test.ts'",
     "test:update": "mocha './src/**/__tests__/*.test.ts' --update"
diff --git a/packages/language-server/src/__tests__/a11y-validation-cache.test.ts b/packages/language-server/src/__tests__/a11y-validation-cache.test.ts
new file mode 100644
index 00000000..f5fd53eb
--- /dev/null
+++ b/packages/language-server/src/__tests__/a11y-validation-cache.test.ts
@@ -0,0 +1,60 @@
+import assert from "node:assert/strict";
+
+import { Project } from "@marko/language-tools";
+import path from "path";
+import { URI } from "vscode-uri";
+
+import { documents } from "../service";
+import HTMLPlugin from "../service/html";
+import { clearMarkoCacheForFile } from "../utils/file";
+
+Project.setDefaultTypePaths({
+  internalTypesFile:
+    require.resolve("@marko/language-tools/marko.internal.d.ts"),
+  markoTypesFile: require.resolve("marko/index.d.ts"),
+});
+
+describe("a11y validation cache", () => {
+  const uri = URI.file(
+    path.join(__dirname, "a11y-cache-virtual.marko"),
+  ).toString();
+
+  it("re-maps diagnostics after edits that leave extraction unchanged", async () => {
+    documents.doOpen({
+      textDocument: {
+        uri,
+        languageId: "marko",
+        version: 1,
+        text: '<script>\n  const a = 1;\n</script>\n<img src="x.png">\n',
+      },
+    });
+    const doc = documents.get(uri)!;
+
+    const first = (await HTMLPlugin.doValidate!(doc))!;
+    assert.equal(first.length, 1);
+    assert.match(first[0].message, /alt attribute/);
+    assert.equal(first[0].range.start.line, 3);
+
+    documents.doChange({
+      textDocument: { uri, version: 2 },
+      contentChanges: [
+        {
+          range: {
+            start: { line: 1, character: 0 },
+            end: { line: 1, character: 0 },
+          },
+          text: "  const b = 2;\n",
+        },
+      ],
+    });
+    // The server binary wires this into documents.onFileChange.
+    clearMarkoCacheForFile(doc);
+
+    const second = (await HTMLPlugin.doValidate!(doc))!;
+    assert.equal(second.length, 1);
+    assert.equal(second[0].message, first[0].message);
+    assert.equal(second[0].range.start.line, 4);
+
+    documents.doClose({ textDocument: { uri } });
+  });
+});
diff --git a/packages/language-server/src/__tests__/bench.test.ts b/packages/language-server/src/__tests__/bench.test.ts
new file mode 100644
index 00000000..60914f48
--- /dev/null
+++ b/packages/language-server/src/__tests__/bench.test.ts
@@ -0,0 +1,201 @@
+import assert from "node:assert/strict";
+
+import fs from "fs";
+import path from "path";
+import type { TextDocument } from "vscode-languageserver-textdocument";
+import { URI } from "vscode-uri";
+
+import { documents } from "../service";
+import HTMLPlugin from "../service/html";
+import { clearMarkoCacheForFile } from "../utils/file";
+
+const SHOULD_BENCH = process.env.BENCH;
+const LEAVES = 20;
+const WRAPPERS = 10;
+const SECTIONS = 24;
+
+(SHOULD_BENCH ? describe : describe.skip)("a11y validation bench", () => {
+  let appDir: string;
+  let tick = 0;
+  let edit = 0;
+
+  const openPage = (name: string, text: string) => {
+    const uri = URI.file(path.join(appDir, name)).toString();
+    documents.doOpen({
+      textDocument: { uri, languageId: "marko", version: 1, text },
+    });
+    return documents.get(uri)!;
+  };
+
+  // Any open/close bumps projectVersion, invalidating the extraction caches
+  // the way a keystroke would.
+  const invalidate = () => {
+    const uri = URI.file(path.join(appDir, `tick.marko`)).toString();
+    documents.doOpen({
+      textDocument: {
+        uri,
+        languageId: "marko",
+        version: ++tick,
+        text: `<div>${tick}</div>`,
+      },
+    });
+    documents.doClose({ textDocument: { uri } });
+  };
+
+  const replaceAt = (
+    doc: TextDocument,
+    search: string,
+    length: number,
+    text: string,
+  ) => {
+    const offset = doc.getText().indexOf(search);
+    assert.notEqual(offset, -1, `bench edit target missing: ${search}`);
+    documents.doChange({
+      textDocument: { uri: doc.uri, version: doc.version + 1 },
+      contentChanges: [
+        {
+          range: {
+            start: doc.positionAt(offset),
+            end: doc.positionAt(offset + length),
+          },
+          text,
+        },
+      ],
+    });
+    clearMarkoCacheForFile(doc);
+  };
+
+  const contentEdits = new WeakMap<TextDocument, number>();
+  const contentEdit = (doc: TextDocument) => {
+    const n = contentEdits.get(doc) ?? 0;
+    contentEdits.set(doc, n + 1);
+    replaceAt(doc, n % 2 ? "Note" : "Copy", 4, n % 2 ? "Copy" : "Note");
+  };
+  const scriptEdit = (doc: TextDocument) =>
+    replaceAt(doc, "marker = ", 10, `marker = ${++edit % 10}`);
+
+  const measure = async (
+    label: string,
+    iterations: number,
+    fn: () => unknown,
+  ) => {
+    for (let i = 0; i < 3; i++) await fn();
+    const samples: number[] = [];
+    for (let i = 0; i < iterations; i++) {
+      const start = performance.now();
+      await fn();
+      samples.push(performance.now() - start);
+    }
+    samples.sort((a, b) => a - b);
+    const mean = samples.reduce((sum, s) => sum + s, 0) / samples.length;
+    console.log(
+      `  ${label}: mean ${mean.toFixed(2)}ms | p50 ${samples[
+        iterations >> 1
+      ].toFixed(2)}ms | min ${samples[0].toFixed(2)}ms`,
+    );
+  };
+
+  before(function () {
+    this.timeout(0);
+    // Inside the repo tree so the workspace marko compiler resolves.
+    appDir = path.join(__dirname, "../../node_modules/.cache/a11y-bench-app");
+    const componentsDir = path.join(appDir, "components");
+    fs.rmSync(appDir, { recursive: true, force: true });
+    fs.mkdirSync(componentsDir, { recursive: true });
+
+    for (let i = 0; i < LEAVES; i++) {
+      fs.writeFileSync(
+        path.join(componentsDir, `leaf-${i}.marko`),
+        i % 4 === 0
+          ? `<li class="leaf">item ${i}</li>\n`
+          : i % 4 === 1
+            ? `<img src="art-${i}.png" alt="art ${i}">\n`
+            : i % 4 === 2
+              ? `<button type="button">action ${i}</button>\n`
+              : `<span class="badge">badge ${i}</span>\n`,
+      );
+    }
+    for (let i = 0; i < WRAPPERS; i++) {
+      fs.writeFileSync(
+        path.join(componentsDir, `wrap-${i}.marko`),
+        `export interface Input {\n  renderBody: Marko.Body;\n}\n\n` +
+          (i % 2 === 0
+            ? `<section class="wrap-${i}"><\${input.renderBody}/></section>\n`
+            : `<ul class="wrap-${i}"><\${input.renderBody}/></ul>\n`),
+      );
+    }
+  });
+
+  after(() => {
+    fs.rmSync(appDir, { recursive: true, force: true });
+  });
+
+  const pageSource = (prefix: string) => {
+    let body = "";
+    for (let s = 0; s < SECTIONS; s++) {
+      const w = s % WRAPPERS;
+      const listItems = Array.from(
+        { length: 4 },
+        (_, i) => `      <${prefix}leaf-${(s + i * 4) % LEAVES}/>\n`,
+      ).join("");
+      body += `<section>
+  <h2>Section ${s}</h2>
+  <${prefix}wrap-${w}>
+${listItems}  </${prefix}wrap-${w}>
+  <if=input.expanded>
+    <${prefix}leaf-${(s + 1) % LEAVES}/>
+  </if>
+  <p>Copy for section ${s} with <a href="/s/${s}">details ${s}</a>.</p>
+  ${s % 6 === 0 ? `<img src="banner-${s}.png">` : `<img src="banner-${s}.png" alt="banner ${s}">`}
+</section>
+`;
+    }
+    return `export interface Input {\n  expanded: boolean;\n}\n\n<script>\n  const marker = 0;\n</script>\n<main>\n${body}</main>\n`;
+  };
+
+  it("runs benches", async function () {
+    this.timeout(0);
+    const inlined = openPage("page-inlined.marko", pageSource(""));
+    const legacy = openPage("page-legacy.marko", pageSource("zz-"));
+
+    const inlinedHtml = (
+      await HTMLPlugin.commands!["$/showHtmlOutput"](inlined.uri)
+    )?.content as string;
+    assert.ok(inlinedHtml.length > 10_000, "bench page extraction too small");
+    assert.ok(
+      inlinedHtml.includes("leaf-0.marko#"),
+      "components were not inlined",
+    );
+    const baseline = (await HTMLPlugin.doValidate!(inlined))!.length;
+    assert.ok(baseline > 0, "bench page produced no diagnostics");
+
+    const validated = async (doc: TextDocument) => {
+      const diags = (await HTMLPlugin.doValidate!(doc))!;
+      assert.ok(diags.length > 0, "bench page lost its diagnostics");
+    };
+
+    console.log(
+      `  page: ${inlined.getText().length} chars source, ${inlinedHtml.length} chars extracted, ${baseline} diagnostics`,
+    );
+    await measure("doValidate, content edit, components inlined", 20, () => {
+      contentEdit(inlined);
+      return validated(inlined);
+    });
+    await measure("doValidate, content edit, legacy (unresolvable)", 20, () => {
+      contentEdit(legacy);
+      return HTMLPlugin.doValidate!(legacy);
+    });
+    await measure("doValidate, script-only edit (axe skipped)", 100, () => {
+      scriptEdit(inlined);
+      return validated(inlined);
+    });
+    await measure("extraction only, components inlined", 200, () => {
+      invalidate();
+      return HTMLPlugin.commands!["$/showHtmlOutput"](inlined.uri);
+    });
+    await measure("extraction only, legacy (unresolvable)", 200, () => {
+      invalidate();
+      return HTMLPlugin.commands!["$/showHtmlOutput"](legacy.uri);
+    });
+  });
+});
diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 22b8bfaf..f53866c2 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -9,6 +9,7 @@ import {
 import axe from "axe-core";
 import { JSDOM } from "jsdom";
 import path from "path";
+import type { Diagnostic } from "vscode-languageserver";
 import type { TextDocument } from "vscode-languageserver-textdocument";
 import { URI } from "vscode-uri";
 
@@ -30,6 +31,19 @@ const extractCache = new WeakMap<
 let childTemplateCacheVersion = -1;
 let childTemplateCache = new Map<Parsed, InlineChildTemplate | undefined>();
 
+interface ViolationEntry {
+  source: string;
+  message: string;
+  anchor: { generatedStart: number; length: number } | { regionIndex: number };
+}
+
+// Axe results depend only on the extraction's content; edits that leave it
+// unchanged (scriptlets, event handlers, ...) reuse them, re-mapping offsets.
+const validationCache = new WeakMap<
+  TextDocument,
+  { key: string; entries: ViolationEntry[] }
+>();
+
 // Path-independent so extracted output is stable across machines.
 const templatePrefixes = new Map<string, string>();
 const basenameCounts = new Map<string, number>();
@@ -62,6 +76,11 @@ const HTMLService: Partial<Plugin> = {
   async doValidate(doc) {
     const extraction = extract(doc);
     const { extracted, nodeDetails } = extraction;
+    const key = extractionKey(extraction);
+    const cached = validationCache.get(doc);
+    if (cached?.key === key) {
+      return cached.entries.flatMap((entry) => toDiagnostic(extraction, entry));
+    }
 
     const jsdom = new JSDOM(extracted.toString(), {
       includeNodeLocations: true,
@@ -90,7 +109,7 @@ const HTMLService: Partial<Plugin> = {
     const violations = await getViolationNodes(Object.keys(ruleExceptions));
     release();
 
-    return violations.flatMap((result) => {
+    const entries = violations.flatMap((result): ViolationEntry[] => {
       const { element } = result;
       if (!element) return [];
       const ruleId = result.ruleId as keyof typeof ruleExceptions;
@@ -131,18 +150,54 @@ const HTMLService: Partial<Plugin> = {
 
       return [
         {
-          range: anchor.range,
-          severity: 3,
           source: `axe-core(${ruleId})`,
           message:
             anchor.messagePrefix +
             (result.failureSummary ?? "unknown accessibility issue"),
+          anchor: anchor.anchor,
         },
       ];
     });
+
+    validationCache.set(doc, { key, entries });
+    return entries.flatMap((entry) => toDiagnostic(extraction, entry));
   },
 };
 
+function extractionKey({
+  extracted,
+  nodeDetails,
+  inlineRegions,
+  fidelity,
+}: HTMLExtraction) {
+  let key = `${fidelity}\n${extracted.toString()}`;
+  for (const id in nodeDetails) {
+    const d = nodeDetails[id];
+    key += `\n${id}:${+d.hasDynamicAttrs}${+d.hasDynamicBody}${+d.inConditional}`;
+  }
+  for (const r of inlineRegions) {
+    key += `\n${r.start}-${r.end}:${+r.bodyUncertain}${+r.inConditional}:${r.rootIds.join()}`;
+  }
+  return key;
+}
+
+function toDiagnostic(
+  extraction: HTMLExtraction,
+  { anchor, source, message }: ViolationEntry,
+): Diagnostic[] {
+  const range =
+    "regionIndex" in anchor
+      ? extraction.extracted.parsed.locationAt(
+          extraction.inlineRegions[anchor.regionIndex].tagName,
+        )
+      : extraction.extracted.sourceLocationAt(
+          anchor.generatedStart + 1,
+          anchor.generatedStart + 1 + anchor.length,
+        );
+  if (!range) return [];
+  return [{ range, severity: 3, source, message }];
+}
+
 function extract(doc: TextDocument) {
   const file = getMarkoFile(doc);
   const cached = extractCache.get(file.parsed);
@@ -233,13 +288,21 @@ function anchorViolation(
   exceptions: Exceptions,
 ) {
   const { extracted, inlineRegions } = extraction;
-  const range = extracted.sourceLocationAt(
-    generatedOffset + 1,
-    generatedOffset + 1 + element.tagName.length,
-  );
-  if (range) return { range, messagePrefix: "" };
+  const length = element.tagName.length;
+  if (
+    extracted.sourceLocationAt(
+      generatedOffset + 1,
+      generatedOffset + 1 + length,
+    )
+  ) {
+    return {
+      anchor: { generatedStart: generatedOffset, length },
+      messagePrefix: "",
+    };
+  }
 
-  const region = innermostRegionAt(inlineRegions, generatedOffset);
+  const regionIndex = innermostRegionIndexAt(inlineRegions, generatedOffset);
+  const region = inlineRegions[regionIndex];
   const nodeId = element.dataset.markoNodeId;
   if (
     !region ||
@@ -252,20 +315,21 @@ function anchorViolation(
   }
 
   return {
-    range: extracted.parsed.locationAt(region.tagName),
+    anchor: { regionIndex },
     messagePrefix: `This tag renders a \`<${element.tagName.toLowerCase()}>\` element here — `,
   };
 }
 
-function innermostRegionAt(regions: InlineRegion[], offset: number) {
-  let match: InlineRegion | undefined;
-  for (const region of regions) {
+function innermostRegionIndexAt(regions: InlineRegion[], offset: number) {
+  let match = -1;
+  for (let i = 0; i < regions.length; i++) {
+    const region = regions[i];
     if (
       region.start <= offset &&
       offset < region.end &&
-      (!match || region.start >= match.start)
+      (match === -1 || region.start >= regions[match].start)
     ) {
-      match = region;
+      match = i;
     }
   }
   return match;

From 7111a9a44648babe6780becdc6dca70e38182e1a Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Fri, 24 Jul 2026 14:55:36 +0000
Subject: [PATCH 18/19] Trim axe work that can't produce diagnostics
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Profiling the bench page showed no pathological rule — cost is spread
across axe's per-node work — but two lossless cuts: skip axe's CSSOM
preload (no enabled rule reads CSS), and when the exact-document gate
is closed, drop the fifteen requiresExactDocument rules from runOnly
instead of running them and filtering every violation. Cold validation
on the bench page drops ~10%; the remaining gap versus the legacy
extraction is the added analysis surface itself (mostly inlined
component roots, which are the point of the feature).
---
 packages/language-server/src/service/html/index.ts | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index f53866c2..807b05d6 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -59,6 +59,14 @@ function getNodeIdPrefix(template: string) {
   return prefix;
 }
 
+const allRules = Object.keys(ruleExceptions);
+// Rules gated on an exact document are filtered wholesale when the gate is
+// closed; skip running them at all.
+const nonDocumentRules = allRules.filter(
+  (id) =>
+    !ruleExceptions[id as keyof typeof ruleExceptions].requiresExactDocument,
+);
+
 const HTMLService: Partial<Plugin> = {
   commands: {
     "$/showHtmlOutput": async (uri: string) => {
@@ -100,13 +108,17 @@ const HTMLService: Partial<Plugin> = {
           },
           resultTypes: ["violations"],
           elementRef: true,
+          // No enabled rule reads CSS, so skip axe's CSSOM preload.
+          preload: false,
         })
       ).violations.flatMap(({ nodes, id }) =>
         nodes.map((node) => ({ ...node, ruleId: id })),
       );
 
     const release = await acquireMutexLock();
-    const violations = await getViolationNodes(Object.keys(ruleExceptions));
+    const violations = await getViolationNodes(
+      exactDocument ? allRules : nonDocumentRules,
+    );
     release();
 
     const entries = violations.flatMap((result): ViolationEntry[] => {

From 159a225d450150ca9584293fd3ecab4d552dd940 Mon Sep 17 00:00:00 2001
From: Luke LaValva <lukelavalva@gmail.com>
Date: Fri, 24 Jul 2026 15:09:35 +0000
Subject: [PATCH 19/19] Memoize computed styles for axe and skip frame plumbing
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CPU profiling showed cold validation dominated not by axe's rule logic
but by jsdom recomputing styles element-by-element for axe's
visibility checks. Extracted documents carry no stylesheets, so an
element's computed style is a pure function of the UA sheet and its
ancestor chain of tags and attributes (jsdom implements inheritance
and the UA sheet uses only tag/attr child combinators — verified
against jsdom's computed-style helper and default stylesheet).
getComputedStyle is now memoized per ancestor-chain key, excluding the
style-inert data-marko-node-id so repeated component instances share
entries. Also passes iframes:false since extracted frames never have
content documents.

Bench page cold validation drops ~200ms to ~156ms (legacy shape
~103ms to ~74ms); axe results verified identical on the corpus and on
an inheritance/visibility torture page.
---
 .../language-server/src/service/html/index.ts | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/packages/language-server/src/service/html/index.ts b/packages/language-server/src/service/html/index.ts
index 807b05d6..9950d12f 100644
--- a/packages/language-server/src/service/html/index.ts
+++ b/packages/language-server/src/service/html/index.ts
@@ -7,7 +7,7 @@ import {
   type Parsed,
 } from "@marko/language-tools";
 import axe from "axe-core";
-import { JSDOM } from "jsdom";
+import { type DOMWindow, JSDOM } from "jsdom";
 import path from "path";
 import type { Diagnostic } from "vscode-languageserver";
 import type { TextDocument } from "vscode-languageserver-textdocument";
@@ -93,6 +93,7 @@ const HTMLService: Partial<Plugin> = {
     const jsdom = new JSDOM(extracted.toString(), {
       includeNodeLocations: true,
     });
+    memoizeComputedStyles(jsdom.window);
     const { documentElement } = jsdom.window.document;
     // jsdom-fabricated `<html>` elements carry no node id.
     const exactDocument =
@@ -110,6 +111,7 @@ const HTMLService: Partial<Plugin> = {
           elementRef: true,
           // No enabled rule reads CSS, so skip axe's CSSOM preload.
           preload: false,
+          iframes: false,
         })
       ).violations.flatMap(({ nodes, id }) =>
         nodes.map((node) => ({ ...node, ruleId: id })),
@@ -210,6 +212,42 @@ function toDiagnostic(
   return [{ range, severity: 3, source, message }];
 }
 
+// Extracted documents have no stylesheets, so jsdom's computed style is a
+// function of the UA sheet and the element's ancestor chain of tags/attrs
+// (data-marko-node-id is style-inert). Memoizing collapses the per-element
+// style computation that otherwise dominates axe's visibility checks.
+function memoizeComputedStyles(window: DOMWindow) {
+  if (window.document.styleSheets.length > 0) return;
+  const keys = new WeakMap<Element, string>();
+  const styles = new Map<string, CSSStyleDeclaration>();
+  const keyOf = (el: Element): string => {
+    let key = keys.get(el);
+    if (key === undefined) {
+      const parent = el.parentElement;
+      key = parent ? `${keyOf(parent)}>` : "";
+      key += el.tagName;
+      for (const attr of el.attributes) {
+        if (attr.name !== "data-marko-node-id") {
+          key += `|${attr.name}=${attr.value}`;
+        }
+      }
+      keys.set(el, key);
+    }
+    return key;
+  };
+  const original = window.getComputedStyle.bind(window);
+  window.getComputedStyle = ((el: Element, pseudo?: string | null) => {
+    if (pseudo) return original(el, pseudo);
+    const key = keyOf(el);
+    let style = styles.get(key);
+    if (!style) {
+      style = original(el);
+      styles.set(key, style);
+    }
+    return style;
+  }) as typeof window.getComputedStyle;
+}
+
 function extract(doc: TextDocument) {
   const file = getMarkoFile(doc);
   const cached = extractCache.get(file.parsed);