vlist-vue 3.1.0-next.2 → 3.1.0

package/README.md

@@ -2,6 +2,21 @@
 
 Vue composable for [vlist](https://github.com/floor/vlist) — lightweight, zero-dependency virtual scrolling.
 
+> **Deprecated.** Use [`vlist/vue`](https://github.com/floor/vlist#frameworks) from the `vlist` package instead. Change the import path, and pass features as plugins:
+>
+> ```ts
+> // before
+> import { useVList } from "vlist-vue";
+> useVList({ items, item, selection: { mode: "single" } });
+>
+> // after
+> import { useVList } from "vlist/vue";
+> import { selection } from "vlist";
+> useVList({ items, item }, [selection({ mode: "single" })]);
+> ```
+>
+> From 3.1 this package is built on `vlist/vue` and keeps its config-based API, so existing code keeps working while you migrate. It needs `vlist ^3.1.0`; on vlist 3.0.x, stay on `vlist-vue` 3.0.x.
+
 ## Install
 
 ```bash
@@ -42,7 +57,7 @@ Full usage guide, feature config examples, and TypeScript types: **[Framework Ad
 
 ## Synthetic input
 
-Every list scrolls natively by default, and hands itself to synthetic input past the browser's element size limit: `scroll.mode` is `"auto"`. Pass `scroll: { mode: "synthetic" }` for synthetic input from the start, or `"native"` to stay native; the adapter forwards `scroll` unchanged through `vlist/config`. A synthetic list draws its own scrollbar. Requires `vlist ^3.1.0-next.2`; on 3.0.0, pass `factory: createVList` from the deprecated `vlist/synthetic`. A carousel honours `"synthetic"` too. `VListFactory` is re-exported for typed custom factories.
+Every list scrolls natively by default, and hands itself to synthetic input past the browser's element size limit: `scroll.mode` is `"auto"`. Pass `scroll: { mode: "synthetic" }` for synthetic input from the start, or `"native"` to stay native; the adapter forwards `scroll` unchanged through `vlist/config`. A synthetic list draws its own scrollbar. Requires `vlist ^3.1.0`. A carousel honours `"synthetic"` too. `VListFactory` is re-exported for typed custom factories.
 
 ```vue
 <script setup lang="ts">

package/dist/index.d.ts

@@ -1,10 +1,17 @@
 /**
  * Vue composable for vlist - lightweight virtual scrolling
+ *
+ * Deprecated: use `vlist/vue` from the vlist package, which takes features as
+ * plugins (`useVList({ items, item }, [selection()])`). This package keeps the
+ * config-based API on top of it: the composables are `vlist/vue`'s, building
+ * the list with `createVListFromConfig` so feature fields still resolve to
+ * plugins.
  */
-import { type Ref, type ShallowRef } from "vue";
-import type { VListItem, VListEvents, EventHandler } from "vlist";
-import type { VList } from "vlist";
+import type { Ref, ShallowRef } from "vue";
+import type { VListItem, VList } from "vlist";
 import { type VListConfig } from "vlist/config";
+import { useVListEvent } from "vlist/vue";
+export { useVListEvent };
 export type { VListItem, VListEvents, VList, CreateVListConfig, ItemConfig, ItemTemplate, EventHandler, Unsubscribe, } from "vlist";
 export type { VListConfig, VListFactory } from "vlist/config";
 /**
@@ -18,4 +25,3 @@ export interface UseVListReturn<T extends VListItem = VListItem> {
     instance: ShallowRef<VList<T> | null>;
 }
 export declare function useVList<T extends VListItem = VListItem>(configInput: UseVListConfig<T> | Ref<UseVListConfig<T>>): UseVListReturn<T>;
-export declare function useVListEvent<T extends VListItem, K extends keyof VListEvents<T>>(instanceRef: Ref<VList<T> | null> | ShallowRef<VList<T> | null>, event: K, handler: EventHandler<VListEvents<T>[K]>): void;

package/dist/index.js

@@ -1 +1 @@
-import{ref as A,shallowRef as N,onMounted as O,onBeforeUnmount as D,watch as E,isRef as P,unref as Q}from"vue";import{createVListFromConfig as S}from"vlist/config";function X(q){let x=A(null),j=N(null);if(O(()=>{let k=x.value;if(!k)return;let z=Q(q);j.value=S({...z,container:k})}),D(()=>{j.value?.destroy(),j.value=null}),P(q))E(()=>q.value.items,(k)=>{if(j.value&&k)j.value.setItems(k)});return{containerRef:x,instance:j}}function Y(q,x,j){let k=A(j);E(()=>q.value,(z)=>{if(!z)return;let G=(K)=>{k.value(K)},J=z.on(x,G);D(()=>{J()})},{immediate:!0})}export{Y as useVListEvent,X as useVList};
+import{createVListFromConfig as k}from"vlist/config";import{useVList as q,useVListEvent as B}from"vlist/vue";var x=k;function D(j){return q(j,[],x)}export{B as useVListEvent,D as useVList};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlist-vue",
-  "version": "3.1.0-next.2",
+  "version": "3.1.0",
   "description": "Vue composable for vlist - lightweight virtual scrolling",
   "author": {
     "name": "Floor IO",
@@ -32,7 +32,7 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "vlist": "^3.0.0 || ^3.1.0-next.2",
+    "vlist": "^3.1.0",
     "vue": ">=3.0.0"
   },
   "files": [
@@ -52,7 +52,7 @@
     "@types/bun": "^1.0.0",
     "bun": "^1.0.0",
     "typescript": "^5.0.0",
-    "vlist": "^3.1.0-next.2",
+    "vlist": "3.1.0",
     "vue": "^3.5.28"
   }
 }