@descryy/runtime-identity-grounding 0.2.0 → 0.4.0

package/dist/element-identity.d.ts

@@ -1,49 +1,27 @@
 /**
  * What identity grounding is allowed to say about one on-screen element.
+ * The whole package answers *which component produced this DOM node, and
+ * where is that written* — this file fixes the vocabulary so "we couldn't
+ * tell" is a first-class named value, not a null a reader has to interpret.
  *
- * The whole package answers a single question — *which component produced
- * this DOM node, and where is that written* — and this file fixes the
- * vocabulary of the answer so that "we could not tell" is a first-class,
- * named value rather than a null a reader has to interpret.
- *
- * ## No new event type, no new node type
- *
- * `RuntimeEventType` (`@descryy/runtime-contracts`) gains nothing here, and
- * neither does `descry-core`'s frozen 15/15 graph vocabulary. This follows
- * `@descryy/runtime-browser`'s `dom-evidence.ts` precedent exactly: a DOM
- * fact is naturally *"what did the element this action touched look like"*,
- * not an independent stream, so it rides on the `Evidence.payload` of the
- * action evidence a caller is already emitting. An `ElementIdentity` is a
- * plain, JSON-serialisable object for exactly that reason.
- *
- * The graph side is the same discipline one layer over: this package
- * resolves an element to a **file, a symbol name and a line**, which is
- * precisely `resolveSymbolNode`'s (`@descryy/runtime-graph-correlator`) input.
- * It does not resolve to a node id itself — that resolver already refuses
- * ambiguity, checks the line against the node's range and knows about
- * repo-relative versus absolute path languages, and a second copy of that
- * reasoning here would be a copy that drifts. See `graph-join.ts`.
+ * No new event type, no new node type: an `ElementIdentity` rides on the
+ * `Evidence.payload` of action evidence a caller is already emitting
+ * (`@descryy/runtime-browser`'s `dom-evidence.ts` precedent), so it's a
+ * plain JSON-serialisable object. This package resolves to a **file, symbol
+ * name and line** — `resolveSymbolNode`'s own input — never to a node id
+ * itself, since that resolver already refuses ambiguity and checks path
+ * languages; a second copy of that reasoning would drift. See `graph-join.ts`.
  */
 import type { CapabilityStatus, SourceLocation } from "@descryy/runtime-contracts";
-/**
- * Every way this can decline to name a component, as a closed set.
- *
- * A refusal is not an error and is never thrown — same contract
- * `CollectorStartResult` states for a collector that cannot start: absence
- * has to be representable data the caller can act on.
- */
-export declare const IDENTITY_REFUSALS: readonly ["probe-not-installed", "element-not-found", "not-react", "react-debug-fields-absent", "no-component-fiber", "anonymous-component"];
+/** Every way this can decline to name a component, as a closed set. A refusal is not an error and is never thrown — absence has to be representable data the caller can act on. */
+export declare const IDENTITY_REFUSALS: readonly ["probe-not-installed", "element-not-found", "not-react", "react-debug-fields-absent", "no-component-fiber", "anonymous-component", "vue-component-marker-absent", "framework-not-detected"];
 export type IdentityRefusal = (typeof IDENTITY_REFUSALS)[number];
-/**
- * How a source location was obtained. The two values are the two React
- * majors' genuinely different internals, not two implementations of one
- * idea — see `identity-grounding.ts` for the measurements.
- */
-export declare const GROUNDING_MECHANISMS: readonly ["react-debug-source", "react-owner-stack"];
+/** How a source location was obtained. The two values are the two React majors' genuinely different internals, not two implementations of one idea — see `identity-grounding.ts` for the measurements. */
+export declare const GROUNDING_MECHANISMS: readonly ["react-debug-source", "react-owner-stack", "vue-options-file"];
 export type GroundingMechanism = (typeof GROUNDING_MECHANISMS)[number];
-export declare const COMPONENT_KINDS: readonly ["function", "class", "forward-ref", "memo"];
+export declare const COMPONENT_KINDS: readonly ["function", "class", "forward-ref", "memo", "vue-options"];
 export type ComponentKind = (typeof COMPONENT_KINDS)[number];
-export declare const COMPONENT_NAME_SOURCES: readonly ["displayName", "function-name", "forward-ref-render-name"];
+export declare const COMPONENT_NAME_SOURCES: readonly ["displayName", "function-name", "forward-ref-render-name", "vue-options-name"];
 export type ComponentNameSource = (typeof COMPONENT_NAME_SOURCES)[number];
 export interface ResolvedComponent {
     readonly name: string;
@@ -52,27 +30,28 @@ export interface ResolvedComponent {
     readonly kind: ComponentKind;
 }
 /**
- * Which fiber field the component was read from.
- *
- * `_debugOwner` is React's own record of **which component's render created
- * this element**, and it is the one that pairs with the source location:
- * `_debugSource` and `_debugStack` both describe the *creation* site. The
- * `return` chain answers a different question — which component this
- * element ended up rendered *inside* — and the two differ whenever an
+ * Which field the component was read from. `_debugOwner` is React's record
+ * of which component's render *created* this element, pairing with the
+ * source location. The `return` chain answers a different question — which
+ * component this element ended up rendered *inside* — differing whenever an
  * element is created in one component and passed down as `children` to
- * another. The fixture app renders exactly that case on purpose.
+ * another (the fixture app renders this case on purpose). `vue-parent-
+ * component` is Vue's own read (`el.__vueParentComponent`) and does not
+ * carry React's creation-vs-render distinction — Vue's instance tree has no
+ * runtime-observable equivalent of `_debugOwner` separate from the nearest
+ * owning instance, so `renderedBy` is always `null` on a Vue-grounded
+ * identity rather than a guessed second answer.
  */
-export declare const COMPONENT_SOURCES: readonly ["debug-owner", "return-chain"];
+export declare const COMPONENT_SOURCES: readonly ["debug-owner", "return-chain", "vue-parent-component"];
 export type ComponentSource = (typeof COMPONENT_SOURCES)[number];
 interface ElementIdentityBase {
     readonly selector: string;
     /**
-     * How many `parentElement` hops from the queried element to the node that
-     * actually carried a React fiber. `0` is the element itself. Greater than
-     * zero means the queried node was not created by React at all — the
-     * inside of a `dangerouslySetInnerHTML` block, say — and the answer
-     * describes its nearest React-rendered ancestor. Stated, never folded
-     * into the answer silently.
+     * `parentElement` hops from the queried element to the node that carried
+     * a React fiber. `0` is the element itself; greater than zero means the
+     * queried node wasn't created by React (e.g. inside
+     * `dangerouslySetInnerHTML`), and the answer describes its nearest
+     * React-rendered ancestor.
      */
     readonly fiberDistance: number;
 }
@@ -84,13 +63,7 @@ export interface ElementIdentityGrounded extends ElementIdentityBase {
     /** The nearest component in the `return` chain — where the element was rendered, as opposed to where it was created. Null when there is none above the host fiber. */
     readonly renderedBy: ResolvedComponent | null;
     readonly sourceLocation: SourceLocation;
-    /**
-     * True when `sourceLocation.file` names authored source. False when it
-     * names compiled output because nothing could map it back — a React 19
-     * owner stack with no source map beside the bundle. The location is still
-     * real and still worth reporting; it just is not the file a developer
-     * wrote, and `capability` degrades accordingly.
-     */
+    /** True when `sourceLocation.file` names authored source. False when it names compiled output (a React 19 owner stack with no source map beside the bundle) — still real, still worth reporting, just not the file a developer wrote. */
     readonly authoredSource: boolean;
     readonly mechanism: GroundingMechanism;
     readonly capability: CapabilityStatus;
@@ -110,35 +83,25 @@ export interface ElementIdentityRefused extends ElementIdentityBase {
     readonly reason: string;
     readonly capability: CapabilityStatus;
     /**
-     * The running page's own `type.name` for the fiber, when there was a
-     * fiber at all.
-     *
-     * **Not a component name**, and deliberately not called one. On the
-     * `react-debug-fields-absent` path this is a minified identifier, kept so
-     * a human debugging a refusal can see what was actually there. Anything
-     * that treats this as an authored name has reintroduced exactly the guess
-     * the refusal exists to prevent.
+     * The running page's own `type.name` for the fiber, when there was one.
+     * NOT a component name, deliberately: on `react-debug-fields-absent` this
+     * is a minified identifier, kept so a human debugging a refusal can see
+     * what was there. Treating this as authored reintroduces the guess the
+     * refusal exists to prevent.
      */
     readonly observedTypeName: string | null;
 }
 export type ElementIdentity = ElementIdentityGrounded | ElementIdentityComponentOnly | ElementIdentityRefused;
 /**
- * The capability level this answer reports, in `CollectorCapabilities`'s own
- * three-value vocabulary (`@descryy/runtime-contracts`) rather than a fourth
- * one invented here.
- *
- * The mapping, stated once so it cannot drift between call sites:
+ * The capability level this answer reports, in `CollectorCapabilities`'s
+ * existing three-value vocabulary rather than a fourth one invented here.
  *
  * | outcome | availability | why |
  * | --- | --- | --- |
  * | `grounded`, authored source, not stale | `available` | component and authored file/line, both trustworthy |
- * | `grounded`, compiled or stale location | `degraded` | a real location that is not the authored one, or one whose freshness failed a check |
+ * | `grounded`, compiled or stale location | `degraded` | a real location that isn't the authored one, or failed a freshness check |
  * | `component-only` | `degraded` | the component is named; no location at all |
  * | `refused` | `unavailable` | nothing was named |
- *
- * `unavailable` is this repo's existing word for what a refusal is; there is
- * no `refused` member of `CapabilityAvailability` and adding one would fork
- * the capability model for one package.
  */
 export declare function capabilityFor(availability: "available"): CapabilityStatus;
 export declare function capabilityFor(availability: "degraded" | "unavailable", reason: string): CapabilityStatus;

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

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

package/dist/element-identity.js

@@ -1,36 +1,18 @@
 /**
  * What identity grounding is allowed to say about one on-screen element.
+ * The whole package answers *which component produced this DOM node, and
+ * where is that written* — this file fixes the vocabulary so "we couldn't
+ * tell" is a first-class named value, not a null a reader has to interpret.
  *
- * The whole package answers a single question — *which component produced
- * this DOM node, and where is that written* — and this file fixes the
- * vocabulary of the answer so that "we could not tell" is a first-class,
- * named value rather than a null a reader has to interpret.
- *
- * ## No new event type, no new node type
- *
- * `RuntimeEventType` (`@descryy/runtime-contracts`) gains nothing here, and
- * neither does `descry-core`'s frozen 15/15 graph vocabulary. This follows
- * `@descryy/runtime-browser`'s `dom-evidence.ts` precedent exactly: a DOM
- * fact is naturally *"what did the element this action touched look like"*,
- * not an independent stream, so it rides on the `Evidence.payload` of the
- * action evidence a caller is already emitting. An `ElementIdentity` is a
- * plain, JSON-serialisable object for exactly that reason.
- *
- * The graph side is the same discipline one layer over: this package
- * resolves an element to a **file, a symbol name and a line**, which is
- * precisely `resolveSymbolNode`'s (`@descryy/runtime-graph-correlator`) input.
- * It does not resolve to a node id itself — that resolver already refuses
- * ambiguity, checks the line against the node's range and knows about
- * repo-relative versus absolute path languages, and a second copy of that
- * reasoning here would be a copy that drifts. See `graph-join.ts`.
- */
-/**
- * Every way this can decline to name a component, as a closed set.
- *
- * A refusal is not an error and is never thrown — same contract
- * `CollectorStartResult` states for a collector that cannot start: absence
- * has to be representable data the caller can act on.
+ * No new event type, no new node type: an `ElementIdentity` rides on the
+ * `Evidence.payload` of action evidence a caller is already emitting
+ * (`@descryy/runtime-browser`'s `dom-evidence.ts` precedent), so it's a
+ * plain JSON-serialisable object. This package resolves to a **file, symbol
+ * name and line** — `resolveSymbolNode`'s own input — never to a node id
+ * itself, since that resolver already refuses ambiguity and checks path
+ * languages; a second copy of that reasoning would drift. See `graph-join.ts`.
  */
+/** Every way this can decline to name a component, as a closed set. A refusal is not an error and is never thrown — absence has to be representable data the caller can act on. */
 export const IDENTITY_REFUSALS = [
     /** `install()` was never called, or was called after the document had already loaded — `page.addInitScript` does not reach a document that is already there. */
     "probe-not-installed",
@@ -41,58 +23,81 @@ export const IDENTITY_REFUSALS = [
     /**
      * A fiber was found and it carries no `_debug*` field of any kind.
      *
-     * **This is the production-build refusal, and it is the one that must
-     * never soften into a guess.** React strips `_debugSource` /
-     * `_debugOwner` / `_debugStack` from fibers outside a development build,
-     * and a production bundle is additionally minified, so `type.name` on the
-     * fiber is whatever the minifier left behind — `U2`, `ap` — not the
-     * authored component name. Measured directly against React 18.3.1 and
-     * 19.2.8 production bundles: zero `_debug*` keys, and component names
-     * mangled in both.
+     * The production-build refusal, must never soften into a guess. React
+     * strips `_debugSource`/`_debugOwner`/`_debugStack` outside dev builds,
+     * and a production bundle is minified too, so `type.name` is whatever the
+     * minifier left (`U2`, `ap`), not the authored name. Measured against
+     * React 18.3.1 and 19.2.8 production bundles: zero `_debug*` keys,
+     * mangled names in both.
      *
-     * So there are two independent losses here, not one: no source location,
-     * *and* no trustworthy name. Reporting the mangled name as the component
-     * would be a confident wrong answer, which is worse than this refusal.
-     * The observed `type.name` still travels on
-     * `ElementIdentityRefused.observedTypeName`, labelled as what it is.
-     *
-     * The second, far rarer reading of the same observation — a React version
-     * that stopped exposing `_debug*` in development too — cannot be
-     * distinguished from here, which is why this is named for the evidence
-     * (the fields are absent) rather than for the conclusion (it is a
-     * production build). The reason string carries both readings.
+     * Two independent losses: no source location, no trustworthy name.
+     * Reporting the mangled name would be a confident wrong answer. It still
+     * travels on `ElementIdentityRefused.observedTypeName`, labelled as what
+     * it is. Named for the evidence (fields absent), not the conclusion
+     * (production build), since a React version that stopped exposing
+     * `_debug*` in dev too can't be distinguished from here.
      */
     "react-debug-fields-absent",
     /** A host fiber with no component above it at all — an element rendered directly by the root, with no `_debugOwner` and no component in its `return` chain. */
     "no-component-fiber",
     /** 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: `resolveSymbolNode` has nothing to look up, and neither does a reader. */
     "anonymous-component",
+    /**
+     * Vue's own read (`vue-identity-grounding.ts`): neither the queried element nor any ancestor
+     * carries `__vueParentComponent`. Named for the evidence, not the conclusion, for the same
+     * reason `react-debug-fields-absent` is — and here it is load-bearing rather than a stylistic
+     * choice: Vue 3 attaches this marker only when the app was built in a mode that keeps it
+     * (measured: present on an `esbuild --define process.env.NODE_ENV=development` bundle,
+     * **absent entirely** on a `minify: true` production bundle with devtools support off — no
+     * marker survives to distinguish "not a Vue page" from "a Vue production build" the way
+     * React's still-present-but-stripped fiber does). So this single refusal covers both readings
+     * honestly, the same way `react-debug-fields-absent` covers "production" vs "a future React
+     * that stopped exposing `_debug*` in dev too."
+     */
+    "vue-component-marker-absent",
+    /**
+     * `createFrameworkAwareGrounder`'s own refusal (`framework-aware-grounder.ts`): neither a React
+     * fiber key nor a Vue `__vueParentComponent` marker was found anywhere in the document, so
+     * there is no framework-specific grounder to delegate to. Distinct from `not-react` (which
+     * only rules out React) and from `vue-component-marker-absent` (which only rules out Vue) --
+     * this one is the honest answer when *both* readings failed, which is the case a caller that
+     * does not know the page's framework in advance is actually in. Never a reason to default to
+     * React.
+     */
+    "framework-not-detected",
 ];
-/**
- * How a source location was obtained. The two values are the two React
- * majors' genuinely different internals, not two implementations of one
- * idea — see `identity-grounding.ts` for the measurements.
- */
+/** How a source location was obtained. The two values are the two React majors' genuinely different internals, not two implementations of one idea — see `identity-grounding.ts` for the measurements. */
 export const GROUNDING_MECHANISMS = [
     /** React 18 and earlier, development build: `fiber._debugSource`, which names the authored file and line directly. */
     "react-debug-source",
     /** React 19, development build: `fiber._debugStack`, a captured `Error` whose frames point into *compiled* output and must be mapped back. */
     "react-owner-stack",
+    /**
+     * Vue 3, a dev-mode-retaining build: `instance.type.__file`, the same property
+     * `@vitejs/plugin-vue`/`vue-loader` write onto a compiled SFC's options object for its own
+     * devtools "open in editor" feature — this package reads that convention rather than
+     * inventing one. **File-level only.** Unlike React's `_debugSource`, nothing in Vue's runtime
+     * records a creation *line* for an element — there is no owner-stack equivalent to fall back
+     * to, so a Vue answer's `sourceLocation.line` is `null` by construction, not a missed case.
+     */
+    "vue-options-file",
 ];
-export const COMPONENT_KINDS = ["function", "class", "forward-ref", "memo"];
-export const COMPONENT_NAME_SOURCES = ["displayName", "function-name", "forward-ref-render-name"];
+export const COMPONENT_KINDS = ["function", "class", "forward-ref", "memo", "vue-options"];
+export const COMPONENT_NAME_SOURCES = ["displayName", "function-name", "forward-ref-render-name", "vue-options-name"];
 /**
- * Which fiber field the component was read from.
- *
- * `_debugOwner` is React's own record of **which component's render created
- * this element**, and it is the one that pairs with the source location:
- * `_debugSource` and `_debugStack` both describe the *creation* site. The
- * `return` chain answers a different question — which component this
- * element ended up rendered *inside* — and the two differ whenever an
+ * Which field the component was read from. `_debugOwner` is React's record
+ * of which component's render *created* this element, pairing with the
+ * source location. The `return` chain answers a different question — which
+ * component this element ended up rendered *inside* — differing whenever an
  * element is created in one component and passed down as `children` to
- * another. The fixture app renders exactly that case on purpose.
+ * another (the fixture app renders this case on purpose). `vue-parent-
+ * component` is Vue's own read (`el.__vueParentComponent`) and does not
+ * carry React's creation-vs-render distinction — Vue's instance tree has no
+ * runtime-observable equivalent of `_debugOwner` separate from the nearest
+ * owning instance, so `renderedBy` is always `null` on a Vue-grounded
+ * identity rather than a guessed second answer.
  */
-export const COMPONENT_SOURCES = ["debug-owner", "return-chain"];
+export const COMPONENT_SOURCES = ["debug-owner", "return-chain", "vue-parent-component"];
 export function capabilityFor(availability, reason) {
     return availability === "available" ? { availability, reason: null } : { availability, reason: reason ?? "" };
 }

package/dist/element-identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"element-identity.js","sourceRoot":"","sources":["../src/element-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gKAAgK;IAChK,qBAAqB;IACrB,gDAAgD;IAChD,mBAAmB;IACnB,8IAA8I;IAC9I,WAAW;IACX;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,2BAA2B;IAC3B,+JAA+J;IAC/J,oBAAoB;IACpB,qPAAqP;IACrP,qBAAqB;CACb,CAAC;AAGX;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,sHAAsH;IACtH,oBAAoB;IACpB,8IAA8I;IAC9I,mBAAmB;CACX,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAU,CAAC;AAGrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,yBAAyB,CAAU,CAAC;AAU3G;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,cAAc,CAAU,CAAC;AAsF1E,MAAM,UAAU,aAAa,CAAC,YAA8C,EAAE,MAAe;IAC3F,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;AAChH,CAAC"}
+{"version":3,"file":"element-identity.js","sourceRoot":"","sources":["../src/element-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,mLAAmL;AACnL,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gKAAgK;IAChK,qBAAqB;IACrB,gDAAgD;IAChD,mBAAmB;IACnB,8IAA8I;IAC9I,WAAW;IACX;;;;;;;;;;;;;;;;OAgBG;IACH,2BAA2B;IAC3B,+JAA+J;IAC/J,oBAAoB;IACpB,qPAAqP;IACrP,qBAAqB;IACrB;;;;;;;;;;;OAWG;IACH,6BAA6B;IAC7B;;;;;;;;OAQG;IACH,wBAAwB;CAChB,CAAC;AAGX,0MAA0M;AAC1M,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,sHAAsH;IACtH,oBAAoB;IACpB,8IAA8I;IAC9I,mBAAmB;IACnB;;;;;;;OAOG;IACH,kBAAkB;CACV,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;AAGpG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,kBAAkB,CAAU,CAAC;AAU/H;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,sBAAsB,CAAU,CAAC;AAqElG,MAAM,UAAU,aAAa,CAAC,YAA8C,EAAE,MAAe;IAC3F,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;AAChH,CAAC"}

package/dist/fiber-probe.d.ts

@@ -2,45 +2,26 @@
  * The page-side half: reads React's fiber bookkeeping off a real DOM node
  * and returns **raw facts only**.
  *
- * ## Read-only, and why that matters here
+ * Read-only, unlike `frontend-initiator-capture.ts` which concedes it
+ * wraps `window.fetch`. This module defines one function on `window` and
+ * reads properties React already put on DOM nodes and fiber objects —
+ * nothing wrapped, nothing patched, no application code path changes shape
+ * (same observation-only guarantee `Collector` states for attach mode).
  *
- * `frontend-initiator-capture.ts` (`@descryy/runtime-browser`) had to open
- * its own module comment by conceding that it *writes* — it wraps
- * `window.fetch` and adds a header to real outgoing requests, which is a
- * real observable side effect on the application under test. This module
- * has no such concession to make. It defines one function on `window` and
- * reads properties React already put on DOM nodes and on its own fiber
- * objects. Nothing is wrapped, nothing is patched, no application code path
- * changes shape because Descry is attached. That is the same
- * observation-only guarantee `Collector` states for attach mode
- * (`ATTACH_MODE_SCOPE_DISCLOSURE`), and it holds here without needing an
- * exception.
+ * Injected via `page.addInitScript` with a string body, the same mechanism
+ * `frontend-initiator-capture.ts` uses — no transpilation step needed. A
+ * string rather than a typed function because this repo's
+ * `tsconfig.base.json` has no DOM library, so `document`/`window` don't
+ * exist as types here; it keeps the "runs here" vs "runs there" boundary
+ * visible.
  *
- * ## Injected through the existing seam, not a second one
+ * `addInitScript` doesn't reach an already-loaded document — call
+ * `install()` before navigating, or a page reports `probe-not-installed`.
  *
- * `page.addInitScript` with a string body — exactly the mechanism
- * `frontend-initiator-capture.ts` already uses, for the same reason it
- * gives: the script runs as written in the page's own JS engine and needs
- * no transpilation step of its own. It is a string rather than a typed
- * function because this repo's `tsconfig.base.json` compiles with `lib:
- * ["ES2023"]` and no DOM library at all, so `document` and `window` do not
- * exist as types in this package. Writing the page code as a string is not
- * a shortcut around that; it is the same choice the sibling module made,
- * and it keeps the boundary between "runs here" and "runs there" visible.
- *
- * `addInitScript` does not reach a document that has already loaded. Call
- * `install()` before navigating, like every other collector in
- * `@descryy/runtime-browser` — a page navigated first reports
- * `probe-not-installed`, by name, rather than silently returning nothing.
- *
- * ## Raw facts only — no decisions
- *
- * Everything this returns is a JSON-serialisable transcript of what was on
- * the fiber. Deciding what it *means* (is this a production build? does
- * this owner stack point at authored source?) happens in Node, in
- * `identity-grounding.ts`, where it can be unit-tested without a browser
- * and where the source-map machinery this repo already owns is reachable.
- * The page-side script cannot resolve a source map and must not try.
+ * Raw facts only, no decisions: everything returned is a JSON-serialisable
+ * transcript. Deciding what it *means* happens in Node
+ * (`identity-grounding.ts`), unit-testable without a browser. The
+ * page-side script cannot resolve a source map and must not try.
  */
 import type { Page } from "playwright-core";
 import type { ComponentKind, ComponentNameSource } from "./element-identity.ts";
@@ -48,14 +29,13 @@ import type { ComponentKind, ComponentNameSource } from "./element-identity.ts";
 export declare const IDENTITY_GROUNDING_BINDING = "__descryIdentityGrounding";
 /**
  * The two key prefixes React has used to hang a fiber off a host DOM node:
- * `__reactFiber$` since React 17, `__reactInternalInstance$` before that.
- * Both are checked because both are cheap to check and a wrong "not React"
- * answer on a React 16 page would be a silent, permanent blind spot.
+ * `__reactFiber$` since React 17, `__reactInternalInstance$` before. Both
+ * checked because both are cheap and a wrong "not React" on a React 16 page
+ * would be a silent, permanent blind spot.
  *
- * Measured present as `__reactFiber$<random>` on React 18.3.1 and 19.2.8
- * alike; `__reactInternalInstance$` is carried on the documented shape of
- * React 16 and is **not** covered by this repo's fixtures, which is stated
- * here rather than implied by the code.
+ * Measured present as `__reactFiber$<random>` on React 18.3.1 and 19.2.8;
+ * `__reactInternalInstance$` matches React 16's documented shape but is
+ * NOT covered by this repo's fixtures.
  */
 export declare const FIBER_KEY_PREFIXES: readonly ["__reactFiber$", "__reactInternalInstance$"];
 export type FiberKeyPrefix = (typeof FIBER_KEY_PREFIXES)[number];
@@ -78,14 +58,14 @@ export type RawFiberProbe = {
 } | {
     readonly status: "no-fiber";
     readonly selector: string;
-    /** The element's own enumerable keys, capped — so a "not React" refusal can be argued with rather than merely believed. */
+    /** The element's own enumerable keys, capped — so a "not React" refusal can be argued with, not just believed. */
     readonly ownKeys: readonly string[];
 } | {
     readonly status: "fiber";
     readonly selector: string;
     readonly fiberKeyPrefix: FiberKeyPrefix;
     readonly fiberDistance: number;
-    /** `fiber.tag`, verbatim, for audit only. Nothing in this package branches on it — see `describeType` in the injected script for why the type shape is used instead. */
+    /** `fiber.tag`, verbatim, for audit only — see `describeType` for why the type shape is used instead. */
     readonly hostTag: number | null;
     /** `fiber.type` when it is a string, i.e. the host element's tag name. Null for a non-host fiber. */
     readonly hostTypeName: string | null;

package/dist/fiber-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fiber-probe.d.ts","sourceRoot":"","sources":["../src/fiber-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,wDAAyD,CAAC;AACzF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,+GAA+G;AAC/G,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnE;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2HAA2H;IAC3H,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,wKAAwK;IACxK,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qGAAqG;IACrG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,+IAA+I;IAC/I,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sJAAsJ;IACtJ,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,sFAAsF;IACtF,QAAQ,CAAC,oBAAoB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7D,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,qGAAqG;IACrG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wIAAwI;IACxI,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,6GAA6G;IAC7G,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,2EAA2E;IAC3E,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7D;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CASrE"}
+{"version":3,"file":"fiber-probe.d.ts","sourceRoot":"","sources":["../src/fiber-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,wDAAyD,CAAC;AACzF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,+GAA+G;AAC/G,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnE;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kHAAkH;IAClH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qGAAqG;IACrG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,+IAA+I;IAC/I,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sJAAsJ;IACtJ,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,sFAAsF;IACtF,QAAQ,CAAC,oBAAoB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7D,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,qGAAqG;IACrG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wIAAwI;IACxI,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,6GAA6G;IAC7G,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,2EAA2E;IAC3E,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7D;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CASrE"}