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

package/dist/hooks/index.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/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAGvE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACtD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/hooks/useAction.cjs

@@ -2,38 +2,104 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const solidJs = require("solid-js");
 const MCPActionContext = require("../context/MCPActionContext.cjs");
-function useAction() {
+function useAction(options = {}) {
   const context = MCPActionContext.useMCPActionSafe();
   const [lastError, setLastError] = solidJs.createSignal();
-  const execute = async (toolName, params) => {
+  const [lastRequest, setLastRequest] = solidJs.createSignal();
+  const [retryAttempt, setRetryAttempt] = solidJs.createSignal(0);
+  const executeWithLifecycle = async (request) => {
+    var _a, _b, _c;
     setLastError(void 0);
-    const result = await context.executeAction({
-      toolName,
-      params
-    });
-    if (!result.success && result.error) {
+    setLastRequest(request);
+    if (options.onBefore) {
+      const shouldProceed = await options.onBefore({
+        toolName: request.toolName,
+        params: request.params
+      });
+      if (!shouldProceed) {
+        const cancelledResult = {
+          success: false,
+          error: "Action cancelled by onBefore callback",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          toolName: request.toolName
+        };
+        return cancelledResult;
+      }
+    }
+    const result = await context.executeAction(request);
+    if (result.success) {
+      (_a = options.onSuccess) == null ? void 0 : _a.call(options, {
+        success: result.success,
+        data: result.data,
+        timestamp: result.timestamp,
+        toolName: result.toolName
+      });
+    } else {
       setLastError(result.error);
+      (_b = options.onError) == null ? void 0 : _b.call(options, result.error || "Unknown error", {
+        toolName: request.toolName,
+        params: request.params
+      });
     }
+    (_c = options.onComplete) == null ? void 0 : _c.call(options, {
+      success: result.success,
+      data: result.data,
+      error: result.error,
+      timestamp: result.timestamp,
+      toolName: result.toolName
+    });
     return result;
   };
+  const execute = async (toolName, params) => {
+    setRetryAttempt(0);
+    return executeWithLifecycle({ toolName, params });
+  };
   const executeAction = async (request) => {
-    setLastError(void 0);
-    const result = await context.executeAction(request);
-    if (!result.success && result.error) {
-      setLastError(result.error);
+    setRetryAttempt(0);
+    return executeWithLifecycle(request);
+  };
+  const retry = async () => {
+    const request = lastRequest();
+    if (!request) return void 0;
+    const maxRetries = options.retryCount || 3;
+    const attempt = retryAttempt() + 1;
+    if (attempt > maxRetries) {
+      setLastError(`Max retries (${maxRetries}) exceeded`);
+      return void 0;
     }
-    return result;
+    setRetryAttempt(attempt);
+    if (options.retryDelay) {
+      await new Promise((r) => setTimeout(r, options.retryDelay));
+    }
+    return executeWithLifecycle(request);
+  };
+  const clearError = () => setLastError(void 0);
+  const reset = () => {
+    setLastError(void 0);
+    setLastRequest(void 0);
+    setRetryAttempt(0);
   };
   return {
     execute,
     executeAction,
     isExecuting: context.isExecuting,
     lastResult: context.lastResult,
-    lastError
+    lastError,
+    retry,
+    clearError,
+    reset
   };
 }
-function useToolAction(toolName) {
-  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction();
+function useToolAction(toolName, options = {}) {
+  const {
+    execute: baseExecute,
+    isExecuting,
+    lastResult,
+    lastError,
+    retry,
+    clearError,
+    reset
+  } = useAction(options);
   const execute = async (params) => {
     return baseExecute(toolName, params);
   };
@@ -41,7 +107,10 @@ function useToolAction(toolName) {
     execute,
     isExecuting,
     lastResult,
-    lastError
+    lastError,
+    retry,
+    clearError,
+    reset
   };
 }
 exports.useAction = useAction;

package/dist/hooks/useAction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useAction.cjs","sources":["../../src/hooks/useAction.ts"],"sourcesContent":["/**\n * useAction - Hook for executing MCP actions from components\n * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components\n */\n\nimport { createSignal, Accessor } from 'solid-js'\nimport { useMCPActionSafe, ActionRequest, ActionResult } from '../context/MCPActionContext'\n\n/**\n * Return type for useAction hook\n */\nexport interface UseActionReturn {\n  /**\n   * Execute a tool action\n   */\n  execute: (toolName: string, params?: Record<string, any>) => Promise<ActionResult>\n\n  /**\n   * Full execute with ActionRequest\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last result from action execution\n   */\n  lastResult: Accessor<ActionResult | undefined>\n\n  /**\n   * Last error (if any)\n   */\n  lastError: Accessor<string | undefined>\n}\n\n/**\n * Hook for executing MCP actions\n *\n * @example\n * ```tsx\n * function MyButton() {\n *   const { execute, isExecuting, lastError } = useAction()\n *\n *   const handleClick = async () => {\n *     const result = await execute('search.hub', { query: 'test' })\n *     if (result.success) {\n *       console.log('Data:', result.data)\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick} disabled={isExecuting()}>\n *       {isExecuting() ? 'Loading...' : 'Search'}\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useAction(): UseActionReturn {\n  const context = useMCPActionSafe()\n  const [lastError, setLastError] = createSignal<string>()\n\n  const execute = async (toolName: string, params?: Record<string, any>): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction({\n      toolName,\n      params,\n    })\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction(request)\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  return {\n    execute,\n    executeAction,\n    isExecuting: context.isExecuting,\n    lastResult: context.lastResult,\n    lastError,\n  }\n}\n\n/**\n * Hook for binding action to a specific tool\n *\n * @example\n * ```tsx\n * function SearchButton() {\n *   const { execute, isExecuting } = useToolAction('search.hub')\n *\n *   return (\n *     <button onClick={() => execute({ query: 'test' })} disabled={isExecuting()}>\n *       Search\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useToolAction(toolName: string): {\n  execute: (params?: Record<string, any>) => Promise<ActionResult>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ActionResult | undefined>\n  lastError: Accessor<string | undefined>\n} {\n  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction()\n\n  const execute = async (params?: Record<string, any>): Promise<ActionResult> => {\n    return baseExecute(toolName, params)\n  }\n\n  return {\n    execute,\n    isExecuting,\n    lastResult,\n    lastError,\n  }\n}\n\nexport type { ActionRequest, ActionResult }\n"],"names":["useMCPActionSafe","createSignal"],"mappings":";;;;AA6DO,SAAS,YAA6B;AAC3C,QAAM,UAAUA,iBAAAA,iBAAA;AAChB,QAAM,CAAC,WAAW,YAAY,IAAIC,qBAAA;AAElC,QAAM,UAAU,OAAO,UAAkB,WAAwD;AAC/F,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc;AAAA,MACzC;AAAA,MACA;AAAA,IAAA,CACD;AAED,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,OAAO,YAAkD;AAC7E,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc,OAAO;AAElD,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB;AAAA,EAAA;AAEJ;AAkBO,SAAS,cAAc,UAK5B;AACA,QAAM,EAAE,SAAS,aAAa,aAAa,YAAY,UAAA,IAAc,UAAA;AAErE,QAAM,UAAU,OAAO,WAAwD;AAC7E,WAAO,YAAY,UAAU,MAAM;AAAA,EACrC;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;;"}
+{"version":3,"file":"useAction.cjs","sources":["../../src/hooks/useAction.ts"],"sourcesContent":["/**\n * useAction - Hook for executing MCP actions from components\n * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components\n * Sprint 2: Lifecycle callbacks and retry support\n */\n\nimport { createSignal, Accessor } from 'solid-js'\nimport { useMCPActionSafe, ActionRequest, ActionResult } from '../context/MCPActionContext'\nimport type { ActionLifecycleCallbacks } from '../types'\n\n/**\n * Options for useAction hook\n */\nexport interface UseActionOptions extends ActionLifecycleCallbacks {\n  /**\n   * Number of retry attempts on failure\n   */\n  retryCount?: number\n\n  /**\n   * Delay between retries in milliseconds\n   */\n  retryDelay?: number\n}\n\n/**\n * Return type for useAction hook\n */\nexport interface UseActionReturn {\n  /**\n   * Execute a tool action\n   */\n  execute: (toolName: string, params?: Record<string, any>) => Promise<ActionResult>\n\n  /**\n   * Full execute with ActionRequest\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last result from action execution\n   */\n  lastResult: Accessor<ActionResult | undefined>\n\n  /**\n   * Last error (if any)\n   */\n  lastError: Accessor<string | undefined>\n\n  /**\n   * Retry the last failed action\n   */\n  retry: () => Promise<ActionResult | undefined>\n\n  /**\n   * Clear the last error\n   */\n  clearError: () => void\n\n  /**\n   * Reset all state\n   */\n  reset: () => void\n}\n\n/**\n * Hook for executing MCP actions\n *\n * @example\n * ```tsx\n * function MyButton() {\n *   const { execute, isExecuting, lastError } = useAction()\n *\n *   const handleClick = async () => {\n *     const result = await execute('search.hub', { query: 'test' })\n *     if (result.success) {\n *       console.log('Data:', result.data)\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick} disabled={isExecuting()}>\n *       {isExecuting() ? 'Loading...' : 'Search'}\n *     </button>\n *   )\n * }\n * ```\n *\n * @example With lifecycle callbacks\n * ```tsx\n * function MyActionButton() {\n *   const { execute, retry, clearError, lastError } = useAction({\n *     onBefore: (req) => {\n *       console.log('About to execute:', req.toolName)\n *       return true // proceed\n *     },\n *     onSuccess: (result) => {\n *       toast.success('Action completed!')\n *     },\n *     onError: (error) => {\n *       toast.error(`Action failed: ${error}`)\n *     },\n *     retryCount: 3,\n *     retryDelay: 1000,\n *   })\n *\n *   return (\n *     <div>\n *       <button onClick={() => execute('search.hub', { query: 'test' })}>\n *         Search\n *       </button>\n *       <Show when={lastError()}>\n *         <button onClick={retry}>Retry</button>\n *         <button onClick={clearError}>Dismiss</button>\n *       </Show>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useAction(options: UseActionOptions = {}): UseActionReturn {\n  const context = useMCPActionSafe()\n  const [lastError, setLastError] = createSignal<string>()\n  const [lastRequest, setLastRequest] = createSignal<ActionRequest>()\n  const [retryAttempt, setRetryAttempt] = createSignal(0)\n\n  const executeWithLifecycle = async (request: ActionRequest): Promise<ActionResult> => {\n    setLastError(undefined)\n    setLastRequest(request)\n\n    // onBefore callback (can cancel)\n    if (options.onBefore) {\n      const shouldProceed = await options.onBefore({\n        toolName: request.toolName,\n        params: request.params,\n      })\n      if (!shouldProceed) {\n        const cancelledResult: ActionResult = {\n          success: false,\n          error: 'Action cancelled by onBefore callback',\n          timestamp: new Date().toISOString(),\n          toolName: request.toolName,\n        }\n        return cancelledResult\n      }\n    }\n\n    const result = await context.executeAction(request)\n\n    if (result.success) {\n      options.onSuccess?.({\n        success: result.success,\n        data: result.data,\n        timestamp: result.timestamp,\n        toolName: result.toolName,\n      })\n    } else {\n      setLastError(result.error)\n      options.onError?.(result.error || 'Unknown error', {\n        toolName: request.toolName,\n        params: request.params,\n      })\n    }\n\n    options.onComplete?.({\n      success: result.success,\n      data: result.data,\n      error: result.error,\n      timestamp: result.timestamp,\n      toolName: result.toolName,\n    })\n\n    return result\n  }\n\n  const execute = async (toolName: string, params?: Record<string, any>): Promise<ActionResult> => {\n    setRetryAttempt(0)\n    return executeWithLifecycle({ toolName, params })\n  }\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setRetryAttempt(0)\n    return executeWithLifecycle(request)\n  }\n\n  const retry = async (): Promise<ActionResult | undefined> => {\n    const request = lastRequest()\n    if (!request) return undefined\n\n    const maxRetries = options.retryCount || 3\n    const attempt = retryAttempt() + 1\n\n    if (attempt > maxRetries) {\n      setLastError(`Max retries (${maxRetries}) exceeded`)\n      return undefined\n    }\n\n    setRetryAttempt(attempt)\n\n    if (options.retryDelay) {\n      await new Promise((r) => setTimeout(r, options.retryDelay))\n    }\n\n    return executeWithLifecycle(request)\n  }\n\n  const clearError = () => setLastError(undefined)\n\n  const reset = () => {\n    setLastError(undefined)\n    setLastRequest(undefined)\n    setRetryAttempt(0)\n  }\n\n  return {\n    execute,\n    executeAction,\n    isExecuting: context.isExecuting,\n    lastResult: context.lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  }\n}\n\n/**\n * Return type for useToolAction hook\n */\nexport interface UseToolActionReturn {\n  execute: (params?: Record<string, any>) => Promise<ActionResult>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ActionResult | undefined>\n  lastError: Accessor<string | undefined>\n  retry: () => Promise<ActionResult | undefined>\n  clearError: () => void\n  reset: () => void\n}\n\n/**\n * Hook for binding action to a specific tool\n *\n * @example\n * ```tsx\n * function SearchButton() {\n *   const { execute, isExecuting } = useToolAction('search.hub')\n *\n *   return (\n *     <button onClick={() => execute({ query: 'test' })} disabled={isExecuting()}>\n *       Search\n *     </button>\n *   )\n * }\n * ```\n *\n * @example With lifecycle callbacks\n * ```tsx\n * function SearchButton() {\n *   const { execute, retry, lastError } = useToolAction('search.hub', {\n *     onSuccess: (result) => toast.success('Search complete!'),\n *     onError: (error) => toast.error(`Search failed: ${error}`),\n *     retryCount: 2,\n *   })\n *\n *   return (\n *     <div>\n *       <button onClick={() => execute({ query: 'test' })}>Search</button>\n *       <Show when={lastError()}>\n *         <button onClick={retry}>Retry</button>\n *       </Show>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useToolAction(\n  toolName: string,\n  options: UseActionOptions = {}\n): UseToolActionReturn {\n  const {\n    execute: baseExecute,\n    isExecuting,\n    lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  } = useAction(options)\n\n  const execute = async (params?: Record<string, any>): Promise<ActionResult> => {\n    return baseExecute(toolName, params)\n  }\n\n  return {\n    execute,\n    isExecuting,\n    lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  }\n}\n\nexport type { ActionRequest, ActionResult }\n"],"names":["useMCPActionSafe","createSignal"],"mappings":"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"}

package/dist/hooks/useAction.d.ts

@@ -1,9 +1,24 @@
 /**
  * useAction - Hook for executing MCP actions from components
  * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components
+ * Sprint 2: Lifecycle callbacks and retry support
  */
 import { Accessor } from 'solid-js';
 import { ActionRequest, ActionResult } from '../context/MCPActionContext';
+import type { ActionLifecycleCallbacks } from '../types';
+/**
+ * Options for useAction hook
+ */
+export interface UseActionOptions extends ActionLifecycleCallbacks {
+    /**
+     * Number of retry attempts on failure
+     */
+    retryCount?: number;
+    /**
+     * Delay between retries in milliseconds
+     */
+    retryDelay?: number;
+}
 /**
  * Return type for useAction hook
  */
@@ -28,6 +43,18 @@ export interface UseActionReturn {
      * Last error (if any)
      */
     lastError: Accessor<string | undefined>;
+    /**
+     * Retry the last failed action
+     */
+    retry: () => Promise<ActionResult | undefined>;
+    /**
+     * Clear the last error
+     */
+    clearError: () => void;
+    /**
+     * Reset all state
+     */
+    reset: () => void;
 }
 /**
  * Hook for executing MCP actions
@@ -51,8 +78,52 @@ export interface UseActionReturn {
  *   )
  * }
  * ```
+ *
+ * @example With lifecycle callbacks
+ * ```tsx
+ * function MyActionButton() {
+ *   const { execute, retry, clearError, lastError } = useAction({
+ *     onBefore: (req) => {
+ *       console.log('About to execute:', req.toolName)
+ *       return true // proceed
+ *     },
+ *     onSuccess: (result) => {
+ *       toast.success('Action completed!')
+ *     },
+ *     onError: (error) => {
+ *       toast.error(`Action failed: ${error}`)
+ *     },
+ *     retryCount: 3,
+ *     retryDelay: 1000,
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => execute('search.hub', { query: 'test' })}>
+ *         Search
+ *       </button>
+ *       <Show when={lastError()}>
+ *         <button onClick={retry}>Retry</button>
+ *         <button onClick={clearError}>Dismiss</button>
+ *       </Show>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
-export declare function useAction(): UseActionReturn;
+export declare function useAction(options?: UseActionOptions): UseActionReturn;
+/**
+ * Return type for useToolAction hook
+ */
+export interface UseToolActionReturn {
+    execute: (params?: Record<string, any>) => Promise<ActionResult>;
+    isExecuting: Accessor<boolean>;
+    lastResult: Accessor<ActionResult | undefined>;
+    lastError: Accessor<string | undefined>;
+    retry: () => Promise<ActionResult | undefined>;
+    clearError: () => void;
+    reset: () => void;
+}
 /**
  * Hook for binding action to a specific tool
  *
@@ -68,12 +139,27 @@ export declare function useAction(): UseActionReturn;
  *   )
  * }
  * ```
+ *
+ * @example With lifecycle callbacks
+ * ```tsx
+ * function SearchButton() {
+ *   const { execute, retry, lastError } = useToolAction('search.hub', {
+ *     onSuccess: (result) => toast.success('Search complete!'),
+ *     onError: (error) => toast.error(`Search failed: ${error}`),
+ *     retryCount: 2,
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => execute({ query: 'test' })}>Search</button>
+ *       <Show when={lastError()}>
+ *         <button onClick={retry}>Retry</button>
+ *       </Show>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
-export declare function useToolAction(toolName: string): {
-    execute: (params?: Record<string, any>) => Promise<ActionResult>;
-    isExecuting: Accessor<boolean>;
-    lastResult: Accessor<ActionResult | undefined>;
-    lastError: Accessor<string | undefined>;
-};
+export declare function useToolAction(toolName: string, options?: UseActionOptions): UseToolActionReturn;
 export type { ActionRequest, ActionResult };
 //# sourceMappingURL=useAction.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAction.d.ts","sourceRoot":"","sources":["../../src/hooks/useAction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,QAAQ,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAoB,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAElF;;OAEG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAEhE;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAE9C;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAsC3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAChE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC9B,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAC9C,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACxC,CAaA;AAED,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"useAction.d.ts","sourceRoot":"","sources":["../../src/hooks/useAction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgB,QAAQ,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAoB,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC3F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,wBAAwB;IAChE;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAElF;;OAEG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAEhE;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAE9C;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAEvC;;OAEG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAE9C;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAwGzE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAChE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC9B,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAC9C,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IAC9C,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,mBAAmB,CAwBrB;AAED,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA"}

package/dist/hooks/useAction.js

@@ -1,37 +1,103 @@
 import { createSignal } from "solid-js";
 import { useMCPActionSafe } from "../context/MCPActionContext.js";
-function useAction() {
+function useAction(options = {}) {
   const context = useMCPActionSafe();
   const [lastError, setLastError] = createSignal();
-  const execute = async (toolName, params) => {
+  const [lastRequest, setLastRequest] = createSignal();
+  const [retryAttempt, setRetryAttempt] = createSignal(0);
+  const executeWithLifecycle = async (request) => {
+    var _a, _b, _c;
     setLastError(void 0);
-    const result = await context.executeAction({
-      toolName,
-      params
-    });
-    if (!result.success && result.error) {
+    setLastRequest(request);
+    if (options.onBefore) {
+      const shouldProceed = await options.onBefore({
+        toolName: request.toolName,
+        params: request.params
+      });
+      if (!shouldProceed) {
+        const cancelledResult = {
+          success: false,
+          error: "Action cancelled by onBefore callback",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          toolName: request.toolName
+        };
+        return cancelledResult;
+      }
+    }
+    const result = await context.executeAction(request);
+    if (result.success) {
+      (_a = options.onSuccess) == null ? void 0 : _a.call(options, {
+        success: result.success,
+        data: result.data,
+        timestamp: result.timestamp,
+        toolName: result.toolName
+      });
+    } else {
       setLastError(result.error);
+      (_b = options.onError) == null ? void 0 : _b.call(options, result.error || "Unknown error", {
+        toolName: request.toolName,
+        params: request.params
+      });
     }
+    (_c = options.onComplete) == null ? void 0 : _c.call(options, {
+      success: result.success,
+      data: result.data,
+      error: result.error,
+      timestamp: result.timestamp,
+      toolName: result.toolName
+    });
     return result;
   };
+  const execute = async (toolName, params) => {
+    setRetryAttempt(0);
+    return executeWithLifecycle({ toolName, params });
+  };
   const executeAction = async (request) => {
-    setLastError(void 0);
-    const result = await context.executeAction(request);
-    if (!result.success && result.error) {
-      setLastError(result.error);
+    setRetryAttempt(0);
+    return executeWithLifecycle(request);
+  };
+  const retry = async () => {
+    const request = lastRequest();
+    if (!request) return void 0;
+    const maxRetries = options.retryCount || 3;
+    const attempt = retryAttempt() + 1;
+    if (attempt > maxRetries) {
+      setLastError(`Max retries (${maxRetries}) exceeded`);
+      return void 0;
     }
-    return result;
+    setRetryAttempt(attempt);
+    if (options.retryDelay) {
+      await new Promise((r) => setTimeout(r, options.retryDelay));
+    }
+    return executeWithLifecycle(request);
+  };
+  const clearError = () => setLastError(void 0);
+  const reset = () => {
+    setLastError(void 0);
+    setLastRequest(void 0);
+    setRetryAttempt(0);
   };
   return {
     execute,
     executeAction,
     isExecuting: context.isExecuting,
     lastResult: context.lastResult,
-    lastError
+    lastError,
+    retry,
+    clearError,
+    reset
   };
 }
-function useToolAction(toolName) {
-  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction();
+function useToolAction(toolName, options = {}) {
+  const {
+    execute: baseExecute,
+    isExecuting,
+    lastResult,
+    lastError,
+    retry,
+    clearError,
+    reset
+  } = useAction(options);
   const execute = async (params) => {
     return baseExecute(toolName, params);
   };
@@ -39,7 +105,10 @@ function useToolAction(toolName) {
     execute,
     isExecuting,
     lastResult,
-    lastError
+    lastError,
+    retry,
+    clearError,
+    reset
   };
 }
 export {

package/dist/hooks/useAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAction.js","sources":["../../src/hooks/useAction.ts"],"sourcesContent":["/**\n * useAction - Hook for executing MCP actions from components\n * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components\n */\n\nimport { createSignal, Accessor } from 'solid-js'\nimport { useMCPActionSafe, ActionRequest, ActionResult } from '../context/MCPActionContext'\n\n/**\n * Return type for useAction hook\n */\nexport interface UseActionReturn {\n  /**\n   * Execute a tool action\n   */\n  execute: (toolName: string, params?: Record<string, any>) => Promise<ActionResult>\n\n  /**\n   * Full execute with ActionRequest\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last result from action execution\n   */\n  lastResult: Accessor<ActionResult | undefined>\n\n  /**\n   * Last error (if any)\n   */\n  lastError: Accessor<string | undefined>\n}\n\n/**\n * Hook for executing MCP actions\n *\n * @example\n * ```tsx\n * function MyButton() {\n *   const { execute, isExecuting, lastError } = useAction()\n *\n *   const handleClick = async () => {\n *     const result = await execute('search.hub', { query: 'test' })\n *     if (result.success) {\n *       console.log('Data:', result.data)\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick} disabled={isExecuting()}>\n *       {isExecuting() ? 'Loading...' : 'Search'}\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useAction(): UseActionReturn {\n  const context = useMCPActionSafe()\n  const [lastError, setLastError] = createSignal<string>()\n\n  const execute = async (toolName: string, params?: Record<string, any>): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction({\n      toolName,\n      params,\n    })\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction(request)\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  return {\n    execute,\n    executeAction,\n    isExecuting: context.isExecuting,\n    lastResult: context.lastResult,\n    lastError,\n  }\n}\n\n/**\n * Hook for binding action to a specific tool\n *\n * @example\n * ```tsx\n * function SearchButton() {\n *   const { execute, isExecuting } = useToolAction('search.hub')\n *\n *   return (\n *     <button onClick={() => execute({ query: 'test' })} disabled={isExecuting()}>\n *       Search\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useToolAction(toolName: string): {\n  execute: (params?: Record<string, any>) => Promise<ActionResult>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ActionResult | undefined>\n  lastError: Accessor<string | undefined>\n} {\n  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction()\n\n  const execute = async (params?: Record<string, any>): Promise<ActionResult> => {\n    return baseExecute(toolName, params)\n  }\n\n  return {\n    execute,\n    isExecuting,\n    lastResult,\n    lastError,\n  }\n}\n\nexport type { ActionRequest, ActionResult }\n"],"names":[],"mappings":";;AA6DO,SAAS,YAA6B;AAC3C,QAAM,UAAU,iBAAA;AAChB,QAAM,CAAC,WAAW,YAAY,IAAI,aAAA;AAElC,QAAM,UAAU,OAAO,UAAkB,WAAwD;AAC/F,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc;AAAA,MACzC;AAAA,MACA;AAAA,IAAA,CACD;AAED,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,OAAO,YAAkD;AAC7E,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc,OAAO;AAElD,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB;AAAA,EAAA;AAEJ;AAkBO,SAAS,cAAc,UAK5B;AACA,QAAM,EAAE,SAAS,aAAa,aAAa,YAAY,UAAA,IAAc,UAAA;AAErE,QAAM,UAAU,OAAO,WAAwD;AAC7E,WAAO,YAAY,UAAU,MAAM;AAAA,EACrC;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useAction.js","sources":["../../src/hooks/useAction.ts"],"sourcesContent":["/**\n * useAction - Hook for executing MCP actions from components\n * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components\n * Sprint 2: Lifecycle callbacks and retry support\n */\n\nimport { createSignal, Accessor } from 'solid-js'\nimport { useMCPActionSafe, ActionRequest, ActionResult } from '../context/MCPActionContext'\nimport type { ActionLifecycleCallbacks } from '../types'\n\n/**\n * Options for useAction hook\n */\nexport interface UseActionOptions extends ActionLifecycleCallbacks {\n  /**\n   * Number of retry attempts on failure\n   */\n  retryCount?: number\n\n  /**\n   * Delay between retries in milliseconds\n   */\n  retryDelay?: number\n}\n\n/**\n * Return type for useAction hook\n */\nexport interface UseActionReturn {\n  /**\n   * Execute a tool action\n   */\n  execute: (toolName: string, params?: Record<string, any>) => Promise<ActionResult>\n\n  /**\n   * Full execute with ActionRequest\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last result from action execution\n   */\n  lastResult: Accessor<ActionResult | undefined>\n\n  /**\n   * Last error (if any)\n   */\n  lastError: Accessor<string | undefined>\n\n  /**\n   * Retry the last failed action\n   */\n  retry: () => Promise<ActionResult | undefined>\n\n  /**\n   * Clear the last error\n   */\n  clearError: () => void\n\n  /**\n   * Reset all state\n   */\n  reset: () => void\n}\n\n/**\n * Hook for executing MCP actions\n *\n * @example\n * ```tsx\n * function MyButton() {\n *   const { execute, isExecuting, lastError } = useAction()\n *\n *   const handleClick = async () => {\n *     const result = await execute('search.hub', { query: 'test' })\n *     if (result.success) {\n *       console.log('Data:', result.data)\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick} disabled={isExecuting()}>\n *       {isExecuting() ? 'Loading...' : 'Search'}\n *     </button>\n *   )\n * }\n * ```\n *\n * @example With lifecycle callbacks\n * ```tsx\n * function MyActionButton() {\n *   const { execute, retry, clearError, lastError } = useAction({\n *     onBefore: (req) => {\n *       console.log('About to execute:', req.toolName)\n *       return true // proceed\n *     },\n *     onSuccess: (result) => {\n *       toast.success('Action completed!')\n *     },\n *     onError: (error) => {\n *       toast.error(`Action failed: ${error}`)\n *     },\n *     retryCount: 3,\n *     retryDelay: 1000,\n *   })\n *\n *   return (\n *     <div>\n *       <button onClick={() => execute('search.hub', { query: 'test' })}>\n *         Search\n *       </button>\n *       <Show when={lastError()}>\n *         <button onClick={retry}>Retry</button>\n *         <button onClick={clearError}>Dismiss</button>\n *       </Show>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useAction(options: UseActionOptions = {}): UseActionReturn {\n  const context = useMCPActionSafe()\n  const [lastError, setLastError] = createSignal<string>()\n  const [lastRequest, setLastRequest] = createSignal<ActionRequest>()\n  const [retryAttempt, setRetryAttempt] = createSignal(0)\n\n  const executeWithLifecycle = async (request: ActionRequest): Promise<ActionResult> => {\n    setLastError(undefined)\n    setLastRequest(request)\n\n    // onBefore callback (can cancel)\n    if (options.onBefore) {\n      const shouldProceed = await options.onBefore({\n        toolName: request.toolName,\n        params: request.params,\n      })\n      if (!shouldProceed) {\n        const cancelledResult: ActionResult = {\n          success: false,\n          error: 'Action cancelled by onBefore callback',\n          timestamp: new Date().toISOString(),\n          toolName: request.toolName,\n        }\n        return cancelledResult\n      }\n    }\n\n    const result = await context.executeAction(request)\n\n    if (result.success) {\n      options.onSuccess?.({\n        success: result.success,\n        data: result.data,\n        timestamp: result.timestamp,\n        toolName: result.toolName,\n      })\n    } else {\n      setLastError(result.error)\n      options.onError?.(result.error || 'Unknown error', {\n        toolName: request.toolName,\n        params: request.params,\n      })\n    }\n\n    options.onComplete?.({\n      success: result.success,\n      data: result.data,\n      error: result.error,\n      timestamp: result.timestamp,\n      toolName: result.toolName,\n    })\n\n    return result\n  }\n\n  const execute = async (toolName: string, params?: Record<string, any>): Promise<ActionResult> => {\n    setRetryAttempt(0)\n    return executeWithLifecycle({ toolName, params })\n  }\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setRetryAttempt(0)\n    return executeWithLifecycle(request)\n  }\n\n  const retry = async (): Promise<ActionResult | undefined> => {\n    const request = lastRequest()\n    if (!request) return undefined\n\n    const maxRetries = options.retryCount || 3\n    const attempt = retryAttempt() + 1\n\n    if (attempt > maxRetries) {\n      setLastError(`Max retries (${maxRetries}) exceeded`)\n      return undefined\n    }\n\n    setRetryAttempt(attempt)\n\n    if (options.retryDelay) {\n      await new Promise((r) => setTimeout(r, options.retryDelay))\n    }\n\n    return executeWithLifecycle(request)\n  }\n\n  const clearError = () => setLastError(undefined)\n\n  const reset = () => {\n    setLastError(undefined)\n    setLastRequest(undefined)\n    setRetryAttempt(0)\n  }\n\n  return {\n    execute,\n    executeAction,\n    isExecuting: context.isExecuting,\n    lastResult: context.lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  }\n}\n\n/**\n * Return type for useToolAction hook\n */\nexport interface UseToolActionReturn {\n  execute: (params?: Record<string, any>) => Promise<ActionResult>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ActionResult | undefined>\n  lastError: Accessor<string | undefined>\n  retry: () => Promise<ActionResult | undefined>\n  clearError: () => void\n  reset: () => void\n}\n\n/**\n * Hook for binding action to a specific tool\n *\n * @example\n * ```tsx\n * function SearchButton() {\n *   const { execute, isExecuting } = useToolAction('search.hub')\n *\n *   return (\n *     <button onClick={() => execute({ query: 'test' })} disabled={isExecuting()}>\n *       Search\n *     </button>\n *   )\n * }\n * ```\n *\n * @example With lifecycle callbacks\n * ```tsx\n * function SearchButton() {\n *   const { execute, retry, lastError } = useToolAction('search.hub', {\n *     onSuccess: (result) => toast.success('Search complete!'),\n *     onError: (error) => toast.error(`Search failed: ${error}`),\n *     retryCount: 2,\n *   })\n *\n *   return (\n *     <div>\n *       <button onClick={() => execute({ query: 'test' })}>Search</button>\n *       <Show when={lastError()}>\n *         <button onClick={retry}>Retry</button>\n *       </Show>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useToolAction(\n  toolName: string,\n  options: UseActionOptions = {}\n): UseToolActionReturn {\n  const {\n    execute: baseExecute,\n    isExecuting,\n    lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  } = useAction(options)\n\n  const execute = async (params?: Record<string, any>): Promise<ActionResult> => {\n    return baseExecute(toolName, params)\n  }\n\n  return {\n    execute,\n    isExecuting,\n    lastResult,\n    lastError,\n    retry,\n    clearError,\n    reset,\n  }\n}\n\nexport type { ActionRequest, ActionResult }\n"],"names":[],"mappings":";;AA6HO,SAAS,UAAU,UAA4B,IAAqB;AACzE,QAAM,UAAU,iBAAA;AAChB,QAAM,CAAC,WAAW,YAAY,IAAI,aAAA;AAClC,QAAM,CAAC,aAAa,cAAc,IAAI,aAAA;AACtC,QAAM,CAAC,cAAc,eAAe,IAAI,aAAa,CAAC;AAEtD,QAAM,uBAAuB,OAAO,YAAkD;;AACpF,iBAAa,MAAS;AACtB,mBAAe,OAAO;AAGtB,QAAI,QAAQ,UAAU;AACpB,YAAM,gBAAgB,MAAM,QAAQ,SAAS;AAAA,QAC3C,UAAU,QAAQ;AAAA,QAClB,QAAQ,QAAQ;AAAA,MAAA,CACjB;AACD,UAAI,CAAC,eAAe;AAClB,cAAM,kBAAgC;AAAA,UACpC,SAAS;AAAA,UACT,OAAO;AAAA,UACP,YAAW,oBAAI,KAAA,GAAO,YAAA;AAAA,UACtB,UAAU,QAAQ;AAAA,QAAA;AAEpB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,SAAS,MAAM,QAAQ,cAAc,OAAO;AAElD,QAAI,OAAO,SAAS;AAClB,oBAAQ,cAAR,iCAAoB;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,MAAM,OAAO;AAAA,QACb,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO;AAAA,MAAA;AAAA,IAErB,OAAO;AACL,mBAAa,OAAO,KAAK;AACzB,oBAAQ,YAAR,iCAAkB,OAAO,SAAS,iBAAiB;AAAA,QACjD,UAAU,QAAQ;AAAA,QAClB,QAAQ,QAAQ;AAAA,MAAA;AAAA,IAEpB;AAEA,kBAAQ,eAAR,iCAAqB;AAAA,MACnB,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,OAAO,OAAO;AAAA,MACd,WAAW,OAAO;AAAA,MAClB,UAAU,OAAO;AAAA,IAAA;AAGnB,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,OAAO,UAAkB,WAAwD;AAC/F,oBAAgB,CAAC;AACjB,WAAO,qBAAqB,EAAE,UAAU,QAAQ;AAAA,EAClD;AAEA,QAAM,gBAAgB,OAAO,YAAkD;AAC7E,oBAAgB,CAAC;AACjB,WAAO,qBAAqB,OAAO;AAAA,EACrC;AAEA,QAAM,QAAQ,YAA+C;AAC3D,UAAM,UAAU,YAAA;AAChB,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,aAAa,QAAQ,cAAc;AACzC,UAAM,UAAU,iBAAiB;AAEjC,QAAI,UAAU,YAAY;AACxB,mBAAa,gBAAgB,UAAU,YAAY;AACnD,aAAO;AAAA,IACT;AAEA,oBAAgB,OAAO;AAEvB,QAAI,QAAQ,YAAY;AACtB,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,QAAQ,UAAU,CAAC;AAAA,IAC5D;AAEA,WAAO,qBAAqB,OAAO;AAAA,EACrC;AAEA,QAAM,aAAa,MAAM,aAAa,MAAS;AAE/C,QAAM,QAAQ,MAAM;AAClB,iBAAa,MAAS;AACtB,mBAAe,MAAS;AACxB,oBAAgB,CAAC;AAAA,EACnB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAmDO,SAAS,cACd,UACA,UAA4B,IACP;AACrB,QAAM;AAAA,IACJ,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE,UAAU,OAAO;AAErB,QAAM,UAAU,OAAO,WAAwD;AAC7E,WAAO,YAAY,UAAU,MAAM;AAAA,EACrC;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/hooks/useConditionalField.cjs

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+function evaluateCondition(condition, formData) {
+  const fieldValue = formData[condition.field];
+  switch (condition.operator) {
+    case "equals":
+      return fieldValue === condition.value;
+    case "notEquals":
+      return fieldValue !== condition.value;
+    case "in":
+      return Array.isArray(condition.value) && condition.value.includes(fieldValue);
+    case "notIn":
+      return Array.isArray(condition.value) && !condition.value.includes(fieldValue);
+    case "contains":
+      return typeof fieldValue === "string" && fieldValue.includes(condition.value);
+    case "startsWith":
+      return typeof fieldValue === "string" && fieldValue.startsWith(condition.value);
+    case "endsWith":
+      return typeof fieldValue === "string" && fieldValue.endsWith(condition.value);
+    case "greaterThan":
+      return typeof fieldValue === "number" && fieldValue > condition.value;
+    case "lessThan":
+      return typeof fieldValue === "number" && fieldValue < condition.value;
+    case "isEmpty":
+      return fieldValue === void 0 || fieldValue === null || fieldValue === "";
+    case "isNotEmpty":
+      return fieldValue !== void 0 && fieldValue !== null && fieldValue !== "";
+    case "isTrue":
+      return fieldValue === true;
+    case "isFalse":
+      return fieldValue === false;
+    default:
+      return true;
+  }
+}
+function useConditionalField(options) {
+  const isVisible = solidJs.createMemo(() => {
+    if (!options.condition) return true;
+    return evaluateCondition(options.condition, options.formData());
+  });
+  return { isVisible };
+}
+exports.evaluateCondition = evaluateCondition;
+exports.useConditionalField = useConditionalField;
+//# sourceMappingURL=useConditionalField.cjs.map

package/dist/hooks/useConditionalField.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConditionalField.cjs","sources":["../../src/hooks/useConditionalField.ts"],"sourcesContent":["/**\n * useConditionalField - Evaluates showWhen conditions for form fields\n * Sprint 2: Form Advanced\n */\n\nimport { Accessor, createMemo } from 'solid-js'\nimport type { ShowWhenCondition } from '../types'\n\nexport interface UseConditionalFieldOptions {\n  condition?: ShowWhenCondition\n  formData: Accessor<Record<string, any>>\n}\n\n/**\n * Evaluates a showWhen condition against form data\n */\nexport function evaluateCondition(\n  condition: ShowWhenCondition,\n  formData: Record<string, any>\n): boolean {\n  const fieldValue = formData[condition.field]\n\n  switch (condition.operator) {\n    case 'equals':\n      return fieldValue === condition.value\n\n    case 'notEquals':\n      return fieldValue !== condition.value\n\n    case 'in':\n      return Array.isArray(condition.value) && condition.value.includes(fieldValue)\n\n    case 'notIn':\n      return Array.isArray(condition.value) && !condition.value.includes(fieldValue)\n\n    case 'contains':\n      return typeof fieldValue === 'string' && fieldValue.includes(condition.value as string)\n\n    case 'startsWith':\n      return typeof fieldValue === 'string' && fieldValue.startsWith(condition.value as string)\n\n    case 'endsWith':\n      return typeof fieldValue === 'string' && fieldValue.endsWith(condition.value as string)\n\n    case 'greaterThan':\n      return typeof fieldValue === 'number' && fieldValue > (condition.value as number)\n\n    case 'lessThan':\n      return typeof fieldValue === 'number' && fieldValue < (condition.value as number)\n\n    case 'isEmpty':\n      return fieldValue === undefined || fieldValue === null || fieldValue === ''\n\n    case 'isNotEmpty':\n      return fieldValue !== undefined && fieldValue !== null && fieldValue !== ''\n\n    case 'isTrue':\n      return fieldValue === true\n\n    case 'isFalse':\n      return fieldValue === false\n\n    default:\n      return true\n  }\n}\n\n/**\n * Hook for conditional field visibility\n *\n * @example\n * ```tsx\n * const { isVisible } = useConditionalField({\n *   condition: field.showWhen,\n *   formData: formDataAccessor\n * })\n *\n * return (\n *   <Show when={isVisible()}>\n *     <input ... />\n *   </Show>\n * )\n * ```\n */\nexport function useConditionalField(options: UseConditionalFieldOptions) {\n  const isVisible = createMemo(() => {\n    if (!options.condition) return true\n    return evaluateCondition(options.condition, options.formData())\n  })\n\n  return { isVisible }\n}\n"],"names":["createMemo"],"mappings":";;;AAgBO,SAAS,kBACd,WACA,UACS;AACT,QAAM,aAAa,SAAS,UAAU,KAAK;AAE3C,UAAQ,UAAU,UAAA;AAAA,IAChB,KAAK;AACH,aAAO,eAAe,UAAU;AAAA,IAElC,KAAK;AACH,aAAO,eAAe,UAAU;AAAA,IAElC,KAAK;AACH,aAAO,MAAM,QAAQ,UAAU,KAAK,KAAK,UAAU,MAAM,SAAS,UAAU;AAAA,IAE9E,KAAK;AACH,aAAO,MAAM,QAAQ,UAAU,KAAK,KAAK,CAAC,UAAU,MAAM,SAAS,UAAU;AAAA,IAE/E,KAAK;AACH,aAAO,OAAO,eAAe,YAAY,WAAW,SAAS,UAAU,KAAe;AAAA,IAExF,KAAK;AACH,aAAO,OAAO,eAAe,YAAY,WAAW,WAAW,UAAU,KAAe;AAAA,IAE1F,KAAK;AACH,aAAO,OAAO,eAAe,YAAY,WAAW,SAAS,UAAU,KAAe;AAAA,IAExF,KAAK;AACH,aAAO,OAAO,eAAe,YAAY,aAAc,UAAU;AAAA,IAEnE,KAAK;AACH,aAAO,OAAO,eAAe,YAAY,aAAc,UAAU;AAAA,IAEnE,KAAK;AACH,aAAO,eAAe,UAAa,eAAe,QAAQ,eAAe;AAAA,IAE3E,KAAK;AACH,aAAO,eAAe,UAAa,eAAe,QAAQ,eAAe;AAAA,IAE3E,KAAK;AACH,aAAO,eAAe;AAAA,IAExB,KAAK;AACH,aAAO,eAAe;AAAA,IAExB;AACE,aAAO;AAAA,EAAA;AAEb;AAmBO,SAAS,oBAAoB,SAAqC;AACvE,QAAM,YAAYA,QAAAA,WAAW,MAAM;AACjC,QAAI,CAAC,QAAQ,UAAW,QAAO;AAC/B,WAAO,kBAAkB,QAAQ,WAAW,QAAQ,UAAU;AAAA,EAChE,CAAC;AAED,SAAO,EAAE,UAAA;AACX;;;"}

package/dist/hooks/useConditionalField.d.ts

@@ -0,0 +1,35 @@
+/**
+ * useConditionalField - Evaluates showWhen conditions for form fields
+ * Sprint 2: Form Advanced
+ */
+import { Accessor } from 'solid-js';
+import type { ShowWhenCondition } from '../types';
+export interface UseConditionalFieldOptions {
+    condition?: ShowWhenCondition;
+    formData: Accessor<Record<string, any>>;
+}
+/**
+ * Evaluates a showWhen condition against form data
+ */
+export declare function evaluateCondition(condition: ShowWhenCondition, formData: Record<string, any>): boolean;
+/**
+ * Hook for conditional field visibility
+ *
+ * @example
+ * ```tsx
+ * const { isVisible } = useConditionalField({
+ *   condition: field.showWhen,
+ *   formData: formDataAccessor
+ * })
+ *
+ * return (
+ *   <Show when={isVisible()}>
+ *     <input ... />
+ *   </Show>
+ * )
+ * ```
+ */
+export declare function useConditionalField(options: UseConditionalFieldOptions): {
+    isVisible: Accessor<boolean>;
+};
+//# sourceMappingURL=useConditionalField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useConditionalField.d.ts","sourceRoot":"","sources":["../../src/hooks/useConditionalField.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CACxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CA8CT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B;;EAOtE"}

package/dist/hooks/useConditionalField.js

@@ -0,0 +1,46 @@
+import { createMemo } from "solid-js";
+function evaluateCondition(condition, formData) {
+  const fieldValue = formData[condition.field];
+  switch (condition.operator) {
+    case "equals":
+      return fieldValue === condition.value;
+    case "notEquals":
+      return fieldValue !== condition.value;
+    case "in":
+      return Array.isArray(condition.value) && condition.value.includes(fieldValue);
+    case "notIn":
+      return Array.isArray(condition.value) && !condition.value.includes(fieldValue);
+    case "contains":
+      return typeof fieldValue === "string" && fieldValue.includes(condition.value);
+    case "startsWith":
+      return typeof fieldValue === "string" && fieldValue.startsWith(condition.value);
+    case "endsWith":
+      return typeof fieldValue === "string" && fieldValue.endsWith(condition.value);
+    case "greaterThan":
+      return typeof fieldValue === "number" && fieldValue > condition.value;
+    case "lessThan":
+      return typeof fieldValue === "number" && fieldValue < condition.value;
+    case "isEmpty":
+      return fieldValue === void 0 || fieldValue === null || fieldValue === "";
+    case "isNotEmpty":
+      return fieldValue !== void 0 && fieldValue !== null && fieldValue !== "";
+    case "isTrue":
+      return fieldValue === true;
+    case "isFalse":
+      return fieldValue === false;
+    default:
+      return true;
+  }
+}
+function useConditionalField(options) {
+  const isVisible = createMemo(() => {
+    if (!options.condition) return true;
+    return evaluateCondition(options.condition, options.formData());
+  });
+  return { isVisible };
+}
+export {
+  evaluateCondition,
+  useConditionalField
+};
+//# sourceMappingURL=useConditionalField.js.map