bippy 0.3.13 → 0.3.14

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2024 Aiden Bai, Million Software, Inc.
+Copyright 2024 Aiden Bai
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/dist/chunk-DWy1uDak.cjs

@@ -0,0 +1,47 @@
+/**
+ * @license bippy
+ *
+ * Copyright (c) Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__commonJS', {
+  enumerable: true,
+  get: function () {
+    return __commonJS;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/core-BOYfIZ0s.d.cts

@@ -0,0 +1,293 @@
+import * as React$2 from "react";
+import { BundleType, ComponentSelector, DevToolsConfig, Fiber, FiberRoot, Flags, HasPseudoClassSelector, HookType, HostConfig, LanePriority, Lanes, MutableSource, OpaqueHandle, OpaqueRoot, React$AbstractComponent, ReactConsumer, ReactContext, ReactPortal, ReactProvider, ReactProviderType, RefObject, RoleSelector, RootTag, Selector, Source, SuspenseHydrationCallbacks, TestNameSelector, TextSelector, Thenable, TransitionTracingCallbacks, TypeOfMode, WorkTag } from "react-reconciler";
+
+//#region src/types.d.ts
+interface ReactDevToolsGlobalHook {
+  checkDCE: (fn: unknown) => void;
+  supportsFiber: boolean;
+  supportsFlight: boolean;
+  renderers: Map<number, ReactRenderer>;
+  hasUnsupportedRendererAttached: boolean;
+  onCommitFiberRoot: (rendererID: number, root: FiberRoot, priority: void | number) => void;
+  onCommitFiberUnmount: (rendererID: number, fiber: Fiber$1) => void;
+  onPostCommitFiberRoot: (rendererID: number, root: FiberRoot) => void;
+  inject: (renderer: ReactRenderer) => number;
+  _instrumentationSource?: string;
+  _instrumentationIsActive?: boolean;
+  _sw?: boolean;
+}
+/**
+ * Represents a react-internal Fiber node.
+ */
+type Fiber$1<T = any> = Omit<Fiber, 'stateNode' | 'dependencies' | 'child' | 'sibling' | 'return' | 'alternate' | 'memoizedProps' | 'pendingProps' | 'memoizedState' | 'updateQueue'> & {
+  stateNode: T;
+  dependencies: Dependencies | null;
+  child: Fiber$1 | null;
+  sibling: Fiber$1 | null;
+  return: Fiber$1 | null;
+  alternate: Fiber$1 | null;
+  memoizedProps: Props;
+  pendingProps: Props;
+  memoizedState: MemoizedState;
+  updateQueue: {
+    lastEffect: Effect | null;
+    [key: string]: unknown;
+  };
+};
+interface ReactRenderer {
+  version: string;
+  bundleType: 0 | 1;
+  findFiberByHostInstance?: (hostInstance: unknown) => Fiber$1 | null;
+  currentDispatcherRef: React.RefObject<unknown>;
+}
+interface ContextDependency<T> {
+  context: ReactContext<T>;
+  memoizedValue: T;
+  observedBits: number;
+  next: ContextDependency<unknown> | null;
+}
+interface Dependencies {
+  lanes: Lanes;
+  firstContext: ContextDependency<unknown> | null;
+}
+interface Effect {
+  next: Effect | null;
+  create: (...args: unknown[]) => unknown;
+  destroy: ((...args: unknown[]) => unknown) | null;
+  deps: unknown[] | null;
+  tag: number;
+  [key: string]: unknown;
+}
+interface MemoizedState {
+  memoizedState: unknown;
+  next: MemoizedState | null;
+  [key: string]: unknown;
+}
+interface Props {
+  [key: string]: unknown;
+}
+declare global {
+  var __REACT_DEVTOOLS_GLOBAL_HOOK__: ReactDevToolsGlobalHook | undefined;
+} //#endregion
+//#region src/install-hook-script-string.d.ts
+declare const INSTALL_HOOK_SCRIPT_STRING = "(()=>{try{var t=()=>{};const n=new Map;let o=0;globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__={checkDCE:t,supportsFiber:!0,supportsFlight:!0,hasUnsupportedRendererAttached:!1,renderers:n,onCommitFiberRoot:t,onCommitFiberUnmount:t,onPostCommitFiberRoot:t,inject(t){var e=++o;return n.set(e,t),globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__._instrumentationIsActive=!0,e},_instrumentationIsActive:!1,_script:!0}}catch{}})()";
+
+//#endregion
+//#region src/rdt-hook.d.ts
+declare const version: string | undefined;
+declare const BIPPY_INSTRUMENTATION_STRING: string;
+declare const isRealReactDevtools: (rdtHook?: ReactDevToolsGlobalHook) => boolean;
+declare const isReactRefresh: (rdtHook?: ReactDevToolsGlobalHook) => boolean;
+declare const _renderers: Set<ReactRenderer>;
+declare const installRDTHook: (onActive?: () => unknown) => ReactDevToolsGlobalHook;
+declare const patchRDTHook: (onActive?: () => unknown) => void;
+declare const hasRDTHook: () => boolean;
+/**
+ * Returns the current React DevTools global hook.
+ */
+declare const getRDTHook: (onActive?: () => unknown) => ReactDevToolsGlobalHook;
+declare const isClientEnvironment: () => boolean;
+/**
+ * Usually used purely for side effect
+ */
+declare const safelyInstallRDTHook: () => void;
+
+//#endregion
+//#region src/core.d.ts
+declare const FunctionComponentTag = 0;
+declare const ClassComponentTag = 1;
+declare const HostRootTag = 3;
+declare const HostComponentTag = 5;
+declare const HostTextTag = 6;
+declare const FragmentTag = 7;
+declare const ContextConsumerTag = 9;
+declare const ForwardRefTag = 11;
+declare const SuspenseComponentTag = 13;
+declare const MemoComponentTag = 14;
+declare const SimpleMemoComponentTag = 15;
+declare const DehydratedSuspenseComponentTag = 18;
+declare const OffscreenComponentTag = 22;
+declare const LegacyHiddenComponentTag = 23;
+declare const HostHoistableTag = 26;
+declare const HostSingletonTag = 27;
+declare const CONCURRENT_MODE_NUMBER = 60111;
+declare const ELEMENT_TYPE_SYMBOL_STRING = "Symbol(react.element)";
+declare const TRANSITIONAL_ELEMENT_TYPE_SYMBOL_STRING = "Symbol(react.transitional.element)";
+declare const CONCURRENT_MODE_SYMBOL_STRING = "Symbol(react.concurrent_mode)";
+declare const DEPRECATED_ASYNC_MODE_SYMBOL_STRING = "Symbol(react.async_mode)";
+/**
+ * Returns `true` if object is a React Element.
+ *
+ * @see https://react.dev/reference/react/isValidElement
+ */
+declare const isValidElement: (element: unknown) => element is React$2.ReactElement;
+/**
+ * Returns `true` if object is a React Fiber.
+ */
+declare const isValidFiber: (fiber: unknown) => fiber is Fiber$1;
+/**
+ * Returns `true` if fiber is a host fiber. Host fibers are DOM nodes in react-dom, `View` in react-native, etc.
+ *
+ * @see https://reactnative.dev/architecture/glossary#host-view-tree-and-host-view
+ */
+declare const isHostFiber: (fiber: Fiber$1) => boolean;
+/**
+ * Returns `true` if fiber is a composite fiber. Composite fibers are fibers that can render (like functional components, class components, etc.)
+ *
+ * @see https://reactnative.dev/architecture/glossary#react-composite-components
+ */
+declare const isCompositeFiber: (fiber: Fiber$1) => boolean;
+/**
+ * Traverses up or down a {@link Fiber}'s contexts, return `true` to stop and select the current and previous context value.
+ */
+declare const traverseContexts: (fiber: Fiber$1, selector: (nextValue: ContextDependency<unknown> | null | undefined, prevValue: ContextDependency<unknown> | null | undefined) => boolean | void) => boolean;
+/**
+ * Traverses up or down a {@link Fiber}'s states, return `true` to stop and select the current and previous state value. This stores both state values and effects.
+ */
+declare const traverseState: (fiber: Fiber$1, selector: (nextValue: MemoizedState | null | undefined, prevValue: MemoizedState | null | undefined) => boolean | void) => boolean;
+/**
+ * Traverses up or down a {@link Fiber}'s props, return `true` to stop and select the current and previous props value.
+ */
+declare const traverseProps: (fiber: Fiber$1, selector: (propName: string, nextValue: unknown, prevValue: unknown) => boolean | void) => boolean;
+/**
+ * Returns `true` if the {@link Fiber} has rendered. Note that this does not mean the fiber has rendered in the current commit, just that it has rendered in the past.
+ */
+declare const didFiberRender: (fiber: Fiber$1) => boolean;
+/**
+ * Returns `true` if the {@link Fiber} has committed. Note that this does not mean the fiber has committed in the current commit, just that it has committed in the past.
+ */
+declare const didFiberCommit: (fiber: Fiber$1) => boolean;
+/**
+ * Returns all host {@link Fiber}s that have committed and rendered.
+ */
+declare const getMutatedHostFibers: (fiber: Fiber$1) => Fiber$1[];
+/**
+ * Returns the stack of {@link Fiber}s from the current fiber to the root fiber.
+ *
+ * @example
+ * ```ts
+ * [fiber, fiber.return, fiber.return.return, ...]
+ * ```
+ */
+declare const getFiberStack: (fiber: Fiber$1) => Fiber$1[];
+/**
+ * Returns `true` if the {@link Fiber} should be filtered out during reconciliation.
+ */
+declare const shouldFilterFiber: (fiber: Fiber$1) => boolean;
+/**
+ * Returns the nearest host {@link Fiber} to the current {@link Fiber}.
+ */
+declare const getNearestHostFiber: (fiber: Fiber$1, ascending?: boolean) => Fiber$1 | null;
+/**
+ * Returns all host {@link Fiber}s in the tree that are associated with the current {@link Fiber}.
+ */
+declare const getNearestHostFibers: (fiber: Fiber$1) => Fiber$1[];
+/**
+ * Traverses up or down a {@link Fiber}, return `true` to stop and select a node.
+ */
+declare const traverseFiber: (fiber: Fiber$1 | null, selector: (node: Fiber$1) => boolean | void, ascending?: boolean) => Fiber$1 | null;
+/**
+ * Returns the timings of the {@link Fiber}.
+ *
+ * @example
+ * ```ts
+ * const { selfTime, totalTime } = getTimings(fiber);
+ * console.log(selfTime, totalTime);
+ * ```
+ */
+declare const getTimings: (fiber?: Fiber$1 | null | undefined) => {
+  selfTime: number;
+  totalTime: number;
+};
+/**
+ * Returns `true` if the {@link Fiber} uses React Compiler's memo cache.
+ */
+declare const hasMemoCache: (fiber: Fiber$1) => boolean;
+/**
+ * Returns the type (e.g. component definition) of the {@link Fiber}
+ */
+declare const getType: (type: unknown) => React$2.ComponentType<unknown> | null;
+/**
+ * Returns the display name of the {@link Fiber} type.
+ */
+declare const getDisplayName: (type: unknown) => string | null;
+/**
+ * Returns the build type of the React renderer.
+ */
+declare const detectReactBuildType: (renderer: ReactRenderer) => "development" | "production";
+/**
+ * Returns `true` if bippy's instrumentation is active.
+ */
+declare const isInstrumentationActive: () => boolean;
+/**
+ * Returns the latest fiber (since it may be double-buffered).
+ */
+declare const getLatestFiber: (fiber: Fiber$1) => Fiber$1;
+type RenderPhase = 'mount' | 'update' | 'unmount';
+type RenderHandler = <S>(fiber: Fiber$1, phase: RenderPhase, state?: S) => unknown;
+declare const fiberIdMap: WeakMap<Fiber$1, number>;
+declare const setFiberId: (fiber: Fiber$1, id?: number) => void;
+declare const getFiberId: (fiber: Fiber$1) => number;
+declare const mountFiberRecursively: (onRender: RenderHandler, firstChild: Fiber$1, traverseSiblings: boolean) => void;
+declare const updateFiberRecursively: (onRender: RenderHandler, nextFiber: Fiber$1, prevFiber: Fiber$1, parentFiber: Fiber$1 | null) => void;
+declare const unmountFiber: (onRender: RenderHandler, fiber: Fiber$1) => void;
+declare const unmountFiberChildrenRecursively: (onRender: RenderHandler, fiber: Fiber$1) => void;
+/**
+ * Creates a fiber visitor function. Must pass a fiber root and a render handler.
+ * @example
+ * traverseRenderedFibers(root, (fiber, phase) => {
+ *   console.log(phase)
+ * })
+ */
+declare const traverseRenderedFibers: (root: FiberRoot, onRender: RenderHandler) => void;
+/**
+ * @deprecated use `traverseRenderedFibers` instead
+ */
+declare const createFiberVisitor: ({
+  onRender
+}: {
+  onRender: RenderHandler;
+  onError: (error: unknown) => unknown;
+}) => (<S>(_rendererID: number, root: FiberRoot | Fiber$1, _state?: S) => void);
+interface InstrumentationOptions {
+  onCommitFiberRoot?: (rendererID: number, root: FiberRoot, priority: void | number) => unknown;
+  onCommitFiberUnmount?: (rendererID: number, fiber: Fiber$1) => unknown;
+  onPostCommitFiberRoot?: (rendererID: number, root: FiberRoot) => unknown;
+  onActive?: () => unknown;
+  name?: string;
+}
+/**
+ * Instruments the DevTools hook.
+ * @example
+ * const hook = instrument({
+ *   onActive() {
+ *     console.log('initialized');
+ *   },
+ *   onCommitFiberRoot(rendererID, root) {
+ *     console.log('fiberRoot', root.current)
+ *   },
+ * });
+ */
+declare const instrument: (options: InstrumentationOptions) => ReactDevToolsGlobalHook;
+declare const getFiberFromHostInstance: <T>(hostInstance: T) => Fiber$1 | null;
+declare const INSTALL_ERROR: Error;
+declare const _fiberRoots: Set<any>;
+declare const secure: (options: InstrumentationOptions, secureOptions?: {
+  minReactMajorVersion?: number;
+  dangerouslyRunInProduction?: boolean;
+  onError?: (error?: unknown) => unknown;
+  installCheckTimeout?: number;
+  isProduction?: boolean;
+}) => InstrumentationOptions;
+/**
+ * a wrapper around the {@link instrument} function that sets the `onCommitFiberRoot` hook.
+ *
+ * @example
+ * onCommitFiberRoot((root) => {
+ *   console.log(root.current);
+ * });
+ */
+declare const onCommitFiberRoot: (handler: (root: FiberRoot) => void) => ReactDevToolsGlobalHook;
+
+//#endregion
+export { BIPPY_INSTRUMENTATION_STRING, BundleType, CONCURRENT_MODE_NUMBER, CONCURRENT_MODE_SYMBOL_STRING, ClassComponentTag, ComponentSelector, ContextConsumerTag, ContextDependency, DEPRECATED_ASYNC_MODE_SYMBOL_STRING, DehydratedSuspenseComponentTag, Dependencies, DevToolsConfig, ELEMENT_TYPE_SYMBOL_STRING, Effect, Fiber$1 as Fiber, FiberRoot, Flags, ForwardRefTag, FragmentTag, FunctionComponentTag, HasPseudoClassSelector, HookType, HostComponentTag, HostConfig, HostHoistableTag, HostRootTag, HostSingletonTag, HostTextTag, INSTALL_ERROR, INSTALL_HOOK_SCRIPT_STRING, InstrumentationOptions, LanePriority, Lanes, LegacyHiddenComponentTag, MemoComponentTag, MemoizedState, MutableSource, OffscreenComponentTag, OpaqueHandle, OpaqueRoot, Props, React$AbstractComponent, ReactConsumer, ReactContext, ReactDevToolsGlobalHook, ReactPortal, ReactProvider, ReactProviderType, ReactRenderer, RefObject, RenderHandler, RenderPhase, RoleSelector, RootTag, Selector, SimpleMemoComponentTag, Source, SuspenseComponentTag, SuspenseHydrationCallbacks, TRANSITIONAL_ELEMENT_TYPE_SYMBOL_STRING, TestNameSelector, TextSelector, Thenable, TransitionTracingCallbacks, TypeOfMode, WorkTag, _fiberRoots, _renderers, createFiberVisitor, detectReactBuildType, didFiberCommit, didFiberRender, fiberIdMap, getDisplayName, getFiberFromHostInstance, getFiberId, getFiberStack, getLatestFiber, getMutatedHostFibers, getNearestHostFiber, getNearestHostFibers, getRDTHook, getTimings, getType, hasMemoCache, hasRDTHook, installRDTHook, instrument, isClientEnvironment, isCompositeFiber, isHostFiber, isInstrumentationActive, isReactRefresh, isRealReactDevtools, isValidElement, isValidFiber, mountFiberRecursively, onCommitFiberRoot, patchRDTHook, safelyInstallRDTHook, secure, setFiberId, shouldFilterFiber, traverseContexts, traverseFiber, traverseProps, traverseRenderedFibers, traverseState, unmountFiber, unmountFiberChildrenRecursively, updateFiberRecursively, version };