Java target

Use the Java target for JVM consumers that need generated model classes with JSON and YAML helper behavior.

emit-targets:
  - type: Java
    output-dir: "generated/java"
    test-dir: "generated/java/tests"
    package-name: "typra.fixtures"
    protocol-scaffolds: "compile-only"
    native-serialization: "jackson"

Option	Why it matters
output-dir	Where generated Java source is written.
test-dir	Where generated Java tests are written.
package-name	Java package for generated classes.
protocol-scaffolds	Emits compile-only test scaffolds for generated protocols.
native-serialization	Defaults to "none". Set to "jackson" to emit Jackson serializers and deserializers that delegate to Typra load/save.

Preview — not production-ready

native-serialization: "jackson" interop is experimental. It is not yet idempotency-locked under the output hygiene guard, and its generated shape may still change. The production-ready Java output is the core model surface — load/save and the fromJson/toJson/fromYaml/toYaml helpers.

Generated Java surfaces include models with load, save, fromJson, toJson, fromYaml, toYaml, scalar coercion, enum handling, polymorphic dispatch, tests, and optional Jackson interop.

Typical usage shape

import typra.fixtures.FixtureRoot;

FixtureRoot root = FixtureRoot.fromJson(jsonText);
String saved = root.toJson();
FixtureRoot yamlRoot = FixtureRoot.fromYaml(yamlText);
String yamlSaved = yamlRoot.toYaml();

Confirm package layout and generated API shape before publishing Java output for downstream consumers.

native-serialization: "jackson" adds Jackson annotations plus generated serializer/deserializer classes. The emitter does not edit a consumer build manifest, so projects enabling this option must provide jackson-databind on their Java compile/runtime classpath.