Compose Adapters

The catalogued composables KBC can render today. IDs come from

dev.ketoy.bytecode.KBCAdapterIds. Standard adapter IDs are 0x0001–0x3FFF; app-specific are 0x4000+.

For the how-to (writing a new adapter, scan-roots directives, the KSP pipeline), see Custom Adapter.

Catalogued (fully routed end-to-end)

Every entry below is generated by the KSP processor reading adapter-scan-roots.txt. The runtime resolves these by ID; the compiler plugin uses ComposeAdapterCatalog (the KSP-emitted binary) to validate calls.

Reserved (IDs exist, not yet routed)

These IDs are reserved in KBCAdapterIds but adapter-scan-roots.txt doesn't include them. KBC source referencing them fails with UnregisteredComposable.

Adding any of these is the standard recipe:

1. Add a composable=<fq>:0x00XX line to adapter-scan-roots.txt.
2. Run ./gradlew :ketoy-adapters-material3:kspRelease.
3. Done. The generated adapter handles the rest.

KBCParamSet typed getters

When an adapter is invoked, the runtime hands you a KBCParamSet containing the decoded KBCValues for each slot. Use these typed getters (all of them safely return defaults when the slot is encoded as KBCValue.Default):

Use isDefaulted(idx) to honour a paramDefault= directive at the adapter level.

How adapter dispatch flows

KBC source        → @KetoyComposable Foo() { Text(text="hi", color=Color.Red, ...) }
       ↓ compiler plugin
KBC bytecode      → COMPOSABLE_CALL(0x0001, 2, [(0, StringLiteral(idx)), (2, ColorARGB(0xFFFF0000))])
       ↓ runtime
KBCInterpreter    → Decodes opcode, builds KBCParamSet from non-defaulted params,
                    asks adapter registry for id=0x0001
       ↓
KBCComposableAdapter.invoke(params) → resolves slots via getters → calls real Text(...)

Slots that aren't encoded resolve to their Compose source default (the paramDefault= directive overrides this when set).

Next: Constructor Adapters →