Compatibility matrix

Support is claimed only where automated tests exist. Prefer Wave A for production apps. Wave B and Wave C are Experimental.

Adapter packages

FrameworkPackageWaveClaimed capabilitiesPeer
React@sometic/reactAbutton, field, input, form, selection, overlay, auth, http, storereact ^18 || ^19
Vue@sometic/vueAbutton, field, input, form, selection, overlay, auth, http, storevue ^3.5
Vanilla / WC@sometic/elements (+ @sometic/dom)Asometic-* elements: button, input, form, selection, overlay, auth, eventsnone (browser CE)
Angular@sometic/angularB ExperimentalstoreBind@angular/core ^19 (optional peer)
Svelte@sometic/svelteB ExperimentalstoreBindsvelte ^5 (optional peer)
Solid@sometic/solidB ExperimentalstoreBindsolid-js ^1.8 (optional peer)
Preact@sometic/preactB ExperimentalstoreBindpreact ^10 (optional peer)
Alpine.js@sometic/alpineC ExperimentalstoreBind, buttonalpinejs ^3.14 (optional peer)
jQuery@sometic/jqueryC ExperimentalstoreBind, buttonjquery ^3.7 (optional peer)
HTMX@sometic/htmxC ExperimentalstoreBind, buttonhtmx.org ^2 (optional peer)

Import maps (Wave A)

@sometic/react / @sometic/vue

SubpathTypical exports
@sometic/{react|vue}/buttonButton, IconButton, ToggleButton, ButtonGroup, AsyncButton
@sometic/{react|vue}/fieldField
@sometic/{react|vue}/inputInput, PasswordInput, OtpInput, NumberInput, FileInput, MaskedInput, CurrencyInput, DateInput
@sometic/{react|vue}/formForm, FormProvider, useForm, useFormContext, useFormField, useFormState, useFieldArray
@sometic/{react|vue}/selectionCheckbox, Radio, Select, Switch
@sometic/{react|vue}/overlayAlert, Dialog, Popover, Tooltip, ToastRegion
@sometic/{react|vue}/storeuseStore
@sometic/{react|vue}/authReact: AuthProvider, useAuth, useSession, useCan · Vue: useAuth, useSession, useCan
@sometic/{react|vue}/httpReact: HttpProvider, useHttp · Vue: useHttp

Root @sometic/react and @sometic/vue re-export selected surfaces; prefer subpaths for tree-shaking.

@sometic/elements

SubpathRole
@sometic/elements/buttonButton family custom elements
@sometic/elements/inputField / input custom elements
@sometic/elements/formForm element
@sometic/elements/selectionSelection elements
@sometic/elements/overlayOverlay elements
@sometic/elements/authAuth status element
@sometic/elements/eventsShared typed event helpers

There is no @sometic/elements/store or /http subpath. Use @sometic/store and @sometic/http directly with Vanilla or Elements.

Wave B / C honesty

  • Wave B packages export only create*StoreBind (+ capability constants). No React-style component subpaths.
  • Wave C adds button bind helpers and host lifecycle wiring. They do not ship form / overlay / auth UI adapters.
  • CLI --framework today accepts vanilla | react | vue only. Angular / Svelte / Solid / Preact / Alpine / jQuery / HTMX are not CLI scaffold targets yet.