@but212/atom-effect-jquery 0.27.0 → 0.29.0

package/dist/index.d.ts

@@ -1,14 +1,7 @@
-import { atom } from '@but212/atom-effect';
-import { batch } from '@but212/atom-effect';
-import { computed } from '@but212/atom-effect';
 import { ComputedAtom } from '@but212/atom-effect';
 import { default as default_2 } from 'jquery';
-import { effect } from '@but212/atom-effect';
 import { EffectObject } from '@but212/atom-effect';
-import { isAtom } from '@but212/atom-effect';
-import { isComputed } from '@but212/atom-effect';
 import { ReadonlyAtom } from '@but212/atom-effect';
-import { untracked } from '@but212/atom-effect';
 import { WritableAtom } from '@but212/atom-effect';
 
 /**
@@ -18,15 +11,6 @@ import { WritableAtom } from '@but212/atom-effect';
  */
 declare type AsyncReactiveValue<T> = T | ReadonlyAtom<T | Promise<T>> | Promise<T> | (() => T | Promise<T>);
 
-export { atom }
-
-/**
- * Creates a two-way "lens" for a specific property path on an object-based atom.
- */
-export declare function atomLens<T extends object, P extends Paths<T>>(atom: WritableAtom<T>, path: P): WritableAtom<PathValue<T, P>>;
-
-export { batch }
-
 export declare interface BindingOptions<T = unknown> {
     text?: AsyncReactiveValue<unknown>;
     html?: AsyncReactiveValue<string>;
@@ -38,7 +22,7 @@ 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<unknown>];
     on?: Record<string, (e: JQuery.Event) => void>;
 }
 
@@ -88,13 +72,6 @@ declare class BindingRegistry {
 
 export declare type ComponentFn<P = Record<string, unknown>> = ($el: JQuery, props: P) => EffectResult;
 
-/**
- * Composes an existing lens with a sub-path to create a deeper lens.
- */
-export declare const composeLens: <T extends object, P extends Paths<T>>(lens: WritableAtom<T>, path: P) => WritableAtom<PathValue<T, P>>;
-
-export { computed }
-
 export { ComputedAtom }
 
 export declare type CssBindings = Record<string, CssValue>;
@@ -114,8 +91,6 @@ export declare function disableAutoCleanup(): void;
  */
 export declare function disablejQueryOverrides(): void;
 
-export { effect }
-
 export declare type EffectCleanup = () => void;
 
 export declare type EffectResult = undefined | EffectCleanup;
@@ -146,9 +121,15 @@ export declare interface FetchOptions<T> {
     eager?: boolean;
 }
 
-export { isAtom }
-
-export { isComputed }
+/**
+ * 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>;
@@ -157,11 +138,6 @@ declare type KeysOfType<T, V> = {
     [K in keyof T]: T[K] extends V ? K : never;
 }[keyof T];
 
-/**
- * Creates a lens factory bound to a specific atom.
- */
-export declare const lensFor: <T extends object>(atom: WritableAtom<T>) => <P extends Paths<T>>(path: P) => WritableAtom<PathValue<T, P>>;
-
 declare type ListKey = string | number;
 
 declare type ListKeyFn<T> = (item: T, index: number) => ListKey;
@@ -180,34 +156,9 @@ export declare interface ListOptions<T> {
 
 declare type ListRenderResult = string | Element | DocumentFragment | JQuery;
 
-/** Max recursion depth for dot-paths. */
-declare type MaxDepth = 8;
-
 /** Resolves after microtask effects flush. Fast Promise-based scheduling. */
 export declare const nextTick: () => Promise<void>;
 
-/**
- * Generates a union of all possible dot-separated paths for a given type T.
- *
- * Used for `atomLens` to provide IDE autocomplete and type safety when
- * zooming into deeply nested reactive objects.
- *
- * @example
- * type User = { profile: { name: string } };
- * type P = Paths<User>; // "profile" | "profile.name"
- */
-export declare type Paths<T, D extends unknown[] = []> = D['length'] extends MaxDepth ? never : T extends object ? {
-    [K in keyof T & (string | number)]-?: `${K}` | (T[K] extends object ? `${K}.${Paths<T[K], [...D, 1]>}` : never);
-}[keyof T & (string | number)] : never;
-
-/**
- * Resolves the type of a value at a specific dot-path P within type T.
- *
- * Works in tandem with `Paths<T>` to ensure that lensed atoms have
- * the correct inferred type for the member they point to.
- */
-export declare type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? StringKeyToNumber<K> extends keyof T ? PathValue<T[StringKeyToNumber<K> & keyof T], Rest> : never : StringKeyToNumber<P> extends keyof T ? T[StringKeyToNumber<P> & keyof T] : never;
-
 export declare type PrimitiveValue = string | number | boolean | null | undefined;
 
 /**
@@ -254,17 +205,12 @@ export declare interface Router {
     destroy: () => void;
 }
 
-/** Helper to convert numeric string to number for array indexing. */
-declare type StringKeyToNumber<S extends string> = S extends `${infer N extends number}` ? N : S;
-
 export declare interface TemplateRoute extends RouteLifecycle {
     template: string;
     render?: never;
     onMount?: ($content: JQuery, onUnmount: (cleanupFn: () => void) => void, router: Router) => void;
 }
 
-export { untracked }
-
 /**
  * Options for `atomVal`, `atomChecked`, and `atomForm` bindings.
  */