@descryy/runtime-identity-grounding 0.2.0

package/dist/graph-join.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The join to `descry-core`'s graph — as a **hand-off**, not a second
+ * resolver.
+ *
+ * `@descryy/runtime-graph-correlator`'s `resolveSymbolNode` already does the
+ * whole job of turning `{ file, symbolName, line }` into a `FUNCTION`/
+ * `CLASS` node, and everything hard about that job is in the parts this
+ * function must not duplicate: refusing ambiguity instead of ranking
+ * candidates, checking the claimed line against the node's own range and
+ * reporting `line-mismatch` distinctly, translating between the absolute /
+ * repo-relative / relative-to-launch-cwd path languages, and requiring
+ * `repo` because `FUNCTION` is repo-scoped and there is no honest default.
+ * A copy of any of that here would be a copy that drifts.
+ *
+ * So this function's entire contract is: hand `resolveSymbolNode` exactly
+ * the input it asks for, or hand it nothing.
+ *
+ * ## No new node type, no new edge type
+ *
+ * The component resolves to a `FUNCTION` or `CLASS` node that an adapter
+ * already produced — `descry-core`'s frozen 15 node types and 15 edge types
+ * are untouched. There is no `COMPONENT_INSTANCE`, no `RENDERS` edge, and
+ * nothing here asks for one. (`COMPONENT` is already one of the 15, and a
+ * React component that an adapter emitted as one is found by the same
+ * name+file lookup.)
+ *
+ * ## Why a compiled location is withheld rather than passed through
+ *
+ * `resolveSymbolNode` would take a bundle path quite happily and report
+ * `not-found` for it, which reads to a consumer as *"that component is not
+ * in the graph"* — the exact misleading refusal `symbol.ts`'s own header
+ * describes and fixed for absolute paths. A React 19 answer with
+ * `authoredSource: false` names `dist/dev.js`, a file no adapter ever
+ * indexed and never will. Withholding it keeps the honest statement —
+ * *"we know the component, we could not reach authored source"* — inside
+ * `ElementIdentity`, where the capability status explains it, instead of
+ * laundering it into a graph miss.
+ */
+import type { ElementIdentity } from "./element-identity.ts";
+/**
+ * Structurally `resolveSymbolNode`'s own `location` parameter. Deliberately
+ * declared with `line` optional rather than nullable, because that is the
+ * shape that function accepts; `graph-join.test.ts` asserts the
+ * compatibility against the real signature at compile time, so a change on
+ * either side breaks the build rather than being discovered at runtime.
+ */
+export interface GraphSymbolLocation {
+    readonly file: string;
+    readonly symbolName: string;
+    readonly line?: number;
+}
+/**
+ * The graph lookup this identity supports, or `null` when it supports none.
+ *
+ * `null` for every outcome except a `grounded` one that reached authored
+ * source with a real file — including `component-only`, which knows the
+ * component's name and nothing about where it lives, and including a
+ * `grounded` answer whose location is compiled output.
+ */
+export declare function symbolLocationForGraph(identity: ElementIdentity): GraphSymbolLocation | null;
+//# sourceMappingURL=graph-join.d.ts.map

package/dist/graph-join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-join.d.ts","sourceRoot":"","sources":["../src/graph-join.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,GAAG,IAAI,CAU5F"}

package/dist/graph-join.js

@@ -0,0 +1,59 @@
+/**
+ * The join to `descry-core`'s graph — as a **hand-off**, not a second
+ * resolver.
+ *
+ * `@descryy/runtime-graph-correlator`'s `resolveSymbolNode` already does the
+ * whole job of turning `{ file, symbolName, line }` into a `FUNCTION`/
+ * `CLASS` node, and everything hard about that job is in the parts this
+ * function must not duplicate: refusing ambiguity instead of ranking
+ * candidates, checking the claimed line against the node's own range and
+ * reporting `line-mismatch` distinctly, translating between the absolute /
+ * repo-relative / relative-to-launch-cwd path languages, and requiring
+ * `repo` because `FUNCTION` is repo-scoped and there is no honest default.
+ * A copy of any of that here would be a copy that drifts.
+ *
+ * So this function's entire contract is: hand `resolveSymbolNode` exactly
+ * the input it asks for, or hand it nothing.
+ *
+ * ## No new node type, no new edge type
+ *
+ * The component resolves to a `FUNCTION` or `CLASS` node that an adapter
+ * already produced — `descry-core`'s frozen 15 node types and 15 edge types
+ * are untouched. There is no `COMPONENT_INSTANCE`, no `RENDERS` edge, and
+ * nothing here asks for one. (`COMPONENT` is already one of the 15, and a
+ * React component that an adapter emitted as one is found by the same
+ * name+file lookup.)
+ *
+ * ## Why a compiled location is withheld rather than passed through
+ *
+ * `resolveSymbolNode` would take a bundle path quite happily and report
+ * `not-found` for it, which reads to a consumer as *"that component is not
+ * in the graph"* — the exact misleading refusal `symbol.ts`'s own header
+ * describes and fixed for absolute paths. A React 19 answer with
+ * `authoredSource: false` names `dist/dev.js`, a file no adapter ever
+ * indexed and never will. Withholding it keeps the honest statement —
+ * *"we know the component, we could not reach authored source"* — inside
+ * `ElementIdentity`, where the capability status explains it, instead of
+ * laundering it into a graph miss.
+ */
+/**
+ * The graph lookup this identity supports, or `null` when it supports none.
+ *
+ * `null` for every outcome except a `grounded` one that reached authored
+ * source with a real file — including `component-only`, which knows the
+ * component's name and nothing about where it lives, and including a
+ * `grounded` answer whose location is compiled output.
+ */
+export function symbolLocationForGraph(identity) {
+    if (identity.outcome !== "grounded")
+        return null;
+    if (!identity.authoredSource)
+        return null;
+    const { file, line } = identity.sourceLocation;
+    if (file === null)
+        return null;
+    return line === null
+        ? { file, symbolName: identity.component.name }
+        : { file, symbolName: identity.component.name, line };
+}
+//# sourceMappingURL=graph-join.js.map

package/dist/graph-join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-join.js","sourceRoot":"","sources":["../src/graph-join.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAiBH;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAC9D,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE/B,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC"}

package/dist/identity-grounder.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The composed, page-driving surface — install once, then ask about a
+ * selector.
+ *
+ * Everything hard here is a composition of parts this repo already owns,
+ * deliberately:
+ *
+ * | step | owner |
+ * | --- | --- |
+ * | inject into the page | `page.addInitScript`, the seam `frontend-initiator-capture.ts` established |
+ * | read the fiber | `fiber-probe.ts` (this package) |
+ * | browser URL to on-disk path | `rewriteScriptUrls` (`@descryy/runtime-browser`) |
+ * | parse a V8 stack | `createV8StackTraceParser` (`@descryy/runtime-adapter-typescript`) |
+ * | source map, staleness, `reliability` | `createNodeSourceLocationResolver` (same) |
+ * | decide what may be claimed | `identity-grounding.ts` (this package) |
+ *
+ * The only genuinely new machinery in this package is the fiber read and
+ * the decision table. A second source-map resolver, a second stack parser
+ * or a second URL-rewriting rule here would each be a copy that holds in
+ * one place — this repo has measured that drift and says so in
+ * `graph-correlator/src/symbol.ts` and `fixture-apps/roots.ts` alike.
+ *
+ * ## `resolveSourceRoot` is what makes the React 19 path work at all
+ *
+ * A React 19 owner stack names the bundle by its **browser URL**
+ * (`http://127.0.0.1:41369/dev.js:21714:62`). `createNodeSourceLocation-
+ * Resolver` resolves source maps from **disk**. `resolveSourceRoot` is the
+ * existing bridge between those two coordinate systems
+ * (`CollectorContext.resolveSourceRoot`, RT-023/RT-029), and without one
+ * the React 19 path degrades honestly: the stack still parses, the frame
+ * still names a position, and the answer comes back with
+ * `authoredSource: false` and a `degraded` capability rather than a
+ * fabricated authored file. React 18 needs none of this — its location is
+ * already authored, on the fiber.
+ */
+import type { SourceRootResolver } from "@descryy/runtime-contracts";
+import type { Page } from "playwright-core";
+import type { ElementIdentity } from "./element-identity.ts";
+export interface IdentityGrounderOptions {
+    /**
+     * Joins a browser origin to the on-disk directory it is served from, so a
+     * React 19 owner stack's compiled frames can be mapped back to authored
+     * source. Absent is a supported configuration, not a misconfiguration —
+     * see this module's header.
+     */
+    readonly resolveSourceRoot?: SourceRootResolver;
+}
+export interface IdentityGrounder {
+    /**
+     * Installs the page-side reader into every document this page loads from
+     * this point forward. **Call before navigating** — `page.addInitScript`
+     * does not reach a document that is already loaded, and a page navigated
+     * first reports `probe-not-installed` by name.
+     */
+    install(page: Page): Promise<void>;
+    /** Resolves one on-screen element to the component that produced it, and to that component's file and line where those can be established. Never throws for a routine unavailability; refuses by name instead. */
+    ground(page: Page, selector: string): Promise<ElementIdentity>;
+}
+export declare function createIdentityGrounder(options?: IdentityGrounderOptions): IdentityGrounder;
+//# sourceMappingURL=identity-grounder.d.ts.map

package/dist/identity-grounder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-grounder.d.ts","sourceRoot":"","sources":["../src/identity-grounder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,4BAA4B,CAAC;AAGjF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kNAAkN;IAClN,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAyB9F"}

package/dist/identity-grounder.js

@@ -0,0 +1,64 @@
+/**
+ * The composed, page-driving surface — install once, then ask about a
+ * selector.
+ *
+ * Everything hard here is a composition of parts this repo already owns,
+ * deliberately:
+ *
+ * | step | owner |
+ * | --- | --- |
+ * | inject into the page | `page.addInitScript`, the seam `frontend-initiator-capture.ts` established |
+ * | read the fiber | `fiber-probe.ts` (this package) |
+ * | browser URL to on-disk path | `rewriteScriptUrls` (`@descryy/runtime-browser`) |
+ * | parse a V8 stack | `createV8StackTraceParser` (`@descryy/runtime-adapter-typescript`) |
+ * | source map, staleness, `reliability` | `createNodeSourceLocationResolver` (same) |
+ * | decide what may be claimed | `identity-grounding.ts` (this package) |
+ *
+ * The only genuinely new machinery in this package is the fiber read and
+ * the decision table. A second source-map resolver, a second stack parser
+ * or a second URL-rewriting rule here would each be a copy that holds in
+ * one place — this repo has measured that drift and says so in
+ * `graph-correlator/src/symbol.ts` and `fixture-apps/roots.ts` alike.
+ *
+ * ## `resolveSourceRoot` is what makes the React 19 path work at all
+ *
+ * A React 19 owner stack names the bundle by its **browser URL**
+ * (`http://127.0.0.1:41369/dev.js:21714:62`). `createNodeSourceLocation-
+ * Resolver` resolves source maps from **disk**. `resolveSourceRoot` is the
+ * existing bridge between those two coordinate systems
+ * (`CollectorContext.resolveSourceRoot`, RT-023/RT-029), and without one
+ * the React 19 path degrades honestly: the stack still parses, the frame
+ * still names a position, and the answer comes back with
+ * `authoredSource: false` and a `degraded` capability rather than a
+ * fabricated authored file. React 18 needs none of this — its location is
+ * already authored, on the fiber.
+ */
+import { rewriteScriptUrls } from "@descryy/runtime-browser";
+import { createNodeSourceLocationResolver, createV8StackTraceParser } from "@descryy/runtime-adapter-typescript";
+import { createIdentityGroundingProbe } from "./fiber-probe.js";
+import { groundFromProbe } from "./identity-grounding.js";
+export function createIdentityGrounder(options = {}) {
+    const probe = createIdentityGroundingProbe();
+    const parser = createV8StackTraceParser(createNodeSourceLocationResolver());
+    const resolveOwnerStack = (rawStackText) => {
+        // Rewritten before parsing, not after -- `script-url-mapping.ts`'s own
+        // reasoning, reused rather than re-argued: the parser and its resolver
+        // already know how to turn `at f (/abs/path.js:12:5)` into a resolved
+        // location, and rewriting the text first lets all of that apply
+        // unchanged. An unmapped URL is left exactly as the browser reported
+        // it, which then resolves as a compiled location rather than a
+        // fabricated file.
+        const rewritten = rewriteScriptUrls(rawStackText, options.resolveSourceRoot);
+        return parser.parse(rewritten.text);
+    };
+    return {
+        install(page) {
+            return probe.install(page);
+        },
+        async ground(page, selector) {
+            const raw = await probe.probe(page, selector);
+            return groundFromProbe(raw, selector, resolveOwnerStack);
+        },
+    };
+}
+//# sourceMappingURL=identity-grounder.js.map

package/dist/identity-grounder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-grounder.js","sourceRoot":"","sources":["../src/identity-grounder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gCAAgC,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAIjH,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,eAAe,EAA2B,MAAM,yBAAyB,CAAC;AAwBnF,MAAM,UAAU,sBAAsB,CAAC,UAAmC,EAAE;IAC1E,MAAM,KAAK,GAAG,4BAA4B,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,wBAAwB,CAAC,gCAAgC,EAAE,CAAC,CAAC;IAE5E,MAAM,iBAAiB,GAAuB,CAAC,YAAoB,EAA8B,EAAE;QACjG,uEAAuE;QACvE,uEAAuE;QACvE,sEAAsE;QACtE,gEAAgE;QAChE,qEAAqE;QACrE,+DAA+D;QAC/D,mBAAmB;QACnB,MAAM,SAAS,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO;QACL,OAAO,CAAC,IAAU;YAChB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAU,EAAE,QAAgB;YACvC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/identity-grounding.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The decision layer: raw fiber facts in, one `ElementIdentity` out.
+ *
+ * Pure with respect to the browser — it never touches a `Page`. Everything
+ * it needs from the page arrives as a `RawFiberProbe`, and the one piece of
+ * machinery it cannot own (turning a React 19 owner stack into a resolved
+ * `StackTrace`, which needs source-map resolution and filesystem access) is
+ * injected as `OwnerStackResolver`. That split is what lets every refusal
+ * branch below be exercised as a plain unit test, with no Chromium and no
+ * fixture app, while the fixture apps prove the two mechanisms end to end.
+ *
+ * ## What this cannot do, stated once, in the place that decides it
+ *
+ * - **A production React build.** No `_debug*` field survives, and the
+ *   component name on the fiber is minified. Refused by name
+ *   (`react-debug-fields-absent`); see that value's own documentation.
+ * - **Anything that is not React.** No fiber key, no answer. There is no
+ *   Vue/Svelte/Angular/Solid path here — not a gap in this module, a scope
+ *   boundary, and the refusal says "not React" rather than "unknown".
+ * - **A React 19 bundle with no source map.** The owner stack still names a
+ *   real position, in compiled output. Reported with
+ *   `authoredSource: false` and a `degraded` capability, never dressed up
+ *   as the file a developer wrote.
+ * - **An anonymous component.** Refused: there is no symbol for
+ *   `resolveSymbolNode` to look up and no name for a reader to act on.
+ *
+ * ## Owner versus renderer
+ *
+ * `component` is read from `_debugOwner` — the component whose render
+ * *created* this element — because that is the component the source
+ * location belongs to. `renderedBy` is the nearest component in the fiber
+ * `return` chain, which is where the element ended up. They differ whenever
+ * an element is created in one component and passed to another as
+ * `children`; the fixture app renders that case deliberately. Both are
+ * reported and neither is reconciled into the other.
+ */
+import { type StackTrace } from "@descryy/runtime-contracts";
+import { type ElementIdentity } from "./element-identity.ts";
+import type { RawFiberProbe } from "./fiber-probe.ts";
+/**
+ * Turns React 19's raw `_debugStack` text into a resolved `StackTrace`, or
+ * `null` when the text is not a V8 stack at all.
+ *
+ * Injected rather than constructed here because the real implementation is
+ * a composition of three things this repo already owns and this package
+ * must not re-own: `@descryy/runtime-browser`'s `rewriteScriptUrls` (browser
+ * URL to on-disk path), and `@descryy/runtime-adapter-typescript`'s
+ * `createV8StackTraceParser` plus `createNodeSourceLocationResolver`
+ * (parsing, source-map resolution and the `reliability` classification —
+ * including staleness detection). `identity-grounder.ts` wires them.
+ */
+export type OwnerStackResolver = (rawStackText: string) => Promise<StackTrace | null>;
+export declare function groundFromProbe(probe: RawFiberProbe, selector: string, resolveOwnerStack: OwnerStackResolver | null): Promise<ElementIdentity>;
+//# sourceMappingURL=identity-grounding.d.ts.map

package/dist/identity-grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-grounding.d.ts","sourceRoot":"","sources":["../src/identity-grounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExG,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAA0B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9E;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAOtF,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,kBAAkB,GAAG,IAAI,GAC3C,OAAO,CAAC,eAAe,CAAC,CA4N1B"}

package/dist/identity-grounding.js

@@ -0,0 +1,238 @@
+/**
+ * The decision layer: raw fiber facts in, one `ElementIdentity` out.
+ *
+ * Pure with respect to the browser — it never touches a `Page`. Everything
+ * it needs from the page arrives as a `RawFiberProbe`, and the one piece of
+ * machinery it cannot own (turning a React 19 owner stack into a resolved
+ * `StackTrace`, which needs source-map resolution and filesystem access) is
+ * injected as `OwnerStackResolver`. That split is what lets every refusal
+ * branch below be exercised as a plain unit test, with no Chromium and no
+ * fixture app, while the fixture apps prove the two mechanisms end to end.
+ *
+ * ## What this cannot do, stated once, in the place that decides it
+ *
+ * - **A production React build.** No `_debug*` field survives, and the
+ *   component name on the fiber is minified. Refused by name
+ *   (`react-debug-fields-absent`); see that value's own documentation.
+ * - **Anything that is not React.** No fiber key, no answer. There is no
+ *   Vue/Svelte/Angular/Solid path here — not a gap in this module, a scope
+ *   boundary, and the refusal says "not React" rather than "unknown".
+ * - **A React 19 bundle with no source map.** The owner stack still names a
+ *   real position, in compiled output. Reported with
+ *   `authoredSource: false` and a `degraded` capability, never dressed up
+ *   as the file a developer wrote.
+ * - **An anonymous component.** Refused: there is no symbol for
+ *   `resolveSymbolNode` to look up and no name for a reader to act on.
+ *
+ * ## Owner versus renderer
+ *
+ * `component` is read from `_debugOwner` — the component whose render
+ * *created* this element — because that is the component the source
+ * location belongs to. `renderedBy` is the nearest component in the fiber
+ * `return` chain, which is where the element ended up. They differ whenever
+ * an element is created in one component and passed to another as
+ * `children`; the fixture app renders that case deliberately. Both are
+ * reported and neither is reconciled into the other.
+ */
+import { locationNamesNothing } from "@descryy/runtime-contracts";
+import { capabilityFor, } from "./element-identity.js";
+import { selectOwnerFrame } from "./owner-stack.js";
+function resolvedComponent(raw) {
+    if (raw === null || raw.name === null || raw.nameSource === null)
+        return null;
+    return { name: raw.name, nameSource: raw.nameSource, kind: raw.kind };
+}
+export async function groundFromProbe(probe, selector, resolveOwnerStack) {
+    if (probe.status === "probe-not-installed") {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: 0,
+            refusal: "probe-not-installed",
+            observedTypeName: null,
+            reason: "the identity-grounding reader is not present in this document. `page.addInitScript` only affects " +
+                "documents loaded after it is registered, so `install()` must be called before navigating — exactly as " +
+                "every collector in @descryy/runtime-browser already requires. Reported as its own refusal rather than " +
+                "as \"not React\", which is what a caller would otherwise conclude about a perfectly ordinary React page.",
+            capability: capabilityFor("unavailable", "the page-side reader was never installed in this document; nothing was inspected."),
+        };
+    }
+    if (probe.status === "element-not-found") {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: 0,
+            refusal: "element-not-found",
+            observedTypeName: null,
+            reason: `no element matched "${selector}" in the page's current document.`,
+            capability: capabilityFor("unavailable", "the selector matched no element; there was nothing to ground."),
+        };
+    }
+    if (probe.status === "no-fiber") {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: 0,
+            refusal: "not-react",
+            observedTypeName: null,
+            reason: `neither the element matched by "${selector}" nor any of its ancestors carries a React fiber key ` +
+                `(${probe.ownKeys.length === 0 ? "the element has no own enumerable keys at all" : `own keys: ${probe.ownKeys.join(", ")}`}). ` +
+                "This page's DOM was not produced by React, or not by a React that tags host nodes. Identity grounding is " +
+                "React-only; there is no Vue, Svelte, Angular or Solid equivalent in this package, which is a scope " +
+                "boundary and not a temporary gap.",
+            capability: capabilityFor("unavailable", "no React fiber on the element or any ancestor — not a React tree."),
+        };
+    }
+    const { fiberDistance } = probe;
+    if (probe.debugFields.length === 0) {
+        // The queried node is usually a *host* fiber whose `type` is the tag
+        // name string ("button"), so the minified identifier a reader wants to
+        // see lives on the nearest component above it, not here. Both are
+        // consulted, in that order, and the result is still not a component
+        // name -- see `ElementIdentityRefused.observedTypeName`.
+        const observedTypeName = probe.observedTypeName ?? probe.returnChainComponent?.name ?? probe.owner?.name ?? null;
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance,
+            refusal: "react-debug-fields-absent",
+            observedTypeName,
+            reason: "a React fiber was found and it carries no `_debug*` field of any kind. React strips `_debugSource`, " +
+                "`_debugOwner` and `_debugStack` from fibers outside a development build, so this is a production React " +
+                "build (overwhelmingly the common reading) or a React version that no longer exposes them in development " +
+                "either. Two things are lost, not one: there is no source location to recover, AND a production bundle is " +
+                "minified, so the fiber's own `type.name` " +
+                (observedTypeName === null ? "(absent here)" : `("${observedTypeName}")`) +
+                " is whatever the minifier left behind rather than the authored component name. Reporting that name as " +
+                "the component would be a confident wrong answer; refused instead.",
+            capability: capabilityFor("unavailable", "React development-build debug fields are absent (production build): no source location exists to " +
+                "recover, and the component name on the fiber is minified rather than authored."),
+        };
+    }
+    const owner = resolvedComponent(probe.owner);
+    const returnChain = resolvedComponent(probe.returnChainComponent);
+    const component = owner ?? returnChain;
+    const componentSource = owner !== null ? "debug-owner" : "return-chain";
+    if (component === null) {
+        const sawSomething = probe.owner !== null || probe.returnChainComponent !== null;
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance,
+            refusal: sawSomething ? "anonymous-component" : "no-component-fiber",
+            observedTypeName: probe.observedTypeName,
+            reason: sawSomething
+                ? "a component fiber was found and it has no resolvable name — an anonymous function or arrow with no " +
+                    "`displayName`. Refused rather than reported as a nameless component: there is no symbol for " +
+                    "`resolveSymbolNode` to look up and no name a reader could act on."
+                : "the fiber has no `_debugOwner` and no nameable component anywhere in its `return` chain, so no " +
+                    "component produced this element in a way this can name — an element rendered directly by the root, or " +
+                    "one whose whole ancestry is host elements, fragments and context providers.",
+            capability: capabilityFor("unavailable", sawSomething ? "the owning component is anonymous." : "no component fiber above this element."),
+        };
+    }
+    const renderedBy = returnChain;
+    // ---- React 18 and earlier: the authored location is on the fiber. ----
+    const debugSource = probe.debugSource;
+    if (debugSource !== null && debugSource.fileName !== null) {
+        const sourceLocation = {
+            file: debugSource.fileName,
+            line: debugSource.lineNumber,
+            column: debugSource.columnNumber,
+            functionName: component.name,
+            // The application's own recorded creation site, not a translation
+            // through a side artifact -- the same class `node-source-location-
+            // resolver.ts` gives a frame with no `sourceMappingURL`: nothing was
+            // lost, this IS the accurate answer.
+            reliability: "self-contained",
+            resolvedVia: null,
+        };
+        return {
+            outcome: "grounded",
+            selector,
+            fiberDistance,
+            component,
+            componentSource,
+            renderedBy,
+            sourceLocation,
+            authoredSource: true,
+            mechanism: "react-debug-source",
+            capability: debugSource.lineNumber === null
+                ? capabilityFor("degraded", "`_debugSource` named the authored file but carried no line number, so the answer is file-level " +
+                    "rather than line-level.")
+                : capabilityFor("available"),
+        };
+    }
+    // ---- React 19: an owner stack in compiled coordinates. ----
+    const stackText = probe.debugStackText;
+    if (stackText !== null) {
+        if (resolveOwnerStack === null) {
+            return componentOnly(selector, fiberDistance, component, componentSource, renderedBy, "this fiber carries a React 19 owner stack (`_debugStack`) and no owner-stack resolver is configured, so " +
+                "its compiled frames cannot be mapped back to authored source. The component is named; its file and " +
+                "line are not.");
+        }
+        const stack = await resolveOwnerStack(stackText);
+        if (stack === null) {
+            return componentOnly(selector, fiberDistance, component, componentSource, renderedBy, "this fiber carries a React 19 owner stack, and the stack parser did not recognise its text as a V8 " +
+                "stack at all. Refused rather than parsed best-effort, per the parser's own contract.");
+        }
+        const selection = selectOwnerFrame(stack);
+        if (!selection.ok) {
+            return componentOnly(selector, fiberDistance, component, componentSource, renderedBy, selection.reason);
+        }
+        const frameLocation = stack.frames[selection.index]?.location ?? null;
+        if (frameLocation === null || locationNamesNothing(frameLocation)) {
+            return componentOnly(selector, fiberDistance, component, componentSource, renderedBy, "the owner stack's application call site resolved to a location that names no file, line or function — " +
+                "so there is a frame, and nothing in it to report as a source location.");
+        }
+        const reliability = frameLocation.reliability;
+        const authoredSource = reliability === "side-artifact-resolved" || reliability === "side-artifact-stale";
+        return {
+            outcome: "grounded",
+            selector,
+            fiberDistance,
+            component,
+            componentSource,
+            renderedBy,
+            sourceLocation: frameLocation,
+            authoredSource,
+            mechanism: "react-owner-stack",
+            capability: ownerStackCapability(frameLocation),
+        };
+    }
+    return componentOnly(selector, fiberDistance, component, componentSource, renderedBy, "this fiber carries React development-build debug fields " +
+        `(${probe.debugFields.join(", ")}) but neither \`_debugSource\` nor \`_debugStack\` — the application was ` +
+        "built without the JSX transform's source annotation (React 18 and earlier), so React itself never recorded " +
+        "where this element was written. The component is named; its file and line are not.");
+}
+function ownerStackCapability(location) {
+    if (location.reliability === "side-artifact-stale") {
+        return capabilityFor("degraded", `the owner stack mapped through "${location.resolvedVia ?? "a source map"}", and that map's embedded ` +
+            "`sourcesContent` does not match the file now on disk — the file and line are the map's, and the map is " +
+            "older than the source.");
+    }
+    if (location.reliability !== "side-artifact-resolved") {
+        return capabilityFor("degraded", "the owner stack named a real position in the compiled bundle and nothing mapped it back to authored " +
+            `source (reliability "${location.reliability}"). The location is the bundle's, not the file a developer ` +
+            "wrote. React 19 removed `_debugSource`, so a bundle shipped without a source map beside it has no " +
+            "authored line to recover from the running page at all.");
+    }
+    if (location.line === null) {
+        return capabilityFor("degraded", "the owner stack mapped to an authored file with no line, so the answer is file-level rather than " +
+            "line-level.");
+    }
+    return capabilityFor("available");
+}
+function componentOnly(selector, fiberDistance, component, componentSource, renderedBy, reason) {
+    return {
+        outcome: "component-only",
+        selector,
+        fiberDistance,
+        component,
+        componentSource,
+        renderedBy,
+        reason,
+        capability: capabilityFor("degraded", reason),
+    };
+}
+//# sourceMappingURL=identity-grounding.js.map

package/dist/identity-grounding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-grounding.js","sourceRoot":"","sources":["../src/identity-grounding.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Identity grounding: an on-screen DOM element to the React component that
+ * produced it, and to that component's authored file and line.
+ *
+ * Start at `createIdentityGrounder` (`identity-grounder.ts`). Read
+ * `element-identity.ts` for what an answer is allowed to say, and
+ * `owner-stack.ts` for the measured difference between React 18's and React
+ * 19's fiber internals — they are not two implementations of one mechanism.
+ */
+export type { IdentityRefusal, GroundingMechanism, ComponentKind, ComponentNameSource, ComponentSource, ResolvedComponent, ElementIdentity, ElementIdentityGrounded, ElementIdentityComponentOnly, ElementIdentityRefused, } from "./element-identity.ts";
+export { IDENTITY_REFUSALS, GROUNDING_MECHANISMS, COMPONENT_KINDS, COMPONENT_NAME_SOURCES, COMPONENT_SOURCES, capabilityFor, } from "./element-identity.ts";
+export type { RawFiberProbe, RawComponentDescriptor, RawDebugSource, FiberKeyPrefix, IdentityGroundingProbe } from "./fiber-probe.ts";
+export { createIdentityGroundingProbe, IDENTITY_GROUNDING_BINDING, FIBER_KEY_PREFIXES } from "./fiber-probe.ts";
+export type { OwnerFrameSelection } from "./owner-stack.ts";
+export { selectOwnerFrame, REACT_ELEMENT_CREATION_FRAMES } from "./owner-stack.ts";
+export type { OwnerStackResolver } from "./identity-grounding.ts";
+export { groundFromProbe } from "./identity-grounding.ts";
+export type { IdentityGrounder, IdentityGrounderOptions } from "./identity-grounder.ts";
+export { createIdentityGrounder } from "./identity-grounder.ts";
+export type { GraphSymbolLocation } from "./graph-join.ts";
+export { symbolLocationForGraph } from "./graph-join.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtI,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEhH,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * Identity grounding: an on-screen DOM element to the React component that
+ * produced it, and to that component's authored file and line.
+ *
+ * Start at `createIdentityGrounder` (`identity-grounder.ts`). Read
+ * `element-identity.ts` for what an answer is allowed to say, and
+ * `owner-stack.ts` for the measured difference between React 18's and React
+ * 19's fiber internals — they are not two implementations of one mechanism.
+ */
+export { IDENTITY_REFUSALS, GROUNDING_MECHANISMS, COMPONENT_KINDS, COMPONENT_NAME_SOURCES, COMPONENT_SOURCES, capabilityFor, } from "./element-identity.js";
+export { createIdentityGroundingProbe, IDENTITY_GROUNDING_BINDING, FIBER_KEY_PREFIXES } from "./fiber-probe.js";
+export { selectOwnerFrame, REACT_ELEMENT_CREATION_FRAMES } from "./owner-stack.js";
+export { groundFromProbe } from "./identity-grounding.js";
+export { createIdentityGrounder } from "./identity-grounder.js";
+export { symbolLocationForGraph } from "./graph-join.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGhH,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}