Keep the pointerEvents ts-expect-error in emitted spec declarations (#4601)

## Description

The three codegen specs redeclare `pointerEvents` as `WithDefault<...,
'auto'>`, which codegen requires. `WithDefault` adds `null`, so the
interface no longer satisfies `ViewProps.pointerEvents`, and the source
suppresses that with a `// @ts-expect-error` (or `// @ts-ignore`) line.

Declaration emit drops line comments, so the published
`lib/typescript/specs/*.d.ts` carry a bare TS2430. Any consumer with
`skipLibCheck: false` fails to type-check:

error TS2430: Interface 'NativeProps' incorrectly extends interface
'ViewProps'. Types of property 'pointerEvents' are incompatible.

This turns the directives into `/** */` block comments. TypeScript
honours directives in block comments, and JSDoc survives declaration
emit, so the suppression now ships with the types. Codegen can't do this
itself: `extends Omit<ViewProps, 'pointerEvents'>` fails with "Unable to
handle prop spread: Omit" and dropping `WithDefault` fails with "A
default enum value is required".

## Test plan

- `yarn ts-check` and `yarn lint:js` in the package
- Codegen schema (`combine-js-to-schema-cli`, iOS and Android) identical
before and after
- `yarn build`, then installed the packed tarball into a fresh RN 0.87
app with `skipLibCheck: false`: the two RNGH TS2430 errors are gone,
only RN's own typing errors remain
- Same check against RN 0.88 declarations

Author: m-bert

packages/react-native-gesture-handler/src/specs/RNGestureHandlerButtonNativeComponent.ts

@@ -11,7 +11,7 @@ export type ButtonEvent = Readonly<{
   pointerType: CodegenTypes.Int32;
 }>;
 
-// @ts-ignore - Redefining pointerEvents with WithDefault for codegen, conflicts with ViewProps type but codegen needs it
+/** @ts-ignore - Redefining pointerEvents with WithDefault for codegen, conflicts with ViewProps type but codegen needs it */
 interface NativeProps extends ViewProps {
   // The events are namespaced with `Button` because the base view config on iOS
   // already registers `topPress` as a bubbling event — a direct event with the

packages/react-native-gesture-handler/src/specs/RNGestureHandlerDetectorNativeComponent.ts

@@ -41,7 +41,7 @@ export interface VirtualChildrenProps {
   viewTag: CodegenTypes.Int32;
 }
 
-// @ts-expect-error WithDefault adds `| null` to the type, which doesn't align with ViewProps.pointerEvents
+/** @ts-expect-error WithDefault adds `| null` to the type, which doesn't align with ViewProps.pointerEvents */
 // Using Exclude to remove null from the type makes the error go away, but breaks codegen.
 export interface NativeProps extends ViewProps {
   onGestureHandlerEvent?:

packages/react-native-gesture-handler/src/specs/RNGestureHandlerRootViewNativeComponent.ts

@@ -6,7 +6,7 @@ export interface RootViewNativeProps extends ViewProps {
   unstable_forceActive?: boolean;
 }
 
-// @ts-expect-error WithDefault adds null for codegen, unlike ViewProps.pointerEvents.
+/** @ts-expect-error WithDefault adds null for codegen, unlike ViewProps.pointerEvents. */
 interface NativeProps extends ViewProps {
   pointerEvents?: CodegenTypes.WithDefault<
     'box-none' | 'none' | 'box-only' | 'auto',