@diia-inhouse/types 6.51.0 → 10.0.10

package/dist/types/generated/google/protobuf/descriptor.d.ts

@@ -1,5 +1,47 @@
-/// <reference types="node" />
 import _m0 from "protobufjs/minimal.js";
+/** The full set of known editions. */
+export declare enum Edition {
+    /** EDITION_UNKNOWN - A placeholder for an unknown edition value. */
+    EDITION_UNKNOWN = "EDITION_UNKNOWN",
+    /**
+     * EDITION_LEGACY - A placeholder edition for specifying default behaviors *before* a feature
+     * was first introduced.  This is effectively an "infinite past".
+     */
+    EDITION_LEGACY = "EDITION_LEGACY",
+    /**
+     * 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 = "EDITION_PROTO2",
+    EDITION_PROTO3 = "EDITION_PROTO3",
+    /**
+     * 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 = "EDITION_2023",
+    EDITION_2024 = "EDITION_2024",
+    /**
+     * 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 = "EDITION_1_TEST_ONLY",
+    EDITION_2_TEST_ONLY = "EDITION_2_TEST_ONLY",
+    EDITION_99997_TEST_ONLY = "EDITION_99997_TEST_ONLY",
+    EDITION_99998_TEST_ONLY = "EDITION_99998_TEST_ONLY",
+    EDITION_99999_TEST_ONLY = "EDITION_99999_TEST_ONLY",
+    /**
+     * 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 = "EDITION_MAX"
+}
+export declare function editionFromJSON(object: any): Edition;
+export declare function editionToJSON(object: Edition): string;
+export declare function editionToNumber(object: Edition): number;
 /**
  * The protocol compiler can output a FileDescriptorSet containing the .proto
  * files it parses.
@@ -10,9 +52,9 @@ export interface FileDescriptorSet {
 /** Describes a complete .proto file. */
 export interface FileDescriptorProto {
     /** file name, relative to root of source tree */
-    name: string;
+    name?: string | undefined;
     /** e.g. "foo", "foo.bar", etc. */
-    package: string;
+    package?: string | undefined;
     /** Names of files imported by this file. */
     dependency: string[];
     /** Indexes of the public imported files in the dependency list above. */
@@ -27,34 +69,34 @@ export interface FileDescriptorProto {
     enum_type: EnumDescriptorProto[];
     service: ServiceDescriptorProto[];
     extension: FieldDescriptorProto[];
-    options: FileOptions | undefined;
+    options?: FileOptions | undefined;
     /**
      * 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.
      */
-    source_code_info: SourceCodeInfo | undefined;
+    source_code_info?: SourceCodeInfo | undefined;
     /**
      * The syntax of the proto file.
      * The supported values are "proto2", "proto3", and "editions".
      *
      * If `edition` is present, this value must be "editions".
      */
-    syntax: string;
-    /** The edition of the proto file, which is an opaque string. */
-    edition: string;
+    syntax?: string | undefined;
+    /** The edition of the proto file. */
+    edition?: Edition | undefined;
 }
 /** Describes a message type. */
 export interface DescriptorProto {
-    name: string;
+    name?: string | undefined;
     field: FieldDescriptorProto[];
     extension: FieldDescriptorProto[];
     nested_type: DescriptorProto[];
     enum_type: EnumDescriptorProto[];
     extension_range: DescriptorProtoExtensionRange[];
     oneof_decl: OneofDescriptorProto[];
-    options: MessageOptions | undefined;
+    options?: MessageOptions | undefined;
     reserved_range: DescriptorProtoReservedRange[];
     /**
      * Reserved field names, which may not be used by fields in the same message.
@@ -64,10 +106,10 @@ export interface DescriptorProto {
 }
 export interface DescriptorProtoExtensionRange {
     /** Inclusive. */
-    start: number;
+    start?: number | undefined;
     /** Exclusive. */
-    end: number;
-    options: ExtensionRangeOptions | undefined;
+    end?: number | undefined;
+    options?: ExtensionRangeOptions | undefined;
 }
 /**
  * Range of reserved tag numbers. Reserved tag numbers may not be used by
@@ -76,9 +118,9 @@ export interface DescriptorProtoExtensionRange {
  */
 export interface DescriptorProtoReservedRange {
     /** Inclusive. */
-    start: number;
+    start?: number | undefined;
     /** Exclusive. */
-    end: number;
+    end?: number | undefined;
 }
 export interface ExtensionRangeOptions {
     /** The parser stores options it doesn't recognize here. See above. */
@@ -90,13 +132,13 @@ export interface ExtensionRangeOptions {
      */
     declaration: ExtensionRangeOptionsDeclaration[];
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /**
      * The verification state of the range.
-     * TODO(b/278783756): flip the default to DECLARATION once all empty ranges
+     * TODO: flip the default to DECLARATION once all empty ranges
      * are marked as UNVERIFIED.
      */
-    verification: ExtensionRangeOptionsVerificationState;
+    verification?: ExtensionRangeOptionsVerificationState | undefined;
 }
 /** The verification state of the extension range. */
 export declare enum ExtensionRangeOptionsVerificationState {
@@ -109,40 +151,40 @@ export declare function extensionRangeOptionsVerificationStateToJSON(object: Ext
 export declare function extensionRangeOptionsVerificationStateToNumber(object: ExtensionRangeOptionsVerificationState): number;
 export interface ExtensionRangeOptionsDeclaration {
     /** The extension number declared within the extension range. */
-    number: number;
+    number?: number | undefined;
     /**
      * The fully-qualified name of the extension field. There must be a leading
      * dot in front of the full name.
      */
-    full_name: string;
+    full_name?: string | undefined;
     /**
      * 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;
+    type?: string | undefined;
     /**
      * 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;
+    reserved?: boolean | undefined;
     /**
      * If true, indicates that the extension must be defined as repeated.
      * Otherwise the extension must be defined as optional.
      */
-    repeated: boolean;
+    repeated?: boolean | undefined;
 }
 /** Describes a field within a message. */
 export interface FieldDescriptorProto {
-    name: string;
-    number: number;
-    label: FieldDescriptorProtoLabel;
+    name?: string | undefined;
+    number?: number | undefined;
+    label?: FieldDescriptorProtoLabel | undefined;
     /**
      * 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.
      */
-    type: FieldDescriptorProtoType;
+    type?: FieldDescriptorProtoType | undefined;
     /**
      * 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
@@ -150,42 +192,42 @@ export interface FieldDescriptorProto {
      * message are searched, then within the parent, on up to the root
      * namespace).
      */
-    type_name: string;
+    type_name?: string | undefined;
     /**
      * For extensions, this is the name of the type being extended.  It is
      * resolved in the same manner as type_name.
      */
-    extendee: string;
+    extendee?: string | undefined;
     /**
      * 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.
      */
-    default_value: string;
+    default_value?: string | undefined;
     /**
      * If set, gives the index of a oneof in the containing type's oneof_decl
      * list.  This field is a member of that oneof.
      */
-    oneof_index: number;
+    oneof_index?: number | undefined;
     /**
      * 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.
      */
-    json_name: string;
-    options: FieldOptions | undefined;
+    json_name?: string | undefined;
+    options?: FieldOptions | undefined;
     /**
      * 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
@@ -199,7 +241,7 @@ export interface FieldDescriptorProto {
      * Proto2 optional fields do not set this flag, because they already indicate
      * optional with `LABEL_OPTIONAL`.
      */
-    proto3_optional: boolean;
+    proto3_optional?: boolean | undefined;
 }
 export declare enum FieldDescriptorProtoType {
     /**
@@ -225,9 +267,10 @@ export declare enum FieldDescriptorProtoType {
     TYPE_STRING = "TYPE_STRING",
     /**
      * 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 = "TYPE_GROUP",
     /** TYPE_MESSAGE - Length-delimited aggregate. */
@@ -249,22 +292,27 @@ export declare function fieldDescriptorProtoTypeToNumber(object: FieldDescriptor
 export declare enum FieldDescriptorProtoLabel {
     /** LABEL_OPTIONAL - 0 is reserved for errors */
     LABEL_OPTIONAL = "LABEL_OPTIONAL",
-    LABEL_REQUIRED = "LABEL_REQUIRED",
-    LABEL_REPEATED = "LABEL_REPEATED"
+    LABEL_REPEATED = "LABEL_REPEATED",
+    /**
+     * 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 = "LABEL_REQUIRED"
 }
 export declare function fieldDescriptorProtoLabelFromJSON(object: any): FieldDescriptorProtoLabel;
 export declare function fieldDescriptorProtoLabelToJSON(object: FieldDescriptorProtoLabel): string;
 export declare function fieldDescriptorProtoLabelToNumber(object: FieldDescriptorProtoLabel): number;
 /** Describes a oneof. */
 export interface OneofDescriptorProto {
-    name: string;
-    options: OneofOptions | undefined;
+    name?: string | undefined;
+    options?: OneofOptions | undefined;
 }
 /** Describes an enum type. */
 export interface EnumDescriptorProto {
-    name: string;
+    name?: string | undefined;
     value: EnumValueDescriptorProto[];
-    options: EnumOptions | undefined;
+    options?: EnumOptions | undefined;
     /**
      * Range of reserved numeric values. Reserved numeric values may not be used
      * by enum values in the same enum declaration. Reserved ranges may not
@@ -287,36 +335,36 @@ export interface EnumDescriptorProto {
  */
 export interface EnumDescriptorProtoEnumReservedRange {
     /** Inclusive. */
-    start: number;
+    start?: number | undefined;
     /** Inclusive. */
-    end: number;
+    end?: number | undefined;
 }
 /** Describes a value within an enum. */
 export interface EnumValueDescriptorProto {
-    name: string;
-    number: number;
-    options: EnumValueOptions | undefined;
+    name?: string | undefined;
+    number?: number | undefined;
+    options?: EnumValueOptions | undefined;
 }
 /** Describes a service. */
 export interface ServiceDescriptorProto {
-    name: string;
+    name?: string | undefined;
     method: MethodDescriptorProto[];
-    options: ServiceOptions | undefined;
+    options?: ServiceOptions | undefined;
 }
 /** Describes a method of a service. */
 export interface MethodDescriptorProto {
-    name: string;
+    name?: string | undefined;
     /**
      * Input and output type names.  These are resolved in the same way as
      * FieldDescriptorProto.type_name, but must refer to a message type.
      */
-    input_type: string;
-    output_type: string;
-    options: MethodOptions | undefined;
+    input_type?: string | undefined;
+    output_type?: string | undefined;
+    options?: MethodOptions | undefined;
     /** Identifies if client streams multiple client messages */
-    client_streaming: boolean;
+    client_streaming?: boolean | undefined;
     /** Identifies if server streams multiple server messages */
-    server_streaming: boolean;
+    server_streaming?: boolean | undefined;
 }
 export interface FileOptions {
     /**
@@ -325,7 +373,7 @@ export interface FileOptions {
      * inappropriate because proto packages do not normally start with backwards
      * domain names.
      */
-    java_package: string;
+    java_package?: string | undefined;
     /**
      * 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
@@ -333,7 +381,7 @@ export interface FileOptions {
      * If java_multiple_files is disabled, then all the other classes from the
      * .proto file will be nested inside the single wrapper outer class.
      */
-    java_outer_classname: string;
+    java_outer_classname?: string | undefined;
     /**
      * 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
@@ -342,23 +390,27 @@ export interface FileOptions {
      * generated to contain the file's getDescriptor() method as well as any
      * top-level extensions defined in the file.
      */
-    java_multiple_files: boolean;
+    java_multiple_files?: boolean | undefined;
     /**
      * This option does nothing.
      *
      * @deprecated
      */
-    java_generate_equals_and_hash: boolean;
+    java_generate_equals_and_hash?: boolean | undefined;
     /**
-     * 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.
      */
-    java_string_check_utf8: boolean;
-    optimize_for: FileOptionsOptimizeMode;
+    java_string_check_utf8?: boolean | undefined;
+    optimize_for?: FileOptionsOptimizeMode | undefined;
     /**
      * Sets the Go package where structs generated from this .proto will be
      * placed. If omitted, the Go package will be derived from the following:
@@ -366,7 +418,7 @@ export interface FileOptions {
      *   - Otherwise, the package statement in the .proto file, if present.
      *   - Otherwise, the basename of the .proto file, without extension.
      */
-    go_package: string;
+    go_package?: string | undefined;
     /**
      * Should generic services be generated in each language?  "Generic" services
      * are not specific to any particular RPC system.  They are generated by the
@@ -379,61 +431,60 @@ export interface FileOptions {
      * these default to false.  Old code which depends on generic services should
      * explicitly set them to true.
      */
-    cc_generic_services: boolean;
-    java_generic_services: boolean;
-    py_generic_services: boolean;
-    php_generic_services: boolean;
+    cc_generic_services?: boolean | undefined;
+    java_generic_services?: boolean | undefined;
+    py_generic_services?: boolean | undefined;
     /**
      * 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.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /**
      * Enables the use of arenas for the proto messages in this file. This applies
      * only to generated classes for C++.
      */
-    cc_enable_arenas: boolean;
+    cc_enable_arenas?: boolean | undefined;
     /**
      * Sets the objective c class prefix which is prepended to all objective c
      * generated classes from this .proto. There is no default.
      */
-    objc_class_prefix: string;
+    objc_class_prefix?: string | undefined;
     /** Namespace for generated classes; defaults to the package. */
-    csharp_namespace: string;
+    csharp_namespace?: string | undefined;
     /**
      * 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.
      */
-    swift_prefix: string;
+    swift_prefix?: string | undefined;
     /**
      * Sets the php class prefix which is prepended to all php generated classes
      * from this .proto. Default is empty.
      */
-    php_class_prefix: string;
+    php_class_prefix?: string | undefined;
     /**
      * 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.
      */
-    php_namespace: string;
+    php_namespace?: string | undefined;
     /**
      * 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.
      */
-    php_metadata_namespace: string;
+    php_metadata_namespace?: string | undefined;
     /**
      * 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.
      */
-    ruby_package: string;
+    ruby_package?: string | undefined;
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /**
      * The parser stores options it doesn't recognize here.
      * See the documentation for the "Options" section above.
@@ -473,25 +524,21 @@ export interface MessageOptions {
      * Because this is an option, the above two restrictions are not enforced by
      * the protocol compiler.
      */
-    message_set_wire_format: boolean;
+    message_set_wire_format?: boolean | undefined;
     /**
      * 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".
      */
-    no_standard_descriptor_accessor: boolean;
+    no_standard_descriptor_accessor?: boolean | undefined;
     /**
      * 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.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /**
-     * 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.
-     *
      * Whether the message is an automatically generated map entry type for the
      * maps field.
      *
@@ -509,8 +556,12 @@ export interface MessageOptions {
      * 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.
      */
-    map_entry: boolean;
+    map_entry?: boolean | undefined;
     /**
      * Enable the legacy handling of JSON field name conflicts.  This lowercases
      * and strips underscored from the fields before comparison in proto3 only.
@@ -520,35 +571,38 @@ export interface MessageOptions {
      * This should only be used as a temporary measure against broken builds due
      * to the change in behavior for JSON field name conflicts.
      *
-     * TODO(b/261750190) This is legacy behavior we plan to remove once downstream
+     * TODO This is legacy behavior we plan to remove once downstream
      * teams have had time to migrate.
      *
      * @deprecated
      */
-    deprecated_legacy_json_field_conflicts: boolean;
+    deprecated_legacy_json_field_conflicts?: boolean | undefined;
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
 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 only implemented to support use of
      * [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of
-     * type "bytes" in the open source release -- sorry, we'll try to include
-     * other types in a future version!
+     * type "bytes" in the open source release.
+     * TODO: make ctype actually deprecated.
      */
-    ctype: FieldOptionsCType;
+    ctype?: FieldOptionsCType | undefined;
     /**
      * 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.
+     * 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;
+    packed?: boolean | undefined;
     /**
      * 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
@@ -562,7 +616,7 @@ export interface FieldOptions {
      * This option is an enum to permit additional types to be added, e.g.
      * goog.math.Integer.
      */
-    jstype: FieldOptionsJSType;
+    jstype?: FieldOptionsJSType | undefined;
     /**
      * Should this field be parsed lazily?  Lazy applies only to message-type
      * fields.  It means that when the outer message is initially parsed, the
@@ -581,46 +635,39 @@ 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.
-     *
-     * As of May 2022, lazy verifies the contents of the byte stream during
-     * parsing.  An invalid byte stream will cause the overall parsing to fail.
+     * 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;
+    lazy?: boolean | undefined;
     /**
      * unverified_lazy does no correctness checks on the byte stream. This should
      * only be used where lazy with verification is prohibitive for performance
      * reasons.
      */
-    unverified_lazy: boolean;
+    unverified_lazy?: boolean | undefined;
     /**
      * 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.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /** For Google-internal migration only. Do not use. */
-    weak: boolean;
+    weak?: boolean | undefined;
     /**
      * Indicate that the field value should not be printed out when using debug
      * formats, e.g. when the field contains sensitive credentials.
      */
-    debug_redact: boolean;
-    retention: FieldOptionsOptionRetention;
+    debug_redact?: boolean | undefined;
+    retention?: FieldOptionsOptionRetention | undefined;
     targets: FieldOptionsOptionTargetType[];
     edition_defaults: FieldOptionsEditionDefault[];
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
+    feature_support?: FieldOptionsFeatureSupport | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
@@ -652,11 +699,7 @@ export declare enum FieldOptionsJSType {
 export declare function fieldOptionsJSTypeFromJSON(object: any): FieldOptionsJSType;
 export declare function fieldOptionsJSTypeToJSON(object: FieldOptionsJSType): string;
 export declare function fieldOptionsJSTypeToNumber(object: FieldOptionsJSType): number;
-/**
- * If set to RETENTION_SOURCE, the option will be omitted from the binary.
- * Note: as of January 2023, support for this is in progress and does not yet
- * have an effect (b/264593489).
- */
+/** If set to RETENTION_SOURCE, the option will be omitted from the binary. */
 export declare enum FieldOptionsOptionRetention {
     RETENTION_UNKNOWN = "RETENTION_UNKNOWN",
     RETENTION_RUNTIME = "RETENTION_RUNTIME",
@@ -668,8 +711,7 @@ export declare function fieldOptionsOptionRetentionToNumber(object: FieldOptions
 /**
  * This indicates the types of entities that the field may apply to when used
  * as an option. If it is unset, then the field may be freely used as an
- * option on any kind of entity. Note: as of January 2023, support for this is
- * in progress and does not yet have an effect (b/264593489).
+ * option on any kind of entity.
  */
 export declare enum FieldOptionsOptionTargetType {
     TARGET_TYPE_UNKNOWN = "TARGET_TYPE_UNKNOWN",
@@ -687,13 +729,38 @@ export declare function fieldOptionsOptionTargetTypeFromJSON(object: any): Field
 export declare function fieldOptionsOptionTargetTypeToJSON(object: FieldOptionsOptionTargetType): string;
 export declare function fieldOptionsOptionTargetTypeToNumber(object: FieldOptionsOptionTargetType): number;
 export interface FieldOptionsEditionDefault {
-    edition: string;
+    edition?: Edition | undefined;
     /** Textproto value. */
-    value: string;
+    value?: string | undefined;
+}
+/** Information about the support window of a feature. */
+export interface FieldOptionsFeatureSupport {
+    /**
+     * 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.
+     */
+    edition_introduced?: Edition | undefined;
+    /**
+     * The edition this feature becomes deprecated in.  Using this after this
+     * edition may trigger warnings.
+     */
+    edition_deprecated?: Edition | undefined;
+    /**
+     * The deprecation warning text if this feature is used after the edition it
+     * was marked deprecated in.
+     */
+    deprecation_warning?: string | undefined;
+    /**
+     * 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.
+     */
+    edition_removed?: Edition | undefined;
 }
 export interface OneofOptions {
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
@@ -702,27 +769,27 @@ export interface EnumOptions {
      * Set this option to true to allow mapping different tag names to the same
      * value.
      */
-    allow_alias: boolean;
+    allow_alias?: boolean | undefined;
     /**
      * 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.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /**
      * 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(b/261750190) Remove this legacy behavior once downstream teams have
+     * TODO Remove this legacy behavior once downstream teams have
      * had time to migrate.
      *
      * @deprecated
      */
-    deprecated_legacy_json_field_conflicts: boolean;
+    deprecated_legacy_json_field_conflicts?: boolean | undefined;
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
@@ -733,28 +800,30 @@ export interface EnumValueOptions {
      * for the enum value, or it will be completely ignored; in the very least,
      * this is a formalization for deprecating enum values.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    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.
      */
-    debug_redact: boolean;
+    debug_redact?: boolean | undefined;
+    /** Information about the support window of a feature value. */
+    feature_support?: FieldOptionsFeatureSupport | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
 export interface ServiceOptions {
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /**
      * 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.
      */
-    deprecated: boolean;
+    deprecated?: boolean | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
@@ -765,10 +834,10 @@ export interface MethodOptions {
      * for the method, or it will be completely ignored; in the very least,
      * this is a formalization for deprecating methods.
      */
-    deprecated: boolean;
-    idempotency_level: MethodOptionsIdempotencyLevel;
+    deprecated?: boolean | undefined;
+    idempotency_level?: MethodOptionsIdempotencyLevel | undefined;
     /** Any features defined in the specific edition. */
-    features: FeatureSet | undefined;
+    features?: FeatureSet | undefined;
     /** The parser stores options it doesn't recognize here. See above. */
     uninterpreted_option: UninterpretedOption[];
 }
@@ -801,12 +870,12 @@ export interface UninterpretedOption {
      * The value of the uninterpreted option, in whatever type the tokenizer
      * identified it as during parsing. Exactly one of these should be set.
      */
-    identifier_value: string;
-    positive_int_value: number;
-    negative_int_value: number;
-    double_value: number;
-    string_value: Buffer;
-    aggregate_value: string;
+    identifier_value?: string | undefined;
+    positive_int_value?: number | undefined;
+    negative_int_value?: number | undefined;
+    double_value?: number | undefined;
+    string_value?: Buffer | undefined;
+    aggregate_value?: string | undefined;
 }
 /**
  * The name of the uninterpreted option.  Each string represents a segment in
@@ -820,7 +889,7 @@ export interface UninterpretedOptionNamePart {
     is_extension: boolean;
 }
 /**
- * TODO(b/274655146) Enums in C++ gencode (and potentially other languages) are
+ * 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
@@ -828,13 +897,12 @@ export interface UninterpretedOptionNamePart {
  * conflict here.
  */
 export interface FeatureSet {
-    field_presence: FeatureSetFieldPresence;
-    enum_type: FeatureSetEnumType;
-    repeated_field_encoding: FeatureSetRepeatedFieldEncoding;
-    string_field_validation: FeatureSetStringFieldValidation;
-    message_encoding: FeatureSetMessageEncoding;
-    json_format: FeatureSetJsonFormat;
-    raw_features: FeatureSet | undefined;
+    field_presence?: FeatureSetFieldPresence | undefined;
+    enum_type?: FeatureSetEnumType | undefined;
+    repeated_field_encoding?: FeatureSetRepeatedFieldEncoding | undefined;
+    utf8_validation?: FeatureSetUtf8Validation | undefined;
+    message_encoding?: FeatureSetMessageEncoding | undefined;
+    json_format?: FeatureSetJsonFormat | undefined;
 }
 export declare enum FeatureSetFieldPresence {
     FIELD_PRESENCE_UNKNOWN = "FIELD_PRESENCE_UNKNOWN",
@@ -861,15 +929,14 @@ export declare enum FeatureSetRepeatedFieldEncoding {
 export declare function featureSetRepeatedFieldEncodingFromJSON(object: any): FeatureSetRepeatedFieldEncoding;
 export declare function featureSetRepeatedFieldEncodingToJSON(object: FeatureSetRepeatedFieldEncoding): string;
 export declare function featureSetRepeatedFieldEncodingToNumber(object: FeatureSetRepeatedFieldEncoding): number;
-export declare enum FeatureSetStringFieldValidation {
-    STRING_FIELD_VALIDATION_UNKNOWN = "STRING_FIELD_VALIDATION_UNKNOWN",
-    MANDATORY = "MANDATORY",
-    HINT = "HINT",
+export declare enum FeatureSetUtf8Validation {
+    UTF8_VALIDATION_UNKNOWN = "UTF8_VALIDATION_UNKNOWN",
+    VERIFY = "VERIFY",
     NONE = "NONE"
 }
-export declare function featureSetStringFieldValidationFromJSON(object: any): FeatureSetStringFieldValidation;
-export declare function featureSetStringFieldValidationToJSON(object: FeatureSetStringFieldValidation): string;
-export declare function featureSetStringFieldValidationToNumber(object: FeatureSetStringFieldValidation): number;
+export declare function featureSetUtf8ValidationFromJSON(object: any): FeatureSetUtf8Validation;
+export declare function featureSetUtf8ValidationToJSON(object: FeatureSetUtf8Validation): string;
+export declare function featureSetUtf8ValidationToNumber(object: FeatureSetUtf8Validation): number;
 export declare enum FeatureSetMessageEncoding {
     MESSAGE_ENCODING_UNKNOWN = "MESSAGE_ENCODING_UNKNOWN",
     LENGTH_PREFIXED = "LENGTH_PREFIXED",
@@ -886,6 +953,38 @@ export declare enum FeatureSetJsonFormat {
 export declare function featureSetJsonFormatFromJSON(object: any): FeatureSetJsonFormat;
 export declare function featureSetJsonFormatToJSON(object: FeatureSetJsonFormat): string;
 export declare function featureSetJsonFormatToNumber(object: FeatureSetJsonFormat): number;
+/**
+ * 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: FeatureSetDefaultsFeatureSetEditionDefault[];
+    /**
+     * The minimum supported edition (inclusive) when this was constructed.
+     * Editions before this will not have defaults.
+     */
+    minimum_edition?: Edition | undefined;
+    /**
+     * The maximum known edition (inclusive) when this was constructed. Editions
+     * after this will not have reliable defaults.
+     */
+    maximum_edition?: Edition | 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 FeatureSetDefaultsFeatureSetEditionDefault {
+    edition?: Edition | undefined;
+    /** Defaults of features that can be overridden in this edition. */
+    overridable_features?: FeatureSet | undefined;
+    /** Defaults of features that can't be overridden in this edition. */
+    fixed_features?: FeatureSet | undefined;
+}
 /**
  * Encapsulates information about the original source file from which a
  * FileDescriptorProto was generated.
@@ -944,7 +1043,7 @@ export interface SourceCodeInfoLocation {
      * location.
      *
      * Each element is a field number or an index.  They form a path from
-     * the root FileDescriptorProto to the place where the definition occurs.
+     * the root FileDescriptorProto to the place where the definition appears.
      * For example, this path:
      *   [ 4, 3, 2, 7, 1 ]
      * refers to:
@@ -1022,8 +1121,8 @@ export interface SourceCodeInfoLocation {
      *
      *   // ignored detached comments.
      */
-    leading_comments: string;
-    trailing_comments: string;
+    leading_comments?: string | undefined;
+    trailing_comments?: string | undefined;
     leading_detached_comments: string[];
 }
 /**
@@ -1045,19 +1144,19 @@ export interface GeneratedCodeInfoAnnotation {
      */
     path: number[];
     /** Identifies the filesystem path to the original source .proto. */
-    source_file: string;
+    source_file?: string | undefined;
     /**
      * Identifies the starting offset in bytes in the generated code
      * that relates to the identified object.
      */
-    begin: number;
+    begin?: number | undefined;
     /**
      * 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).
      */
-    end: number;
-    semantic: GeneratedCodeInfoAnnotationSemantic;
+    end?: number | undefined;
+    semantic?: GeneratedCodeInfoAnnotationSemantic | undefined;
 }
 /**
  * Represents the identified object's effect on the element in the original
@@ -1218,6 +1317,14 @@ export declare const FieldOptionsEditionDefault: {
     create(base?: DeepPartial<FieldOptionsEditionDefault>): FieldOptionsEditionDefault;
     fromPartial(object: DeepPartial<FieldOptionsEditionDefault>): FieldOptionsEditionDefault;
 };
+export declare const FieldOptionsFeatureSupport: {
+    encode(message: FieldOptionsFeatureSupport, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): FieldOptionsFeatureSupport;
+    fromJSON(object: any): FieldOptionsFeatureSupport;
+    toJSON(message: FieldOptionsFeatureSupport): unknown;
+    create(base?: DeepPartial<FieldOptionsFeatureSupport>): FieldOptionsFeatureSupport;
+    fromPartial(object: DeepPartial<FieldOptionsFeatureSupport>): FieldOptionsFeatureSupport;
+};
 export declare const OneofOptions: {
     encode(message: OneofOptions, writer?: _m0.Writer): _m0.Writer;
     decode(input: _m0.Reader | Uint8Array, length?: number): OneofOptions;
@@ -1282,6 +1389,22 @@ export declare const FeatureSet: {
     create(base?: DeepPartial<FeatureSet>): FeatureSet;
     fromPartial(object: DeepPartial<FeatureSet>): FeatureSet;
 };
+export declare const FeatureSetDefaults: {
+    encode(message: FeatureSetDefaults, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | 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 FeatureSetDefaultsFeatureSetEditionDefault: {
+    encode(message: FeatureSetDefaultsFeatureSetEditionDefault, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): FeatureSetDefaultsFeatureSetEditionDefault;
+    fromJSON(object: any): FeatureSetDefaultsFeatureSetEditionDefault;
+    toJSON(message: FeatureSetDefaultsFeatureSetEditionDefault): unknown;
+    create(base?: DeepPartial<FeatureSetDefaultsFeatureSetEditionDefault>): FeatureSetDefaultsFeatureSetEditionDefault;
+    fromPartial(object: DeepPartial<FeatureSetDefaultsFeatureSetEditionDefault>): FeatureSetDefaultsFeatureSetEditionDefault;
+};
 export declare const SourceCodeInfo: {
     encode(message: SourceCodeInfo, writer?: _m0.Writer): _m0.Writer;
     decode(input: _m0.Reader | Uint8Array, length?: number): SourceCodeInfo;