@descryy/runtime-identity-grounding 0.3.0 → 0.4.1

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.3.0",
+  "version": "0.4.1",
   "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,13 +24,13 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.2.0",
-    "@descryy/runtime-adapter-typescript": "0.2.0",
-    "@descryy/runtime-browser": "0.3.0",
+    "@descryy/runtime-contracts": "0.3.3",
+    "@descryy/runtime-adapter-typescript": "0.3.4",
+    "@descryy/runtime-browser": "0.4.5",
     "playwright-core": "^1.62.1"
   },
   "devDependencies": {
-    "@descryy/runtime-graph-correlator": "*",
-    "@descryy/runtime-controller": "*"
+    "@descryy/runtime-graph-correlator": "0.4.5",
+    "@descryy/runtime-controller": "0.3.4"
   }
 }