@rose42/feedback-capture 0.1.0

package/dist/source/adapters/svelte.js

@@ -0,0 +1,64 @@
+import { normalizeSourcePath } from "../sourceMap.js";
+function readMeta(el) {
+    const record = el;
+    const meta = record.__svelte_meta;
+    if (meta && typeof meta === "object")
+        return meta;
+    return null;
+}
+function findMetaChain(el, getMeta, maxOwners) {
+    const chain = [];
+    let current = el;
+    const seen = new Set();
+    while (current && chain.length < maxOwners + 1) {
+        if (seen.has(current))
+            break;
+        seen.add(current);
+        const meta = getMeta(current);
+        if (meta?.loc?.file)
+            chain.push(meta);
+        current = current.parentElement;
+    }
+    return chain;
+}
+function locationFromMeta(meta) {
+    const file = meta.loc?.file?.trim();
+    if (!file)
+        return undefined;
+    const line = meta.loc?.line && meta.loc.line > 0 ? meta.loc.line : 1;
+    const column = meta.loc?.column;
+    const name = meta.component?.name;
+    return {
+        fileName: normalizeSourcePath(file),
+        line,
+        ...(column != null && column >= 0 ? { column } : {}),
+        ...(name ? { name } : {}),
+    };
+}
+/**
+ * Svelte DEV enrichment via `__svelte_meta` (present when compiled with `dev: true`).
+ * File/line often already point at the `.svelte` source — maps are optional.
+ */
+export function createSvelteSourceResolver(options = {}) {
+    const maxOwners = options.maxOwners ?? 5;
+    const getMeta = options.getMeta ?? readMeta;
+    return async (el) => {
+        const chain = findMetaChain(el, getMeta, maxOwners);
+        if (chain.length === 0)
+            return undefined;
+        const component = locationFromMeta(chain[0]);
+        const owners = [];
+        for (const meta of chain.slice(1, maxOwners + 1)) {
+            const loc = locationFromMeta(meta);
+            if (loc)
+                owners.push(loc);
+        }
+        if (!component && owners.length === 0)
+            return undefined;
+        return {
+            ...(component ? { component } : {}),
+            ...(owners.length > 0 ? { owners } : {}),
+        };
+    };
+}
+//# sourceMappingURL=svelte.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { ResolveElementSource } from "../../plugins/elementTarget.js";
+type VueComponentInstance = {
+    type?: {
+        name?: string;
+        __name?: string;
+        __file?: string;
+        displayName?: string;
+    };
+    parent?: VueComponentInstance | null;
+    vnode?: {
+        type?: unknown;
+    };
+};
+export type VueSourceResolverOptions = {
+    /** Max parent components to attach as owners (default: 5). */
+    maxOwners?: number;
+    /** Override instance lookup (tests). */
+    getInstance?: (el: Element) => VueComponentInstance | null;
+};
+/**
+ * Vue 3 (and Vue 2 `__vue__`) source enrichment via `__vueParentComponent` + `__file`.
+ * File paths usually come from `@vitejs/plugin-vue` without needing sourcemaps;
+ * line stays `1` unless a future stack/map refine is added.
+ */
+export declare function createVueSourceResolver(options?: VueSourceResolverOptions): ResolveElementSource;
+export {};
+//# sourceMappingURL=vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/vue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAGxC,KAAK,oBAAoB,GAAG;IAC1B,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,oBAAoB,GAAG,IAAI,CAAC;CAC5D,CAAC;AA+CF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAsBtB"}

package/dist/source/adapters/vue.js

@@ -0,0 +1,76 @@
+import { normalizeSourcePath } from "../sourceMap.js";
+function readVueInstance(el) {
+    let current = el;
+    while (current) {
+        const record = current;
+        const inst = record.__vueParentComponent;
+        if (inst && typeof inst === "object")
+            return inst;
+        // Vue 2
+        const vue2 = record.__vue__;
+        if (vue2 && typeof vue2 === "object")
+            return vue2;
+        current = current.parentElement;
+    }
+    return null;
+}
+function componentName(inst) {
+    const t = inst.type;
+    if (!t)
+        return undefined;
+    return t.displayName || t.name || t.__name || undefined;
+}
+function locationFromInstance(inst) {
+    const file = inst.type?.__file?.trim();
+    if (!file)
+        return undefined;
+    const name = componentName(inst);
+    return {
+        fileName: normalizeSourcePath(file),
+        // Vite Vue SFC `__file` is the module path; exact JSX/template line is rarely present.
+        line: 1,
+        ...(name ? { name } : {}),
+    };
+}
+function ownerChain(inst, maxOwners) {
+    const chain = [];
+    let current = inst.parent ?? null;
+    const seen = new Set();
+    while (current && chain.length < maxOwners) {
+        if (seen.has(current))
+            break;
+        seen.add(current);
+        if (current.type?.__file || componentName(current))
+            chain.push(current);
+        current = current.parent ?? null;
+    }
+    return chain;
+}
+/**
+ * Vue 3 (and Vue 2 `__vue__`) source enrichment via `__vueParentComponent` + `__file`.
+ * File paths usually come from `@vitejs/plugin-vue` without needing sourcemaps;
+ * line stays `1` unless a future stack/map refine is added.
+ */
+export function createVueSourceResolver(options = {}) {
+    const maxOwners = options.maxOwners ?? 5;
+    const getInstance = options.getInstance ?? readVueInstance;
+    return async (el) => {
+        const inst = getInstance(el);
+        if (!inst)
+            return undefined;
+        const component = locationFromInstance(inst);
+        const owners = [];
+        for (const owner of ownerChain(inst, maxOwners)) {
+            const loc = locationFromInstance(owner);
+            if (loc)
+                owners.push(loc);
+        }
+        if (!component && owners.length === 0)
+            return undefined;
+        return {
+            ...(component ? { component } : {}),
+            ...(owners.length > 0 ? { owners } : {}),
+        };
+    };
+}
+//# sourceMappingURL=vue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../../src/source/adapters/vue.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAoBtD,SAAS,eAAe,CAAC,EAAW;IAClC,IAAI,OAAO,GAAmB,EAAE,CAAC;IACjC,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,OAA6C,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,oBAAoB,CAAC;QACzC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAA4B,CAAC;QAC1E,QAAQ;QACR,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAA4B,CAAC;QAC1E,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,IAA0B;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IACpB,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;AAC1D,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA0B;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC;QACnC,uFAAuF;QACvF,IAAI,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAA0B,EAAE,SAAiB;IAC/D,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC7C,OAAO,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,MAAM;QAC7B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAoC,EAAE;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,eAAe,CAAC;IAE3D,OAAO,KAAK,EAAE,EAAW,EAAgD,EAAE;QACzE,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE5B,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAExD,OAAO;YACL,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/source/locateJsx.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Best-effort line number for a DOM node inside a JSX/TSX source file.
+ * Used when Flight only gives a page file (no fiber / sourcemap for RSC HTML).
+ */
+export type LocateJsxHints = {
+    tagName: string;
+    /** Space-separated class names from the element. */
+    className?: string;
+    /** Optional text / attribute hints (href, etc.). */
+    textSnippet?: string;
+    href?: string;
+};
+export type LocateJsxResult = {
+    line: number;
+    column: number;
+    score: number;
+};
+/**
+ * Find the best JSX opening-tag line for `hints` inside `source`.
+ * Scores class-name overlap and optional href/text presence in a small window.
+ */
+export declare function locateJsxInSource(source: string, hints: LocateJsxHints): LocateJsxResult | undefined;
+/** Read `class` from an Element as a space-separated string. */
+export declare function classNameOf(el: Element): string | undefined;
+//# sourceMappingURL=locateJsx.d.ts.map

package/dist/source/locateJsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locateJsx.d.ts","sourceRoot":"","sources":["../../src/source/locateJsx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAUF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,GACpB,eAAe,GAAG,SAAS,CA6C7B;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG3D"}

package/dist/source/locateJsx.js

@@ -0,0 +1,67 @@
+/**
+ * Best-effort line number for a DOM node inside a JSX/TSX source file.
+ * Used when Flight only gives a page file (no fiber / sourcemap for RSC HTML).
+ */
+function tokenizeClasses(className) {
+    if (!className)
+        return [];
+    return className
+        .split(/\s+/)
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0 && c.length < 80);
+}
+/**
+ * Find the best JSX opening-tag line for `hints` inside `source`.
+ * Scores class-name overlap and optional href/text presence in a small window.
+ */
+export function locateJsxInSource(source, hints) {
+    const tag = hints.tagName.trim().toLowerCase();
+    if (!tag || !/^[a-z][a-z0-9-]*$/.test(tag))
+        return undefined;
+    const classes = tokenizeClasses(hints.className);
+    const lines = source.split(/\r?\n/);
+    const tagRe = new RegExp(`<${tag}(?:\\s|>|/)`, "i");
+    let best;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (!tagRe.test(line))
+            continue;
+        // Window covering multi-line JSX opening tags.
+        const windowText = lines.slice(i, Math.min(lines.length, i + 8)).join("\n");
+        let score = 1;
+        for (const cls of classes) {
+            if (windowText.includes(cls))
+                score += 3;
+        }
+        if (hints.href) {
+            const href = hints.href.trim();
+            if (href && windowText.includes(href))
+                score += 5;
+        }
+        // Text only as a weak signal (RSC often interpolates `{expr}`).
+        const snippet = hints.textSnippet?.trim();
+        if (snippet && snippet.length >= 12) {
+            const needle = snippet.slice(0, 40);
+            if (windowText.includes(needle))
+                score += 2;
+        }
+        const colMatch = /</.exec(line);
+        const column = colMatch ? colMatch.index + 1 : 1;
+        const candidate = { line: i + 1, column, score };
+        if (!best || candidate.score > best.score)
+            best = candidate;
+    }
+    // Require at least one class/href hit when classes were available — otherwise
+    // the first `<div` in the file wins and every child collapses to the same line.
+    if (!best)
+        return undefined;
+    if (classes.length > 0 && best.score < 4)
+        return undefined;
+    return best;
+}
+/** Read `class` from an Element as a space-separated string. */
+export function classNameOf(el) {
+    const value = el.getAttribute("class")?.trim();
+    return value || undefined;
+}
+//# sourceMappingURL=locateJsx.js.map

package/dist/source/locateJsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locateJsx.js","sourceRoot":"","sources":["../../src/source/locateJsx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,SAAS,eAAe,CAAC,SAA6B;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,SAAS;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,KAAqB;IAErB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,aAAa,EAAE,GAAG,CAAC,CAAC;IAEpD,IAAI,IAAiC,CAAC;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAEhC,+CAA+C;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QACpD,CAAC;QAED,gEAAgE;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;QAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,GAAG,SAAS,CAAC;IAC9D,CAAC;IAED,8EAA8E;IAC9E,gFAAgF;IAChF,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,EAAW;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC"}

package/dist/source/rankSourceHierarchy.d.ts

@@ -0,0 +1,25 @@
+import type { ComponentSourceLocation, ElementSourceEnrichment } from "../plugins/elementTarget.js";
+/** Enrichment after ranking usage vs leaf (UI primitives). */
+export type RankedSourceEnrichment = ElementSourceEnrichment & {
+    /**
+     * Innermost definition when it differs from {@link ElementSourceEnrichment.component}
+     * (e.g. `Link` while `component` is `Header`).
+     */
+    leaf?: ComponentSourceLocation;
+};
+export declare function sameSourceLocation(a: ComponentSourceLocation, b: ComponentSourceLocation): boolean;
+/**
+ * Design-system / shadcn-style primitives — prefer a parent usage site as primary.
+ * Matches `components/ui/…`, `packages/ui/…`, and bare `ui/button.tsx`-style paths.
+ */
+export declare function isUiPrimitiveSource(loc: ComponentSourceLocation): boolean;
+/**
+ * Rank a leaf + owner chain for feedback:
+ * - `component` = primary (nearest non-primitive when leaf is a UI primitive)
+ * - `leaf` = innermost when different from primary
+ * - `owners` = remaining outer ancestors
+ *
+ * If `leaf` is already set (post-merge), the enrichment is returned as-is.
+ */
+export declare function rankSourceHierarchy(enrichment: ElementSourceEnrichment | undefined): RankedSourceEnrichment | undefined;
+//# sourceMappingURL=rankSourceHierarchy.d.ts.map

package/dist/source/rankSourceHierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankSourceHierarchy.d.ts","sourceRoot":"","sources":["../../src/source/rankSourceHierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEpG,8DAA8D;AAC9D,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D;;;OAGG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,uBAAuB,EAC1B,CAAC,EAAE,uBAAuB,GACzB,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAKzE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,uBAAuB,GAAG,SAAS,GAC9C,sBAAsB,GAAG,SAAS,CAiCpC"}

package/dist/source/rankSourceHierarchy.js

@@ -0,0 +1,60 @@
+export function sameSourceLocation(a, b) {
+    return (a.fileName === b.fileName &&
+        a.line === b.line &&
+        (a.column ?? 0) === (b.column ?? 0) &&
+        (a.name ?? "") === (b.name ?? ""));
+}
+/**
+ * Design-system / shadcn-style primitives — prefer a parent usage site as primary.
+ * Matches `components/ui/…`, `packages/ui/…`, and bare `ui/button.tsx`-style paths.
+ */
+export function isUiPrimitiveSource(loc) {
+    const file = loc.fileName.replace(/\\/g, "/");
+    if (/(^|\/)(components\/ui|packages\/ui)\//.test(file))
+        return true;
+    if (/(^|\/)ui\/[A-Za-z][\w-]*\.[cm]?[tj]sx?$/.test(file))
+        return true;
+    return false;
+}
+/**
+ * Rank a leaf + owner chain for feedback:
+ * - `component` = primary (nearest non-primitive when leaf is a UI primitive)
+ * - `leaf` = innermost when different from primary
+ * - `owners` = remaining outer ancestors
+ *
+ * If `leaf` is already set (post-merge), the enrichment is returned as-is.
+ */
+export function rankSourceHierarchy(enrichment) {
+    if (!enrichment)
+        return undefined;
+    // Already ranked by mergeSourceEnrichment (or a prior pass).
+    if (enrichment.leaf && enrichment.component) {
+        return enrichment;
+    }
+    const chain = [];
+    if (enrichment.component)
+        chain.push(enrichment.component);
+    for (const owner of enrichment.owners ?? []) {
+        if (!chain.some((loc) => sameSourceLocation(loc, owner)))
+            chain.push(owner);
+    }
+    if (chain.length === 0) {
+        return enrichment.component || enrichment.owners ? enrichment : undefined;
+    }
+    const leaf = chain[0];
+    let primaryIdx = 0;
+    if (isUiPrimitiveSource(leaf)) {
+        const usageIdx = chain.findIndex((loc, i) => i > 0 && !isUiPrimitiveSource(loc));
+        if (usageIdx >= 0)
+            primaryIdx = usageIdx;
+    }
+    const primary = chain[primaryIdx];
+    const owners = chain.filter((_, i) => i !== 0 && i !== primaryIdx);
+    const leafDistinct = !sameSourceLocation(primary, leaf);
+    return {
+        component: primary,
+        ...(leafDistinct ? { leaf } : {}),
+        ...(owners.length > 0 ? { owners } : {}),
+    };
+}
+//# sourceMappingURL=rankSourceHierarchy.js.map

package/dist/source/rankSourceHierarchy.js.map

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

package/dist/source/reactSourceResolver.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from `./adapters/react.js` or package root instead. */
+export { createReactSourceResolver, findCompositeFiber, type ReactSourceResolverOptions, } from "./adapters/react.js";
+//# sourceMappingURL=reactSourceResolver.d.ts.map

package/dist/source/reactSourceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactSourceResolver.d.ts","sourceRoot":"","sources":["../../src/source/reactSourceResolver.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC"}

package/dist/source/reactSourceResolver.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from `./adapters/react.js` or package root instead. */
+export { createReactSourceResolver, findCompositeFiber, } from "./adapters/react.js";
+//# sourceMappingURL=reactSourceResolver.js.map

package/dist/source/reactSourceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactSourceResolver.js","sourceRoot":"","sources":["../../src/source/reactSourceResolver.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC"}

package/dist/source/sourceMap.d.ts

@@ -0,0 +1,41 @@
+export type GeneratedPosition = {
+    /** Absolute URL of the generated (served) script. */
+    url: string;
+    line: number;
+    column: number;
+    /** Function / component name from the stack frame, when present. */
+    name?: string;
+};
+export type OriginalPosition = {
+    fileName: string;
+    line: number;
+    column: number;
+    name?: string;
+};
+/** Clear fetch / consumer caches (tests). */
+export declare function clearSourceMapCaches(): void;
+/**
+ * Strip Vite/query noise and leading `/@fs/` / protocol so agents see a
+ * repo-friendly path when possible.
+ */
+export declare function normalizeSourcePath(fileName: string): string;
+/**
+ * Map a generated stack position to original source via Source Map V3.
+ * Falls back to a normalized URL path when no map is available.
+ */
+export declare function resolveOriginalPosition(position: GeneratedPosition, options?: {
+    fetchFn?: typeof fetch;
+}): Promise<OriginalPosition>;
+/**
+ * Parse V8-style stack frames into generated positions.
+ * Supports `at name (url:line:col)` and `at url:line:col`.
+ */
+export declare function parseStackFrames(stack: string): GeneratedPosition[];
+/** Prefer app frames over React / bundler internals. */
+export declare function isAppFrame(frame: GeneratedPosition): boolean;
+/**
+ * After Source Map V3, reject React / Next / package internals so callers can
+ * walk to the next stack frame (Next `_debugStack` often maps to jsx-runtime).
+ */
+export declare function isAppSourcePath(fileName: string): boolean;
+//# sourceMappingURL=sourceMap.d.ts.map

package/dist/source/sourceMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceMap.d.ts","sourceRoot":"","sources":["../../src/source/sourceMap.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAaF,6CAA6C;AAC7C,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C;AAiDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwB5D;AAyCD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACvC,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA6BnE;AAWD,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAS5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUzD"}