API reference
This section is a navigation hub, not a generated per-symbol reference. Hand-written guides under Components, Forms, Stores, Theming, Authentication, Primitives, and Services explain usage. Package .d.ts files remain the source of truth for exact TypeScript signatures.
How to use these docs
- Find the package and maturity label in the Package index.
- Open the linked live guide for that domain.
- Confirm prop and function details against the installed package types in your editor.
Do not expect auto-generated pages for every export. Prefer deep guides with examples, edge cases, and FAQs.
Start by domain
| Domain | Live docs | Typical packages |
|---|---|---|
| Stores | Stores, Store | @sometic/store, @sometic/store-immer |
| Theming | Theming | @sometic/theme |
| Authentication | Authentication | @sometic/auth, @sometic/auth-* |
| HTTP | HTTP, Services | @sometic/http |
| Components | Components | @sometic/react/*, @sometic/vue/*, @sometic/elements/* |
| Forms | Forms | @sometic/forms, @sometic/validation |
| Primitives | Primitives | core, events, styling, accessibility, dom, date-* |
| Frameworks | Frameworks | adapter packages |
| Concepts | Architecture and siblings | cross-cutting |
Stability labels
| Label | Meaning |
|---|---|
| Beta | Usable and tested; breaking changes may land in 0.x with changelog notes |
| Experimental | Wave B/C adapters and incomplete contracts; prefer React / Vue / Elements for production |
| Deferred | Later-phase catalogs (for example multi-select polish, date picker UI, data tables) |
Full wording: Beta maturity.
Shared prop conventions
Where a surface exposes value or style hooks, prefer these names:
value, defaultValue, onValueChange, disabled, readonly, required, invalid, loading, unstyled, classes, styles, cssVariables, size, variant
Controlled detection and ownership rules: Controlled state, Uncontrolled state.
Errors
Public failures use typed SometicError with stable codes (isSometicError helpers). Do not rely on legacy error class names from earlier product identity. See Beta maturity and Changelog.
What is not documented as shipped
The following are Deferred for this beta and must not be treated as public catalog APIs:
- Menu
- Combobox
- Drawer
- Tabs / Accordion / Command Palette / Tree catalogs
- App primitives such as feature flags or offline queues (later roadmap)
Select, Popover, Dialog, and Toast are not substitutes for Menu or Combobox.