bippy 0.6.1-dev.fe75557 → 0.7.0-dev.697d535

package/dist/unsubscribe.d.ts

@@ -1,298 +0,0 @@
-import { ReactNode } from "react";
-
-//#region src/types.d.ts
-type BundleType = 0 | 1;
-type Flags = number;
-type Lanes = number;
-type TypeOfMode = number;
-type RootTag = 0 | 1 | 2;
-type LanePriority = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17;
-type WorkTag = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31;
-type HookType = "useState" | "useReducer" | "useContext" | "useRef" | "useEffect" | "useLayoutEffect" | "useCallback" | "useMemo" | "useImperativeHandle" | "useDebugValue" | "useDeferredValue" | "useTransition" | "useMutableSource" | "useOpaqueIdentifier" | "useCacheRefresh";
-type FiberRoot = any;
-type MutableSource = any;
-type OpaqueHandle = any;
-type OpaqueRoot = any;
-type React$AbstractComponent<_Config, _Instance = unknown> = any;
-type HostConfig = Record<string, any>;
-interface Source {
-  fileName: string;
-  lineNumber: number;
-}
-interface RefObject {
-  current: any;
-}
-interface Thenable<T> {
-  then(resolve: () => T, reject?: () => T): T;
-}
-interface ReactContext<T> {
-  $$typeof: symbol | number;
-  Consumer: ReactContext<T>;
-  Provider: ReactProviderType<T>;
-  _calculateChangedBits: ((a: T, b: T) => number) | null;
-  _currentValue: T;
-  _currentValue2: T;
-  _threadCount: number;
-  _currentRenderer?: Record<string, any> | null;
-  _currentRenderer2?: Record<string, any> | null;
-  displayName?: string;
-}
-interface ReactProviderType<T> {
-  $$typeof: symbol | number;
-  _context: ReactContext<T>;
-}
-interface ReactProvider<T> {
-  $$typeof: symbol | number;
-  type: ReactProviderType<T>;
-  key: null | string;
-  ref: null;
-  props: {
-    value: T;
-    children?: ReactNode;
-  };
-}
-interface ReactConsumer<T> {
-  $$typeof: symbol | number;
-  type: ReactContext<T>;
-  key: null | string;
-  ref: null;
-  props: {
-    children: (value: T) => ReactNode;
-    unstable_observedBits?: number;
-  };
-}
-interface ReactPortal {
-  $$typeof: symbol | number;
-  key: null | string;
-  containerInfo: any;
-  children: ReactNode;
-  implementation: any;
-}
-interface ComponentSelector {
-  $$typeof: symbol | number;
-  value: React$AbstractComponent<never, unknown>;
-}
-interface HasPseudoClassSelector {
-  $$typeof: symbol | number;
-  value: Selector[];
-}
-interface RoleSelector {
-  $$typeof: symbol | number;
-  value: string;
-}
-interface TextSelector {
-  $$typeof: symbol | number;
-  value: string;
-}
-interface TestNameSelector {
-  $$typeof: symbol | number;
-  value: string;
-}
-type Selector = ComponentSelector | HasPseudoClassSelector | RoleSelector | TextSelector | TestNameSelector;
-interface DevToolsConfig<Instance = any, TextInstance = any, RendererInspectionConfig = any> {
-  bundleType: BundleType;
-  version: string;
-  rendererPackageName: string;
-  findFiberByHostInstance?: (instance: Instance | TextInstance) => ReactFiber | null;
-  rendererConfig?: RendererInspectionConfig;
-}
-interface SuspenseHydrationCallbacks<SuspenseInstance = unknown> {
-  onHydrated?: (suspenseInstance: SuspenseInstance) => void;
-  onDeleted?: (suspenseInstance: SuspenseInstance) => void;
-}
-interface TransitionTracingCallbacks {
-  onTransitionStart?: (transitionName: string, startTime: number) => void;
-  onTransitionProgress?: (transitionName: string, startTime: number, currentTime: number, pending: Array<{
-    name: null | string;
-  }>) => void;
-  onTransitionIncomplete?: (transitionName: string, startTime: number, deletions: Array<{
-    type: string;
-    name?: string;
-    newName?: string;
-    endTime: number;
-  }>) => void;
-  onTransitionComplete?: (transitionName: string, startTime: number, endTime: number) => void;
-  onMarkerProgress?: (transitionName: string, marker: string, startTime: number, currentTime: number, pending: Array<{
-    name: null | string;
-  }>) => void;
-  onMarkerIncomplete?: (transitionName: string, marker: string, startTime: number, deletions: Array<{
-    type: string;
-    name?: string;
-    newName?: string;
-    endTime: number;
-  }>) => void;
-  onMarkerComplete?: (transitionName: string, marker: string, startTime: number, endTime: number) => void;
-}
-interface ReactFiber {
-  tag: WorkTag;
-  key: null | string;
-  elementType: any;
-  type: any;
-  stateNode: any;
-  return: ReactFiber | null;
-  child: ReactFiber | null;
-  sibling: ReactFiber | null;
-  index: number;
-  ref: null | (((handle: unknown) => void) & {
-    _stringRef?: string | null;
-  }) | RefObject;
-  pendingProps: any;
-  memoizedProps: any;
-  updateQueue: unknown;
-  memoizedState: any;
-  dependencies: Dependencies | null;
-  mode: TypeOfMode;
-  flags: Flags;
-  subtreeFlags: Flags;
-  deletions: ReactFiber[] | null;
-  nextEffect: ReactFiber | null;
-  firstEffect: ReactFiber | null;
-  lastEffect: ReactFiber | null;
-  lanes: Lanes;
-  childLanes: Lanes;
-  alternate: ReactFiber | null;
-  actualDuration?: number;
-  actualStartTime?: number;
-  selfBaseDuration?: number;
-  treeBaseDuration?: number;
-  _debugID?: number;
-  _debugSource?: Source | null;
-  _debugOwner?: ReactFiber | null;
-  _debugIsCurrentlyTiming?: boolean;
-  _debugNeedsRemount?: boolean;
-  _debugHookTypes?: HookType[] | null;
-}
-interface ContextDependency<T> {
-  context: ReactContext<T>;
-  memoizedValue: T;
-  next: ContextDependency<unknown> | null;
-  observedBits: number;
-}
-interface Dependencies {
-  firstContext: ContextDependency<unknown> | null;
-  lanes: Lanes;
-}
-interface Effect {
-  [key: string]: unknown;
-  create: (...args: unknown[]) => unknown;
-  deps: null | unknown[];
-  destroy: ((...args: unknown[]) => unknown) | null;
-  next: Effect | null;
-  tag: number;
-}
-interface Family {
-  current: unknown;
-}
-/**
- * React 19 flight metadata for a server component owner (ReactComponentInfo).
- * Unlike client owners it has no `tag`; the owner chain continues via `owner`.
- */
-interface ServerComponentInfo {
-  name?: string;
-  env?: string;
-  owner?: Fiber | ServerComponentInfo | null;
-  debugStack?: Error | null;
-}
-interface RendererRefreshUpdate {
-  staleFamilies: Set<Family>;
-  updatedFamilies: Set<Family>;
-}
-/**
- * Represents a react-internal Fiber node.
- */
-type Fiber<T = any> = Omit<ReactFiber, "alternate" | "child" | "dependencies" | "memoizedProps" | "memoizedState" | "pendingProps" | "return" | "sibling" | "stateNode" | "updateQueue"> & {
-  _debugInfo?: Array<{
-    debugLocation?: unknown;
-    env?: string;
-    name?: string;
-  }>;
-  _debugOwner?: Fiber;
-  _debugSource?: {
-    columnNumber?: number;
-    fileName: string;
-    lineNumber: number;
-  };
-  _debugStack?: Error & {
-    stack: string;
-  };
-  alternate: Fiber | null;
-  child: Fiber | null;
-  dependencies: Dependencies | null;
-  memoizedProps: Props;
-  memoizedState: MemoizedState;
-  pendingProps: Props;
-  return: Fiber | null;
-  sibling: Fiber | null;
-  stateNode: T;
-  updateQueue: {
-    [key: string]: unknown;
-    lastEffect: Effect | null;
-  };
-};
-interface MemoizedState {
-  [key: string]: unknown;
-  memoizedState: unknown;
-  next: MemoizedState | null;
-}
-interface Props {
-  [key: string]: unknown;
-}
-interface ReactDevToolsGlobalHook {
-  _instrumentationIsActive?: boolean;
-  _instrumentationSource?: string;
-  checkDCE: (fn: unknown) => void;
-  hasUnsupportedRendererAttached: boolean;
-  inject: (renderer: ReactRenderer) => number;
-  on: () => void;
-  onCommitFiberRoot: (rendererID: number, root: FiberRoot, priority: number | void) => void;
-  onCommitFiberUnmount: (rendererID: number, fiber: Fiber) => void;
-  onPostCommitFiberRoot: (rendererID: number, root: FiberRoot) => void;
-  onScheduleFiberRoot?: (rendererID: number, root: FiberRoot, children: ReactNode) => void;
-  renderers: Map<number, ReactRenderer>;
-  supportsFiber: boolean;
-  supportsFlight: boolean;
-}
-interface ReactRenderer {
-  bundleType: 0 | 1;
-  currentDispatcherRef: any;
-  findFiberByHostInstance?: (hostInstance: unknown) => Fiber | null;
-  getCurrentFiber?: (fiber: Fiber) => Fiber | null;
-  overrideContext?: (fiber: Fiber, contextType: unknown, path: string[], value: unknown) => void;
-  overrideHookState?: (fiber: Fiber, id: string, path: string[], value: unknown) => void;
-  overrideHookStateDeletePath?: (fiber: Fiber, id: number, path: Array<number | string>) => void;
-  overrideHookStateRenamePath?: (fiber: Fiber, id: number, oldPath: Array<number | string>, newPath: Array<number | string>) => void;
-  overrideProps?: (fiber: Fiber, path: string[], value: unknown) => void;
-  overridePropsDeletePath?: (fiber: Fiber, path: Array<number | string>) => void;
-  overridePropsRenamePath?: (fiber: Fiber, oldPath: Array<number | string>, newPath: Array<number | string>) => void;
-  reconcilerVersion: string;
-  rendererPackageName: string;
-  scheduleRefresh?: (root: FiberRoot, update: RendererRefreshUpdate) => void;
-  scheduleRoot?: (root: FiberRoot, element: React.ReactNode) => void;
-  scheduleUpdate?: (fiber: Fiber) => void;
-  setErrorHandler?: (newShouldErrorImpl: (fiber: Fiber) => boolean) => void;
-  setRefreshHandler?: (handler: ((fiber: Fiber) => Family | null) | null) => void;
-  setSuspenseHandler?: (newShouldSuspendImpl: (suspenseInstance: unknown) => void) => void;
-  version: string;
-}
-declare global {
-  var __REACT_DEVTOOLS_GLOBAL_HOOK__: ReactDevToolsGlobalHook | undefined;
-}
-//#endregion
-//#region src/unsubscribe.d.ts
-interface Unsubscribe extends Disposable {
-  (): void;
-}
-/**
- * Wraps a teardown callback so it is both callable and a `Disposable`,
- * letting subscriptions compose through explicit resource management:
- *
- * @example
- * ```ts
- * using instrumentation = instrument({ onCommitFiberRoot });
- * using refresh = instrumentReactRefresh({ onRefresh: handleRefresh });
- * // both torn down automatically at scope exit
- * ```
- */
-declare const toUnsubscribe: (dispose: () => void) => Unsubscribe;
-//#endregion
-export { ReactRenderer as A, TextSelector as B, React$AbstractComponent as C, ReactPortal as D, ReactDevToolsGlobalHook as E, Selector as F, TransitionTracingCallbacks as H, ServerComponentInfo as I, Source as L, RendererRefreshUpdate as M, RoleSelector as N, ReactProvider as O, RootTag as P, SuspenseHydrationCallbacks as R, Props as S, ReactContext as T, TypeOfMode as U, Thenable as V, WorkTag as W, Lanes as _, ContextDependency as a, OpaqueHandle as b, Effect as c, FiberRoot as d, Flags as f, LanePriority as g, HostConfig as h, ComponentSelector as i, RefObject as j, ReactProviderType as k, Family as l, HookType as m, toUnsubscribe as n, Dependencies as o, HasPseudoClassSelector as p, BundleType as r, DevToolsConfig as s, Unsubscribe as t, Fiber as u, MemoizedState as v, ReactConsumer as w, OpaqueRoot as x, MutableSource as y, TestNameSelector as z };

package/src/react-refresh/constants.ts

@@ -1,9 +0,0 @@
-export const HMR_RECONNECT_DELAY_MS = 1000;
-
-export const PENDING_HOT_UPDATE_MAX_AGE_MS = 10_000;
-
-export const VITE_WS_TOKEN_REGEX = /wsToken = "([^"]+)"/;
-
-export const HMR_SOURCE_FILE_EXTENSION_REGEX = /\.(?:tsx|ts|jsx|js|mjs|cjs|css)$/;
-
-export const BUNDLER_LAYER_PREFIX_REGEX = /^(?:\.\/)?\/?\([a-z][a-z0-9-]*\)\//;

package/src/react-refresh/detect-hmr-transport.ts

@@ -1,33 +0,0 @@
-import { isClientEnvironment } from "../rdt-hook.js";
-
-import { createMetroHmrTransport } from "./metro-hmr-transport.js";
-import { createNextWebpackHmrTransport } from "./next-webpack-hmr-transport.js";
-import { HmrTransport, HmrUpdateHandler } from "./types.js";
-import { createViteHmrTransport } from "./vite-hmr-transport.js";
-
-/**
- * Detects the dev server's HMR transport (Next.js webpack, then Metro for
- * React Native, then Vite) and subscribes `onHmrUpdate` to hot updates.
- * Resolves `null` on the server (SSR) and when no known transport is
- * available (production builds, unsupported bundlers — Turbopack exposes
- * `window.TURBOPACK_CHUNK_UPDATE_LISTENERS` but its update payload shape
- * has not been validated, so it is not wired up yet).
- *
- * @example
- * ```ts
- * const transport = await detectHmrTransport((filePaths) => {
- *   console.log("hot updated:", filePaths);
- * });
- * transport?.dispose();
- * ```
- */
-export const detectHmrTransport = async (
-  onHmrUpdate: HmrUpdateHandler,
-): Promise<HmrTransport | null> => {
-  if (!isClientEnvironment()) return null;
-  const webpackTransport = createNextWebpackHmrTransport(onHmrUpdate);
-  if (webpackTransport) return webpackTransport;
-  const metroTransport = createMetroHmrTransport(onHmrUpdate);
-  if (metroTransport) return metroTransport;
-  return createViteHmrTransport(onHmrUpdate);
-};

package/src/react-refresh/index.ts

@@ -1,173 +0,0 @@
-import { getType, traverseFiber } from "../core.js";
-import { getRDTHook, isClientEnvironment, onRendererInject } from "../rdt-hook.js";
-import type { Fiber, FiberRoot, ReactRenderer } from "../types.js";
-import { toUnsubscribe, type Unsubscribe } from "../unsubscribe.js";
-import { PENDING_HOT_UPDATE_MAX_AGE_MS } from "./constants.js";
-import { detectHmrTransport } from "./detect-hmr-transport.js";
-import { HmrTransport } from "./types.js";
-
-export interface ReactRefreshUpdate {
-  /**
-   * hot-updated source file paths reported by the bundler's HMR transport
-   * (auto-detected: Next.js webpack, Metro, Vite). Best-effort: empty when
-   * the bundler does not expose a transport (e.g. Turbopack) or when the
-   * transport message has not arrived yet (e.g. Metro delivers updates on
-   * an independent socket).
-   */
-  filePaths: string[];
-  root: FiberRoot;
-  /** new component types that were remounted, losing state */
-  staleComponents: unknown[];
-  /** mounted fibers whose component types were remounted */
-  staleFibers: Fiber[];
-  /** new component types that re-rendered preserving state */
-  updatedComponents: unknown[];
-  /** mounted fibers whose component types re-rendered preserving state */
-  updatedFibers: Fiber[];
-}
-
-export interface ReactRefreshHandler {
-  (update: ReactRefreshUpdate): void;
-}
-
-export interface ReactRefreshInstrumentationOptions {
-  onRefresh?: ReactRefreshHandler;
-}
-
-const collectFibersByComponentType = (root: FiberRoot, componentTypes: Set<unknown>): Fiber[] => {
-  if (componentTypes.size === 0 || !root.current) return [];
-  const matchedFibers: Fiber[] = [];
-  traverseFiber(root.current, (fiber) => {
-    // memo/forwardRef fibers carry the wrapper as fiber.type, while the
-    // refresh families can register either the wrapper or the inner type
-    if (componentTypes.has(fiber.type) || componentTypes.has(getType(fiber.type))) {
-      matchedFibers.push(fiber);
-    }
-  });
-  return matchedFibers;
-};
-
-const refreshHandlers = new Set<ReactRefreshHandler>();
-const refreshWrappedRenderers = new WeakSet<ReactRenderer>();
-
-let pendingFilePaths: string[] = [];
-let pendingFilePathsReceivedAtMs = 0;
-
-const bufferHotUpdateFilePaths = (filePaths: string[]): void => {
-  const nowMs = Date.now();
-  if (nowMs - pendingFilePathsReceivedAtMs > PENDING_HOT_UPDATE_MAX_AGE_MS) {
-    pendingFilePaths = [];
-  }
-  pendingFilePaths.push(...filePaths);
-  pendingFilePathsReceivedAtMs = nowMs;
-};
-
-const takeFreshFilePaths = (): string[] => {
-  if (Date.now() - pendingFilePathsReceivedAtMs > PENDING_HOT_UPDATE_MAX_AGE_MS) return [];
-  const freshFilePaths = [...pendingFilePaths];
-  // performReactRefresh calls scheduleRefresh synchronously once per
-  // mounted root, so clear the pending paths only after the whole
-  // refresh pass instead of on the first root
-  queueMicrotask(() => {
-    pendingFilePaths = [];
-  });
-  return freshFilePaths;
-};
-
-const wrapRendererScheduleRefresh = (renderer: ReactRenderer): void => {
-  if (refreshWrappedRenderers.has(renderer)) return;
-  const originalScheduleRefresh = renderer.scheduleRefresh;
-  if (typeof originalScheduleRefresh !== "function") return;
-  refreshWrappedRenderers.add(renderer);
-  renderer.scheduleRefresh = (root, update) => {
-    originalScheduleRefresh.call(renderer, root, update);
-    if (refreshHandlers.size === 0) return;
-    const staleComponents = Array.from(update.staleFamilies, (family) => family.current);
-    const updatedComponents = Array.from(update.updatedFamilies, (family) => family.current);
-    const refreshUpdate: ReactRefreshUpdate = {
-      filePaths: takeFreshFilePaths(),
-      root,
-      staleComponents,
-      staleFibers: collectFibersByComponentType(root, new Set(staleComponents)),
-      updatedComponents,
-      updatedFibers: collectFibersByComponentType(root, new Set(updatedComponents)),
-    };
-    for (const handler of refreshHandlers) {
-      handler(refreshUpdate);
-    }
-  };
-};
-
-let isRefreshWired = false;
-
-const ensureRefreshWired = (): void => {
-  if (isRefreshWired) return;
-  isRefreshWired = true;
-  const rdtHook = getRDTHook();
-  for (const renderer of rdtHook.renderers.values()) {
-    wrapRendererScheduleRefresh(renderer);
-  }
-  onRendererInject(wrapRendererScheduleRefresh);
-};
-
-let activeTransport: HmrTransport | null = null;
-
-// the bundler's HMR global may not exist yet when an early subscriber
-// arrives, so detection is retried whenever the first subscriber (re)appears
-const detectTransportForNewSubscriber = (): void => {
-  void detectHmrTransport(bufferHotUpdateFilePaths).then((detectedTransport) => {
-    if (!detectedTransport) return;
-    activeTransport?.dispose();
-    activeTransport = detectedTransport;
-  });
-};
-
-/**
- * Subscribes to react-refresh (fast refresh) updates by wrapping
- * `scheduleRefresh` on every renderer injected into the React DevTools
- * global hook. The react-refresh runtime calls `scheduleRefresh` after each
- * hot update, so this works with any bundler that uses react-refresh (Vite,
- * Next.js webpack, Next.js Turbopack, Metro) without bundler-specific code.
- * Returns an unsubscribe function (a no-op in non-client environments like
- * SSR, so callers never need an environment check). The returned function
- * is also a `Disposable`, so it composes with other bippy subscriptions
- * through `using`.
- *
- * The bundler's HMR transport is auto-detected and each refresh update is
- * augmented with the hot-updated source file paths it reported.
- *
- * The handler runs after React has re-rendered with the new component
- * types, so the refreshed root's fiber tree already carries them;
- * `updatedFibers`/`staleFibers` are the mounted fibers matching the
- * hot-swapped component types.
- *
- * @example
- * ```ts
- * const unsubscribe = instrumentReactRefresh({
- *   onRefresh(update) {
- *     for (const fiber of update.updatedFibers) {
- *       console.log("hot updated:", getDisplayName(fiber.type));
- *     }
- *     console.log("changed files:", update.filePaths);
- *   },
- * });
- * unsubscribe();
- * ```
- *
- * Pair with `getSource(fiber)` from `bippy/source` to symbolicate the
- * source locations of `updatedFibers` when needed.
- */
-export const instrumentReactRefresh = (
-  options: ReactRefreshInstrumentationOptions,
-): Unsubscribe => {
-  const { onRefresh } = options;
-  if (!onRefresh || !isClientEnvironment()) return toUnsubscribe(() => {});
-  ensureRefreshWired();
-  if (refreshHandlers.size === 0) {
-    detectTransportForNewSubscriber();
-  }
-  refreshHandlers.add(onRefresh);
-  return toUnsubscribe(() => {
-    refreshHandlers.delete(onRefresh);
-  });
-};