@descryy/runtime-identity-grounding 0.3.0 → 0.4.1

package/dist/identity-grounding.js

@@ -1,38 +1,24 @@
 /**
  * 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.
+ * Pure with respect to the browser — never touches a `Page`. The one piece
+ * of machinery it can't own (turning a React 19 owner stack into a resolved
+ * `StackTrace`) is injected as `OwnerStackResolver`, so every refusal
+ * branch below is a plain unit test, no Chromium needed.
  *
- * ## What this cannot do, stated once, in the place that decides it
+ * What this cannot do, decided here: a production React build (no
+ * `_debug*` survives, refused as `react-debug-fields-absent`); anything
+ * that isn't React (no fiber key — a scope boundary, not a gap, refused as
+ * "not React" rather than "unknown"); a React 19 bundle with no source map
+ * (reported with `authoredSource: false` and `degraded`, never dressed up);
+ * an anonymous component (refused — no symbol to look up, no name to act on).
  *
- * - **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.
+ * `component` is read from `_debugOwner` — whose render *created* the
+ * element, matching the source location. `renderedBy` is the nearest
+ * component in the `return` chain — where it ended up. They differ when an
+ * element is created in one component and passed to another as `children`
+ * (the fixture app renders this on purpose); both are reported, neither
+ * reconciled.
  */
 import { locationNamesNothing } from "@descryy/runtime-contracts";
 import { capabilityFor, } from "./element-identity.js";
@@ -77,19 +63,18 @@ export async function groundFromProbe(probe, selector, resolveOwnerStack) {
             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.",
+                "This page's DOM was not produced by React, or not by a React that tags host nodes. This resolver " +
+                "(`groundFromProbe`) is React-only — `groundFromVueProbe` (`vue-identity-grounding.ts`) is this " +
+                "package's Vue reader, on the same `ElementIdentity` vocabulary; Svelte, Angular and Solid remain a scope " +
+                "boundary, not a temporary gap (RG-15: one framework extension at a time).",
             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`.
+        // The queried node is usually a host fiber whose `type` is a tag name
+        // string, so the minified identifier lives on the nearest component
+        // above it. Consulted in that order — still not a component name.
         const observedTypeName = probe.observedTypeName ?? probe.returnChainComponent?.name ?? probe.owner?.name ?? null;
         return {
             outcome: "refused",
@@ -132,7 +117,7 @@ export async function groundFromProbe(probe, selector, resolveOwnerStack) {
         };
     }
     const renderedBy = returnChain;
-    // ---- React 18 and earlier: the authored location is on the fiber. ----
+    // React 18 and earlier: the authored location is on the fiber.
     const debugSource = probe.debugSource;
     if (debugSource !== null && debugSource.fileName !== null) {
         const sourceLocation = {
@@ -140,10 +125,8 @@ export async function groundFromProbe(probe, selector, resolveOwnerStack) {
             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.
+            // The app's own recorded creation site, not a translation through a
+            // side artifact — nothing was lost, this IS the accurate answer.
             reliability: "self-contained",
             resolvedVia: null,
         };
@@ -163,7 +146,7 @@ export async function groundFromProbe(probe, selector, resolveOwnerStack) {
                 : capabilityFor("available"),
         };
     }
-    // ---- React 19: an owner stack in compiled coordinates. ----
+    // React 19: an owner stack in compiled coordinates.
     const stackText = probe.debugStackText;
     if (stackText !== null) {
         if (resolveOwnerStack === null) {

package/dist/identity-grounding.js.map

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

package/dist/index.d.ts

@@ -1,11 +1,7 @@
 /**
  * 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.
+ * produced it, and to its authored file and line. Start at
+ * `createIdentityGrounder` (`identity-grounder.ts`).
  */
 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";
@@ -17,6 +13,11 @@ 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 { RawVueProbe, RawVueComponentDescriptor, VueIdentityGroundingProbe } from "./vue-probe.ts";
+export { createVueIdentityGroundingProbe, VUE_IDENTITY_GROUNDING_BINDING } from "./vue-probe.ts";
+export { groundFromVueProbe } from "./vue-identity-grounding.ts";
+export type { VueIdentityGrounder } from "./vue-identity-grounder.ts";
+export { createVueIdentityGrounder } from "./vue-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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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,WAAW,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACxG,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,16 +1,15 @@
 /**
  * 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.
+ * produced it, and to its authored file and line. Start at
+ * `createIdentityGrounder` (`identity-grounder.ts`).
  */
 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 { createVueIdentityGroundingProbe, VUE_IDENTITY_GROUNDING_BINDING } from "./vue-probe.js";
+export { groundFromVueProbe } from "./vue-identity-grounding.js";
+export { createVueIdentityGrounder } from "./vue-identity-grounder.js";
 export { symbolLocationForGraph } from "./graph-join.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/owner-stack.d.ts

@@ -1,12 +1,9 @@
 /**
- * React 19's replacement for `_debugSource`, and the one rule this package
- * needs in order to read it.
+ * React 19's replacement for `_debugSource`, and the rule this package
+ * needs to read it.
  *
- * ## What actually changed between the majors
- *
- * Measured directly, in a real Chromium, against React 18.3.1 and 19.2.8
- * development bundles of the same authored source
- * (`fixture-apps/react-identity`):
+ * Measured in a real Chromium, React 18.3.1 vs 19.2.8 dev bundles of the
+ * same source (`fixture-apps/react-identity`):
  *
  * | fiber field | React 18.3.1 dev | React 19.2.8 dev | either, production |
  * | --- | --- | --- | --- |
@@ -15,64 +12,41 @@
  * | `_debugOwner` | present | present | absent |
  * | `type.name` | authored | authored | minified |
  *
- * So React 19 did not move the source location, it **deleted** it and left
- * a captured stack in its place. The stack's frames point into *compiled*
- * output — the bundle the browser actually ran — which is why this path
- * costs a source-map resolution that React 18's does not, and why the two
- * mechanisms report different `SourceLocation.reliability` values
- * (`self-contained` versus `side-artifact-resolved`). That difference is
- * not cosmetic: one is the application telling us where it came from, the
- * other is us translating through a file that can be missing or stale.
- *
- * ## The rule: drop React's own element-creation frame, and only that
- *
- * The captured stack's innermost frame is React's own JSX entry point:
- *
- * ```text
- * Error: react-stack-top-frame
- *     at exports.jsxDEV (http://…/dev.js:21690:32)
- *     at PayButton     (http://…/dev.js:21714:62)   <- the site we want
- *     at Object.react_stack_bottom_frame (…)
- * ```
- *
- * The second frame is the JSX call site inside the owning component, which
- * is exactly the fact React 18's `_debugSource` carries. Verified against
- * the fixture: React 18 reports `src/app.jsx:20`, and mapping React 19's
- * second frame through the bundle's source map lands on `src/app.jsx:20`
- * as well. `react-fixtures.test.ts` asserts that equality rather than
- * asserting each major separately, because two independently-written
- * expectations can both be wrong in the same direction.
- *
- * ## Why not `stripInitiatorWrapperFrame`'s positional rule
- *
- * `@descryy/runtime-browser`'s initiator capture drops its first frame *by
- * position*, and argues correctly that its own wrapper is deterministically
- * innermost because it captured the stack itself. Nothing here captured
- * this stack — React did — so the same reasoning is not available. Worse,
- * `createV8StackTraceParser` **omits** frames it cannot parse a
- * `line:column` from, so "the first frame of the parsed trace" is not
- * reliably "the first frame of the raw text" either.
- *
- * The rule used instead is by name, against a closed list of React's own
- * element-creation entry points, and it **refuses** when the innermost
- * frame is not one of them. A refusal here costs a source location; a
- * positional guess that is off by one costs a confident wrong file and
- * line, attributed to a component that did not create the element. Rule 2.
+ * React 19 didn't move the source location, it **deleted** it and left a
+ * captured stack whose frames point into *compiled* output — costing a
+ * source-map resolution React 18 doesn't need, and reporting a different
+ * `SourceLocation.reliability` (`self-contained` vs `side-artifact-resolved`):
+ * one is the app telling us where it came from, the other is us
+ * translating through a file that can be missing or stale.
+ *
+ * The rule: drop React's own element-creation frame (the stack's innermost
+ * frame, e.g. `exports.jsxDEV`), and only that — the second frame is the
+ * JSX call site inside the owning component, the same fact React 18's
+ * `_debugSource` carries. Verified against the fixture: both majors land on
+ * `src/app.jsx:20` (`react-fixtures.test.ts` asserts the equality, not each
+ * major separately, since two independent expectations can be wrong the
+ * same way).
+ *
+ * Not `stripInitiatorWrapperFrame`'s positional rule: nothing here captured
+ * this stack, React did, so "deterministically innermost" doesn't apply —
+ * and `createV8StackTraceParser` omits unparseable frames, so "first frame
+ * of the parsed trace" isn't reliably "first frame of the raw text" either.
+ * Instead: match by name against a closed list of React's element-creation
+ * entry points, and **refuse** when the innermost frame isn't one of them.
+ * A refusal costs a source location; an off-by-one positional guess costs a
+ * confident wrong file/line attributed to the wrong component (rule 2).
  */
 import type { StackTrace } from "@descryy/runtime-contracts";
 /**
  * React's own element-creation entry points, matched against the **last
- * dotted segment** of a frame's function name so that V8's `exports.jsxDEV`
- * and a bare `jsxDEV` are the same frame.
- *
- * `jsxDEV` / `jsxDEVImpl` are the automatic runtime's development entry;
- * `jsx` / `jsxs` its production ones (listed for completeness — a
- * production build has no `_debugStack` to reach this code with);
- * `createElement` / `createElementWithValidation` the classic runtime's.
- *
- * Deliberately a closed list rather than a "does this frame live inside
- * react-dom" heuristic: the latter needs a resolved path for the frame,
- * which is exactly the thing that may not resolve.
+ * dotted segment** of a frame's function name so `exports.jsxDEV` and bare
+ * `jsxDEV` are the same frame. `jsxDEV`/`jsxDEVImpl` are the automatic
+ * runtime's dev entry; `jsx`/`jsxs` its production ones (listed for
+ * completeness — production has no `_debugStack` to reach this code with);
+ * `createElement`/`createElementWithValidation` the classic runtime's.
+ *
+ * A closed list, not a "lives inside react-dom" heuristic — that needs a
+ * resolved path, exactly the thing that may not resolve.
  */
 export declare const REACT_ELEMENT_CREATION_FRAMES: readonly ["jsxDEV", "jsxDEVImpl", "jsxWithValidation", "jsx", "jsxs", "createElement", "createElementWithValidation"];
 export type OwnerFrameSelection = {
@@ -82,9 +56,6 @@ export type OwnerFrameSelection = {
     readonly ok: false;
     readonly reason: string;
 };
-/**
- * Index of the frame that is the JSX call site inside the owning component,
- * or a refusal naming why the stack could not be read that way.
- */
+/** Index of the frame that is the JSX call site inside the owning component, or a refusal naming why the stack couldn't be read that way. */
 export declare function selectOwnerFrame(stack: StackTrace): OwnerFrameSelection;
 //# sourceMappingURL=owner-stack.d.ts.map

package/dist/owner-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owner-stack.d.ts","sourceRoot":"","sources":["../src/owner-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,uHAQhC,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAOpD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAsCvE"}
+{"version":3,"file":"owner-stack.d.ts","sourceRoot":"","sources":["../src/owner-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,uHAQhC,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAOpD,6IAA6I;AAC7I,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAsCvE"}

package/dist/owner-stack.js

@@ -1,12 +1,9 @@
 /**
- * React 19's replacement for `_debugSource`, and the one rule this package
- * needs in order to read it.
+ * React 19's replacement for `_debugSource`, and the rule this package
+ * needs to read it.
  *
- * ## What actually changed between the majors
- *
- * Measured directly, in a real Chromium, against React 18.3.1 and 19.2.8
- * development bundles of the same authored source
- * (`fixture-apps/react-identity`):
+ * Measured in a real Chromium, React 18.3.1 vs 19.2.8 dev bundles of the
+ * same source (`fixture-apps/react-identity`):
  *
  * | fiber field | React 18.3.1 dev | React 19.2.8 dev | either, production |
  * | --- | --- | --- | --- |
@@ -15,63 +12,40 @@
  * | `_debugOwner` | present | present | absent |
  * | `type.name` | authored | authored | minified |
  *
- * So React 19 did not move the source location, it **deleted** it and left
- * a captured stack in its place. The stack's frames point into *compiled*
- * output — the bundle the browser actually ran — which is why this path
- * costs a source-map resolution that React 18's does not, and why the two
- * mechanisms report different `SourceLocation.reliability` values
- * (`self-contained` versus `side-artifact-resolved`). That difference is
- * not cosmetic: one is the application telling us where it came from, the
- * other is us translating through a file that can be missing or stale.
- *
- * ## The rule: drop React's own element-creation frame, and only that
- *
- * The captured stack's innermost frame is React's own JSX entry point:
- *
- * ```text
- * Error: react-stack-top-frame
- *     at exports.jsxDEV (http://…/dev.js:21690:32)
- *     at PayButton     (http://…/dev.js:21714:62)   <- the site we want
- *     at Object.react_stack_bottom_frame (…)
- * ```
- *
- * The second frame is the JSX call site inside the owning component, which
- * is exactly the fact React 18's `_debugSource` carries. Verified against
- * the fixture: React 18 reports `src/app.jsx:20`, and mapping React 19's
- * second frame through the bundle's source map lands on `src/app.jsx:20`
- * as well. `react-fixtures.test.ts` asserts that equality rather than
- * asserting each major separately, because two independently-written
- * expectations can both be wrong in the same direction.
+ * React 19 didn't move the source location, it **deleted** it and left a
+ * captured stack whose frames point into *compiled* output — costing a
+ * source-map resolution React 18 doesn't need, and reporting a different
+ * `SourceLocation.reliability` (`self-contained` vs `side-artifact-resolved`):
+ * one is the app telling us where it came from, the other is us
+ * translating through a file that can be missing or stale.
  *
- * ## Why not `stripInitiatorWrapperFrame`'s positional rule
+ * The rule: drop React's own element-creation frame (the stack's innermost
+ * frame, e.g. `exports.jsxDEV`), and only that — the second frame is the
+ * JSX call site inside the owning component, the same fact React 18's
+ * `_debugSource` carries. Verified against the fixture: both majors land on
+ * `src/app.jsx:20` (`react-fixtures.test.ts` asserts the equality, not each
+ * major separately, since two independent expectations can be wrong the
+ * same way).
  *
- * `@descryy/runtime-browser`'s initiator capture drops its first frame *by
- * position*, and argues correctly that its own wrapper is deterministically
- * innermost because it captured the stack itself. Nothing here captured
- * this stack — React did — so the same reasoning is not available. Worse,
- * `createV8StackTraceParser` **omits** frames it cannot parse a
- * `line:column` from, so "the first frame of the parsed trace" is not
- * reliably "the first frame of the raw text" either.
- *
- * The rule used instead is by name, against a closed list of React's own
- * element-creation entry points, and it **refuses** when the innermost
- * frame is not one of them. A refusal here costs a source location; a
- * positional guess that is off by one costs a confident wrong file and
- * line, attributed to a component that did not create the element. Rule 2.
+ * Not `stripInitiatorWrapperFrame`'s positional rule: nothing here captured
+ * this stack, React did, so "deterministically innermost" doesn't apply —
+ * and `createV8StackTraceParser` omits unparseable frames, so "first frame
+ * of the parsed trace" isn't reliably "first frame of the raw text" either.
+ * Instead: match by name against a closed list of React's element-creation
+ * entry points, and **refuse** when the innermost frame isn't one of them.
+ * A refusal costs a source location; an off-by-one positional guess costs a
+ * confident wrong file/line attributed to the wrong component (rule 2).
  */
 /**
  * React's own element-creation entry points, matched against the **last
- * dotted segment** of a frame's function name so that V8's `exports.jsxDEV`
- * and a bare `jsxDEV` are the same frame.
- *
- * `jsxDEV` / `jsxDEVImpl` are the automatic runtime's development entry;
- * `jsx` / `jsxs` its production ones (listed for completeness — a
- * production build has no `_debugStack` to reach this code with);
- * `createElement` / `createElementWithValidation` the classic runtime's.
+ * dotted segment** of a frame's function name so `exports.jsxDEV` and bare
+ * `jsxDEV` are the same frame. `jsxDEV`/`jsxDEVImpl` are the automatic
+ * runtime's dev entry; `jsx`/`jsxs` its production ones (listed for
+ * completeness — production has no `_debugStack` to reach this code with);
+ * `createElement`/`createElementWithValidation` the classic runtime's.
  *
- * Deliberately a closed list rather than a "does this frame live inside
- * react-dom" heuristic: the latter needs a resolved path for the frame,
- * which is exactly the thing that may not resolve.
+ * A closed list, not a "lives inside react-dom" heuristic — that needs a
+ * resolved path, exactly the thing that may not resolve.
  */
 export const REACT_ELEMENT_CREATION_FRAMES = [
     "jsxDEV",
@@ -86,10 +60,7 @@ function lastSegment(functionName) {
     const parts = functionName.split(".");
     return parts[parts.length - 1] ?? functionName;
 }
-/**
- * Index of the frame that is the JSX call site inside the owning component,
- * or a refusal naming why the stack could not be read that way.
- */
+/** Index of the frame that is the JSX call site inside the owning component, or a refusal naming why the stack couldn't be read that way. */
 export function selectOwnerFrame(stack) {
     const first = stack.frames[0];
     if (first === undefined) {

package/dist/owner-stack.js.map

@@ -1 +1 @@
-{"version":3,"file":"owner-stack.js","sourceRoot":"","sources":["../src/owner-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,YAAY;IACZ,mBAAmB;IACnB,KAAK;IACL,MAAM;IACN,eAAe;IACf,6BAA6B;CACrB,CAAC;AAMX,SAAS,WAAW,CAAC,YAAoB;IACvC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yFAAyF,EAAE,CAAC;IAC1H,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;IACjD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,wGAAwG;gBACxG,uGAAuG;gBACvG,iFAAiF;SACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAE,6BAAmD,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,uDAAuD,YAAY,qCAAqC;gBACxG,kCAAkC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC;gBAC5G,sGAAsG;gBACtG,yBAAyB;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,2GAA2G;gBAC3G,+FAA+F;SAClG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"owner-stack.js","sourceRoot":"","sources":["../src/owner-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,YAAY;IACZ,mBAAmB;IACnB,KAAK;IACL,MAAM;IACN,eAAe;IACf,6BAA6B;CACrB,CAAC;AAMX,SAAS,WAAW,CAAC,YAAoB;IACvC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC;AACjD,CAAC;AAED,6IAA6I;AAC7I,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yFAAyF,EAAE,CAAC;IAC1H,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;IACjD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,wGAAwG;gBACxG,uGAAuG;gBACvG,iFAAiF;SACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAE,6BAAmD,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,uDAAuD,YAAY,qCAAqC;gBACxG,kCAAkC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC;gBAC5G,sGAAsG;gBACtG,yBAAyB;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,2GAA2G;gBAC3G,+FAA+F;SAClG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * The composed, page-driving surface for Vue — install once, then ask about
+ * a selector. Mirrors `identity-grounder.ts`'s shape exactly (`install`/
+ * `ground`) so a caller consuming both frameworks can hold one interface
+ * and switch grounders per page, without a framework-specific branch
+ * anywhere above this module.
+ *
+ * Nothing to compose here beyond the probe and the decision layer — Vue's
+ * answer needs no source-map resolver, no stack parser, no `resolveSourceRoot`
+ * (`vue-identity-grounding.ts`'s own header says why: file-level only, by
+ * construction). That is the whole reason this file is a fifth of
+ * `identity-grounder.ts`'s size rather than a second copy of it.
+ */
+import type { Page } from "playwright-core";
+import type { ElementIdentity } from "./element-identity.ts";
+export interface VueIdentityGrounder {
+    /** Installs the page-side reader into every document this page loads from now on. Call before navigating — a page navigated first reports `probe-not-installed`. */
+    install(page: Page): Promise<void>;
+    /** Resolves one on-screen element to the component that produced it, and to that component's authored file where it can be established. Never throws for a routine unavailability; refuses by name instead. */
+    ground(page: Page, selector: string): Promise<ElementIdentity>;
+}
+export declare function createVueIdentityGrounder(): VueIdentityGrounder;
+//# sourceMappingURL=vue-identity-grounder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue-identity-grounder.d.ts","sourceRoot":"","sources":["../src/vue-identity-grounder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,mBAAmB;IAClC,oKAAoK;IACpK,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+MAA+M;IAC/M,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,CAW/D"}

package/dist/vue-identity-grounder.js

@@ -0,0 +1,28 @@
+/**
+ * The composed, page-driving surface for Vue — install once, then ask about
+ * a selector. Mirrors `identity-grounder.ts`'s shape exactly (`install`/
+ * `ground`) so a caller consuming both frameworks can hold one interface
+ * and switch grounders per page, without a framework-specific branch
+ * anywhere above this module.
+ *
+ * Nothing to compose here beyond the probe and the decision layer — Vue's
+ * answer needs no source-map resolver, no stack parser, no `resolveSourceRoot`
+ * (`vue-identity-grounding.ts`'s own header says why: file-level only, by
+ * construction). That is the whole reason this file is a fifth of
+ * `identity-grounder.ts`'s size rather than a second copy of it.
+ */
+import { createVueIdentityGroundingProbe } from "./vue-probe.js";
+import { groundFromVueProbe } from "./vue-identity-grounding.js";
+export function createVueIdentityGrounder() {
+    const probe = createVueIdentityGroundingProbe();
+    return {
+        install(page) {
+            return probe.install(page);
+        },
+        async ground(page, selector) {
+            const raw = await probe.probe(page, selector);
+            return groundFromVueProbe(raw, selector);
+        },
+    };
+}
+//# sourceMappingURL=vue-identity-grounder.js.map

package/dist/vue-identity-grounder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-identity-grounder.js","sourceRoot":"","sources":["../src/vue-identity-grounder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AASjE,MAAM,UAAU,yBAAyB;IACvC,MAAM,KAAK,GAAG,+BAA+B,EAAE,CAAC;IAChD,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,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * The decision layer for Vue: raw probe facts in, one `ElementIdentity` out
+ * — same contract `identity-grounding.ts`'s `groundFromProbe` holds for
+ * React, on the same output vocabulary, so a caller that already branches
+ * on `ElementIdentity.outcome` needs no second code path to consume this.
+ *
+ * Simpler than the React decision layer by construction, not by omission:
+ * Vue's runtime gives this package one fact per element (`type.__file`,
+ * file-level, no line) rather than React 18's file+line or React 19's
+ * compiled-stack-needing-resolution — there is no owner-stack equivalent to
+ * inject a resolver for, so this function takes no second argument.
+ */
+import { type ElementIdentity } from "./element-identity.ts";
+import type { RawVueProbe } from "./vue-probe.ts";
+export declare function groundFromVueProbe(probe: RawVueProbe, selector: string): ElementIdentity;
+//# sourceMappingURL=vue-identity-grounding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue-identity-grounding.d.ts","sourceRoot":"","sources":["../src/vue-identity-grounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiB,KAAK,eAAe,EAA0B,MAAM,uBAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkHxF"}