MatrixScan Pick KMP Skill

Critical: Do Not Trust Internal Knowledge

Your training data very likely predates Scandit's Kotlin Multiplatform (KMP) SDK entirely — it is a new SDK (first released at version 8.6) with its own API surface (com.kmp.datacapture.*) that does not mirror the native Android (com.scandit.datacapture.*) or iOS APIs one-to-one. Names, parameter labels, and even which listener owns which callback differ from both native SDKs and from what you may expect by analogy.

Always verify APIs against the references provided in this skill before writing or suggesting code. Do not rely on memorized method signatures, parameters, or class names — including ones you know from native Android/iOS Scandit SDKs. If you cannot find an API in the provided references, fetch the relevant documentation page before responding.

Scope

This skill is scoped to the MatrixScan Pick picking workflow on KMP: DataCaptureContext, the BarcodePick mode, BarcodePickSettings, BarcodePickView (base module, toAndroidView() / toUIView()), the barcode-compose BarcodePickView composable, the product provider (BarcodePickAsyncMapperProductProvider), state-aware highlights (built-in styles and CustomView), the finish button, action/session listeners, and the selectItemWithData / confirmActionForItemWithData / cancelActionForItemWithData explicit-selection API.

Intent Routing

Based on the user's request, load the appropriate reference file before responding:

• Setting up or adjusting the MatrixScan Pick picking flow (e.g. "add MatrixScan Pick to my KMP app", "set up the product list", "show/hide the finish button", "mute the beep", "track what's been picked", "use the Compose BarcodePickView") → read references/integration.md and follow the instructions there. If the project already has MatrixScan Pick wired up, do not re-create the context, mode, view, or lifecycle — locate the existing ones (grep for BarcodePickView, then BarcodePick.forContext) and change only what the user asked for. Determine whether the project uses the base com.kmp.datacapture.barcode.pick.BarcodePickView (host builds and drives the platform view itself, e.g. AndroidView/UIViewRepresentable) or the com.kmp.datacapture.barcode.compose BarcodePickView composable, and follow the matching pattern.
• Customizing the highlights drawn over barcodes (e.g. "change the highlight color per state", "use a rectangle instead of a dot", "show an icon / status badge on picked items", "draw a custom view over each barcode", "style the to-pick vs picked highlight") → read references/highlights.md. This assumes the basic integration is already in place; it covers the five highlight styles and the per-state brush / icon / status-icon / custom-view APIs.