mtrl-addons 0.3.4 → 0.3.6

package/dist/components/form/constants.d.ts

@@ -43,6 +43,8 @@ export declare const FORM_CLASSES: {
     readonly SUBMITTING: "submitting";
     /** Applied when form is disabled */
     readonly DISABLED: "disabled";
+    /** Applied when form body is scrolled away from top */
+    readonly SCROLLED: "mtrl-form--scrolled";
 };
 /**
  * Default form configuration

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

@@ -32,9 +32,11 @@ interface EnhancedFormComponent extends BaseFormComponent {
     enableFields: () => void;
     disableFields: () => void;
     validate: () => FormValidationResult;
+    validateField: (fieldName: string) => string | undefined;
     submit: (options?: FormSubmitOptions) => Promise<unknown>;
     setValidationRules: (rules: import("../types").FormValidationRule[]) => void;
     clearErrors: () => void;
+    clearFieldError: (field: string) => void;
     setFieldError: (field: string, error: string) => void;
     getFieldError: (field: string) => string | undefined;
     on?: (event: string, handler: Function) => void;

package/dist/components/form/features/fields.d.ts

@@ -33,6 +33,11 @@ export declare const updateTrackedFieldValue: (name: string, value: FieldValue)
  * Called after silent setData to sync deduplication state
  */
 export declare const syncTrackedFieldValues: (fields: FormFieldRegistry) => void;
+/**
+ * Resets the field value tracker for a new form
+ * Should be called at the start of withFields before bindFieldEvents
+ */
+export declare const resetFieldValueTracker: () => void;
 /**
  * withFields feature
  * Adds field extraction and registry management to the form

package/dist/components/form/features/index.d.ts

@@ -3,7 +3,7 @@
  * Each feature adds specific capabilities to the form component
  */
 export { withLayout } from "./layout";
-export { withFields, getFieldValue, setFieldValue, updateTrackedFieldValue, syncTrackedFieldValues, } from "./fields";
+export { withFields, getFieldValue, setFieldValue, updateTrackedFieldValue, syncTrackedFieldValues, resetFieldValueTracker, } from "./fields";
 export { withData, flatToNested, getNestedValue, setNestedValue } from "./data";
 export { withController } from "./controller";
 export { withSubmit, validateData, performRequest } from "./submit";

package/dist/components/form/features/layout.d.ts

@@ -7,5 +7,6 @@ export declare const withLayout: (config: FormConfig) => <T extends BaseFormComp
     form: HTMLFormElement;
     ui: Record<string, unknown>;
     layoutResult: unknown;
+    _cleanupScrollIndicator?: () => void;
 };
 export default withLayout;

package/dist/components/form/features/submit.d.ts

@@ -1,12 +1,16 @@
 /**
  * Submit feature for Form component
- * Handles form validation and submission
+ * Handles form validation and submission with automatic field error display
  */
 import type { FormConfig, BaseFormComponent, FormData, FormState, FormFieldRegistry, FormValidationRule, FormValidationResult, FormSubmitOptions } from "../types";
 /**
  * Validates form data against validation rules
  */
 declare const validateData: (data: FormData, rules: FormValidationRule[]) => FormValidationResult;
+/**
+ * Validates a single field against its validation rules
+ */
+declare const validateField: (fieldName: string, data: FormData, rules: FormValidationRule[]) => string | undefined;
 /**
  * Performs the actual HTTP request
  */
@@ -23,13 +27,16 @@ export declare const withSubmit: (config: FormConfig) => <T extends BaseFormComp
     disableControls: () => void;
     snapshot: () => void;
     emit?: (event: string, data?: unknown) => void;
+    on?: (event: string, handler: (data: unknown) => void) => void;
 }>(component: T) => T & {
     validate: () => FormValidationResult;
+    validateField: (fieldName: string) => string | undefined;
     submit: (options?: FormSubmitOptions) => Promise<unknown>;
     setValidationRules: (rules: FormValidationRule[]) => void;
     clearErrors: () => void;
+    clearFieldError: (field: string) => void;
     setFieldError: (field: string, error: string) => void;
     getFieldError: (field: string) => string | undefined;
 };
-export { validateData, performRequest };
+export { validateData, validateField, performRequest };
 export default withSubmit;

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

@@ -31,6 +31,10 @@ export interface FormField {
     disable?: () => void;
     /** Check if field is disabled */
     isDisabled?: () => boolean;
+    /** Set error state with optional message */
+    setError?: (error: boolean, message?: string) => void;
+    /** Check if field has error */
+    isError?: () => boolean;
     /** Add event listener */
     on?: (event: string, handler: Function) => void;
     /** Remove event listener */
@@ -157,6 +161,8 @@ export interface FormConfig {
     data?: FormData;
     /** Validation rules */
     validation?: FormValidationRule[];
+    /** Whether to show error messages in field helper text (default: true) */
+    showFieldErrorMessages?: boolean;
     /** Event handlers */
     on?: FormEventHandlers;
     /** Container element to append form to */
@@ -199,8 +205,18 @@ export interface FormAPI {
     isModified: () => boolean;
     /** Get current data state (pristine or dirty) */
     getDataState: () => DataState;
-    /** Validate the form */
+    /** Validate the form (shows errors on fields automatically) */
     validate: () => FormValidationResult;
+    /** Validate a single field */
+    validateField: (fieldName: string) => string | undefined;
+    /** Clear all validation errors */
+    clearErrors: () => FormComponent;
+    /** Clear error for a specific field */
+    clearFieldError: (field: string) => FormComponent;
+    /** Set error for a specific field */
+    setFieldError: (field: string, error: string) => FormComponent;
+    /** Get error for a specific field */
+    getFieldError: (field: string) => string | undefined;
     /** Submit the form */
     submit: (options?: FormSubmitOptions) => Promise<unknown>;
     /** Reset form to initial data */