@atlassian/chippy 0.0.1-beta.1 → 0.0.1-beta.2

package/lib/types/chippy-bridge/react-renderer.d.ts

@@ -14,9 +14,8 @@
  * without duplicating the iteration (and its Map/entries quirks).
  */
 export type ReactRenderer = {
-    currentDispatcherRef?: {
-        current: unknown;
-    } | null;
+    /** `{ current }` on React <=18; `ReactSharedInternals` (`H`) on React 19. */
+    currentDispatcherRef?: Record<string, unknown> | null;
     scheduleUpdate?: (fiber: unknown) => void;
     version?: string;
     rendererPackageName?: string;
@@ -34,8 +33,34 @@ export type DevtoolsHookLike = {
  */
 export declare function getReactRenderers(scope?: typeof globalThis): ReactRenderer[];
 /**
- * First renderer that exposes a usable `currentDispatcherRef`. Used by
- * debug-render to patch the hook dispatcher.
+ * The writable property that holds React's active hooks dispatcher.
+ *
+ * React <=18 injects `ReactCurrentDispatcher`, whose dispatcher lives at
+ * `current`. React 19 injects `ReactSharedInternals`, whose dispatcher lives
+ * at `H` (`current` does not exist there). React DevTools makes the same
+ * distinction in its own `getDispatcherRef`.
+ */
+export type DispatcherSlot = {
+    owner: Record<string, unknown>;
+    key: 'current' | 'H';
+};
+export declare function dispatcherSlotOf(injected: unknown): DispatcherSlot | null;
+/**
+ * First renderer that exposes a usable dispatcher slot. Used by debug-render
+ * when it must trap writes to the exact property React assigns.
+ */
+export declare function getDispatcherSlot(scope?: typeof globalThis): DispatcherSlot | null;
+/**
+ * Normalize a slot to a `{ current }` ref. A legacy ref is returned as-is; a
+ * React 19 internals object gets one stable accessor view that reads and
+ * writes `H`.
+ */
+export declare function dispatcherRefOf(slot: DispatcherSlot): {
+    current: unknown;
+};
+/**
+ * First renderer's hooks dispatcher as a `{ current }` ref, across React
+ * versions. Used by debug replay to swap in its stub dispatcher.
  */
 export declare function getDispatcherRef(scope?: typeof globalThis): {
     current: unknown;

package/lib/types/chippy-bridge/recorded-source.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Correct React <=18 `_debugSource` lines through the served module.
+ *
+ * The JSX transform records `lineNumber`/`columnNumber` from the code it
+ * receives. When an earlier transform adds lines first, the recorded position
+ * points into that intermediate code rather than the authored file. For
+ * example, `@vitejs/plugin-react` adds a Fast Refresh header before esbuild
+ * compiles JSX, which shifts every recorded line in the module.
+ *
+ * The served module still contains the recorded literal, and its source map
+ * maps that literal to the JSX element in the authored file. This module finds
+ * the literal and the URLs that may serve the recorded file; the call-site
+ * resolver in fiber-source.ts fetches the module and applies the map.
+ */
+export type RecordedSource = {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number | null;
+};
+export type ServedPosition = {
+    line: number;
+    column: number;
+};
+export type PageModules = {
+    origin: string;
+    /** Script and module URLs the page loaded, oldest first. */
+    resourceUrls: readonly string[];
+    /** Vite serves any allowed file from `/@fs/<absolute path>`. */
+    vite: boolean;
+};
+/**
+ * The position of the single debug literal for `source` in served code, or
+ * null when the literal is missing or appears more than once.
+ */
+export declare function recordedLiteralPosition(code: string, source: RecordedSource): ServedPosition | null;
+/**
+ * Same-origin URLs that may serve `fileName`, best match first: loaded modules
+ * whose path ends the recorded file path, newest first, then Vite's `/@fs`
+ * URL when the page runs on Vite.
+ */
+export declare function servedModuleUrls(fileName: string, page: PageModules): string[];
+/** Candidate module URLs for a recorded file on the current page. */
+export declare function pageModuleUrls(fileName: string): string[];
+export declare function baseName(path: string): string;

package/lib/types/debug-render/core.d.ts

@@ -66,6 +66,12 @@ export declare function parseStackFrames(stack: string): StackFrame[];
 type DispatcherRef = {
     current: unknown;
 };
+/**
+ * True for a hook frame, including qualified names. React 19's CommonJS build
+ * defines `exports.useState = function (...) {}`, which V8 names
+ * `exports.useState`; bundlers can produce similar `ns.useX` names.
+ */
+export declare function isHookFrameName(name: string): boolean;
 export declare function createDebugRender(options?: {
     maxEventsPerComponent?: number;
 }): DebugRenderModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlassian/chippy",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.2",
   "description": "React runtime inspection and Avalanche commit evidence",
   "license": "Apache-2.0",
   "repository": {
@@ -96,7 +96,9 @@
     "jsdom": "^26.1.0",
     "playwright": "^1.64.1",
     "react": "^18.3.1",
+    "react-19": "npm:react@19.2.0",
     "react-dom": "^18.3.1",
+    "react-dom-19": "npm:react-dom@19.2.0",
     "storybook": "^10.3.3",
     "typescript": "^5.9.3",
     "vite": "^6.4.1",