@but212/atom-effect-jquery 0.24.1 → 0.25.0

package/dist/index.d.ts

@@ -11,6 +11,12 @@ import { ReadonlyAtom } from '@but212/atom-effect';
 import { untracked } from '@but212/atom-effect';
 import { WritableAtom } from '@but212/atom-effect';
 
+/**
+ * Represents a value that can be a synchronous `ReactiveValue<T>`,
+ * a `Promise<T>`, or an Atom yielding `T | Promise<T>`.
+ */
+declare type AsyncReactiveValue<T> = T | ReadonlyAtom<T | Promise<T>> | Promise<T> | (() => T | Promise<T>);
+
 export { atom }
 
 export { batch }
@@ -21,21 +27,21 @@ export { batch }
  */
 export declare interface BindingOptions<T = unknown> {
     /** Binds textContent to any reactive source. */
-    text?: ReactiveValue<unknown>;
+    text?: AsyncReactiveValue<unknown>;
     /** Binds innerHTML to a reactive string source (sanitized). */
-    html?: ReactiveValue<string>;
+    html?: AsyncReactiveValue<string>;
     /** Map of class names to reactive boolean conditions. */
-    class?: Record<string, ReactiveValue<boolean>>;
+    class?: Record<string, AsyncReactiveValue<boolean>>;
     /** Map of CSS properties to reactive values or [value, unit] tuples. */
     css?: CssBindings;
     /** Binds attributes with consistent primitive constraints. */
-    attr?: Record<string, ReactiveValue<PrimitiveValue>>;
+    attr?: Record<string, AsyncReactiveValue<PrimitiveValue>>;
     /** Binds DOM properties. */
-    prop?: Record<string, ReactiveValue<unknown>>;
+    prop?: Record<string, AsyncReactiveValue<unknown>>;
     /** Direct visibility control (display: none). */
-    show?: ReactiveValue<boolean>;
+    show?: AsyncReactiveValue<boolean>;
     /** Inverse visibility control. */
-    hide?: ReactiveValue<boolean>;
+    hide?: AsyncReactiveValue<boolean>;
     /**
      * Two-way binding for input values.
      * Pass an atom or a `[atom, options]` tuple.
@@ -43,6 +49,8 @@ export declare interface BindingOptions<T = unknown> {
     val?: WritableAtom<T> | [atom: WritableAtom<T>, options: ValOptions<T>];
     /** Two-way binding for checkboxes and radio buttons. */
     checked?: WritableAtom<boolean>;
+    /** Fully automated two-way form binding using name attributes. */
+    form?: WritableAtom<T extends object ? T : unknown>;
     /** Event listeners with automatic batched execution and lifecycle-bound cleanup. */
     on?: Record<string, (e: JQuery.Event) => void>;
 }
@@ -92,7 +100,7 @@ export declare type CssBindings = Record<string, CssValue>;
 /**
  * CSS value: either a direct reactive value or a numeric tuple of [source, unit].
  */
-export declare type CssValue = ReactiveValue<string | number> | [source: ReactiveValue<number>, unit: string];
+export declare type CssValue = AsyncReactiveValue<string | number> | [source: AsyncReactiveValue<number>, unit: string];
 
 export default default_2;
 
@@ -261,7 +269,7 @@ export declare type PrimitiveValue = string | number | boolean | null | undefine
  * `ComputedAtom<T>` is a structural sub-type of `ReadonlyAtom<T>`, so it is
  * already covered by `ReadonlyAtom<T>`.
  */
-export declare type ReactiveValue<T> = T | ReadonlyAtom<T>;
+export declare type ReactiveValue<T> = T | ReadonlyAtom<T> | (() => T);
 
 export { ReadonlyAtom }