[BUG][DART] PATCH tri-state optional handling

[radelcom]

Summary

Adds minimal PATCH tri-state handling for dart-dio with built_value serialization.

This fixes the PATCH case where the generator needs to preserve three distinct states for nullable fields:

• absent
• present with null
• present with a value

The PR is intentionally scoped to the serialization path only to keep review risk low.

Changes

• mark models with wrapped optional PATCH properties using x-has-optional-properties
• export optional.dart when useOptional=true
• import optional.dart in generated built_value models when needed
• initialize wrapped fields with Optional.absent()
• serialize wrapped fields only when object.field.isPresent
• emit null when the present wrapped value is null
• use unwrapped datatype metadata for serializer typing

Validation

Validated locally with:

./mvnw clean package -DskipTests

Build result: success.

Also validated by generating a Dart Dio sample from the built CLI jar. Generation completed successfully.

./mvnw clean package with tests enabled hit unrelated existing Kotlin Spring test failures on the local Java 25 environment, so this PR was validated through successful package build and Dart generation behavior.

How to validate

1. Build the project:

./mvnw clean package -DskipTests

2. Generate a Dart Dio client.
3. Confirm wrapped PATCH fields:

• default to Optional.absent()
• are omitted when absent
• serialize as key: null for Optional.present(null)
• serialize as key: value for Optional.present(value)

/cc @wing328 @jaumard

---

Summary by cubic

Fixes PATCH tri-state handling in dart-dio with built_value, so optional fields correctly support absent, present-null, and present-value. Prevents PATCH payloads from dropping keys or mis-serializing nulls.

• Bug Fixes
  • Wrap optional PATCH fields in Optional and default to Optional.absent().
  • Serialize keys only when isPresent; emit null for present-with-null.
  • Export optional.dart when useOptional=true; import it only for models with x-has-optional-properties. Also avoid whitespace-only churn in the class template.
  • Use unwrapped datatypes in serializer FullType to avoid leaking Optional.

^{Written for commit 6c2ac87. Summary will update on new commits.}

[cubic-dev-ai]

No issues found across 6 files

[wing328]

cc @jaumard (2018/09) @josh-burton (2019/12) @amondnet (2019/12) @sbu-WBT (2020/12) @kuhnroyal (2020/12) @agilob (2020/12) @ahmednfwela (2021/08)