mtrl-addons 0.2.2 → 0.2.4

package/{src/core/viewport/index.ts → dist/core/viewport/index.d.ts}

@@ -1,14 +1,8 @@
-// src/core/viewport/index.ts
-
 /**
  * Viewport Module - High-Performance Virtual Scrolling
  * A composable, feature-based virtual scrolling solution
  */
-
-// Main viewport creator
 export * from "./viewport";
-
-// Feature enhancers (for custom composition)
 export { withBase } from "./features/base";
 export { withVirtual } from "./features/virtual";
 export { withScrolling } from "./features/scrolling";
@@ -17,15 +11,5 @@ export { withRendering } from "./features/rendering";
 export { withCollection } from "./features/collection";
 export { withPlaceholders } from "./features/placeholders";
 export { withEvents } from "./features/events";
-
-// Types
-export type {
-  ViewportConfig,
-  ViewportComponent,
-  ViewportContext,
-  ItemRange,
-  ViewportInfo,
-} from "./types";
-
-// Constants
+export type { ViewportConfig, ViewportComponent, ViewportContext, ItemRange, ViewportInfo, } from "./types";
 export { VIEWPORT_CONSTANTS } from "./constants";

package/dist/core/viewport/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Core type definitions for Viewport
+ * Virtual scrolling and rendering types
+ */
+import type { CollectionComponent } from "./features/collection";
+/**
+ * Core Range and Item Types
+ */
+export interface ItemRange {
+    start: number;
+    end: number;
+}
+export interface ViewportInfo {
+    containerSize: number;
+    totalVirtualSize: number;
+    visibleRange: ItemRange;
+    virtualScrollPosition: number;
+}
+/**
+ * Viewport context interface - provides context for viewport features
+ */
+export interface ViewportContext {
+    element: HTMLElement;
+    items: any[];
+    totalItems: number;
+    template?: (item: any, index: number) => string | HTMLElement;
+    emit?: (event: string, data?: any) => void;
+    on?: (event: string, handler: Function) => () => void;
+    once?: (event: string, handler: Function) => () => void;
+    off?: (event: string, handler: Function) => void;
+    getClass?: (name: string) => string;
+}
+/**
+ * Viewport configuration - Feature-oriented structure
+ */
+export interface ViewportConfig {
+    element?: HTMLElement;
+    className?: string;
+    debug?: boolean;
+    template?: (item: any, index: number) => string | HTMLElement | any[] | Record<string, any>;
+    collection?: {
+        adapter?: any;
+        transform?: (item: any) => any;
+    };
+    pagination?: {
+        strategy?: "page" | "offset" | "cursor";
+        limit?: number;
+    };
+    virtual?: {
+        itemSize?: number;
+        overscan?: number;
+        autoDetectItemSize?: boolean;
+    };
+    scrolling?: {
+        orientation?: "vertical" | "horizontal";
+        animation?: boolean;
+        sensitivity?: number;
+    };
+    scrollbar?: {
+        enabled?: boolean;
+        autoHide?: boolean;
+    };
+    performance?: {
+        maxConcurrentRequests?: number;
+        cancelLoadThreshold?: number;
+        enableRequestQueue?: boolean;
+        recycleElements?: boolean;
+        bufferSize?: number;
+        renderDebounce?: number;
+    };
+    placeholders?: {
+        enabled?: boolean;
+        template?: (index: number) => string | HTMLElement;
+        maskCharacter?: string;
+        analyzeFirstLoad?: boolean;
+    };
+}
+/**
+ * Enhanced component after viewport is applied
+ */
+export interface ViewportComponent extends ViewportContext {
+    viewport: {
+        initialize(): boolean | void;
+        destroy(): void;
+        updateViewport(): void;
+        scrollToIndex(index: number, alignment?: "start" | "center" | "end"): void;
+        scrollToPosition(position: number): void;
+        getScrollPosition(): number;
+        scrollBy(delta: number): void;
+        getVelocity(): number;
+        collection?: CollectionComponent["collection"];
+        getVisibleRange(): ItemRange;
+        getViewportInfo(): ViewportInfo;
+        renderItems(): void;
+    };
+}

package/dist/core/viewport/utils/speed-tracker.d.ts

@@ -0,0 +1,22 @@
+export interface SpeedTracker {
+    velocity: number;
+    direction: "forward" | "backward";
+    isAccelerating: boolean;
+    lastMeasurement: number;
+}
+/**
+ * Create a new speed tracker instance
+ */
+export declare function createSpeedTracker(): SpeedTracker;
+/**
+ * Update speed tracker with new scroll position
+ */
+export declare function updateSpeedTracker(tracker: SpeedTracker, newPosition: number, previousPosition: number): SpeedTracker;
+/**
+ * Determine if scroll speed is fast (should defer loading)
+ */
+export declare function isFastScrolling(tracker: SpeedTracker): boolean;
+/**
+ * Get loading strategy based on current speed
+ */
+export declare function getLoadingStrategy(tracker: SpeedTracker): "defer" | "immediate";

package/dist/core/viewport/viewport.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Viewport - Core virtual scrolling engine
+ */
+import type { ViewportConfig, ViewportContext, ViewportComponent } from "./types";
+/**
+ * Creates a viewport-enhanced component using composition
+ *
+ * @param config - Viewport configuration
+ * @returns Function that enhances a component with viewport capabilities
+ */
+export declare const createViewport: (config?: ViewportConfig) => <T extends ViewportContext>(component: T) => T & ViewportComponent;

package/{src/index.ts → dist/index.d.ts}

@@ -2,9 +2,5 @@
  * mtrl-addons
  * Additional components and utilities for the mtrl system
  */
-
-// === Core System ===
 export * from "./core";
-
-// === Components ===
 export * from "./components";