mtrl-addons 0.2.2 → 0.2.4

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

@@ -3,7 +3,5 @@
  *
  * Central export point for all components
  */
-
-// VList component (virtual list with viewport)
 export { createVList } from "./vlist";
 export type { VListConfig, VListComponent } from "./vlist/types";

package/dist/components/vlist/config.d.ts

@@ -0,0 +1,86 @@
+/**
+ * mtrl-addons List Component Configuration
+ *
+ * Configuration utilities and defaults for the list component.
+ * Follows mtrl patterns for component configuration.
+ */
+import type { ListConfig, ListItem } from "./types";
+/**
+ * Default configuration for the mtrl-addons List component
+ */
+export declare const defaultConfig: Partial<ListConfig>;
+export declare function createBaseConfig<T extends ListItem = ListItem>(config?: ListConfig<T>): Required<ListConfig<T>>;
+/**
+ * Creates element configuration for withElement
+ * @param {ListConfig} config - List configuration
+ * @returns {Object} Element configuration
+ */
+export declare function getElementConfig<T extends ListItem = ListItem>(config: ListConfig<T>): any;
+/**
+ * Creates API configuration for the List component
+ * @param {Object} component - Component with list functionality
+ * @returns {Object} API configuration object for withApi
+ */
+export declare function getApiConfig<T extends ListItem = ListItem>(component: any): {
+    data: {
+        add: any;
+        update: any;
+        remove: any;
+        clear: any;
+        refresh: any;
+        getItems: any;
+        getItem: any;
+        query: any;
+        sort: any;
+        getSize: any;
+        isEmpty: any;
+        isLoading: any;
+        getError: any;
+    };
+    selection: {
+        selectItem: any;
+        deselectItem: any;
+        selectAll: any;
+        deselectAll: any;
+        getSelectedItems: any;
+        getSelectedIds: any;
+    } | undefined;
+    scrolling: {
+        scrollToItem: any;
+        scrollToIndex: any;
+        scrollToPage: any;
+    };
+    performance: {
+        getMetrics: any;
+        resetMetrics: any;
+    };
+    template: {
+        setTemplate: any;
+        getTemplate: any;
+    };
+    events: {
+        on: any;
+        off: any;
+        emit: any;
+        subscribe: any;
+    };
+    lifecycle: {
+        destroy: any;
+    };
+    config: {
+        selection: any;
+        scroll: any;
+    };
+};
+/**
+ * Validates list configuration
+ */
+export declare const validateConfig: (config: ListConfig) => void;
+/**
+ * Creates Collection configuration from List config
+ */
+export declare const getCollectionConfig: (config: ListConfig) => {
+    adapter: import("./types").ListAdapter<ListItem> | undefined;
+    items: ListItem[] | undefined;
+    cache: any;
+};

package/{src/components/vlist/constants.ts → dist/components/vlist/constants.d.ts}

@@ -5,19 +5,18 @@
  * Note: Base mtrl list functionality is handled by mtrl core.
  * These constants are for addons-specific features only.
  */
-
 /**
  * CSS class names for VList component
  * Following BEM convention: component__element--modifier
  * Note: mtrl prefix is added automatically by core DOM classes system
  */
-export const VLIST_CLASSES = {
-  /** List element */
-  LIST: "vlist",
-  /** List item */
-  ITEM: "viewport-item",
-  /** Selected list item */
-  SELECTED: "viewport-item--selected",
-  /** Empty state */
-  EMPTY: "vlist--empty",
-} as const;
+export declare const VLIST_CLASSES: {
+    /** List element */
+    readonly LIST: "vlist";
+    /** List item */
+    readonly ITEM: "viewport-item";
+    /** Selected list item */
+    readonly SELECTED: "viewport-item--selected";
+    /** Empty state */
+    readonly EMPTY: "vlist--empty";
+};

package/dist/components/vlist/features/api.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API feature for VList
+ * Provides a clean public API for the VList component
+ */
+import type { VListConfig, VListItem } from "../types";
+export type { RemoveItemOptions } from "../types";
+export declare const withAPI: <T extends VListItem = VListItem>(config: VListConfig<T>) => (component: any) => any;

package/{src/components/vlist/features/index.ts → dist/components/vlist/features/index.d.ts}

@@ -3,8 +3,6 @@
  *
  * List-specific features and enhancements.
  */
-
-// VList-specific features
 export { withViewport } from "./viewport";
 export { withAPI } from "./api";
 export { withSelection } from "./selection";

package/dist/components/vlist/features/selection.d.ts

@@ -0,0 +1,6 @@
+import type { VListConfig, VListComponent, VListItem } from "../types";
+/**
+ * Adds selection management capabilities to VList component
+ */
+export declare const withSelection: <T extends VListItem = VListItem>(config: VListConfig<T>) => (component: VListComponent<T>) => VListComponent<T>;
+export default withSelection;

package/dist/components/vlist/features/viewport.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Viewport feature for VList
+ * Integrates the core viewport functionality with VList component
+ */
+import type { VListConfig, VListItem } from "../types";
+/**
+ * Adds viewport functionality to VList
+ */
+export declare const withViewport: <T extends VListItem = VListItem>(config: VListConfig<T>) => (component: any) => any;

package/dist/components/vlist/features.d.ts

@@ -0,0 +1,31 @@
+/**
+ * List component features
+ *
+ * Modular features that can be composed with the list component.
+ * Following mtrl's functional composition pattern.
+ */
+import type { ListComponent, ListItem } from "./types";
+/**
+ * Virtual scrolling feature (future implementation)
+ * This will provide window-based virtual scrolling for massive datasets
+ */
+export declare function withVirtualScroll<T extends ListItem = ListItem>(config?: any): (list: ListComponent<T>) => ListComponent<T>;
+/**
+ * Enhanced list selection feature (future implementation)
+ * This will provide advanced selection patterns
+ */
+export declare function withListSelection<T extends ListItem = ListItem>(config?: any): (list: ListComponent<T>) => ListComponent<T>;
+/**
+ * Advanced list styling feature (future implementation)
+ * This will provide theme integration and advanced styling
+ */
+export declare function withListStyling<T extends ListItem = ListItem>(config?: any): (list: ListComponent<T>) => ListComponent<T>;
+/**
+ * Performance optimization feature (future implementation)
+ * This will provide advanced performance monitoring and optimization
+ */
+export declare function withListPerformance<T extends ListItem = ListItem>(config?: any): (list: ListComponent<T>) => ListComponent<T>;
+/**
+ * Re-export the internal composition functions for advanced usage
+ * These are the actual working implementations used in createList
+ */

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

@@ -4,14 +4,5 @@
  * A high-performance virtual list component that uses the viewport
  * feature directly without the list-manager layer.
  */
-
 export { createVList } from "./vlist";
-export type {
-  RemoveItemOptions,
-  VListConfig,
-  VListComponent,
-  VListItem,
-  VListAPI,
-  VListState,
-  VListEvents,
-} from "./types";
+export type { RemoveItemOptions, VListConfig, VListComponent, VListItem, VListAPI, VListState, VListEvents, } from "./types";