@spaethtech/svelte-ui 0.21.1-dev.134.0bfe62d → 0.21.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/MIGRATION.md +12 -11
  2. package/package.json +2 -2
package/MIGRATION.md CHANGED
@@ -8,15 +8,16 @@ upgrade are documented here, each with a dated heading and a concrete before/aft
8
8
 
9
9
  ## The `*2` native-first variants (transitional)
10
10
 
11
- > ### ⚠️ EXPERIMENTAL — proof-of-concept, NOT ready for use
11
+ > ### ⚠️ EXPERIMENTAL — unstable API, adopt with care
12
12
  >
13
- > The `*2` components (`Select2`, `Disclosure2`, `Accordion2`, `DatePicker2`) are a **proof-of-concept
14
- > under active evaluation in a single test bed (php-svelte) only**. They ship on the **`@dev`** channel
15
- > so that test bed can exercise them — **do not adopt them in any other project yet.** The API, the
16
- > behaviour, and even whether each one survives are still in flux (e.g. reset semantics are still being
17
- > settled). Treat them as unstable: no compatibility promise, and they may change or be removed without
18
- > a migration note while in this phase. When one is actually ready, this banner comes off and the swap
19
- > is announced here. Until then: **look, test in php-svelte, don't build on them.**
13
+ > The `*2` components (`Select2`, `Disclosure2`, `Accordion2`, `DatePicker2`) are **transitional
14
+ > native-first variants under active evaluation**. They're published (not `@dev`-only), but the API,
15
+ > the behaviour, and even whether each one survives are still in flux (e.g. reset semantics are still
16
+ > being settled). Treat them as unstable: **no compatibility promise**, and they may change or be
17
+ > removed without a migration note while in this phase. Adopt one only if you can track breaking
18
+ > changes and pin exact versions. When one is actually ready, this banner comes off and the swap is
19
+ > announced here. The stable originals (`Select`, `Disclosure`, `Accordion`, `DatePicker`) carry no
20
+ > such caveat.
20
21
 
21
22
  Several components are getting a **native-first, no-JS / SSR-correct** rebuild so SSR apps (e.g. a
22
23
  PHP-rendered front end) render and submit them with **no client JavaScript**. Rather than change the
@@ -25,13 +26,13 @@ existing components in place and risk the apps that already depend on them, each
25
26
 
26
27
  - **Nothing breaks on arrival.** The `2` components are purely additive new exports. Existing
27
28
  components are untouched; your current code keeps working.
28
- - **Try them on `@dev`.** Import the `2` variant (`import { Select2 } from '@spaethtech/svelte-ui'`
29
+ - **Try them.** Import the `2` variant (`import { Select2 } from '@spaethtech/svelte-ui'`
29
30
  or the `@spaethtech/svelte-ui/select2` subpath) and A/B it against the original in the same app.
30
31
  - **The eventual swap is deliberate and versioned.** Once a `2` variant proves out, its
31
32
  implementation replaces the original's (`Select2` → `Select`), the `2` export is removed, and that
32
33
  single swap is documented here with its compatibility delta and a MINOR version bump. The only
33
- thing that can break at that point is a **direct `Select2` import** — which should only ever exist
34
- in the test bed, never in shipped app code.
34
+ thing that can break at that point is a **direct `Select2` import** — so if you adopt one, pin exact
35
+ versions and track this file.
35
36
 
36
37
  The `2` variants aim to be a **drop-in prop-superset** of the original: props the native element
37
38
  can't honour are still *accepted* (so swapping the component name type-checks) but ignored, and are
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spaethtech/svelte-ui",
3
- "version": "0.21.1-dev.134.0bfe62d",
3
+ "version": "0.21.1",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/spaethtech/svelte-ui.git"
@@ -357,7 +357,7 @@
357
357
  "@iconify-json/mdi": "^1.2.3",
358
358
  "svelte": "^5.0.0",
359
359
  "tailwindcss": "^4.0.0",
360
- "unplugin-icons": "^23.0.1"
360
+ "unplugin-icons": "^23.0.1 || ^24.0.0"
361
361
  },
362
362
  "peerDependenciesMeta": {
363
363
  "@iconify-json/mdi": {