[native_assets_cli] Add more info to generated files (#2120)

Author: dcharkes

pkgs/hook/tool/generate_syntax.dart

@@ -66,7 +66,15 @@ void main() {
                   ]
                   : null,
         ).analyze();
-    final output = SyntaxGenerator(analyzedSchema).generate();
+    final output =
+        SyntaxGenerator(
+          analyzedSchema,
+          header: '''
+// This file is generated, do not edit.
+// File generated by pkgs/hook/tool/generate_syntax.dart.
+// Must be rerun when pkgs/$packageName/doc/schema/ is modified.
+''',
+        ).generate();
     final outputUri = packageUri.resolve(
       '../native_assets_cli/lib/src/$packageName/syntax.g.dart',
     );

pkgs/json_syntax_generator/lib/src/generator/syntax_generator.dart

@@ -12,7 +12,9 @@ import 'normal_class_generator.dart';
 class SyntaxGenerator {
   final SchemaInfo schemaInfo;
 
-  SyntaxGenerator(this.schemaInfo);
+  final String header;
+
+  SyntaxGenerator(this.schemaInfo, {this.header = ''});
 
   String generate() {
     final buffer = StringBuffer();
@@ -22,7 +24,7 @@ class SyntaxGenerator {
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-// This file is generated, do not edit.
+$header
 
 // ignore_for_file: unused_element
 

pkgs/native_assets_cli/lib/src/code_assets/syntax.g.dart

@@ -3,6 +3,8 @@
 // BSD-style license that can be found in the LICENSE file.
 
 // This file is generated, do not edit.
+// File generated by pkgs/hook/tool/generate_syntax.dart.
+// Must be rerun when pkgs/code_assets/doc/schema/ is modified.
 
 // ignore_for_file: unused_element
 

pkgs/native_assets_cli/lib/src/data_assets/syntax.g.dart

@@ -3,6 +3,8 @@
 // BSD-style license that can be found in the LICENSE file.
 
 // This file is generated, do not edit.
+// File generated by pkgs/hook/tool/generate_syntax.dart.
+// Must be rerun when pkgs/data_assets/doc/schema/ is modified.
 
 // ignore_for_file: unused_element
 

pkgs/native_assets_cli/lib/src/hook/syntax.g.dart

@@ -3,6 +3,8 @@
 // BSD-style license that can be found in the LICENSE file.
 
 // This file is generated, do not edit.
+// File generated by pkgs/hook/tool/generate_syntax.dart.
+// Must be rerun when pkgs/hook/doc/schema/ is modified.
 
 // ignore_for_file: unused_element