[robdobsn]

Device type management from raftjs and a web UI, as in devdocs/device-type-management-web-plan.md (phases 2–6). Pairs with robdobsn/RaftCore#18: the firmware's new status fields, _sources, the shared test vectors, and the Pages workflow that publishes the catalogue and this app.

Library (new modules, exported from main.ts)

TypeScript copies of RaftCore's Python device type tools. They give the same output and are checked against RaftCore's shared vectors (copied into testdata/).

• RaftDeviceTypeJson: JSON as Python reads and writes it.
  • JSON.parse would reorder integer-like keys (LSM6DS3's rate map), and JavaScript writes floats differently from Python.
  • With this module a type file built here is byte for byte the Python's, so the device's CRC agrees.
• RaftDeviceTypeGrammar: the command grammar.
• RaftDeviceTypeFile: buildTypeFile and typeFileCrc.
• RaftDeviceTypeSources: DeviceTypeSources.json merging, selection rules and provenance.
• RaftDeviceTypeCatalogue: readers for RaftCore's catalogue on GitHub Pages, git sources on GitHub (via its API at the resolved commit), and local record files; plus the lock file writer.
• RaftDeviceTypeFileManager: status, type table, device records, pull, and push (upload, check, confirm, apply, wait for the restart, verify).
• RaftDeviceManager types: raftCore, recordFormat, decode and protected, all optional.

App (apps/devtypes)

React and Parcel. Tabs: Catalogue, Device, Sources, Type file, Export.

• Connects by Bluetooth or serial. WiFi is offered only on http pages and localhost, because an https page can't open ws:// to a device.

Testing

• raftjs: 370 tests pass. The every-record vector (63.7 KB) is built byte for byte. tsc (web and React Native) and eslint are clean.
  • One test is skipped when the RaftCore checkout next to raftjs lacks the vectors, i.e. before RaftCore#18 is merged. Against that branch it runs and passes.
• App, in headless Chrome against a local copy of the site:
  • catalogue, search, selection and export work; phone width works;
  • importing a selection (RaftCore records, a live GitHub git source, local records, an exclude and two policies) gave the same type file (CRC 9796) and lock as AssembleDeviceTypes.py --typefile;
  • building the exported zip with the Python tool gave the same file again.
• Not yet checked on hardware: connecting, the Device tab, push and pull.

Not in this PR

• The dashboard's TypeFilePanel still has its own steps. Moving it onto DeviceTypeFileManager is left for later.

🤖 Generated with Claude Code