solid-baseui 0.1.0-alpha.2 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.0-alpha.3
+
+### Documentation
+
+- Replace the README warning banner with "WIP: An unofficial port of Base UI for
+  SolidJS" and use the same wording for the npm package description.
+- Refresh the Status section with the current release, all 38 implemented
+  component families, verification results, and development focus.
+- Simplify the alpha installation guidance.
+- Keep alpha.2 event-composition migration details in the changelog rather than
+  the README.
+
+No runtime, API, or dependency changes from alpha.2.
+
 ## 0.1.0-alpha.2
 
 ### Breaking Changes

package/README.md

@@ -1,10 +1,6 @@
 # solid-baseui
 
-> [!WARNING]
-> **Work in progress — alpha, unannounced, and not stable.**
-> Published to reserve the name and to be used in the author's own projects.
-> Expect breaking changes without notice, incomplete verification, and no
-> support. Do not adopt this in production.
+> WIP: An unofficial port of Base UI for SolidJS
 
 A native Solid 2 port of [Base UI](https://base-ui.com/). It preserves Base UI's
 observable behavior and accessibility contracts while replacing React-specific
@@ -15,8 +11,7 @@ maintained by MUI or the Base UI team, nor by the SolidJS core team.
 
 ## Install
 
-Install explicitly from the `alpha` dist-tag to get the current prerelease.
-There is no stable release:
+Install the current alpha release:
 
 ```bash
 bun add solid-baseui@alpha
@@ -166,54 +161,23 @@ root, `solid-baseui/use-render`, and `solid-baseui/types`.
 
 See [CHANGELOG.md](./CHANGELOG.md) for this alpha's changes.
 
-## Migrating To 0.1.0-alpha.2
-
-Version `0.1.0-alpha.2` changes the internal event-composition API to direct handlers:
-
-```tsx
-import type { JSX } from "@solidjs/web";
-import { omit } from "solid-js";
-import {
-  composeEventHandlers,
-  liveEventHandler,
-} from "solid-baseui/internals/composeEventHandlers";
-
-function CustomButton(props: JSX.ButtonHTMLAttributes<HTMLButtonElement>) {
-  const others = omit(props, "onClick");
-  const onClick = composeEventHandlers<HTMLButtonElement, MouseEvent>(
-    liveEventHandler(() => props.onClick),
-    (event) => event.preventBaseUIHandler(),
-  );
-  return <button type="button" onClick={onClick} {...others} />;
-}
-```
-
-Fixed handlers need no outer function. Use `liveEventHandler` only when a callback
-prop or handler selection can change; it creates a deferred source for the composer,
-not a standalone DOM handler. Sources resolve in order at event time, including
-Solid's `[handler, data]` tuples. Base UI cancellation stops later handlers and
-source resolution; native `preventDefault` has its separate meaning.
-
-This is a breaking change from alpha.1. Bare `() => handler` arguments must be
-converted to direct handlers or explicit live sources. Handler return values are
-ignored, so an old accessor can still typecheck without doing the intended work.
-
 ## Status
 
-All 38 component families in the pinned inventory are implemented and exported.
-The requested Tooltip, Combobox, Autocomplete, and Drawer verification is complete;
-the project is now in stabilization and performance optimization.
-
-Implementation coverage is not exhaustive Base UI 1.8 parity or production stability.
-The optional `unstable-use-media-query` utility is not implemented and is outside
-the 38-component scope.
-
-A component is only treated as done when its upstream Base UI test ledger is
-classified and represented in the Solid suite. Per-family status, the decisions
-that are not derivable from the code, and the verification runs behind each one
-live in [`knowledge/README.md`](./knowledge/README.md); the stable scope and test
-ledger live in
-[`BASE_UI_PORTING_INVENTORY.md`](./BASE_UI_PORTING_INVENTORY.md).
+| Area | Status |
+| --- | --- |
+| Current release | `0.1.0-alpha.3`, available from `solid-baseui@alpha` |
+| Components | All 38 component families implemented and exported |
+| Framework | Native Solid 2, using the RC.6 runtime and compiler |
+| Verification | Typecheck, lint, unit, SSR, hydration, and Chromium/Firefox/WebKit suites passing |
+| Current focus | Stabilization, performance, and real-application integrations |
+
+The latest release includes the completed Tooltip, Combobox, Autocomplete, and
+Drawer verification work. The optional `unstable-use-media-query` utility remains
+outside the 38-component scope and is not implemented.
+
+See [`knowledge/README.md`](./knowledge/README.md) for verification scope and
+remaining work, and [`BASE_UI_PORTING_INVENTORY.md`](./BASE_UI_PORTING_INVENTORY.md)
+for the upstream porting inventory.
 
 ## Solid API decisions
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "solid-baseui",
-  "version": "0.1.0-alpha.2",
-  "description": "A native Solid 2 port of Base UI. Alpha: unannounced and unstable.",
+  "version": "0.1.0-alpha.3",
+  "description": "WIP: An unofficial port of Base UI for SolidJS",
   "type": "module",
   "module": "./dist/lib/client/index.js",
   "types": "./dist/lib/types/index.d.ts",