vlist 2.7.2 → 2.8.1

package/dist/plugins/autosize/plugin.d.ts

@@ -8,7 +8,7 @@
  * Because a pinned item cannot grow, content that changes size after the
  * measurement (an image that loads or fails, a font swap, lazy content)
  * needs a fresh measurement. `load` and `error` events from descendants
- * trigger one automatically.
+ * trigger one automatically; `list.remeasure(index?)` does it on demand.
  *
  * Priority 5 — runs before grid/masonry (10) so the measured cache
  * is in place before layout plugins consume it.

package/dist/plugins/scale/plugin.d.ts

@@ -4,4 +4,6 @@ export interface ScalePluginConfig {
     force?: boolean;
 }
 export declare function scale<T extends VListItem = VListItem>(_config?: ScalePluginConfig): VListPlugin<T>;
+/** Internal: the config entry installs the compatibility stub without warning. */
+export declare function createScalePlugin<T extends VListItem = VListItem>(warn: boolean): VListPlugin<T>;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/size.json

@@ -1 +1 @@
-{"base":{"minified":"27.8","gzipped":"9.9","minBytes":28421,"gzBytes":10106},"synthetic":{"minified":"35.0","gzipped":"12.5","minBytes":35888,"gzBytes":12764},"a11y":{"minified":"31.0","gzipped":"11.1","minBytes":31753,"gzBytes":11336},"selection":{"minified":"37.1","gzipped":"12.7","minBytes":38030,"gzBytes":12989},"data":{"minified":"41.4","gzipped":"14.7","minBytes":42378,"gzBytes":15034},"scrollbar":{"minified":"34.8","gzipped":"11.9","minBytes":35686,"gzBytes":12164},"sortable":{"minified":"37.2","gzipped":"12.9","minBytes":38099,"gzBytes":13194},"groups":{"minified":"43.7","gzipped":"15.2","minBytes":44759,"gzBytes":15564},"page":{"minified":"30.2","gzipped":"10.6","minBytes":30907,"gzBytes":10881},"snapshots":{"minified":"31.0","gzipped":"11.0","minBytes":31775,"gzBytes":11288},"transition":{"minified":"34.4","gzipped":"11.8","minBytes":35208,"gzBytes":12123},"autosize":{"minified":"30.7","gzipped":"10.9","minBytes":31411,"gzBytes":11143},"grid":{"minified":"34.8","gzipped":"12.3","minBytes":35665,"gzBytes":12628},"table":{"minified":"46.1","gzipped":"15.7","minBytes":47219,"gzBytes":16074},"masonry":{"minified":"39.0","gzipped":"14.0","minBytes":39947,"gzBytes":14298},"tree":{"minified":"43.0","gzipped":"14.9","minBytes":44065,"gzBytes":15269},"search":{"minified":"36.9","gzipped":"13.0","minBytes":37743,"gzBytes":13361},"carousel":{"minified":"37.2","gzipped":"13.3","minBytes":38126,"gzBytes":13644}}
+{"base":{"minified":"27.8","gzipped":"9.9","minBytes":28421,"gzBytes":10106},"synthetic":{"minified":"35.0","gzipped":"12.5","minBytes":35888,"gzBytes":12764},"a11y":{"minified":"31.0","gzipped":"11.1","minBytes":31753,"gzBytes":11336},"selection":{"minified":"37.1","gzipped":"12.7","minBytes":38030,"gzBytes":12989},"data":{"minified":"41.4","gzipped":"14.7","minBytes":42378,"gzBytes":15034},"scrollbar":{"minified":"34.8","gzipped":"11.9","minBytes":35686,"gzBytes":12164},"sortable":{"minified":"37.2","gzipped":"12.9","minBytes":38099,"gzBytes":13194},"groups":{"minified":"43.7","gzipped":"15.2","minBytes":44759,"gzBytes":15564},"page":{"minified":"30.2","gzipped":"10.6","minBytes":30907,"gzBytes":10881},"snapshots":{"minified":"31.0","gzipped":"11.0","minBytes":31775,"gzBytes":11288},"transition":{"minified":"34.4","gzipped":"11.8","minBytes":35208,"gzBytes":12123},"autosize":{"minified":"30.8","gzipped":"10.9","minBytes":31529,"gzBytes":11174},"grid":{"minified":"34.8","gzipped":"12.3","minBytes":35665,"gzBytes":12628},"table":{"minified":"46.1","gzipped":"15.7","minBytes":47219,"gzBytes":16074},"masonry":{"minified":"39.0","gzipped":"14.0","minBytes":39947,"gzBytes":14298},"tree":{"minified":"43.0","gzipped":"14.9","minBytes":44065,"gzBytes":15269},"search":{"minified":"36.9","gzipped":"13.0","minBytes":37743,"gzBytes":13361},"carousel":{"minified":"37.6","gzipped":"13.4","minBytes":38503,"gzBytes":13746}}

package/dist/types.d.ts

@@ -292,14 +292,19 @@ export interface ScrollConfig {
      */
     wrap?: boolean;
     /**
-     * Scrollbar mode (default: custom scrollbar).
-     *
-     * - *omitted* — Custom scrollbar (default), native scrollbar hidden via CSS
-     * - `'native'` — Browser native scrollbar
-     * - `'none'` — No scrollbar at all (native hidden, custom not created)
-     * - `ScrollbarOptions` — Custom scrollbar with fine-tuning options
+     * Scrollbar selection depends on the entry:
+     * - Core reads only `'none'`, which hides the native scrollbar via CSS.
+     *   Omission, `'native'` and options objects do not install a custom scrollbar.
+     * - `vlist/config` installs `scrollbar()` for omission or an options object;
+     *   `'native'` and `'none'` skip that plugin. An explicit `scrollbar()` plugin
+     *   controls its own native-scrollbar hiding independently.
      */
-    scrollbar?: "native" | "none" | ScrollbarOptions;
+    scrollbar?: 
+    /** Browser scrollbar. Stays available on the native default in 3.0; the
+     * `vlist/synthetic` entry has no browser scrollbar and uses `scrollbar()`. */
+    "native"
+    /** Hide the browser scrollbar. Stays available on the native default in 3.0. */
+     | "none" | ScrollbarOptions;
     /** External scroll element for window scrolling */
     element?: Window;
     /** Scroll idle detection timeout in ms (default: 150) */
@@ -310,6 +315,11 @@ export interface ScrollConfig {
      * `"bounded"` sizes the content to a viewport-multiple runway and rebases a
      * logical origin near the edges, supporting unbounded item counts without
      * compressing the scroll space.
+     *
+     * @deprecated Removed in 3.0. Native scrolling stays the default of `vlist`; for
+     * lists beyond the browser's element size limit, import `createVList` from
+     * `vlist/synthetic` instead of using bounded mode. Bounded remains supported in 2.x.
+     * See https://vlist.io/docs/migration-v3
      */
     mode?: "native" | "bounded";
     /**
@@ -319,6 +329,9 @@ export interface ScrollConfig {
      * more native-scroll headroom and less frequent rebasing, at the cost of a
      * bigger content element. Clamped up to a minimum of 1.5 so native scroll and
      * touch momentum always have some room.
+     *
+     * @deprecated Removed with bounded mode in 3.0.
+     * See https://vlist.io/docs/migration-v3
      */
     runway?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlist",
-  "version": "2.7.2",
+  "version": "2.8.1",
   "description": "Lightweight, high-performance virtual list with zero dependencies",
   "author": {
     "name": "Floor IO",