@mochabug/adaptkit 1.0.0-rc.5 → 1.0.0-rc.51

package/bin/genproto/buf/validate/validate_pb.d.ts

@@ -1,15 +1,15 @@
-import type { GenEnum, GenExtension, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
-import type { Duration, DurationJson, FieldDescriptorProto_Type, FieldDescriptorProto_TypeJson, FieldOptions, MessageOptions, OneofOptions, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { GenEnum, GenExtension, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Duration, DurationJson, FieldDescriptorProto_Type, FieldDescriptorProto_TypeJson, FieldMask, FieldMaskJson, FieldOptions, MessageOptions, OneofOptions, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file buf/validate/validate.proto.
  */
 export declare const file_buf_validate_validate: GenFile;
 /**
- * `Constraint` represents a validation rule written in the Common Expression
- * Language (CEL) syntax. Each Constraint includes a unique identifier, an
+ * `Rule` represents a validation rule written in the Common Expression
+ * Language (CEL) syntax. Each Rule includes a unique identifier, an
  * optional error message, and the CEL expression to evaluate. For more
- * information on CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+ * information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
  *
  * ```proto
  * message Foo {
@@ -22,11 +22,11 @@ export declare const file_buf_validate_validate: GenFile;
  * }
  * ```
  *
- * @generated from message buf.validate.Constraint
+ * @generated from message buf.validate.Rule
  */
-export type Constraint = Message<"buf.validate.Constraint"> & {
+export type Rule = Message<"buf.validate.Rule"> & {
     /**
-     * `id` is a string that serves as a machine-readable name for this Constraint.
+     * `id` is a string that serves as a machine-readable name for this Rule.
      * It should be unique within its scope, which could be either a message or a field.
      *
      * @generated from field: optional string id = 1;
@@ -34,7 +34,7 @@ export type Constraint = Message<"buf.validate.Constraint"> & {
     id: string;
     /**
      * `message` is an optional field that provides a human-readable error message
-     * for this Constraint when the CEL expression evaluates to false. If a
+     * for this Rule when the CEL expression evaluates to false. If a
      * non-empty message is provided, any strings resulting from the CEL
      * expression evaluation are ignored.
      *
@@ -52,10 +52,10 @@ export type Constraint = Message<"buf.validate.Constraint"> & {
     expression: string;
 };
 /**
- * `Constraint` represents a validation rule written in the Common Expression
- * Language (CEL) syntax. Each Constraint includes a unique identifier, an
+ * `Rule` represents a validation rule written in the Common Expression
+ * Language (CEL) syntax. Each Rule includes a unique identifier, an
  * optional error message, and the CEL expression to evaluate. For more
- * information on CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+ * information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
  *
  * ```proto
  * message Foo {
@@ -68,11 +68,11 @@ export type Constraint = Message<"buf.validate.Constraint"> & {
  * }
  * ```
  *
- * @generated from message buf.validate.Constraint
+ * @generated from message buf.validate.Rule
  */
-export type ConstraintJson = {
+export type RuleJson = {
     /**
-     * `id` is a string that serves as a machine-readable name for this Constraint.
+     * `id` is a string that serves as a machine-readable name for this Rule.
      * It should be unique within its scope, which could be either a message or a field.
      *
      * @generated from field: optional string id = 1;
@@ -80,7 +80,7 @@ export type ConstraintJson = {
     id?: string;
     /**
      * `message` is an optional field that provides a human-readable error message
-     * for this Constraint when the CEL expression evaluates to false. If a
+     * for this Rule when the CEL expression evaluates to false. If a
      * non-empty message is provided, any strings resulting from the CEL
      * expression evaluation are ignored.
      *
@@ -98,35 +98,46 @@ export type ConstraintJson = {
     expression?: string;
 };
 /**
- * Describes the message buf.validate.Constraint.
- * Use `create(ConstraintSchema)` to create a new message.
+ * Describes the message buf.validate.Rule.
+ * Use `create(RuleSchema)` to create a new message.
  */
-export declare const ConstraintSchema: GenMessage<Constraint, ConstraintJson>;
+export declare const RuleSchema: GenMessage<Rule, {
+    jsonType: RuleJson;
+}>;
 /**
- * MessageConstraints represents validation rules that are applied to the entire message.
- * It includes disabling options and a list of Constraint messages representing Common Expression Language (CEL) validation rules.
+ * MessageRules represents validation rules that are applied to the entire message.
+ * It includes disabling options and a list of Rule messages representing Common Expression Language (CEL) validation rules.
  *
- * @generated from message buf.validate.MessageConstraints
+ * @generated from message buf.validate.MessageRules
  */
-export type MessageConstraints = Message<"buf.validate.MessageConstraints"> & {
+export type MessageRules = Message<"buf.validate.MessageRules"> & {
     /**
-     * `disabled` is a boolean flag that, when set to true, nullifies any validation rules for this message.
-     * This includes any fields within the message that would otherwise support validation.
+     * `cel_expression` is a repeated field CEL expressions. Each expression specifies a validation
+     * rule to be applied to this message. These rules are written in Common Expression Language (CEL) syntax.
+     *
+     * This is a simplified form of the `cel` Rule field, where only `expression` is set. This allows for
+     * simpler syntax when defining CEL Rules where `id` and `message` derived from the `expression`. `id` will
+     * be same as the `expression`.
+     *
+     * For more information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      * ```proto
      * message MyMessage {
-     *   // validation will be bypassed for this message
-     *   option (buf.validate.message).disabled = true;
+     *   // The field `foo` must be greater than 42.
+     *   option (buf.validate.message).cel_expression = "this.foo > 42";
+     *   // The field `foo` must be less than 84.
+     *   option (buf.validate.message).cel_expression = "this.foo < 84";
+     *   optional int32 foo = 1;
      * }
      * ```
      *
-     * @generated from field: optional bool disabled = 1;
+     * @generated from field: repeated string cel_expression = 5;
      */
-    disabled: boolean;
+    celExpression: string[];
     /**
-     * `cel` is a repeated field of type Constraint. Each Constraint specifies a validation rule to be applied to this message.
-     * These constraints are written in Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * `cel` is a repeated field of type Rule. Each Rule specifies a validation rule to be applied to this message.
+     * These rules are written in Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      *
      * ```proto
@@ -141,35 +152,83 @@ export type MessageConstraints = Message<"buf.validate.MessageConstraints"> & {
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 3;
+     * @generated from field: repeated buf.validate.Rule cel = 3;
      */
-    cel: Constraint[];
+    cel: Rule[];
+    /**
+     * `oneof` is a repeated field of type MessageOneofRule that specifies a list of fields
+     * of which at most one can be present. If `required` is also specified, then exactly one
+     * of the specified fields _must_ be present.
+     *
+     * This will enforce oneof-like constraints with a few features not provided by
+     * actual Protobuf oneof declarations:
+     *   1. Repeated and map fields are allowed in this validation. In a Protobuf oneof,
+     *      only scalar fields are allowed.
+     *   2. Fields with implicit presence are allowed. In a Protobuf oneof, all member
+     *      fields have explicit presence. This means that, for the purpose of determining
+     *      how many fields are set, explicitly setting such a field to its zero value is
+     *      effectively the same as not setting it at all.
+     *   3. This will always generate validation errors for a message unmarshalled from
+     *      serialized data that sets more than one field. With a Protobuf oneof, when
+     *      multiple fields are present in the serialized form, earlier values are usually
+     *      silently ignored when unmarshalling, with only the last field being set when
+     *      unmarshalling completes.
+     *
+     * Note that adding a field to a `oneof` will also set the IGNORE_IF_ZERO_VALUE on the fields. This means
+     * only the field that is set will be validated and the unset fields are not validated according to the field rules.
+     * This behavior can be overridden by setting `ignore` against a field.
+     *
+     * ```proto
+     * message MyMessage {
+     *   // Only one of `field1` or `field2` _can_ be present in this message.
+     *   option (buf.validate.message).oneof = { fields: ["field1", "field2"] };
+     *   // Exactly one of `field3` or `field4` _must_ be present in this message.
+     *   option (buf.validate.message).oneof = { fields: ["field3", "field4"], required: true };
+     *   string field1 = 1;
+     *   bytes field2 = 2;
+     *   bool field3 = 3;
+     *   int32 field4 = 4;
+     * }
+     * ```
+     *
+     * @generated from field: repeated buf.validate.MessageOneofRule oneof = 4;
+     */
+    oneof: MessageOneofRule[];
 };
 /**
- * MessageConstraints represents validation rules that are applied to the entire message.
- * It includes disabling options and a list of Constraint messages representing Common Expression Language (CEL) validation rules.
+ * MessageRules represents validation rules that are applied to the entire message.
+ * It includes disabling options and a list of Rule messages representing Common Expression Language (CEL) validation rules.
  *
- * @generated from message buf.validate.MessageConstraints
+ * @generated from message buf.validate.MessageRules
  */
-export type MessageConstraintsJson = {
+export type MessageRulesJson = {
     /**
-     * `disabled` is a boolean flag that, when set to true, nullifies any validation rules for this message.
-     * This includes any fields within the message that would otherwise support validation.
+     * `cel_expression` is a repeated field CEL expressions. Each expression specifies a validation
+     * rule to be applied to this message. These rules are written in Common Expression Language (CEL) syntax.
+     *
+     * This is a simplified form of the `cel` Rule field, where only `expression` is set. This allows for
+     * simpler syntax when defining CEL Rules where `id` and `message` derived from the `expression`. `id` will
+     * be same as the `expression`.
+     *
+     * For more information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      * ```proto
      * message MyMessage {
-     *   // validation will be bypassed for this message
-     *   option (buf.validate.message).disabled = true;
+     *   // The field `foo` must be greater than 42.
+     *   option (buf.validate.message).cel_expression = "this.foo > 42";
+     *   // The field `foo` must be less than 84.
+     *   option (buf.validate.message).cel_expression = "this.foo < 84";
+     *   optional int32 foo = 1;
      * }
      * ```
      *
-     * @generated from field: optional bool disabled = 1;
+     * @generated from field: repeated string cel_expression = 5;
      */
-    disabled?: boolean;
+    celExpression?: string[];
     /**
-     * `cel` is a repeated field of type Constraint. Each Constraint specifies a validation rule to be applied to this message.
-     * These constraints are written in Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * `cel` is a repeated field of type Rule. Each Rule specifies a validation rule to be applied to this message.
+     * These rules are written in Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      *
      * ```proto
@@ -184,26 +243,111 @@ export type MessageConstraintsJson = {
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 3;
+     * @generated from field: repeated buf.validate.Rule cel = 3;
      */
-    cel?: ConstraintJson[];
+    cel?: RuleJson[];
+    /**
+     * `oneof` is a repeated field of type MessageOneofRule that specifies a list of fields
+     * of which at most one can be present. If `required` is also specified, then exactly one
+     * of the specified fields _must_ be present.
+     *
+     * This will enforce oneof-like constraints with a few features not provided by
+     * actual Protobuf oneof declarations:
+     *   1. Repeated and map fields are allowed in this validation. In a Protobuf oneof,
+     *      only scalar fields are allowed.
+     *   2. Fields with implicit presence are allowed. In a Protobuf oneof, all member
+     *      fields have explicit presence. This means that, for the purpose of determining
+     *      how many fields are set, explicitly setting such a field to its zero value is
+     *      effectively the same as not setting it at all.
+     *   3. This will always generate validation errors for a message unmarshalled from
+     *      serialized data that sets more than one field. With a Protobuf oneof, when
+     *      multiple fields are present in the serialized form, earlier values are usually
+     *      silently ignored when unmarshalling, with only the last field being set when
+     *      unmarshalling completes.
+     *
+     * Note that adding a field to a `oneof` will also set the IGNORE_IF_ZERO_VALUE on the fields. This means
+     * only the field that is set will be validated and the unset fields are not validated according to the field rules.
+     * This behavior can be overridden by setting `ignore` against a field.
+     *
+     * ```proto
+     * message MyMessage {
+     *   // Only one of `field1` or `field2` _can_ be present in this message.
+     *   option (buf.validate.message).oneof = { fields: ["field1", "field2"] };
+     *   // Exactly one of `field3` or `field4` _must_ be present in this message.
+     *   option (buf.validate.message).oneof = { fields: ["field3", "field4"], required: true };
+     *   string field1 = 1;
+     *   bytes field2 = 2;
+     *   bool field3 = 3;
+     *   int32 field4 = 4;
+     * }
+     * ```
+     *
+     * @generated from field: repeated buf.validate.MessageOneofRule oneof = 4;
+     */
+    oneof?: MessageOneofRuleJson[];
+};
+/**
+ * Describes the message buf.validate.MessageRules.
+ * Use `create(MessageRulesSchema)` to create a new message.
+ */
+export declare const MessageRulesSchema: GenMessage<MessageRules, {
+    jsonType: MessageRulesJson;
+}>;
+/**
+ * @generated from message buf.validate.MessageOneofRule
+ */
+export type MessageOneofRule = Message<"buf.validate.MessageOneofRule"> & {
+    /**
+     * A list of field names to include in the oneof. All field names must be
+     * defined in the message. At least one field must be specified, and
+     * duplicates are not permitted.
+     *
+     * @generated from field: repeated string fields = 1;
+     */
+    fields: string[];
+    /**
+     * If true, one of the fields specified _must_ be set.
+     *
+     * @generated from field: optional bool required = 2;
+     */
+    required: boolean;
 };
 /**
- * Describes the message buf.validate.MessageConstraints.
- * Use `create(MessageConstraintsSchema)` to create a new message.
+ * @generated from message buf.validate.MessageOneofRule
  */
-export declare const MessageConstraintsSchema: GenMessage<MessageConstraints, MessageConstraintsJson>;
+export type MessageOneofRuleJson = {
+    /**
+     * A list of field names to include in the oneof. All field names must be
+     * defined in the message. At least one field must be specified, and
+     * duplicates are not permitted.
+     *
+     * @generated from field: repeated string fields = 1;
+     */
+    fields?: string[];
+    /**
+     * If true, one of the fields specified _must_ be set.
+     *
+     * @generated from field: optional bool required = 2;
+     */
+    required?: boolean;
+};
 /**
- * The `OneofConstraints` message type enables you to manage constraints for
+ * Describes the message buf.validate.MessageOneofRule.
+ * Use `create(MessageOneofRuleSchema)` to create a new message.
+ */
+export declare const MessageOneofRuleSchema: GenMessage<MessageOneofRule, {
+    jsonType: MessageOneofRuleJson;
+}>;
+/**
+ * The `OneofRules` message type enables you to manage rules for
  * oneof fields in your protobuf messages.
  *
- * @generated from message buf.validate.OneofConstraints
+ * @generated from message buf.validate.OneofRules
  */
-export type OneofConstraints = Message<"buf.validate.OneofConstraints"> & {
+export type OneofRules = Message<"buf.validate.OneofRules"> & {
     /**
-     * If `required` is true, exactly one field of the oneof must be present. A
-     * validation error is returned if no fields in the oneof are present. The
-     * field itself may still be a default value; further constraints
+     * If `required` is true, exactly one field of the oneof must be set. A
+     * validation error is returned if no fields in the oneof are set. Further rules
      * should be placed on the fields themselves to ensure they are valid values,
      * such as `min_len` or `gt`.
      *
@@ -224,16 +368,15 @@ export type OneofConstraints = Message<"buf.validate.OneofConstraints"> & {
     required: boolean;
 };
 /**
- * The `OneofConstraints` message type enables you to manage constraints for
+ * The `OneofRules` message type enables you to manage rules for
  * oneof fields in your protobuf messages.
  *
- * @generated from message buf.validate.OneofConstraints
+ * @generated from message buf.validate.OneofRules
  */
-export type OneofConstraintsJson = {
+export type OneofRulesJson = {
     /**
-     * If `required` is true, exactly one field of the oneof must be present. A
-     * validation error is returned if no fields in the oneof are present. The
-     * field itself may still be a default value; further constraints
+     * If `required` is true, exactly one field of the oneof must be set. A
+     * validation error is returned if no fields in the oneof are set. Further rules
      * should be placed on the fields themselves to ensure they are valid values,
      * such as `min_len` or `gt`.
      *
@@ -254,21 +397,43 @@ export type OneofConstraintsJson = {
     required?: boolean;
 };
 /**
- * Describes the message buf.validate.OneofConstraints.
- * Use `create(OneofConstraintsSchema)` to create a new message.
+ * Describes the message buf.validate.OneofRules.
+ * Use `create(OneofRulesSchema)` to create a new message.
  */
-export declare const OneofConstraintsSchema: GenMessage<OneofConstraints, OneofConstraintsJson>;
+export declare const OneofRulesSchema: GenMessage<OneofRules, {
+    jsonType: OneofRulesJson;
+}>;
 /**
- * FieldConstraints encapsulates the rules for each type of field. Depending on
+ * FieldRules encapsulates the rules for each type of field. Depending on
  * the field, the correct set should be used to ensure proper validations.
  *
- * @generated from message buf.validate.FieldConstraints
+ * @generated from message buf.validate.FieldRules
  */
-export type FieldConstraints = Message<"buf.validate.FieldConstraints"> & {
+export type FieldRules = Message<"buf.validate.FieldRules"> & {
+    /**
+     * `cel_expression` is a repeated field CEL expressions. Each expression specifies a validation
+     * rule to be applied to this message. These rules are written in Common Expression Language (CEL) syntax.
+     *
+     * This is a simplified form of the `cel` Rule field, where only `expression` is set. This allows for
+     * simpler syntax when defining CEL Rules where `id` and `message` derived from the `expression`. `id` will
+     * be same as the `expression`.
+     *
+     * For more information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
+     *
+     * ```proto
+     * message MyMessage {
+     *   // The field `value` must be greater than 42.
+     *   optional int32 value = 1 [(buf.validate.field).cel_expression = "this > 42"];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string cel_expression = 29;
+     */
+    celExpression: string[];
     /**
      * `cel` is a repeated field used to represent a textual expression
-     * in the Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * in the Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      * ```proto
      * message MyMessage {
@@ -281,42 +446,80 @@ export type FieldConstraints = Message<"buf.validate.FieldConstraints"> & {
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 23;
+     * @generated from field: repeated buf.validate.Rule cel = 23;
      */
-    cel: Constraint[];
+    cel: Rule[];
     /**
-     * If `required` is true, the field must be populated. A populated field can be
-     * described as "serialized in the wire format," which includes:
+     * If `required` is true, the field must be set. A validation error is returned
+     * if the field is not set.
      *
-     * - the following "nullable" fields must be explicitly set to be considered populated:
-     *   - singular message fields (whose fields may be unpopulated/default values)
-     *   - member fields of a oneof (may be their default value)
-     *   - proto3 optional fields (may be their default value)
-     *   - proto2 scalar fields (both optional and required)
-     * - proto3 scalar fields must be non-zero to be considered populated
-     * - repeated and map fields must be non-empty to be considered populated
+     * ```proto
+     * syntax="proto3";
+     *
+     * message FieldsWithPresence {
+     *   // Requires any string to be set, including the empty string.
+     *   optional string link = 1 [
+     *     (buf.validate.field).required = true
+     *   ];
+     *   // Requires true or false to be set.
+     *   optional bool disabled = 2 [
+     *     (buf.validate.field).required = true
+     *   ];
+     *   // Requires a message to be set, including the empty message.
+     *   SomeMessage msg = 4 [
+     *     (buf.validate.field).required = true
+     *   ];
+     * }
+     * ```
+     *
+     * All fields in the example above track presence. By default, Protovalidate
+     * ignores rules on those fields if no value is set. `required` ensures that
+     * the fields are set and valid.
+     *
+     * Fields that don't track presence are always validated by Protovalidate,
+     * whether they are set or not. It is not necessary to add `required`. It
+     * can be added to indicate that the field cannot be the zero value.
      *
      * ```proto
-     * message MyMessage {
-     *   // The field `value` must be set to a non-null value.
-     *   optional MyOtherMessage value = 1 [(buf.validate.field).required = true];
+     * syntax="proto3";
+     *
+     * message FieldsWithoutPresence {
+     *   // `string.email` always applies, even to an empty string.
+     *   string link = 1 [
+     *     (buf.validate.field).string.email = true
+     *   ];
+     *   // `repeated.min_items` always applies, even to an empty list.
+     *   repeated string labels = 2 [
+     *     (buf.validate.field).repeated.min_items = 1
+     *   ];
+     *   // `required`, for fields that don't track presence, indicates
+     *   // the value of the field can't be the zero value.
+     *   int32 zero_value_not_allowed = 3 [
+     *     (buf.validate.field).required = true
+     *   ];
      * }
      * ```
      *
+     * To learn which fields track presence, see the
+     * [Field Presence cheat sheet](https://protobuf.dev/programming-guides/field_presence/#cheat).
+     *
+     * Note: While field rules can be applied to repeated items, map keys, and map
+     * values, the elements are always considered to be set. Consequently,
+     * specifying `repeated.items.required` is redundant.
+     *
      * @generated from field: optional bool required = 25;
      */
     required: boolean;
     /**
-     * Skip validation on the field if its value matches the specified criteria.
-     * See Ignore enum for details.
+     * Ignore validation rules on the field if its value matches the specified
+     * criteria. See the `Ignore` enum for details.
      *
      * ```proto
      * message UpdateRequest {
-     *   // The uri rule only applies if the field is populated and not an empty
-     *   // string.
-     *   optional string url = 1 [
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE,
-     *     (buf.validate.field).string.uri = true,
+     *   // The uri rule only applies if the field is not an empty string.
+     *   string url = 1 [
+     *     (buf.validate.field).ignore = IGNORE_IF_ZERO_VALUE,
+     *     (buf.validate.field).string.uri = true
      *   ];
      * }
      * ```
@@ -325,7 +528,7 @@ export type FieldConstraints = Message<"buf.validate.FieldConstraints"> & {
      */
     ignore: Ignore;
     /**
-     * @generated from oneof buf.validate.FieldConstraints.type
+     * @generated from oneof buf.validate.FieldRules.type
      */
     type: {
         /**
@@ -453,6 +656,12 @@ export type FieldConstraints = Message<"buf.validate.FieldConstraints"> & {
          */
         value: DurationRules;
         case: "duration";
+    } | {
+        /**
+         * @generated from field: buf.validate.FieldMaskRules field_mask = 28;
+         */
+        value: FieldMaskRules;
+        case: "fieldMask";
     } | {
         /**
          * @generated from field: buf.validate.TimestampRules timestamp = 22;
@@ -465,16 +674,36 @@ export type FieldConstraints = Message<"buf.validate.FieldConstraints"> & {
     };
 };
 /**
- * FieldConstraints encapsulates the rules for each type of field. Depending on
+ * FieldRules encapsulates the rules for each type of field. Depending on
  * the field, the correct set should be used to ensure proper validations.
  *
- * @generated from message buf.validate.FieldConstraints
+ * @generated from message buf.validate.FieldRules
  */
-export type FieldConstraintsJson = {
+export type FieldRulesJson = {
+    /**
+     * `cel_expression` is a repeated field CEL expressions. Each expression specifies a validation
+     * rule to be applied to this message. These rules are written in Common Expression Language (CEL) syntax.
+     *
+     * This is a simplified form of the `cel` Rule field, where only `expression` is set. This allows for
+     * simpler syntax when defining CEL Rules where `id` and `message` derived from the `expression`. `id` will
+     * be same as the `expression`.
+     *
+     * For more information, [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
+     *
+     * ```proto
+     * message MyMessage {
+     *   // The field `value` must be greater than 42.
+     *   optional int32 value = 1 [(buf.validate.field).cel_expression = "this > 42"];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string cel_expression = 29;
+     */
+    celExpression?: string[];
     /**
      * `cel` is a repeated field used to represent a textual expression
-     * in the Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * in the Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/custom-rules/).
      *
      * ```proto
      * message MyMessage {
@@ -487,42 +716,80 @@ export type FieldConstraintsJson = {
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 23;
+     * @generated from field: repeated buf.validate.Rule cel = 23;
      */
-    cel?: ConstraintJson[];
+    cel?: RuleJson[];
     /**
-     * If `required` is true, the field must be populated. A populated field can be
-     * described as "serialized in the wire format," which includes:
+     * If `required` is true, the field must be set. A validation error is returned
+     * if the field is not set.
+     *
+     * ```proto
+     * syntax="proto3";
      *
-     * - the following "nullable" fields must be explicitly set to be considered populated:
-     *   - singular message fields (whose fields may be unpopulated/default values)
-     *   - member fields of a oneof (may be their default value)
-     *   - proto3 optional fields (may be their default value)
-     *   - proto2 scalar fields (both optional and required)
-     * - proto3 scalar fields must be non-zero to be considered populated
-     * - repeated and map fields must be non-empty to be considered populated
+     * message FieldsWithPresence {
+     *   // Requires any string to be set, including the empty string.
+     *   optional string link = 1 [
+     *     (buf.validate.field).required = true
+     *   ];
+     *   // Requires true or false to be set.
+     *   optional bool disabled = 2 [
+     *     (buf.validate.field).required = true
+     *   ];
+     *   // Requires a message to be set, including the empty message.
+     *   SomeMessage msg = 4 [
+     *     (buf.validate.field).required = true
+     *   ];
+     * }
+     * ```
+     *
+     * All fields in the example above track presence. By default, Protovalidate
+     * ignores rules on those fields if no value is set. `required` ensures that
+     * the fields are set and valid.
+     *
+     * Fields that don't track presence are always validated by Protovalidate,
+     * whether they are set or not. It is not necessary to add `required`. It
+     * can be added to indicate that the field cannot be the zero value.
      *
      * ```proto
-     * message MyMessage {
-     *   // The field `value` must be set to a non-null value.
-     *   optional MyOtherMessage value = 1 [(buf.validate.field).required = true];
+     * syntax="proto3";
+     *
+     * message FieldsWithoutPresence {
+     *   // `string.email` always applies, even to an empty string.
+     *   string link = 1 [
+     *     (buf.validate.field).string.email = true
+     *   ];
+     *   // `repeated.min_items` always applies, even to an empty list.
+     *   repeated string labels = 2 [
+     *     (buf.validate.field).repeated.min_items = 1
+     *   ];
+     *   // `required`, for fields that don't track presence, indicates
+     *   // the value of the field can't be the zero value.
+     *   int32 zero_value_not_allowed = 3 [
+     *     (buf.validate.field).required = true
+     *   ];
      * }
      * ```
      *
+     * To learn which fields track presence, see the
+     * [Field Presence cheat sheet](https://protobuf.dev/programming-guides/field_presence/#cheat).
+     *
+     * Note: While field rules can be applied to repeated items, map keys, and map
+     * values, the elements are always considered to be set. Consequently,
+     * specifying `repeated.items.required` is redundant.
+     *
      * @generated from field: optional bool required = 25;
      */
     required?: boolean;
     /**
-     * Skip validation on the field if its value matches the specified criteria.
-     * See Ignore enum for details.
+     * Ignore validation rules on the field if its value matches the specified
+     * criteria. See the `Ignore` enum for details.
      *
      * ```proto
      * message UpdateRequest {
-     *   // The uri rule only applies if the field is populated and not an empty
-     *   // string.
-     *   optional string url = 1 [
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE,
-     *     (buf.validate.field).string.uri = true,
+     *   // The uri rule only applies if the field is not an empty string.
+     *   string url = 1 [
+     *     (buf.validate.field).ignore = IGNORE_IF_ZERO_VALUE,
+     *     (buf.validate.field).string.uri = true
      *   ];
      * }
      * ```
@@ -616,27 +883,33 @@ export type FieldConstraintsJson = {
      * @generated from field: buf.validate.DurationRules duration = 21;
      */
     duration?: DurationRulesJson;
+    /**
+     * @generated from field: buf.validate.FieldMaskRules field_mask = 28;
+     */
+    fieldMask?: FieldMaskRulesJson;
     /**
      * @generated from field: buf.validate.TimestampRules timestamp = 22;
      */
     timestamp?: TimestampRulesJson;
 };
 /**
- * Describes the message buf.validate.FieldConstraints.
- * Use `create(FieldConstraintsSchema)` to create a new message.
+ * Describes the message buf.validate.FieldRules.
+ * Use `create(FieldRulesSchema)` to create a new message.
  */
-export declare const FieldConstraintsSchema: GenMessage<FieldConstraints, FieldConstraintsJson>;
+export declare const FieldRulesSchema: GenMessage<FieldRules, {
+    jsonType: FieldRulesJson;
+}>;
 /**
- * PredefinedConstraints are custom constraints that can be re-used with
+ * PredefinedRules are custom rules that can be re-used with
  * multiple fields.
  *
- * @generated from message buf.validate.PredefinedConstraints
+ * @generated from message buf.validate.PredefinedRules
  */
-export type PredefinedConstraints = Message<"buf.validate.PredefinedConstraints"> & {
+export type PredefinedRules = Message<"buf.validate.PredefinedRules"> & {
     /**
      * `cel` is a repeated field used to represent a textual expression
-     * in the Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * in the Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/predefined-rules/).
      *
      * ```proto
      * message MyMessage {
@@ -649,21 +922,21 @@ export type PredefinedConstraints = Message<"buf.validate.PredefinedConstraints"
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 1;
+     * @generated from field: repeated buf.validate.Rule cel = 1;
      */
-    cel: Constraint[];
+    cel: Rule[];
 };
 /**
- * PredefinedConstraints are custom constraints that can be re-used with
+ * PredefinedRules are custom rules that can be re-used with
  * multiple fields.
  *
- * @generated from message buf.validate.PredefinedConstraints
+ * @generated from message buf.validate.PredefinedRules
  */
-export type PredefinedConstraintsJson = {
+export type PredefinedRulesJson = {
     /**
      * `cel` is a repeated field used to represent a textual expression
-     * in the Common Expression Language (CEL) syntax. For more information on
-     * CEL, [see our documentation](https://github.com/bufbuild/protovalidate/blob/main/docs/cel.md).
+     * in the Common Expression Language (CEL) syntax. For more information,
+     * [see our documentation](https://buf.build/docs/protovalidate/schemas/predefined-rules/).
      *
      * ```proto
      * message MyMessage {
@@ -676,17 +949,19 @@ export type PredefinedConstraintsJson = {
      * }
      * ```
      *
-     * @generated from field: repeated buf.validate.Constraint cel = 1;
+     * @generated from field: repeated buf.validate.Rule cel = 1;
      */
-    cel?: ConstraintJson[];
+    cel?: RuleJson[];
 };
 /**
- * Describes the message buf.validate.PredefinedConstraints.
- * Use `create(PredefinedConstraintsSchema)` to create a new message.
+ * Describes the message buf.validate.PredefinedRules.
+ * Use `create(PredefinedRulesSchema)` to create a new message.
  */
-export declare const PredefinedConstraintsSchema: GenMessage<PredefinedConstraints, PredefinedConstraintsJson>;
+export declare const PredefinedRulesSchema: GenMessage<PredefinedRules, {
+    jsonType: PredefinedRulesJson;
+}>;
 /**
- * FloatRules describes the constraints applied to `float` values. These
+ * FloatRules describes the rules applied to `float` values. These
  * rules may also be applied to the `google.protobuf.FloatValue` Well-Known-Type.
  *
  * @generated from message buf.validate.FloatRules
@@ -843,14 +1118,14 @@ export type FloatRules = Message<"buf.validate.FloatRules"> & {
     finite: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
      * message MyFloat {
      *   float value = 1 [
      *     (buf.validate.field).float.example = 1.0,
-     *     (buf.validate.field).float.example = "Infinity"
+     *     (buf.validate.field).float.example = inf
      *   ];
      * }
      * ```
@@ -860,7 +1135,7 @@ export type FloatRules = Message<"buf.validate.FloatRules"> & {
     example: number[];
 };
 /**
- * FloatRules describes the constraints applied to `float` values. These
+ * FloatRules describes the rules applied to `float` values. These
  * rules may also be applied to the `google.protobuf.FloatValue` Well-Known-Type.
  *
  * @generated from message buf.validate.FloatRules
@@ -995,14 +1270,14 @@ export type FloatRulesJson = {
     finite?: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
      * message MyFloat {
      *   float value = 1 [
      *     (buf.validate.field).float.example = 1.0,
-     *     (buf.validate.field).float.example = "Infinity"
+     *     (buf.validate.field).float.example = inf
      *   ];
      * }
      * ```
@@ -1015,9 +1290,11 @@ export type FloatRulesJson = {
  * Describes the message buf.validate.FloatRules.
  * Use `create(FloatRulesSchema)` to create a new message.
  */
-export declare const FloatRulesSchema: GenMessage<FloatRules, FloatRulesJson>;
+export declare const FloatRulesSchema: GenMessage<FloatRules, {
+    jsonType: FloatRulesJson;
+}>;
 /**
- * DoubleRules describes the constraints applied to `double` values. These
+ * DoubleRules describes the rules applied to `double` values. These
  * rules may also be applied to the `google.protobuf.DoubleValue` Well-Known-Type.
  *
  * @generated from message buf.validate.DoubleRules
@@ -1174,14 +1451,14 @@ export type DoubleRules = Message<"buf.validate.DoubleRules"> & {
     finite: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
      * message MyDouble {
      *   double value = 1 [
      *     (buf.validate.field).double.example = 1.0,
-     *     (buf.validate.field).double.example = "Infinity"
+     *     (buf.validate.field).double.example = inf
      *   ];
      * }
      * ```
@@ -1191,7 +1468,7 @@ export type DoubleRules = Message<"buf.validate.DoubleRules"> & {
     example: number[];
 };
 /**
- * DoubleRules describes the constraints applied to `double` values. These
+ * DoubleRules describes the rules applied to `double` values. These
  * rules may also be applied to the `google.protobuf.DoubleValue` Well-Known-Type.
  *
  * @generated from message buf.validate.DoubleRules
@@ -1326,14 +1603,14 @@ export type DoubleRulesJson = {
     finite?: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
      * message MyDouble {
      *   double value = 1 [
      *     (buf.validate.field).double.example = 1.0,
-     *     (buf.validate.field).double.example = "Infinity"
+     *     (buf.validate.field).double.example = inf
      *   ];
      * }
      * ```
@@ -1346,9 +1623,11 @@ export type DoubleRulesJson = {
  * Describes the message buf.validate.DoubleRules.
  * Use `create(DoubleRulesSchema)` to create a new message.
  */
-export declare const DoubleRulesSchema: GenMessage<DoubleRules, DoubleRulesJson>;
+export declare const DoubleRulesSchema: GenMessage<DoubleRules, {
+    jsonType: DoubleRulesJson;
+}>;
 /**
- * Int32Rules describes the constraints applied to `int32` values. These
+ * Int32Rules describes the rules applied to `int32` values. These
  * rules may also be applied to the `google.protobuf.Int32Value` Well-Known-Type.
  *
  * @generated from message buf.validate.Int32Rules
@@ -1498,7 +1777,7 @@ export type Int32Rules = Message<"buf.validate.Int32Rules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -1515,7 +1794,7 @@ export type Int32Rules = Message<"buf.validate.Int32Rules"> & {
     example: number[];
 };
 /**
- * Int32Rules describes the constraints applied to `int32` values. These
+ * Int32Rules describes the rules applied to `int32` values. These
  * rules may also be applied to the `google.protobuf.Int32Value` Well-Known-Type.
  *
  * @generated from message buf.validate.Int32Rules
@@ -1643,7 +1922,7 @@ export type Int32RulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -1663,9 +1942,11 @@ export type Int32RulesJson = {
  * Describes the message buf.validate.Int32Rules.
  * Use `create(Int32RulesSchema)` to create a new message.
  */
-export declare const Int32RulesSchema: GenMessage<Int32Rules, Int32RulesJson>;
+export declare const Int32RulesSchema: GenMessage<Int32Rules, {
+    jsonType: Int32RulesJson;
+}>;
 /**
- * Int64Rules describes the constraints applied to `int64` values. These
+ * Int64Rules describes the rules applied to `int64` values. These
  * rules may also be applied to the `google.protobuf.Int64Value` Well-Known-Type.
  *
  * @generated from message buf.validate.Int64Rules
@@ -1815,7 +2096,7 @@ export type Int64Rules = Message<"buf.validate.Int64Rules"> & {
     notIn: bigint[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -1832,7 +2113,7 @@ export type Int64Rules = Message<"buf.validate.Int64Rules"> & {
     example: bigint[];
 };
 /**
- * Int64Rules describes the constraints applied to `int64` values. These
+ * Int64Rules describes the rules applied to `int64` values. These
  * rules may also be applied to the `google.protobuf.Int64Value` Well-Known-Type.
  *
  * @generated from message buf.validate.Int64Rules
@@ -1960,7 +2241,7 @@ export type Int64RulesJson = {
     notIn?: string[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -1980,9 +2261,11 @@ export type Int64RulesJson = {
  * Describes the message buf.validate.Int64Rules.
  * Use `create(Int64RulesSchema)` to create a new message.
  */
-export declare const Int64RulesSchema: GenMessage<Int64Rules, Int64RulesJson>;
+export declare const Int64RulesSchema: GenMessage<Int64Rules, {
+    jsonType: Int64RulesJson;
+}>;
 /**
- * UInt32Rules describes the constraints applied to `uint32` values. These
+ * UInt32Rules describes the rules applied to `uint32` values. These
  * rules may also be applied to the `google.protobuf.UInt32Value` Well-Known-Type.
  *
  * @generated from message buf.validate.UInt32Rules
@@ -2132,7 +2415,7 @@ export type UInt32Rules = Message<"buf.validate.UInt32Rules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2149,7 +2432,7 @@ export type UInt32Rules = Message<"buf.validate.UInt32Rules"> & {
     example: number[];
 };
 /**
- * UInt32Rules describes the constraints applied to `uint32` values. These
+ * UInt32Rules describes the rules applied to `uint32` values. These
  * rules may also be applied to the `google.protobuf.UInt32Value` Well-Known-Type.
  *
  * @generated from message buf.validate.UInt32Rules
@@ -2277,7 +2560,7 @@ export type UInt32RulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2297,9 +2580,11 @@ export type UInt32RulesJson = {
  * Describes the message buf.validate.UInt32Rules.
  * Use `create(UInt32RulesSchema)` to create a new message.
  */
-export declare const UInt32RulesSchema: GenMessage<UInt32Rules, UInt32RulesJson>;
+export declare const UInt32RulesSchema: GenMessage<UInt32Rules, {
+    jsonType: UInt32RulesJson;
+}>;
 /**
- * UInt64Rules describes the constraints applied to `uint64` values. These
+ * UInt64Rules describes the rules applied to `uint64` values. These
  * rules may also be applied to the `google.protobuf.UInt64Value` Well-Known-Type.
  *
  * @generated from message buf.validate.UInt64Rules
@@ -2449,7 +2734,7 @@ export type UInt64Rules = Message<"buf.validate.UInt64Rules"> & {
     notIn: bigint[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2466,7 +2751,7 @@ export type UInt64Rules = Message<"buf.validate.UInt64Rules"> & {
     example: bigint[];
 };
 /**
- * UInt64Rules describes the constraints applied to `uint64` values. These
+ * UInt64Rules describes the rules applied to `uint64` values. These
  * rules may also be applied to the `google.protobuf.UInt64Value` Well-Known-Type.
  *
  * @generated from message buf.validate.UInt64Rules
@@ -2594,7 +2879,7 @@ export type UInt64RulesJson = {
     notIn?: string[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2614,9 +2899,11 @@ export type UInt64RulesJson = {
  * Describes the message buf.validate.UInt64Rules.
  * Use `create(UInt64RulesSchema)` to create a new message.
  */
-export declare const UInt64RulesSchema: GenMessage<UInt64Rules, UInt64RulesJson>;
+export declare const UInt64RulesSchema: GenMessage<UInt64Rules, {
+    jsonType: UInt64RulesJson;
+}>;
 /**
- * SInt32Rules describes the constraints applied to `sint32` values.
+ * SInt32Rules describes the rules applied to `sint32` values.
  *
  * @generated from message buf.validate.SInt32Rules
  */
@@ -2765,7 +3052,7 @@ export type SInt32Rules = Message<"buf.validate.SInt32Rules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2782,7 +3069,7 @@ export type SInt32Rules = Message<"buf.validate.SInt32Rules"> & {
     example: number[];
 };
 /**
- * SInt32Rules describes the constraints applied to `sint32` values.
+ * SInt32Rules describes the rules applied to `sint32` values.
  *
  * @generated from message buf.validate.SInt32Rules
  */
@@ -2909,7 +3196,7 @@ export type SInt32RulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -2929,9 +3216,11 @@ export type SInt32RulesJson = {
  * Describes the message buf.validate.SInt32Rules.
  * Use `create(SInt32RulesSchema)` to create a new message.
  */
-export declare const SInt32RulesSchema: GenMessage<SInt32Rules, SInt32RulesJson>;
+export declare const SInt32RulesSchema: GenMessage<SInt32Rules, {
+    jsonType: SInt32RulesJson;
+}>;
 /**
- * SInt64Rules describes the constraints applied to `sint64` values.
+ * SInt64Rules describes the rules applied to `sint64` values.
  *
  * @generated from message buf.validate.SInt64Rules
  */
@@ -3080,7 +3369,7 @@ export type SInt64Rules = Message<"buf.validate.SInt64Rules"> & {
     notIn: bigint[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3097,7 +3386,7 @@ export type SInt64Rules = Message<"buf.validate.SInt64Rules"> & {
     example: bigint[];
 };
 /**
- * SInt64Rules describes the constraints applied to `sint64` values.
+ * SInt64Rules describes the rules applied to `sint64` values.
  *
  * @generated from message buf.validate.SInt64Rules
  */
@@ -3224,7 +3513,7 @@ export type SInt64RulesJson = {
     notIn?: string[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3244,9 +3533,11 @@ export type SInt64RulesJson = {
  * Describes the message buf.validate.SInt64Rules.
  * Use `create(SInt64RulesSchema)` to create a new message.
  */
-export declare const SInt64RulesSchema: GenMessage<SInt64Rules, SInt64RulesJson>;
+export declare const SInt64RulesSchema: GenMessage<SInt64Rules, {
+    jsonType: SInt64RulesJson;
+}>;
 /**
- * Fixed32Rules describes the constraints applied to `fixed32` values.
+ * Fixed32Rules describes the rules applied to `fixed32` values.
  *
  * @generated from message buf.validate.Fixed32Rules
  */
@@ -3395,7 +3686,7 @@ export type Fixed32Rules = Message<"buf.validate.Fixed32Rules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3412,7 +3703,7 @@ export type Fixed32Rules = Message<"buf.validate.Fixed32Rules"> & {
     example: number[];
 };
 /**
- * Fixed32Rules describes the constraints applied to `fixed32` values.
+ * Fixed32Rules describes the rules applied to `fixed32` values.
  *
  * @generated from message buf.validate.Fixed32Rules
  */
@@ -3539,7 +3830,7 @@ export type Fixed32RulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3559,9 +3850,11 @@ export type Fixed32RulesJson = {
  * Describes the message buf.validate.Fixed32Rules.
  * Use `create(Fixed32RulesSchema)` to create a new message.
  */
-export declare const Fixed32RulesSchema: GenMessage<Fixed32Rules, Fixed32RulesJson>;
+export declare const Fixed32RulesSchema: GenMessage<Fixed32Rules, {
+    jsonType: Fixed32RulesJson;
+}>;
 /**
- * Fixed64Rules describes the constraints applied to `fixed64` values.
+ * Fixed64Rules describes the rules applied to `fixed64` values.
  *
  * @generated from message buf.validate.Fixed64Rules
  */
@@ -3710,7 +4003,7 @@ export type Fixed64Rules = Message<"buf.validate.Fixed64Rules"> & {
     notIn: bigint[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3727,7 +4020,7 @@ export type Fixed64Rules = Message<"buf.validate.Fixed64Rules"> & {
     example: bigint[];
 };
 /**
- * Fixed64Rules describes the constraints applied to `fixed64` values.
+ * Fixed64Rules describes the rules applied to `fixed64` values.
  *
  * @generated from message buf.validate.Fixed64Rules
  */
@@ -3854,7 +4147,7 @@ export type Fixed64RulesJson = {
     notIn?: string[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -3874,9 +4167,11 @@ export type Fixed64RulesJson = {
  * Describes the message buf.validate.Fixed64Rules.
  * Use `create(Fixed64RulesSchema)` to create a new message.
  */
-export declare const Fixed64RulesSchema: GenMessage<Fixed64Rules, Fixed64RulesJson>;
+export declare const Fixed64RulesSchema: GenMessage<Fixed64Rules, {
+    jsonType: Fixed64RulesJson;
+}>;
 /**
- * SFixed32Rules describes the constraints applied to `fixed32` values.
+ * SFixed32Rules describes the rules applied to `fixed32` values.
  *
  * @generated from message buf.validate.SFixed32Rules
  */
@@ -4025,7 +4320,7 @@ export type SFixed32Rules = Message<"buf.validate.SFixed32Rules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4042,7 +4337,7 @@ export type SFixed32Rules = Message<"buf.validate.SFixed32Rules"> & {
     example: number[];
 };
 /**
- * SFixed32Rules describes the constraints applied to `fixed32` values.
+ * SFixed32Rules describes the rules applied to `fixed32` values.
  *
  * @generated from message buf.validate.SFixed32Rules
  */
@@ -4169,7 +4464,7 @@ export type SFixed32RulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4189,9 +4484,11 @@ export type SFixed32RulesJson = {
  * Describes the message buf.validate.SFixed32Rules.
  * Use `create(SFixed32RulesSchema)` to create a new message.
  */
-export declare const SFixed32RulesSchema: GenMessage<SFixed32Rules, SFixed32RulesJson>;
+export declare const SFixed32RulesSchema: GenMessage<SFixed32Rules, {
+    jsonType: SFixed32RulesJson;
+}>;
 /**
- * SFixed64Rules describes the constraints applied to `fixed64` values.
+ * SFixed64Rules describes the rules applied to `fixed64` values.
  *
  * @generated from message buf.validate.SFixed64Rules
  */
@@ -4340,7 +4637,7 @@ export type SFixed64Rules = Message<"buf.validate.SFixed64Rules"> & {
     notIn: bigint[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4357,7 +4654,7 @@ export type SFixed64Rules = Message<"buf.validate.SFixed64Rules"> & {
     example: bigint[];
 };
 /**
- * SFixed64Rules describes the constraints applied to `fixed64` values.
+ * SFixed64Rules describes the rules applied to `fixed64` values.
  *
  * @generated from message buf.validate.SFixed64Rules
  */
@@ -4484,7 +4781,7 @@ export type SFixed64RulesJson = {
     notIn?: string[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4504,9 +4801,11 @@ export type SFixed64RulesJson = {
  * Describes the message buf.validate.SFixed64Rules.
  * Use `create(SFixed64RulesSchema)` to create a new message.
  */
-export declare const SFixed64RulesSchema: GenMessage<SFixed64Rules, SFixed64RulesJson>;
+export declare const SFixed64RulesSchema: GenMessage<SFixed64Rules, {
+    jsonType: SFixed64RulesJson;
+}>;
 /**
- * BoolRules describes the constraints applied to `bool` values. These rules
+ * BoolRules describes the rules applied to `bool` values. These rules
  * may also be applied to the `google.protobuf.BoolValue` Well-Known-Type.
  *
  * @generated from message buf.validate.BoolRules
@@ -4528,7 +4827,7 @@ export type BoolRules = Message<"buf.validate.BoolRules"> & {
     const: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4545,7 +4844,7 @@ export type BoolRules = Message<"buf.validate.BoolRules"> & {
     example: boolean[];
 };
 /**
- * BoolRules describes the constraints applied to `bool` values. These rules
+ * BoolRules describes the rules applied to `bool` values. These rules
  * may also be applied to the `google.protobuf.BoolValue` Well-Known-Type.
  *
  * @generated from message buf.validate.BoolRules
@@ -4567,7 +4866,7 @@ export type BoolRulesJson = {
     const?: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -4587,9 +4886,11 @@ export type BoolRulesJson = {
  * Describes the message buf.validate.BoolRules.
  * Use `create(BoolRulesSchema)` to create a new message.
  */
-export declare const BoolRulesSchema: GenMessage<BoolRules, BoolRulesJson>;
+export declare const BoolRulesSchema: GenMessage<BoolRules, {
+    jsonType: BoolRulesJson;
+}>;
 /**
- * StringRules describes the constraints applied to `string` values These
+ * StringRules describes the rules applied to `string` values These
  * rules may also be applied to the `google.protobuf.StringValue` Well-Known-Type.
  *
  * @generated from message buf.validate.StringRules
@@ -4810,15 +5111,21 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
      */
     notIn: string[];
     /**
-     * `WellKnown` rules provide advanced constraints against common string
-     * patterns
+     * `WellKnown` rules provide advanced rules against common string
+     * patterns.
      *
      * @generated from oneof buf.validate.StringRules.well_known
      */
     wellKnown: {
         /**
-         * `email` specifies that the field value must be a valid email address
-         * (addr-spec only) as defined by [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4.1).
+         * `email` specifies that the field value must be a valid email address, for
+         * example "foo@example.com".
+         *
+         * Conforms to the definition for a valid email address from the [HTML standard](https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address).
+         * Note that this standard willfully deviates from [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322),
+         * which allows many unexpected forms of email addresses and will easily match
+         * a typographical error.
+         *
          * If the field value isn't a valid email address, an error message will be generated.
          *
          * ```proto
@@ -4834,10 +5141,18 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "email";
     } | {
         /**
-         * `hostname` specifies that the field value must be a valid
-         * hostname as defined by [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034#section-3.5). This constraint doesn't support
-         * internationalized domain names (IDNs). If the field value isn't a
-         * valid hostname, an error message will be generated.
+         * `hostname` specifies that the field value must be a valid hostname, for
+         * example "foo.example.com".
+         *
+         * A valid hostname follows the rules below:
+         * - The name consists of one or more labels, separated by a dot (".").
+         * - Each label can be 1 to 63 alphanumeric characters.
+         * - A label can contain hyphens ("-"), but must not start or end with a hyphen.
+         * - The right-most label must not be digits only.
+         * - The name can have a trailing dot—for example, "foo.example.com.".
+         * - The name can be 253 characters at most, excluding the optional trailing dot.
+         *
+         * If the field value isn't a valid hostname, an error message will be generated.
          *
          * ```proto
          * message MyString {
@@ -4852,8 +5167,15 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "hostname";
     } | {
         /**
-         * `ip` specifies that the field value must be a valid IP
-         * (v4 or v6) address, without surrounding square brackets for IPv6 addresses.
+         * `ip` specifies that the field value must be a valid IP (v4 or v6) address.
+         *
+         * IPv4 addresses are expected in the dotted decimal format—for example, "192.168.5.21".
+         * IPv6 addresses are expected in their text representation—for example, "::1",
+         * or "2001:0DB8:ABCD:0012::0".
+         *
+         * Both formats are well-defined in the internet standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).
+         * Zone identifiers for IPv6 addresses (for example, "fe80::a%en1") are supported.
+         *
          * If the field value isn't a valid IP address, an error message will be
          * generated.
          *
@@ -4870,9 +5192,9 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ip";
     } | {
         /**
-         * `ipv4` specifies that the field value must be a valid IPv4
-         * address. If the field value isn't a valid IPv4 address, an error message
-         * will be generated.
+         * `ipv4` specifies that the field value must be a valid IPv4 address—for
+         * example "192.168.5.21". If the field value isn't a valid IPv4 address, an
+         * error message will be generated.
          *
          * ```proto
          * message MyString {
@@ -4887,9 +5209,9 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ipv4";
     } | {
         /**
-         * `ipv6` specifies that the field value must be a valid
-         * IPv6 address, without surrounding square brackets. If the field value is
-         * not a valid IPv6 address, an error message will be generated.
+         * `ipv6` specifies that the field value must be a valid IPv6 address—for
+         * example "::1", or "d7a:115c:a1e0:ab12:4843:cd96:626b:430b". If the field
+         * value is not a valid IPv6 address, an error message will be generated.
          *
          * ```proto
          * message MyString {
@@ -4904,8 +5226,11 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ipv6";
     } | {
         /**
-         * `uri` specifies that the field value must be a valid URI as defined by
-         * [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
+         * `uri` specifies that the field value must be a valid URI, for example
+         * "https://example.com/foo/bar?baz=quux#frag".
+         *
+         * URI is defined in the internet standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).
+         * Zone Identifiers in IPv6 address literals are supported ([RFC 6874](https://datatracker.ietf.org/doc/html/rfc6874)).
          *
          * If the field value isn't a valid URI, an error message will be generated.
          *
@@ -4922,11 +5247,13 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "uri";
     } | {
         /**
-         * `uri_ref` specifies that the field value must be a valid URI Reference as
-         * defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986#section-4.1).
+         * `uri_ref` specifies that the field value must be a valid URI Reference—either
+         * a URI such as "https://example.com/foo/bar?baz=quux#frag", or a Relative
+         * Reference such as "./foo/bar?query".
          *
-         * A URI Reference is either a [URI](https://datatracker.ietf.org/doc/html/rfc3986#section-3),
-         * or a [Relative Reference](https://datatracker.ietf.org/doc/html/rfc3986#section-4.2).
+         * URI, URI Reference, and Relative Reference are defined in the internet
+         * standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986). Zone
+         * Identifiers in IPv6 address literals are supported ([RFC 6874](https://datatracker.ietf.org/doc/html/rfc6874)).
          *
          * If the field value isn't a valid URI Reference, an error message will be
          * generated.
@@ -4945,10 +5272,9 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     } | {
         /**
          * `address` specifies that the field value must be either a valid hostname
-         * as defined by [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034#section-3.5)
-         * (which doesn't support internationalized domain names or IDNs) or a valid
-         * IP (v4 or v6). If the field value isn't a valid hostname or IP, an error
-         * message will be generated.
+         * (for example, "example.com"), or a valid IP (v4 or v6) address (for example,
+         * "192.168.0.1", or "::1"). If the field value isn't a valid hostname or IP,
+         * an error message will be generated.
          *
          * ```proto
          * message MyString {
@@ -4998,10 +5324,10 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "tuuid";
     } | {
         /**
-         * `ip_with_prefixlen` specifies that the field value must be a valid IP (v4 or v6)
-         * address with prefix length. If the field value isn't a valid IP with prefix
-         * length, an error message will be generated.
-         *
+         * `ip_with_prefixlen` specifies that the field value must be a valid IP
+         * (v4 or v6) address with prefix length—for example, "192.168.5.21/16" or
+         * "2001:0DB8:ABCD:0012::F1/64". If the field value isn't a valid IP with
+         * prefix length, an error message will be generated.
          *
          * ```proto
          * message MyString {
@@ -5017,9 +5343,9 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     } | {
         /**
          * `ipv4_with_prefixlen` specifies that the field value must be a valid
-         * IPv4 address with prefix.
-         * If the field value isn't a valid IPv4 address with prefix length,
-         * an error message will be generated.
+         * IPv4 address with prefix length—for example, "192.168.5.21/16". If the
+         * field value isn't a valid IPv4 address with prefix length, an error
+         * message will be generated.
          *
          * ```proto
          * message MyString {
@@ -5035,7 +5361,7 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     } | {
         /**
          * `ipv6_with_prefixlen` specifies that the field value must be a valid
-         * IPv6 address with prefix length.
+         * IPv6 address with prefix length—for example, "2001:0DB8:ABCD:0012::F1/64".
          * If the field value is not a valid IPv6 address with prefix length,
          * an error message will be generated.
          *
@@ -5052,10 +5378,15 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ipv6WithPrefixlen";
     } | {
         /**
-         * `ip_prefix` specifies that the field value must be a valid IP (v4 or v6) prefix.
+         * `ip_prefix` specifies that the field value must be a valid IP (v4 or v6)
+         * prefix—for example, "192.168.0.0/16" or "2001:0DB8:ABCD:0012::0/64".
+         *
+         * The prefix must have all zeros for the unmasked bits. For example,
+         * "2001:0DB8:ABCD:0012::0/64" designates the left-most 64 bits for the
+         * prefix, and the remaining 64 bits must be zero.
+         *
          * If the field value isn't a valid IP prefix, an error message will be
-         * generated. The prefix must have all zeros for the masked bits of the prefix (e.g.,
-         * `127.0.0.0/16`, not `127.0.0.1/16`).
+         * generated.
          *
          * ```proto
          * message MyString {
@@ -5071,9 +5402,14 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     } | {
         /**
          * `ipv4_prefix` specifies that the field value must be a valid IPv4
-         * prefix. If the field value isn't a valid IPv4 prefix, an error message
-         * will be generated. The prefix must have all zeros for the masked bits of
-         * the prefix (e.g., `127.0.0.0/16`, not `127.0.0.1/16`).
+         * prefix, for example "192.168.0.0/16".
+         *
+         * The prefix must have all zeros for the unmasked bits. For example,
+         * "192.168.0.0/16" designates the left-most 16 bits for the prefix,
+         * and the remaining 16 bits must be zero.
+         *
+         * If the field value isn't a valid IPv4 prefix, an error message
+         * will be generated.
          *
          * ```proto
          * message MyString {
@@ -5088,10 +5424,15 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ipv4Prefix";
     } | {
         /**
-         * `ipv6_prefix` specifies that the field value must be a valid IPv6 prefix.
+         * `ipv6_prefix` specifies that the field value must be a valid IPv6 prefix—for
+         * example, "2001:0DB8:ABCD:0012::0/64".
+         *
+         * The prefix must have all zeros for the unmasked bits. For example,
+         * "2001:0DB8:ABCD:0012::0/64" designates the left-most 64 bits for the
+         * prefix, and the remaining 64 bits must be zero.
+         *
          * If the field value is not a valid IPv6 prefix, an error message will be
-         * generated. The prefix must have all zeros for the masked bits of the prefix
-         * (e.g., `2001:db8::/48`, not `2001:db8::1/48`).
+         * generated.
          *
          * ```proto
          * message MyString {
@@ -5106,15 +5447,38 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
         case: "ipv6Prefix";
     } | {
         /**
-         * `host_and_port` specifies the field value must be a valid host and port
-         * pair. The host must be a valid hostname or IP address while the port
-         * must be in the range of 0-65535, inclusive. IPv6 addresses must be delimited
-         * with square brackets (e.g., `[::1]:1234`).
+         * `host_and_port` specifies that the field value must be valid host/port
+         * pair—for example, "example.com:8080".
+         *
+         * The host can be one of:
+         * - An IPv4 address in dotted decimal format—for example, "192.168.5.21".
+         * - An IPv6 address enclosed in square brackets—for example, "[2001:0DB8:ABCD:0012::F1]".
+         * - A hostname—for example, "example.com".
+         *
+         * The port is separated by a colon. It must be non-empty, with a decimal number
+         * in the range of 0-65535, inclusive.
          *
          * @generated from field: bool host_and_port = 32;
          */
         value: boolean;
         case: "hostAndPort";
+    } | {
+        /**
+         * `ulid` specifies that the field value must be a valid ULID (Universally Unique
+         * Lexicographically Sortable Identifier) as defined by the [ULID specification](https://github.com/ulid/spec).
+         * If the field value isn't a valid ULID, an error message will be generated.
+         *
+         * ```proto
+         * message MyString {
+         *   // value must be a valid ULID
+         *   string value = 1 [(buf.validate.field).string.ulid = true];
+         * }
+         * ```
+         *
+         * @generated from field: bool ulid = 35;
+         */
+        value: boolean;
+        case: "ulid";
     } | {
         /**
          * `well_known_regex` specifies a common well-known pattern
@@ -5165,7 +5529,7 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     strict: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -5182,7 +5546,7 @@ export type StringRules = Message<"buf.validate.StringRules"> & {
     example: string[];
 };
 /**
- * StringRules describes the constraints applied to `string` values These
+ * StringRules describes the rules applied to `string` values These
  * rules may also be applied to the `google.protobuf.StringValue` Well-Known-Type.
  *
  * @generated from message buf.validate.StringRules
@@ -5403,8 +5767,14 @@ export type StringRulesJson = {
      */
     notIn?: string[];
     /**
-     * `email` specifies that the field value must be a valid email address
-     * (addr-spec only) as defined by [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4.1).
+     * `email` specifies that the field value must be a valid email address, for
+     * example "foo@example.com".
+     *
+     * Conforms to the definition for a valid email address from the [HTML standard](https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address).
+     * Note that this standard willfully deviates from [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322),
+     * which allows many unexpected forms of email addresses and will easily match
+     * a typographical error.
+     *
      * If the field value isn't a valid email address, an error message will be generated.
      *
      * ```proto
@@ -5418,10 +5788,18 @@ export type StringRulesJson = {
      */
     email?: boolean;
     /**
-     * `hostname` specifies that the field value must be a valid
-     * hostname as defined by [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034#section-3.5). This constraint doesn't support
-     * internationalized domain names (IDNs). If the field value isn't a
-     * valid hostname, an error message will be generated.
+     * `hostname` specifies that the field value must be a valid hostname, for
+     * example "foo.example.com".
+     *
+     * A valid hostname follows the rules below:
+     * - The name consists of one or more labels, separated by a dot (".").
+     * - Each label can be 1 to 63 alphanumeric characters.
+     * - A label can contain hyphens ("-"), but must not start or end with a hyphen.
+     * - The right-most label must not be digits only.
+     * - The name can have a trailing dot—for example, "foo.example.com.".
+     * - The name can be 253 characters at most, excluding the optional trailing dot.
+     *
+     * If the field value isn't a valid hostname, an error message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5434,8 +5812,15 @@ export type StringRulesJson = {
      */
     hostname?: boolean;
     /**
-     * `ip` specifies that the field value must be a valid IP
-     * (v4 or v6) address, without surrounding square brackets for IPv6 addresses.
+     * `ip` specifies that the field value must be a valid IP (v4 or v6) address.
+     *
+     * IPv4 addresses are expected in the dotted decimal format—for example, "192.168.5.21".
+     * IPv6 addresses are expected in their text representation—for example, "::1",
+     * or "2001:0DB8:ABCD:0012::0".
+     *
+     * Both formats are well-defined in the internet standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).
+     * Zone identifiers for IPv6 addresses (for example, "fe80::a%en1") are supported.
+     *
      * If the field value isn't a valid IP address, an error message will be
      * generated.
      *
@@ -5450,9 +5835,9 @@ export type StringRulesJson = {
      */
     ip?: boolean;
     /**
-     * `ipv4` specifies that the field value must be a valid IPv4
-     * address. If the field value isn't a valid IPv4 address, an error message
-     * will be generated.
+     * `ipv4` specifies that the field value must be a valid IPv4 address—for
+     * example "192.168.5.21". If the field value isn't a valid IPv4 address, an
+     * error message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5465,9 +5850,9 @@ export type StringRulesJson = {
      */
     ipv4?: boolean;
     /**
-     * `ipv6` specifies that the field value must be a valid
-     * IPv6 address, without surrounding square brackets. If the field value is
-     * not a valid IPv6 address, an error message will be generated.
+     * `ipv6` specifies that the field value must be a valid IPv6 address—for
+     * example "::1", or "d7a:115c:a1e0:ab12:4843:cd96:626b:430b". If the field
+     * value is not a valid IPv6 address, an error message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5480,8 +5865,11 @@ export type StringRulesJson = {
      */
     ipv6?: boolean;
     /**
-     * `uri` specifies that the field value must be a valid URI as defined by
-     * [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
+     * `uri` specifies that the field value must be a valid URI, for example
+     * "https://example.com/foo/bar?baz=quux#frag".
+     *
+     * URI is defined in the internet standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).
+     * Zone Identifiers in IPv6 address literals are supported ([RFC 6874](https://datatracker.ietf.org/doc/html/rfc6874)).
      *
      * If the field value isn't a valid URI, an error message will be generated.
      *
@@ -5496,11 +5884,13 @@ export type StringRulesJson = {
      */
     uri?: boolean;
     /**
-     * `uri_ref` specifies that the field value must be a valid URI Reference as
-     * defined by [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986#section-4.1).
+     * `uri_ref` specifies that the field value must be a valid URI Reference—either
+     * a URI such as "https://example.com/foo/bar?baz=quux#frag", or a Relative
+     * Reference such as "./foo/bar?query".
      *
-     * A URI Reference is either a [URI](https://datatracker.ietf.org/doc/html/rfc3986#section-3),
-     * or a [Relative Reference](https://datatracker.ietf.org/doc/html/rfc3986#section-4.2).
+     * URI, URI Reference, and Relative Reference are defined in the internet
+     * standard [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986). Zone
+     * Identifiers in IPv6 address literals are supported ([RFC 6874](https://datatracker.ietf.org/doc/html/rfc6874)).
      *
      * If the field value isn't a valid URI Reference, an error message will be
      * generated.
@@ -5517,10 +5907,9 @@ export type StringRulesJson = {
     uriRef?: boolean;
     /**
      * `address` specifies that the field value must be either a valid hostname
-     * as defined by [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034#section-3.5)
-     * (which doesn't support internationalized domain names or IDNs) or a valid
-     * IP (v4 or v6). If the field value isn't a valid hostname or IP, an error
-     * message will be generated.
+     * (for example, "example.com"), or a valid IP (v4 or v6) address (for example,
+     * "192.168.0.1", or "::1"). If the field value isn't a valid hostname or IP,
+     * an error message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5564,10 +5953,10 @@ export type StringRulesJson = {
      */
     tuuid?: boolean;
     /**
-     * `ip_with_prefixlen` specifies that the field value must be a valid IP (v4 or v6)
-     * address with prefix length. If the field value isn't a valid IP with prefix
-     * length, an error message will be generated.
-     *
+     * `ip_with_prefixlen` specifies that the field value must be a valid IP
+     * (v4 or v6) address with prefix length—for example, "192.168.5.21/16" or
+     * "2001:0DB8:ABCD:0012::F1/64". If the field value isn't a valid IP with
+     * prefix length, an error message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5581,9 +5970,9 @@ export type StringRulesJson = {
     ipWithPrefixlen?: boolean;
     /**
      * `ipv4_with_prefixlen` specifies that the field value must be a valid
-     * IPv4 address with prefix.
-     * If the field value isn't a valid IPv4 address with prefix length,
-     * an error message will be generated.
+     * IPv4 address with prefix length—for example, "192.168.5.21/16". If the
+     * field value isn't a valid IPv4 address with prefix length, an error
+     * message will be generated.
      *
      * ```proto
      * message MyString {
@@ -5597,7 +5986,7 @@ export type StringRulesJson = {
     ipv4WithPrefixlen?: boolean;
     /**
      * `ipv6_with_prefixlen` specifies that the field value must be a valid
-     * IPv6 address with prefix length.
+     * IPv6 address with prefix length—for example, "2001:0DB8:ABCD:0012::F1/64".
      * If the field value is not a valid IPv6 address with prefix length,
      * an error message will be generated.
      *
@@ -5612,10 +6001,15 @@ export type StringRulesJson = {
      */
     ipv6WithPrefixlen?: boolean;
     /**
-     * `ip_prefix` specifies that the field value must be a valid IP (v4 or v6) prefix.
+     * `ip_prefix` specifies that the field value must be a valid IP (v4 or v6)
+     * prefix—for example, "192.168.0.0/16" or "2001:0DB8:ABCD:0012::0/64".
+     *
+     * The prefix must have all zeros for the unmasked bits. For example,
+     * "2001:0DB8:ABCD:0012::0/64" designates the left-most 64 bits for the
+     * prefix, and the remaining 64 bits must be zero.
+     *
      * If the field value isn't a valid IP prefix, an error message will be
-     * generated. The prefix must have all zeros for the masked bits of the prefix (e.g.,
-     * `127.0.0.0/16`, not `127.0.0.1/16`).
+     * generated.
      *
      * ```proto
      * message MyString {
@@ -5629,9 +6023,14 @@ export type StringRulesJson = {
     ipPrefix?: boolean;
     /**
      * `ipv4_prefix` specifies that the field value must be a valid IPv4
-     * prefix. If the field value isn't a valid IPv4 prefix, an error message
-     * will be generated. The prefix must have all zeros for the masked bits of
-     * the prefix (e.g., `127.0.0.0/16`, not `127.0.0.1/16`).
+     * prefix, for example "192.168.0.0/16".
+     *
+     * The prefix must have all zeros for the unmasked bits. For example,
+     * "192.168.0.0/16" designates the left-most 16 bits for the prefix,
+     * and the remaining 16 bits must be zero.
+     *
+     * If the field value isn't a valid IPv4 prefix, an error message
+     * will be generated.
      *
      * ```proto
      * message MyString {
@@ -5644,10 +6043,15 @@ export type StringRulesJson = {
      */
     ipv4Prefix?: boolean;
     /**
-     * `ipv6_prefix` specifies that the field value must be a valid IPv6 prefix.
+     * `ipv6_prefix` specifies that the field value must be a valid IPv6 prefix—for
+     * example, "2001:0DB8:ABCD:0012::0/64".
+     *
+     * The prefix must have all zeros for the unmasked bits. For example,
+     * "2001:0DB8:ABCD:0012::0/64" designates the left-most 64 bits for the
+     * prefix, and the remaining 64 bits must be zero.
+     *
      * If the field value is not a valid IPv6 prefix, an error message will be
-     * generated. The prefix must have all zeros for the masked bits of the prefix
-     * (e.g., `2001:db8::/48`, not `2001:db8::1/48`).
+     * generated.
      *
      * ```proto
      * message MyString {
@@ -5660,14 +6064,35 @@ export type StringRulesJson = {
      */
     ipv6Prefix?: boolean;
     /**
-     * `host_and_port` specifies the field value must be a valid host and port
-     * pair. The host must be a valid hostname or IP address while the port
-     * must be in the range of 0-65535, inclusive. IPv6 addresses must be delimited
-     * with square brackets (e.g., `[::1]:1234`).
+     * `host_and_port` specifies that the field value must be valid host/port
+     * pair—for example, "example.com:8080".
+     *
+     * The host can be one of:
+     * - An IPv4 address in dotted decimal format—for example, "192.168.5.21".
+     * - An IPv6 address enclosed in square brackets—for example, "[2001:0DB8:ABCD:0012::F1]".
+     * - A hostname—for example, "example.com".
+     *
+     * The port is separated by a colon. It must be non-empty, with a decimal number
+     * in the range of 0-65535, inclusive.
      *
      * @generated from field: bool host_and_port = 32;
      */
     hostAndPort?: boolean;
+    /**
+     * `ulid` specifies that the field value must be a valid ULID (Universally Unique
+     * Lexicographically Sortable Identifier) as defined by the [ULID specification](https://github.com/ulid/spec).
+     * If the field value isn't a valid ULID, an error message will be generated.
+     *
+     * ```proto
+     * message MyString {
+     *   // value must be a valid ULID
+     *   string value = 1 [(buf.validate.field).string.ulid = true];
+     * }
+     * ```
+     *
+     * @generated from field: bool ulid = 35;
+     */
+    ulid?: boolean;
     /**
      * `well_known_regex` specifies a common well-known pattern
      * defined as a regex. If the field value doesn't match the well-known
@@ -5712,7 +6137,7 @@ export type StringRulesJson = {
     strict?: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -5732,9 +6157,11 @@ export type StringRulesJson = {
  * Describes the message buf.validate.StringRules.
  * Use `create(StringRulesSchema)` to create a new message.
  */
-export declare const StringRulesSchema: GenMessage<StringRules, StringRulesJson>;
+export declare const StringRulesSchema: GenMessage<StringRules, {
+    jsonType: StringRulesJson;
+}>;
 /**
- * BytesRules describe the constraints applied to `bytes` values. These rules
+ * BytesRules describe the rules applied to `bytes` values. These rules
  * may also be applied to the `google.protobuf.BytesValue` Well-Known-Type.
  *
  * @generated from message buf.validate.BytesRules
@@ -5850,7 +6277,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
      * the string.
      * If the field value doesn't meet the requirement, an error message is generated.
      *
-     * ```protobuf
+     * ```proto
      * message MyBytes {
      *   // value does not contain \x02\x03
      *   optional bytes value = 1 [(buf.validate.field).bytes.contains = "\x02\x03"];
@@ -5865,7 +6292,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
      * values. If the field value doesn't match any of the specified values, an
      * error message is generated.
      *
-     * ```protobuf
+     * ```proto
      * message MyBytes {
      *   // value must in ["\x01\x02", "\x02\x03", "\x03\x04"]
      *   optional bytes value = 1 [(buf.validate.field).bytes.in = {"\x01\x02", "\x02\x03", "\x03\x04"}];
@@ -5892,7 +6319,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
      */
     notIn: Uint8Array[];
     /**
-     * WellKnown rules provide advanced constraints against common byte
+     * WellKnown rules provide advanced rules against common byte
      * patterns
      *
      * @generated from oneof buf.validate.BytesRules.well_known
@@ -5900,7 +6327,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
     wellKnown: {
         /**
          * `ip` ensures that the field `value` is a valid IP address (v4 or v6) in byte format.
-         * If the field value doesn't meet this constraint, an error message is generated.
+         * If the field value doesn't meet this rule, an error message is generated.
          *
          * ```proto
          * message MyBytes {
@@ -5916,7 +6343,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
     } | {
         /**
          * `ipv4` ensures that the field `value` is a valid IPv4 address in byte format.
-         * If the field value doesn't meet this constraint, an error message is generated.
+         * If the field value doesn't meet this rule, an error message is generated.
          *
          * ```proto
          * message MyBytes {
@@ -5932,7 +6359,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
     } | {
         /**
          * `ipv6` ensures that the field `value` is a valid IPv6 address in byte format.
-         * If the field value doesn't meet this constraint, an error message is generated.
+         * If the field value doesn't meet this rule, an error message is generated.
          * ```proto
          * message MyBytes {
          *   // value must be a valid IPv6 address
@@ -5944,13 +6371,32 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
          */
         value: boolean;
         case: "ipv6";
+    } | {
+        /**
+         * `uuid` ensures that the field `value` encodes the 128-bit UUID data as
+         * defined by [RFC 4122](https://datatracker.ietf.org/doc/html/rfc4122#section-4.1.2).
+         * The field must contain exactly 16 bytes
+         * representing the UUID. If the field value isn't a valid UUID, an error
+         * message will be generated.
+         *
+         * ```proto
+         * message MyBytes {
+         *   // value must be a valid UUID
+         *   optional bytes value = 1 [(buf.validate.field).bytes.uuid = true];
+         * }
+         * ```
+         *
+         * @generated from field: bool uuid = 15;
+         */
+        value: boolean;
+        case: "uuid";
     } | {
         case: undefined;
         value?: undefined;
     };
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -5967,7 +6413,7 @@ export type BytesRules = Message<"buf.validate.BytesRules"> & {
     example: Uint8Array[];
 };
 /**
- * BytesRules describe the constraints applied to `bytes` values. These rules
+ * BytesRules describe the rules applied to `bytes` values. These rules
  * may also be applied to the `google.protobuf.BytesValue` Well-Known-Type.
  *
  * @generated from message buf.validate.BytesRules
@@ -6083,7 +6529,7 @@ export type BytesRulesJson = {
      * the string.
      * If the field value doesn't meet the requirement, an error message is generated.
      *
-     * ```protobuf
+     * ```proto
      * message MyBytes {
      *   // value does not contain \x02\x03
      *   optional bytes value = 1 [(buf.validate.field).bytes.contains = "\x02\x03"];
@@ -6098,7 +6544,7 @@ export type BytesRulesJson = {
      * values. If the field value doesn't match any of the specified values, an
      * error message is generated.
      *
-     * ```protobuf
+     * ```proto
      * message MyBytes {
      *   // value must in ["\x01\x02", "\x02\x03", "\x03\x04"]
      *   optional bytes value = 1 [(buf.validate.field).bytes.in = {"\x01\x02", "\x02\x03", "\x03\x04"}];
@@ -6126,7 +6572,7 @@ export type BytesRulesJson = {
     notIn?: string[];
     /**
      * `ip` ensures that the field `value` is a valid IP address (v4 or v6) in byte format.
-     * If the field value doesn't meet this constraint, an error message is generated.
+     * If the field value doesn't meet this rule, an error message is generated.
      *
      * ```proto
      * message MyBytes {
@@ -6140,7 +6586,7 @@ export type BytesRulesJson = {
     ip?: boolean;
     /**
      * `ipv4` ensures that the field `value` is a valid IPv4 address in byte format.
-     * If the field value doesn't meet this constraint, an error message is generated.
+     * If the field value doesn't meet this rule, an error message is generated.
      *
      * ```proto
      * message MyBytes {
@@ -6154,7 +6600,7 @@ export type BytesRulesJson = {
     ipv4?: boolean;
     /**
      * `ipv6` ensures that the field `value` is a valid IPv6 address in byte format.
-     * If the field value doesn't meet this constraint, an error message is generated.
+     * If the field value doesn't meet this rule, an error message is generated.
      * ```proto
      * message MyBytes {
      *   // value must be a valid IPv6 address
@@ -6165,9 +6611,26 @@ export type BytesRulesJson = {
      * @generated from field: bool ipv6 = 12;
      */
     ipv6?: boolean;
+    /**
+     * `uuid` ensures that the field `value` encodes the 128-bit UUID data as
+     * defined by [RFC 4122](https://datatracker.ietf.org/doc/html/rfc4122#section-4.1.2).
+     * The field must contain exactly 16 bytes
+     * representing the UUID. If the field value isn't a valid UUID, an error
+     * message will be generated.
+     *
+     * ```proto
+     * message MyBytes {
+     *   // value must be a valid UUID
+     *   optional bytes value = 1 [(buf.validate.field).bytes.uuid = true];
+     * }
+     * ```
+     *
+     * @generated from field: bool uuid = 15;
+     */
+    uuid?: boolean;
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -6187,9 +6650,11 @@ export type BytesRulesJson = {
  * Describes the message buf.validate.BytesRules.
  * Use `create(BytesRulesSchema)` to create a new message.
  */
-export declare const BytesRulesSchema: GenMessage<BytesRules, BytesRulesJson>;
+export declare const BytesRulesSchema: GenMessage<BytesRules, {
+    jsonType: BytesRulesJson;
+}>;
 /**
- * EnumRules describe the constraints applied to `enum` values.
+ * EnumRules describe the rules applied to `enum` values.
  *
  * @generated from message buf.validate.EnumRules
  */
@@ -6278,7 +6743,7 @@ export type EnumRules = Message<"buf.validate.EnumRules"> & {
     notIn: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -6299,7 +6764,7 @@ export type EnumRules = Message<"buf.validate.EnumRules"> & {
     example: number[];
 };
 /**
- * EnumRules describe the constraints applied to `enum` values.
+ * EnumRules describe the rules applied to `enum` values.
  *
  * @generated from message buf.validate.EnumRules
  */
@@ -6388,7 +6853,7 @@ export type EnumRulesJson = {
     notIn?: number[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -6412,9 +6877,11 @@ export type EnumRulesJson = {
  * Describes the message buf.validate.EnumRules.
  * Use `create(EnumRulesSchema)` to create a new message.
  */
-export declare const EnumRulesSchema: GenMessage<EnumRules, EnumRulesJson>;
+export declare const EnumRulesSchema: GenMessage<EnumRules, {
+    jsonType: EnumRulesJson;
+}>;
 /**
- * RepeatedRules describe the constraints applied to `repeated` values.
+ * RepeatedRules describe the rules applied to `repeated` values.
  *
  * @generated from message buf.validate.RepeatedRules
  */
@@ -6453,7 +6920,7 @@ export type RepeatedRules = Message<"buf.validate.RepeatedRules"> & {
     maxItems: bigint;
     /**
      * `unique` indicates that all elements in this field must
-     * be unique. This constraint is strictly applicable to scalar and enum
+     * be unique. This rule is strictly applicable to scalar and enum
      * types, with message types not being supported.
      *
      * ```proto
@@ -6467,13 +6934,13 @@ export type RepeatedRules = Message<"buf.validate.RepeatedRules"> & {
      */
     unique: boolean;
     /**
-     * `items` details the constraints to be applied to each item
+     * `items` details the rules to be applied to each item
      * in the field. Even for repeated message fields, validation is executed
-     * against each item unless skip is explicitly specified.
+     * against each item unless `ignore` is specified.
      *
      * ```proto
      * message MyRepeated {
-     *   // The items in the field `value` must follow the specified constraints.
+     *   // The items in the field `value` must follow the specified rules.
      *   repeated string value = 1 [(buf.validate.field).repeated.items = {
      *     string: {
      *       min_len: 3
@@ -6483,12 +6950,15 @@ export type RepeatedRules = Message<"buf.validate.RepeatedRules"> & {
      * }
      * ```
      *
-     * @generated from field: optional buf.validate.FieldConstraints items = 4;
+     * Note that the `required` rule does not apply. Repeated items
+     * cannot be unset.
+     *
+     * @generated from field: optional buf.validate.FieldRules items = 4;
      */
-    items?: FieldConstraints;
+    items?: FieldRules;
 };
 /**
- * RepeatedRules describe the constraints applied to `repeated` values.
+ * RepeatedRules describe the rules applied to `repeated` values.
  *
  * @generated from message buf.validate.RepeatedRules
  */
@@ -6527,7 +6997,7 @@ export type RepeatedRulesJson = {
     maxItems?: string;
     /**
      * `unique` indicates that all elements in this field must
-     * be unique. This constraint is strictly applicable to scalar and enum
+     * be unique. This rule is strictly applicable to scalar and enum
      * types, with message types not being supported.
      *
      * ```proto
@@ -6541,13 +7011,13 @@ export type RepeatedRulesJson = {
      */
     unique?: boolean;
     /**
-     * `items` details the constraints to be applied to each item
+     * `items` details the rules to be applied to each item
      * in the field. Even for repeated message fields, validation is executed
-     * against each item unless skip is explicitly specified.
+     * against each item unless `ignore` is specified.
      *
      * ```proto
      * message MyRepeated {
-     *   // The items in the field `value` must follow the specified constraints.
+     *   // The items in the field `value` must follow the specified rules.
      *   repeated string value = 1 [(buf.validate.field).repeated.items = {
      *     string: {
      *       min_len: 3
@@ -6557,17 +7027,22 @@ export type RepeatedRulesJson = {
      * }
      * ```
      *
-     * @generated from field: optional buf.validate.FieldConstraints items = 4;
+     * Note that the `required` rule does not apply. Repeated items
+     * cannot be unset.
+     *
+     * @generated from field: optional buf.validate.FieldRules items = 4;
      */
-    items?: FieldConstraintsJson;
+    items?: FieldRulesJson;
 };
 /**
  * Describes the message buf.validate.RepeatedRules.
  * Use `create(RepeatedRulesSchema)` to create a new message.
  */
-export declare const RepeatedRulesSchema: GenMessage<RepeatedRules, RepeatedRulesJson>;
+export declare const RepeatedRulesSchema: GenMessage<RepeatedRules, {
+    jsonType: RepeatedRulesJson;
+}>;
 /**
- * MapRules describe the constraints applied to `map` values.
+ * MapRules describe the rules applied to `map` values.
  *
  * @generated from message buf.validate.MapRules
  */
@@ -6601,11 +7076,11 @@ export type MapRules = Message<"buf.validate.MapRules"> & {
      */
     maxPairs: bigint;
     /**
-     * Specifies the constraints to be applied to each key in the field.
+     * Specifies the rules to be applied to each key in the field.
      *
      * ```proto
      * message MyMap {
-     *   // The keys in the field `value` must follow the specified constraints.
+     *   // The keys in the field `value` must follow the specified rules.
      *   map<string, string> value = 1 [(buf.validate.field).map.keys = {
      *     string: {
      *       min_len: 3
@@ -6615,17 +7090,19 @@ export type MapRules = Message<"buf.validate.MapRules"> & {
      * }
      * ```
      *
-     * @generated from field: optional buf.validate.FieldConstraints keys = 4;
+     * Note that the `required` rule does not apply. Map keys cannot be unset.
+     *
+     * @generated from field: optional buf.validate.FieldRules keys = 4;
      */
-    keys?: FieldConstraints;
+    keys?: FieldRules;
     /**
-     * Specifies the constraints to be applied to the value of each key in the
+     * Specifies the rules to be applied to the value of each key in the
      * field. Message values will still have their validations evaluated unless
-     * skip is specified here.
+     * `ignore` is specified.
      *
      * ```proto
      * message MyMap {
-     *   // The values in the field `value` must follow the specified constraints.
+     *   // The values in the field `value` must follow the specified rules.
      *   map<string, string> value = 1 [(buf.validate.field).map.values = {
      *     string: {
      *       min_len: 5
@@ -6634,13 +7111,14 @@ export type MapRules = Message<"buf.validate.MapRules"> & {
      *   }];
      * }
      * ```
+     * Note that the `required` rule does not apply. Map values cannot be unset.
      *
-     * @generated from field: optional buf.validate.FieldConstraints values = 5;
+     * @generated from field: optional buf.validate.FieldRules values = 5;
      */
-    values?: FieldConstraints;
+    values?: FieldRules;
 };
 /**
- * MapRules describe the constraints applied to `map` values.
+ * MapRules describe the rules applied to `map` values.
  *
  * @generated from message buf.validate.MapRules
  */
@@ -6674,11 +7152,11 @@ export type MapRulesJson = {
      */
     maxPairs?: string;
     /**
-     * Specifies the constraints to be applied to each key in the field.
+     * Specifies the rules to be applied to each key in the field.
      *
      * ```proto
      * message MyMap {
-     *   // The keys in the field `value` must follow the specified constraints.
+     *   // The keys in the field `value` must follow the specified rules.
      *   map<string, string> value = 1 [(buf.validate.field).map.keys = {
      *     string: {
      *       min_len: 3
@@ -6688,17 +7166,19 @@ export type MapRulesJson = {
      * }
      * ```
      *
-     * @generated from field: optional buf.validate.FieldConstraints keys = 4;
+     * Note that the `required` rule does not apply. Map keys cannot be unset.
+     *
+     * @generated from field: optional buf.validate.FieldRules keys = 4;
      */
-    keys?: FieldConstraintsJson;
+    keys?: FieldRulesJson;
     /**
-     * Specifies the constraints to be applied to the value of each key in the
+     * Specifies the rules to be applied to the value of each key in the
      * field. Message values will still have their validations evaluated unless
-     * skip is specified here.
+     * `ignore` is specified.
      *
      * ```proto
      * message MyMap {
-     *   // The values in the field `value` must follow the specified constraints.
+     *   // The values in the field `value` must follow the specified rules.
      *   map<string, string> value = 1 [(buf.validate.field).map.values = {
      *     string: {
      *       min_len: 5
@@ -6707,18 +7187,21 @@ export type MapRulesJson = {
      *   }];
      * }
      * ```
+     * Note that the `required` rule does not apply. Map values cannot be unset.
      *
-     * @generated from field: optional buf.validate.FieldConstraints values = 5;
+     * @generated from field: optional buf.validate.FieldRules values = 5;
      */
-    values?: FieldConstraintsJson;
+    values?: FieldRulesJson;
 };
 /**
  * Describes the message buf.validate.MapRules.
  * Use `create(MapRulesSchema)` to create a new message.
  */
-export declare const MapRulesSchema: GenMessage<MapRules, MapRulesJson>;
+export declare const MapRulesSchema: GenMessage<MapRules, {
+    jsonType: MapRulesJson;
+}>;
 /**
- * AnyRules describe constraints applied exclusively to the `google.protobuf.Any` well-known type.
+ * AnyRules describe rules applied exclusively to the `google.protobuf.Any` well-known type.
  *
  * @generated from message buf.validate.AnyRules
  */
@@ -6731,7 +7214,9 @@ export type AnyRules = Message<"buf.validate.AnyRules"> & {
      * ```proto
      * message MyAny {
      *   //  The `value` field must have a `type_url` equal to one of the specified values.
-     *   google.protobuf.Any value = 1 [(buf.validate.field).any.in = ["type.googleapis.com/MyType1", "type.googleapis.com/MyType2"]];
+     *   google.protobuf.Any value = 1 [(buf.validate.field).any = {
+     *       in: ["type.googleapis.com/MyType1", "type.googleapis.com/MyType2"]
+     *   }];
      * }
      * ```
      *
@@ -6743,8 +7228,10 @@ export type AnyRules = Message<"buf.validate.AnyRules"> & {
      *
      * ```proto
      * message MyAny {
-     *   // The field `value` must not have a `type_url` equal to any of the specified values.
-     *   google.protobuf.Any value = 1 [(buf.validate.field).any.not_in = ["type.googleapis.com/ForbiddenType1", "type.googleapis.com/ForbiddenType2"]];
+     *   //  The `value` field must not have a `type_url` equal to any of the specified values.
+     *   google.protobuf.Any value = 1 [(buf.validate.field).any = {
+     *       not_in: ["type.googleapis.com/ForbiddenType1", "type.googleapis.com/ForbiddenType2"]
+     *   }];
      * }
      * ```
      *
@@ -6753,7 +7240,7 @@ export type AnyRules = Message<"buf.validate.AnyRules"> & {
     notIn: string[];
 };
 /**
- * AnyRules describe constraints applied exclusively to the `google.protobuf.Any` well-known type.
+ * AnyRules describe rules applied exclusively to the `google.protobuf.Any` well-known type.
  *
  * @generated from message buf.validate.AnyRules
  */
@@ -6766,7 +7253,9 @@ export type AnyRulesJson = {
      * ```proto
      * message MyAny {
      *   //  The `value` field must have a `type_url` equal to one of the specified values.
-     *   google.protobuf.Any value = 1 [(buf.validate.field).any.in = ["type.googleapis.com/MyType1", "type.googleapis.com/MyType2"]];
+     *   google.protobuf.Any value = 1 [(buf.validate.field).any = {
+     *       in: ["type.googleapis.com/MyType1", "type.googleapis.com/MyType2"]
+     *   }];
      * }
      * ```
      *
@@ -6778,8 +7267,10 @@ export type AnyRulesJson = {
      *
      * ```proto
      * message MyAny {
-     *   // The field `value` must not have a `type_url` equal to any of the specified values.
-     *   google.protobuf.Any value = 1 [(buf.validate.field).any.not_in = ["type.googleapis.com/ForbiddenType1", "type.googleapis.com/ForbiddenType2"]];
+     *   //  The `value` field must not have a `type_url` equal to any of the specified values.
+     *   google.protobuf.Any value = 1 [(buf.validate.field).any = {
+     *       not_in: ["type.googleapis.com/ForbiddenType1", "type.googleapis.com/ForbiddenType2"]
+     *   }];
      * }
      * ```
      *
@@ -6791,9 +7282,11 @@ export type AnyRulesJson = {
  * Describes the message buf.validate.AnyRules.
  * Use `create(AnyRulesSchema)` to create a new message.
  */
-export declare const AnyRulesSchema: GenMessage<AnyRules, AnyRulesJson>;
+export declare const AnyRulesSchema: GenMessage<AnyRules, {
+    jsonType: AnyRulesJson;
+}>;
 /**
- * DurationRules describe the constraints applied exclusively to the `google.protobuf.Duration` well-known type.
+ * DurationRules describe the rules applied exclusively to the `google.protobuf.Duration` well-known type.
  *
  * @generated from message buf.validate.DurationRules
  */
@@ -6944,7 +7437,7 @@ export type DurationRules = Message<"buf.validate.DurationRules"> & {
     notIn: Duration[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -6961,7 +7454,7 @@ export type DurationRules = Message<"buf.validate.DurationRules"> & {
     example: Duration[];
 };
 /**
- * DurationRules describe the constraints applied exclusively to the `google.protobuf.Duration` well-known type.
+ * DurationRules describe the rules applied exclusively to the `google.protobuf.Duration` well-known type.
  *
  * @generated from message buf.validate.DurationRules
  */
@@ -7090,7 +7583,7 @@ export type DurationRulesJson = {
     notIn?: DurationJson[];
     /**
      * `example` specifies values that the field may have. These values SHOULD
-     * conform to other constraints. `example` values will not impact validation
+     * conform to other rules. `example` values will not impact validation
      * but may be used as helpful guidance on how to populate the given field.
      *
      * ```proto
@@ -7110,9 +7603,176 @@ export type DurationRulesJson = {
  * Describes the message buf.validate.DurationRules.
  * Use `create(DurationRulesSchema)` to create a new message.
  */
-export declare const DurationRulesSchema: GenMessage<DurationRules, DurationRulesJson>;
+export declare const DurationRulesSchema: GenMessage<DurationRules, {
+    jsonType: DurationRulesJson;
+}>;
+/**
+ * FieldMaskRules describe rules applied exclusively to the `google.protobuf.FieldMask` well-known type.
+ *
+ * @generated from message buf.validate.FieldMaskRules
+ */
+export type FieldMaskRules = Message<"buf.validate.FieldMaskRules"> & {
+    /**
+     * `const` dictates that the field must match the specified value of the `google.protobuf.FieldMask` type exactly.
+     * If the field's value deviates from the specified value, an error message
+     * will be generated.
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   // value must equal ["a"]
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask.const = {
+     *       paths: ["a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: optional google.protobuf.FieldMask const = 1;
+     */
+    const?: FieldMask;
+    /**
+     * `in` requires the field value to only contain paths matching specified
+     * values or their subpaths.
+     * If any of the field value's paths doesn't match the rule,
+     * an error message is generated.
+     * See: https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   //  The `value` FieldMask must only contain paths listed in `in`.
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask = {
+     *       in: ["a", "b", "c.a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string in = 2;
+     */
+    in: string[];
+    /**
+     * `not_in` requires the field value to not contain paths matching specified
+     * values or their subpaths.
+     * If any of the field value's paths matches the rule,
+     * an error message is generated.
+     * See: https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   //  The `value` FieldMask shall not contain paths listed in `not_in`.
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask = {
+     *       not_in: ["forbidden", "immutable", "c.a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string not_in = 3;
+     */
+    notIn: string[];
+    /**
+     * `example` specifies values that the field may have. These values SHOULD
+     * conform to other rules. `example` values will not impact validation
+     * but may be used as helpful guidance on how to populate the given field.
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   google.protobuf.FieldMask value = 1 [
+     *     (buf.validate.field).field_mask.example = { paths: ["a", "b"] },
+     *     (buf.validate.field).field_mask.example = { paths: ["c.a", "d"] },
+     *   ];
+     * }
+     * ```
+     *
+     * @generated from field: repeated google.protobuf.FieldMask example = 4;
+     */
+    example: FieldMask[];
+};
+/**
+ * FieldMaskRules describe rules applied exclusively to the `google.protobuf.FieldMask` well-known type.
+ *
+ * @generated from message buf.validate.FieldMaskRules
+ */
+export type FieldMaskRulesJson = {
+    /**
+     * `const` dictates that the field must match the specified value of the `google.protobuf.FieldMask` type exactly.
+     * If the field's value deviates from the specified value, an error message
+     * will be generated.
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   // value must equal ["a"]
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask.const = {
+     *       paths: ["a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: optional google.protobuf.FieldMask const = 1;
+     */
+    const?: FieldMaskJson;
+    /**
+     * `in` requires the field value to only contain paths matching specified
+     * values or their subpaths.
+     * If any of the field value's paths doesn't match the rule,
+     * an error message is generated.
+     * See: https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   //  The `value` FieldMask must only contain paths listed in `in`.
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask = {
+     *       in: ["a", "b", "c.a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string in = 2;
+     */
+    in?: string[];
+    /**
+     * `not_in` requires the field value to not contain paths matching specified
+     * values or their subpaths.
+     * If any of the field value's paths matches the rule,
+     * an error message is generated.
+     * See: https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   //  The `value` FieldMask shall not contain paths listed in `not_in`.
+     *   google.protobuf.FieldMask value = 1 [(buf.validate.field).field_mask = {
+     *       not_in: ["forbidden", "immutable", "c.a"]
+     *   }];
+     * }
+     * ```
+     *
+     * @generated from field: repeated string not_in = 3;
+     */
+    notIn?: string[];
+    /**
+     * `example` specifies values that the field may have. These values SHOULD
+     * conform to other rules. `example` values will not impact validation
+     * but may be used as helpful guidance on how to populate the given field.
+     *
+     * ```proto
+     * message MyFieldMask {
+     *   google.protobuf.FieldMask value = 1 [
+     *     (buf.validate.field).field_mask.example = { paths: ["a", "b"] },
+     *     (buf.validate.field).field_mask.example = { paths: ["c.a", "d"] },
+     *   ];
+     * }
+     * ```
+     *
+     * @generated from field: repeated google.protobuf.FieldMask example = 4;
+     */
+    example?: FieldMaskJson[];
+};
+/**
+ * Describes the message buf.validate.FieldMaskRules.
+ * Use `create(FieldMaskRulesSchema)` to create a new message.
+ */
+export declare const FieldMaskRulesSchema: GenMessage<FieldMaskRules, {
+    jsonType: FieldMaskRulesJson;
+}>;
 /**
- * TimestampRules describe the constraints applied exclusively to the `google.protobuf.Timestamp` well-known type.
+ * TimestampRules describe the rules applied exclusively to the `google.protobuf.Timestamp` well-known type.
  *
  * @generated from message buf.validate.TimestampRules
  */
@@ -7268,12 +7928,25 @@ export type TimestampRules = Message<"buf.validate.TimestampRules"> & {
      */
     within?: Duration;
     /**
+     * `example` specifies values that the field may have. These values SHOULD
+     * conform to other rules. `example` values will not impact validation
+     * but may be used as helpful guidance on how to populate the given field.
+     *
+     * ```proto
+     * message MyTimestamp {
+     *   google.protobuf.Timestamp value = 1 [
+     *     (buf.validate.field).timestamp.example = { seconds: 1672444800 },
+     *     (buf.validate.field).timestamp.example = { seconds: 1672531200 },
+     *   ];
+     * }
+     * ```
+     *
      * @generated from field: repeated google.protobuf.Timestamp example = 10;
      */
     example: Timestamp[];
 };
 /**
- * TimestampRules describe the constraints applied exclusively to the `google.protobuf.Timestamp` well-known type.
+ * TimestampRules describe the rules applied exclusively to the `google.protobuf.Timestamp` well-known type.
  *
  * @generated from message buf.validate.TimestampRules
  */
@@ -7403,6 +8076,19 @@ export type TimestampRulesJson = {
      */
     within?: DurationJson;
     /**
+     * `example` specifies values that the field may have. These values SHOULD
+     * conform to other rules. `example` values will not impact validation
+     * but may be used as helpful guidance on how to populate the given field.
+     *
+     * ```proto
+     * message MyTimestamp {
+     *   google.protobuf.Timestamp value = 1 [
+     *     (buf.validate.field).timestamp.example = { seconds: 1672444800 },
+     *     (buf.validate.field).timestamp.example = { seconds: 1672531200 },
+     *   ];
+     * }
+     * ```
+     *
      * @generated from field: repeated google.protobuf.Timestamp example = 10;
      */
     example?: TimestampJson[];
@@ -7411,10 +8097,12 @@ export type TimestampRulesJson = {
  * Describes the message buf.validate.TimestampRules.
  * Use `create(TimestampRulesSchema)` to create a new message.
  */
-export declare const TimestampRulesSchema: GenMessage<TimestampRules, TimestampRulesJson>;
+export declare const TimestampRulesSchema: GenMessage<TimestampRules, {
+    jsonType: TimestampRulesJson;
+}>;
 /**
  * `Violations` is a collection of `Violation` messages. This message type is returned by
- * protovalidate when a proto message fails to meet the requirements set by the `Constraint` validation rules.
+ * Protovalidate when a proto message fails to meet the requirements set by the `Rule` validation rules.
  * Each individual violation is represented by a `Violation` message.
  *
  * @generated from message buf.validate.Violations
@@ -7429,7 +8117,7 @@ export type Violations = Message<"buf.validate.Violations"> & {
 };
 /**
  * `Violations` is a collection of `Violation` messages. This message type is returned by
- * protovalidate when a proto message fails to meet the requirements set by the `Constraint` validation rules.
+ * Protovalidate when a proto message fails to meet the requirements set by the `Rule` validation rules.
  * Each individual violation is represented by a `Violation` message.
  *
  * @generated from message buf.validate.Violations
@@ -7446,18 +8134,51 @@ export type ViolationsJson = {
  * Describes the message buf.validate.Violations.
  * Use `create(ViolationsSchema)` to create a new message.
  */
-export declare const ViolationsSchema: GenMessage<Violations, ViolationsJson>;
+export declare const ViolationsSchema: GenMessage<Violations, {
+    jsonType: ViolationsJson;
+}>;
 /**
  * `Violation` represents a single instance where a validation rule, expressed
- * as a `Constraint`, was not met. It provides information about the field that
- * caused the violation, the specific constraint that wasn't fulfilled, and a
+ * as a `Rule`, was not met. It provides information about the field that
+ * caused the violation, the specific rule that wasn't fulfilled, and a
  * human-readable error message.
  *
+ * For example, consider the following message:
+ *
+ * ```proto
+ * message User {
+ *     int32 age = 1 [(buf.validate.field).cel = {
+ *         id: "user.age",
+ *         expression: "this < 18 ? 'User must be at least 18 years old' : ''",
+ *     }];
+ * }
+ * ```
+ *
+ * It could produce the following violation:
+ *
  * ```json
  * {
- *   "fieldPath": "bar",
- *   "constraintId": "foo.bar",
- *   "message": "bar must be greater than 0"
+ *   "ruleId": "user.age",
+ *   "message": "User must be at least 18 years old",
+ *   "field": {
+ *     "elements": [
+ *       {
+ *         "fieldNumber": 1,
+ *         "fieldName": "age",
+ *         "fieldType": "TYPE_INT32"
+ *       }
+ *     ]
+ *   },
+ *   "rule": {
+ *     "elements": [
+ *       {
+ *         "fieldNumber": 23,
+ *         "fieldName": "cel",
+ *         "fieldType": "TYPE_MESSAGE",
+ *         "index": "0"
+ *       }
+ *     ]
+ *   }
  * }
  * ```
  *
@@ -7489,9 +8210,9 @@ export type Violation = Message<"buf.validate.Violation"> & {
      */
     field?: FieldPath;
     /**
-     * `rule` is a machine-readable path that points to the specific constraint rule that failed validation.
-     * This will be a nested field starting from the FieldConstraints of the field that failed validation.
-     * For custom constraints, this will provide the path of the constraint, e.g. `cel[0]`.
+     * `rule` is a machine-readable path that points to the specific rule that failed validation.
+     * This will be a nested field starting from the FieldRules of the field that failed validation.
+     * For custom rules, this will provide the path of the rule, e.g. `cel[0]`.
      *
      * For example, consider the following message:
      *
@@ -7499,7 +8220,7 @@ export type Violation = Message<"buf.validate.Violation"> & {
      * message Message {
      *   bool a = 1 [(buf.validate.field).required = true];
      *   bool b = 2 [(buf.validate.field).cel = {
-     *     id: "custom_constraint",
+     *     id: "custom_rule",
      *     expression: "!this ? 'b must be true': ''"
      *   }]
      * }
@@ -7522,15 +8243,15 @@ export type Violation = Message<"buf.validate.Violation"> & {
      */
     rule?: FieldPath;
     /**
-     * `constraint_id` is the unique identifier of the `Constraint` that was not fulfilled.
-     * This is the same `id` that was specified in the `Constraint` message, allowing easy tracing of which rule was violated.
+     * `rule_id` is the unique identifier of the `Rule` that was not fulfilled.
+     * This is the same `id` that was specified in the `Rule` message, allowing easy tracing of which rule was violated.
      *
-     * @generated from field: optional string constraint_id = 2;
+     * @generated from field: optional string rule_id = 2;
      */
-    constraintId: string;
+    ruleId: string;
     /**
      * `message` is a human-readable error message that describes the nature of the violation.
-     * This can be the default error message from the violated `Constraint`, or it can be a custom message that gives more context about the violation.
+     * This can be the default error message from the violated `Rule`, or it can be a custom message that gives more context about the violation.
      *
      * @generated from field: optional string message = 3;
      */
@@ -7544,15 +8265,46 @@ export type Violation = Message<"buf.validate.Violation"> & {
 };
 /**
  * `Violation` represents a single instance where a validation rule, expressed
- * as a `Constraint`, was not met. It provides information about the field that
- * caused the violation, the specific constraint that wasn't fulfilled, and a
+ * as a `Rule`, was not met. It provides information about the field that
+ * caused the violation, the specific rule that wasn't fulfilled, and a
  * human-readable error message.
  *
+ * For example, consider the following message:
+ *
+ * ```proto
+ * message User {
+ *     int32 age = 1 [(buf.validate.field).cel = {
+ *         id: "user.age",
+ *         expression: "this < 18 ? 'User must be at least 18 years old' : ''",
+ *     }];
+ * }
+ * ```
+ *
+ * It could produce the following violation:
+ *
  * ```json
  * {
- *   "fieldPath": "bar",
- *   "constraintId": "foo.bar",
- *   "message": "bar must be greater than 0"
+ *   "ruleId": "user.age",
+ *   "message": "User must be at least 18 years old",
+ *   "field": {
+ *     "elements": [
+ *       {
+ *         "fieldNumber": 1,
+ *         "fieldName": "age",
+ *         "fieldType": "TYPE_INT32"
+ *       }
+ *     ]
+ *   },
+ *   "rule": {
+ *     "elements": [
+ *       {
+ *         "fieldNumber": 23,
+ *         "fieldName": "cel",
+ *         "fieldType": "TYPE_MESSAGE",
+ *         "index": "0"
+ *       }
+ *     ]
+ *   }
  * }
  * ```
  *
@@ -7584,9 +8336,9 @@ export type ViolationJson = {
      */
     field?: FieldPathJson;
     /**
-     * `rule` is a machine-readable path that points to the specific constraint rule that failed validation.
-     * This will be a nested field starting from the FieldConstraints of the field that failed validation.
-     * For custom constraints, this will provide the path of the constraint, e.g. `cel[0]`.
+     * `rule` is a machine-readable path that points to the specific rule that failed validation.
+     * This will be a nested field starting from the FieldRules of the field that failed validation.
+     * For custom rules, this will provide the path of the rule, e.g. `cel[0]`.
      *
      * For example, consider the following message:
      *
@@ -7594,7 +8346,7 @@ export type ViolationJson = {
      * message Message {
      *   bool a = 1 [(buf.validate.field).required = true];
      *   bool b = 2 [(buf.validate.field).cel = {
-     *     id: "custom_constraint",
+     *     id: "custom_rule",
      *     expression: "!this ? 'b must be true': ''"
      *   }]
      * }
@@ -7617,15 +8369,15 @@ export type ViolationJson = {
      */
     rule?: FieldPathJson;
     /**
-     * `constraint_id` is the unique identifier of the `Constraint` that was not fulfilled.
-     * This is the same `id` that was specified in the `Constraint` message, allowing easy tracing of which rule was violated.
+     * `rule_id` is the unique identifier of the `Rule` that was not fulfilled.
+     * This is the same `id` that was specified in the `Rule` message, allowing easy tracing of which rule was violated.
      *
-     * @generated from field: optional string constraint_id = 2;
+     * @generated from field: optional string rule_id = 2;
      */
-    constraintId?: string;
+    ruleId?: string;
     /**
      * `message` is a human-readable error message that describes the nature of the violation.
-     * This can be the default error message from the violated `Constraint`, or it can be a custom message that gives more context about the violation.
+     * This can be the default error message from the violated `Rule`, or it can be a custom message that gives more context about the violation.
      *
      * @generated from field: optional string message = 3;
      */
@@ -7641,7 +8393,9 @@ export type ViolationJson = {
  * Describes the message buf.validate.Violation.
  * Use `create(ViolationSchema)` to create a new message.
  */
-export declare const ViolationSchema: GenMessage<Violation, ViolationJson>;
+export declare const ViolationSchema: GenMessage<Violation, {
+    jsonType: ViolationJson;
+}>;
 /**
  * `FieldPath` provides a path to a nested protobuf field.
  *
@@ -7678,7 +8432,9 @@ export type FieldPathJson = {
  * Describes the message buf.validate.FieldPath.
  * Use `create(FieldPathSchema)` to create a new message.
  */
-export declare const FieldPathSchema: GenMessage<FieldPath, FieldPathJson>;
+export declare const FieldPathSchema: GenMessage<FieldPath, {
+    jsonType: FieldPathJson;
+}>;
 /**
  * `FieldPathElement` provides enough information to nest through a single protobuf field.
  *
@@ -7870,162 +8626,104 @@ export type FieldPathElementJson = {
  * Describes the message buf.validate.FieldPathElement.
  * Use `create(FieldPathElementSchema)` to create a new message.
  */
-export declare const FieldPathElementSchema: GenMessage<FieldPathElement, FieldPathElementJson>;
+export declare const FieldPathElementSchema: GenMessage<FieldPathElement, {
+    jsonType: FieldPathElementJson;
+}>;
 /**
- * Specifies how FieldConstraints.ignore behaves. See the documentation for
- * FieldConstraints.required for definitions of "populated" and "nullable".
+ * Specifies how `FieldRules.ignore` behaves, depending on the field's value, and
+ * whether the field tracks presence.
  *
  * @generated from enum buf.validate.Ignore
  */
 export declare enum Ignore {
     /**
-     * Validation is only skipped if it's an unpopulated nullable fields.
+     * Ignore rules if the field tracks presence and is unset. This is the default
+     * behavior.
+     *
+     * In proto3, only message fields, members of a Protobuf `oneof`, and fields
+     * with the `optional` label track presence. Consequently, the following fields
+     * are always validated, whether a value is set or not:
      *
      * ```proto
      * syntax="proto3";
      *
-     * message Request {
-     *   // The uri rule applies to any value, including the empty string.
-     *   string foo = 1 [
-     *     (buf.validate.field).string.uri = true
-     *   ];
-     *
-     *   // The uri rule only applies if the field is set, including if it's
-     *   // set to the empty string.
-     *   optional string bar = 2 [
-     *     (buf.validate.field).string.uri = true
+     * message RulesApply {
+     *   string email = 1 [
+     *     (buf.validate.field).string.email = true
      *   ];
-     *
-     *   // The min_items rule always applies, even if the list is empty.
-     *   repeated string baz = 3 [
-     *     (buf.validate.field).repeated.min_items = 3
+     *   int32 age = 2 [
+     *     (buf.validate.field).int32.gt = 0
      *   ];
-     *
-     *   // The custom CEL rule applies only if the field is set, including if
-     *   // it's the "zero" value of that message.
-     *   SomeMessage quux = 4 [
-     *     (buf.validate.field).cel = {/* ... *\/}
+     *   repeated string labels = 3 [
+     *     (buf.validate.field).repeated.min_items = 1
      *   ];
      * }
      * ```
      *
-     * @generated from enum value: IGNORE_UNSPECIFIED = 0;
-     */
-    UNSPECIFIED = 0,
-    /**
-     * Validation is skipped if the field is unpopulated. This rule is redundant
-     * if the field is already nullable.
+     * In contrast, the following fields track presence, and are only validated if
+     * a value is set:
      *
      * ```proto
-     * syntax="proto3
-     *
-     * message Request {
-     *   // The uri rule applies only if the value is not the empty string.
-     *   string foo = 1 [
-     *     (buf.validate.field).string.uri = true,
-     *     (buf.validate.field).ignore = IGNORE_IF_UNPOPULATED
-     *   ];
-     *
-     *   // IGNORE_IF_UNPOPULATED is equivalent to IGNORE_UNSPECIFIED in this
-     *   // case: the uri rule only applies if the field is set, including if
-     *   // it's set to the empty string.
-     *   optional string bar = 2 [
-     *     (buf.validate.field).string.uri = true,
-     *     (buf.validate.field).ignore = IGNORE_IF_UNPOPULATED
-     *   ];
+     * syntax="proto3";
      *
-     *   // The min_items rule only applies if the list has at least one item.
-     *   repeated string baz = 3 [
-     *     (buf.validate.field).repeated.min_items = 3,
-     *     (buf.validate.field).ignore = IGNORE_IF_UNPOPULATED
+     * message RulesApplyIfSet {
+     *   optional string email = 1 [
+     *     (buf.validate.field).string.email = true
      *   ];
-     *
-     *   // IGNORE_IF_UNPOPULATED is equivalent to IGNORE_UNSPECIFIED in this
-     *   // case: the custom CEL rule applies only if the field is set, including
-     *   // if it's the "zero" value of that message.
-     *   SomeMessage quux = 4 [
-     *     (buf.validate.field).cel = {/* ... *\/},
-     *     (buf.validate.field).ignore = IGNORE_IF_UNPOPULATED
+     *   oneof ref {
+     *     string reference = 2 [
+     *       (buf.validate.field).string.uuid = true
+     *     ];
+     *     string name = 3 [
+     *       (buf.validate.field).string.min_len = 4
+     *     ];
+     *   }
+     *   SomeMessage msg = 4 [
+     *     (buf.validate.field).cel = {/* ... *\/}
      *   ];
      * }
      * ```
      *
-     * @generated from enum value: IGNORE_IF_UNPOPULATED = 1;
-     */
-    IF_UNPOPULATED = 1,
-    /**
-     * Validation is skipped if the field is unpopulated or if it is a nullable
-     * field populated with its default value. This is typically the zero or
-     * empty value, but proto2 scalars support custom defaults. For messages, the
-     * default is a non-null message with all its fields unpopulated.
-     *
-     * ```proto
-     * syntax="proto3
-     *
-     * message Request {
-     *   // IGNORE_IF_DEFAULT_VALUE is equivalent to IGNORE_IF_UNPOPULATED in
-     *   // this case; the uri rule applies only if the value is not the empty
-     *   // string.
-     *   string foo = 1 [
-     *     (buf.validate.field).string.uri = true,
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE
-     *   ];
-     *
-     *   // The uri rule only applies if the field is set to a value other than
-     *   // the empty string.
-     *   optional string bar = 2 [
-     *     (buf.validate.field).string.uri = true,
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE
-     *   ];
-     *
-     *   // IGNORE_IF_DEFAULT_VALUE is equivalent to IGNORE_IF_UNPOPULATED in
-     *   // this case; the min_items rule only applies if the list has at least
-     *   // one item.
-     *   repeated string baz = 3 [
-     *     (buf.validate.field).repeated.min_items = 3,
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE
-     *   ];
+     * To ensure that such a field is set, add the `required` rule.
      *
-     *   // The custom CEL rule only applies if the field is set to a value other
-     *   // than an empty message (i.e., fields are unpopulated).
-     *   SomeMessage quux = 4 [
-     *     (buf.validate.field).cel = {/* ... *\/},
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE
-     *   ];
-     * }
-     * ```
+     * To learn which fields track presence, see the
+     * [Field Presence cheat sheet](https://protobuf.dev/programming-guides/field_presence/#cheat).
      *
-     * This rule is affected by proto2 custom default values:
+     * @generated from enum value: IGNORE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Ignore rules if the field is unset, or set to the zero value.
      *
-     * ```proto
-     * syntax="proto2";
+     * The zero value depends on the field type:
+     * - For strings, the zero value is the empty string.
+     * - For bytes, the zero value is empty bytes.
+     * - For bool, the zero value is false.
+     * - For numeric types, the zero value is zero.
+     * - For enums, the zero value is the first defined enum value.
+     * - For repeated fields, the zero is an empty list.
+     * - For map fields, the zero is an empty map.
+     * - For message fields, absence of the message (typically a null-value) is considered zero value.
      *
-     * message Request {
-     *   // The gt rule only applies if the field is set and it's value is not
-     *   the default (i.e., not -42). The rule even applies if the field is set
-     *   to zero since the default value differs.
-     *   optional int32 value = 1 [
-     *     default = -42,
-     *     (buf.validate.field).int32.gt = 0,
-     *     (buf.validate.field).ignore = IGNORE_IF_DEFAULT_VALUE
-     *   ];
-     * }
+     * For fields that track presence (e.g. adding the `optional` label in proto3),
+     * this a no-op and behavior is the same as the default `IGNORE_UNSPECIFIED`.
      *
-     * @generated from enum value: IGNORE_IF_DEFAULT_VALUE = 2;
+     * @generated from enum value: IGNORE_IF_ZERO_VALUE = 1;
      */
-    IF_DEFAULT_VALUE = 2,
+    IF_ZERO_VALUE = 1,
     /**
-     * The validation rules of this field will be skipped and not evaluated. This
-     * is useful for situations that necessitate turning off the rules of a field
-     * containing a message that may not make sense in the current context, or to
-     * temporarily disable constraints during development.
+     * Always ignore rules, including the `required` rule.
+     *
+     * This is useful for ignoring the rules of a referenced message, or to
+     * temporarily ignore rules during development.
      *
      * ```proto
      * message MyMessage {
-     *   // The field's rules will always be ignored, including any validation's
+     *   // The field's rules will always be ignored, including any validations
      *   // on value's fields.
      *   MyOtherMessage value = 1 [
-     *     (buf.validate.field).ignore = IGNORE_ALWAYS];
+     *     (buf.validate.field).ignore = IGNORE_ALWAYS
+     *   ];
      * }
      * ```
      *
@@ -8034,18 +8732,18 @@ export declare enum Ignore {
     ALWAYS = 3
 }
 /**
- * Specifies how FieldConstraints.ignore behaves. See the documentation for
- * FieldConstraints.required for definitions of "populated" and "nullable".
+ * Specifies how `FieldRules.ignore` behaves, depending on the field's value, and
+ * whether the field tracks presence.
  *
  * @generated from enum buf.validate.Ignore
  */
-export type IgnoreJson = "IGNORE_UNSPECIFIED" | "IGNORE_IF_UNPOPULATED" | "IGNORE_IF_DEFAULT_VALUE" | "IGNORE_ALWAYS";
+export type IgnoreJson = "IGNORE_UNSPECIFIED" | "IGNORE_IF_ZERO_VALUE" | "IGNORE_ALWAYS";
 /**
  * Describes the enum buf.validate.Ignore.
  */
 export declare const IgnoreSchema: GenEnum<Ignore, IgnoreJson>;
 /**
- * WellKnownRegex contain some well-known patterns.
+ * KnownRegex contains some well-known patterns.
  *
  * @generated from enum buf.validate.KnownRegex
  */
@@ -8068,7 +8766,7 @@ export declare enum KnownRegex {
     HTTP_HEADER_VALUE = 2
 }
 /**
- * WellKnownRegex contain some well-known patterns.
+ * KnownRegex contains some well-known patterns.
  *
  * @generated from enum buf.validate.KnownRegex
  */
@@ -8081,25 +8779,25 @@ export declare const KnownRegexSchema: GenEnum<KnownRegex, KnownRegexJson>;
  * Rules specify the validations to be performed on this message. By default,
  * no validation is performed against a message.
  *
- * @generated from extension: optional buf.validate.MessageConstraints message = 1159;
+ * @generated from extension: optional buf.validate.MessageRules message = 1159;
  */
-export declare const message: GenExtension<MessageOptions, MessageConstraints>;
+export declare const message: GenExtension<MessageOptions, MessageRules>;
 /**
  * Rules specify the validations to be performed on this oneof. By default,
  * no validation is performed against a oneof.
  *
- * @generated from extension: optional buf.validate.OneofConstraints oneof = 1159;
+ * @generated from extension: optional buf.validate.OneofRules oneof = 1159;
  */
-export declare const oneof: GenExtension<OneofOptions, OneofConstraints>;
+export declare const oneof: GenExtension<OneofOptions, OneofRules>;
 /**
  * Rules specify the validations to be performed on this field. By default,
  * no validation is performed against a field.
  *
- * @generated from extension: optional buf.validate.FieldConstraints field = 1159;
+ * @generated from extension: optional buf.validate.FieldRules field = 1159;
  */
-export declare const field: GenExtension<FieldOptions, FieldConstraints>;
+export declare const field: GenExtension<FieldOptions, FieldRules>;
 /**
- * Specifies predefined rules. When extending a standard constraint message,
+ * Specifies predefined rules. When extending a standard rule message,
  * this adds additional CEL expressions that apply when the extension is used.
  *
  * ```proto
@@ -8116,7 +8814,7 @@ export declare const field: GenExtension<FieldOptions, FieldConstraints>;
  * }
  * ```
  *
- * @generated from extension: optional buf.validate.PredefinedConstraints predefined = 1160;
+ * @generated from extension: optional buf.validate.PredefinedRules predefined = 1160;
  */
-export declare const predefined: GenExtension<FieldOptions, PredefinedConstraints>;
+export declare const predefined: GenExtension<FieldOptions, PredefinedRules>;
 //# sourceMappingURL=validate_pb.d.ts.map