chore: Backport refcallback type and debug helpers (#4860)

* fix: Backport RefCallback type change for cleanups

Co-authored-by: Jason Miller <[email protected]>

* feat: Backport exporting of helper function from debug

Co-authored-by: Qingyu Wang <[email protected]>

---------

Co-authored-by: Jason Miller <[email protected]>
Co-authored-by: Qingyu Wang <[email protected]>

Author: 3 people

debug/src/index.d.ts

@@ -1,3 +1,22 @@
+import { VNode } from 'preact';
+
+/**
+ * Get the currently rendered `vnode`
+ */
+export function getCurrentVNode(): VNode | null;
+
+/**
+ * Return the component stack that was captured up to this point.
+ */
+export function getOwnerStack(vnode: VNode): string;
+
+/**
+ * Setup code to capture the component trace while rendering. Note that
+ * we cannot simply traverse `vnode._parent` upwards, because we have some
+ * debug messages for `this.setState` where the `vnode` is `undefined`.
+ */
+export function setupComponentStack(): void;
+
 /**
  * Reset the history of which prop type warnings have been logged.
  */

debug/src/index.js

@@ -4,3 +4,9 @@ import 'preact/devtools';
 initDebug();
 
 export { resetPropWarnings } from './check-props';
+
+export {
+	getCurrentVNode,
+	getDisplayName,
+	getOwnerStack
+} from './component-stack';

src/index-5.d.ts

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

src/index.d.ts

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