docs: drop the 'bare single #[EnumValue] to silence' shortcut recommendation

Recommending users annotate a single case to silence the advisory is
actively misleading: once the default flips, every other case would
disappear from the schema — the exact opposite of what a user reaching
for the shortcut wanted. The honest recommendation is 'annotate every
case you want to keep exposed', which aligns their intent with the
post-flip behaviour.

- Warning message rewritten around 'add to every case you want exposed,
  omit only from cases you want hidden' instead of 'at least one case
  silences this notice'.
- descriptions.md migration subsection mirrors the same framing.
- Color/Size/Position test fixtures now annotate every case, not just
  the first one, so they demonstrate the correct migration pattern
  rather than the misleading shortcut.

Author: oojacoboo

src/Mappers/Root/EnumTypeMapper.php

@@ -197,12 +197,10 @@ private function mapByClassName(string $enumClass): EnumType|null
      *
      * Today every case is automatically exposed in the schema regardless of `#[EnumValue]` —
      * this call site keeps that behaviour intact. The notice announces the planned migration:
-     * a future major release will require at least one `#[EnumValue]`-annotated case per
-     * `#[Type]`-mapped enum, and only annotated cases will participate in the schema
-     * (mirroring `#[Field]`'s opt-in model on classes). Partial annotation is deliberately
-     * allowed and intentionally silent — leaving some cases unannotated is the mechanism that
-     * hides internal cases from the public schema once the default flips, so it must not
-     * itself produce a warning.
+     * a future major release will require `#[EnumValue]` on each case that should participate
+     * in the schema, and unannotated cases will be hidden (mirroring `#[Field]`'s opt-in
+     * model on classes). Partial annotation is deliberately allowed and intentionally silent
+     * so that leaving some cases unannotated can be used to hide them once the default flips.
      *
      * @param class-string<UnitEnum> $enumClass
      */
@@ -211,8 +209,8 @@ private function warnEnumHasNoEnumValueAttribute(string $enumClass): void
         trigger_error(
             sprintf(
                 'Enum "%s" is mapped to a GraphQL enum type but declares no #[EnumValue] attributes on any case. '
-                . 'Today every case is automatically exposed; a future major release will require at least one #[EnumValue]-annotated case per #[Type]-mapped enum, and only annotated cases will participate in the schema (mirroring #[Field]\'s opt-in model on classes). '
-                . 'Add #[EnumValue] to the case(s) you want to expose — annotating at least one case acknowledges the opt-in model and silences this notice. Cases left unannotated will be hidden from the schema after the future default flip, which is the intended way to keep internal values out of the public API.',
+                . 'Today every case is automatically exposed; a future major release will require #[EnumValue] on each case that should participate in the schema, and unannotated cases will be hidden (mirroring #[Field]\'s opt-in model on classes). '
+                . 'Add #[EnumValue] to every case you want to keep exposed. Omit it only from cases you want hidden from the public schema after the future default flip.',
                 $enumClass,
             ),
             E_USER_DEPRECATED,

tests/Fixtures/Integration/Models/Color.php

@@ -13,10 +13,8 @@
 )]
 enum Color: string
 {
-    // A bare #[EnumValue] acknowledges the opt-in migration without altering runtime behaviour.
-    // Remove the attribute or annotate specific cases once the enum actually needs per-case
-    // description/deprecation metadata.
     #[EnumValue]
     case Green = 'green';
+    #[EnumValue]
     case Red   = 'red';
 }

tests/Fixtures/Integration/Models/Position.php

@@ -12,5 +12,6 @@ enum Position: int
 {
     #[EnumValue]
     case Off = 0;
+    #[EnumValue]
     case On  = 1;
 }

tests/Fixtures/Integration/Models/Size.php

@@ -12,6 +12,8 @@ enum Size
 {
     #[EnumValue]
     case S;
+    #[EnumValue]
     case M;
+    #[EnumValue]
     case L;
 }

website/docs/descriptions.md

@@ -131,14 +131,14 @@ is an enum value.
 
 ### Future migration
 
-A future major release will require at least one `#[EnumValue]`-annotated case per
-`#[Type]`-mapped enum; only annotated cases will be exposed in the schema (mirroring
-`#[Field]`'s opt-in model). Today every case is still auto-exposed, so nothing breaks.
-
-GraphQLite emits a deprecation notice only when a `#[Type]`-mapped enum has **zero**
-`#[EnumValue]` attributes — annotating any single case silences it and acknowledges the
-model. Partial annotation is intentional: an unannotated case is how you hide a value from
-the public schema once the default flips.
+A future major release will require `#[EnumValue]` on each case that should participate in
+the schema; unannotated cases will be hidden (mirroring `#[Field]`'s opt-in model). Today
+every case is still auto-exposed, so nothing breaks. Add `#[EnumValue]` to every case you
+want to keep exposed — omitting it from a case is the mechanism for hiding internal values
+once the default flips.
+
+GraphQLite emits a deprecation notice when a `#[Type]`-mapped enum has **zero**
+`#[EnumValue]` attributes at all (partial annotation is intentional and stays silent).
 
 ## Description uniqueness on `#[ExtendType]`