@spaethtech/svelte-ui 0.21.1-dev.126.3149ff9 → 0.21.1-dev.127.89441ce

package/MIGRATION.md

@@ -8,6 +8,16 @@ upgrade are documented here, each with a dated heading and a concrete before/aft
 
 ## The `*2` native-first variants (transitional)
 
+> ### ⚠️ EXPERIMENTAL — proof-of-concept, NOT ready for use
+>
+> The `*2` components (`Select2`, `Disclosure2`, `Accordion2`, `DatePicker2`) are a **proof-of-concept
+> under active evaluation in a single test bed (php-svelte) only**. They ship on the **`@dev`** channel
+> so that test bed can exercise them — **do not adopt them in any other project yet.** The API, the
+> behaviour, and even whether each one survives are still in flux (e.g. reset semantics are still being
+> settled). Treat them as unstable: no compatibility promise, and they may change or be removed without
+> a migration note while in this phase. When one is actually ready, this banner comes off and the swap
+> is announced here. Until then: **look, test in php-svelte, don't build on them.**
+
 Several components are getting a **native-first, no-JS / SSR-correct** rebuild so SSR apps (e.g. a
 PHP-rendered front end) render and submit them with **no client JavaScript**. Rather than change the
 existing components in place and risk the apps that already depend on them, each rebuild ships

package/docs/components.md

@@ -93,6 +93,8 @@ Custom dropdown built on `Input` + `List`.
 
 ### Select2 (native-first)
 
+> ⚠️ **Experimental — proof-of-concept, NOT ready for use.** Evaluated in the php-svelte test bed only, on the `@dev` channel; the API/behaviour are unstable and it may change or be removed without notice. Don't adopt it in a project yet. See the `*2` banner in `MIGRATION.md`.
+
 A **no-JS / SSR-correct** sibling of `Select` that renders a real `<select>` — it works with
 JavaScript disabled, submits in a plain `<form>` (its `name` carries the value, no hidden input), and
 shows the right option in SSR / before hydration. The **closed control is pixel-identical** to
@@ -313,6 +315,8 @@ independent. Propagates `size`/`variant`/`disabled` to children.
 
 ### Disclosure2 / Accordion2 (native-first)
 
+> ⚠️ **Experimental — proof-of-concept, NOT ready for use.** Evaluated in the php-svelte test bed only, on the `@dev` channel; the API/behaviour are unstable and it may change or be removed without notice. Don't adopt it in a project yet. See the `*2` banner in `MIGRATION.md`.
+
 **No-JS / SSR-correct** siblings built on real `<details>/<summary>`: they expand, rotate the chevron,
 and (via `Accordion2`'s shared `<details name>`) enforce single-open **with no JavaScript**, correct
 in SSR. The `<summary>` wears `Button`'s ghost-header classes, so the header is **pixel-identical** to
@@ -420,6 +424,8 @@ snaps to canonical on blur.
 
 ### DatePicker2 (native-first)
 
+> ⚠️ **Experimental — proof-of-concept, NOT ready for use.** Evaluated in the php-svelte test bed only, on the `@dev` channel; the API/behaviour are unstable and it may change or be removed without notice. Don't adopt it in a project yet. See the `*2` banner in `MIGRATION.md`.
+
 **No-JS / SSR-correct** date entry: reuses `Input` with a real `<input type="date">` (or
 `datetime-local` in `time` mode), so it works without JavaScript, pops the browser's native picker,
 and submits via `name`. The field **frame** is pixel-identical to `DatePicker` (same `Input`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaethtech/svelte-ui",
-  "version": "0.21.1-dev.126.3149ff9",
+  "version": "0.21.1-dev.127.89441ce",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spaethtech/svelte-ui.git"