Add option to encode only non-null default values in encodeDefaults

[jschneider]

Currently, encodeDefaults = true writes all default values, while encodeDefaults = false omits all of them.
There is no way to include only non-null defaults.

Motivation

In many API contexts, it is desirable to serialize default values that carry meaningful information but skip those that are null by default.
This keeps payloads compact and avoids sending meaningless null entries while still preserving useful defaults.

@Serializable
data class UserProfile(
  val id: String,
  val nickname: String?,
  val displayName: String? = null,
  val country: String = "DE",
  val avatarUrl: String? = null,
)

Rationale:

This would allow developers to keep meaningful defaults (like "DE") while automatically skipping null defaults, avoiding the need for custom serializers or post-processing.

[sandwwraith]

Does

Json {
    encodeDefaults = true
    explicitNulls = false
}

achieve what you want?

[jschneider]

Of course! Thanks!
Didn't even try this combination. Just assumed that the default nulls are also serialized!

But of course it works.

[jschneider]

I am wrong! It does not work in every case.
I want to add "null" for all values that do not have a default value set.

Unfortunately I am not able to reopen the issue...

[sandwwraith]

I want to add "null" for all values that do not have a default value set.

Isn't this what explicitNulls do?

during decoding, the absence of a field value is treated as null for nullable properties without a default value.

https://kotlinlang.org/api/kotlinx.serialization/kotlinx-serialization-json/kotlinx.serialization.json/-json-builder/explicit-nulls.html

[jschneider]

The problem is my TypeScript client.

For TypeScript there are these possible types:

• Required (must be defined, must not be null)
• Optional (might be undefined - but not null)
• Nullable (might be null - but not undefined)
• Optional and Nullable (might be null or undefined).

Unfortunately I can not match these exact cases at the same time.

At the moment I have this mapping:

TS optional <-> Kotlin has default value
TS nullable <-> Kotlin nullable
TS optional + nullable <-> Kotlin nullable + has default value

[sandwwraith]

Can you show the TS example, please?