vlist 2.8.1 → 3.0.0-next.2

package/dist/core/create.d.ts

@@ -7,10 +7,21 @@
 import type { VListItem } from "../types";
 import type { CreateVListConfig, VListPlugin, VList } from "./types";
 import type { SizeCache } from "./sizes";
-import { type BoundedScrollHandler, type BoundedScrollConfig } from "./runway";
-export declare function createVList<T extends VListItem = VListItem>(rawConfig: CreateVListConfig<T>, plugins?: VListPlugin<T>[], 
-/** @internal Provided only by the opt-in scroll entry. */
+import type { BoundedScrollHandler, BoundedScrollConfig } from "./runway";
+import type { ScrollHandler, ScrollHandlerConfig } from "./scroll";
+import { type Emitter } from "../events";
+import type { VListEvents } from "../types";
+/** Create a list with native scrolling. Opt into synthetic input via vlist/synthetic. */
+export declare function createVList<T extends VListItem = VListItem>(config: CreateVListConfig<T>, plugins?: VListPlugin<T>[]): VList<T>;
+/** @internal Shared factory; entries select the input handler. */
+export declare function createCore<T extends VListItem = VListItem>(rawConfig: CreateVListConfig<T>, plugins?: VListPlugin<T>[], 
+/** @internal Omitted by the native entry. */
 logicalHandlerFactory?: (config: BoundedScrollConfig & {
     sizeCache: SizeCache;
-}) => BoundedScrollHandler): VList<T>;
+}) => BoundedScrollHandler, nativeOptions?: {
+    native: (config: ScrollHandlerConfig) => ScrollHandler & {
+        commitScroll(pos?: number): void;
+    };
+    onContentSize: (size: number, emitter: Emitter<VListEvents<T>>) => void;
+}): VList<T>;
 //# sourceMappingURL=create.d.ts.map

package/dist/core/scroll-source.d.ts

@@ -0,0 +1,5 @@
+import type { ScrollHandler, ScrollHandlerConfig } from "./scroll";
+export declare function createScrollSource(config: ScrollHandlerConfig): ScrollHandler & {
+    commitScroll(pos?: number): void;
+};
+//# sourceMappingURL=scroll-source.d.ts.map

package/dist/core/scroll.d.ts

@@ -28,5 +28,7 @@ export interface ScrollHandlerConfig {
     /** Called when scrolling becomes idle */
     readonly onIdle: () => void;
 }
-export declare function createScrollHandler(config: ScrollHandlerConfig): ScrollHandler;
+export declare function createScrollHandler(config: ScrollHandlerConfig): ScrollHandler & {
+    commitScroll(pos?: number): void;
+};
 //# sourceMappingURL=scroll.d.ts.map

package/dist/core/types.d.ts

@@ -79,11 +79,15 @@ export interface PluginContext<T extends VListItem = VListItem> {
     registerDestroyHandler(handler: () => void): void;
     enableListboxRole(): void;
     setSizeConfig(config: number | ((index: number) => number)): void;
-    /** @deprecated Use setScrollSource in 3.0; removed in 3.0.
-     * See https://vlist.io/docs/rfcs/RFC-014-Scroll-Input-Model */
-    setScrollFns(get: () => number, set: (pos: number) => void): void;
+    /** Install an external writer and disable default scroll/wheel listeners. */
+    setScrollSource(source: {
+        write(px: number): void;
+        onContentSize?(px: number): void;
+    }): void;
+    /** Commit an external position, render synchronously and schedule configured idle. */
+    commitScroll(px: number): void;
     /** Request the bounded scroll handler in infinite-loop (wrap) mode (carousel). */
-    setBoundedWrap(config: import("./runway").WrapConfig): void;
+    setBoundedWrap(config: import("./runway").WrapConfig, createHandler: (config: import("./runway").BoundedScrollConfig) => import("./runway").BoundedScrollHandler): void;
     setVirtualTotalFn(fn: () => number): void;
     setIndexMapFn(fn: (renderIndex: number) => number): void;
     getItems(): readonly T[];
@@ -104,9 +108,6 @@ export interface PluginContext<T extends VListItem = VListItem> {
     smoothScrollTo(target: number | (() => number), duration: number, easing?: (t: number) => number, onComplete?: () => void): void;
     /** Cancel any in-flight smooth-scroll animation on the active handler. */
     cancelScroll(): void;
-    /** @deprecated Use setScrollSource in 3.0; removed in 3.0.
-     * See https://vlist.io/docs/rfcs/RFC-014-Scroll-Input-Model */
-    disableDefaultScroll(): void;
     disableDefaultResize(): void;
     setScrollTarget(target: EventTarget): void;
     setScrollToPosFn(fn: (index: number, sizeCache: import("./sizes").SizeCache, containerSize: number, totalItems: number, align: string) => number): void;

package/dist/index.d.ts

@@ -39,11 +39,6 @@ export { search, DEFAULT_SEARCH_TEXT } from "./plugins/search";
 export type { SearchPluginConfig, SearchText } from "./plugins/search";
 export { carousel, registerPreset, getPreset, resolvePreset, full, hero, heroCenter, multi, uncontained } from "./plugins/carousel";
 export type { CarouselPluginConfig, CarouselVariant, CarouselDirection, CarouselState, SlotConfig, SlotConfigResolver, TextFade } from "./plugins/carousel";
-/** @deprecated Removed in 3.0. Use `scroll: { mode: "synthetic" }` from
- * `vlist/synthetic` (bounded remains available in 2.x).
- * See https://vlist.io/docs/rfcs/RFC-014-Scroll-Input-Model */
-export { scale } from "./plugins/scale";
-export type { ScalePluginConfig } from "./plugins/scale";
 export { createStats } from "./utils/stats";
 export type { Stats, StatsConfig, StatsState } from "./utils/stats";
 export { rebuild } from "./utils/rebuild";