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

package/dist/context/AutocompleteContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutocompleteContext.js","sources":["../../src/context/AutocompleteContext.tsx"],"sourcesContent":["/**\n * AutocompleteContext - Context provider for autocomplete functionality\n * Manages plugins and provides unified autocomplete API\n *\n * Sprint Autocomplete Feature\n */\n\nimport {\n  createContext,\n  useContext,\n  ParentComponent,\n  Accessor,\n  createSignal,\n  createMemo,\n  onCleanup\n} from 'solid-js'\nimport type {\n  AutocompletePlugin,\n  AutocompleteResult,\n  AutocompleteContext as AutocompleteContextData,\n  AutocompleteProviderConfig\n} from '../types'\n\n/**\n * Cache entry for autocomplete results\n */\ninterface CacheEntry {\n  result: AutocompleteResult\n  timestamp: number\n}\n\n/**\n * Context value interface\n */\nexport interface AutocompleteContextValue {\n  /**\n   * Get suggestions from a plugin\n   */\n  getSuggestions: (\n    input: string,\n    pluginId?: string,\n    context?: AutocompleteContextData\n  ) => Promise<AutocompleteResult>\n\n  /**\n   * Get registered plugins\n   */\n  plugins: Accessor<AutocompletePlugin[]>\n\n  /**\n   * Get default plugin ID\n   */\n  defaultPluginId: Accessor<string | undefined>\n\n  /**\n   * Check if a plugin is ready\n   */\n  isPluginReady: (pluginId: string) => boolean\n\n  /**\n   * Get plugin by ID\n   */\n  getPlugin: (pluginId: string) => AutocompletePlugin | undefined\n\n  /**\n   * Register a new plugin\n   */\n  registerPlugin: (plugin: AutocompletePlugin) => void\n\n  /**\n   * Unregister a plugin\n   */\n  unregisterPlugin: (pluginId: string) => void\n\n  /**\n   * Clear cache\n   */\n  clearCache: () => void\n\n  /**\n   * Global config\n   */\n  config: {\n    debounceMs: number\n    minChars: number\n    cacheTtl: number\n    cacheEnabled: boolean\n  }\n}\n\n// Create context with undefined default\nconst AutocompleteCtx = createContext<AutocompleteContextValue>()\n\n/**\n * Props for AutocompleteProvider\n */\nexport interface AutocompleteProviderProps extends AutocompleteProviderConfig {\n  children: any\n}\n\n/**\n * Generate cache key\n */\nfunction getCacheKey(input: string, pluginId: string, context?: AutocompleteContextData): string {\n  const contextKey = context ? JSON.stringify(context) : ''\n  return `${pluginId}:${input}:${contextKey}`\n}\n\n/**\n * AutocompleteProvider Component\n * Provides autocomplete context to child components\n */\nexport const AutocompleteProvider: ParentComponent<AutocompleteProviderProps> = (props) => {\n  // Plugin registry\n  const [plugins, setPlugins] = createSignal<AutocompletePlugin[]>(props.plugins || [])\n\n  // Result cache\n  const [cache, setCache] = createSignal<Map<string, CacheEntry>>(new Map())\n\n  // Config with defaults\n  const config = createMemo(() => ({\n    debounceMs: props.debounceMs ?? 150,\n    minChars: props.minChars ?? 1,\n    cacheTtl: props.cacheTtl ?? 60000,\n    cacheEnabled: props.cacheEnabled ?? true\n  }))\n\n  // Default plugin ID\n  const defaultPluginId = createMemo(() => {\n    if (props.defaultPlugin) return props.defaultPlugin\n    const firstPlugin = plugins()[0]\n    return firstPlugin?.id\n  })\n\n  /**\n   * Get plugin by ID\n   */\n  const getPlugin = (pluginId: string): AutocompletePlugin | undefined => {\n    return plugins().find(p => p.id === pluginId)\n  }\n\n  /**\n   * Check if plugin is ready\n   */\n  const isPluginReady = (pluginId: string): boolean => {\n    const plugin = getPlugin(pluginId)\n    if (!plugin) return false\n    if (plugin.isReady) return plugin.isReady()\n    return true\n  }\n\n  /**\n   * Check cache for result\n   */\n  const getFromCache = (key: string): AutocompleteResult | null => {\n    if (!config().cacheEnabled) return null\n\n    const entry = cache().get(key)\n    if (!entry) return null\n\n    const age = Date.now() - entry.timestamp\n    if (age > config().cacheTtl) {\n      // Expired, remove from cache\n      setCache(prev => {\n        const next = new Map(prev)\n        next.delete(key)\n        return next\n      })\n      return null\n    }\n\n    return { ...entry.result, cached: true }\n  }\n\n  /**\n   * Add result to cache\n   */\n  const addToCache = (key: string, result: AutocompleteResult): void => {\n    if (!config().cacheEnabled) return\n\n    setCache(prev => {\n      const next = new Map(prev)\n      next.set(key, { result, timestamp: Date.now() })\n      return next\n    })\n  }\n\n  /**\n   * Get suggestions from plugin\n   */\n  const getSuggestions = async (\n    input: string,\n    pluginId?: string,\n    context?: AutocompleteContextData\n  ): Promise<AutocompleteResult> => {\n    const targetPluginId = pluginId || defaultPluginId()\n\n    if (!targetPluginId) {\n      return { type: 'options', options: [], pluginId: undefined }\n    }\n\n    const plugin = getPlugin(targetPluginId)\n    if (!plugin) {\n      console.warn(`[Autocomplete] Plugin not found: ${targetPluginId}`)\n      return { type: 'options', options: [], pluginId: targetPluginId }\n    }\n\n    // Check cache\n    const cacheKey = getCacheKey(input, targetPluginId, context)\n    const cached = getFromCache(cacheKey)\n    if (cached) {\n      return cached\n    }\n\n    try {\n      const result = await plugin.getSuggestions(input, context)\n      result.pluginId = targetPluginId\n\n      // Cache result\n      addToCache(cacheKey, result)\n\n      return result\n    } catch (error) {\n      console.error(`[Autocomplete] Plugin error (${targetPluginId}):`, error)\n      return {\n        type: 'options',\n        options: [],\n        pluginId: targetPluginId\n      }\n    }\n  }\n\n  /**\n   * Register a new plugin\n   */\n  const registerPlugin = (plugin: AutocompletePlugin): void => {\n    setPlugins(prev => {\n      // Remove existing plugin with same ID\n      const filtered = prev.filter(p => p.id !== plugin.id)\n      return [...filtered, plugin]\n    })\n  }\n\n  /**\n   * Unregister a plugin\n   */\n  const unregisterPlugin = (pluginId: string): void => {\n    const plugin = getPlugin(pluginId)\n    if (plugin?.dispose) {\n      plugin.dispose()\n    }\n    setPlugins(prev => prev.filter(p => p.id !== pluginId))\n  }\n\n  /**\n   * Clear cache\n   */\n  const clearCache = (): void => {\n    setCache(new Map())\n  }\n\n  // Cleanup on unmount\n  onCleanup(() => {\n    // Dispose all plugins\n    plugins().forEach(plugin => {\n      if (plugin.dispose) {\n        try {\n          plugin.dispose()\n        } catch (e) {\n          console.error(`[Autocomplete] Error disposing plugin ${plugin.id}:`, e)\n        }\n      }\n    })\n  })\n\n  // Context value\n  const contextValue: AutocompleteContextValue = {\n    getSuggestions,\n    plugins,\n    defaultPluginId,\n    isPluginReady,\n    getPlugin,\n    registerPlugin,\n    unregisterPlugin,\n    clearCache,\n    config: config()\n  }\n\n  return (\n    <AutocompleteCtx.Provider value={contextValue}>\n      {props.children}\n    </AutocompleteCtx.Provider>\n  )\n}\n\n/**\n * Hook to use autocomplete context\n * @throws Error if used outside provider\n */\nexport function useAutocompleteContext(): AutocompleteContextValue {\n  const context = useContext(AutocompleteCtx)\n  if (!context) {\n    throw new Error(\n      'useAutocompleteContext must be used within an AutocompleteProvider'\n    )\n  }\n  return context\n}\n\n/**\n * Safe hook that returns undefined if outside provider\n */\nexport function useAutocompleteContextSafe(): AutocompleteContextValue | undefined {\n  return useContext(AutocompleteCtx)\n}\n\nexport { AutocompleteCtx }\n"],"names":["AutocompleteCtx","createContext","getCacheKey","input","pluginId","context","contextKey","JSON","stringify","AutocompleteProvider","props","plugins","setPlugins","createSignal","cache","setCache","Map","config","createMemo","debounceMs","minChars","cacheTtl","cacheEnabled","defaultPluginId","defaultPlugin","firstPlugin","id","getPlugin","find","p","isPluginReady","plugin","isReady","getFromCache","key","entry","get","age","Date","now","timestamp","prev","next","delete","result","cached","addToCache","set","getSuggestions","targetPluginId","type","options","undefined","console","warn","cacheKey","error","registerPlugin","filtered","filter","unregisterPlugin","dispose","clearCache","onCleanup","forEach","e","contextValue","_$createComponent","Provider","value","children","useAutocompleteContext","useContext","Error","useAutocompleteContextSafe"],"mappings":"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"}

package/dist/hooks/index.d.ts

@@ -13,4 +13,10 @@ export { useModal, useConfirmModal } from './useModal';
 export type { UseModalReturn, UseConfirmModalReturn } from './useModal';
 export { useFormPersistence } from './useFormPersistence';
 export type { UseFormPersistenceOptions, UseFormPersistenceReturn } from './useFormPersistence';
+export { useDragDrop } from './useDragDrop';
+export type { UseDragDropOptions, UseDragDropReturn, DragProps, } from './useDragDrop';
+export { useResize } from './useResize';
+export type { UseResizeOptions, UseResizeReturn, ResizeEdge, ResizeHandleProps, } from './useResize';
+export { useAutocomplete } from './useAutocomplete';
+export type { UseAutocompleteOptions, UseAutocompleteReturn, } from './useAutocomplete';
 //# 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,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"}
+{"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;AAG/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA"}

package/dist/hooks/useAutocomplete.cjs

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+const web = require("solid-js/web");
+const AutocompleteContext = require("../context/AutocompleteContext.cjs");
+function debounce(fn, delay) {
+  let timeoutId = null;
+  return {
+    call: (...args) => {
+      if (timeoutId) clearTimeout(timeoutId);
+      timeoutId = setTimeout(() => {
+        fn(...args);
+        timeoutId = null;
+      }, delay);
+    },
+    cancel: () => {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+        timeoutId = null;
+      }
+    }
+  };
+}
+function useAutocomplete(options) {
+  const {
+    inputValue,
+    pluginId,
+    fieldConfig,
+    context,
+    enabled = true,
+    onInputChange,
+    minChars: minCharsOption,
+    debounceMs: debounceOption
+  } = options;
+  const autocompleteCtx = AutocompleteContext.useAutocompleteContextSafe();
+  const [completion, setCompletion] = solidJs.createSignal(null);
+  const [options_, setOptions] = solidJs.createSignal([]);
+  const [selectedIndex, setSelectedIndex] = solidJs.createSignal(-1);
+  const [isLoading, setIsLoading] = solidJs.createSignal(false);
+  const [error, setError] = solidJs.createSignal(null);
+  const [isOpen, setIsOpen] = solidJs.createSignal(false);
+  const [resultType, setResultType] = solidJs.createSignal(null);
+  const config = solidJs.createMemo(() => ({
+    minChars: minCharsOption ?? (fieldConfig == null ? void 0 : fieldConfig.minChars) ?? (autocompleteCtx == null ? void 0 : autocompleteCtx.config.minChars) ?? 1,
+    debounceMs: debounceOption ?? (fieldConfig == null ? void 0 : fieldConfig.debounceMs) ?? (autocompleteCtx == null ? void 0 : autocompleteCtx.config.debounceMs) ?? 150
+  }));
+  const ghostText = solidJs.createMemo(() => {
+    const comp = completion();
+    const input = inputValue();
+    if (!comp || !input) return "";
+    if (comp.toLowerCase().startsWith(input.toLowerCase())) {
+      return comp.slice(input.length);
+    }
+    return "";
+  });
+  const fetchSuggestions = async (input) => {
+    if (!autocompleteCtx) {
+      return;
+    }
+    if (input.length < config().minChars) {
+      solidJs.batch(() => {
+        setCompletion(null);
+        setOptions([]);
+        setIsOpen(false);
+        setResultType(null);
+      });
+      return;
+    }
+    setIsLoading(true);
+    setError(null);
+    try {
+      const targetPluginId = pluginId ?? (fieldConfig == null ? void 0 : fieldConfig.plugin);
+      const contextData = context == null ? void 0 : context();
+      const result = await autocompleteCtx.getSuggestions(
+        input,
+        targetPluginId,
+        contextData
+      );
+      solidJs.batch(() => {
+        var _a;
+        setResultType(result.type);
+        if (result.type === "completion") {
+          setCompletion(result.completion || null);
+          setOptions([]);
+          setIsOpen(!!result.completion);
+        } else {
+          setCompletion(null);
+          setOptions(result.options || []);
+          setSelectedIndex(-1);
+          setIsOpen((((_a = result.options) == null ? void 0 : _a.length) || 0) > 0);
+        }
+        setIsLoading(false);
+      });
+    } catch (e) {
+      solidJs.batch(() => {
+        setError(e instanceof Error ? e.message : "Unknown error");
+        setIsLoading(false);
+        setIsOpen(false);
+      });
+    }
+  };
+  const debouncedFetch = debounce(fetchSuggestions, config().debounceMs);
+  solidJs.createEffect(
+    solidJs.on(inputValue, (value) => {
+      if (!enabled || !autocompleteCtx || web.isServer) {
+        return;
+      }
+      debouncedFetch.call(value);
+    })
+  );
+  solidJs.onCleanup(() => {
+    debouncedFetch.cancel();
+  });
+  const acceptCompletion = () => {
+    const comp = completion();
+    if (comp && onInputChange) {
+      onInputChange(comp);
+      solidJs.batch(() => {
+        setCompletion(null);
+        setIsOpen(false);
+      });
+    }
+  };
+  const selectOption = (option) => {
+    if (onInputChange) {
+      onInputChange(option.value);
+    }
+    solidJs.batch(() => {
+      setOptions([]);
+      setSelectedIndex(-1);
+      setIsOpen(false);
+    });
+  };
+  const nextOption = () => {
+    const opts = options_();
+    if (opts.length === 0) return;
+    setSelectedIndex((prev) => {
+      const next = prev + 1;
+      return next >= opts.length ? 0 : next;
+    });
+  };
+  const prevOption = () => {
+    const opts = options_();
+    if (opts.length === 0) return;
+    setSelectedIndex((prev) => {
+      const next = prev - 1;
+      return next < 0 ? opts.length - 1 : next;
+    });
+  };
+  const selectCurrentOption = () => {
+    const idx = selectedIndex();
+    const opts = options_();
+    if (idx >= 0 && idx < opts.length) {
+      selectOption(opts[idx]);
+    }
+  };
+  const dismiss = () => {
+    debouncedFetch.cancel();
+    solidJs.batch(() => {
+      setCompletion(null);
+      setOptions([]);
+      setSelectedIndex(-1);
+      setIsOpen(false);
+      setError(null);
+    });
+  };
+  const open = () => {
+    const input = inputValue();
+    if (input.length >= config().minChars) {
+      fetchSuggestions(input);
+    }
+  };
+  const handleKeyDown = (e) => {
+    if (!isOpen()) return false;
+    const type = resultType();
+    if (e.key === "Tab" && type === "completion" && ghostText()) {
+      e.preventDefault();
+      acceptCompletion();
+      return true;
+    }
+    if (type === "options") {
+      switch (e.key) {
+        case "ArrowDown":
+          e.preventDefault();
+          nextOption();
+          return true;
+        case "ArrowUp":
+          e.preventDefault();
+          prevOption();
+          return true;
+        case "Enter":
+          if (selectedIndex() >= 0) {
+            e.preventDefault();
+            selectCurrentOption();
+            return true;
+          }
+          break;
+        case "Tab":
+          if (selectedIndex() >= 0) {
+            e.preventDefault();
+            selectCurrentOption();
+            return true;
+          }
+          break;
+      }
+    }
+    if (e.key === "Escape") {
+      e.preventDefault();
+      dismiss();
+      return true;
+    }
+    return false;
+  };
+  return {
+    completion,
+    ghostText,
+    acceptCompletion,
+    options: options_,
+    selectedIndex,
+    selectOption,
+    nextOption,
+    prevOption,
+    selectCurrentOption,
+    isLoading,
+    error,
+    dismiss,
+    isOpen,
+    resultType,
+    open,
+    handleKeyDown
+  };
+}
+exports.useAutocomplete = useAutocomplete;
+//# sourceMappingURL=useAutocomplete.cjs.map

package/dist/hooks/useAutocomplete.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutocomplete.cjs","sources":["../../src/hooks/useAutocomplete.ts"],"sourcesContent":["/**\n * useAutocomplete Hook\n * Provides autocomplete functionality for form fields\n *\n * Sprint Autocomplete Feature\n */\n\nimport {\n  createSignal,\n  createEffect,\n  on,\n  Accessor,\n  onCleanup,\n  batch,\n  createMemo\n} from 'solid-js'\nimport { isServer } from 'solid-js/web'\nimport { useAutocompleteContextSafe } from '../context/AutocompleteContext'\nimport type {\n  AutocompleteOption,\n  AutocompleteContext,\n  FieldAutocompleteConfig\n} from '../types'\n\n/**\n * Options for the useAutocomplete hook\n */\nexport interface UseAutocompleteOptions {\n  /**\n   * Current input value accessor\n   */\n  inputValue: Accessor<string>\n\n  /**\n   * Plugin ID to use (overrides default)\n   */\n  pluginId?: string\n\n  /**\n   * Field configuration\n   */\n  fieldConfig?: FieldAutocompleteConfig\n\n  /**\n   * Context data for suggestions\n   */\n  context?: Accessor<AutocompleteContext>\n\n  /**\n   * Whether autocomplete is enabled\n   */\n  enabled?: boolean\n\n  /**\n   * Callback when input value should change (for accepting suggestions)\n   */\n  onInputChange?: (value: string) => void\n\n  /**\n   * Minimum characters before triggering\n   */\n  minChars?: number\n\n  /**\n   * Debounce delay in ms\n   */\n  debounceMs?: number\n}\n\n/**\n * Return type for the useAutocomplete hook\n */\nexport interface UseAutocompleteReturn {\n  /**\n   * Current completion text (for ghost text, LLM mode)\n   */\n  completion: Accessor<string | null>\n\n  /**\n   * Ghost text to show (remaining text after input)\n   */\n  ghostText: Accessor<string>\n\n  /**\n   * Accept the current completion\n   */\n  acceptCompletion: () => void\n\n  /**\n   * Current options (for dropdown, data mode)\n   */\n  options: Accessor<AutocompleteOption[]>\n\n  /**\n   * Currently selected option index\n   */\n  selectedIndex: Accessor<number>\n\n  /**\n   * Select an option by index\n   */\n  selectOption: (option: AutocompleteOption) => void\n\n  /**\n   * Navigate to next option\n   */\n  nextOption: () => void\n\n  /**\n   * Navigate to previous option\n   */\n  prevOption: () => void\n\n  /**\n   * Select current highlighted option\n   */\n  selectCurrentOption: () => void\n\n  /**\n   * Whether suggestions are loading\n   */\n  isLoading: Accessor<boolean>\n\n  /**\n   * Error message if any\n   */\n  error: Accessor<string | null>\n\n  /**\n   * Dismiss suggestions\n   */\n  dismiss: () => void\n\n  /**\n   * Whether suggestions are visible\n   */\n  isOpen: Accessor<boolean>\n\n  /**\n   * Result type ('completion' or 'options')\n   */\n  resultType: Accessor<'completion' | 'options' | null>\n\n  /**\n   * Open/show suggestions\n   */\n  open: () => void\n\n  /**\n   * Handle keyboard events\n   */\n  handleKeyDown: (e: KeyboardEvent) => boolean\n}\n\n/**\n * Debounce helper\n */\nfunction debounce<T extends (...args: any[]) => any>(\n  fn: T,\n  delay: number\n): { call: (...args: Parameters<T>) => void; cancel: () => void } {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n\n  return {\n    call: (...args: Parameters<T>) => {\n      if (timeoutId) clearTimeout(timeoutId)\n      timeoutId = setTimeout(() => {\n        fn(...args)\n        timeoutId = null\n      }, delay)\n    },\n    cancel: () => {\n      if (timeoutId) {\n        clearTimeout(timeoutId)\n        timeoutId = null\n      }\n    }\n  }\n}\n\n/**\n * Hook for autocomplete functionality\n */\nexport function useAutocomplete(options: UseAutocompleteOptions): UseAutocompleteReturn {\n  const {\n    inputValue,\n    pluginId,\n    fieldConfig,\n    context,\n    enabled = true,\n    onInputChange,\n    minChars: minCharsOption,\n    debounceMs: debounceOption\n  } = options\n\n  // Get context (may be undefined if no provider)\n  const autocompleteCtx = useAutocompleteContextSafe()\n\n  // State\n  const [completion, setCompletion] = createSignal<string | null>(null)\n  const [options_, setOptions] = createSignal<AutocompleteOption[]>([])\n  const [selectedIndex, setSelectedIndex] = createSignal(-1)\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [error, setError] = createSignal<string | null>(null)\n  const [isOpen, setIsOpen] = createSignal(false)\n  const [resultType, setResultType] = createSignal<'completion' | 'options' | null>(null)\n\n  // Config with defaults from context/options\n  const config = createMemo(() => ({\n    minChars: minCharsOption ?? fieldConfig?.minChars ?? autocompleteCtx?.config.minChars ?? 1,\n    debounceMs: debounceOption ?? fieldConfig?.debounceMs ?? autocompleteCtx?.config.debounceMs ?? 150\n  }))\n\n  // Ghost text (portion after current input)\n  const ghostText = createMemo(() => {\n    const comp = completion()\n    const input = inputValue()\n\n    if (!comp || !input) return ''\n\n    // If completion starts with input, show the remaining part\n    if (comp.toLowerCase().startsWith(input.toLowerCase())) {\n      return comp.slice(input.length)\n    }\n\n    return ''\n  })\n\n  // Fetch suggestions\n  const fetchSuggestions = async (input: string) => {\n    if (!autocompleteCtx) {\n      return\n    }\n\n    if (input.length < config().minChars) {\n      batch(() => {\n        setCompletion(null)\n        setOptions([])\n        setIsOpen(false)\n        setResultType(null)\n      })\n      return\n    }\n\n    setIsLoading(true)\n    setError(null)\n\n    try {\n      const targetPluginId = pluginId ?? fieldConfig?.plugin\n      const contextData = context?.()\n\n      const result = await autocompleteCtx.getSuggestions(\n        input,\n        targetPluginId,\n        contextData\n      )\n\n      batch(() => {\n        setResultType(result.type)\n\n        if (result.type === 'completion') {\n          setCompletion(result.completion || null)\n          setOptions([])\n          setIsOpen(!!result.completion)\n        } else {\n          setCompletion(null)\n          setOptions(result.options || [])\n          setSelectedIndex(-1)\n          setIsOpen((result.options?.length || 0) > 0)\n        }\n\n        setIsLoading(false)\n      })\n    } catch (e) {\n      batch(() => {\n        setError(e instanceof Error ? e.message : 'Unknown error')\n        setIsLoading(false)\n        setIsOpen(false)\n      })\n    }\n  }\n\n  // Debounced fetch\n  const debouncedFetch = debounce(fetchSuggestions, config().debounceMs)\n\n  // Watch input value changes\n  createEffect(\n    on(inputValue, (value) => {\n      if (!enabled || !autocompleteCtx || isServer) {\n        return\n      }\n\n      debouncedFetch.call(value)\n    })\n  )\n\n  // Cleanup\n  onCleanup(() => {\n    debouncedFetch.cancel()\n  })\n\n  /**\n   * Accept the current completion\n   */\n  const acceptCompletion = () => {\n    const comp = completion()\n    if (comp && onInputChange) {\n      onInputChange(comp)\n      batch(() => {\n        setCompletion(null)\n        setIsOpen(false)\n      })\n    }\n  }\n\n  /**\n   * Select an option\n   */\n  const selectOption = (option: AutocompleteOption) => {\n    if (onInputChange) {\n      onInputChange(option.value)\n    }\n    batch(() => {\n      setOptions([])\n      setSelectedIndex(-1)\n      setIsOpen(false)\n    })\n  }\n\n  /**\n   * Navigate to next option\n   */\n  const nextOption = () => {\n    const opts = options_()\n    if (opts.length === 0) return\n\n    setSelectedIndex((prev) => {\n      const next = prev + 1\n      return next >= opts.length ? 0 : next\n    })\n  }\n\n  /**\n   * Navigate to previous option\n   */\n  const prevOption = () => {\n    const opts = options_()\n    if (opts.length === 0) return\n\n    setSelectedIndex((prev) => {\n      const next = prev - 1\n      return next < 0 ? opts.length - 1 : next\n    })\n  }\n\n  /**\n   * Select current highlighted option\n   */\n  const selectCurrentOption = () => {\n    const idx = selectedIndex()\n    const opts = options_()\n    if (idx >= 0 && idx < opts.length) {\n      selectOption(opts[idx])\n    }\n  }\n\n  /**\n   * Dismiss suggestions\n   */\n  const dismiss = () => {\n    debouncedFetch.cancel()\n    batch(() => {\n      setCompletion(null)\n      setOptions([])\n      setSelectedIndex(-1)\n      setIsOpen(false)\n      setError(null)\n    })\n  }\n\n  /**\n   * Open suggestions\n   */\n  const open = () => {\n    const input = inputValue()\n    if (input.length >= config().minChars) {\n      fetchSuggestions(input)\n    }\n  }\n\n  /**\n   * Handle keyboard events\n   * Returns true if the event was handled\n   */\n  const handleKeyDown = (e: KeyboardEvent): boolean => {\n    if (!isOpen()) return false\n\n    const type = resultType()\n\n    // Tab to accept completion\n    if (e.key === 'Tab' && type === 'completion' && ghostText()) {\n      e.preventDefault()\n      acceptCompletion()\n      return true\n    }\n\n    // Arrow keys for dropdown navigation\n    if (type === 'options') {\n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault()\n          nextOption()\n          return true\n\n        case 'ArrowUp':\n          e.preventDefault()\n          prevOption()\n          return true\n\n        case 'Enter':\n          if (selectedIndex() >= 0) {\n            e.preventDefault()\n            selectCurrentOption()\n            return true\n          }\n          break\n\n        case 'Tab':\n          if (selectedIndex() >= 0) {\n            e.preventDefault()\n            selectCurrentOption()\n            return true\n          }\n          break\n      }\n    }\n\n    // Escape to dismiss\n    if (e.key === 'Escape') {\n      e.preventDefault()\n      dismiss()\n      return true\n    }\n\n    return false\n  }\n\n  return {\n    completion,\n    ghostText,\n    acceptCompletion,\n    options: options_,\n    selectedIndex,\n    selectOption,\n    nextOption,\n    prevOption,\n    selectCurrentOption,\n    isLoading,\n    error,\n    dismiss,\n    isOpen,\n    resultType,\n    open,\n    handleKeyDown\n  }\n}\n"],"names":["useAutocompleteContextSafe","createSignal","createMemo","batch","createEffect","on","isServer","onCleanup"],"mappings":"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"}

package/dist/hooks/useAutocomplete.d.ts

@@ -0,0 +1,119 @@
+/**
+ * useAutocomplete Hook
+ * Provides autocomplete functionality for form fields
+ *
+ * Sprint Autocomplete Feature
+ */
+import { Accessor } from 'solid-js';
+import type { AutocompleteOption, AutocompleteContext, FieldAutocompleteConfig } from '../types';
+/**
+ * Options for the useAutocomplete hook
+ */
+export interface UseAutocompleteOptions {
+    /**
+     * Current input value accessor
+     */
+    inputValue: Accessor<string>;
+    /**
+     * Plugin ID to use (overrides default)
+     */
+    pluginId?: string;
+    /**
+     * Field configuration
+     */
+    fieldConfig?: FieldAutocompleteConfig;
+    /**
+     * Context data for suggestions
+     */
+    context?: Accessor<AutocompleteContext>;
+    /**
+     * Whether autocomplete is enabled
+     */
+    enabled?: boolean;
+    /**
+     * Callback when input value should change (for accepting suggestions)
+     */
+    onInputChange?: (value: string) => void;
+    /**
+     * Minimum characters before triggering
+     */
+    minChars?: number;
+    /**
+     * Debounce delay in ms
+     */
+    debounceMs?: number;
+}
+/**
+ * Return type for the useAutocomplete hook
+ */
+export interface UseAutocompleteReturn {
+    /**
+     * Current completion text (for ghost text, LLM mode)
+     */
+    completion: Accessor<string | null>;
+    /**
+     * Ghost text to show (remaining text after input)
+     */
+    ghostText: Accessor<string>;
+    /**
+     * Accept the current completion
+     */
+    acceptCompletion: () => void;
+    /**
+     * Current options (for dropdown, data mode)
+     */
+    options: Accessor<AutocompleteOption[]>;
+    /**
+     * Currently selected option index
+     */
+    selectedIndex: Accessor<number>;
+    /**
+     * Select an option by index
+     */
+    selectOption: (option: AutocompleteOption) => void;
+    /**
+     * Navigate to next option
+     */
+    nextOption: () => void;
+    /**
+     * Navigate to previous option
+     */
+    prevOption: () => void;
+    /**
+     * Select current highlighted option
+     */
+    selectCurrentOption: () => void;
+    /**
+     * Whether suggestions are loading
+     */
+    isLoading: Accessor<boolean>;
+    /**
+     * Error message if any
+     */
+    error: Accessor<string | null>;
+    /**
+     * Dismiss suggestions
+     */
+    dismiss: () => void;
+    /**
+     * Whether suggestions are visible
+     */
+    isOpen: Accessor<boolean>;
+    /**
+     * Result type ('completion' or 'options')
+     */
+    resultType: Accessor<'completion' | 'options' | null>;
+    /**
+     * Open/show suggestions
+     */
+    open: () => void;
+    /**
+     * Handle keyboard events
+     */
+    handleKeyDown: (e: KeyboardEvent) => boolean;
+}
+/**
+ * Hook for autocomplete functionality
+ */
+export declare function useAutocomplete(options: UseAutocompleteOptions): UseAutocompleteReturn;
+//# sourceMappingURL=useAutocomplete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAutocomplete.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutocomplete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,QAAQ,EAIT,MAAM,UAAU,CAAA;AAGjB,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,UAAU,CAAA;AAEjB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAA;IAErC;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAEvC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEnC;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE3B;;OAEG;IACH,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAA;IAEvC;;OAEG;IACH,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE/B;;OAEG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAElD;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;OAEG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAA;IAE/B;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE5B;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAE9B;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IAEnB;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEzB;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IAErD;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAA;IAEhB;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAA;CAC7C;AA4BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA0RtF"}

package/dist/hooks/useAutocomplete.js

@@ -0,0 +1,234 @@
+import { createSignal, createMemo, createEffect, on, onCleanup, batch } from "solid-js";
+import { isServer } from "solid-js/web";
+import { useAutocompleteContextSafe } from "../context/AutocompleteContext.js";
+function debounce(fn, delay) {
+  let timeoutId = null;
+  return {
+    call: (...args) => {
+      if (timeoutId) clearTimeout(timeoutId);
+      timeoutId = setTimeout(() => {
+        fn(...args);
+        timeoutId = null;
+      }, delay);
+    },
+    cancel: () => {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+        timeoutId = null;
+      }
+    }
+  };
+}
+function useAutocomplete(options) {
+  const {
+    inputValue,
+    pluginId,
+    fieldConfig,
+    context,
+    enabled = true,
+    onInputChange,
+    minChars: minCharsOption,
+    debounceMs: debounceOption
+  } = options;
+  const autocompleteCtx = useAutocompleteContextSafe();
+  const [completion, setCompletion] = createSignal(null);
+  const [options_, setOptions] = createSignal([]);
+  const [selectedIndex, setSelectedIndex] = createSignal(-1);
+  const [isLoading, setIsLoading] = createSignal(false);
+  const [error, setError] = createSignal(null);
+  const [isOpen, setIsOpen] = createSignal(false);
+  const [resultType, setResultType] = createSignal(null);
+  const config = createMemo(() => ({
+    minChars: minCharsOption ?? (fieldConfig == null ? void 0 : fieldConfig.minChars) ?? (autocompleteCtx == null ? void 0 : autocompleteCtx.config.minChars) ?? 1,
+    debounceMs: debounceOption ?? (fieldConfig == null ? void 0 : fieldConfig.debounceMs) ?? (autocompleteCtx == null ? void 0 : autocompleteCtx.config.debounceMs) ?? 150
+  }));
+  const ghostText = createMemo(() => {
+    const comp = completion();
+    const input = inputValue();
+    if (!comp || !input) return "";
+    if (comp.toLowerCase().startsWith(input.toLowerCase())) {
+      return comp.slice(input.length);
+    }
+    return "";
+  });
+  const fetchSuggestions = async (input) => {
+    if (!autocompleteCtx) {
+      return;
+    }
+    if (input.length < config().minChars) {
+      batch(() => {
+        setCompletion(null);
+        setOptions([]);
+        setIsOpen(false);
+        setResultType(null);
+      });
+      return;
+    }
+    setIsLoading(true);
+    setError(null);
+    try {
+      const targetPluginId = pluginId ?? (fieldConfig == null ? void 0 : fieldConfig.plugin);
+      const contextData = context == null ? void 0 : context();
+      const result = await autocompleteCtx.getSuggestions(
+        input,
+        targetPluginId,
+        contextData
+      );
+      batch(() => {
+        var _a;
+        setResultType(result.type);
+        if (result.type === "completion") {
+          setCompletion(result.completion || null);
+          setOptions([]);
+          setIsOpen(!!result.completion);
+        } else {
+          setCompletion(null);
+          setOptions(result.options || []);
+          setSelectedIndex(-1);
+          setIsOpen((((_a = result.options) == null ? void 0 : _a.length) || 0) > 0);
+        }
+        setIsLoading(false);
+      });
+    } catch (e) {
+      batch(() => {
+        setError(e instanceof Error ? e.message : "Unknown error");
+        setIsLoading(false);
+        setIsOpen(false);
+      });
+    }
+  };
+  const debouncedFetch = debounce(fetchSuggestions, config().debounceMs);
+  createEffect(
+    on(inputValue, (value) => {
+      if (!enabled || !autocompleteCtx || isServer) {
+        return;
+      }
+      debouncedFetch.call(value);
+    })
+  );
+  onCleanup(() => {
+    debouncedFetch.cancel();
+  });
+  const acceptCompletion = () => {
+    const comp = completion();
+    if (comp && onInputChange) {
+      onInputChange(comp);
+      batch(() => {
+        setCompletion(null);
+        setIsOpen(false);
+      });
+    }
+  };
+  const selectOption = (option) => {
+    if (onInputChange) {
+      onInputChange(option.value);
+    }
+    batch(() => {
+      setOptions([]);
+      setSelectedIndex(-1);
+      setIsOpen(false);
+    });
+  };
+  const nextOption = () => {
+    const opts = options_();
+    if (opts.length === 0) return;
+    setSelectedIndex((prev) => {
+      const next = prev + 1;
+      return next >= opts.length ? 0 : next;
+    });
+  };
+  const prevOption = () => {
+    const opts = options_();
+    if (opts.length === 0) return;
+    setSelectedIndex((prev) => {
+      const next = prev - 1;
+      return next < 0 ? opts.length - 1 : next;
+    });
+  };
+  const selectCurrentOption = () => {
+    const idx = selectedIndex();
+    const opts = options_();
+    if (idx >= 0 && idx < opts.length) {
+      selectOption(opts[idx]);
+    }
+  };
+  const dismiss = () => {
+    debouncedFetch.cancel();
+    batch(() => {
+      setCompletion(null);
+      setOptions([]);
+      setSelectedIndex(-1);
+      setIsOpen(false);
+      setError(null);
+    });
+  };
+  const open = () => {
+    const input = inputValue();
+    if (input.length >= config().minChars) {
+      fetchSuggestions(input);
+    }
+  };
+  const handleKeyDown = (e) => {
+    if (!isOpen()) return false;
+    const type = resultType();
+    if (e.key === "Tab" && type === "completion" && ghostText()) {
+      e.preventDefault();
+      acceptCompletion();
+      return true;
+    }
+    if (type === "options") {
+      switch (e.key) {
+        case "ArrowDown":
+          e.preventDefault();
+          nextOption();
+          return true;
+        case "ArrowUp":
+          e.preventDefault();
+          prevOption();
+          return true;
+        case "Enter":
+          if (selectedIndex() >= 0) {
+            e.preventDefault();
+            selectCurrentOption();
+            return true;
+          }
+          break;
+        case "Tab":
+          if (selectedIndex() >= 0) {
+            e.preventDefault();
+            selectCurrentOption();
+            return true;
+          }
+          break;
+      }
+    }
+    if (e.key === "Escape") {
+      e.preventDefault();
+      dismiss();
+      return true;
+    }
+    return false;
+  };
+  return {
+    completion,
+    ghostText,
+    acceptCompletion,
+    options: options_,
+    selectedIndex,
+    selectOption,
+    nextOption,
+    prevOption,
+    selectCurrentOption,
+    isLoading,
+    error,
+    dismiss,
+    isOpen,
+    resultType,
+    open,
+    handleKeyDown
+  };
+}
+export {
+  useAutocomplete
+};
+//# sourceMappingURL=useAutocomplete.js.map