bufbuild · timostamm · Sep 3, 2026 · Sep 9, 2026
diff --git a/packages/example/README.md b/packages/example/README.md
@@ -50,3 +50,7 @@ If you modify the rules of one of the Protobuf messages, make sure to re-generat
 
 With the [Buf CLI](https://github.com/bufbuild/buf), simply run `npx buf generate` in this directory. [`buf.gen.yaml`](./buf.gen.yaml)
 contains the plugin configuration.
+
+Note that this example does not generate code for `buf/validate/validate.proto`, even though its Protobuf files
+import it. Instead, the plugin option [`map_imports`](https://protobufes.com/reference/plugin-options/#map_imports) points the generated imports at the code that
+`@bufbuild/protovalidate` already ships as `@bufbuild/protovalidate/gen/buf/validate/validate_pb.js`.
diff --git a/packages/example/buf.gen.yaml b/packages/example/buf.gen.yaml
@@ -11,6 +11,8 @@ plugins:
       - target=ts
       # This option enables Valid types
       - valid_types=protovalidate_required+legacy_required
+      # Use the validate.proto artifacts exported by @bufbuild/protovalidate
+      # instead of generating a local copy. This requires
+      # @bufbuild/protoc-gen-es v2.15.0 or later.
+      - map_imports=buf/validate/:@bufbuild/protovalidate/gen
     out: src/gen
-    # Also generate any imported dependencies
-    include_imports: true
diff --git a/packages/example/src/gen/banking/v1/money_transfer_pb.ts b/packages/example/src/gen/banking/v1/money_transfer_pb.ts
diff --git a/packages/example/src/gen/buf/validate/validate_pb.ts b/packages/example/src/gen/buf/validate/validate_pb.ts
diff --git a/packages/example/src/gen/store/v1/order_pb.ts b/packages/example/src/gen/store/v1/order_pb.ts