A2UI v0.8 Ink wrapper MVP.
This library renders a minimal subset of A2UI components using Ink and React. It supports beginRendering, surfaceUpdate, dataModelUpdate, adjacency-list rendering, and basic user actions for input, selection, and buttons.
Use npm run demo to launch the sample surface renderer.
🌐 View the interactive demo site - Browse components, test the JSON playground, and see examples in action.
- A2UI v0.8 render gate: beginRendering, surfaceUpdate, dataModelUpdate
- Adjacency-list tree reconstruction with explicit children and template lists
- Data binding via
BoundValue(path + literal fallbacks) - Ink-backed components: Text, Box, Spacer, Input, Select, Button, Checkbox, RadioGroup, List, Tabs, Table, Slider, Modal, Divider, Image, Chart
- Focus management with Tab / Shift+Tab navigation
- Action dispatch: onPress, onChange, onSubmit, onSelect
- Create a renderer instance with
createA2uiInkRenderer. - Send A2UI server messages in this order:
- surfaceUpdate: component catalog and root ID
- dataModelUpdate: initial state
- beginRendering: unlock rendering
- Handle
userActioncallbacks to round-trip input back to your A2UI server.
Create the renderer, stream A2UI messages into handleMessage, and forward user actions back to your server.
Example flow:
surfaceUpdateprovides the component graph.dataModelUpdatesupplies initial data.beginRenderingallows the client to render.
Use the onUserAction callback to capture input and selection events.
Recommended entry points:
- Public API: src/index.ts
- Renderer core: src/renderer.ts
- Component registry: src/catalog.ts
- Binding and tree build: src/binding.ts and src/tree.ts
- Add more standard catalog components (checkbox, radio, list view, tabs)
- Styling parity improvements (alignment, borders, padding presets)
- Better input controls (multi-line input, validation, masking)
- Multi-surface support in a single process
- Performance tuning for large dynamic lists