mtrl-addons 0.1.2 → 0.2.2

package/src/components/list/api.ts

@@ -1,314 +0,0 @@
-import type { ListComponent, ListConfig, ListAPI } from "./types";
-
-/**
- * API configuration interface
- */
-export interface ApiConfig<T = any> {
-  component: ListComponent<T>;
-  config: ListConfig<T>;
-}
-
-/**
- * Creates the public API layer for the List component
- * Following mtrl's withAPI pattern
- */
-export const withAPI =
-  <T = any>(apiConfig: ApiConfig<T>) =>
-  <C extends Partial<ListComponent<T>>>(component: C): C & ListAPI<T> => {
-    const { config } = apiConfig;
-
-    // Store references to orchestration methods before API overwrites them
-    const orchestrationMethods = {
-      scrollToIndex: component.scrollToIndex,
-      scrollToTop: component.scrollToTop,
-      scrollToBottom: component.scrollToBottom,
-      loadData: component.loadData,
-      reload: component.reload,
-      clear: component.clear,
-    };
-
-    // Create clean public API interface
-    const api: ListAPI<T> = {
-      // Data management API
-      async loadData(): Promise<void> {
-        try {
-          if (orchestrationMethods.loadData) {
-            await orchestrationMethods.loadData();
-          } else {
-            await component.collection?.loadPage?.(1);
-          }
-        } catch (error) {
-          console.error("List: Failed to load data", error);
-          throw error;
-        }
-      },
-
-      async reload(): Promise<void> {
-        try {
-          if (orchestrationMethods.reload) {
-            await orchestrationMethods.reload();
-          } else {
-            await component.collection?.refresh?.();
-          }
-        } catch (error) {
-          console.error("List: Failed to reload data", error);
-          throw error;
-        }
-      },
-
-      clear(): void {
-        if (orchestrationMethods.clear) {
-          orchestrationMethods.clear();
-        } else {
-          component.collection?.clearItems?.();
-          component.clearSelection?.();
-        }
-      },
-
-      addItems(items: T[], position: "start" | "end" = "end"): void {
-        if (!Array.isArray(items)) {
-          throw new Error("Items must be an array");
-        }
-        component.addItems?.(items, position);
-      },
-
-      removeItems(indices: number[]): void {
-        if (!Array.isArray(indices)) {
-          throw new Error("Indices must be an array");
-        }
-        component.removeItems?.(indices);
-      },
-
-      updateItem(index: number, item: T): void {
-        if (typeof index !== "number" || index < 0) {
-          throw new Error("Index must be a non-negative number");
-        }
-        component.updateItem?.(index, item);
-      },
-
-      getItem(index: number): T | undefined {
-        if (typeof index !== "number") {
-          return undefined;
-        }
-        return component.getItem?.(index);
-      },
-
-      getItems(): T[] {
-        return component.getItems?.() || [];
-      },
-
-      getItemCount(): number {
-        return component.collection?.getSize?.() || 0;
-      },
-
-      // Scrolling API
-      async scrollToIndex(
-        index: number,
-        alignment: "start" | "center" | "end" = "start"
-      ): Promise<void> {
-        if (typeof index !== "number" || index < 0) {
-          throw new Error("Index must be a non-negative number");
-        }
-
-        // For virtual scrolling with infinite data, don't do strict bounds checking
-        // The orchestration layer will handle loading data as needed
-        try {
-          if (orchestrationMethods.scrollToIndex) {
-            await orchestrationMethods.scrollToIndex(index, alignment);
-          } else {
-            console.warn("scrollToIndex not available");
-          }
-        } catch (error) {
-          console.error("List: Failed to scroll to index", error);
-          throw error;
-        }
-      },
-
-      async scrollToTop(): Promise<void> {
-        try {
-          if (orchestrationMethods.scrollToTop) {
-            await orchestrationMethods.scrollToTop();
-          } else {
-            console.warn("scrollToTop not available");
-          }
-        } catch (error) {
-          console.error("List: Failed to scroll to top", error);
-          throw error;
-        }
-      },
-
-      async scrollToBottom(): Promise<void> {
-        try {
-          if (orchestrationMethods.scrollToBottom) {
-            await orchestrationMethods.scrollToBottom();
-          } else {
-            console.warn("scrollToBottom not available");
-          }
-        } catch (error) {
-          console.error("List: Failed to scroll to bottom", error);
-          throw error;
-        }
-      },
-
-      getScrollPosition(): number {
-        return component.getScrollPosition?.() || 0;
-      },
-
-      // Selection API
-      selectItems(indices: number[]): void {
-        if (!config.selection?.enabled) {
-          console.warn("List: Selection is not enabled");
-          return;
-        }
-
-        if (!Array.isArray(indices)) {
-          throw new Error("Indices must be an array");
-        }
-
-        const itemCount = this.getItemCount();
-        const validIndices = indices.filter(
-          (index) =>
-            typeof index === "number" && index >= 0 && index < itemCount
-        );
-
-        if (config.selection.mode === "single" && validIndices.length > 1) {
-          console.warn("List: Single selection mode allows only one item");
-          component.selectItems?.([validIndices[0]]);
-        } else {
-          component.selectItems?.(validIndices);
-        }
-      },
-
-      deselectItems(indices: number[]): void {
-        if (!config.selection?.enabled) {
-          console.warn("List: Selection is not enabled");
-          return;
-        }
-
-        if (!Array.isArray(indices)) {
-          throw new Error("Indices must be an array");
-        }
-
-        component.deselectItems?.(indices);
-      },
-
-      clearSelection(): void {
-        if (!config.selection?.enabled) {
-          console.warn("List: Selection is not enabled");
-          return;
-        }
-
-        component.clearSelection?.();
-      },
-
-      getSelectedItems(): T[] {
-        return component.getSelectedItems?.() || [];
-      },
-
-      getSelectedIndices(): number[] {
-        return component.getSelectedIndices?.() || [];
-      },
-
-      isSelected(index: number): boolean {
-        if (typeof index !== "number") {
-          return false;
-        }
-        return component.isSelected?.(index) || false;
-      },
-
-      // State API
-      getState() {
-        return (
-          component.getState?.() || {
-            isLoading: false,
-            error: null,
-            isEmpty: true,
-            scrollTop: 0,
-            visibleRange: { start: 0, end: 0, count: 0 },
-            renderRange: { start: 0, end: 0, count: 0 },
-            selectedIndices: [],
-            totalItems: 0,
-            isVirtual: false,
-          }
-        );
-      },
-
-      isLoading(): boolean {
-        return component.isLoading?.() || false;
-      },
-
-      hasError(): boolean {
-        return component.hasError?.() || false;
-      },
-
-      isEmpty(): boolean {
-        return component.isEmpty?.() || true;
-      },
-
-      // Rendering API
-      render(): void {
-        component.render?.();
-      },
-
-      updateViewport(): void {
-        component.updateViewport?.();
-      },
-
-      getVisibleRange() {
-        return component.getVisibleRange?.() || { start: 0, end: 0, count: 0 };
-      },
-
-      getRenderRange() {
-        return component.getRenderRange?.() || { start: 0, end: 0, count: 0 };
-      },
-
-      // Template API
-      setTemplate(template) {
-        if (typeof template !== "function") {
-          throw new Error("Template must be a function");
-        }
-        component.setTemplate?.(template);
-      },
-
-      setLoadingTemplate(template) {
-        // Store in config for future use
-        config.loadingTemplate = template;
-      },
-
-      setEmptyTemplate(template) {
-        // Store in config for future use
-        config.emptyTemplate = template;
-      },
-
-      setErrorTemplate(template) {
-        // Store in config for future use
-        config.errorTemplate = template;
-      },
-
-      // Configuration API
-      updateConfig(newConfig: Partial<ListConfig<T>>): void {
-        if (typeof newConfig !== "object" || newConfig === null) {
-          throw new Error("Config must be an object");
-        }
-
-        component.updateConfig?.(newConfig);
-      },
-
-      getConfig(): ListConfig<T> {
-        return component.getConfig?.() || config;
-      },
-    };
-
-    // Return component with API methods
-    return Object.assign(component, api) as C & ListAPI<T>;
-  };
-
-/**
- * Helper to get API configuration
- */
-export const getApiConfig = <T = any>(
-  component: ListComponent<T>
-): ApiConfig<T> => ({
-  component,
-  config: component.config,
-});

package/src/components/list/constants.ts

@@ -1,56 +0,0 @@
-/**
- * mtrl-addons List Component Constants
- *
- * Constants for the addons list component.
- * Note: Base mtrl list functionality is handled by mtrl core.
- * These constants are for addons-specific features only.
- */
-
-/**
- * CSS class names for List component
- * Following BEM convention: component__element--modifier
- * Note: mtrl prefix is added automatically by core DOM classes system
- */
-export const LIST_CLASSES = {
-  BASE: "list",
-  ADDONS: "list-addons", // Addons-specific class
-} as const;
-
-/**
- * Default values for List component configuration
- * These supplement mtrl's base list defaults with addons-specific values
- */
-export const LIST_DEFAULTS = {
-  // Collection defaults (addons-specific)
-  INITIAL_CAPACITY: 100,
-  RENDER_BUFFER_SIZE: 10,
-  RENDER_DEBOUNCE: 16, // ~1 frame at 60fps
-
-  // Template defaults (addons-specific)
-  TEMPLATE_ENGINE: "object" as const,
-
-  // Performance defaults (addons-specific)
-  PERFORMANCE_TRACKING: true,
-} as const;
-
-/**
- * Event names for List component
- * Following mtrl event naming conventions
- */
-export const LIST_EVENTS = {
-  // Core events (inherited from mtrl base)
-  CREATED: "list:created",
-  DESTROYED: "list:destroyed",
-
-  // Data events (addons-specific)
-  DATA_LOADED: "list:data-loaded",
-  DATA_ERROR: "list:data-error",
-  DATA_UPDATED: "list:data-updated",
-
-  // Selection events (addons-specific enhancements)
-  SELECTION_CHANGED: "list:selection-changed",
-  SELECTION_CLEARED: "list:selection-cleared",
-
-  // Performance events (addons-specific)
-  PERFORMANCE_METRICS: "list:performance-metrics",
-} as const;