@ikonai/sdk-react-ui-standard 1.0.44 → 1.0.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk-react-ui-standard",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/standard-core.d.ts

@@ -67,14 +67,22 @@ export declare function useOptimisticState<T>(serverValue: T | undefined, defaul
  */
 export declare function useOptimisticArrayState<T>(serverValue: T[] | undefined, defaultValue: T[], onChange?: (value: T[]) => void): [T[], (value: T[]) => void, boolean];
 /**
- * Hook for optimistic text input with debouncing.
- * Provides immediate visual feedback when users type, while debouncing server dispatches
- * to reduce network traffic.
+ * Hook for optimistic text input.
  *
- * @param serverValue - The controlled value from the server (undefined means uncontrolled)
- * @param defaultValue - The default value for uncontrolled mode
+ * Dispatches user keystrokes synchronously on every change (default) so reactive variables
+ * and downstream UI observers update in real-time. The input box itself is protected from
+ * server echo-back by a focus guard and a divergence guard.
+ *
+ * IME composition: while the user is composing (CJK, dead keys, accents), local value
+ * updates but dispatch is suppressed. The committed value is dispatched once on compositionend.
+ *
+ * Opt-in coalescing: pass debounceMs > 0 for search-style inputs that want to reduce
+ * dispatch traffic. Default 0 = synchronous.
+ *
+ * @param serverValue - Controlled value from the server (undefined means uncontrolled)
+ * @param defaultValue - Default value for uncontrolled mode
  * @param onChange - Optional callback when value changes (dispatches to server)
- * @param debounceMs - Debounce delay in milliseconds (default 150ms)
+ * @param debounceMs - Optional debounce delay (default 0 = immediate)
  * @returns Tuple of [currentValue, setValue, flush, isPending, inputRef]
  */
 export declare function useOptimisticTextState(serverValue: string | undefined, defaultValue: string, onChange?: (value: string) => void, debounceMs?: number): [string, (value: string) => void, () => void, boolean, React.RefObject<HTMLInputElement | HTMLTextAreaElement | null>];

package/utils/file-picker-store.d.ts

@@ -0,0 +1,5 @@
+export declare function stashSelection(id: string, file: File): void;
+export declare function takeSelection(id: string): File | undefined;
+export declare function peekSelection(id: string): File | undefined;
+export declare function hasSelection(id: string): boolean;
+export declare function dropSelection(id: string): void;