@seed-ship/mcp-ui-solid 1.2.2 → 2.0.0

package/dist/hooks/useFormPersistence.cjs

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+const STORAGE_PREFIX = "mcp-ui-form:";
+const DEFAULT_DEBOUNCE = 500;
+const STORAGE_VERSION = 1;
+function useFormPersistence(options) {
+  const storageKey = `${STORAGE_PREFIX}${options.persistKey}`;
+  let debounceTimer;
+  let isInitialized = false;
+  const getStorage = () => {
+    if (options.storage !== void 0) {
+      return options.storage;
+    }
+    if (typeof window !== "undefined" && window.localStorage) {
+      return window.localStorage;
+    }
+    return null;
+  };
+  solidJs.onMount(() => {
+    const storage = getStorage();
+    if (!storage) return;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (stored) {
+        const parsed = JSON.parse(stored);
+        if (parsed.version !== STORAGE_VERSION) {
+          storage.removeItem(storageKey);
+          return;
+        }
+        if (options.expiresIn) {
+          const elapsed = Date.now() - parsed.timestamp;
+          if (elapsed > options.expiresIn) {
+            storage.removeItem(storageKey);
+            return;
+          }
+        }
+        const currentData = options.formData();
+        const mergedData = { ...currentData, ...parsed.data };
+        options.setFormData(mergedData);
+      }
+    } catch (e) {
+      console.warn("[useFormPersistence] Failed to restore form data:", e);
+    }
+    isInitialized = true;
+  });
+  solidJs.createEffect(() => {
+    const data = options.formData();
+    if (!isInitialized) return;
+    const storage = getStorage();
+    if (!storage) return;
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(() => {
+      try {
+        const toStore = { ...data };
+        for (const field of options.excludeFields || []) {
+          delete toStore[field];
+        }
+        if (Object.keys(toStore).length === 0) {
+          storage.removeItem(storageKey);
+          return;
+        }
+        const stored = {
+          data: toStore,
+          timestamp: Date.now(),
+          version: STORAGE_VERSION
+        };
+        storage.setItem(storageKey, JSON.stringify(stored));
+      } catch (e) {
+        console.warn("[useFormPersistence] Failed to persist form data:", e);
+      }
+    }, options.debounce ?? DEFAULT_DEBOUNCE);
+  });
+  solidJs.onCleanup(() => {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+  });
+  const clearPersisted = () => {
+    const storage = getStorage();
+    if (storage) {
+      storage.removeItem(storageKey);
+    }
+  };
+  const hasPersisted = () => {
+    const storage = getStorage();
+    if (!storage) return false;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (!stored) return false;
+      const parsed = JSON.parse(stored);
+      if (parsed.version !== STORAGE_VERSION) return false;
+      if (options.expiresIn) {
+        const elapsed = Date.now() - parsed.timestamp;
+        if (elapsed > options.expiresIn) return false;
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const getPersistedTimestamp = () => {
+    const storage = getStorage();
+    if (!storage) return null;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (!stored) return null;
+      const parsed = JSON.parse(stored);
+      return parsed.timestamp;
+    } catch {
+      return null;
+    }
+  };
+  return {
+    clearPersisted,
+    hasPersisted,
+    getPersistedTimestamp
+  };
+}
+exports.useFormPersistence = useFormPersistence;
+//# sourceMappingURL=useFormPersistence.cjs.map

package/dist/hooks/useFormPersistence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormPersistence.cjs","sources":["../../src/hooks/useFormPersistence.ts"],"sourcesContent":["/**\n * useFormPersistence - Save/restore form data to localStorage\n * Sprint 4: State & Charts\n */\n\nimport { Accessor, createEffect, onMount, onCleanup } from 'solid-js'\n\nconst STORAGE_PREFIX = 'mcp-ui-form:'\nconst DEFAULT_DEBOUNCE = 500\n\n/**\n * Options for form persistence\n */\nexport interface UseFormPersistenceOptions {\n  /**\n   * Unique key for storage\n   */\n  persistKey: string\n\n  /**\n   * Form data accessor\n   */\n  formData: Accessor<Record<string, unknown>>\n\n  /**\n   * Setter for form data\n   */\n  setFormData: (data: Record<string, unknown>) => void\n\n  /**\n   * Debounce delay in ms (default: 500)\n   */\n  debounce?: number\n\n  /**\n   * Fields to exclude from persistence (e.g., passwords)\n   */\n  excludeFields?: string[]\n\n  /**\n   * Expiry time in ms (default: none)\n   */\n  expiresIn?: number\n\n  /**\n   * Storage provider (default: localStorage)\n   * Useful for SSR or testing\n   */\n  storage?: Storage | null\n}\n\n/**\n * Stored data structure with timestamp for expiry\n */\ninterface StoredData {\n  data: Record<string, unknown>\n  timestamp: number\n  version: number\n}\n\nconst STORAGE_VERSION = 1\n\n/**\n * Return type for useFormPersistence hook\n */\nexport interface UseFormPersistenceReturn {\n  /**\n   * Clear persisted data from storage\n   */\n  clearPersisted: () => void\n\n  /**\n   * Check if there is persisted data\n   */\n  hasPersisted: () => boolean\n\n  /**\n   * Get the timestamp of persisted data\n   */\n  getPersistedTimestamp: () => number | null\n}\n\n/**\n * Hook for persisting form data to localStorage\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [formData, setFormData] = createSignal({})\n *\n *   const { clearPersisted } = useFormPersistence({\n *     persistKey: 'my-form-draft',\n *     formData,\n *     setFormData,\n *     excludeFields: ['password'],\n *     expiresIn: 7 * 24 * 60 * 60 * 1000, // 7 days\n *   })\n *\n *   const handleSubmit = () => {\n *     // Submit form\n *     clearPersisted() // Clear draft after successful submit\n *   }\n * }\n * ```\n */\nexport function useFormPersistence(options: UseFormPersistenceOptions): UseFormPersistenceReturn {\n  const storageKey = `${STORAGE_PREFIX}${options.persistKey}`\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n  let isInitialized = false\n\n  // Get storage (default to localStorage, with SSR safety)\n  const getStorage = (): Storage | null => {\n    if (options.storage !== undefined) {\n      return options.storage\n    }\n    // SSR-safe check for localStorage\n    if (typeof window !== 'undefined' && window.localStorage) {\n      return window.localStorage\n    }\n    return null\n  }\n\n  // Restore on mount\n  onMount(() => {\n    const storage = getStorage()\n    if (!storage) return\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (stored) {\n        const parsed: StoredData = JSON.parse(stored)\n\n        // Check version\n        if (parsed.version !== STORAGE_VERSION) {\n          storage.removeItem(storageKey)\n          return\n        }\n\n        // Check expiry\n        if (options.expiresIn) {\n          const elapsed = Date.now() - parsed.timestamp\n          if (elapsed > options.expiresIn) {\n            storage.removeItem(storageKey)\n            return\n          }\n        }\n\n        // Merge with existing form data (don't overwrite)\n        const currentData = options.formData()\n        const mergedData = { ...currentData, ...parsed.data }\n        options.setFormData(mergedData)\n      }\n    } catch (e) {\n      console.warn('[useFormPersistence] Failed to restore form data:', e)\n    }\n\n    isInitialized = true\n  })\n\n  // Save on change (debounced)\n  createEffect(() => {\n    const data = options.formData()\n\n    // Don't save before initialization (would save initial/empty state)\n    if (!isInitialized) return\n\n    const storage = getStorage()\n    if (!storage) return\n\n    if (debounceTimer) {\n      clearTimeout(debounceTimer)\n    }\n\n    debounceTimer = setTimeout(() => {\n      try {\n        // Filter excluded fields\n        const toStore = { ...data }\n        for (const field of options.excludeFields || []) {\n          delete toStore[field]\n        }\n\n        // Don't store empty data\n        if (Object.keys(toStore).length === 0) {\n          storage.removeItem(storageKey)\n          return\n        }\n\n        const stored: StoredData = {\n          data: toStore,\n          timestamp: Date.now(),\n          version: STORAGE_VERSION,\n        }\n\n        storage.setItem(storageKey, JSON.stringify(stored))\n      } catch (e) {\n        console.warn('[useFormPersistence] Failed to persist form data:', e)\n      }\n    }, options.debounce ?? DEFAULT_DEBOUNCE)\n  })\n\n  // Cleanup timer on unmount\n  onCleanup(() => {\n    if (debounceTimer) {\n      clearTimeout(debounceTimer)\n    }\n  })\n\n  // Clear persisted data\n  const clearPersisted = () => {\n    const storage = getStorage()\n    if (storage) {\n      storage.removeItem(storageKey)\n    }\n  }\n\n  // Check if there is persisted data\n  const hasPersisted = (): boolean => {\n    const storage = getStorage()\n    if (!storage) return false\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (!stored) return false\n\n      const parsed: StoredData = JSON.parse(stored)\n\n      // Check version\n      if (parsed.version !== STORAGE_VERSION) return false\n\n      // Check expiry\n      if (options.expiresIn) {\n        const elapsed = Date.now() - parsed.timestamp\n        if (elapsed > options.expiresIn) return false\n      }\n\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  // Get timestamp of persisted data\n  const getPersistedTimestamp = (): number | null => {\n    const storage = getStorage()\n    if (!storage) return null\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (!stored) return null\n\n      const parsed: StoredData = JSON.parse(stored)\n      return parsed.timestamp\n    } catch {\n      return null\n    }\n  }\n\n  return {\n    clearPersisted,\n    hasPersisted,\n    getPersistedTimestamp,\n  }\n}\n"],"names":["onMount","createEffect","onCleanup"],"mappings":"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"}

package/dist/hooks/useFormPersistence.d.ts

@@ -0,0 +1,81 @@
+/**
+ * useFormPersistence - Save/restore form data to localStorage
+ * Sprint 4: State & Charts
+ */
+import { Accessor } from 'solid-js';
+/**
+ * Options for form persistence
+ */
+export interface UseFormPersistenceOptions {
+    /**
+     * Unique key for storage
+     */
+    persistKey: string;
+    /**
+     * Form data accessor
+     */
+    formData: Accessor<Record<string, unknown>>;
+    /**
+     * Setter for form data
+     */
+    setFormData: (data: Record<string, unknown>) => void;
+    /**
+     * Debounce delay in ms (default: 500)
+     */
+    debounce?: number;
+    /**
+     * Fields to exclude from persistence (e.g., passwords)
+     */
+    excludeFields?: string[];
+    /**
+     * Expiry time in ms (default: none)
+     */
+    expiresIn?: number;
+    /**
+     * Storage provider (default: localStorage)
+     * Useful for SSR or testing
+     */
+    storage?: Storage | null;
+}
+/**
+ * Return type for useFormPersistence hook
+ */
+export interface UseFormPersistenceReturn {
+    /**
+     * Clear persisted data from storage
+     */
+    clearPersisted: () => void;
+    /**
+     * Check if there is persisted data
+     */
+    hasPersisted: () => boolean;
+    /**
+     * Get the timestamp of persisted data
+     */
+    getPersistedTimestamp: () => number | null;
+}
+/**
+ * Hook for persisting form data to localStorage
+ *
+ * @example
+ * ```tsx
+ * function MyForm() {
+ *   const [formData, setFormData] = createSignal({})
+ *
+ *   const { clearPersisted } = useFormPersistence({
+ *     persistKey: 'my-form-draft',
+ *     formData,
+ *     setFormData,
+ *     excludeFields: ['password'],
+ *     expiresIn: 7 * 24 * 60 * 60 * 1000, // 7 days
+ *   })
+ *
+ *   const handleSubmit = () => {
+ *     // Submit form
+ *     clearPersisted() // Clear draft after successful submit
+ *   }
+ * }
+ * ```
+ */
+export declare function useFormPersistence(options: UseFormPersistenceOptions): UseFormPersistenceReturn;
+//# sourceMappingURL=useFormPersistence.d.ts.map

package/dist/hooks/useFormPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormPersistence.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormPersistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAoC,MAAM,UAAU,CAAA;AAKrE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAE3C;;OAEG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAEpD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CACzB;AAaD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAA;IAE1B;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAA;IAE3B;;OAEG;IACH,qBAAqB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB,CA6J/F"}

package/dist/hooks/useFormPersistence.js

@@ -0,0 +1,123 @@
+import { onMount, createEffect, onCleanup } from "solid-js";
+const STORAGE_PREFIX = "mcp-ui-form:";
+const DEFAULT_DEBOUNCE = 500;
+const STORAGE_VERSION = 1;
+function useFormPersistence(options) {
+  const storageKey = `${STORAGE_PREFIX}${options.persistKey}`;
+  let debounceTimer;
+  let isInitialized = false;
+  const getStorage = () => {
+    if (options.storage !== void 0) {
+      return options.storage;
+    }
+    if (typeof window !== "undefined" && window.localStorage) {
+      return window.localStorage;
+    }
+    return null;
+  };
+  onMount(() => {
+    const storage = getStorage();
+    if (!storage) return;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (stored) {
+        const parsed = JSON.parse(stored);
+        if (parsed.version !== STORAGE_VERSION) {
+          storage.removeItem(storageKey);
+          return;
+        }
+        if (options.expiresIn) {
+          const elapsed = Date.now() - parsed.timestamp;
+          if (elapsed > options.expiresIn) {
+            storage.removeItem(storageKey);
+            return;
+          }
+        }
+        const currentData = options.formData();
+        const mergedData = { ...currentData, ...parsed.data };
+        options.setFormData(mergedData);
+      }
+    } catch (e) {
+      console.warn("[useFormPersistence] Failed to restore form data:", e);
+    }
+    isInitialized = true;
+  });
+  createEffect(() => {
+    const data = options.formData();
+    if (!isInitialized) return;
+    const storage = getStorage();
+    if (!storage) return;
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(() => {
+      try {
+        const toStore = { ...data };
+        for (const field of options.excludeFields || []) {
+          delete toStore[field];
+        }
+        if (Object.keys(toStore).length === 0) {
+          storage.removeItem(storageKey);
+          return;
+        }
+        const stored = {
+          data: toStore,
+          timestamp: Date.now(),
+          version: STORAGE_VERSION
+        };
+        storage.setItem(storageKey, JSON.stringify(stored));
+      } catch (e) {
+        console.warn("[useFormPersistence] Failed to persist form data:", e);
+      }
+    }, options.debounce ?? DEFAULT_DEBOUNCE);
+  });
+  onCleanup(() => {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+  });
+  const clearPersisted = () => {
+    const storage = getStorage();
+    if (storage) {
+      storage.removeItem(storageKey);
+    }
+  };
+  const hasPersisted = () => {
+    const storage = getStorage();
+    if (!storage) return false;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (!stored) return false;
+      const parsed = JSON.parse(stored);
+      if (parsed.version !== STORAGE_VERSION) return false;
+      if (options.expiresIn) {
+        const elapsed = Date.now() - parsed.timestamp;
+        if (elapsed > options.expiresIn) return false;
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const getPersistedTimestamp = () => {
+    const storage = getStorage();
+    if (!storage) return null;
+    try {
+      const stored = storage.getItem(storageKey);
+      if (!stored) return null;
+      const parsed = JSON.parse(stored);
+      return parsed.timestamp;
+    } catch {
+      return null;
+    }
+  };
+  return {
+    clearPersisted,
+    hasPersisted,
+    getPersistedTimestamp
+  };
+}
+export {
+  useFormPersistence
+};
+//# sourceMappingURL=useFormPersistence.js.map

package/dist/hooks/useFormPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormPersistence.js","sources":["../../src/hooks/useFormPersistence.ts"],"sourcesContent":["/**\n * useFormPersistence - Save/restore form data to localStorage\n * Sprint 4: State & Charts\n */\n\nimport { Accessor, createEffect, onMount, onCleanup } from 'solid-js'\n\nconst STORAGE_PREFIX = 'mcp-ui-form:'\nconst DEFAULT_DEBOUNCE = 500\n\n/**\n * Options for form persistence\n */\nexport interface UseFormPersistenceOptions {\n  /**\n   * Unique key for storage\n   */\n  persistKey: string\n\n  /**\n   * Form data accessor\n   */\n  formData: Accessor<Record<string, unknown>>\n\n  /**\n   * Setter for form data\n   */\n  setFormData: (data: Record<string, unknown>) => void\n\n  /**\n   * Debounce delay in ms (default: 500)\n   */\n  debounce?: number\n\n  /**\n   * Fields to exclude from persistence (e.g., passwords)\n   */\n  excludeFields?: string[]\n\n  /**\n   * Expiry time in ms (default: none)\n   */\n  expiresIn?: number\n\n  /**\n   * Storage provider (default: localStorage)\n   * Useful for SSR or testing\n   */\n  storage?: Storage | null\n}\n\n/**\n * Stored data structure with timestamp for expiry\n */\ninterface StoredData {\n  data: Record<string, unknown>\n  timestamp: number\n  version: number\n}\n\nconst STORAGE_VERSION = 1\n\n/**\n * Return type for useFormPersistence hook\n */\nexport interface UseFormPersistenceReturn {\n  /**\n   * Clear persisted data from storage\n   */\n  clearPersisted: () => void\n\n  /**\n   * Check if there is persisted data\n   */\n  hasPersisted: () => boolean\n\n  /**\n   * Get the timestamp of persisted data\n   */\n  getPersistedTimestamp: () => number | null\n}\n\n/**\n * Hook for persisting form data to localStorage\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [formData, setFormData] = createSignal({})\n *\n *   const { clearPersisted } = useFormPersistence({\n *     persistKey: 'my-form-draft',\n *     formData,\n *     setFormData,\n *     excludeFields: ['password'],\n *     expiresIn: 7 * 24 * 60 * 60 * 1000, // 7 days\n *   })\n *\n *   const handleSubmit = () => {\n *     // Submit form\n *     clearPersisted() // Clear draft after successful submit\n *   }\n * }\n * ```\n */\nexport function useFormPersistence(options: UseFormPersistenceOptions): UseFormPersistenceReturn {\n  const storageKey = `${STORAGE_PREFIX}${options.persistKey}`\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n  let isInitialized = false\n\n  // Get storage (default to localStorage, with SSR safety)\n  const getStorage = (): Storage | null => {\n    if (options.storage !== undefined) {\n      return options.storage\n    }\n    // SSR-safe check for localStorage\n    if (typeof window !== 'undefined' && window.localStorage) {\n      return window.localStorage\n    }\n    return null\n  }\n\n  // Restore on mount\n  onMount(() => {\n    const storage = getStorage()\n    if (!storage) return\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (stored) {\n        const parsed: StoredData = JSON.parse(stored)\n\n        // Check version\n        if (parsed.version !== STORAGE_VERSION) {\n          storage.removeItem(storageKey)\n          return\n        }\n\n        // Check expiry\n        if (options.expiresIn) {\n          const elapsed = Date.now() - parsed.timestamp\n          if (elapsed > options.expiresIn) {\n            storage.removeItem(storageKey)\n            return\n          }\n        }\n\n        // Merge with existing form data (don't overwrite)\n        const currentData = options.formData()\n        const mergedData = { ...currentData, ...parsed.data }\n        options.setFormData(mergedData)\n      }\n    } catch (e) {\n      console.warn('[useFormPersistence] Failed to restore form data:', e)\n    }\n\n    isInitialized = true\n  })\n\n  // Save on change (debounced)\n  createEffect(() => {\n    const data = options.formData()\n\n    // Don't save before initialization (would save initial/empty state)\n    if (!isInitialized) return\n\n    const storage = getStorage()\n    if (!storage) return\n\n    if (debounceTimer) {\n      clearTimeout(debounceTimer)\n    }\n\n    debounceTimer = setTimeout(() => {\n      try {\n        // Filter excluded fields\n        const toStore = { ...data }\n        for (const field of options.excludeFields || []) {\n          delete toStore[field]\n        }\n\n        // Don't store empty data\n        if (Object.keys(toStore).length === 0) {\n          storage.removeItem(storageKey)\n          return\n        }\n\n        const stored: StoredData = {\n          data: toStore,\n          timestamp: Date.now(),\n          version: STORAGE_VERSION,\n        }\n\n        storage.setItem(storageKey, JSON.stringify(stored))\n      } catch (e) {\n        console.warn('[useFormPersistence] Failed to persist form data:', e)\n      }\n    }, options.debounce ?? DEFAULT_DEBOUNCE)\n  })\n\n  // Cleanup timer on unmount\n  onCleanup(() => {\n    if (debounceTimer) {\n      clearTimeout(debounceTimer)\n    }\n  })\n\n  // Clear persisted data\n  const clearPersisted = () => {\n    const storage = getStorage()\n    if (storage) {\n      storage.removeItem(storageKey)\n    }\n  }\n\n  // Check if there is persisted data\n  const hasPersisted = (): boolean => {\n    const storage = getStorage()\n    if (!storage) return false\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (!stored) return false\n\n      const parsed: StoredData = JSON.parse(stored)\n\n      // Check version\n      if (parsed.version !== STORAGE_VERSION) return false\n\n      // Check expiry\n      if (options.expiresIn) {\n        const elapsed = Date.now() - parsed.timestamp\n        if (elapsed > options.expiresIn) return false\n      }\n\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  // Get timestamp of persisted data\n  const getPersistedTimestamp = (): number | null => {\n    const storage = getStorage()\n    if (!storage) return null\n\n    try {\n      const stored = storage.getItem(storageKey)\n      if (!stored) return null\n\n      const parsed: StoredData = JSON.parse(stored)\n      return parsed.timestamp\n    } catch {\n      return null\n    }\n  }\n\n  return {\n    clearPersisted,\n    hasPersisted,\n    getPersistedTimestamp,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/hooks/useModal.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+function useModal(initialOpen = false) {
+  const [isOpen, setIsOpen] = solidJs.createSignal(initialOpen);
+  const open = () => setIsOpen(true);
+  const close = () => setIsOpen(false);
+  const toggle = () => setIsOpen((prev) => !prev);
+  return { isOpen, open, close, toggle };
+}
+function useConfirmModal() {
+  const [isOpen, setIsOpen] = solidJs.createSignal(false);
+  const [resolveRef, setResolveRef] = solidJs.createSignal(null);
+  const confirm = () => {
+    return new Promise((resolve) => {
+      setResolveRef(() => resolve);
+      setIsOpen(true);
+    });
+  };
+  const handleConfirm = () => {
+    var _a;
+    (_a = resolveRef()) == null ? void 0 : _a(true);
+    setResolveRef(null);
+    setIsOpen(false);
+  };
+  const handleCancel = () => {
+    var _a;
+    (_a = resolveRef()) == null ? void 0 : _a(false);
+    setResolveRef(null);
+    setIsOpen(false);
+  };
+  return {
+    isOpen,
+    confirm,
+    handleConfirm,
+    handleCancel
+  };
+}
+exports.useConfirmModal = useConfirmModal;
+exports.useModal = useModal;
+//# sourceMappingURL=useModal.cjs.map

package/dist/hooks/useModal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModal.cjs","sources":["../../src/hooks/useModal.ts"],"sourcesContent":["/**\n * useModal - Hooks for modal state management\n * Sprint 3: UX Improvements\n */\n\nimport { createSignal, Accessor } from 'solid-js'\n\n/**\n * Return type for useModal hook\n */\nexport interface UseModalReturn {\n  /**\n   * Whether the modal is currently open\n   */\n  isOpen: Accessor<boolean>\n\n  /**\n   * Open the modal\n   */\n  open: () => void\n\n  /**\n   * Close the modal\n   */\n  close: () => void\n\n  /**\n   * Toggle the modal open/closed state\n   */\n  toggle: () => void\n}\n\n/**\n * Hook for managing modal open/close state\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { isOpen, open, close } = useModal()\n *\n *   return (\n *     <>\n *       <button onClick={open}>Open Modal</button>\n *       <ModalRenderer\n *         isOpen={isOpen()}\n *         onClose={close}\n *         params={{ title: 'My Modal' }}\n *       >\n *         <p>Modal content</p>\n *       </ModalRenderer>\n *     </>\n *   )\n * }\n * ```\n */\nexport function useModal(initialOpen = false): UseModalReturn {\n  const [isOpen, setIsOpen] = createSignal(initialOpen)\n\n  const open = () => setIsOpen(true)\n  const close = () => setIsOpen(false)\n  const toggle = () => setIsOpen((prev) => !prev)\n\n  return { isOpen, open, close, toggle }\n}\n\n/**\n * Return type for useConfirmModal hook\n */\nexport interface UseConfirmModalReturn {\n  /**\n   * Whether the confirm modal is currently open\n   */\n  isOpen: Accessor<boolean>\n\n  /**\n   * Show the confirm dialog and return a promise that resolves to true/false\n   */\n  confirm: () => Promise<boolean>\n\n  /**\n   * Call this when user confirms (resolves promise with true)\n   */\n  handleConfirm: () => void\n\n  /**\n   * Call this when user cancels (resolves promise with false)\n   */\n  handleCancel: () => void\n}\n\n/**\n * Hook for confirmation dialogs that return a promise\n *\n * @example\n * ```tsx\n * function DeleteButton() {\n *   const { isOpen, confirm, handleConfirm, handleCancel } = useConfirmModal()\n *\n *   const handleDelete = async () => {\n *     const confirmed = await confirm()\n *     if (confirmed) {\n *       await deleteItem()\n *     }\n *   }\n *\n *   return (\n *     <>\n *       <button onClick={handleDelete}>Delete</button>\n *       <ModalRenderer\n *         isOpen={isOpen()}\n *         onClose={handleCancel}\n *         params={{ title: 'Confirm Delete', size: 'sm' }}\n *       >\n *         <p>Are you sure you want to delete this item?</p>\n *         <div class=\"flex gap-2 mt-4\">\n *           <button onClick={handleCancel}>Cancel</button>\n *           <button onClick={handleConfirm}>Delete</button>\n *         </div>\n *       </ModalRenderer>\n *     </>\n *   )\n * }\n * ```\n */\nexport function useConfirmModal(): UseConfirmModalReturn {\n  const [isOpen, setIsOpen] = createSignal(false)\n  const [resolveRef, setResolveRef] = createSignal<((value: boolean) => void) | null>(null)\n\n  const confirm = (): Promise<boolean> => {\n    return new Promise((resolve) => {\n      setResolveRef(() => resolve)\n      setIsOpen(true)\n    })\n  }\n\n  const handleConfirm = () => {\n    resolveRef()?.(true)\n    setResolveRef(null)\n    setIsOpen(false)\n  }\n\n  const handleCancel = () => {\n    resolveRef()?.(false)\n    setResolveRef(null)\n    setIsOpen(false)\n  }\n\n  return {\n    isOpen,\n    confirm,\n    handleConfirm,\n    handleCancel,\n  }\n}\n"],"names":["createSignal"],"mappings":";;;AAuDO,SAAS,SAAS,cAAc,OAAuB;AAC5D,QAAM,CAAC,QAAQ,SAAS,IAAIA,QAAAA,aAAa,WAAW;AAEpD,QAAM,OAAO,MAAM,UAAU,IAAI;AACjC,QAAM,QAAQ,MAAM,UAAU,KAAK;AACnC,QAAM,SAAS,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI;AAE9C,SAAO,EAAE,QAAQ,MAAM,OAAO,OAAA;AAChC;AA6DO,SAAS,kBAAyC;AACvD,QAAM,CAAC,QAAQ,SAAS,IAAIA,QAAAA,aAAa,KAAK;AAC9C,QAAM,CAAC,YAAY,aAAa,IAAIA,QAAAA,aAAgD,IAAI;AAExF,QAAM,UAAU,MAAwB;AACtC,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,oBAAc,MAAM,OAAO;AAC3B,gBAAU,IAAI;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,QAAM,gBAAgB,MAAM;;AAC1B,qBAAA,MAAA,mBAAe;AACf,kBAAc,IAAI;AAClB,cAAU,KAAK;AAAA,EACjB;AAEA,QAAM,eAAe,MAAM;;AACzB,qBAAA,MAAA,mBAAe;AACf,kBAAc,IAAI;AAClB,cAAU,KAAK;AAAA,EACjB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;;"}

package/dist/hooks/useModal.d.ts

@@ -0,0 +1,107 @@
+/**
+ * useModal - Hooks for modal state management
+ * Sprint 3: UX Improvements
+ */
+import { Accessor } from 'solid-js';
+/**
+ * Return type for useModal hook
+ */
+export interface UseModalReturn {
+    /**
+     * Whether the modal is currently open
+     */
+    isOpen: Accessor<boolean>;
+    /**
+     * Open the modal
+     */
+    open: () => void;
+    /**
+     * Close the modal
+     */
+    close: () => void;
+    /**
+     * Toggle the modal open/closed state
+     */
+    toggle: () => void;
+}
+/**
+ * Hook for managing modal open/close state
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isOpen, open, close } = useModal()
+ *
+ *   return (
+ *     <>
+ *       <button onClick={open}>Open Modal</button>
+ *       <ModalRenderer
+ *         isOpen={isOpen()}
+ *         onClose={close}
+ *         params={{ title: 'My Modal' }}
+ *       >
+ *         <p>Modal content</p>
+ *       </ModalRenderer>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export declare function useModal(initialOpen?: boolean): UseModalReturn;
+/**
+ * Return type for useConfirmModal hook
+ */
+export interface UseConfirmModalReturn {
+    /**
+     * Whether the confirm modal is currently open
+     */
+    isOpen: Accessor<boolean>;
+    /**
+     * Show the confirm dialog and return a promise that resolves to true/false
+     */
+    confirm: () => Promise<boolean>;
+    /**
+     * Call this when user confirms (resolves promise with true)
+     */
+    handleConfirm: () => void;
+    /**
+     * Call this when user cancels (resolves promise with false)
+     */
+    handleCancel: () => void;
+}
+/**
+ * Hook for confirmation dialogs that return a promise
+ *
+ * @example
+ * ```tsx
+ * function DeleteButton() {
+ *   const { isOpen, confirm, handleConfirm, handleCancel } = useConfirmModal()
+ *
+ *   const handleDelete = async () => {
+ *     const confirmed = await confirm()
+ *     if (confirmed) {
+ *       await deleteItem()
+ *     }
+ *   }
+ *
+ *   return (
+ *     <>
+ *       <button onClick={handleDelete}>Delete</button>
+ *       <ModalRenderer
+ *         isOpen={isOpen()}
+ *         onClose={handleCancel}
+ *         params={{ title: 'Confirm Delete', size: 'sm' }}
+ *       >
+ *         <p>Are you sure you want to delete this item?</p>
+ *         <div class="flex gap-2 mt-4">
+ *           <button onClick={handleCancel}>Cancel</button>
+ *           <button onClick={handleConfirm}>Delete</button>
+ *         </div>
+ *       </ModalRenderer>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export declare function useConfirmModal(): UseConfirmModalReturn;
+//# sourceMappingURL=useModal.d.ts.map

package/dist/hooks/useModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../src/hooks/useModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEzB;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAA;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,WAAW,UAAQ,GAAG,cAAc,CAQ5D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEzB;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAE/B;;OAEG;IACH,aAAa,EAAE,MAAM,IAAI,CAAA;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CA6BvD"}

package/dist/hooks/useModal.js

@@ -0,0 +1,41 @@
+import { createSignal } from "solid-js";
+function useModal(initialOpen = false) {
+  const [isOpen, setIsOpen] = createSignal(initialOpen);
+  const open = () => setIsOpen(true);
+  const close = () => setIsOpen(false);
+  const toggle = () => setIsOpen((prev) => !prev);
+  return { isOpen, open, close, toggle };
+}
+function useConfirmModal() {
+  const [isOpen, setIsOpen] = createSignal(false);
+  const [resolveRef, setResolveRef] = createSignal(null);
+  const confirm = () => {
+    return new Promise((resolve) => {
+      setResolveRef(() => resolve);
+      setIsOpen(true);
+    });
+  };
+  const handleConfirm = () => {
+    var _a;
+    (_a = resolveRef()) == null ? void 0 : _a(true);
+    setResolveRef(null);
+    setIsOpen(false);
+  };
+  const handleCancel = () => {
+    var _a;
+    (_a = resolveRef()) == null ? void 0 : _a(false);
+    setResolveRef(null);
+    setIsOpen(false);
+  };
+  return {
+    isOpen,
+    confirm,
+    handleConfirm,
+    handleCancel
+  };
+}
+export {
+  useConfirmModal,
+  useModal
+};
+//# sourceMappingURL=useModal.js.map

package/dist/hooks/useModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModal.js","sources":["../../src/hooks/useModal.ts"],"sourcesContent":["/**\n * useModal - Hooks for modal state management\n * Sprint 3: UX Improvements\n */\n\nimport { createSignal, Accessor } from 'solid-js'\n\n/**\n * Return type for useModal hook\n */\nexport interface UseModalReturn {\n  /**\n   * Whether the modal is currently open\n   */\n  isOpen: Accessor<boolean>\n\n  /**\n   * Open the modal\n   */\n  open: () => void\n\n  /**\n   * Close the modal\n   */\n  close: () => void\n\n  /**\n   * Toggle the modal open/closed state\n   */\n  toggle: () => void\n}\n\n/**\n * Hook for managing modal open/close state\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { isOpen, open, close } = useModal()\n *\n *   return (\n *     <>\n *       <button onClick={open}>Open Modal</button>\n *       <ModalRenderer\n *         isOpen={isOpen()}\n *         onClose={close}\n *         params={{ title: 'My Modal' }}\n *       >\n *         <p>Modal content</p>\n *       </ModalRenderer>\n *     </>\n *   )\n * }\n * ```\n */\nexport function useModal(initialOpen = false): UseModalReturn {\n  const [isOpen, setIsOpen] = createSignal(initialOpen)\n\n  const open = () => setIsOpen(true)\n  const close = () => setIsOpen(false)\n  const toggle = () => setIsOpen((prev) => !prev)\n\n  return { isOpen, open, close, toggle }\n}\n\n/**\n * Return type for useConfirmModal hook\n */\nexport interface UseConfirmModalReturn {\n  /**\n   * Whether the confirm modal is currently open\n   */\n  isOpen: Accessor<boolean>\n\n  /**\n   * Show the confirm dialog and return a promise that resolves to true/false\n   */\n  confirm: () => Promise<boolean>\n\n  /**\n   * Call this when user confirms (resolves promise with true)\n   */\n  handleConfirm: () => void\n\n  /**\n   * Call this when user cancels (resolves promise with false)\n   */\n  handleCancel: () => void\n}\n\n/**\n * Hook for confirmation dialogs that return a promise\n *\n * @example\n * ```tsx\n * function DeleteButton() {\n *   const { isOpen, confirm, handleConfirm, handleCancel } = useConfirmModal()\n *\n *   const handleDelete = async () => {\n *     const confirmed = await confirm()\n *     if (confirmed) {\n *       await deleteItem()\n *     }\n *   }\n *\n *   return (\n *     <>\n *       <button onClick={handleDelete}>Delete</button>\n *       <ModalRenderer\n *         isOpen={isOpen()}\n *         onClose={handleCancel}\n *         params={{ title: 'Confirm Delete', size: 'sm' }}\n *       >\n *         <p>Are you sure you want to delete this item?</p>\n *         <div class=\"flex gap-2 mt-4\">\n *           <button onClick={handleCancel}>Cancel</button>\n *           <button onClick={handleConfirm}>Delete</button>\n *         </div>\n *       </ModalRenderer>\n *     </>\n *   )\n * }\n * ```\n */\nexport function useConfirmModal(): UseConfirmModalReturn {\n  const [isOpen, setIsOpen] = createSignal(false)\n  const [resolveRef, setResolveRef] = createSignal<((value: boolean) => void) | null>(null)\n\n  const confirm = (): Promise<boolean> => {\n    return new Promise((resolve) => {\n      setResolveRef(() => resolve)\n      setIsOpen(true)\n    })\n  }\n\n  const handleConfirm = () => {\n    resolveRef()?.(true)\n    setResolveRef(null)\n    setIsOpen(false)\n  }\n\n  const handleCancel = () => {\n    resolveRef()?.(false)\n    setResolveRef(null)\n    setIsOpen(false)\n  }\n\n  return {\n    isOpen,\n    confirm,\n    handleConfirm,\n    handleCancel,\n  }\n}\n"],"names":[],"mappings":";AAuDO,SAAS,SAAS,cAAc,OAAuB;AAC5D,QAAM,CAAC,QAAQ,SAAS,IAAI,aAAa,WAAW;AAEpD,QAAM,OAAO,MAAM,UAAU,IAAI;AACjC,QAAM,QAAQ,MAAM,UAAU,KAAK;AACnC,QAAM,SAAS,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI;AAE9C,SAAO,EAAE,QAAQ,MAAM,OAAO,OAAA;AAChC;AA6DO,SAAS,kBAAyC;AACvD,QAAM,CAAC,QAAQ,SAAS,IAAI,aAAa,KAAK;AAC9C,QAAM,CAAC,YAAY,aAAa,IAAI,aAAgD,IAAI;AAExF,QAAM,UAAU,MAAwB;AACtC,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,oBAAc,MAAM,OAAO;AAC3B,gBAAU,IAAI;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,QAAM,gBAAgB,MAAM;;AAC1B,qBAAA,MAAA,mBAAe;AACf,kBAAc,IAAI;AAClB,cAAU,KAAK;AAAA,EACjB;AAEA,QAAM,eAAe,MAAM;;AACzB,qBAAA,MAAA,mBAAe;AACf,kBAAc,IAAI;AAClB,cAAU,KAAK;AAAA,EACjB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/hooks.cjs

@@ -2,7 +2,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const useStreamingUI = require("./hooks/useStreamingUI.cjs");
 const useAction = require("./hooks/useAction.cjs");
+const useConditionalField = require("./hooks/useConditionalField.cjs");
+const useModal = require("./hooks/useModal.cjs");
+const useFormPersistence = require("./hooks/useFormPersistence.cjs");
 exports.useStreamingUI = useStreamingUI.useStreamingUI;
 exports.useAction = useAction.useAction;
 exports.useToolAction = useAction.useToolAction;
+exports.evaluateCondition = useConditionalField.evaluateCondition;
+exports.useConditionalField = useConditionalField.useConditionalField;
+exports.useConfirmModal = useModal.useConfirmModal;
+exports.useModal = useModal.useModal;
+exports.useFormPersistence = useFormPersistence.useFormPersistence;
 //# sourceMappingURL=hooks.cjs.map

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
+{"version":3,"file":"hooks.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/hooks.d.cts

@@ -0,0 +1,16 @@
+/**
+ * MCP UI Solid - Hooks
+ *
+ * SolidJS hooks for managing UI resource state and streaming
+ */
+export { useStreamingUI } from './useStreamingUI';
+export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, } from './useStreamingUI';
+export { useAction, useToolAction } from './useAction';
+export type { UseActionReturn, UseActionOptions, UseToolActionReturn, ActionRequest, ActionResult, } from './useAction';
+export { useConditionalField, evaluateCondition } from './useConditionalField';
+export type { UseConditionalFieldOptions } from './useConditionalField';
+export { useModal, useConfirmModal } from './useModal';
+export type { UseModalReturn, UseConfirmModalReturn } from './useModal';
+export { useFormPersistence } from './useFormPersistence';
+export type { UseFormPersistenceOptions, UseFormPersistenceReturn } from './useFormPersistence';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks.d.ts

@@ -6,5 +6,11 @@
 export { useStreamingUI } from './useStreamingUI';
 export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, } from './useStreamingUI';
 export { useAction, useToolAction } from './useAction';
-export type { UseActionReturn, ActionRequest, ActionResult } from './useAction';
+export type { UseActionReturn, UseActionOptions, UseToolActionReturn, ActionRequest, ActionResult, } from './useAction';
+export { useConditionalField, evaluateCondition } from './useConditionalField';
+export type { UseConditionalFieldOptions } from './useConditionalField';
+export { useModal, useConfirmModal } from './useModal';
+export type { UseModalReturn, UseConfirmModalReturn } from './useModal';
+export { useFormPersistence } from './useFormPersistence';
+export type { UseFormPersistenceOptions, UseFormPersistenceReturn } from './useFormPersistence';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks.js

@@ -1,7 +1,15 @@
 import { useStreamingUI } from "./hooks/useStreamingUI.js";
 import { useAction, useToolAction } from "./hooks/useAction.js";
+import { evaluateCondition, useConditionalField } from "./hooks/useConditionalField.js";
+import { useConfirmModal, useModal } from "./hooks/useModal.js";
+import { useFormPersistence } from "./hooks/useFormPersistence.js";
 export {
+  evaluateCondition,
   useAction,
+  useConditionalField,
+  useConfirmModal,
+  useFormPersistence,
+  useModal,
   useStreamingUI,
   useToolAction
 };

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"hooks.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}