ts-proto 2.8.2 → 2.9.0

package/build/protos/google/protobuf/descriptor.d.ts

@@ -1,4 +1,64 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+/** The full set of known editions. */
+export declare enum Edition {
+    /** EDITION_UNKNOWN - A placeholder for an unknown edition value. */
+    EDITION_UNKNOWN = 0,
+    /**
+     * EDITION_LEGACY - A placeholder edition for specifying default behaviors *before* a feature
+     * was first introduced.  This is effectively an "infinite past".
+     */
+    EDITION_LEGACY = 900,
+    /**
+     * EDITION_PROTO2 - 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.
+     */
+    EDITION_PROTO2 = 998,
+    EDITION_PROTO3 = 999,
+    /**
+     * EDITION_2023 - 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.
+     */
+    EDITION_2023 = 1000,
+    EDITION_2024 = 1001,
+    /** EDITION_UNSTABLE - A placeholder edition for developing and testing unscheduled features. */
+    EDITION_UNSTABLE = 9999,
+    /**
+     * EDITION_1_TEST_ONLY - Placeholder editions for testing feature resolution.  These should not be
+     * used or relied on outside of tests.
+     */
+    EDITION_1_TEST_ONLY = 1,
+    EDITION_2_TEST_ONLY = 2,
+    EDITION_99997_TEST_ONLY = 99997,
+    EDITION_99998_TEST_ONLY = 99998,
+    EDITION_99999_TEST_ONLY = 99999,
+    /**
+     * EDITION_MAX - 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.
+     */
+    EDITION_MAX = 2147483647,
+    UNRECOGNIZED = -1
+}
+export declare function editionFromJSON(object: any): Edition;
+export declare function editionToJSON(object: Edition): string;
+/**
+ * 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.
+ */
+export declare enum SymbolVisibility {
+    VISIBILITY_UNSET = 0,
+    VISIBILITY_LOCAL = 1,
+    VISIBILITY_EXPORT = 2,
+    UNRECOGNIZED = -1
+}
+export declare function symbolVisibilityFromJSON(object: any): SymbolVisibility;
+export declare function symbolVisibilityToJSON(object: SymbolVisibility): string;
 /**
  * The protocol compiler can output a FileDescriptorSet containing the .proto
  * files it parses.
@@ -24,6 +84,11 @@ export interface FileDescriptorProto {
      * For Google-internal migration only. Do not use.
      */
     weakDependency: number[];
+    /**
+     * Names of files imported by this file purely for the purpose of providing
+     * option extensions. These are excluded from the dependency list above.
+     */
+    optionDependency: string[];
     /** All top-level definitions in this file. */
     messageType: DescriptorProto[];
     enumType: EnumDescriptorProto[];
@@ -39,9 +104,21 @@ export interface FileDescriptorProto {
     sourceCodeInfo: SourceCodeInfo | undefined;
     /**
      * The syntax of the proto file.
-     * The supported values are "proto2" and "proto3".
+     * 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.
      */
     syntax: 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.
+     */
+    edition: Edition;
     _unknownFields?: {
         [key: number]: Uint8Array[];
     } | undefined;
@@ -62,6 +139,8 @@ export interface DescriptorProto {
      * A given name may only be reserved once.
      */
     reservedName: string[];
+    /** Support for `export` and `local` keywords on enums. */
+    visibility: SymbolVisibility;
     _unknownFields?: {
         [key: number]: Uint8Array[];
     } | undefined;
@@ -93,6 +172,58 @@ export interface DescriptorProto_ReservedRange {
 export interface ExtensionRangeOptions {
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
+    /**
+     * 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.
+     */
+    declaration: ExtensionRangeOptions_Declaration[];
+    /** Any features defined in the specific edition. */
+    features: FeatureSet | undefined;
+    /**
+     * The verification state of the range.
+     * TODO: flip the default to DECLARATION once all empty ranges
+     * are marked as UNVERIFIED.
+     */
+    verification: ExtensionRangeOptions_VerificationState;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** The verification state of the extension range. */
+export declare enum ExtensionRangeOptions_VerificationState {
+    /** DECLARATION - All the extensions of the range must be declared. */
+    DECLARATION = 0,
+    UNVERIFIED = 1,
+    UNRECOGNIZED = -1
+}
+export declare function extensionRangeOptions_VerificationStateFromJSON(object: any): ExtensionRangeOptions_VerificationState;
+export declare function extensionRangeOptions_VerificationStateToJSON(object: ExtensionRangeOptions_VerificationState): string;
+export interface ExtensionRangeOptions_Declaration {
+    /** The extension number declared within the extension range. */
+    number: number;
+    /**
+     * The fully-qualified name of the extension field. There must be a leading
+     * dot in front of the full name.
+     */
+    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.
+     */
+    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.
+     */
+    reserved: boolean;
+    /**
+     * If true, indicates that the extension must be defined as repeated.
+     * Otherwise the extension must be defined as optional.
+     */
+    repeated: boolean;
     _unknownFields?: {
         [key: number]: Uint8Array[];
     } | undefined;
@@ -125,7 +256,6 @@ export interface FieldDescriptorProto {
      * 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.
-     * TODO(kenton):  Base-64 encode?
      */
     defaultValue: string;
     /**
@@ -145,12 +275,12 @@ export interface FieldDescriptorProto {
      * 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 be 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.
+     * 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
@@ -193,9 +323,10 @@ export declare enum FieldDescriptorProto_Type {
     TYPE_STRING = 9,
     /**
      * TYPE_GROUP - Tag-delimited aggregate.
-     * Group type is deprecated and not supported in proto3. However, Proto3
+     * 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.
+     * treat group fields as unknown fields.  In Editions, the group wire format
+     * can be enabled via the `message_encoding` feature.
      */
     TYPE_GROUP = 10,
     /** TYPE_MESSAGE - Length-delimited aggregate. */
@@ -217,8 +348,13 @@ export declare function fieldDescriptorProto_TypeToJSON(object: FieldDescriptorP
 export declare enum FieldDescriptorProto_Label {
     /** LABEL_OPTIONAL - 0 is reserved for errors */
     LABEL_OPTIONAL = 1,
-    LABEL_REQUIRED = 2,
     LABEL_REPEATED = 3,
+    /**
+     * LABEL_REQUIRED - 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.
+     */
+    LABEL_REQUIRED = 2,
     UNRECOGNIZED = -1
 }
 export declare function fieldDescriptorProto_LabelFromJSON(object: any): FieldDescriptorProto_Label;
@@ -247,6 +383,8 @@ export interface EnumDescriptorProto {
      * be reserved once.
      */
     reservedName: string[];
+    /** Support for `export` and `local` keywords on enums. */
+    visibility: SymbolVisibility;
     _unknownFields?: {
         [key: number]: Uint8Array[];
     } | undefined;
@@ -313,18 +451,18 @@ export interface FileOptions {
      */
     javaPackage: string;
     /**
-     * If set, all the classes from the .proto file are wrapped in a single
-     * outer class with the given name.  This applies to both Proto1
-     * (equivalent to the old "--one_java_file" option) and Proto2 (where
-     * a .proto always translates to a single class, but you may want to
-     * explicitly choose the class name).
+     * 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.
      */
     javaOuterClassname: string;
     /**
-     * If set true, then the Java code generator will generate a separate .java
+     * 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 outer class
-     * named by java_outer_classname.  However, the outer class will still be
+     * 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.
      */
@@ -336,12 +474,16 @@ export interface FileOptions {
      */
     javaGenerateEqualsAndHash: boolean;
     /**
-     * If set true, then the Java2 code generator will generate code that
-     * throws an exception whenever an attempt is made to assign a non-UTF-8
-     * byte sequence to a string field.
-     * Message reflection will do the same.
-     * However, an extension field still accepts non-UTF-8 byte sequences.
-     * This option has no effect on when used with the lite runtime.
+     * 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.
      */
     javaStringCheckUtf8: boolean;
     optimizeFor: FileOptions_OptimizeMode;
@@ -368,7 +510,6 @@ export interface FileOptions {
     ccGenericServices: boolean;
     javaGenericServices: boolean;
     pyGenericServices: boolean;
-    phpGenericServices: boolean;
     /**
      * Is this file deprecated?
      * Depending on the target platform, this can emit Deprecated annotations
@@ -418,6 +559,13 @@ export interface FileOptions {
      * determining the ruby package.
      */
     rubyPackage: 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.
+     */
+    features: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here.
      * See the documentation for the "Options" section above.
@@ -498,6 +646,28 @@ export interface MessageOptions {
      * parser.
      */
     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.
+     *
+     * @deprecated
+     */
+    deprecatedLegacyJsonFieldConflicts: boolean;
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -506,10 +676,13 @@ export interface MessageOptions {
 }
 export interface 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 not yet implemented in the open source
-     * release -- sorry, we'll try to include it in a future version!
+     * 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.
      */
     ctype: FieldOptions_CType;
     /**
@@ -517,7 +690,9 @@ export interface FieldOptions {
      * 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.
+     * 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.
      */
     packed: boolean;
     /**
@@ -552,18 +727,19 @@ export interface FieldOptions {
      * call from multiple threads concurrently, while non-const methods continue
      * to require exclusive access.
      *
-     * Note that implementations may choose not to check required fields within
-     * a lazy sub-message.  That is, calling IsInitialized() on the outer message
-     * may return true even if the inner message has missing required fields.
-     * This is necessary because otherwise the inner message would have to be
-     * parsed in order to perform the check, defeating the purpose of lazy
-     * parsing.  An implementation which chooses not to check required fields
-     * must be consistent about it.  That is, for any particular sub-message, the
-     * implementation must either *always* check its required fields, or *never*
-     * check its required fields, regardless of whether or not the message has
-     * been parsed.
+     * 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).
      */
     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.
+     */
+    unverifiedLazy: boolean;
     /**
      * Is this field deprecated?
      * Depending on the target platform, this can emit Deprecated annotations
@@ -571,8 +747,29 @@ export interface FieldOptions {
      * is a formalization for deprecating fields.
      */
     deprecated: boolean;
-    /** For Google-internal migration only. Do not use. */
+    /**
+     * DEPRECATED. DO NOT USE!
+     * For Google-internal migration only. Do not use.
+     *
+     * @deprecated
+     */
     weak: boolean;
+    /**
+     * Indicate that the field value should not be printed out when using debug
+     * formats, e.g. when the field contains sensitive credentials.
+     */
+    debugRedact: boolean;
+    retention: FieldOptions_OptionRetention;
+    targets: FieldOptions_OptionTargetType[];
+    editionDefaults: FieldOptions_EditionDefault[];
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
+    featureSupport: FieldOptions_FeatureSupport | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -582,6 +779,14 @@ export interface FieldOptions {
 export declare enum FieldOptions_CType {
     /** STRING - Default mode. */
     STRING = 0,
+    /**
+     * CORD - 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.
+     */
     CORD = 1,
     STRING_PIECE = 2,
     UNRECOGNIZED = -1
@@ -599,7 +804,79 @@ export declare enum FieldOptions_JSType {
 }
 export declare function fieldOptions_JSTypeFromJSON(object: any): FieldOptions_JSType;
 export declare function fieldOptions_JSTypeToJSON(object: FieldOptions_JSType): string;
+/** If set to RETENTION_SOURCE, the option will be omitted from the binary. */
+export declare enum FieldOptions_OptionRetention {
+    RETENTION_UNKNOWN = 0,
+    RETENTION_RUNTIME = 1,
+    RETENTION_SOURCE = 2,
+    UNRECOGNIZED = -1
+}
+export declare function fieldOptions_OptionRetentionFromJSON(object: any): FieldOptions_OptionRetention;
+export declare function fieldOptions_OptionRetentionToJSON(object: FieldOptions_OptionRetention): string;
+/**
+ * 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.
+ */
+export declare enum FieldOptions_OptionTargetType {
+    TARGET_TYPE_UNKNOWN = 0,
+    TARGET_TYPE_FILE = 1,
+    TARGET_TYPE_EXTENSION_RANGE = 2,
+    TARGET_TYPE_MESSAGE = 3,
+    TARGET_TYPE_FIELD = 4,
+    TARGET_TYPE_ONEOF = 5,
+    TARGET_TYPE_ENUM = 6,
+    TARGET_TYPE_ENUM_ENTRY = 7,
+    TARGET_TYPE_SERVICE = 8,
+    TARGET_TYPE_METHOD = 9,
+    UNRECOGNIZED = -1
+}
+export declare function fieldOptions_OptionTargetTypeFromJSON(object: any): FieldOptions_OptionTargetType;
+export declare function fieldOptions_OptionTargetTypeToJSON(object: FieldOptions_OptionTargetType): string;
+export interface FieldOptions_EditionDefault {
+    edition: Edition;
+    /** Textproto value. */
+    value: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** Information about the support window of a feature. */
+export interface FieldOptions_FeatureSupport {
+    /**
+     * 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.
+     */
+    editionIntroduced: Edition;
+    /**
+     * The edition this feature becomes deprecated in.  Using this after this
+     * edition may trigger warnings.
+     */
+    editionDeprecated: Edition;
+    /**
+     * The deprecation warning text if this feature is used after the edition it
+     * was marked deprecated in.
+     */
+    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.
+     */
+    editionRemoved: Edition;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
 export interface OneofOptions {
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -619,6 +896,24 @@ export interface EnumOptions {
      * is a formalization for deprecating enums.
      */
     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.
+     *
+     * @deprecated
+     */
+    deprecatedLegacyJsonFieldConflicts: boolean;
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -633,6 +928,21 @@ export interface EnumValueOptions {
      * this is a formalization for deprecating enum values.
      */
     deprecated: boolean;
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
+    /**
+     * 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.
+     */
+    debugRedact: boolean;
+    /** Information about the support window of a feature value. */
+    featureSupport: FieldOptions_FeatureSupport | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -640,6 +950,13 @@ export interface EnumValueOptions {
     } | undefined;
 }
 export interface ServiceOptions {
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
     /**
      * Is this service deprecated?
      * Depending on the target platform, this can emit Deprecated annotations
@@ -662,6 +979,13 @@ export interface MethodOptions {
      */
     deprecated: boolean;
     idempotencyLevel: MethodOptions_IdempotencyLevel;
+    /**
+     * 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.
+     */
+    features: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpretedOption: UninterpretedOption[];
     _unknownFields?: {
@@ -711,8 +1035,8 @@ export interface UninterpretedOption {
  * 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], ["qux", false] } represents
- * "foo.(bar.baz).qux".
+ * E.g.,{ ["foo", false], ["bar.baz", true], ["moo", false] } represents
+ * "foo.(bar.baz).moo".
  */
 export interface UninterpretedOption_NamePart {
     namePart: string;
@@ -721,6 +1045,145 @@ export interface UninterpretedOption_NamePart {
         [key: number]: Uint8Array[];
     } | undefined;
 }
+/**
+ * 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.
+ */
+export interface FeatureSet {
+    fieldPresence: FeatureSet_FieldPresence;
+    enumType: FeatureSet_EnumType;
+    repeatedFieldEncoding: FeatureSet_RepeatedFieldEncoding;
+    utf8Validation: FeatureSet_Utf8Validation;
+    messageEncoding: FeatureSet_MessageEncoding;
+    jsonFormat: FeatureSet_JsonFormat;
+    enforceNamingStyle: FeatureSet_EnforceNamingStyle;
+    defaultSymbolVisibility: FeatureSet_VisibilityFeature_DefaultSymbolVisibility;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare enum FeatureSet_FieldPresence {
+    FIELD_PRESENCE_UNKNOWN = 0,
+    EXPLICIT = 1,
+    IMPLICIT = 2,
+    LEGACY_REQUIRED = 3,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_FieldPresenceFromJSON(object: any): FeatureSet_FieldPresence;
+export declare function featureSet_FieldPresenceToJSON(object: FeatureSet_FieldPresence): string;
+export declare enum FeatureSet_EnumType {
+    ENUM_TYPE_UNKNOWN = 0,
+    OPEN = 1,
+    CLOSED = 2,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_EnumTypeFromJSON(object: any): FeatureSet_EnumType;
+export declare function featureSet_EnumTypeToJSON(object: FeatureSet_EnumType): string;
+export declare enum FeatureSet_RepeatedFieldEncoding {
+    REPEATED_FIELD_ENCODING_UNKNOWN = 0,
+    PACKED = 1,
+    EXPANDED = 2,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_RepeatedFieldEncodingFromJSON(object: any): FeatureSet_RepeatedFieldEncoding;
+export declare function featureSet_RepeatedFieldEncodingToJSON(object: FeatureSet_RepeatedFieldEncoding): string;
+export declare enum FeatureSet_Utf8Validation {
+    UTF8_VALIDATION_UNKNOWN = 0,
+    VERIFY = 2,
+    NONE = 3,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_Utf8ValidationFromJSON(object: any): FeatureSet_Utf8Validation;
+export declare function featureSet_Utf8ValidationToJSON(object: FeatureSet_Utf8Validation): string;
+export declare enum FeatureSet_MessageEncoding {
+    MESSAGE_ENCODING_UNKNOWN = 0,
+    LENGTH_PREFIXED = 1,
+    DELIMITED = 2,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_MessageEncodingFromJSON(object: any): FeatureSet_MessageEncoding;
+export declare function featureSet_MessageEncodingToJSON(object: FeatureSet_MessageEncoding): string;
+export declare enum FeatureSet_JsonFormat {
+    JSON_FORMAT_UNKNOWN = 0,
+    ALLOW = 1,
+    LEGACY_BEST_EFFORT = 2,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_JsonFormatFromJSON(object: any): FeatureSet_JsonFormat;
+export declare function featureSet_JsonFormatToJSON(object: FeatureSet_JsonFormat): string;
+export declare enum FeatureSet_EnforceNamingStyle {
+    ENFORCE_NAMING_STYLE_UNKNOWN = 0,
+    STYLE2024 = 1,
+    STYLE_LEGACY = 2,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_EnforceNamingStyleFromJSON(object: any): FeatureSet_EnforceNamingStyle;
+export declare function featureSet_EnforceNamingStyleToJSON(object: FeatureSet_EnforceNamingStyle): string;
+export interface FeatureSet_VisibilityFeature {
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare enum FeatureSet_VisibilityFeature_DefaultSymbolVisibility {
+    DEFAULT_SYMBOL_VISIBILITY_UNKNOWN = 0,
+    /** EXPORT_ALL - Default pre-EDITION_2024, all UNSET visibility are export. */
+    EXPORT_ALL = 1,
+    /** EXPORT_TOP_LEVEL - All top-level symbols default to export, nested default to local. */
+    EXPORT_TOP_LEVEL = 2,
+    /** LOCAL_ALL - All symbols default to local. */
+    LOCAL_ALL = 3,
+    /**
+     * STRICT - 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.
+     */
+    STRICT = 4,
+    UNRECOGNIZED = -1
+}
+export declare function featureSet_VisibilityFeature_DefaultSymbolVisibilityFromJSON(object: any): FeatureSet_VisibilityFeature_DefaultSymbolVisibility;
+export declare function featureSet_VisibilityFeature_DefaultSymbolVisibilityToJSON(object: FeatureSet_VisibilityFeature_DefaultSymbolVisibility): string;
+/**
+ * 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.
+ */
+export interface FeatureSetDefaults {
+    defaults: FeatureSetDefaults_FeatureSetEditionDefault[];
+    /**
+     * The minimum supported edition (inclusive) when this was constructed.
+     * Editions before this will not have defaults.
+     */
+    minimumEdition: Edition;
+    /**
+     * The maximum known edition (inclusive) when this was constructed. Editions
+     * after this will not have reliable defaults.
+     */
+    maximumEdition: Edition;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * 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.
+ */
+export interface FeatureSetDefaults_FeatureSetEditionDefault {
+    edition: Edition;
+    /** Defaults of features that can be overridden in this edition. */
+    overridableFeatures: FeatureSet | undefined;
+    /** Defaults of features that can't be overridden in this edition. */
+    fixedFeatures: FeatureSet | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
 /**
  * Encapsulates information about the original source file from which a
  * FileDescriptorProto was generated.
@@ -782,8 +1245,8 @@ export interface SourceCodeInfo_Location {
      * location.
      *
      * Each element is a field number or an index.  They form a path from
-     * the root FileDescriptorProto to the place where the definition.  For
-     * example, this path:
+     * 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
@@ -839,13 +1302,13 @@ export interface SourceCodeInfo_Location {
      *   // Comment attached to baz.
      *   // Another line attached to baz.
      *
-     *   // Comment attached to qux.
+     *   // Comment attached to moo.
      *   //
-     *   // Another line attached to qux.
-     *   optional double qux = 4;
+     *   // Another line attached to moo.
+     *   optional double moo = 4;
      *
      *   // Detached comment for corge. This is not leading or trailing comments
-     *   // to qux or corge because there are blank lines separating it from
+     *   // to moo or corge because there are blank lines separating it from
      *   // both.
      *
      *   // Detached comment for corge paragraph 2.
@@ -897,17 +1360,35 @@ export interface GeneratedCodeInfo_Annotation {
     begin: number;
     /**
      * Identifies the ending offset in bytes in the generated code that
-     * relates to the identified offset. The end offset should be one past
+     * relates to the identified object. The end offset should be one past
      * the last relevant byte (so the length of the text = end - begin).
      */
     end: number;
+    semantic: GeneratedCodeInfo_Annotation_Semantic;
     _unknownFields?: {
         [key: number]: Uint8Array[];
     } | undefined;
 }
+/**
+ * Represents the identified object's effect on the element in the original
+ * .proto file.
+ */
+export declare enum GeneratedCodeInfo_Annotation_Semantic {
+    /** NONE - There is no effect or the effect is indescribable. */
+    NONE = 0,
+    /** SET - The element is set or otherwise mutated. */
+    SET = 1,
+    /** ALIAS - An alias to the element is returned. */
+    ALIAS = 2,
+    UNRECOGNIZED = -1
+}
+export declare function generatedCodeInfo_Annotation_SemanticFromJSON(object: any): GeneratedCodeInfo_Annotation_Semantic;
+export declare function generatedCodeInfo_Annotation_SemanticToJSON(object: GeneratedCodeInfo_Annotation_Semantic): string;
 export declare const FileDescriptorSet: {
     encode(message: FileDescriptorSet, writer?: BinaryWriter): BinaryWriter;
+    setExtension<T>(message: FileDescriptorSet, extension: Extension<T>, value: T): void;
     decode(input: BinaryReader | Uint8Array, length?: number): FileDescriptorSet;
+    getExtension<T>(message: FileDescriptorSet, extension: Extension<T>): T | undefined;
     fromJSON(object: any): FileDescriptorSet;
     toJSON(message: FileDescriptorSet): unknown;
     create(base?: DeepPartial<FileDescriptorSet>): FileDescriptorSet;
@@ -955,6 +1436,14 @@ export declare const ExtensionRangeOptions: {
     create(base?: DeepPartial<ExtensionRangeOptions>): ExtensionRangeOptions;
     fromPartial(object: DeepPartial<ExtensionRangeOptions>): ExtensionRangeOptions;
 };
+export declare const ExtensionRangeOptions_Declaration: {
+    encode(message: ExtensionRangeOptions_Declaration, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): ExtensionRangeOptions_Declaration;
+    fromJSON(object: any): ExtensionRangeOptions_Declaration;
+    toJSON(message: ExtensionRangeOptions_Declaration): unknown;
+    create(base?: DeepPartial<ExtensionRangeOptions_Declaration>): ExtensionRangeOptions_Declaration;
+    fromPartial(object: DeepPartial<ExtensionRangeOptions_Declaration>): ExtensionRangeOptions_Declaration;
+};
 export declare const FieldDescriptorProto: {
     encode(message: FieldDescriptorProto, writer?: BinaryWriter): BinaryWriter;
     decode(input: BinaryReader | Uint8Array, length?: number): FieldDescriptorProto;
@@ -1041,6 +1530,22 @@ export declare const FieldOptions: {
     create(base?: DeepPartial<FieldOptions>): FieldOptions;
     fromPartial(object: DeepPartial<FieldOptions>): FieldOptions;
 };
+export declare const FieldOptions_EditionDefault: {
+    encode(message: FieldOptions_EditionDefault, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): FieldOptions_EditionDefault;
+    fromJSON(object: any): FieldOptions_EditionDefault;
+    toJSON(message: FieldOptions_EditionDefault): unknown;
+    create(base?: DeepPartial<FieldOptions_EditionDefault>): FieldOptions_EditionDefault;
+    fromPartial(object: DeepPartial<FieldOptions_EditionDefault>): FieldOptions_EditionDefault;
+};
+export declare const FieldOptions_FeatureSupport: {
+    encode(message: FieldOptions_FeatureSupport, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): FieldOptions_FeatureSupport;
+    fromJSON(object: any): FieldOptions_FeatureSupport;
+    toJSON(message: FieldOptions_FeatureSupport): unknown;
+    create(base?: DeepPartial<FieldOptions_FeatureSupport>): FieldOptions_FeatureSupport;
+    fromPartial(object: DeepPartial<FieldOptions_FeatureSupport>): FieldOptions_FeatureSupport;
+};
 export declare const OneofOptions: {
     encode(message: OneofOptions, writer?: BinaryWriter): BinaryWriter;
     setExtension<T>(message: OneofOptions, extension: Extension<T>, value: T): void;
@@ -1107,9 +1612,45 @@ export declare const UninterpretedOption_NamePart: {
     create(base?: DeepPartial<UninterpretedOption_NamePart>): UninterpretedOption_NamePart;
     fromPartial(object: DeepPartial<UninterpretedOption_NamePart>): UninterpretedOption_NamePart;
 };
+export declare const FeatureSet: {
+    encode(message: FeatureSet, writer?: BinaryWriter): BinaryWriter;
+    setExtension<T>(message: FeatureSet, extension: Extension<T>, value: T): void;
+    decode(input: BinaryReader | Uint8Array, length?: number): FeatureSet;
+    getExtension<T>(message: FeatureSet, extension: Extension<T>): T | undefined;
+    fromJSON(object: any): FeatureSet;
+    toJSON(message: FeatureSet): unknown;
+    create(base?: DeepPartial<FeatureSet>): FeatureSet;
+    fromPartial(object: DeepPartial<FeatureSet>): FeatureSet;
+};
+export declare const FeatureSet_VisibilityFeature: {
+    encode(message: FeatureSet_VisibilityFeature, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): FeatureSet_VisibilityFeature;
+    fromJSON(_: any): FeatureSet_VisibilityFeature;
+    toJSON(_: FeatureSet_VisibilityFeature): unknown;
+    create(base?: DeepPartial<FeatureSet_VisibilityFeature>): FeatureSet_VisibilityFeature;
+    fromPartial(_: DeepPartial<FeatureSet_VisibilityFeature>): FeatureSet_VisibilityFeature;
+};
+export declare const FeatureSetDefaults: {
+    encode(message: FeatureSetDefaults, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): FeatureSetDefaults;
+    fromJSON(object: any): FeatureSetDefaults;
+    toJSON(message: FeatureSetDefaults): unknown;
+    create(base?: DeepPartial<FeatureSetDefaults>): FeatureSetDefaults;
+    fromPartial(object: DeepPartial<FeatureSetDefaults>): FeatureSetDefaults;
+};
+export declare const FeatureSetDefaults_FeatureSetEditionDefault: {
+    encode(message: FeatureSetDefaults_FeatureSetEditionDefault, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): FeatureSetDefaults_FeatureSetEditionDefault;
+    fromJSON(object: any): FeatureSetDefaults_FeatureSetEditionDefault;
+    toJSON(message: FeatureSetDefaults_FeatureSetEditionDefault): unknown;
+    create(base?: DeepPartial<FeatureSetDefaults_FeatureSetEditionDefault>): FeatureSetDefaults_FeatureSetEditionDefault;
+    fromPartial(object: DeepPartial<FeatureSetDefaults_FeatureSetEditionDefault>): FeatureSetDefaults_FeatureSetEditionDefault;
+};
 export declare const SourceCodeInfo: {
     encode(message: SourceCodeInfo, writer?: BinaryWriter): BinaryWriter;
+    setExtension<T>(message: SourceCodeInfo, extension: Extension<T>, value: T): void;
     decode(input: BinaryReader | Uint8Array, length?: number): SourceCodeInfo;
+    getExtension<T>(message: SourceCodeInfo, extension: Extension<T>): T | undefined;
     fromJSON(object: any): SourceCodeInfo;
     toJSON(message: SourceCodeInfo): unknown;
     create(base?: DeepPartial<SourceCodeInfo>): SourceCodeInfo;