`@vue-ignore` not working with `v-else`

[downace]

Vue - Official extension or vue-tsc version

3.1.2

VSCode version

Vue version

3.5.13

TypeScript version

5.9.3

System Info

package.json dependencies

Steps to reproduce

1. Create Vue component with error at the same node as v-else and try to suppress the error with @vue-ignore:

<template>
  <div v-if="condition"></div>
  <!-- @vue-ignore -->
  <div v-else :class="unknownProp"> Test </div>
</template>

<script setup lang="ts">
import { shallowRef } from 'vue';
const condition = shallowRef(false);
</script>

2. Run vue-tsc (e.g. ./node_modules/.bin/vue-tsc --noEmit)

What is expected?

Error should be suppressed

What is actually happening?

Error is reported as if there were not @vue-ignore directive:

frontend/components/TestComponent.vue:6:13 - error TS2339: Property 'unknownProp' does not exist on type '{ condition: boolean; $: ComponentInternalInstance; $data: {}; $props: {}; $attrs: Data; $refs: Data; $slots: Readonly<InternalSlots>; ... 19 more ...; $router: Router; }'.

6     :class="unknownProp"
              ~~~~~~~~~~~


Found 1 error in frontend/components/TestComponent.vue:6

Workaround: use v-if="!condition" instead of v-else

Link to minimal reproduction

No response

Any additional comments?

No response

[Mathious6]

Same issue on my side using:

• "vue-tsc": "^3.1.3"
• "vue": "^3.5.11"
• "typescript": "^5.5.4"

📚 Note: I also face the issue while using v-else-if (not only v-else)

[KazariEX]

Workaround:

<template>
  <div v-if="condition"></div>
  <template v-else>
    <!-- @vue-ignore -->
    <div :class="unknownProp"> Test </div>
  </template>
</template>

[Mathious6]

Env

typescript: 5.8.3
vue-tsc: 3.1.3
vue: 3.5.13

Repro

<template>
  <Title v-if="condition" title="Test" />

  <template v-else>
    <!-- @vue-ignore -->
    <Title title="Test" :unknownProp="true" />
  </template>
</template>

Expected
The @vue-ignore comment should suppress the type error on the <Title> inside the v-else branch.

Actual
vue-tsc still reports:

Object literal may only specify known properties, and 'unknownProp' does not exist in type '{ readonly title: string } & VNodeProps & AllowedComponentProps & ComponentCustomProps'.ts-plugin(2353)

Notes / Workarounds

• Placing @vue-ignore before the first node of the if/else chain suppresses errors in both branches (unexpected but works):

  <template>
    <!-- @vue-ignore -->
    <Title v-if="condition" title="Test" :unknownProp="true" />
  
    <template v-else>
      <Title title="Test" :unknownProp="true" />
    </template>
  </template>

• However, this behavior is a bit aggressive, since ignoring at the top of the chain disables type-checking for the entire if/else logic, not just the intended node. It would be preferable to be able to scope the ignore to a single branch or element.