mtrl-addons 0.3.6 → 0.3.8

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

@@ -0,0 +1,18 @@
+/**
+ * Keyboard Navigation Feature for VList
+ *
+ * Implements Material Design 3 accessibility guidelines for lists:
+ * - Arrow keys (Up/Down/Left/Right) navigate between items with wrapping
+ * - Space/Enter activates/selects the focused item
+ * - Tab moves focus to/from the list
+ * - Home/End jump to first/last item
+ * - Page Up/Down skip multiple items
+ *
+ * @see https://m3.material.io/components/lists/accessibility
+ */
+import type { VListConfig, VListComponent, VListItem } from "../types";
+/**
+ * Adds keyboard navigation and accessibility to VList component
+ */
+export declare const withKeyboard: <T extends VListItem = VListItem>(config: VListConfig<T>) => (component: VListComponent<T>) => VListComponent<T>;
+export default withKeyboard;

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

@@ -5,4 +5,4 @@
  * 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, ListKeyboardConfig, } from "./types";

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

@@ -150,6 +150,34 @@ export interface ListSelectionConfig {
     /** Automatically select first item after initial load (default: false) */
     autoSelectFirst?: boolean;
 }
+/**
+ * Keyboard navigation configuration
+ *
+ * Follows Material Design 3 accessibility guidelines:
+ * - Arrow keys (Up/Down/Left/Right) navigate with wrapping
+ * - Space/Enter activates/selects items
+ * - Home/End jump to first/last
+ *
+ * @see https://m3.material.io/components/lists/accessibility
+ */
+export interface ListKeyboardConfig {
+    /** Enable keyboard navigation (default: true when selection is enabled) */
+    enabled?: boolean;
+    /** Enable Home/End keys (default: true) */
+    homeEnd?: boolean;
+    /** Enable Page Up/Down keys (default: true) */
+    pageUpDown?: boolean;
+    /** Number of items to skip with Page Up/Down (default: 10) */
+    pageSize?: number;
+    /** Enable type-ahead search (default: false) */
+    typeAhead?: boolean;
+    /** Type-ahead search timeout in ms (default: 500) */
+    typeAheadTimeout?: number;
+    /** Wrap around when reaching start/end (default: true per MD3 spec) */
+    wrap?: boolean;
+    /** Callback when keyboard navigation occurs */
+    onNavigate?: (index: number, key: string) => void;
+}
 /**
  * List orientation configuration
  */
@@ -561,6 +589,8 @@ export interface VListConfig<T extends ListItem = ListItem> {
     prefix?: string;
     ariaLabel?: string;
     debug?: boolean;
+    /** Automatically select first item after initial load (default: false) */
+    autoSelectFirst?: boolean;
     initialScrollIndex?: number;
     selectId?: string | number;
     autoLoad?: boolean;
@@ -613,6 +643,7 @@ export interface VListConfig<T extends ListItem = ListItem> {
         maintainDomOrder?: boolean;
     };
     selection?: ListSelectionConfig;
+    keyboard?: ListKeyboardConfig;
     on?: ListEventHandlers<T>;
 }
 export type VListComponent<T extends ListItem = ListItem> = ListComponent<T> & {

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

@@ -37,6 +37,12 @@ export interface ViewportConfig {
     element?: HTMLElement;
     className?: string;
     debug?: boolean;
+    /** ID of item to select after initial load completes */
+    selectId?: string | number;
+    /** Whether to automatically load data on initialization (default: true) */
+    autoLoad?: boolean;
+    /** Automatically select first item after initial load (default: false) */
+    autoSelectFirst?: boolean;
     template?: (item: any, index: number) => string | HTMLElement | any[] | Record<string, any>;
     collection?: {
         adapter?: any;