Add "// dart format width=80" comment in generated code

[munificent]

After many years of users asking for it, we are adding support to the formatter for project-wide page width configuration using a surrounding analysis_options.yaml file (dart-lang/sdk#56863). However, tools like source_gen don't necessarily have access to (or want to access) IO or know where generated code will end up on disk.

To avoid breaking CI by having the code get generated and formatted at one width and then get formatted to a different width when the user runs dart format, we also added support for putting a marker comment in a file to specify an explicit width, like:

// dart format width=80

When this comment is present at the top of the file (before any code, but can be after other comments), then that comment will take precedence and the file will reliably be formatted at that width regardless of any surrounding configuration. So if code generators insert that comment at the top of the code they generate, they don't have to worry about reading the user's configuration.

This issue is requesting that source_gen be updated to add that comment to the code it generates. Since it's just a comment, it's safe to add this at any time. Let me know if you have any questions/feedback and I'll do my best.

[jakemac53]

cc @natebosch or @kevmoo could you take this on?