align ts definitions from react to refs and forward refs (#3713)

* align ts definitions from react to refs and forward refs

* type ref to also allow null as per react type definition

* add PropsWithChildren also to preact/compat

Co-authored-by: Jovi De Croock <decroockjovi@gmail.com>

compat/src/index.d.ts

@@ -124,19 +124,29 @@ declare namespace React {
 	): C;
 
 	export interface ForwardFn<P = {}, T = any> {
-		(props: P, ref: Ref<T>): preact.ComponentChild;
+		(props: P, ref: ForwardedRef<T>): preact.ComponentChild;
 		displayName?: string;
 	}
 
 	export function forwardRef<R, P = {}>(
 		fn: ForwardFn<P, R>
 	): preact.FunctionalComponent<Omit<P, 'ref'> & { ref?: preact.Ref<R> }>;
 
+	interface MutableRefObject<T> {
+		current: T;
+	}
+
+	export type ForwardedRef<T> = ((instance: T | null) => void) | MutableRefObject<T | null> | null;
+
 	export function unstable_batchedUpdates(
 		callback: (arg?: any) => void,
 		arg?: any
 	): void;
 
+	export type PropsWithChildren<P = unknown> = P & {
+		children?: preact.ComponentChild | undefined
+	};
+
 	export const Children: {
 		map<T extends preact.ComponentChild, R>(
 			children: T | T[],

src/index.d.ts

@@ -39,7 +39,7 @@ export type Key = string | number | any;
 
 export type RefObject<T> = { current: T | null };
 export type RefCallback<T> = (instance: T | null) => void;
-export type Ref<T> = RefObject<T> | RefCallback<T>;
+export type Ref<T> = RefObject<T> | RefCallback<T> | null;
 
 export type ComponentChild =
 	| VNode<any>