@descryy/runtime-identity-grounding 0.2.0 → 0.4.0

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"}

package/dist/vue-identity-grounding.js

@@ -0,0 +1,110 @@
+/**
+ * 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 { capabilityFor } from "./element-identity.js";
+export function groundFromVueProbe(probe, selector) {
+    if (probe.status === "probe-not-installed") {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: 0,
+            refusal: "probe-not-installed",
+            observedTypeName: null,
+            reason: "the Vue 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.",
+            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-marker") {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: 0,
+            refusal: "vue-component-marker-absent",
+            observedTypeName: null,
+            reason: `neither the element matched by "${selector}" nor any of its ancestors carries a __vueParentComponent ` +
+                `marker (${probe.ownKeys.length === 0 ? "the element has no own enumerable keys at all" : `own keys: ${probe.ownKeys.join(", ")}`}). ` +
+                "Measured against a real Vue 3 build (fixture-apps/vue-identity): this page was not produced by Vue at " +
+                "all, OR it was produced by a Vue build where this marker was compiled out — Vue does not distinguish " +
+                "the two the way React's still-present-but-stripped production fiber does, so both readings are named " +
+                "together rather than one being guessed.",
+            capability: capabilityFor("unavailable", "no __vueParentComponent marker on the element or any ancestor."),
+        };
+    }
+    const { name, file } = probe.component;
+    if (name === null) {
+        return {
+            outcome: "refused",
+            selector,
+            fiberDistance: probe.componentDistance,
+            refusal: "anonymous-component",
+            observedTypeName: null,
+            reason: "a Vue component instance was found and its options object carries no `name` — an anonymous component " +
+                "definition. Refused rather than reported as nameless: there is no symbol for `resolveSymbolNode` to " +
+                "look up and no name a reader could act on.",
+            capability: capabilityFor("unavailable", "the owning component has no `name`."),
+        };
+    }
+    const component = { name, nameSource: "vue-options-name", kind: "vue-options" };
+    if (file === null) {
+        return {
+            outcome: "component-only",
+            selector,
+            fiberDistance: probe.componentDistance,
+            component,
+            componentSource: "vue-parent-component",
+            // Vue's instance tree carries no runtime-observable creation-vs-render
+            // split the way React's `_debugOwner` vs `return` chain does — see
+            // `COMPONENT_SOURCES`'s own doc. Never a guessed second answer.
+            renderedBy: null,
+            reason: `the component "${name}" was found and it carries no \`__file\` — either it was not compiled by a tool ` +
+                "that writes one (`@vitejs/plugin-vue`/`vue-loader`'s devtools convention), or that tool's dev-only " +
+                "annotation was stripped for this build. The component is named; its file is not.",
+            capability: capabilityFor("degraded", "no `__file` on the component's options object."),
+        };
+    }
+    return {
+        outcome: "grounded",
+        selector,
+        fiberDistance: probe.componentDistance,
+        component,
+        componentSource: "vue-parent-component",
+        renderedBy: null,
+        sourceLocation: {
+            file,
+            // Vue's runtime records no creation line anywhere this package can
+            // read — not a missed case, the real ceiling of what `__file` alone
+            // can answer. See `vue-options-file`'s own doc.
+            line: null,
+            column: null,
+            functionName: name,
+            reliability: "self-contained",
+            resolvedVia: null,
+        },
+        authoredSource: true,
+        mechanism: "vue-options-file",
+        capability: capabilityFor("degraded", "`__file` named the authored file, but Vue's runtime records no creation line to pair with it, so the " +
+            "answer is file-level rather than line-level."),
+    };
+}
+//# sourceMappingURL=vue-identity-grounding.js.map

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

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

package/dist/vue-probe.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The page-side half of Vue support: reads the marker Vue itself puts on a
+ * DOM node and returns **raw facts only** — same discipline as
+ * `fiber-probe.ts`, and deliberately a separate module rather than a branch
+ * inside it, so the React reader's own tests and this one never share a
+ * probe function that could silently start doing both jobs at once.
+ *
+ * `el.__vueParentComponent` is Vue 3's own internal marker, set when the
+ * element is mounted — measured (see `fixture-apps/vue-identity`) present
+ * on an unminified dev-mode bundle and **absent entirely** on a minified
+ * bundle with devtools support compiled out. That is a real difference from
+ * React: a React production fiber is still there, just stripped of
+ * `_debug*` fields, so "no fiber" and "production build" are
+ * distinguishable there. Here they are not — see
+ * `vue-component-marker-absent`'s own doc in `element-identity.ts`.
+ *
+ * Injected the same way `fiber-probe.ts` is: `page.addInitScript` with a
+ * string body (no DOM lib in this repo's `tsconfig.base.json`), installed
+ * before the first navigation or the page reports `probe-not-installed`.
+ */
+import type { Page } from "playwright-core";
+export declare const VUE_IDENTITY_GROUNDING_BINDING = "__descryVueIdentityGrounding";
+export interface RawVueComponentDescriptor {
+    readonly name: string | null;
+    /** `type.__file`, verbatim — the marker `@vitejs/plugin-vue`/`vue-loader` write for their own "open in editor" devtools feature. Null when the options object carries none. */
+    readonly file: string | null;
+}
+export type RawVueProbe = {
+    readonly status: "probe-not-installed";
+} | {
+    readonly status: "element-not-found";
+    readonly selector: string;
+} | {
+    readonly status: "no-marker";
+    readonly selector: string;
+    /** Capped own-keys list, same audit purpose `fiber-probe.ts`'s carries. */
+    readonly ownKeys: readonly string[];
+} | {
+    readonly status: "component";
+    readonly selector: string;
+    readonly componentDistance: number;
+    readonly component: RawVueComponentDescriptor;
+};
+export interface VueIdentityGroundingProbe {
+    install(page: Page): Promise<void>;
+    probe(page: Page, selector: string): Promise<RawVueProbe>;
+}
+export declare function createVueIdentityGroundingProbe(): VueIdentityGroundingProbe;
+//# sourceMappingURL=vue-probe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue-probe.d.ts","sourceRoot":"","sources":["../src/vue-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAE7E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+KAA+K;IAC/K,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,GACnB;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,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEN,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3D;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAS3E"}

package/dist/vue-probe.js

@@ -0,0 +1,95 @@
+/**
+ * The page-side half of Vue support: reads the marker Vue itself puts on a
+ * DOM node and returns **raw facts only** — same discipline as
+ * `fiber-probe.ts`, and deliberately a separate module rather than a branch
+ * inside it, so the React reader's own tests and this one never share a
+ * probe function that could silently start doing both jobs at once.
+ *
+ * `el.__vueParentComponent` is Vue 3's own internal marker, set when the
+ * element is mounted — measured (see `fixture-apps/vue-identity`) present
+ * on an unminified dev-mode bundle and **absent entirely** on a minified
+ * bundle with devtools support compiled out. That is a real difference from
+ * React: a React production fiber is still there, just stripped of
+ * `_debug*` fields, so "no fiber" and "production build" are
+ * distinguishable there. Here they are not — see
+ * `vue-component-marker-absent`'s own doc in `element-identity.ts`.
+ *
+ * Injected the same way `fiber-probe.ts` is: `page.addInitScript` with a
+ * string body (no DOM lib in this repo's `tsconfig.base.json`), installed
+ * before the first navigation or the page reports `probe-not-installed`.
+ */
+export const VUE_IDENTITY_GROUNDING_BINDING = "__descryVueIdentityGrounding";
+export function createVueIdentityGroundingProbe() {
+    return {
+        async install(page) {
+            await page.addInitScript({ content: probeScriptSource() });
+        },
+        probe(page, selector) {
+            return page.evaluate(probeCallSource(selector));
+        },
+    };
+}
+/** Self-invoking, selector serialised in — same reasoning as `fiber-probe.ts`'s `probeCallSource`. */
+function probeCallSource(selector) {
+    return `(() => {
+  const grounding = window[${JSON.stringify(VUE_IDENTITY_GROUNDING_BINDING)}];
+  if (grounding === undefined || typeof grounding.probe !== "function") {
+    return { status: "probe-not-installed" };
+  }
+  return grounding.probe(${JSON.stringify(selector)});
+})()`;
+}
+/** Cap on the reported own-keys list — same bound `fiber-probe.ts` uses, same reason. */
+const MAX_REPORTED_OWN_KEYS = 32;
+function probeScriptSource() {
+    return `(() => {
+  function describeInstance(instance) {
+    const type = instance && instance.type;
+    if (type === null || type === undefined) return { name: null, file: null };
+    return {
+      name: typeof type.name === "string" && type.name.length > 0 ? type.name : null,
+      file: typeof type.__file === "string" && type.__file.length > 0 ? type.__file : null,
+    };
+  }
+
+  window[${JSON.stringify(VUE_IDENTITY_GROUNDING_BINDING)}] = {
+    probe: function (selector) {
+      let element;
+      try {
+        element = document.querySelector(selector);
+      } catch (_error) {
+        return { status: "element-not-found", selector: selector };
+      }
+      if (element === null) return { status: "element-not-found", selector: selector };
+
+      let node = element;
+      let distance = 0;
+      let instance = null;
+      while (node !== null && node !== undefined) {
+        if (node.__vueParentComponent !== undefined && node.__vueParentComponent !== null) {
+          instance = node.__vueParentComponent;
+          break;
+        }
+        node = node.parentElement;
+        distance++;
+      }
+
+      if (instance === null) {
+        return {
+          status: "no-marker",
+          selector: selector,
+          ownKeys: Object.keys(element).slice(0, ${MAX_REPORTED_OWN_KEYS}),
+        };
+      }
+
+      return {
+        status: "component",
+        selector: selector,
+        componentDistance: distance,
+        component: describeInstance(instance),
+      };
+    },
+  };
+})();`;
+}
+//# sourceMappingURL=vue-probe.js.map

package/dist/vue-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-probe.js","sourceRoot":"","sources":["../src/vue-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,CAAC,MAAM,8BAA8B,GAAG,8BAA8B,CAAC;AA6B7E,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAU;YACtB,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,CAAC,IAAU,EAAE,QAAgB;YAChC,OAAO,IAAI,CAAC,QAAQ,CAAc,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO;6BACoB,IAAI,CAAC,SAAS,CAAC,8BAA8B,CAAC;;;;2BAIhD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC9C,CAAC;AACN,CAAC;AAED,yFAAyF;AACzF,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,SAAS,iBAAiB;IACxB,OAAO;;;;;;;;;;WAUE,IAAI,CAAC,SAAS,CAAC,8BAA8B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;mDA0BN,qBAAqB;;;;;;;;;;;;MAYlE,CAAC;AACP,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@descryy/runtime-identity-grounding",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
-  "description": "Identity grounding: resolves an on-screen DOM element back to the React component that produced it, and to that component's authored file and line. Injects through @descryy/runtime-browser's existing page.addInitScript seam; refuses by name on a production React build rather than guessing.",
+  "description": "Identity grounding: resolves an on-screen DOM element back to the React or Vue component that produced it, and to that component's authored file (and, for React, line). createFrameworkAwareGrounder detects which framework actually rendered the page (React's fiber marker, then Vue's component marker, else a named refusal) and grounds through the matching mechanism -- never a default to React. Injects through @descryy/runtime-browser's existing page.addInitScript seam; refuses by name on a production build rather than guessing. Consumed by descry-core's @descryy/mcp (packages/mcp/src/browser/playwright-driver.ts) and descry-desktop's @descry/session (packages/session/src/pipeline/browser-drive.ts).",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=22.5"
@@ -24,9 +24,9 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.2.0",
-    "@descryy/runtime-adapter-typescript": "0.2.0",
-    "@descryy/runtime-browser": "0.2.0",
+    "@descryy/runtime-contracts": "0.3.3",
+    "@descryy/runtime-adapter-typescript": "0.3.3",
+    "@descryy/runtime-browser": "0.4.4",
     "playwright-core": "^1.62.1"
   },
   "devDependencies": {