# Changelog

All notable changes to `MOZA_SDK` will be documented in this file.

This file follows a Keep a Changelog style structure.

## [1.0.0.4] - 2026-07-07 Initial Public Release

### Added

- Initial public C API in `include/moza/moza.h`.
- Initial public C++ wrapper API in `include/moza/moza.hpp`.
- SDK initialization, version query, and shutdown support.
- Device discovery, device information query, device open, and device close support.
- Public device information structure including `portName`, device category, type, state, and HID count.
- Parameter discovery APIs by name, ID, and full list.
- Parameter fetch, cached get, set, and synchronous timeout APIs.
- Command discovery APIs by name, ID, and full list.
- Command send and synchronous timeout APIs.
- Unified command and parameter value passing through `MOZA_VALUE`, including `MOZA_VT_LIST` for multiple command arguments.
- HID device list, open, close, and input-state snapshot APIs.
- HID state helper utilities for button state inspection.
- Global event callback support.
- Device connection and disconnection events.
- Parameter value changed and parameter error events.
- Command replied and command error events.
- HID axis and HID button events.
- Configurable HID axis event minimum dispatch interval.
- Public error codes for common SDK, device, HID, timeout, pending, and asynchronous states.
- Dedicated public error codes for parameter read-command and write-command failures.
- Developer documentation in Chinese and English.
- API reference documentation in Chinese and English.
- Wheelbase force feedback command guide in Chinese and English.
- SDK debug tool guidance for inspecting available commands and parameters.

### Notes

- `ApiDebugTool.exe` is included as part of the SDK package and can be used to inspect available commands and parameters, as well as validate command and parameter behavior during integration.
- Event callback payload pointer fields are valid only during the callback and should be copied if the application needs to retain them.
