@classic-homes/theme-svelte 0.1.7 → 0.1.9

package/dist/lib/components/Alert.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { Snippet } from 'svelte';
 declare const Alert: import("svelte").Component<{
     [key: string]: unknown;
-    variant?: "default" | "destructive" | "error" | "success" | "warning" | "info" | undefined;
+    variant?: "default" | "destructive" | "warning" | "error" | "success" | "info" | undefined;
     class?: string;
     children: Snippet;
 }, {}, "">;

package/dist/lib/components/Badge.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { Snippet } from 'svelte';
 declare const Badge: import("svelte").Component<{
     [key: string]: unknown;
-    variant?: "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "info" | undefined;
+    variant?: "default" | "secondary" | "destructive" | "outline" | "warning" | "success" | "info" | undefined;
     size?: "default" | "sm" | "dot" | undefined;
     clickable?: boolean;
     class?: string;

package/dist/lib/components/Card.svelte

@@ -5,8 +5,14 @@
    * Features:
    * - Clean border styling with sharp look
    * - Optional hover shadow effect for interactive cards
-   * - Featured variant with thicker border (border-2)
+   * - Multiple variants: default, featured, highlight, warning
    * - Consistent with brand guidelines
+   *
+   * Variants:
+   * - default: Standard card with 1px border
+   * - featured: Thicker 2px border for emphasis
+   * - highlight: Teal border (brand-core-1) for positive/info callouts
+   * - warning: Red border (brand-red-primary) for warnings/alerts
    */
   import type { Snippet } from 'svelte';
   import { cn } from '../utils.js';
@@ -14,9 +20,15 @@
   interface Props {
     /** Enable hover shadow effect for interactive cards */
     interactive?: boolean;
-    /** Card variant - default has 1px border, featured has 2px border */
-    variant?: 'default' | 'featured';
-    /** Border color for featured variant */
+    /**
+     * Card variant
+     * - default: Standard 1px border
+     * - featured: Thicker 2px border
+     * - highlight: Teal border for positive/info callouts
+     * - warning: Red border for warnings/alerts
+     */
+    variant?: 'default' | 'featured' | 'highlight' | 'warning';
+    /** Border color override (ignored for highlight/warning variants) */
     borderColor?: 'default' | 'primary' | 'muted';
     /** Additional classes */
     class?: string;
@@ -39,15 +51,26 @@
     primary: 'border-primary',
     muted: 'border-gray-200',
   };
+
+  // Variant-specific border colors (highlight and warning override borderColor)
+  const variantBorderClasses = $derived({
+    default: borderColorClasses[borderColor],
+    featured: borderColorClasses[borderColor],
+    highlight: 'border-brand-core-1',
+    warning: 'border-brand-red-primary',
+  });
+
+  // Variants with thick borders
+  const thickBorderVariants = ['featured', 'highlight', 'warning'];
 </script>
 
 <div
   class={cn(
     'rounded-md bg-card text-card-foreground',
-    // Border thickness based on variant
-    variant === 'featured' ? 'border-2' : 'border',
-    // Border color
-    borderColorClasses[borderColor],
+    // Border thickness - thick for featured, highlight, warning
+    thickBorderVariants.includes(variant) ? 'border-2' : 'border',
+    // Border color based on variant
+    variantBorderClasses[variant],
     // Interactive hover effect
     interactive && 'hover:shadow-lg transition-shadow duration-200',
     className

package/dist/lib/components/Card.svelte.d.ts

@@ -4,16 +4,28 @@
    * Features:
    * - Clean border styling with sharp look
    * - Optional hover shadow effect for interactive cards
-   * - Featured variant with thicker border (border-2)
+   * - Multiple variants: default, featured, highlight, warning
    * - Consistent with brand guidelines
+   *
+   * Variants:
+   * - default: Standard card with 1px border
+   * - featured: Thicker 2px border for emphasis
+   * - highlight: Teal border (brand-core-1) for positive/info callouts
+   * - warning: Red border (brand-red-primary) for warnings/alerts
    */
 import type { Snippet } from 'svelte';
 interface Props {
     /** Enable hover shadow effect for interactive cards */
     interactive?: boolean;
-    /** Card variant - default has 1px border, featured has 2px border */
-    variant?: 'default' | 'featured';
-    /** Border color for featured variant */
+    /**
+     * Card variant
+     * - default: Standard 1px border
+     * - featured: Thicker 2px border
+     * - highlight: Teal border for positive/info callouts
+     * - warning: Red border for warnings/alerts
+     */
+    variant?: 'default' | 'featured' | 'highlight' | 'warning';
+    /** Border color override (ignored for highlight/warning variants) */
     borderColor?: 'default' | 'primary' | 'muted';
     /** Additional classes */
     class?: string;

package/dist/lib/components/Toast.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { Snippet } from 'svelte';
 declare const Toast: import("svelte").Component<{
     [key: string]: unknown;
-    type?: "error" | "success" | "warning" | "info" | undefined;
+    type?: "warning" | "error" | "success" | "info" | undefined;
     title?: string;
     message: string;
     class?: string;

package/dist/lib/composables/index.d.ts

@@ -6,3 +6,4 @@
  */
 export { useForm, type UseFormOptions, type UseFormReturn, type FieldError, type FormState, type InferFormData, } from './useForm.svelte.js';
 export { useAsync, runAsync, type UseAsyncOptions, type UseAsyncReturn, } from './useAsync.svelte.js';
+export { usePersistedForm, type UsePersistedFormOptions, type UsePersistedFormReturn, type InferPersistedFormData, } from './usePersistedForm.svelte.js';

package/dist/lib/composables/index.js

@@ -8,3 +8,5 @@
 export { useForm, } from './useForm.svelte.js';
 // Async operation composable
 export { useAsync, runAsync, } from './useAsync.svelte.js';
+// Persisted form composable with localStorage draft saving
+export { usePersistedForm, } from './usePersistedForm.svelte.js';

package/dist/lib/composables/useForm.svelte.d.ts

@@ -84,6 +84,8 @@ export interface UseFormReturn<T extends z.ZodObject<z.ZodRawShape>> {
     readonly data: z.infer<T>;
     /** Field errors (reactive) */
     readonly errors: Record<string, string>;
+    /** Global error message for API/submission errors (reactive) */
+    readonly globalError: string;
     /** Whether form is submitting (reactive) */
     readonly isSubmitting: boolean;
     /** Whether form has been submitted (reactive) */
@@ -110,8 +112,12 @@ export interface UseFormReturn<T extends z.ZodObject<z.ZodRawShape>> {
     clearErrors: () => void;
     /** Set a specific error */
     setError: (field: string, message: string) => void;
+    /** Set the global error message */
+    setGlobalError: (message: string) => void;
     /** Mark a field as dirty */
     markDirty: (field: string) => void;
+    /** Handle field blur - validates the field and marks dirty */
+    handleBlur: (field: keyof z.infer<T>) => void;
 }
 /**
  * Create a form handler with Zod validation and Svelte 5 runes

package/dist/lib/composables/useForm.svelte.js

@@ -51,12 +51,13 @@ export function useForm(options) {
     // Reactive state using Svelte 5 runes
     let data = $state(cloneInitialValues());
     let errors = $state({});
+    let globalError = $state('');
     let isSubmitting = $state(false);
     let isSubmitted = $state(false);
     let dirtyFields = $state(new Set());
     // Derived state
     const isDirty = $derived(dirtyFields.size > 0);
-    const isValid = $derived(Object.keys(errors).length === 0);
+    const isValid = $derived(Object.keys(errors).length === 0 && globalError === '');
     /**
      * Set nested value in object using dot notation path
      */
@@ -159,6 +160,9 @@ export function useForm(options) {
      */
     async function handleSubmit(event) {
         event?.preventDefault();
+        // Clear previous errors
+        errors = {};
+        globalError = '';
         isSubmitted = true;
         // Validate all fields
         if (!validate()) {
@@ -180,38 +184,56 @@ export function useForm(options) {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
+            const message = errorMessage || err.message || 'An error occurred';
+            // Set global error for display in form
+            globalError = message;
             if (onError) {
                 onError(err);
             }
             if (showToastOnError) {
-                toastStore.error(errorMessage || err.message || 'An error occurred');
+                toastStore.error(message);
             }
         }
         finally {
             isSubmitting = false;
         }
     }
+    /**
+     * Handle field blur - validates the field and marks dirty
+     */
+    function handleBlur(field) {
+        markDirty(field);
+        validateField(field);
+    }
     /**
      * Reset form to initial values
      */
     function reset() {
         data = cloneInitialValues();
         errors = {};
+        globalError = '';
         isSubmitted = false;
         dirtyFields = new Set();
     }
     /**
-     * Clear all errors
+     * Clear all errors (field and global)
      */
     function clearErrors() {
         errors = {};
+        globalError = '';
     }
     /**
-     * Set a specific error manually
+     * Set a specific field error manually
      */
     function setError(field, message) {
         errors = { ...errors, [field]: message };
     }
+    /**
+     * Set the global error message
+     */
+    function setGlobalError(message) {
+        globalError = message;
+    }
     return {
         get data() {
             return data;
@@ -219,6 +241,9 @@ export function useForm(options) {
         get errors() {
             return errors;
         },
+        get globalError() {
+            return globalError;
+        },
         get isSubmitting() {
             return isSubmitting;
         },
@@ -240,6 +265,8 @@ export function useForm(options) {
         reset,
         clearErrors,
         setError,
+        setGlobalError,
         markDirty,
+        handleBlur,
     };
 }

package/dist/lib/composables/usePersistedForm.svelte.d.ts

@@ -0,0 +1,78 @@
+/**
+ * usePersistedForm - Form state management with localStorage persistence
+ *
+ * Composes with useForm to add:
+ * - Automatic draft saving to localStorage with debounce
+ * - Draft restoration on mount
+ * - Configurable expiration time
+ * - Field exclusion from persistence (e.g., consent fields)
+ * - Duplicate submission prevention with cooldown
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { usePersistedForm } from '@classic-homes/theme-svelte';
+ *   import { z } from 'zod';
+ *
+ *   const schema = z.object({
+ *     email: z.string().email(),
+ *     name: z.string().min(1),
+ *     consent: z.boolean(),
+ *   });
+ *
+ *   const form = usePersistedForm({
+ *     schema,
+ *     initialValues: { email: '', name: '', consent: false },
+ *     onSubmit: async (data) => {
+ *       await submitForm(data);
+ *     },
+ *     storageKey: 'my-form-draft',
+ *     excludeFields: ['consent'], // Don't persist consent
+ *     expirationMs: 7 * 24 * 60 * 60 * 1000, // 7 days
+ *     onDraftRestored: () => {
+ *       console.log('Draft was restored');
+ *     },
+ *   });
+ * </script>
+ *
+ * <form onsubmit={form.handleSubmit}>
+ *   <input bind:value={form.data.email} />
+ *   {#if form.draftRestored}
+ *     <div>Your previous draft has been restored.</div>
+ *   {/if}
+ * </form>
+ * ```
+ */
+import { z } from 'zod';
+import { type UseFormOptions, type UseFormReturn } from './useForm.svelte.js';
+export interface UsePersistedFormOptions<T extends z.ZodObject<z.ZodRawShape>> extends UseFormOptions<T> {
+    /** localStorage key for draft persistence */
+    storageKey: string;
+    /** Fields to exclude from persistence (e.g., consent fields that require re-confirmation) */
+    excludeFields?: (keyof z.infer<T>)[];
+    /** Expiration time in milliseconds (default: 7 days) */
+    expirationMs?: number;
+    /** Callback when a draft is restored */
+    onDraftRestored?: () => void;
+    /** Debounce time for saving drafts in milliseconds (default: 500ms) */
+    debounceMs?: number;
+    /** Cooldown time between submissions in milliseconds (default: 5000ms) */
+    submitCooldownMs?: number;
+}
+export interface UsePersistedFormReturn<T extends z.ZodObject<z.ZodRawShape>> extends UseFormReturn<T> {
+    /** Whether a draft was restored on mount (reactive) */
+    readonly draftRestored: boolean;
+    /** Clear the stored draft */
+    clearDraft: () => void;
+    /** Dismiss the draft restored notification */
+    dismissDraftNotification: () => void;
+}
+/**
+ * Create a form handler with localStorage persistence
+ * Composes with useForm for all base functionality
+ */
+export declare function usePersistedForm<T extends z.ZodObject<z.ZodRawShape>>(options: UsePersistedFormOptions<T>): UsePersistedFormReturn<T>;
+/**
+ * Type helper to extract form data type from schema
+ */
+export type InferPersistedFormData<T extends z.ZodObject<z.ZodRawShape>> = z.infer<T>;

package/dist/lib/composables/usePersistedForm.svelte.js

@@ -0,0 +1,260 @@
+/**
+ * usePersistedForm - Form state management with localStorage persistence
+ *
+ * Composes with useForm to add:
+ * - Automatic draft saving to localStorage with debounce
+ * - Draft restoration on mount
+ * - Configurable expiration time
+ * - Field exclusion from persistence (e.g., consent fields)
+ * - Duplicate submission prevention with cooldown
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { usePersistedForm } from '@classic-homes/theme-svelte';
+ *   import { z } from 'zod';
+ *
+ *   const schema = z.object({
+ *     email: z.string().email(),
+ *     name: z.string().min(1),
+ *     consent: z.boolean(),
+ *   });
+ *
+ *   const form = usePersistedForm({
+ *     schema,
+ *     initialValues: { email: '', name: '', consent: false },
+ *     onSubmit: async (data) => {
+ *       await submitForm(data);
+ *     },
+ *     storageKey: 'my-form-draft',
+ *     excludeFields: ['consent'], // Don't persist consent
+ *     expirationMs: 7 * 24 * 60 * 60 * 1000, // 7 days
+ *     onDraftRestored: () => {
+ *       console.log('Draft was restored');
+ *     },
+ *   });
+ * </script>
+ *
+ * <form onsubmit={form.handleSubmit}>
+ *   <input bind:value={form.data.email} />
+ *   {#if form.draftRestored}
+ *     <div>Your previous draft has been restored.</div>
+ *   {/if}
+ * </form>
+ * ```
+ */
+import { useForm } from './useForm.svelte.js';
+import { toastStore } from '../stores/toast.svelte.js';
+const DEFAULT_EXPIRATION_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const DEFAULT_DEBOUNCE_MS = 500;
+const DEFAULT_SUBMIT_COOLDOWN_MS = 5000;
+/**
+ * Check if localStorage is available (also checks for browser environment)
+ */
+function isStorageAvailable() {
+    if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+        return false;
+    }
+    try {
+        const test = '__storage_test__';
+        localStorage.setItem(test, test);
+        localStorage.removeItem(test);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a form handler with localStorage persistence
+ * Composes with useForm for all base functionality
+ */
+export function usePersistedForm(options) {
+    const { storageKey, excludeFields = [], expirationMs = DEFAULT_EXPIRATION_MS, onDraftRestored, debounceMs = DEFAULT_DEBOUNCE_MS, submitCooldownMs = DEFAULT_SUBMIT_COOLDOWN_MS, onSubmit, initialValues, ...baseOptions } = options;
+    // Persistence state
+    let draftRestored = $state(false);
+    let lastSubmitTime = $state(0);
+    let debounceTimer = null;
+    /**
+     * Load draft from localStorage
+     */
+    function loadDraft() {
+        if (!isStorageAvailable())
+            return null;
+        try {
+            const stored = localStorage.getItem(storageKey);
+            if (!stored)
+                return null;
+            const draft = JSON.parse(stored);
+            // Check if draft has expired
+            if (Date.now() - draft.timestamp > expirationMs) {
+                clearDraft();
+                return null;
+            }
+            return draft.data;
+        }
+        catch {
+            // Silently fail - corrupt data
+            return null;
+        }
+    }
+    /**
+     * Clear draft from localStorage
+     */
+    function clearDraft() {
+        if (!isStorageAvailable())
+            return;
+        try {
+            localStorage.removeItem(storageKey);
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Get the initial values, merging with any restored draft
+     */
+    function getInitialValues() {
+        const draft = loadDraft();
+        if (draft && Object.keys(draft).length > 0) {
+            // Schedule callback for after initialization
+            if (typeof window !== 'undefined') {
+                queueMicrotask(() => {
+                    draftRestored = true;
+                    onDraftRestored?.();
+                });
+            }
+            // Merge draft with initial values (keeps excluded fields at defaults)
+            return { ...JSON.parse(JSON.stringify(initialValues)), ...draft };
+        }
+        return JSON.parse(JSON.stringify(initialValues));
+    }
+    /**
+     * Wrapped onSubmit with cooldown and draft clearing
+     */
+    async function wrappedOnSubmit(data) {
+        // Check for duplicate submission
+        const now = Date.now();
+        if (now - lastSubmitTime < submitCooldownMs) {
+            toastStore.warning('Please wait before submitting again');
+            throw new Error('Submission cooldown active');
+        }
+        try {
+            await onSubmit(data);
+            lastSubmitTime = now;
+            // Clear draft on successful submission
+            clearDraft();
+        }
+        catch (error) {
+            // Reset cooldown on error to allow retry
+            lastSubmitTime = 0;
+            throw error;
+        }
+    }
+    // Create base form with potentially restored initial values
+    const baseForm = useForm({
+        ...baseOptions,
+        initialValues: getInitialValues(),
+        onSubmit: wrappedOnSubmit,
+    });
+    /**
+     * Get data to persist (excludes specified fields)
+     */
+    function getDataToPersist() {
+        const dataCopy = { ...baseForm.data };
+        for (const field of excludeFields) {
+            delete dataCopy[field];
+        }
+        return dataCopy;
+    }
+    /**
+     * Save draft to localStorage with debounce
+     */
+    function saveDraft() {
+        if (!isStorageAvailable())
+            return;
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            try {
+                const draft = {
+                    data: getDataToPersist(),
+                    timestamp: Date.now(),
+                };
+                localStorage.setItem(storageKey, JSON.stringify(draft));
+            }
+            catch (error) {
+                // Silently fail - localStorage may be full or unavailable
+                console.warn('Failed to save form draft', error);
+            }
+        }, debounceMs);
+    }
+    // Watch for form changes and save draft
+    $effect(() => {
+        // Access data to create dependency
+        JSON.stringify(baseForm.data);
+        if (baseForm.isDirty) {
+            saveDraft();
+        }
+    });
+    /**
+     * Extended reset that also clears the draft
+     */
+    function reset() {
+        baseForm.reset();
+        draftRestored = false;
+        clearDraft();
+    }
+    /**
+     * Dismiss the draft restored notification
+     */
+    function dismissDraftNotification() {
+        draftRestored = false;
+    }
+    return {
+        // Delegate all base form properties
+        get data() {
+            return baseForm.data;
+        },
+        get errors() {
+            return baseForm.errors;
+        },
+        get globalError() {
+            return baseForm.globalError;
+        },
+        get isSubmitting() {
+            return baseForm.isSubmitting;
+        },
+        get isSubmitted() {
+            return baseForm.isSubmitted;
+        },
+        get isDirty() {
+            return baseForm.isDirty;
+        },
+        get isValid() {
+            return baseForm.isValid;
+        },
+        // Persistence-specific properties
+        get draftRestored() {
+            return draftRestored;
+        },
+        // Delegate base form methods
+        setField: baseForm.setField,
+        setFields: baseForm.setFields,
+        setNestedField: baseForm.setNestedField,
+        validateField: baseForm.validateField,
+        validate: baseForm.validate,
+        handleSubmit: baseForm.handleSubmit,
+        clearErrors: baseForm.clearErrors,
+        setError: baseForm.setError,
+        setGlobalError: baseForm.setGlobalError,
+        markDirty: baseForm.markDirty,
+        handleBlur: baseForm.handleBlur,
+        // Override reset to also clear draft
+        reset,
+        // Persistence-specific methods
+        clearDraft,
+        dismissDraftNotification,
+    };
+}

package/dist/lib/index.d.ts

@@ -72,5 +72,5 @@ export { cn } from './utils.js';
 export { tv, type VariantProps } from 'tailwind-variants';
 export { validateNonEmptyArray, validateRequired, validateOneOf, validateRange, validateProps, createValidator, type ValidationResult, } from './validation.js';
 export { perfStart, perfEnd, measure, measureAsync, getPerformanceEntries, clearPerformanceEntries, createPerfMonitor, type PerformanceMark, } from './performance.js';
-export { useForm, useAsync, runAsync, type UseFormOptions, type UseFormReturn, type FieldError, type FormState, type InferFormData, type UseAsyncOptions, type UseAsyncReturn, } from './composables/index.js';
+export { useForm, useAsync, runAsync, usePersistedForm, type UseFormOptions, type UseFormReturn, type FieldError, type FormState, type InferFormData, type UseAsyncOptions, type UseAsyncReturn, type UsePersistedFormOptions, type UsePersistedFormReturn, type InferPersistedFormData, } from './composables/index.js';
 export * from './schemas/index.js';

package/dist/lib/index.js

@@ -89,6 +89,6 @@ export { validateNonEmptyArray, validateRequired, validateOneOf, validateRange,
 // Performance monitoring utilities (dev-only, tree-shaken in production)
 export { perfStart, perfEnd, measure, measureAsync, getPerformanceEntries, clearPerformanceEntries, createPerfMonitor, } from './performance.js';
 // Composables - reusable Svelte 5 state management patterns
-export { useForm, useAsync, runAsync, } from './composables/index.js';
+export { useForm, useAsync, runAsync, usePersistedForm, } from './composables/index.js';
 // Validation schemas - Zod schemas for forms and data validation
 export * from './schemas/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/theme-svelte",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Svelte components for the Classic theme system",
   "type": "module",
   "svelte": "./dist/lib/index.js",