Packages
Published JavaScript and native package topology.
v0.1 publishes JavaScript packages plus optional native compiler packages. The
native packages are installed through @naos-ui/compiler.
JavaScript Packages
| Package | Purpose | Stability |
|---|---|---|
@naos-ui/core | Public authoring types and primitives. | Preview |
@naos-ui/runtime | Tiny generated-code helper runtime. | Preview |
@naos-ui/primitives | Naos-authored primitive Web Components. | Experimental |
@naos-ui/router | Optional platform router for Custom Element app shells. | Preview |
@naos-ui/data | Platform-native data resources (fetch and subscriptions). | Experimental |
@naos-ui/data-convex | Optional Convex adapter for data resources. | Experimental |
@naos-ui/motion | Framework-free motion primitives and tokens. | Experimental |
@naos-ui/testing | Mount, flush, and inspect helpers for component tests. | Experimental |
@naos-ui/compiler | Node boundary and native loader. | Preview |
@naos-ui/vite | Vite plugin. | Preview |
@naos-ui/cli | Minimal compile, prerender, and info binary. | Preview |
Stability Tiers
All packages are pre-1.0 and follow a shared expectation per tier:
- Preview packages have a settled shape. Breaking changes are still possible before 1.0, but they are deliberate, documented in release notes, and avoided in patch releases.
- Experimental packages are under active design. Their APIs may change in any release while the underlying model is validated; pin exact versions if you depend on them.
No package is marked stable before 1.0. A tier applies to a package's documented public API; internal modules carry no compatibility expectation.
Native Packages
| Package | Platform |
|---|---|
@naos-ui/compiler-darwin-arm64 | macOS arm64 |
@naos-ui/compiler-darwin-x64 | macOS x64 |
@naos-ui/compiler-linux-arm64-gnu | Linux arm64 glibc |
@naos-ui/compiler-linux-arm64-musl | Linux arm64 musl |
@naos-ui/compiler-linux-x64-gnu | Linux x64 glibc |
@naos-ui/compiler-linux-x64-musl | Linux x64 musl |
@naos-ui/compiler-win32-arm64-msvc | Windows arm64 MSVC |
@naos-ui/compiler-win32-x64-msvc | Windows x64 MSVC |
The loader resolution order is environment override, installed optional package, workspace-local binding, then a clear unsupported or missing-dependency error. Contributor source builds remain local development workflows only.