webpb 0.0.36 → 0.0.39

package/dist/index.d.ts

@@ -15,6 +15,19 @@ export interface WebpbMeta {
 	context: string;
 	path: string;
 }
+export interface WebpbValidationRule {
+	required?: boolean;
+	notBlank?: boolean;
+	minLen?: number;
+	maxLen?: number;
+	min?: number | string;
+	max?: number | string;
+	pattern?: string;
+	patternFlags?: string;
+	email?: boolean;
+	valid?: boolean;
+}
+export type WebpbValidation = Record<string, WebpbValidationRule>;
 export declare function assign(src: unknown, dest: unknown, excludes?: readonly string[]): void;
 export declare function getter(data: unknown, path: string): unknown;
 export declare function query(pre: string, params: {

package/package.json

@@ -37,5 +37,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.36"
+  "version": "0.0.39"
 }

package/proto/webpb/WebpbExtend.proto

@@ -14,6 +14,7 @@ message FileOpts {
   optional OptFileOpts opt = 1000;
   optional JavaFileOpts java = 1001;
   optional TsFileOpts ts = 1002;
+  optional GoFileOpts go = 1003;
 }
 
 message OptFileOpts {
@@ -26,6 +27,26 @@ message JavaFileOpts {
   repeated string annotation = 1003;
   repeated string field_annotation = 1004;
   repeated string repeatable_annotation = 1005;
+  // Maps language-agnostic (opts).opt.valid constraints to Java annotations.
+  // File-level value overrides the shared WebpbOptions.proto defaults;
+  // unset templates fall back to the generator built-ins (jakarta.validation).
+  // Placeholders: {{value}} for single-value constraints,
+  // {{min}}/{{max}} for the size interval, {{flags}} for pattern flags.
+  optional JavaValidationMapping validation = 1006;
+}
+
+// Template set for rendering FieldValidation into Java annotations.
+// Example: size_template = "@Size(min = {{min}}, max = {{max}})"
+// renders {min_len: 1} as "@Size(min = 1)".
+message JavaValidationMapping {
+  optional string required_template = 1;
+  optional string not_blank_template = 2;
+  optional string size_template = 3;
+  optional string min_template = 4;
+  optional string max_template = 5;
+  optional string pattern_template = 6;
+  optional string email_template = 7;
+  optional string valid_template = 8;
 }
 
 message TsFileOpts {
@@ -39,6 +60,65 @@ message TsFileOpts {
   optional bool enum_by_value = 1007;
   optional bool enum_helpers = 1008;
   optional string enum_emit_mode = 1009;
+  // Maps language-agnostic (opts).opt.valid constraints to TS decorators
+  // (class-validator style by default). Same override chain as Java.
+  // Placeholders: {{value}}, {{min}}/{{max}}, {{flags}}.
+  optional TsValidationMapping validation = 1010;
+  // Emit a framework-neutral validation descriptor per message:
+  //   export const XxxValidation = { field: { minLen: 1, ... } } as const;
+  // Usage sites bridge it to zod / class-validator / form libs themselves,
+  // so generated code stays dependency-free (no zod/class-validator import,
+  // no experimentalDecorators). Only constraints actually declared are
+  // included; fields without constraints are omitted.
+  optional bool validation_object = 1011 [default = false];
+  // Emit class-validator decorators from `validation` templates. Default
+  // false: decorators require experimentalDecorators plus the
+  // class-validator dependency at the usage site.
+  optional bool validation_decorators = 1012 [default = false];
+}
+
+// Template set for rendering FieldValidation into TS decorators.
+// String length uses length/min_length/max_length; repeated/map size uses
+// array_min_size/array_max_size. The generator picks by field cardinality.
+message TsValidationMapping {
+  optional string required_template = 1;
+  optional string not_blank_template = 2;
+  optional string length_template = 3;
+  optional string min_length_template = 4;
+  optional string max_length_template = 5;
+  optional string array_min_size_template = 6;
+  optional string array_max_size_template = 7;
+  optional string min_template = 8;
+  optional string max_template = 9;
+  optional string pattern_template = 10;
+  optional string email_template = 11;
+  optional string valid_template = 12;
+}
+
+message GoFileOpts {
+  repeated string import = 1000;
+  optional bool int64_as_string = 1001;
+  optional bool auto_alias = 1002;
+  optional bool enum_auto_alias = 1003;
+  // Overrides the generated Go package name (defaults to the plugin parameter).
+  optional string package = 1004;
+  // Maps language-agnostic (opts).opt.valid constraints to
+  // go-playground/validator tag fragments joined by comma
+  // into `validate:"..."`. Placeholders: {{value}}.
+  optional GoValidationMapping validation = 1005;
+}
+
+// Template set for rendering FieldValidation into Go validator tag fragments.
+message GoValidationMapping {
+  optional string required_template = 1;
+  optional string not_blank_template = 2;
+  optional string min_len_template = 3;
+  optional string max_len_template = 4;
+  optional string min_template = 5;
+  optional string max_template = 6;
+  optional string pattern_template = 7;
+  optional string email_template = 8;
+  optional string valid_template = 9;
 }
 
 // message options
@@ -50,6 +130,7 @@ message MessageOpts {
   optional OptMessageOpts opt = 1000;
   optional JavaMessageOpts java = 1001;
   optional TsMessageOpts ts = 1002;
+  optional GoMessageOpts go = 1003;
 }
 
 message OptMessageOpts {
@@ -79,6 +160,12 @@ message TsMessageOpts {
   optional bool auto_alias = 1000;
 }
 
+message GoMessageOpts {
+  optional bool auto_alias = 1000;
+  // Emit a Go interface implemented by this message (for polymorphism).
+  optional string implements_interface = 1001;
+}
+
 // enum options
 extend google.protobuf.EnumOptions {
   optional EnumOpts e_opts = 1000;
@@ -88,6 +175,7 @@ message EnumOpts {
   optional OptEnumOpts opt = 1000;
   optional JavaEnumOpts java = 1001;
   optional TsEnumOpts ts = 1002;
+  optional GoEnumOpts go = 1003;
 }
 
 message OptEnumOpts {
@@ -109,6 +197,10 @@ message TsEnumOpts {
   optional string enum_emit_mode = 1007;
 }
 
+message GoEnumOpts {
+  optional bool auto_alias = 1000;
+}
+
 // field options
 extend google.protobuf.FieldOptions {
   optional FieldOpts opts = 1000;
@@ -118,11 +210,41 @@ message FieldOpts {
   optional OptFieldOpts opt = 1000;
   optional JavaFieldOpts java = 1001;
   optional TsFieldOpts ts = 1002;
+  optional GoFieldOpts go = 1003;
 }
 
 message OptFieldOpts {
   optional bool omitted = 1000;
   optional bool in_query = 1001;
+  // Language-agnostic validation constraints. The generators render them
+  // into per-language annotations/decorators/tags using the
+  // Java/Ts/GoValidationMapping templates. Explicit proto presence
+  // (e.g. `required` keyword, proto2 required vs proto3 optional) does not
+  // imply validation; set valid.required explicitly when needed.
+  optional FieldValidation valid = 1002;
+}
+
+// Language-agnostic field validation. min_len/max_len cover both string
+// length and repeated/map size (merged by design); the generators pick the
+// target spelling (@Size vs @Length/@ArrayMinSize vs min=/max=) from context.
+message FieldValidation {
+  optional bool required = 1;
+  optional bool not_blank = 2;
+  optional int64 min_len = 3;
+  optional int64 max_len = 4;
+  // Numeric bounds as strings so int64 and double share one schema
+  // without precision loss; the Java generator picks @Min/@Max for
+  // integral fields and @DecimalMin/@DecimalMax for floating point ones.
+  optional string min = 5;
+  optional string max = 6;
+  // Regular expression without surrounding slashes.
+  optional string pattern = 7;
+  // Regex flags, e.g. "i" or "CASE_INSENSITIVE". Rendered via the
+  // {{flags}} placeholder of the per-language pattern template.
+  optional string pattern_flags = 8;
+  optional bool email = 9;
+  // Cascaded validation for message / repeated message fields.
+  optional bool valid = 10;
 }
 
 message JavaFieldOpts {
@@ -137,6 +259,14 @@ message TsFieldOpts {
   optional bool auto_alias = 1002;
 }
 
+message GoFieldOpts {
+  optional bool as_string = 1000;
+  optional string alias = 1001;
+  optional bool auto_alias = 1002;
+  // Skip the field in generated structs (e.g. handled by another message).
+  optional bool omitted = 1003;
+}
+
 // enum value options
 extend google.protobuf.EnumValueOptions {
   optional EnumValueOpts v_opts = 1000;
@@ -146,6 +276,7 @@ message EnumValueOpts {
   optional OptEnumValueOpts opt = 1000;
   optional JavaEnumValueOpts java = 1001;
   optional TsEnumValueOpts ts = 1002;
+  optional GoEnumValueOpts go = 1003;
 }
 
 message OptEnumValueOpts {
@@ -158,3 +289,6 @@ message JavaEnumValueOpts {
 
 message TsEnumValueOpts {
 }
+
+message GoEnumValueOpts {
+}

package/webpb-version.properties

@@ -1,2 +1,2 @@
-webpbVersion=0.0.36
+webpbVersion=0.0.39
 protobufVersion=4.36.1