@bufbuild/protobuf 2.0.0 → 2.2.0

package/dist/cjs/wkt/gen/google/protobuf/descriptor_pb.d.ts

@@ -17,7 +17,10 @@ export type FileDescriptorSet = Message<"google.protobuf.FileDescriptorSet"> & {
     file: FileDescriptorProto[];
 };
 /**
- * JSON type for the message google.protobuf.FileDescriptorSet.
+ * The protocol compiler can output a FileDescriptorSet containing the .proto
+ * files it parses.
+ *
+ * @generated from message google.protobuf.FileDescriptorSet
  */
 export type FileDescriptorSetJson = {
     /**
@@ -115,30 +118,45 @@ export type FileDescriptorProto = Message<"google.protobuf.FileDescriptorProto">
     edition: Edition;
 };
 /**
- * JSON type for the message google.protobuf.FileDescriptorProto.
+ * Describes a complete .proto file.
+ *
+ * @generated from message google.protobuf.FileDescriptorProto
  */
 export type FileDescriptorProtoJson = {
     /**
+     * file name, relative to root of source tree
+     *
      * @generated from field: optional string name = 1;
      */
     name?: string;
     /**
+     * e.g. "foo", "foo.bar", etc.
+     *
      * @generated from field: optional string package = 2;
      */
     package?: string;
     /**
+     * Names of files imported by this file.
+     *
      * @generated from field: repeated string dependency = 3;
      */
     dependency?: string[];
     /**
+     * Indexes of the public imported files in the dependency list above.
+     *
      * @generated from field: repeated int32 public_dependency = 10;
      */
     publicDependency?: number[];
     /**
+     * Indexes of the weak imported files in the dependency list.
+     * For Google-internal migration only. Do not use.
+     *
      * @generated from field: repeated int32 weak_dependency = 11;
      */
     weakDependency?: number[];
     /**
+     * All top-level definitions in this file.
+     *
      * @generated from field: repeated google.protobuf.DescriptorProto message_type = 4;
      */
     messageType?: DescriptorProtoJson[];
@@ -159,14 +177,26 @@ export type FileDescriptorProtoJson = {
      */
     options?: FileOptionsJson;
     /**
+     * This field contains optional information about the original source code.
+     * You may safely remove this entire field without harming runtime
+     * functionality of the descriptors -- the information is needed only by
+     * development tools.
+     *
      * @generated from field: optional google.protobuf.SourceCodeInfo source_code_info = 9;
      */
     sourceCodeInfo?: SourceCodeInfoJson;
     /**
+     * The syntax of the proto file.
+     * The supported values are "proto2", "proto3", and "editions".
+     *
+     * If `edition` is present, this value must be "editions".
+     *
      * @generated from field: optional string syntax = 12;
      */
     syntax?: string;
     /**
+     * The edition of the proto file.
+     *
      * @generated from field: optional google.protobuf.Edition edition = 14;
      */
     edition?: EditionJson;
@@ -227,7 +257,9 @@ export type DescriptorProto = Message<"google.protobuf.DescriptorProto"> & {
     reservedName: string[];
 };
 /**
- * JSON type for the message google.protobuf.DescriptorProto.
+ * Describes a message type.
+ *
+ * @generated from message google.protobuf.DescriptorProto
  */
 export type DescriptorProtoJson = {
     /**
@@ -267,6 +299,9 @@ export type DescriptorProtoJson = {
      */
     reservedRange?: DescriptorProto_ReservedRangeJson[];
     /**
+     * Reserved field names, which may not be used by fields in the same message.
+     * A given name may only be reserved once.
+     *
      * @generated from field: repeated string reserved_name = 10;
      */
     reservedName?: string[];
@@ -298,14 +333,18 @@ export type DescriptorProto_ExtensionRange = Message<"google.protobuf.Descriptor
     options?: ExtensionRangeOptions;
 };
 /**
- * JSON type for the message google.protobuf.DescriptorProto.ExtensionRange.
+ * @generated from message google.protobuf.DescriptorProto.ExtensionRange
  */
 export type DescriptorProto_ExtensionRangeJson = {
     /**
+     * Inclusive.
+     *
      * @generated from field: optional int32 start = 1;
      */
     start?: number;
     /**
+     * Exclusive.
+     *
      * @generated from field: optional int32 end = 2;
      */
     end?: number;
@@ -341,14 +380,22 @@ export type DescriptorProto_ReservedRange = Message<"google.protobuf.DescriptorP
     end: number;
 };
 /**
- * JSON type for the message google.protobuf.DescriptorProto.ReservedRange.
+ * Range of reserved tag numbers. Reserved tag numbers may not be used by
+ * fields or extension ranges in the same message. Reserved ranges may
+ * not overlap.
+ *
+ * @generated from message google.protobuf.DescriptorProto.ReservedRange
  */
 export type DescriptorProto_ReservedRangeJson = {
     /**
+     * Inclusive.
+     *
      * @generated from field: optional int32 start = 1;
      */
     start?: number;
     /**
+     * Exclusive.
+     *
      * @generated from field: optional int32 end = 2;
      */
     end?: number;
@@ -392,22 +439,34 @@ export type ExtensionRangeOptions = Message<"google.protobuf.ExtensionRangeOptio
     verification: ExtensionRangeOptions_VerificationState;
 };
 /**
- * JSON type for the message google.protobuf.ExtensionRangeOptions.
+ * @generated from message google.protobuf.ExtensionRangeOptions
  */
 export type ExtensionRangeOptionsJson = {
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
     /**
+     * For external users: DO NOT USE. We are in the process of open sourcing
+     * extension declaration and executing internal cleanups before it can be
+     * used externally.
+     *
      * @generated from field: repeated google.protobuf.ExtensionRangeOptions.Declaration declaration = 2;
      */
     declaration?: ExtensionRangeOptions_DeclarationJson[];
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 50;
      */
     features?: FeatureSetJson;
     /**
+     * The verification state of the range.
+     * TODO: flip the default to DECLARATION once all empty ranges
+     * are marked as UNVERIFIED.
+     *
      * @generated from field: optional google.protobuf.ExtensionRangeOptions.VerificationState verification = 3 [default = UNVERIFIED];
      */
     verification?: ExtensionRangeOptions_VerificationStateJson;
@@ -459,26 +518,42 @@ export type ExtensionRangeOptions_Declaration = Message<"google.protobuf.Extensi
     repeated: boolean;
 };
 /**
- * JSON type for the message google.protobuf.ExtensionRangeOptions.Declaration.
+ * @generated from message google.protobuf.ExtensionRangeOptions.Declaration
  */
 export type ExtensionRangeOptions_DeclarationJson = {
     /**
+     * The extension number declared within the extension range.
+     *
      * @generated from field: optional int32 number = 1;
      */
     number?: number;
     /**
+     * The fully-qualified name of the extension field. There must be a leading
+     * dot in front of the full name.
+     *
      * @generated from field: optional string full_name = 2;
      */
     fullName?: string;
     /**
+     * The fully-qualified type name of the extension field. Unlike
+     * Metadata.type, Declaration.type must have a leading dot for messages
+     * and enums.
+     *
      * @generated from field: optional string type = 3;
      */
     type?: string;
     /**
+     * If true, indicates that the number is reserved in the extension range,
+     * and any extension field with the number will fail to compile. Set this
+     * when a declared extension field is deleted.
+     *
      * @generated from field: optional bool reserved = 5;
      */
     reserved?: boolean;
     /**
+     * If true, indicates that the extension must be defined as repeated.
+     * Otherwise the extension must be defined as optional.
+     *
      * @generated from field: optional bool repeated = 6;
      */
     repeated?: boolean;
@@ -506,7 +581,9 @@ export declare enum ExtensionRangeOptions_VerificationState {
     UNVERIFIED = 1
 }
 /**
- * JSON type for the enum google.protobuf.ExtensionRangeOptions.VerificationState.
+ * The verification state of the extension range.
+ *
+ * @generated from enum google.protobuf.ExtensionRangeOptions.VerificationState
  */
 export type ExtensionRangeOptions_VerificationStateJson = "DECLARATION" | "UNVERIFIED";
 /**
@@ -612,7 +689,9 @@ export type FieldDescriptorProto = Message<"google.protobuf.FieldDescriptorProto
     proto3Optional: boolean;
 };
 /**
- * JSON type for the message google.protobuf.FieldDescriptorProto.
+ * Describes a field within a message.
+ *
+ * @generated from message google.protobuf.FieldDescriptorProto
  */
 export type FieldDescriptorProtoJson = {
     /**
@@ -628,26 +707,51 @@ export type FieldDescriptorProtoJson = {
      */
     label?: FieldDescriptorProto_LabelJson;
     /**
+     * If type_name is set, this need not be set.  If both this and type_name
+     * are set, this must be one of TYPE_ENUM, TYPE_MESSAGE or TYPE_GROUP.
+     *
      * @generated from field: optional google.protobuf.FieldDescriptorProto.Type type = 5;
      */
     type?: FieldDescriptorProto_TypeJson;
     /**
+     * For message and enum types, this is the name of the type.  If the name
+     * starts with a '.', it is fully-qualified.  Otherwise, C++-like scoping
+     * rules are used to find the type (i.e. first the nested types within this
+     * message are searched, then within the parent, on up to the root
+     * namespace).
+     *
      * @generated from field: optional string type_name = 6;
      */
     typeName?: string;
     /**
+     * For extensions, this is the name of the type being extended.  It is
+     * resolved in the same manner as type_name.
+     *
      * @generated from field: optional string extendee = 2;
      */
     extendee?: string;
     /**
+     * For numeric types, contains the original text representation of the value.
+     * For booleans, "true" or "false".
+     * For strings, contains the default text contents (not escaped in any way).
+     * For bytes, contains the C escaped value.  All bytes >= 128 are escaped.
+     *
      * @generated from field: optional string default_value = 7;
      */
     defaultValue?: string;
     /**
+     * If set, gives the index of a oneof in the containing type's oneof_decl
+     * list.  This field is a member of that oneof.
+     *
      * @generated from field: optional int32 oneof_index = 9;
      */
     oneofIndex?: number;
     /**
+     * JSON name of this field. The value is set by protocol compiler. If the
+     * user has set a "json_name" option on this field, that option's value
+     * will be used. Otherwise, it's deduced from the field's name by converting
+     * it to camelCase.
+     *
      * @generated from field: optional string json_name = 10;
      */
     jsonName?: string;
@@ -656,6 +760,28 @@ export type FieldDescriptorProtoJson = {
      */
     options?: FieldOptionsJson;
     /**
+     * If true, this is a proto3 "optional". When a proto3 field is optional, it
+     * tracks presence regardless of field type.
+     *
+     * When proto3_optional is true, this field must belong to a oneof to signal
+     * to old proto3 clients that presence is tracked for this field. This oneof
+     * is known as a "synthetic" oneof, and this field must be its sole member
+     * (each proto3 optional field gets its own synthetic oneof). Synthetic oneofs
+     * exist in the descriptor only, and do not generate any API. Synthetic oneofs
+     * must be ordered after all "real" oneofs.
+     *
+     * For message fields, proto3_optional doesn't create any semantic change,
+     * since non-repeated message fields always track presence. However it still
+     * indicates the semantic detail of whether the user wrote "optional" or not.
+     * This can be useful for round-tripping the .proto file. For consistency we
+     * give message fields a synthetic oneof also, even though it is not required
+     * to track presence. This is especially important because the parser can't
+     * tell if a field is a message or an enum, so it must always create a
+     * synthetic oneof.
+     *
+     * Proto2 optional fields do not set this flag, because they already indicate
+     * optional with `LABEL_OPTIONAL`.
+     *
      * @generated from field: optional bool proto3_optional = 17;
      */
     proto3Optional?: boolean;
@@ -766,7 +892,7 @@ export declare enum FieldDescriptorProto_Type {
     SINT64 = 18
 }
 /**
- * JSON type for the enum google.protobuf.FieldDescriptorProto.Type.
+ * @generated from enum google.protobuf.FieldDescriptorProto.Type
  */
 export type FieldDescriptorProto_TypeJson = "TYPE_DOUBLE" | "TYPE_FLOAT" | "TYPE_INT64" | "TYPE_UINT64" | "TYPE_INT32" | "TYPE_FIXED64" | "TYPE_FIXED32" | "TYPE_BOOL" | "TYPE_STRING" | "TYPE_GROUP" | "TYPE_MESSAGE" | "TYPE_BYTES" | "TYPE_UINT32" | "TYPE_ENUM" | "TYPE_SFIXED32" | "TYPE_SFIXED64" | "TYPE_SINT32" | "TYPE_SINT64";
 /**
@@ -797,7 +923,7 @@ export declare enum FieldDescriptorProto_Label {
     REQUIRED = 2
 }
 /**
- * JSON type for the enum google.protobuf.FieldDescriptorProto.Label.
+ * @generated from enum google.protobuf.FieldDescriptorProto.Label
  */
 export type FieldDescriptorProto_LabelJson = "LABEL_OPTIONAL" | "LABEL_REPEATED" | "LABEL_REQUIRED";
 /**
@@ -820,7 +946,9 @@ export type OneofDescriptorProto = Message<"google.protobuf.OneofDescriptorProto
     options?: OneofOptions;
 };
 /**
- * JSON type for the message google.protobuf.OneofDescriptorProto.
+ * Describes a oneof.
+ *
+ * @generated from message google.protobuf.OneofDescriptorProto
  */
 export type OneofDescriptorProtoJson = {
     /**
@@ -872,7 +1000,9 @@ export type EnumDescriptorProto = Message<"google.protobuf.EnumDescriptorProto">
     reservedName: string[];
 };
 /**
- * JSON type for the message google.protobuf.EnumDescriptorProto.
+ * Describes an enum type.
+ *
+ * @generated from message google.protobuf.EnumDescriptorProto
  */
 export type EnumDescriptorProtoJson = {
     /**
@@ -888,10 +1018,17 @@ export type EnumDescriptorProtoJson = {
      */
     options?: EnumOptionsJson;
     /**
+     * Range of reserved numeric values. Reserved numeric values may not be used
+     * by enum values in the same enum declaration. Reserved ranges may not
+     * overlap.
+     *
      * @generated from field: repeated google.protobuf.EnumDescriptorProto.EnumReservedRange reserved_range = 4;
      */
     reservedRange?: EnumDescriptorProto_EnumReservedRangeJson[];
     /**
+     * Reserved enum value names, which may not be reused. A given name may only
+     * be reserved once.
+     *
      * @generated from field: repeated string reserved_name = 5;
      */
     reservedName?: string[];
@@ -926,14 +1063,25 @@ export type EnumDescriptorProto_EnumReservedRange = Message<"google.protobuf.Enu
     end: number;
 };
 /**
- * JSON type for the message google.protobuf.EnumDescriptorProto.EnumReservedRange.
+ * Range of reserved numeric values. Reserved values may not be used by
+ * entries in the same enum. Reserved ranges may not overlap.
+ *
+ * Note that this is distinct from DescriptorProto.ReservedRange in that it
+ * is inclusive such that it can appropriately represent the entire int32
+ * domain.
+ *
+ * @generated from message google.protobuf.EnumDescriptorProto.EnumReservedRange
  */
 export type EnumDescriptorProto_EnumReservedRangeJson = {
     /**
+     * Inclusive.
+     *
      * @generated from field: optional int32 start = 1;
      */
     start?: number;
     /**
+     * Inclusive.
+     *
      * @generated from field: optional int32 end = 2;
      */
     end?: number;
@@ -963,7 +1111,9 @@ export type EnumValueDescriptorProto = Message<"google.protobuf.EnumValueDescrip
     options?: EnumValueOptions;
 };
 /**
- * JSON type for the message google.protobuf.EnumValueDescriptorProto.
+ * Describes a value within an enum.
+ *
+ * @generated from message google.protobuf.EnumValueDescriptorProto
  */
 export type EnumValueDescriptorProtoJson = {
     /**
@@ -1004,7 +1154,9 @@ export type ServiceDescriptorProto = Message<"google.protobuf.ServiceDescriptorP
     options?: ServiceOptions;
 };
 /**
- * JSON type for the message google.protobuf.ServiceDescriptorProto.
+ * Describes a service.
+ *
+ * @generated from message google.protobuf.ServiceDescriptorProto
  */
 export type ServiceDescriptorProtoJson = {
     /**
@@ -1064,7 +1216,9 @@ export type MethodDescriptorProto = Message<"google.protobuf.MethodDescriptorPro
     serverStreaming: boolean;
 };
 /**
- * JSON type for the message google.protobuf.MethodDescriptorProto.
+ * Describes a method of a service.
+ *
+ * @generated from message google.protobuf.MethodDescriptorProto
  */
 export type MethodDescriptorProtoJson = {
     /**
@@ -1072,6 +1226,9 @@ export type MethodDescriptorProtoJson = {
      */
     name?: string;
     /**
+     * Input and output type names.  These are resolved in the same way as
+     * FieldDescriptorProto.type_name, but must refer to a message type.
+     *
      * @generated from field: optional string input_type = 2;
      */
     inputType?: string;
@@ -1084,10 +1241,14 @@ export type MethodDescriptorProtoJson = {
      */
     options?: MethodOptionsJson;
     /**
+     * Identifies if client streams multiple client messages
+     *
      * @generated from field: optional bool client_streaming = 5 [default = false];
      */
     clientStreaming?: boolean;
     /**
+     * Identifies if server streams multiple server messages
+     *
      * @generated from field: optional bool server_streaming = 6 [default = false];
      */
     serverStreaming?: boolean;
@@ -1274,26 +1435,58 @@ export type FileOptions = Message<"google.protobuf.FileOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.FileOptions.
+ * @generated from message google.protobuf.FileOptions
  */
 export type FileOptionsJson = {
     /**
+     * Sets the Java package where classes generated from this .proto will be
+     * placed.  By default, the proto package is used, but this is often
+     * inappropriate because proto packages do not normally start with backwards
+     * domain names.
+     *
      * @generated from field: optional string java_package = 1;
      */
     javaPackage?: string;
     /**
+     * Controls the name of the wrapper Java class generated for the .proto file.
+     * That class will always contain the .proto file's getDescriptor() method as
+     * well as any top-level extensions defined in the .proto file.
+     * If java_multiple_files is disabled, then all the other classes from the
+     * .proto file will be nested inside the single wrapper outer class.
+     *
      * @generated from field: optional string java_outer_classname = 8;
      */
     javaOuterClassname?: string;
     /**
+     * If enabled, then the Java code generator will generate a separate .java
+     * file for each top-level message, enum, and service defined in the .proto
+     * file.  Thus, these types will *not* be nested inside the wrapper class
+     * named by java_outer_classname.  However, the wrapper class will still be
+     * generated to contain the file's getDescriptor() method as well as any
+     * top-level extensions defined in the file.
+     *
      * @generated from field: optional bool java_multiple_files = 10 [default = false];
      */
     javaMultipleFiles?: boolean;
     /**
+     * This option does nothing.
+     *
      * @generated from field: optional bool java_generate_equals_and_hash = 20 [deprecated = true];
+     * @deprecated
      */
     javaGenerateEqualsAndHash?: boolean;
     /**
+     * A proto2 file can set this to true to opt in to UTF-8 checking for Java,
+     * which will throw an exception if invalid UTF-8 is parsed from the wire or
+     * assigned to a string field.
+     *
+     * TODO: clarify exactly what kinds of field types this option
+     * applies to, and update these docs accordingly.
+     *
+     * Proto3 files already perform these checks. Setting the option explicitly to
+     * false has no effect: it cannot be used to opt proto3 files out of UTF-8
+     * checks.
+     *
      * @generated from field: optional bool java_string_check_utf8 = 27 [default = false];
      */
     javaStringCheckUtf8?: boolean;
@@ -1302,10 +1495,27 @@ export type FileOptionsJson = {
      */
     optimizeFor?: FileOptions_OptimizeModeJson;
     /**
+     * Sets the Go package where structs generated from this .proto will be
+     * placed. If omitted, the Go package will be derived from the following:
+     *   - The basename of the package import path, if provided.
+     *   - Otherwise, the package statement in the .proto file, if present.
+     *   - Otherwise, the basename of the .proto file, without extension.
+     *
      * @generated from field: optional string go_package = 11;
      */
     goPackage?: string;
     /**
+     * Should generic services be generated in each language?  "Generic" services
+     * are not specific to any particular RPC system.  They are generated by the
+     * main code generators in each language (without additional plugins).
+     * Generic services were the only kind of service generation supported by
+     * early versions of google.protobuf.
+     *
+     * Generic services are now considered deprecated in favor of using plugins
+     * that generate code specific to your particular RPC system.  Therefore,
+     * these default to false.  Old code which depends on generic services should
+     * explicitly set them to true.
+     *
      * @generated from field: optional bool cc_generic_services = 16 [default = false];
      */
     ccGenericServices?: boolean;
@@ -1318,46 +1528,84 @@ export type FileOptionsJson = {
      */
     pyGenericServices?: boolean;
     /**
+     * Is this file deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for everything in the file, or it will be completely ignored; in the very
+     * least, this is a formalization for deprecating files.
+     *
      * @generated from field: optional bool deprecated = 23 [default = false];
      */
     deprecated?: boolean;
     /**
+     * Enables the use of arenas for the proto messages in this file. This applies
+     * only to generated classes for C++.
+     *
      * @generated from field: optional bool cc_enable_arenas = 31 [default = true];
      */
     ccEnableArenas?: boolean;
     /**
+     * Sets the objective c class prefix which is prepended to all objective c
+     * generated classes from this .proto. There is no default.
+     *
      * @generated from field: optional string objc_class_prefix = 36;
      */
     objcClassPrefix?: string;
     /**
+     * Namespace for generated classes; defaults to the package.
+     *
      * @generated from field: optional string csharp_namespace = 37;
      */
     csharpNamespace?: string;
     /**
+     * By default Swift generators will take the proto package and CamelCase it
+     * replacing '.' with underscore and use that to prefix the types/symbols
+     * defined. When this options is provided, they will use this value instead
+     * to prefix the types/symbols defined.
+     *
      * @generated from field: optional string swift_prefix = 39;
      */
     swiftPrefix?: string;
     /**
+     * Sets the php class prefix which is prepended to all php generated classes
+     * from this .proto. Default is empty.
+     *
      * @generated from field: optional string php_class_prefix = 40;
      */
     phpClassPrefix?: string;
     /**
+     * Use this option to change the namespace of php generated classes. Default
+     * is empty. When this option is empty, the package name will be used for
+     * determining the namespace.
+     *
      * @generated from field: optional string php_namespace = 41;
      */
     phpNamespace?: string;
     /**
-     * @generated from field: optional string php_metadata_namespace = 44;
-     */
-    phpMetadataNamespace?: string;
+     * Use this option to change the namespace of php generated metadata classes.
+     * Default is empty. When this option is empty, the proto file name will be
+     * used for determining the namespace.
+     *
+     * @generated from field: optional string php_metadata_namespace = 44;
+     */
+    phpMetadataNamespace?: string;
     /**
+     * Use this option to change the package of ruby generated classes. Default
+     * is empty. When this option is not set, the package name will be used for
+     * determining the ruby package.
+     *
      * @generated from field: optional string ruby_package = 45;
      */
     rubyPackage?: string;
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 50;
      */
     features?: FeatureSetJson;
     /**
+     * The parser stores options it doesn't recognize here.
+     * See the documentation for the "Options" section above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -1395,7 +1643,9 @@ export declare enum FileOptions_OptimizeMode {
     LITE_RUNTIME = 3
 }
 /**
- * JSON type for the enum google.protobuf.FileOptions.OptimizeMode.
+ * Generated classes can be optimized for speed or code size.
+ *
+ * @generated from enum google.protobuf.FileOptions.OptimizeMode
  */
 export type FileOptions_OptimizeModeJson = "SPEED" | "CODE_SIZE" | "LITE_RUNTIME";
 /**
@@ -1502,34 +1752,100 @@ export type MessageOptions = Message<"google.protobuf.MessageOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.MessageOptions.
+ * @generated from message google.protobuf.MessageOptions
  */
 export type MessageOptionsJson = {
     /**
+     * Set true to use the old proto1 MessageSet wire format for extensions.
+     * This is provided for backwards-compatibility with the MessageSet wire
+     * format.  You should not use this for any other reason:  It's less
+     * efficient, has fewer features, and is more complicated.
+     *
+     * The message must be defined exactly as follows:
+     *   message Foo {
+     *     option message_set_wire_format = true;
+     *     extensions 4 to max;
+     *   }
+     * Note that the message cannot have any defined fields; MessageSets only
+     * have extensions.
+     *
+     * All extensions of your type must be singular messages; e.g. they cannot
+     * be int32s, enums, or repeated messages.
+     *
+     * Because this is an option, the above two restrictions are not enforced by
+     * the protocol compiler.
+     *
      * @generated from field: optional bool message_set_wire_format = 1 [default = false];
      */
     messageSetWireFormat?: boolean;
     /**
+     * Disables the generation of the standard "descriptor()" accessor, which can
+     * conflict with a field of the same name.  This is meant to make migration
+     * from proto1 easier; new code should avoid fields named "descriptor".
+     *
      * @generated from field: optional bool no_standard_descriptor_accessor = 2 [default = false];
      */
     noStandardDescriptorAccessor?: boolean;
     /**
+     * Is this message deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for the message, or it will be completely ignored; in the very least,
+     * this is a formalization for deprecating messages.
+     *
      * @generated from field: optional bool deprecated = 3 [default = false];
      */
     deprecated?: boolean;
     /**
+     * Whether the message is an automatically generated map entry type for the
+     * maps field.
+     *
+     * For maps fields:
+     *     map<KeyType, ValueType> map_field = 1;
+     * The parsed descriptor looks like:
+     *     message MapFieldEntry {
+     *         option map_entry = true;
+     *         optional KeyType key = 1;
+     *         optional ValueType value = 2;
+     *     }
+     *     repeated MapFieldEntry map_field = 1;
+     *
+     * Implementations may choose not to generate the map_entry=true message, but
+     * use a native map in the target language to hold the keys and values.
+     * The reflection APIs in such implementations still need to work as
+     * if the field is a repeated message field.
+     *
+     * NOTE: Do not set the option in .proto files. Always use the maps syntax
+     * instead. The option should only be implicitly set by the proto compiler
+     * parser.
+     *
      * @generated from field: optional bool map_entry = 7;
      */
     mapEntry?: boolean;
     /**
+     * Enable the legacy handling of JSON field name conflicts.  This lowercases
+     * and strips underscored from the fields before comparison in proto3 only.
+     * The new behavior takes `json_name` into account and applies to proto2 as
+     * well.
+     *
+     * This should only be used as a temporary measure against broken builds due
+     * to the change in behavior for JSON field name conflicts.
+     *
+     * TODO This is legacy behavior we plan to remove once downstream
+     * teams have had time to migrate.
+     *
      * @generated from field: optional bool deprecated_legacy_json_field_conflicts = 11 [deprecated = true];
+     * @deprecated
      */
     deprecatedLegacyJsonFieldConflicts?: boolean;
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 12;
      */
     features?: FeatureSetJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -1544,12 +1860,13 @@ export declare const MessageOptionsSchema: GenMessage<MessageOptions, MessageOpt
  */
 export type FieldOptions = Message<"google.protobuf.FieldOptions"> & {
     /**
+     * NOTE: ctype is deprecated. Use `features.(pb.cpp).string_type` instead.
      * The ctype option instructs the C++ code generator to use a different
      * representation of the field than it normally would.  See the specific
      * options below.  This option is only implemented to support use of
      * [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of
-     * type "bytes" in the open source release -- sorry, we'll try to include
-     * other types in a future version!
+     * type "bytes" in the open source release.
+     * TODO: make ctype actually deprecated.
      *
      * @generated from field: optional google.protobuf.FieldOptions.CType ctype = 1 [default = STRING];
      */
@@ -1669,38 +1986,103 @@ export type FieldOptions = Message<"google.protobuf.FieldOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.FieldOptions.
+ * @generated from message google.protobuf.FieldOptions
  */
 export type FieldOptionsJson = {
     /**
+     * NOTE: ctype is deprecated. Use `features.(pb.cpp).string_type` instead.
+     * The ctype option instructs the C++ code generator to use a different
+     * representation of the field than it normally would.  See the specific
+     * options below.  This option is only implemented to support use of
+     * [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of
+     * type "bytes" in the open source release.
+     * TODO: make ctype actually deprecated.
+     *
      * @generated from field: optional google.protobuf.FieldOptions.CType ctype = 1 [default = STRING];
      */
     ctype?: FieldOptions_CTypeJson;
     /**
+     * The packed option can be enabled for repeated primitive fields to enable
+     * a more efficient representation on the wire. Rather than repeatedly
+     * writing the tag and type for each element, the entire array is encoded as
+     * a single length-delimited blob. In proto3, only explicit setting it to
+     * false will avoid using packed encoding.  This option is prohibited in
+     * Editions, but the `repeated_field_encoding` feature can be used to control
+     * the behavior.
+     *
      * @generated from field: optional bool packed = 2;
      */
     packed?: boolean;
     /**
+     * The jstype option determines the JavaScript type used for values of the
+     * field.  The option is permitted only for 64 bit integral and fixed types
+     * (int64, uint64, sint64, fixed64, sfixed64).  A field with jstype JS_STRING
+     * is represented as JavaScript string, which avoids loss of precision that
+     * can happen when a large value is converted to a floating point JavaScript.
+     * Specifying JS_NUMBER for the jstype causes the generated JavaScript code to
+     * use the JavaScript "number" type.  The behavior of the default option
+     * JS_NORMAL is implementation dependent.
+     *
+     * This option is an enum to permit additional types to be added, e.g.
+     * goog.math.Integer.
+     *
      * @generated from field: optional google.protobuf.FieldOptions.JSType jstype = 6 [default = JS_NORMAL];
      */
     jstype?: FieldOptions_JSTypeJson;
     /**
+     * Should this field be parsed lazily?  Lazy applies only to message-type
+     * fields.  It means that when the outer message is initially parsed, the
+     * inner message's contents will not be parsed but instead stored in encoded
+     * form.  The inner message will actually be parsed when it is first accessed.
+     *
+     * This is only a hint.  Implementations are free to choose whether to use
+     * eager or lazy parsing regardless of the value of this option.  However,
+     * setting this option true suggests that the protocol author believes that
+     * using lazy parsing on this field is worth the additional bookkeeping
+     * overhead typically needed to implement it.
+     *
+     * This option does not affect the public interface of any generated code;
+     * all method signatures remain the same.  Furthermore, thread-safety of the
+     * interface is not affected by this option; const methods remain safe to
+     * call from multiple threads concurrently, while non-const methods continue
+     * to require exclusive access.
+     *
+     * Note that lazy message fields are still eagerly verified to check
+     * ill-formed wireformat or missing required fields. Calling IsInitialized()
+     * on the outer message would fail if the inner message has missing required
+     * fields. Failed verification would result in parsing failure (except when
+     * uninitialized messages are acceptable).
+     *
      * @generated from field: optional bool lazy = 5 [default = false];
      */
     lazy?: boolean;
     /**
+     * unverified_lazy does no correctness checks on the byte stream. This should
+     * only be used where lazy with verification is prohibitive for performance
+     * reasons.
+     *
      * @generated from field: optional bool unverified_lazy = 15 [default = false];
      */
     unverifiedLazy?: boolean;
     /**
+     * Is this field deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for accessors, or it will be completely ignored; in the very least, this
+     * is a formalization for deprecating fields.
+     *
      * @generated from field: optional bool deprecated = 3 [default = false];
      */
     deprecated?: boolean;
     /**
+     * For Google-internal migration only. Do not use.
+     *
      * @generated from field: optional bool weak = 10 [default = false];
      */
     weak?: boolean;
     /**
+     * Indicate that the field value should not be printed out when using debug
+     * formats, e.g. when the field contains sensitive credentials.
+     *
      * @generated from field: optional bool debug_redact = 16 [default = false];
      */
     debugRedact?: boolean;
@@ -1717,6 +2099,8 @@ export type FieldOptionsJson = {
      */
     editionDefaults?: FieldOptions_EditionDefaultJson[];
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 21;
      */
     features?: FeatureSetJson;
@@ -1725,6 +2109,8 @@ export type FieldOptionsJson = {
      */
     featureSupport?: FieldOptions_FeatureSupportJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -1750,7 +2136,7 @@ export type FieldOptions_EditionDefault = Message<"google.protobuf.FieldOptions.
     value: string;
 };
 /**
- * JSON type for the message google.protobuf.FieldOptions.EditionDefault.
+ * @generated from message google.protobuf.FieldOptions.EditionDefault
  */
 export type FieldOptions_EditionDefaultJson = {
     /**
@@ -1758,6 +2144,8 @@ export type FieldOptions_EditionDefaultJson = {
      */
     edition?: EditionJson;
     /**
+     * Textproto value.
+     *
      * @generated from field: optional string value = 2;
      */
     value?: string;
@@ -1805,22 +2193,38 @@ export type FieldOptions_FeatureSupport = Message<"google.protobuf.FieldOptions.
     editionRemoved: Edition;
 };
 /**
- * JSON type for the message google.protobuf.FieldOptions.FeatureSupport.
+ * Information about the support window of a feature.
+ *
+ * @generated from message google.protobuf.FieldOptions.FeatureSupport
  */
 export type FieldOptions_FeatureSupportJson = {
     /**
+     * The edition that this feature was first available in.  In editions
+     * earlier than this one, the default assigned to EDITION_LEGACY will be
+     * used, and proto files will not be able to override it.
+     *
      * @generated from field: optional google.protobuf.Edition edition_introduced = 1;
      */
     editionIntroduced?: EditionJson;
     /**
+     * The edition this feature becomes deprecated in.  Using this after this
+     * edition may trigger warnings.
+     *
      * @generated from field: optional google.protobuf.Edition edition_deprecated = 2;
      */
     editionDeprecated?: EditionJson;
     /**
+     * The deprecation warning text if this feature is used after the edition it
+     * was marked deprecated in.
+     *
      * @generated from field: optional string deprecation_warning = 3;
      */
     deprecationWarning?: string;
     /**
+     * The edition this feature is no longer available in.  In editions after
+     * this one, the last default assigned will be used, and proto files will
+     * not be able to override it.
+     *
      * @generated from field: optional google.protobuf.Edition edition_removed = 4;
      */
     editionRemoved?: EditionJson;
@@ -1857,7 +2261,7 @@ export declare enum FieldOptions_CType {
     STRING_PIECE = 2
 }
 /**
- * JSON type for the enum google.protobuf.FieldOptions.CType.
+ * @generated from enum google.protobuf.FieldOptions.CType
  */
 export type FieldOptions_CTypeJson = "STRING" | "CORD" | "STRING_PIECE";
 /**
@@ -1888,7 +2292,7 @@ export declare enum FieldOptions_JSType {
     JS_NUMBER = 2
 }
 /**
- * JSON type for the enum google.protobuf.FieldOptions.JSType.
+ * @generated from enum google.protobuf.FieldOptions.JSType
  */
 export type FieldOptions_JSTypeJson = "JS_NORMAL" | "JS_STRING" | "JS_NUMBER";
 /**
@@ -1917,7 +2321,11 @@ export declare enum FieldOptions_OptionRetention {
     RETENTION_SOURCE = 2
 }
 /**
- * JSON type for the enum google.protobuf.FieldOptions.OptionRetention.
+ * If set to RETENTION_SOURCE, the option will be omitted from the binary.
+ * Note: as of January 2023, support for this is in progress and does not yet
+ * have an effect (b/264593489).
+ *
+ * @generated from enum google.protobuf.FieldOptions.OptionRetention
  */
 export type FieldOptions_OptionRetentionJson = "RETENTION_UNKNOWN" | "RETENTION_RUNTIME" | "RETENTION_SOURCE";
 /**
@@ -1975,7 +2383,12 @@ export declare enum FieldOptions_OptionTargetType {
     TARGET_TYPE_METHOD = 9
 }
 /**
- * JSON type for the enum google.protobuf.FieldOptions.OptionTargetType.
+ * This indicates the types of entities that the field may apply to when used
+ * as an option. If it is unset, then the field may be freely used as an
+ * option on any kind of entity. Note: as of January 2023, support for this is
+ * in progress and does not yet have an effect (b/264593489).
+ *
+ * @generated from enum google.protobuf.FieldOptions.OptionTargetType
  */
 export type FieldOptions_OptionTargetTypeJson = "TARGET_TYPE_UNKNOWN" | "TARGET_TYPE_FILE" | "TARGET_TYPE_EXTENSION_RANGE" | "TARGET_TYPE_MESSAGE" | "TARGET_TYPE_FIELD" | "TARGET_TYPE_ONEOF" | "TARGET_TYPE_ENUM" | "TARGET_TYPE_ENUM_ENTRY" | "TARGET_TYPE_SERVICE" | "TARGET_TYPE_METHOD";
 /**
@@ -2000,14 +2413,18 @@ export type OneofOptions = Message<"google.protobuf.OneofOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.OneofOptions.
+ * @generated from message google.protobuf.OneofOptions
  */
 export type OneofOptionsJson = {
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 1;
      */
     features?: FeatureSetJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -2063,26 +2480,46 @@ export type EnumOptions = Message<"google.protobuf.EnumOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.EnumOptions.
+ * @generated from message google.protobuf.EnumOptions
  */
 export type EnumOptionsJson = {
     /**
+     * Set this option to true to allow mapping different tag names to the same
+     * value.
+     *
      * @generated from field: optional bool allow_alias = 2;
      */
     allowAlias?: boolean;
     /**
+     * Is this enum deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for the enum, or it will be completely ignored; in the very least, this
+     * is a formalization for deprecating enums.
+     *
      * @generated from field: optional bool deprecated = 3 [default = false];
      */
     deprecated?: boolean;
     /**
+     * Enable the legacy handling of JSON field name conflicts.  This lowercases
+     * and strips underscored from the fields before comparison in proto3 only.
+     * The new behavior takes `json_name` into account and applies to proto2 as
+     * well.
+     * TODO Remove this legacy behavior once downstream teams have
+     * had time to migrate.
+     *
      * @generated from field: optional bool deprecated_legacy_json_field_conflicts = 6 [deprecated = true];
+     * @deprecated
      */
     deprecatedLegacyJsonFieldConflicts?: boolean;
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 7;
      */
     features?: FeatureSetJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -2133,26 +2570,41 @@ export type EnumValueOptions = Message<"google.protobuf.EnumValueOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.EnumValueOptions.
+ * @generated from message google.protobuf.EnumValueOptions
  */
 export type EnumValueOptionsJson = {
     /**
+     * Is this enum value deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for the enum value, or it will be completely ignored; in the very least,
+     * this is a formalization for deprecating enum values.
+     *
      * @generated from field: optional bool deprecated = 1 [default = false];
      */
     deprecated?: boolean;
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 2;
      */
     features?: FeatureSetJson;
     /**
+     * Indicate that fields annotated with this enum value should not be printed
+     * out when using debug formats, e.g. when the field contains sensitive
+     * credentials.
+     *
      * @generated from field: optional bool debug_redact = 3 [default = false];
      */
     debugRedact?: boolean;
     /**
+     * Information about the support window of a feature value.
+     *
      * @generated from field: optional google.protobuf.FieldOptions.FeatureSupport feature_support = 4;
      */
     featureSupport?: FieldOptions_FeatureSupportJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -2189,18 +2641,27 @@ export type ServiceOptions = Message<"google.protobuf.ServiceOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.ServiceOptions.
+ * @generated from message google.protobuf.ServiceOptions
  */
 export type ServiceOptionsJson = {
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 34;
      */
     features?: FeatureSetJson;
     /**
+     * Is this service deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for the service, or it will be completely ignored; in the very least,
+     * this is a formalization for deprecating services.
+     *
      * @generated from field: optional bool deprecated = 33 [default = false];
      */
     deprecated?: boolean;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -2241,10 +2702,15 @@ export type MethodOptions = Message<"google.protobuf.MethodOptions"> & {
     uninterpretedOption: UninterpretedOption[];
 };
 /**
- * JSON type for the message google.protobuf.MethodOptions.
+ * @generated from message google.protobuf.MethodOptions
  */
 export type MethodOptionsJson = {
     /**
+     * Is this method deprecated?
+     * Depending on the target platform, this can emit Deprecated annotations
+     * for the method, or it will be completely ignored; in the very least,
+     * this is a formalization for deprecating methods.
+     *
      * @generated from field: optional bool deprecated = 33 [default = false];
      */
     deprecated?: boolean;
@@ -2253,10 +2719,14 @@ export type MethodOptionsJson = {
      */
     idempotencyLevel?: MethodOptions_IdempotencyLevelJson;
     /**
+     * Any features defined in the specific edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet features = 35;
      */
     features?: FeatureSetJson;
     /**
+     * The parser stores options it doesn't recognize here. See above.
+     *
      * @generated from field: repeated google.protobuf.UninterpretedOption uninterpreted_option = 999;
      */
     uninterpretedOption?: UninterpretedOptionJson[];
@@ -2292,7 +2762,11 @@ export declare enum MethodOptions_IdempotencyLevel {
     IDEMPOTENT = 2
 }
 /**
- * JSON type for the enum google.protobuf.MethodOptions.IdempotencyLevel.
+ * Is this method side-effect-free (or safe in HTTP parlance), or idempotent,
+ * or neither? HTTP based RPC implementation may choose GET verb for safe
+ * methods, and PUT verb for idempotent methods instead of the default POST.
+ *
+ * @generated from enum google.protobuf.MethodOptions.IdempotencyLevel
  */
 export type MethodOptions_IdempotencyLevelJson = "IDEMPOTENCY_UNKNOWN" | "NO_SIDE_EFFECTS" | "IDEMPOTENT";
 /**
@@ -2343,7 +2817,14 @@ export type UninterpretedOption = Message<"google.protobuf.UninterpretedOption">
     aggregateValue: string;
 };
 /**
- * JSON type for the message google.protobuf.UninterpretedOption.
+ * A message representing a option the parser does not recognize. This only
+ * appears in options protos created by the compiler::Parser class.
+ * DescriptorPool resolves these when building Descriptor objects. Therefore,
+ * options protos in descriptor objects (e.g. returned by Descriptor::options(),
+ * or produced by Descriptor::CopyTo()) will never have UninterpretedOptions
+ * in them.
+ *
+ * @generated from message google.protobuf.UninterpretedOption
  */
 export type UninterpretedOptionJson = {
     /**
@@ -2351,6 +2832,9 @@ export type UninterpretedOptionJson = {
      */
     name?: UninterpretedOption_NamePartJson[];
     /**
+     * The value of the uninterpreted option, in whatever type the tokenizer
+     * identified it as during parsing. Exactly one of these should be set.
+     *
      * @generated from field: optional string identifier_value = 3;
      */
     identifierValue?: string;
@@ -2400,7 +2884,13 @@ export type UninterpretedOption_NamePart = Message<"google.protobuf.Uninterprete
     isExtension: boolean;
 };
 /**
- * JSON type for the message google.protobuf.UninterpretedOption.NamePart.
+ * The name of the uninterpreted option.  Each string represents a segment in
+ * a dot-separated name.  is_extension is true iff a segment represents an
+ * extension (denoted with parentheses in options specs in .proto files).
+ * E.g.,{ ["foo", false], ["bar.baz", true], ["moo", false] } represents
+ * "foo.(bar.baz).moo".
+ *
+ * @generated from message google.protobuf.UninterpretedOption.NamePart
  */
 export type UninterpretedOption_NamePartJson = {
     /**
@@ -2454,7 +2944,14 @@ export type FeatureSet = Message<"google.protobuf.FeatureSet"> & {
     jsonFormat: FeatureSet_JsonFormat;
 };
 /**
- * JSON type for the message google.protobuf.FeatureSet.
+ * TODO Enums in C++ gencode (and potentially other languages) are
+ * not well scoped.  This means that each of the feature enums below can clash
+ * with each other.  The short names we've chosen maximize call-site
+ * readability, but leave us very open to this scenario.  A future feature will
+ * be designed and implemented to handle this, hopefully before we ever hit a
+ * conflict here.
+ *
+ * @generated from message google.protobuf.FeatureSet
  */
 export type FeatureSetJson = {
     /**
@@ -2509,7 +3006,7 @@ export declare enum FeatureSet_FieldPresence {
     LEGACY_REQUIRED = 3
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.FieldPresence.
+ * @generated from enum google.protobuf.FeatureSet.FieldPresence
  */
 export type FeatureSet_FieldPresenceJson = "FIELD_PRESENCE_UNKNOWN" | "EXPLICIT" | "IMPLICIT" | "LEGACY_REQUIRED";
 /**
@@ -2534,7 +3031,7 @@ export declare enum FeatureSet_EnumType {
     CLOSED = 2
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.EnumType.
+ * @generated from enum google.protobuf.FeatureSet.EnumType
  */
 export type FeatureSet_EnumTypeJson = "ENUM_TYPE_UNKNOWN" | "OPEN" | "CLOSED";
 /**
@@ -2559,7 +3056,7 @@ export declare enum FeatureSet_RepeatedFieldEncoding {
     EXPANDED = 2
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.RepeatedFieldEncoding.
+ * @generated from enum google.protobuf.FeatureSet.RepeatedFieldEncoding
  */
 export type FeatureSet_RepeatedFieldEncodingJson = "REPEATED_FIELD_ENCODING_UNKNOWN" | "PACKED" | "EXPANDED";
 /**
@@ -2584,7 +3081,7 @@ export declare enum FeatureSet_Utf8Validation {
     NONE = 3
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.Utf8Validation.
+ * @generated from enum google.protobuf.FeatureSet.Utf8Validation
  */
 export type FeatureSet_Utf8ValidationJson = "UTF8_VALIDATION_UNKNOWN" | "VERIFY" | "NONE";
 /**
@@ -2609,7 +3106,7 @@ export declare enum FeatureSet_MessageEncoding {
     DELIMITED = 2
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.MessageEncoding.
+ * @generated from enum google.protobuf.FeatureSet.MessageEncoding
  */
 export type FeatureSet_MessageEncodingJson = "MESSAGE_ENCODING_UNKNOWN" | "LENGTH_PREFIXED" | "DELIMITED";
 /**
@@ -2634,7 +3131,7 @@ export declare enum FeatureSet_JsonFormat {
     LEGACY_BEST_EFFORT = 2
 }
 /**
- * JSON type for the enum google.protobuf.FeatureSet.JsonFormat.
+ * @generated from enum google.protobuf.FeatureSet.JsonFormat
  */
 export type FeatureSet_JsonFormatJson = "JSON_FORMAT_UNKNOWN" | "ALLOW" | "LEGACY_BEST_EFFORT";
 /**
@@ -2670,7 +3167,12 @@ export type FeatureSetDefaults = Message<"google.protobuf.FeatureSetDefaults"> &
     maximumEdition: Edition;
 };
 /**
- * JSON type for the message google.protobuf.FeatureSetDefaults.
+ * A compiled specification for the defaults of a set of features.  These
+ * messages are generated from FeatureSet extensions and can be used to seed
+ * feature resolution. The resolution with this object becomes a simple search
+ * for the closest matching edition, followed by proto merges.
+ *
+ * @generated from message google.protobuf.FeatureSetDefaults
  */
 export type FeatureSetDefaultsJson = {
     /**
@@ -2678,10 +3180,16 @@ export type FeatureSetDefaultsJson = {
      */
     defaults?: FeatureSetDefaults_FeatureSetEditionDefaultJson[];
     /**
+     * The minimum supported edition (inclusive) when this was constructed.
+     * Editions before this will not have defaults.
+     *
      * @generated from field: optional google.protobuf.Edition minimum_edition = 4;
      */
     minimumEdition?: EditionJson;
     /**
+     * The maximum known edition (inclusive) when this was constructed. Editions
+     * after this will not have reliable defaults.
+     *
      * @generated from field: optional google.protobuf.Edition maximum_edition = 5;
      */
     maximumEdition?: EditionJson;
@@ -2718,7 +3226,12 @@ export type FeatureSetDefaults_FeatureSetEditionDefault = Message<"google.protob
     fixedFeatures?: FeatureSet;
 };
 /**
- * JSON type for the message google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault.
+ * A map from every known edition with a unique set of defaults to its
+ * defaults. Not all editions may be contained here.  For a given edition,
+ * the defaults at the closest matching edition ordered at or before it should
+ * be used.  This field must be in strict ascending order by edition.
+ *
+ * @generated from message google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault
  */
 export type FeatureSetDefaults_FeatureSetEditionDefaultJson = {
     /**
@@ -2726,10 +3239,14 @@ export type FeatureSetDefaults_FeatureSetEditionDefaultJson = {
      */
     edition?: EditionJson;
     /**
+     * Defaults of features that can be overridden in this edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet overridable_features = 4;
      */
     overridableFeatures?: FeatureSetJson;
     /**
+     * Defaults of features that can't be overridden in this edition.
+     *
      * @generated from field: optional google.protobuf.FeatureSet fixed_features = 5;
      */
     fixedFeatures?: FeatureSetJson;
@@ -2796,10 +3313,57 @@ export type SourceCodeInfo = Message<"google.protobuf.SourceCodeInfo"> & {
     location: SourceCodeInfo_Location[];
 };
 /**
- * JSON type for the message google.protobuf.SourceCodeInfo.
+ * Encapsulates information about the original source file from which a
+ * FileDescriptorProto was generated.
+ *
+ * @generated from message google.protobuf.SourceCodeInfo
  */
 export type SourceCodeInfoJson = {
     /**
+     * A Location identifies a piece of source code in a .proto file which
+     * corresponds to a particular definition.  This information is intended
+     * to be useful to IDEs, code indexers, documentation generators, and similar
+     * tools.
+     *
+     * For example, say we have a file like:
+     *   message Foo {
+     *     optional string foo = 1;
+     *   }
+     * Let's look at just the field definition:
+     *   optional string foo = 1;
+     *   ^       ^^     ^^  ^  ^^^
+     *   a       bc     de  f  ghi
+     * We have the following locations:
+     *   span   path               represents
+     *   [a,i)  [ 4, 0, 2, 0 ]     The whole field definition.
+     *   [a,b)  [ 4, 0, 2, 0, 4 ]  The label (optional).
+     *   [c,d)  [ 4, 0, 2, 0, 5 ]  The type (string).
+     *   [e,f)  [ 4, 0, 2, 0, 1 ]  The name (foo).
+     *   [g,h)  [ 4, 0, 2, 0, 3 ]  The number (1).
+     *
+     * Notes:
+     * - A location may refer to a repeated field itself (i.e. not to any
+     *   particular index within it).  This is used whenever a set of elements are
+     *   logically enclosed in a single code segment.  For example, an entire
+     *   extend block (possibly containing multiple extension definitions) will
+     *   have an outer location whose path refers to the "extensions" repeated
+     *   field without an index.
+     * - Multiple locations may have the same path.  This happens when a single
+     *   logical declaration is spread out across multiple places.  The most
+     *   obvious example is the "extend" block again -- there may be multiple
+     *   extend blocks in the same scope, each of which will have the same path.
+     * - A location's span is not always a subset of its parent's span.  For
+     *   example, the "extendee" of an extension declaration appears at the
+     *   beginning of the "extend" block and is shared by all extensions within
+     *   the block.
+     * - Just because a location's span is a subset of some other location's span
+     *   does not mean that it is a descendant.  For example, a "group" defines
+     *   both a type and a field in a single declaration.  Thus, the locations
+     *   corresponding to the type and field and their components will overlap.
+     * - Code which tries to interpret locations should probably be designed to
+     *   ignore those that it doesn't understand, as more types of locations could
+     *   be recorded in the future.
+     *
      * @generated from field: repeated google.protobuf.SourceCodeInfo.Location location = 1;
      */
     location?: SourceCodeInfo_LocationJson[];
@@ -2913,18 +3477,96 @@ export type SourceCodeInfo_Location = Message<"google.protobuf.SourceCodeInfo.Lo
     leadingDetachedComments: string[];
 };
 /**
- * JSON type for the message google.protobuf.SourceCodeInfo.Location.
+ * @generated from message google.protobuf.SourceCodeInfo.Location
  */
 export type SourceCodeInfo_LocationJson = {
     /**
+     * Identifies which part of the FileDescriptorProto was defined at this
+     * location.
+     *
+     * Each element is a field number or an index.  They form a path from
+     * the root FileDescriptorProto to the place where the definition appears.
+     * For example, this path:
+     *   [ 4, 3, 2, 7, 1 ]
+     * refers to:
+     *   file.message_type(3)  // 4, 3
+     *       .field(7)         // 2, 7
+     *       .name()           // 1
+     * This is because FileDescriptorProto.message_type has field number 4:
+     *   repeated DescriptorProto message_type = 4;
+     * and DescriptorProto.field has field number 2:
+     *   repeated FieldDescriptorProto field = 2;
+     * and FieldDescriptorProto.name has field number 1:
+     *   optional string name = 1;
+     *
+     * Thus, the above path gives the location of a field name.  If we removed
+     * the last element:
+     *   [ 4, 3, 2, 7 ]
+     * this path refers to the whole field declaration (from the beginning
+     * of the label to the terminating semicolon).
+     *
      * @generated from field: repeated int32 path = 1 [packed = true];
      */
     path?: number[];
     /**
+     * Always has exactly three or four elements: start line, start column,
+     * end line (optional, otherwise assumed same as start line), end column.
+     * These are packed into a single field for efficiency.  Note that line
+     * and column numbers are zero-based -- typically you will want to add
+     * 1 to each before displaying to a user.
+     *
      * @generated from field: repeated int32 span = 2 [packed = true];
      */
     span?: number[];
     /**
+     * If this SourceCodeInfo represents a complete declaration, these are any
+     * comments appearing before and after the declaration which appear to be
+     * attached to the declaration.
+     *
+     * A series of line comments appearing on consecutive lines, with no other
+     * tokens appearing on those lines, will be treated as a single comment.
+     *
+     * leading_detached_comments will keep paragraphs of comments that appear
+     * before (but not connected to) the current element. Each paragraph,
+     * separated by empty lines, will be one comment element in the repeated
+     * field.
+     *
+     * Only the comment content is provided; comment markers (e.g. //) are
+     * stripped out.  For block comments, leading whitespace and an asterisk
+     * will be stripped from the beginning of each line other than the first.
+     * Newlines are included in the output.
+     *
+     * Examples:
+     *
+     *   optional int32 foo = 1;  // Comment attached to foo.
+     *   // Comment attached to bar.
+     *   optional int32 bar = 2;
+     *
+     *   optional string baz = 3;
+     *   // Comment attached to baz.
+     *   // Another line attached to baz.
+     *
+     *   // Comment attached to moo.
+     *   //
+     *   // Another line attached to moo.
+     *   optional double moo = 4;
+     *
+     *   // Detached comment for corge. This is not leading or trailing comments
+     *   // to moo or corge because there are blank lines separating it from
+     *   // both.
+     *
+     *   // Detached comment for corge paragraph 2.
+     *
+     *   optional string corge = 5;
+     *   /* Block comment attached
+     *    * to corge.  Leading asterisks
+     *    * will be removed. *\/
+     *   /* Block comment attached to
+     *    * grault. *\/
+     *   optional int32 grault = 6;
+     *
+     *   // ignored detached comments.
+     *
      * @generated from field: optional string leading_comments = 3;
      */
     leadingComments?: string;
@@ -2959,10 +3601,17 @@ export type GeneratedCodeInfo = Message<"google.protobuf.GeneratedCodeInfo"> & {
     annotation: GeneratedCodeInfo_Annotation[];
 };
 /**
- * JSON type for the message google.protobuf.GeneratedCodeInfo.
+ * Describes the relationship between generated code and its original source
+ * file. A GeneratedCodeInfo message is associated with only one generated
+ * source file, but may contain references to different source .proto files.
+ *
+ * @generated from message google.protobuf.GeneratedCodeInfo
  */
 export type GeneratedCodeInfoJson = {
     /**
+     * An Annotation connects some span of text in generated code to an element
+     * of its generating .proto file.
+     *
      * @generated from field: repeated google.protobuf.GeneratedCodeInfo.Annotation annotation = 1;
      */
     annotation?: GeneratedCodeInfo_AnnotationJson[];
@@ -3010,22 +3659,34 @@ export type GeneratedCodeInfo_Annotation = Message<"google.protobuf.GeneratedCod
     semantic: GeneratedCodeInfo_Annotation_Semantic;
 };
 /**
- * JSON type for the message google.protobuf.GeneratedCodeInfo.Annotation.
+ * @generated from message google.protobuf.GeneratedCodeInfo.Annotation
  */
 export type GeneratedCodeInfo_AnnotationJson = {
     /**
+     * Identifies the element in the original source .proto file. This field
+     * is formatted the same as SourceCodeInfo.Location.path.
+     *
      * @generated from field: repeated int32 path = 1 [packed = true];
      */
     path?: number[];
     /**
+     * Identifies the filesystem path to the original source .proto.
+     *
      * @generated from field: optional string source_file = 2;
      */
     sourceFile?: string;
     /**
+     * Identifies the starting offset in bytes in the generated code
+     * that relates to the identified object.
+     *
      * @generated from field: optional int32 begin = 3;
      */
     begin?: number;
     /**
+     * Identifies the ending offset in bytes in the generated code that
+     * relates to the identified object. The end offset should be one past
+     * the last relevant byte (so the length of the text = end - begin).
+     *
      * @generated from field: optional int32 end = 4;
      */
     end?: number;
@@ -3066,7 +3727,10 @@ export declare enum GeneratedCodeInfo_Annotation_Semantic {
     ALIAS = 2
 }
 /**
- * JSON type for the enum google.protobuf.GeneratedCodeInfo.Annotation.Semantic.
+ * Represents the identified object's effect on the element in the original
+ * .proto file.
+ *
+ * @generated from enum google.protobuf.GeneratedCodeInfo.Annotation.Semantic
  */
 export type GeneratedCodeInfo_Annotation_SemanticJson = "NONE" | "SET" | "ALIAS";
 /**
@@ -3150,7 +3814,9 @@ export declare enum Edition {
     EDITION_MAX = 2147483647
 }
 /**
- * JSON type for the enum google.protobuf.Edition.
+ * The full set of known editions.
+ *
+ * @generated from enum google.protobuf.Edition
  */
 export type EditionJson = "EDITION_UNKNOWN" | "EDITION_LEGACY" | "EDITION_PROTO2" | "EDITION_PROTO3" | "EDITION_2023" | "EDITION_2024" | "EDITION_1_TEST_ONLY" | "EDITION_2_TEST_ONLY" | "EDITION_99997_TEST_ONLY" | "EDITION_99998_TEST_ONLY" | "EDITION_99999_TEST_ONLY" | "EDITION_MAX";
 /**