vlist 2.7.2 → 3.0.0-next.1

package/dist/core/adapter.d.ts

@@ -45,9 +45,11 @@ export interface ScrollAdapter {
     setLogical(pos: LogicalScrollPosition): void;
     /** Pixel-equivalent of the current position (for public API / events). */
     getPixelEquivalent(): number;
+    /** Origin subtracted from logical item offsets when positioning content. */
+    getRenderOrigin(): number;
     /** Move to a pixel-equivalent position. Out-of-range input is clamped. */
     setPixelEquivalent(px: number): void;
-    /** Maximum scrollable pixel-equivalent (`totalSize - containerSize`, >= 0). */
+    /** Maximum scrollable pixel-equivalent (`totalSize + padding - containerSize`, >= 0). */
     getMaxPixelEquivalent(): number;
     /** Advance the position by a pixel delta (used by native/wheel input). */
     scrollByPx(delta: number): void;
@@ -58,10 +60,14 @@ export interface ScrollAdapterConfig {
     readonly sizeCache: SizeCache;
     /** Read the current pixel-equivalent position from the active scroll source. */
     readonly getPixel: () => number;
+    /** Read the origin owned by the active scroll source. */
+    readonly getRenderOrigin: () => number;
     /** Write a (clamped) pixel-equivalent position to the active scroll source. */
     readonly setPixel: (px: number) => void;
     /** Current viewport size along the main axis. */
     readonly getContainerSize: () => number;
+    /** Total start and end padding along the main axis. */
+    readonly padding: number;
 }
 /**
  * Convert a pixel offset into a logical position. The returned position is

package/dist/core/create.d.ts

@@ -7,10 +7,22 @@
 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 synthetic input. Native input is available from vlist/native. */
+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;
+    };
+    wrap: (config: BoundedScrollConfig) => BoundedScrollHandler;
+    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,7 +79,13 @@ export interface PluginContext<T extends VListItem = VListItem> {
     registerDestroyHandler(handler: () => void): void;
     enableListboxRole(): void;
     setSizeConfig(config: number | ((index: number) => number)): void;
-    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;
     setVirtualTotalFn(fn: () => number): void;
@@ -102,7 +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;
-    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,9 +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 Use `scroll: { mode: "bounded" }` instead. Will be removed in vlist 3.0. */
-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";