protostar 0.1.0.beta1

data/lib/protostar/google/protobuf/descriptor_pb.rb

@@ -0,0 +1,1239 @@
+# frozen_string_literal: true
+
+# Generated by protostar from google/protobuf/descriptor.proto. Do not edit.
+
+require "protostar"
+
+Protostar::DSL.file(
+  "google/protobuf/descriptor.proto",
+  package: "google.protobuf",
+  go_package: "google.golang.org/protobuf/types/descriptorpb",
+  java_package: "com.google.protobuf",
+  java_outer_classname: "DescriptorProtos",
+  csharp_namespace: "Google.Protobuf.Reflection",
+  objc_class_prefix: "GPB",
+  cc_enable_arenas: true,
+  optimize_for: :SPEED
+) do |f|
+  # The protocol compiler can output a FileDescriptorSet containing the .proto
+  # files it parses.
+  f.message "FileDescriptorSet" do |m|
+    m.field :file, 1, :message, ".google.protobuf.FileDescriptorProto", label: :repeated
+    m.extensions 536000000
+  end
+  # Describes a complete .proto file.
+  f.message "FileDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :package, 2, :string
+    # Names of files imported by this file.
+    m.field :dependency, 3, :string, label: :repeated
+    # Indexes of the public imported files in the dependency list above.
+    m.field :public_dependency, 10, :int32, label: :repeated
+    # Indexes of the weak imported files in the dependency list.
+    # For Google-internal migration only. Do not use.
+    m.field :weak_dependency, 11, :int32, label: :repeated
+    # Names of files imported by this file purely for the purpose of providing
+    # option extensions. These are excluded from the dependency list above.
+    m.field :option_dependency, 15, :string, label: :repeated
+    # All top-level definitions in this file.
+    m.field :message_type, 4, :message, ".google.protobuf.DescriptorProto", label: :repeated
+    m.field :enum_type, 5, :message, ".google.protobuf.EnumDescriptorProto", label: :repeated
+    m.field :service, 6, :message, ".google.protobuf.ServiceDescriptorProto", label: :repeated
+    m.field :extension, 7, :message, ".google.protobuf.FieldDescriptorProto", label: :repeated
+    m.field :options, 8, :message, ".google.protobuf.FileOptions"
+    # 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.
+    m.field :source_code_info, 9, :message, ".google.protobuf.SourceCodeInfo"
+    # The syntax of the proto file.
+    # The supported values are "proto2", "proto3", and "editions".
+    #
+    # If `edition` is present, this value must be "editions".
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :syntax, 12, :string
+    # The edition of the proto file.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :edition, 14, :enum, ".google.protobuf.Edition"
+  end
+  # Describes a message type.
+  f.message "DescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :field, 2, :message, ".google.protobuf.FieldDescriptorProto", label: :repeated
+    m.field :extension, 6, :message, ".google.protobuf.FieldDescriptorProto", label: :repeated
+    m.field :nested_type, 3, :message, ".google.protobuf.DescriptorProto", label: :repeated
+    m.field :enum_type, 4, :message, ".google.protobuf.EnumDescriptorProto", label: :repeated
+    m.field :extension_range, 5, :message, ".google.protobuf.DescriptorProto.ExtensionRange",
+      label: :repeated
+    m.field :oneof_decl, 8, :message, ".google.protobuf.OneofDescriptorProto", label: :repeated
+    m.field :options, 7, :message, ".google.protobuf.MessageOptions"
+    m.field :reserved_range, 9, :message, ".google.protobuf.DescriptorProto.ReservedRange",
+      label: :repeated
+    # Reserved field names, which may not be used by fields in the same message.
+    # A given name may only be reserved once.
+    m.field :reserved_name, 10, :string, label: :repeated
+    # Support for `export` and `local` keywords on enums.
+    m.field :visibility, 11, :enum, ".google.protobuf.SymbolVisibility"
+    m.message "ExtensionRange" do |m|
+      m.field :start, 1, :int32
+      m.field :end, 2, :int32
+      m.field :options, 3, :message, ".google.protobuf.ExtensionRangeOptions"
+    end
+    # 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.
+    m.message "ReservedRange" do |m|
+      m.field :start, 1, :int32
+      m.field :end, 2, :int32
+    end
+  end
+  f.message "ExtensionRangeOptions" do |m|
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    # 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.
+    m.field :declaration, 2, :message, ".google.protobuf.ExtensionRangeOptions.Declaration",
+      label: :repeated,
+      retention: :RETENTION_SOURCE
+    # Any features defined in the specific edition.
+    m.field :features, 50, :message, ".google.protobuf.FeatureSet"
+    # The verification state of the range.
+    # TODO: flip the default to DECLARATION once all empty ranges
+    # are marked as UNVERIFIED.
+    m.field :verification, 3, :enum, ".google.protobuf.ExtensionRangeOptions.VerificationState",
+      default: "UNVERIFIED",
+      retention: :RETENTION_SOURCE
+    m.message "Declaration" do |m|
+      # The extension number declared within the extension range.
+      m.field :number, 1, :int32
+      # The fully-qualified name of the extension field. There must be a leading
+      # dot in front of the full name.
+      m.field :full_name, 2, :string
+      # The fully-qualified type name of the extension field. Unlike
+      # Metadata.type, Declaration.type must have a leading dot for messages
+      # and enums.
+      m.field :type, 3, :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.
+      m.field :reserved, 5, :bool
+      # If true, indicates that the extension must be defined as repeated.
+      # Otherwise the extension must be defined as optional.
+      m.field :repeated, 6, :bool
+      m.reserved 4
+    end
+    # The verification state of the extension range.
+    m.enum "VerificationState" do |e|
+      # All the extensions of the range must be declared.
+      e.value :DECLARATION, 0
+      e.value :UNVERIFIED, 1
+    end
+    m.extensions 990..998
+    m.extensions 1000..536870911
+  end
+  # Describes a field within a message.
+  f.message "FieldDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :number, 3, :int32
+    m.field :label, 4, :enum, ".google.protobuf.FieldDescriptorProto.Label"
+    # 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.
+    m.field :type, 5, :enum, ".google.protobuf.FieldDescriptorProto.Type"
+    # 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).
+    m.field :type_name, 6, :string
+    # For extensions, this is the name of the type being extended.  It is
+    # resolved in the same manner as type_name.
+    m.field :extendee, 2, :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.
+    m.field :default_value, 7, :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.
+    m.field :oneof_index, 9, :int32
+    # 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.
+    m.field :json_name, 10, :string
+    m.field :options, 8, :message, ".google.protobuf.FieldOptions"
+    # 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`.
+    m.field :proto3_optional, 17, :bool
+    m.enum "Type" do |e|
+      # 0 is reserved for errors.
+      # Order is weird for historical reasons.
+      e.value :TYPE_DOUBLE, 1
+      e.value :TYPE_FLOAT, 2
+      # Not ZigZag encoded.  Negative numbers take 10 bytes.  Use TYPE_SINT64 if
+      # negative values are likely.
+      e.value :TYPE_INT64, 3
+      e.value :TYPE_UINT64, 4
+      # Not ZigZag encoded.  Negative numbers take 10 bytes.  Use TYPE_SINT32 if
+      # negative values are likely.
+      e.value :TYPE_INT32, 5
+      e.value :TYPE_FIXED64, 6
+      e.value :TYPE_FIXED32, 7
+      e.value :TYPE_BOOL, 8
+      e.value :TYPE_STRING, 9
+      # Tag-delimited aggregate.
+      # Group type is deprecated and not supported after google.protobuf. However, Proto3
+      # implementations should still be able to parse the group wire format and
+      # treat group fields as unknown fields.  In Editions, the group wire format
+      # can be enabled via the `message_encoding` feature.
+      e.value :TYPE_GROUP, 10
+      e.value :TYPE_MESSAGE, 11
+      # New in version 2.
+      e.value :TYPE_BYTES, 12
+      e.value :TYPE_UINT32, 13
+      e.value :TYPE_ENUM, 14
+      e.value :TYPE_SFIXED32, 15
+      e.value :TYPE_SFIXED64, 16
+      e.value :TYPE_SINT32, 17
+      e.value :TYPE_SINT64, 18
+    end
+    m.enum "Label" do |e|
+      # 0 is reserved for errors
+      e.value :LABEL_OPTIONAL, 1
+      e.value :LABEL_REPEATED, 3
+      # The required label is only allowed in google.protobuf.  In proto3 and Editions
+      # it's explicitly prohibited.  In Editions, the `field_presence` feature
+      # can be used to get this behavior.
+      e.value :LABEL_REQUIRED, 2
+    end
+  end
+  # Describes a oneof.
+  f.message "OneofDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :options, 2, :message, ".google.protobuf.OneofOptions"
+  end
+  # Describes an enum type.
+  f.message "EnumDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :value, 2, :message, ".google.protobuf.EnumValueDescriptorProto", label: :repeated
+    m.field :options, 3, :message, ".google.protobuf.EnumOptions"
+    # 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.
+    m.field :reserved_range, 4, :message, ".google.protobuf.EnumDescriptorProto.EnumReservedRange",
+      label: :repeated
+    # Reserved enum value names, which may not be reused. A given name may only
+    # be reserved once.
+    m.field :reserved_name, 5, :string, label: :repeated
+    # Support for `export` and `local` keywords on enums.
+    m.field :visibility, 6, :enum, ".google.protobuf.SymbolVisibility"
+    # 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.
+    m.message "EnumReservedRange" do |m|
+      m.field :start, 1, :int32
+      m.field :end, 2, :int32
+    end
+  end
+  # Describes a value within an enum.
+  f.message "EnumValueDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :number, 2, :int32
+    m.field :options, 3, :message, ".google.protobuf.EnumValueOptions"
+  end
+  # Describes a service.
+  f.message "ServiceDescriptorProto" do |m|
+    m.field :name, 1, :string
+    m.field :method, 2, :message, ".google.protobuf.MethodDescriptorProto", label: :repeated
+    m.field :options, 3, :message, ".google.protobuf.ServiceOptions"
+    m.reserved 4, "stream"
+  end
+  # Describes a method of a service.
+  f.message "MethodDescriptorProto" do |m|
+    m.field :name, 1, :string
+    # Input and output type names.  These are resolved in the same way as
+    # FieldDescriptorProto.type_name, but must refer to a message type.
+    m.field :input_type, 2, :string
+    m.field :output_type, 3, :string
+    m.field :options, 4, :message, ".google.protobuf.MethodOptions"
+    # Identifies if client streams multiple client messages
+    m.field :client_streaming, 5, :bool, default: "false"
+    # Identifies if server streams multiple server messages
+    m.field :server_streaming, 6, :bool, default: "false"
+  end
+  f.message "FileOptions" do |m|
+    # 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.
+    m.field :java_package, 1, :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.
+    m.field :java_outer_classname, 8, :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.
+    m.field :java_multiple_files, 10, :bool,
+      default: "false",
+      feature_support: {
+        edition_introduced: :EDITION_PROTO2,
+        edition_removed: :EDITION_2024,
+        removal_error: "This behavior is enabled by default in editions 2024 and above. To disable it, you can set `features.(pb.java).nest_in_file_class = YES` on individual messages, enums, or services."
+      }
+    # This option does nothing.
+    m.field :java_generate_equals_and_hash, 20, :bool, deprecated: true
+    # 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.
+    m.field :java_string_check_utf8, 27, :bool, default: "false"
+    m.field :optimize_for, 9, :enum, ".google.protobuf.FileOptions.OptimizeMode", default: "SPEED"
+    # 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.
+    m.field :go_package, 11, :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.
+    m.field :cc_generic_services, 16, :bool, default: "false"
+    m.field :java_generic_services, 17, :bool, default: "false"
+    m.field :py_generic_services, 18, :bool, default: "false"
+    # 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.
+    m.field :deprecated, 23, :bool, default: "false"
+    # Enables the use of arenas for the proto messages in this file. This applies
+    # only to generated classes for C++.
+    m.field :cc_enable_arenas, 31, :bool,
+      default: "true",
+      feature_support: {
+        edition_removed: :EDITION_2026,
+        removal_error: "cc_enable_arenas is enabled by default in every edition and overrides are ignored.This option is removed in editions 2026 and above."
+      }
+    # Sets the objective c class prefix which is prepended to all objective c
+    # generated classes from this .proto. There is no default.
+    m.field :objc_class_prefix, 36, :string
+    # Namespace for generated classes; defaults to the package.
+    m.field :csharp_namespace, 37, :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.
+    m.field :swift_prefix, 39, :string
+    # Sets the php class prefix which is prepended to all php generated classes
+    # from this .proto. Default is empty.
+    m.field :php_class_prefix, 40, :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.
+    m.field :php_namespace, 41, :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.
+    m.field :php_metadata_namespace, 44, :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.
+    m.field :ruby_package, 45, :string
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 50, :message, ".google.protobuf.FeatureSet"
+    # The parser stores options it doesn't recognize here.
+    # See the documentation for the "Options" section above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    # Generated classes can be optimized for speed or code size.
+    m.enum "OptimizeMode" do |e|
+      e.value :SPEED, 1
+      # etc.
+      e.value :CODE_SIZE, 2
+      e.value :LITE_RUNTIME, 3
+    end
+    m.extensions 990..998
+    m.extensions 1000..536870911
+    m.reserved 42, 38, "php_generic_services"
+  end
+  f.message "MessageOptions" do |m|
+    # 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.
+    m.field :message_set_wire_format, 1, :bool, default: "false"
+    # 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".
+    m.field :no_standard_descriptor_accessor, 2, :bool, default: "false"
+    # 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.
+    m.field :deprecated, 3, :bool, default: "false"
+    # 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.
+    m.field :map_entry, 7, :bool
+    # 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.
+    m.field :deprecated_legacy_json_field_conflicts, 11, :bool, deprecated: true
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 12, :message, ".google.protobuf.FeatureSet"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.extensions 990..998
+    m.extensions 1000..536870911
+    m.reserved 4, 5, 6, 8, 9
+  end
+  f.message "FieldOptions" do |m|
+    # 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.
+    m.field :ctype, 1, :enum, ".google.protobuf.FieldOptions.CType", default: "STRING"
+    # 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.
+    m.field :packed, 2, :bool
+    # 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.
+    m.field :jstype, 6, :enum, ".google.protobuf.FieldOptions.JSType", default: "JS_NORMAL"
+    # 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).
+    m.field :lazy, 5, :bool, default: "false"
+    # unverified_lazy does no correctness checks on the byte stream. This should
+    # only be used where lazy with verification is prohibitive for performance
+    # reasons.
+    m.field :unverified_lazy, 15, :bool, default: "false"
+    # 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.
+    m.field :deprecated, 3, :bool, default: "false"
+    # DEPRECATED. DO NOT USE!
+    # For Google-internal migration only. Do not use.
+    m.field :weak, 10, :bool, default: "false", deprecated: true
+    # Indicate that the field value should not be printed out when using debug
+    # formats, e.g. when the field contains sensitive credentials.
+    m.field :debug_redact, 16, :bool, default: "false"
+    m.field :retention, 17, :enum, ".google.protobuf.FieldOptions.OptionRetention"
+    m.field :targets, 19, :enum, ".google.protobuf.FieldOptions.OptionTargetType", label: :repeated
+    m.field :edition_defaults, 20, :message, ".google.protobuf.FieldOptions.EditionDefault",
+      label: :repeated
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 21, :message, ".google.protobuf.FeatureSet"
+    m.field :feature_support, 22, :message, ".google.protobuf.FieldOptions.FeatureSupport"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.message "EditionDefault" do |m|
+      m.field :edition, 3, :enum, ".google.protobuf.Edition"
+      m.field :value, 2, :string
+    end
+    # Information about the support window of a feature.
+    m.message "FeatureSupport" do |m|
+      # 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.
+      m.field :edition_introduced, 1, :enum, ".google.protobuf.Edition"
+      # The edition this feature becomes deprecated in.  Using this after this
+      # edition may trigger warnings.
+      m.field :edition_deprecated, 2, :enum, ".google.protobuf.Edition"
+      # The deprecation warning text if this feature is used after the edition it
+      # was marked deprecated in.
+      m.field :deprecation_warning, 3, :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.
+      m.field :edition_removed, 4, :enum, ".google.protobuf.Edition"
+      # The removal error text if this feature is used after the edition it was
+      # removed in.
+      m.field :removal_error, 5, :string
+    end
+    m.enum "CType" do |e|
+      # Default mode.
+      e.value :STRING, 0
+      # The option [ctype=CORD] may be applied to a non-repeated field of type
+      # "bytes". It indicates that in C++, the data should be stored in a Cord
+      # instead of a string.  For very large strings, this may reduce memory
+      # fragmentation. It may also allow better performance when parsing from a
+      # Cord, or when parsing with aliasing enabled, as the parsed Cord may then
+      # alias the original buffer.
+      e.value :CORD, 1
+      e.value :STRING_PIECE, 2
+    end
+    m.enum "JSType" do |e|
+      # Use the default type.
+      e.value :JS_NORMAL, 0
+      # Use JavaScript strings.
+      e.value :JS_STRING, 1
+      # Use JavaScript numbers.
+      e.value :JS_NUMBER, 2
+    end
+    # If set to RETENTION_SOURCE, the option will be omitted from the binary.
+    m.enum "OptionRetention" do |e|
+      e.value :RETENTION_UNKNOWN, 0
+      e.value :RETENTION_RUNTIME, 1
+      e.value :RETENTION_SOURCE, 2
+    end
+    # 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.
+    m.enum "OptionTargetType" do |e|
+      e.value :TARGET_TYPE_UNKNOWN, 0
+      e.value :TARGET_TYPE_FILE, 1
+      e.value :TARGET_TYPE_EXTENSION_RANGE, 2
+      e.value :TARGET_TYPE_MESSAGE, 3
+      e.value :TARGET_TYPE_FIELD, 4
+      e.value :TARGET_TYPE_ONEOF, 5
+      e.value :TARGET_TYPE_ENUM, 6
+      e.value :TARGET_TYPE_ENUM_ENTRY, 7
+      e.value :TARGET_TYPE_SERVICE, 8
+      e.value :TARGET_TYPE_METHOD, 9
+    end
+    m.extensions 990..998
+    m.extensions 1000..536870911
+    m.reserved 4, 18
+  end
+  f.message "OneofOptions" do |m|
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 1, :message, ".google.protobuf.FeatureSet"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.extensions 990..998
+    m.extensions 1000..536870911
+  end
+  f.message "EnumOptions" do |m|
+    # Set this option to true to allow mapping different tag names to the same
+    # value.
+    m.field :allow_alias, 2, :bool
+    # 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.
+    m.field :deprecated, 3, :bool, default: "false"
+    # 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.
+    m.field :deprecated_legacy_json_field_conflicts, 6, :bool, deprecated: true
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 7, :message, ".google.protobuf.FeatureSet"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.extensions 990..998
+    m.extensions 1000..536870911
+    m.reserved 5
+  end
+  f.message "EnumValueOptions" do |m|
+    # 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.
+    m.field :deprecated, 1, :bool, default: "false"
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 2, :message, ".google.protobuf.FeatureSet"
+    # 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.
+    m.field :debug_redact, 3, :bool, default: "false"
+    # Information about the support window of a feature value.
+    m.field :feature_support, 4, :message, ".google.protobuf.FieldOptions.FeatureSupport"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.extensions 990..998
+    m.extensions 1000..536870911
+  end
+  f.message "ServiceOptions" do |m|
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 34, :message, ".google.protobuf.FeatureSet"
+    # 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.
+    m.field :deprecated, 33, :bool, default: "false"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    m.extensions 990..998
+    m.extensions 1000..536870911
+  end
+  f.message "MethodOptions" do |m|
+    # 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.
+    m.field :deprecated, 33, :bool, default: "false"
+    m.field :idempotency_level, 34, :enum, ".google.protobuf.MethodOptions.IdempotencyLevel",
+      default: "IDEMPOTENCY_UNKNOWN"
+    # Any features defined in the specific edition.
+    # WARNING: This field should only be used by protobuf plugins or special
+    # cases like the proto compiler. Other uses are discouraged and
+    # developers should rely on the protoreflect APIs for their client language.
+    m.field :features, 35, :message, ".google.protobuf.FeatureSet"
+    # The parser stores options it doesn't recognize here. See above.
+    m.field :uninterpreted_option, 999, :message, ".google.protobuf.UninterpretedOption",
+      label: :repeated
+    # 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.
+    m.enum "IdempotencyLevel" do |e|
+      e.value :IDEMPOTENCY_UNKNOWN, 0
+      e.value :NO_SIDE_EFFECTS, 1
+      e.value :IDEMPOTENT, 2
+    end
+    m.extensions 990..998
+    m.extensions 1000..536870911
+  end
+  # 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.
+  f.message "UninterpretedOption" do |m|
+    m.field :name, 2, :message, ".google.protobuf.UninterpretedOption.NamePart", label: :repeated
+    # The value of the uninterpreted option, in whatever type the tokenizer
+    # identified it as during parsing. Exactly one of these should be set.
+    m.field :identifier_value, 3, :string
+    m.field :positive_int_value, 4, :uint64
+    m.field :negative_int_value, 5, :int64
+    m.field :double_value, 6, :double
+    m.field :string_value, 7, :bytes
+    m.field :aggregate_value, 8, :string
+    # 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".
+    m.message "NamePart" do |m|
+      m.field :name_part, 1, :string, label: :required
+      m.field :is_extension, 2, :bool, label: :required
+    end
+  end
+  # 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.
+  f.message "FeatureSet" do |m|
+    m.field :field_presence, 1, :enum, ".google.protobuf.FeatureSet.FieldPresence",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_FIELD, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "EXPLICIT"},
+        {edition: :EDITION_PROTO3, value: "IMPLICIT"},
+        {edition: :EDITION_2023, value: "EXPLICIT"}
+      ]
+    m.field :enum_type, 2, :enum, ".google.protobuf.FeatureSet.EnumType",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_ENUM, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "CLOSED"},
+        {edition: :EDITION_PROTO3, value: "OPEN"}
+      ]
+    m.field :repeated_field_encoding, 3, :enum, ".google.protobuf.FeatureSet.RepeatedFieldEncoding",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_FIELD, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "EXPANDED"},
+        {edition: :EDITION_PROTO3, value: "PACKED"}
+      ]
+    m.field :utf8_validation, 4, :enum, ".google.protobuf.FeatureSet.Utf8Validation",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_FIELD, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "NONE"},
+        {edition: :EDITION_PROTO3, value: "VERIFY"}
+      ]
+    m.field :message_encoding, 5, :enum, ".google.protobuf.FeatureSet.MessageEncoding",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_FIELD, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [{edition: :EDITION_LEGACY, value: "LENGTH_PREFIXED"}]
+    m.field :json_format, 6, :enum, ".google.protobuf.FeatureSet.JsonFormat",
+      retention: :RETENTION_RUNTIME,
+      targets: [:TARGET_TYPE_MESSAGE, :TARGET_TYPE_ENUM, :TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2023},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "LEGACY_BEST_EFFORT"},
+        {edition: :EDITION_PROTO3, value: "ALLOW"}
+      ]
+    m.field :enforce_naming_style, 7, :enum, ".google.protobuf.FeatureSet.EnforceNamingStyle",
+      retention: :RETENTION_SOURCE,
+      targets: [
+        :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
+      ],
+      feature_support: {edition_introduced: :EDITION_2024},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "STYLE_LEGACY"},
+        {edition: :EDITION_2024, value: "STYLE2024"},
+        {edition: :EDITION_2026, value: "STYLE2026"}
+      ]
+    m.field :default_symbol_visibility, 8, :enum, ".google.protobuf.FeatureSet.VisibilityFeature.DefaultSymbolVisibility",
+      retention: :RETENTION_SOURCE,
+      targets: [:TARGET_TYPE_FILE],
+      feature_support: {edition_introduced: :EDITION_2024},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "EXPORT_ALL"},
+        {edition: :EDITION_2024, value: "EXPORT_TOP_LEVEL"},
+        {edition: :EDITION_2026, value: "STRICT"}
+      ]
+    m.field :enforce_proto_limits, 9, :enum, ".google.protobuf.FeatureSet.ProtoLimitsFeature.EnforceProtoLimits",
+      retention: :RETENTION_SOURCE,
+      targets: [:TARGET_TYPE_ENUM, :TARGET_TYPE_MESSAGE, :TARGET_TYPE_FIELD, :TARGET_TYPE_ONEOF],
+      feature_support: {edition_introduced: :EDITION_2026},
+      edition_defaults: [
+        {edition: :EDITION_LEGACY, value: "LEGACY_NO_EXPLICIT_LIMITS"},
+        {edition: :EDITION_2026, value: "PROTO_LIMITS2026"}
+      ]
+    m.message "VisibilityFeature" do |m|
+      m.enum "DefaultSymbolVisibility" do |e|
+        e.value :DEFAULT_SYMBOL_VISIBILITY_UNKNOWN, 0
+        # Default pre-EDITION_2024, all UNSET visibility are export.
+        e.value :EXPORT_ALL, 1
+        # All top-level symbols default to export, nested default to local.
+        e.value :EXPORT_TOP_LEVEL, 2
+        # All symbols default to local.
+        e.value :LOCAL_ALL, 3
+        # All symbols local by default. Nested types cannot be exported.
+        # With special case caveat for message { enum {} reserved 1 to max; }
+        # This is the recommended setting for new protos.
+        e.value :STRICT, 4
+      end
+      m.reserved 1..536870911
+    end
+    m.message "ProtoLimitsFeature" do |m|
+      m.enum "EnforceProtoLimits" do |e|
+        e.value :PROTO_LIMITS_UNKNOWN, 0
+        # Default pre-EDITION_2026: there are no limit enforcement at the protoc
+        # level. Practical limits still exist, but they will tend to fail while
+        # compiling protoc-generated code, and these limits tend to be language
+        # or toolchain specific.
+        e.value :LEGACY_NO_EXPLICIT_LIMITS, 1
+        # A set of limits enforced by Edition 2026 by default. For a detailed
+        # list of all the limits please consult the Edition 2026 documentation.
+        e.value :PROTO_LIMITS2026, 2
+      end
+    end
+    m.enum "FieldPresence" do |e|
+      e.value :FIELD_PRESENCE_UNKNOWN, 0
+      e.value :EXPLICIT, 1
+      e.value :IMPLICIT, 2
+      e.value :LEGACY_REQUIRED, 3
+    end
+    m.enum "EnumType" do |e|
+      e.value :ENUM_TYPE_UNKNOWN, 0
+      e.value :OPEN, 1
+      e.value :CLOSED, 2
+    end
+    m.enum "RepeatedFieldEncoding" do |e|
+      e.value :REPEATED_FIELD_ENCODING_UNKNOWN, 0
+      e.value :PACKED, 1
+      e.value :EXPANDED, 2
+    end
+    m.enum "Utf8Validation" do |e|
+      e.value :UTF8_VALIDATION_UNKNOWN, 0
+      e.value :VERIFY, 2
+      e.value :NONE, 3
+      e.reserved 1
+    end
+    m.enum "MessageEncoding" do |e|
+      e.value :MESSAGE_ENCODING_UNKNOWN, 0
+      e.value :LENGTH_PREFIXED, 1
+      e.value :DELIMITED, 2
+    end
+    m.enum "JsonFormat" do |e|
+      e.value :JSON_FORMAT_UNKNOWN, 0
+      e.value :ALLOW, 1
+      e.value :LEGACY_BEST_EFFORT, 2
+    end
+    m.enum "EnforceNamingStyle" do |e|
+      e.value :ENFORCE_NAMING_STYLE_UNKNOWN, 0
+      e.value :STYLE2024, 1
+      e.value :STYLE_LEGACY, 2
+      e.value :STYLE2026, 3
+    end
+    m.extensions 1000..9994
+    m.extensions 9995..9999
+    m.extensions 10000
+    m.reserved 999
+  end
+  # 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.
+  f.message "FeatureSetDefaults" do |m|
+    m.field :defaults, 1, :message, ".google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault",
+      label: :repeated
+    # The minimum supported edition (inclusive) when this was constructed.
+    # Editions before this will not have defaults.
+    m.field :minimum_edition, 4, :enum, ".google.protobuf.Edition"
+    # The maximum known edition (inclusive) when this was constructed. Editions
+    # after this will not have reliable defaults.
+    m.field :maximum_edition, 5, :enum, ".google.protobuf.Edition"
+    # 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.
+    m.message "FeatureSetEditionDefault" do |m|
+      m.field :edition, 3, :enum, ".google.protobuf.Edition"
+      # Defaults of features that can be overridden in this edition.
+      m.field :overridable_features, 4, :message, ".google.protobuf.FeatureSet"
+      # Defaults of features that can't be overridden in this edition.
+      m.field :fixed_features, 5, :message, ".google.protobuf.FeatureSet"
+      m.reserved 1, 2, "features"
+    end
+  end
+  # Encapsulates information about the original source file from which a
+  # FileDescriptorProto was generated.
+  f.message "SourceCodeInfo" do |m|
+    # 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.
+    m.field :location, 1, :message, ".google.protobuf.SourceCodeInfo.Location", label: :repeated
+    m.message "Location" do |m|
+      # 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).
+      #
+      # For options, the path refers to the interpreted option in the descriptor.
+      # E.g., for a custom option `(my_opt) = "foo"` on a message using extension
+      # number 10101, the path is:
+      #   [ 4, 3, 7, 10101 ]
+      # refers to:
+      #   file.message_type(3)     // 4, 3
+      #       .options()           // 7
+      #       .my_opt()            // 10101
+      #
+      # Sub-locations corresponding to the interpreted option's corresponding
+      # `UninterpretedOption` are also appended to the interpreted option, which
+      # deviates from the actual FileDescriptorProto path. E.g.:
+      #   [ 4, 3, 7, 10101, 2 ]
+      # refers to the option name `(my_opt)`, and:
+      #   [ 4, 3, 7, 10101, 7 ]
+      # refers to the "foo" string value of the option.
+      m.field :path, 1, :int32, label: :repeated, packed: true
+      # 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.
+      m.field :span, 2, :int32, label: :repeated, packed: true
+      # 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.
+      m.field :leading_comments, 3, :string
+      m.field :trailing_comments, 4, :string
+      m.field :leading_detached_comments, 6, :string, label: :repeated
+    end
+    m.extensions 536000000
+  end
+  # 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.
+  f.message "GeneratedCodeInfo" do |m|
+    # An Annotation connects some span of text in generated code to an element
+    # of its generating .proto file.
+    m.field :annotation, 1, :message, ".google.protobuf.GeneratedCodeInfo.Annotation",
+      label: :repeated
+    m.message "Annotation" do |m|
+      # Identifies the element in the original source .proto file. This field
+      # is formatted the same as SourceCodeInfo.Location.path.
+      m.field :path, 1, :int32, label: :repeated, packed: true
+      # Identifies the filesystem path to the original source .proto.
+      m.field :source_file, 2, :string
+      # Identifies the starting offset in bytes in the generated code
+      # that relates to the identified object.
+      m.field :begin, 3, :int32
+      # 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).
+      m.field :end, 4, :int32
+      m.field :semantic, 5, :enum, ".google.protobuf.GeneratedCodeInfo.Annotation.Semantic"
+      # Represents the identified object's effect on the element in the original
+      # .proto file.
+      m.enum "Semantic" do |e|
+        # There is no effect or the effect is indescribable.
+        e.value :NONE, 0
+        # The element is set or otherwise mutated.
+        e.value :SET, 1
+        # An alias to the element is returned.
+        e.value :ALIAS, 2
+      end
+    end
+  end
+  # The full set of known editions.
+  f.enum "Edition" do |e|
+    # A placeholder for an unknown edition value.
+    e.value :EDITION_UNKNOWN, 0
+    # A placeholder edition for specifying default behaviors *before* a feature
+    # was first introduced.  This is effectively an "infinite past".
+    e.value :EDITION_LEGACY, 900
+    # Legacy syntax "editions".  These pre-date editions, but behave much like
+    # distinct editions.  These can't be used to specify the edition of proto
+    # files, but feature definitions must supply proto2/proto3 defaults for
+    # backwards compatibility.
+    e.value :EDITION_PROTO2, 998
+    e.value :EDITION_PROTO3, 999
+    # Editions that have been released.  The specific values are arbitrary and
+    # should not be depended on, but they will always be time-ordered for easy
+    # comparison.
+    e.value :EDITION_2023, 1000
+    e.value :EDITION_2024, 1001
+    e.value :EDITION_2026, 1002
+    # A placeholder edition for developing and testing unscheduled features.
+    e.value :EDITION_UNSTABLE, 9999
+    # Placeholder editions for testing feature resolution.  These should not be
+    # used or relied on outside of tests.
+    e.value :EDITION_1_TEST_ONLY, 1
+    e.value :EDITION_2_TEST_ONLY, 2
+    e.value :EDITION_99997_TEST_ONLY, 99997
+    e.value :EDITION_99998_TEST_ONLY, 99998
+    e.value :EDITION_99999_TEST_ONLY, 99999
+    # Placeholder for specifying unbounded edition support.  This should only
+    # ever be used by plugins that can expect to never require any changes to
+    # support a new edition.
+    e.value :EDITION_MAX, 2147483647
+  end
+  # Describes the 'visibility' of a symbol with respect to the proto import
+  # system. Symbols can only be imported when the visibility rules do not prevent
+  # it (ex: local symbols cannot be imported).  Visibility modifiers can only set
+  # on `message` and `enum` as they are the only types available to be referenced
+  # from other files.
+  f.enum "SymbolVisibility" do |e|
+    e.value :VISIBILITY_UNSET, 0
+    e.value :VISIBILITY_LOCAL, 1
+    e.value :VISIBILITY_EXPORT, 2
+  end
+end
+
+module Protostar
+  module Google
+    module Protobuf
+      FileDescriptorSet = Protostar::DSL.message("google.protobuf.FileDescriptorSet")
+      FileDescriptorProto = Protostar::DSL.message("google.protobuf.FileDescriptorProto")
+      DescriptorProto = Protostar::DSL.message("google.protobuf.DescriptorProto")
+      DescriptorProto::ExtensionRange = Protostar::DSL.message("google.protobuf.DescriptorProto.ExtensionRange")
+      DescriptorProto::ReservedRange = Protostar::DSL.message("google.protobuf.DescriptorProto.ReservedRange")
+      ExtensionRangeOptions = Protostar::DSL.message("google.protobuf.ExtensionRangeOptions")
+      ExtensionRangeOptions::Declaration = Protostar::DSL.message("google.protobuf.ExtensionRangeOptions.Declaration")
+      ExtensionRangeOptions::VerificationState = Protostar::DSL.enum("google.protobuf.ExtensionRangeOptions.VerificationState")
+      FieldDescriptorProto = Protostar::DSL.message("google.protobuf.FieldDescriptorProto")
+      FieldDescriptorProto::Type = Protostar::DSL.enum("google.protobuf.FieldDescriptorProto.Type")
+      FieldDescriptorProto::Label = Protostar::DSL.enum("google.protobuf.FieldDescriptorProto.Label")
+      OneofDescriptorProto = Protostar::DSL.message("google.protobuf.OneofDescriptorProto")
+      EnumDescriptorProto = Protostar::DSL.message("google.protobuf.EnumDescriptorProto")
+      EnumDescriptorProto::EnumReservedRange = Protostar::DSL.message("google.protobuf.EnumDescriptorProto.EnumReservedRange")
+      EnumValueDescriptorProto = Protostar::DSL.message("google.protobuf.EnumValueDescriptorProto")
+      ServiceDescriptorProto = Protostar::DSL.message("google.protobuf.ServiceDescriptorProto")
+      MethodDescriptorProto = Protostar::DSL.message("google.protobuf.MethodDescriptorProto")
+      FileOptions = Protostar::DSL.message("google.protobuf.FileOptions")
+      FileOptions::OptimizeMode = Protostar::DSL.enum("google.protobuf.FileOptions.OptimizeMode")
+      MessageOptions = Protostar::DSL.message("google.protobuf.MessageOptions")
+      FieldOptions = Protostar::DSL.message("google.protobuf.FieldOptions")
+      FieldOptions::EditionDefault = Protostar::DSL.message("google.protobuf.FieldOptions.EditionDefault")
+      FieldOptions::FeatureSupport = Protostar::DSL.message("google.protobuf.FieldOptions.FeatureSupport")
+      FieldOptions::CType = Protostar::DSL.enum("google.protobuf.FieldOptions.CType")
+      FieldOptions::JSType = Protostar::DSL.enum("google.protobuf.FieldOptions.JSType")
+      FieldOptions::OptionRetention = Protostar::DSL.enum("google.protobuf.FieldOptions.OptionRetention")
+      FieldOptions::OptionTargetType = Protostar::DSL.enum("google.protobuf.FieldOptions.OptionTargetType")
+      OneofOptions = Protostar::DSL.message("google.protobuf.OneofOptions")
+      EnumOptions = Protostar::DSL.message("google.protobuf.EnumOptions")
+      EnumValueOptions = Protostar::DSL.message("google.protobuf.EnumValueOptions")
+      ServiceOptions = Protostar::DSL.message("google.protobuf.ServiceOptions")
+      MethodOptions = Protostar::DSL.message("google.protobuf.MethodOptions")
+      MethodOptions::IdempotencyLevel = Protostar::DSL.enum("google.protobuf.MethodOptions.IdempotencyLevel")
+      UninterpretedOption = Protostar::DSL.message("google.protobuf.UninterpretedOption")
+      UninterpretedOption::NamePart = Protostar::DSL.message("google.protobuf.UninterpretedOption.NamePart")
+      FeatureSet = Protostar::DSL.message("google.protobuf.FeatureSet")
+      FeatureSet::VisibilityFeature = Protostar::DSL.message("google.protobuf.FeatureSet.VisibilityFeature")
+      FeatureSet::VisibilityFeature::DefaultSymbolVisibility = Protostar::DSL.enum("google.protobuf.FeatureSet.VisibilityFeature.DefaultSymbolVisibility")
+      FeatureSet::ProtoLimitsFeature = Protostar::DSL.message("google.protobuf.FeatureSet.ProtoLimitsFeature")
+      FeatureSet::ProtoLimitsFeature::EnforceProtoLimits = Protostar::DSL.enum("google.protobuf.FeatureSet.ProtoLimitsFeature.EnforceProtoLimits")
+      FeatureSet::FieldPresence = Protostar::DSL.enum("google.protobuf.FeatureSet.FieldPresence")
+      FeatureSet::EnumType = Protostar::DSL.enum("google.protobuf.FeatureSet.EnumType")
+      FeatureSet::RepeatedFieldEncoding = Protostar::DSL.enum("google.protobuf.FeatureSet.RepeatedFieldEncoding")
+      FeatureSet::Utf8Validation = Protostar::DSL.enum("google.protobuf.FeatureSet.Utf8Validation")
+      FeatureSet::MessageEncoding = Protostar::DSL.enum("google.protobuf.FeatureSet.MessageEncoding")
+      FeatureSet::JsonFormat = Protostar::DSL.enum("google.protobuf.FeatureSet.JsonFormat")
+      FeatureSet::EnforceNamingStyle = Protostar::DSL.enum("google.protobuf.FeatureSet.EnforceNamingStyle")
+      FeatureSetDefaults = Protostar::DSL.message("google.protobuf.FeatureSetDefaults")
+      FeatureSetDefaults::FeatureSetEditionDefault = Protostar::DSL.message("google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault")
+      SourceCodeInfo = Protostar::DSL.message("google.protobuf.SourceCodeInfo")
+      SourceCodeInfo::Location = Protostar::DSL.message("google.protobuf.SourceCodeInfo.Location")
+      GeneratedCodeInfo = Protostar::DSL.message("google.protobuf.GeneratedCodeInfo")
+      GeneratedCodeInfo::Annotation = Protostar::DSL.message("google.protobuf.GeneratedCodeInfo.Annotation")
+      GeneratedCodeInfo::Annotation::Semantic = Protostar::DSL.enum("google.protobuf.GeneratedCodeInfo.Annotation.Semantic")
+      Edition = Protostar::DSL.enum("google.protobuf.Edition")
+      SymbolVisibility = Protostar::DSL.enum("google.protobuf.SymbolVisibility")
+    end
+  end
+end