@rose42/feedback-capture 0.1.0

package/dist/session.d.ts

@@ -0,0 +1,19 @@
+import { type FeedbackCapturePlugin } from "./plugins/core.js";
+import type { FeedbackEnvelope } from "./types.js";
+export type FeedbackCaptureSession<Ps extends readonly FeedbackCapturePlugin[]> = {
+    /**
+     * Collect an envelope from the session plugins.
+     * Pass `extraPlugins` for submit-only collectors (e.g. comment / screenshot in mount).
+     */
+    build: <const Extra extends readonly FeedbackCapturePlugin[] = []>(extraPlugins?: Extra) => Promise<FeedbackEnvelope<[...Ps, ...Extra]>>;
+    /** Tear down plugin setup (idempotent). */
+    dispose: () => void;
+};
+/**
+ * Init feedback capture with a plugin list: runs `setup` immediately,
+ * then use `build()` later to collect a typed envelope.
+ */
+export declare function initFeedbackCapture<const Ps extends readonly FeedbackCapturePlugin[]>(options: {
+    plugins: Ps;
+}): FeedbackCaptureSession<Ps>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,sBAAsB,CAAC,EAAE,SAAS,SAAS,qBAAqB,EAAE,IAAI;IAChF;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,qBAAqB,EAAE,GAAG,EAAE,EAC/D,YAAY,CAAC,EAAE,KAAK,KACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,2CAA2C;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,qBAAqB,EAAE,EAAE,OAAO,EAAE;IAC9F,OAAO,EAAE,EAAE,CAAC;CACb,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAc7B"}

package/dist/session.js

@@ -0,0 +1,18 @@
+import { collectPluginExtras, installCapturePlugins, } from "./plugins/core.js";
+/**
+ * Init feedback capture with a plugin list: runs `setup` immediately,
+ * then use `build()` later to collect a typed envelope.
+ */
+export function initFeedbackCapture(options) {
+    const plugins = options.plugins;
+    const dispose = installCapturePlugins(plugins);
+    return {
+        async build(extraPlugins) {
+            const extra = (extraPlugins ?? []);
+            const all = [...plugins, ...extra];
+            return collectPluginExtras(all);
+        },
+        dispose,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAe3B;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAoD,OAEtF;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/C,OAAO;QACL,KAAK,CAAC,KAAK,CACT,YAAoB;YAEpB,MAAM,KAAK,GAAG,CAAC,YAAY,IAAI,EAAE,CAAU,CAAC;YAC5C,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,CAAsB,CAAC;YACxD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/source/adapters/compose.d.ts

@@ -0,0 +1,7 @@
+import type { ResolveElementSource } from "../../plugins/elementTarget.js";
+/**
+ * Try resolvers in order; first non-empty enrichment wins.
+ * Errors in one resolver are swallowed so later adapters still run.
+ */
+export declare function composeSourceResolvers(resolvers: readonly ResolveElementSource[]): ResolveElementSource;
+//# sourceMappingURL=compose.d.ts.map

package/dist/source/adapters/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEpG;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GACzC,oBAAoB,CActB"}

package/dist/source/adapters/compose.js

@@ -0,0 +1,21 @@
+/**
+ * Try resolvers in order; first non-empty enrichment wins.
+ * Errors in one resolver are swallowed so later adapters still run.
+ */
+export function composeSourceResolvers(resolvers) {
+    return async (el) => {
+        for (const resolve of resolvers) {
+            try {
+                const enrichment = await resolve(el);
+                if (enrichment?.component || (enrichment?.owners && enrichment.owners.length > 0)) {
+                    return enrichment;
+                }
+            }
+            catch {
+                // try next adapter
+            }
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/source/adapters/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/source/adapters/compose.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA0C;IAE1C,OAAO,KAAK,EAAE,EAAW,EAAgD,EAAE;QACzE,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,UAAU,EAAE,SAAS,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;oBAClF,OAAO,UAAU,CAAC;gBACpB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/source/adapters/createSourceResolver.d.ts

@@ -0,0 +1,28 @@
+import type { ResolveElementSource } from "../../plugins/elementTarget.js";
+import { type SourceFrameworkChoice, type SourceFrameworkId } from "./detect.js";
+export type CreateSourceResolverOptions = {
+    /**
+     * Which adapter(s) to use.
+     * - `"auto"` (default): try adapters in detected order
+     * - `"react"` | `"next"` | `"vue"` | `"svelte"` | `"qwik"` | `"locator"`: single adapter
+     * - `"none"`: disable enrichment
+     */
+    framework?: SourceFrameworkChoice;
+    /**
+     * Full custom resolver. When set, wins over `framework` (config inject escape hatch).
+     */
+    resolveSource?: ResolveElementSource;
+    /** Override auto try-order (ignored when `framework` is a single id). */
+    order?: readonly SourceFrameworkId[];
+    /**
+     * Feedback bridge base path for Next Flight source fetches
+     * (e.g. `/api/t3-feedback`). Forwarded to {@link createNextSourceResolver}.
+     */
+    sourceEndpoint?: string;
+};
+/**
+ * Build a {@link ResolveElementSource} from serializable config and/or a custom inject.
+ * Returns `undefined` when enrichment is disabled (`framework: "none"`).
+ */
+export declare function createSourceResolver(options?: CreateSourceResolverOptions): ResolveElementSource | undefined;
+//# sourceMappingURL=createSourceResolver.d.ts.map

package/dist/source/adapters/createSourceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSourceResolver.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/createSourceResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAQrB,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAwBF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,GAAG,SAAS,CA2BlC"}

package/dist/source/adapters/createSourceResolver.js

@@ -0,0 +1,59 @@
+import { composeSourceResolvers } from "./compose.js";
+import { detectFrameworkOnElement, detectFrameworkOrder, } from "./detect.js";
+import { createLocatorSourceResolver } from "./locator.js";
+import { createNextSourceResolver } from "./next.js";
+import { createQwikSourceResolver } from "./qwik.js";
+import { createReactSourceResolver } from "./react.js";
+import { createSvelteSourceResolver } from "./svelte.js";
+import { createVueSourceResolver } from "./vue.js";
+function adapterFor(id, options = {}) {
+    switch (id) {
+        case "react":
+            return createReactSourceResolver();
+        case "next":
+            return createNextSourceResolver({
+                ...(options.sourceEndpoint ? { sourceEndpoint: options.sourceEndpoint } : {}),
+            });
+        case "vue":
+            return createVueSourceResolver();
+        case "svelte":
+            return createSvelteSourceResolver();
+        case "qwik":
+            return createQwikSourceResolver();
+        case "locator":
+            return createLocatorSourceResolver();
+    }
+}
+/**
+ * Build a {@link ResolveElementSource} from serializable config and/or a custom inject.
+ * Returns `undefined` when enrichment is disabled (`framework: "none"`).
+ */
+export function createSourceResolver(options = {}) {
+    if (options.resolveSource)
+        return options.resolveSource;
+    const framework = options.framework ?? "auto";
+    if (framework === "none")
+        return undefined;
+    if (framework !== "auto") {
+        return adapterFor(framework, options);
+    }
+    const order = options.order?.length ? options.order : detectFrameworkOrder();
+    const resolvers = order.map((id) => adapterFor(id, options));
+    // Prefer the adapter that matches the clicked element when auto-ordering is ambiguous.
+    return async (el) => {
+        const onEl = detectFrameworkOnElement(el);
+        if (onEl) {
+            const preferred = adapterFor(onEl, options);
+            try {
+                const hit = await preferred(el);
+                if (hit?.component || (hit?.owners && hit.owners.length > 0))
+                    return hit;
+            }
+            catch {
+                /* fall through to compose */
+            }
+        }
+        return composeSourceResolvers(resolvers)(el);
+    };
+}
+//# sourceMappingURL=createSourceResolver.js.map

package/dist/source/adapters/createSourceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSourceResolver.js","sourceRoot":"","sources":["../../../src/source/adapters/createSourceResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GAGrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAuBnD,SAAS,UAAU,CACjB,EAAqB,EACrB,UAAuC,EAAE;IAEzC,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,OAAO;YACV,OAAO,yBAAyB,EAAE,CAAC;QACrC,KAAK,MAAM;YACT,OAAO,wBAAwB,CAAC;gBAC9B,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9E,CAAC,CAAC;QACL,KAAK,KAAK;YACR,OAAO,uBAAuB,EAAE,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,0BAA0B,EAAE,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,wBAAwB,EAAE,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,2BAA2B,EAAE,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,OAAO,CAAC,aAAa,CAAC;IAExD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAE3C,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC7E,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7D,uFAAuF;IACvF,OAAO,KAAK,EAAE,EAAE,EAAE,EAAE;QAClB,MAAM,IAAI,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,GAAG,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBAAE,OAAO,GAAG,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC"}

package/dist/source/adapters/detect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Heuristic framework detection for ordering / diagnostics.
+ * Prefer explicit config when the app is multi-framework or detection is ambiguous.
+ */
+export type SourceFrameworkId = "react" | "next" | "vue" | "svelte" | "qwik" | "locator";
+export type SourceFrameworkChoice = SourceFrameworkId | "auto" | "none";
+/** Page-level Next.js markers (App Router / Pages Router / Turbopack chunks). */
+export declare function pageLooksLikeNext(doc?: Document | null): boolean;
+/**
+ * Probe a single element (and a few ancestors) for framework ownership markers.
+ * React fibers on a Next page resolve to `"next"` so the Turbopack-aware adapter runs.
+ */
+export declare function detectFrameworkOnElement(el: Element): SourceFrameworkId | null;
+/**
+ * App-level hints from globals + a light DOM scan.
+ * Returns preferred try-order (may list multiple when islands coexist).
+ */
+export declare function detectFrameworkOrder(doc?: Document | null): SourceFrameworkId[];
+export declare function isSourceFrameworkChoice(value: unknown): value is SourceFrameworkChoice;
+/** @internal used by tests */
+export declare function defaultFrameworkOrder(): readonly SourceFrameworkId[];
+//# sourceMappingURL=detect.d.ts.map

package/dist/source/adapters/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAsCxE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,QAAQ,GAAG,IAAwD,GACvE,OAAO,CAST;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAc9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,QAAQ,GAAG,IAAwD,GACvE,iBAAiB,EAAE,CAgCrB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAWtF;AAED,8BAA8B;AAC9B,wBAAgB,qBAAqB,IAAI,SAAS,iBAAiB,EAAE,CAEpE"}

package/dist/source/adapters/detect.js

@@ -0,0 +1,133 @@
+/**
+ * Heuristic framework detection for ordering / diagnostics.
+ * Prefer explicit config when the app is multi-framework or detection is ambiguous.
+ */
+const DEFAULT_ORDER = [
+    "qwik",
+    "locator",
+    "next",
+    "react",
+    "vue",
+    "svelte",
+];
+function elementLooksLikeReact(el) {
+    for (const key of Object.keys(el)) {
+        if (key.startsWith("__reactFiber$") || key.startsWith("__reactInternalInstance$")) {
+            return true;
+        }
+    }
+    return false;
+}
+function elementLooksLikeVue(el) {
+    const record = el;
+    return Boolean(record.__vueParentComponent || record.__vue__);
+}
+function elementLooksLikeSvelte(el) {
+    const record = el;
+    return Boolean(record.__svelte_meta);
+}
+function elementLooksLikeQwik(el) {
+    return el.hasAttribute("data-qwik-inspector");
+}
+function elementLooksLikeLocator(el) {
+    return el.hasAttribute("data-locatorjs") || el.hasAttribute("data-locator-id");
+}
+/** Page-level Next.js markers (App Router / Pages Router / Turbopack chunks). */
+export function pageLooksLikeNext(doc = typeof document !== "undefined" ? document : null) {
+    if (typeof window !== "undefined") {
+        const w = window;
+        if (w.__NEXT_DATA__ || w.__NEXT_P || w.next)
+            return true;
+    }
+    if (!doc)
+        return false;
+    if (doc.getElementById("__NEXT_DATA__"))
+        return true;
+    if (doc.querySelector('script[src*="/_next/"]'))
+        return true;
+    return false;
+}
+/**
+ * Probe a single element (and a few ancestors) for framework ownership markers.
+ * React fibers on a Next page resolve to `"next"` so the Turbopack-aware adapter runs.
+ */
+export function detectFrameworkOnElement(el) {
+    let current = el;
+    for (let i = 0; i < 8 && current; i += 1) {
+        // Attribute-based adapters first — cheap and unambiguous.
+        if (elementLooksLikeQwik(current))
+            return "qwik";
+        if (elementLooksLikeLocator(current))
+            return "locator";
+        if (elementLooksLikeReact(current)) {
+            return pageLooksLikeNext(current.ownerDocument) ? "next" : "react";
+        }
+        if (elementLooksLikeVue(current))
+            return "vue";
+        if (elementLooksLikeSvelte(current))
+            return "svelte";
+        current = current.parentElement;
+    }
+    return null;
+}
+/**
+ * App-level hints from globals + a light DOM scan.
+ * Returns preferred try-order (may list multiple when islands coexist).
+ */
+export function detectFrameworkOrder(doc = typeof document !== "undefined" ? document : null) {
+    const found = new Set();
+    if (pageLooksLikeNext(doc))
+        found.add("next");
+    if (typeof window !== "undefined") {
+        const w = window;
+        if (w.__REACT_DEVTOOLS_GLOBAL_HOOK__ || w.React)
+            found.add("react");
+        if (w.__VUE__ || w.Vue)
+            found.add("vue");
+        if (w.__SVELTE_HMR || w.__SAPPER__)
+            found.add("svelte");
+        if (w.qwik || w.__qwik_inspector)
+            found.add("qwik");
+    }
+    if (doc?.body) {
+        const sample = doc.body.querySelectorAll("*");
+        const limit = Math.min(sample.length, 80);
+        for (let i = 0; i < limit; i += 1) {
+            const el = sample[i];
+            if (elementLooksLikeQwik(el))
+                found.add("qwik");
+            if (elementLooksLikeLocator(el))
+                found.add("locator");
+            if (elementLooksLikeReact(el)) {
+                if (pageLooksLikeNext(doc))
+                    found.add("next");
+                else
+                    found.add("react");
+            }
+            if (elementLooksLikeVue(el))
+                found.add("vue");
+            if (elementLooksLikeSvelte(el))
+                found.add("svelte");
+            if (found.size >= DEFAULT_ORDER.length)
+                break;
+        }
+    }
+    if (found.size === 0)
+        return [...DEFAULT_ORDER];
+    return DEFAULT_ORDER.filter((id) => found.has(id));
+}
+export function isSourceFrameworkChoice(value) {
+    return (value === "react" ||
+        value === "next" ||
+        value === "vue" ||
+        value === "svelte" ||
+        value === "qwik" ||
+        value === "locator" ||
+        value === "auto" ||
+        value === "none");
+}
+/** @internal used by tests */
+export function defaultFrameworkOrder() {
+    return DEFAULT_ORDER;
+}
+//# sourceMappingURL=detect.js.map

package/dist/source/adapters/detect.js.map

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

package/dist/source/adapters/index.d.ts

@@ -0,0 +1,18 @@
+export type { SourceFrameworkChoice, SourceFrameworkId } from "./detect.js";
+export { defaultFrameworkOrder, detectFrameworkOnElement, detectFrameworkOrder, isSourceFrameworkChoice, pageLooksLikeNext, } from "./detect.js";
+export { composeSourceResolvers } from "./compose.js";
+export type { CreateSourceResolverOptions } from "./createSourceResolver.js";
+export { createSourceResolver } from "./createSourceResolver.js";
+export type { ReactSourceResolverOptions } from "./react.js";
+export { createFiberStackSourceResolver, createReactSourceResolver, findCompositeFiber, } from "./react.js";
+export type { NextSourceResolverOptions } from "./next.js";
+export { createNextSourceResolver, flightPagePathMatchesUrl, flightPagePathToAppFile, normalizeNextSourcePath, parseNextFlightPagePaths, pickNextFlightPagePath, } from "./next.js";
+export type { VueSourceResolverOptions } from "./vue.js";
+export { createVueSourceResolver } from "./vue.js";
+export type { SvelteSourceResolverOptions } from "./svelte.js";
+export { createSvelteSourceResolver } from "./svelte.js";
+export type { QwikSourceResolverOptions } from "./qwik.js";
+export { createQwikSourceResolver, parseQwikInspectorValue } from "./qwik.js";
+export type { LocatorSourceResolverOptions } from "./locator.js";
+export { createLocatorSourceResolver, parseLocatorValue } from "./locator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/source/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEnD,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAE9E,YAAY,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/source/adapters/index.js

@@ -0,0 +1,10 @@
+export { defaultFrameworkOrder, detectFrameworkOnElement, detectFrameworkOrder, isSourceFrameworkChoice, pageLooksLikeNext, } from "./detect.js";
+export { composeSourceResolvers } from "./compose.js";
+export { createSourceResolver } from "./createSourceResolver.js";
+export { createFiberStackSourceResolver, createReactSourceResolver, findCompositeFiber, } from "./react.js";
+export { createNextSourceResolver, flightPagePathMatchesUrl, flightPagePathToAppFile, normalizeNextSourcePath, parseNextFlightPagePaths, pickNextFlightPagePath, } from "./next.js";
+export { createVueSourceResolver } from "./vue.js";
+export { createSvelteSourceResolver } from "./svelte.js";
+export { createQwikSourceResolver, parseQwikInspectorValue } from "./qwik.js";
+export { createLocatorSourceResolver, parseLocatorValue } from "./locator.js";
+//# sourceMappingURL=index.js.map

package/dist/source/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/source/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG9E,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/source/adapters/locator.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentSourceLocation, ResolveElementSource } from "../../plugins/elementTarget.js";
+export type LocatorSourceResolverOptions = {
+    getLocatorValue?: (el: Element) => string | null;
+};
+/**
+ * Parse LocatorJS-style `path/to/File.tsx:line:col` (or `…:line`).
+ */
+export declare function parseLocatorValue(raw: string): ComponentSourceLocation | undefined;
+/**
+ * LocatorJS / `@locator/babel-jsx` enrichment (React, Solid, … when the Babel plugin is on).
+ * Reads `data-locatorjs` / `data-locator-id` — no runtime framework bridge needed.
+ */
+export declare function createLocatorSourceResolver(options?: LocatorSourceResolverOptions): ResolveElementSource;
+//# sourceMappingURL=locator.d.ts.map

package/dist/source/adapters/locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/locator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAMxC,MAAM,MAAM,4BAA4B,GAAG;IACzC,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAoClF;AAUD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,oBAAoB,CAetB"}

package/dist/source/adapters/locator.js

@@ -0,0 +1,69 @@
+import { normalizeSourcePath } from "../sourceMap.js";
+/** Common LocatorJS / babel-jsx attribute names. */
+const ATTRS = ["data-locatorjs", "data-locator-id"];
+/**
+ * Parse LocatorJS-style `path/to/File.tsx:line:col` (or `…:line`).
+ */
+export function parseLocatorValue(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    // Sometimes Locator stores JSON; prefer plain path:line:col.
+    if (trimmed.startsWith("{")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed.fileName && parsed.lineNumber) {
+                return {
+                    fileName: normalizeSourcePath(parsed.fileName),
+                    line: parsed.lineNumber,
+                    ...(parsed.columnNumber != null ? { column: parsed.columnNumber } : {}),
+                };
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const match = /^(.*?):(\d+)(?::(\d+))?$/.exec(trimmed);
+    if (!match)
+        return undefined;
+    const file = match[1]?.trim();
+    const line = Number(match[2]);
+    const column = match[3] != null ? Number(match[3]) : undefined;
+    if (!file || !Number.isFinite(line) || line < 1)
+        return undefined;
+    return {
+        fileName: normalizeSourcePath(file),
+        line,
+        ...(column != null && Number.isFinite(column) ? { column } : {}),
+    };
+}
+function readAttr(el) {
+    for (const name of ATTRS) {
+        const v = el.getAttribute(name);
+        if (v)
+            return v;
+    }
+    return null;
+}
+/**
+ * LocatorJS / `@locator/babel-jsx` enrichment (React, Solid, … when the Babel plugin is on).
+ * Reads `data-locatorjs` / `data-locator-id` — no runtime framework bridge needed.
+ */
+export function createLocatorSourceResolver(options = {}) {
+    const getValue = options.getLocatorValue ?? readAttr;
+    return async (el) => {
+        let current = el;
+        for (let i = 0; i < 12 && current; i += 1) {
+            const raw = getValue(current);
+            if (raw) {
+                const component = parseLocatorValue(raw);
+                if (component)
+                    return { component };
+            }
+            current = current.parentElement;
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=locator.js.map

package/dist/source/adapters/locator.js.map

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

package/dist/source/adapters/next.d.ts

@@ -0,0 +1,46 @@
+import type { ResolveElementSource } from "../../plugins/elementTarget.js";
+import { type ReactSourceResolverOptions } from "./react.js";
+export type NextSourceResolverOptions = ReactSourceResolverOptions & {
+    /**
+     * When fiber enrichment finds nothing (typical for pure RSC HTML), fall back
+     * to the Flight `pagePath` embedded in `__next_f` scripts. Default: true.
+     */
+    flightPageFallback?: boolean;
+    /**
+     * Load app-relative source (e.g. `app/[locale]/page.tsx`) for JSX line
+     * matching after a Flight file hit. Defaults to GET `{endpoint}/source?file=`.
+     */
+    fetchSourceFile?: (appRelativeFile: string) => Promise<string | null>;
+    /**
+     * Feedback bridge base path used by the default `fetchSourceFile`
+     * (e.g. `/api/t3-feedback` or `/__t3-feedback`).
+     */
+    sourceEndpoint?: string;
+};
+export { flightPagePathMatchesUrl, flightPagePathToAppFile, parseNextFlightPagePaths, pickNextFlightPagePath, } from "./nextFlight.js";
+/**
+ * Strip Turbopack `[project]/` and leading `apps/<pkg>/` so paths line up with
+ * an open-in-editor root pointed at the Next app (e.g. `apps/b2b`).
+ * Workspace packages (`packages/…`) stay monorepo-relative — pair with a
+ * workspace-rooted editor template when opening those files.
+ */
+export declare function normalizeNextSourcePath(fileName: string): string;
+/**
+ * Next.js (Turbopack / webpack) source enrichment.
+ *
+ * Same fiber + `_debugStack` bridge as React, but:
+ * - walks stack frames until the mapped source is an app file (skips
+ *   `react-jsx-runtime` / `node_modules` — React 19's `react-stack-top-frame`
+ *   is created inside the JSX runtime, and Next serves it as a compiled chunk
+ *   URL that passes a naive "first app frame" filter);
+ * - prefers the DOM node's host-fiber `_debugStack` (JSX call site) before the
+ *   composite — Next client roots hydrated from RSC often lack a useful stack
+ *   on the component fiber itself;
+ * - when there is no client fiber (pure Server Component HTML), falls back to
+ *   the Flight `pagePath` and matches the element's tag/classes to a JSX line
+ *   in that file (via optional `/source` bridge);
+ * - normalizes Turbopack `file:///…/apps/<pkg>/…` paths to app-relative paths
+ *   for `cursor://` / open-in-editor templates rooted at the Next app.
+ */
+export declare function createNextSourceResolver(options?: NextSourceResolverOptions): ResolveElementSource;
+//# sourceMappingURL=next.d.ts.map

package/dist/source/adapters/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAkC,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAO7F,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG;IACnE;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMhE;AA8ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,oBAAoB,CAmBtB"}