@but212/atom-effect-jquery 0.28.0 → 0.30.0

package/dist/index.d.ts

@@ -12,7 +12,7 @@ import { WritableAtom } from '@but212/atom-effect';
 declare type AsyncReactiveValue<T> = T | ReadonlyAtom<T | Promise<T>> | Promise<T> | (() => T | Promise<T>);
 
 export declare interface BindingOptions<T = unknown> {
-    text?: AsyncReactiveValue<unknown>;
+    text?: AsyncReactiveValue<unknown> | [source: AsyncReactiveValue<unknown>, formatter: (v: unknown) => string];
     html?: AsyncReactiveValue<string>;
     class?: Record<string, AsyncReactiveValue<boolean>>;
     css?: CssBindings;
@@ -22,7 +22,10 @@ export declare interface BindingOptions<T = unknown> {
     hide?: AsyncReactiveValue<boolean>;
     val?: WritableAtom<T> | [atom: WritableAtom<T>, options: ValOptions<T>];
     checked?: WritableAtom<boolean>;
-    form?: WritableAtom<T extends object ? T : unknown>;
+    form?: WritableAtom<T extends object ? T : unknown> | [
+    atom: WritableAtom<T extends object ? T : unknown>,
+    options: FormOptions<T extends object ? T : unknown>
+    ];
     on?: Record<string, (e: JQuery.Event) => void>;
 }
 
@@ -65,9 +68,9 @@ declare class BindingRegistry {
      */
     setComponentCleanup(el: Element, fn: (() => void) | undefined): void;
     hasBind(el: Element): boolean;
-    cleanup(el: Element | Node): void;
+    cleanup(el: Node): void;
     cleanupDescendants(el: Element | DocumentFragment | ShadowRoot): void;
-    cleanupTree(el: Element | Node): void;
+    cleanupTree(el: Node): void;
 }
 
 export declare type ComponentFn<P = Record<string, unknown>> = ($el: JQuery, props: P) => EffectResult;
@@ -99,13 +102,10 @@ export declare type EffectResult = undefined | EffectCleanup;
  * Starts observing `root` for removed elements and automatically disposes
  * their reactive bindings when they leave the DOM.
  *
+ * Supports Element, ShadowRoot, and DocumentFragment roots.
  * Multiple roots can be observed concurrently (e.g. for Micro-Frontends).
- * The `root` parameter is required (no default) to make the caller explicit
- * about which subtree is being observed.
- *
- * Idempotent: calling more than once with the same root has no effect.
  */
-export declare function enableAutoCleanup(root: Element): void;
+export declare function enableAutoCleanup(root: Element | ShadowRoot | DocumentFragment): void;
 
 export declare function enablejQueryOverrides(): void;
 
@@ -121,6 +121,16 @@ export declare interface FetchOptions<T> {
     eager?: boolean;
 }
 
+/**
+ * Options for `atomForm` binding.
+ */
+declare interface FormOptions<T> extends ValOptions<T> {
+    /** Custom function to transform field value based on path before atomic sync. */
+    transform?: (path: string, value: unknown) => unknown;
+    /** Callback triggered when a field value changes. */
+    onChange?: (path: string, value: unknown) => void;
+}
+
 /** Checks if a given value is a reactive node (Atom or Computed). */
 export declare const isReactive: (v: unknown) => v is ReadonlyAtom<unknown>;