[flutter_tools] add needsFullRestart flag on hot runner

[Jasguerrero]

fixes: #92000

Pre-launch Checklist

• I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
• I read the [Tree Hygiene] wiki page, which explains my responsibilities.
• I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement].
• I signed the [CLA].
• I listed at least one issue that this PR fixes in the description above.
• I updated/added relevant documentation (doc comments with ///).
• I added new tests to check the change I am making, or this PR is [test-exempt].
• All existing and new tests are passing.

[jonahwilliams]

Instead of adding it here, I would add it to the ResidentRunner base class and document it. While its technically allowed to add new named parameters to overriden methods on subclasses, I think you should generally avoid that practice. It occasionally leads to surprises when a developer can't autocomplete a parameter due to the static type of a variable.

[jonahwilliams]

Can you add a doc comment on what needsFullRestart is for?

[jonahwilliams]

Doc comments should go on the method itself. Look at the flutter framework for examples of how parameters are documented. Usually something like:

/// One sentence summary about what foo does
///
/// [bar] is blah blah.
void foo(String bar);
```

[Jasguerrero]

I was following this particular example which apparently to have more than one line is acceptable. About going in the method agree I should move this up. https://dart.dev/guides/language/effective-dart/documentation#avoid-redundancy-with-the-surrounding-context

[jonahwilliams]

Thats fine, but it needs to go on the method itself and not the parameter

[jonahwilliams]

LGTM with nit

[jonahwilliams]

How about something like:

/// Connect to a flutter application.
///
/// [needsFullRestart] defaults to `true`, and controls if the frontend server should
/// compile a full dill. This should be set to `false` if this is called in [ResidentRunner.run], since that method already perfoms an initial compilation.

[jonahwilliams]

Still LGTM