@frmwrkd/snag-anchor 0.1.0

package/dist/babel/plugin.js

@@ -0,0 +1,272 @@
+/**
+ * The JSX visitor. This is tier 0, and tier 0 is the product.
+ *
+ * ## Written from scratch, on purpose
+ *
+ * doc 03 §2.1 **[V — verified against React source]**: React 19 **removed**
+ * `fiber._debugSource`. `jsxDEV`'s `source` argument was dropped in 19.0/19.1
+ * and removed from the signature entirely in 19.2, and `createElement`
+ * explicitly strips `__source`/`__self`. `@babel/preset-react` now defaults
+ * `developmentSourceSelf` to `false` for exactly that reason.
+ *
+ * That break took out `click-to-component`, `vite-plugin-react-click-to-component`,
+ * `react-dev-inspector`, `code-inspector`, `radon-ide` and LocatorJS's React
+ * path *simultaneously*. doc 02 §2.4: **do not depend on any of them.** Nothing
+ * in this file reads `_debugSource`, `__source`, `__self`, or imports any of
+ * those packages. It is a Babel visitor, and it is about forty lines.
+ *
+ * ## Two rules, kept separate — doc 02 §2.2
+ *
+ * 1. `data-snag="path:line:col"` goes on **intrinsic (lowercase) JSX elements
+ *    only** — `<div>`, `<button>`, `<input>`. Never on `<PromoField />`: a
+ *    `data-snag` prop on a component element is silently swallowed unless that
+ *    component happens to spread its props onto a DOM node, and an attribute
+ *    that lands nowhere is worse than no attribute, because the resolver cannot
+ *    tell the difference between "not stamped" and "stamped and dropped".
+ * 2. `data-snag-cmp` carries the nearest enclosing component name
+ *    (`./component-name.ts`).
+ *
+ * Fragments are skipped for free: `<>` parses to `JSXOpeningFragment`, a
+ * different node type this visitor never sees, and `<React.Fragment>` is a
+ * `JSXMemberExpression`, which is not intrinsic.
+ *
+ * ## Line and column semantics — read this before changing anything
+ *
+ * `line` is 1-based and points at the `<` of the element's **opening tag**.
+ * `col` is **1-based**: Babel reports `loc.start.column` 0-based, and this
+ * module adds one, because the consumer is `vscode://file/{path}:{line}:{col}`
+ * and every editor's "go to line:column" is 1-based. So the invariant a test
+ * can assert directly is:
+ *
+ *     sourceLines[line - 1].charAt(col - 1) === '<'
+ *
+ * `@frmwrkd/snag-core`'s `AnchorSchema` documents `col` as "0-based or 1-based per the
+ * emitting tool; stored verbatim, never recomputed" — this is the emitting
+ * tool, and this is the choice.
+ *
+ * ## Two call paths, one decision core
+ *
+ * `stampJsx()` is the string-splicing transform the unplugin uses. `default
+ * export` is a genuine Babel `PluginObj` for anyone wiring this into their own
+ * `babel.config.js` (React Native, Next's Babel path, Storybook). Both route
+ * every decision through `shouldStamp()` / `buildAttributes()`, so they cannot
+ * disagree — `test/parity.test.ts` asserts exactly that.
+ */
+import { parse } from '@babel/parser';
+import { jsxAttribute, jsxIdentifier, stringLiteral } from '@babel/types';
+import { MagicString } from '../magic-string.js';
+import { DEFAULT_ATTRIBUTE, DEFAULT_COMPONENT_ATTRIBUTE } from '../options.js';
+import { resolveRoot, toRepoRelative } from '../root.js';
+import { buildAttributes, renderAttributes } from '../stamp.js';
+import { resolveComponentName } from './component-name.js';
+import { walk } from './walk.js';
+export { buildAttributes, escapeAttributeValue } from '../stamp.js';
+/* ------------------------------------------------------- decision primitives */
+/**
+ * Babel's own `isCompatTag`: a JSX identifier is an intrinsic host element iff
+ * it starts with a lowercase ASCII letter. `<div>` and `<my-widget>` are
+ * intrinsic; `<Foo>`, `<_Foo>`, `<Foo.Bar>` and `<svg:circle>` are not.
+ */
+export function isIntrinsicTagName(name) {
+    return /^[a-z]/.test(name);
+}
+export function tagInfo(name) {
+    switch (name.type) {
+        case 'JSXIdentifier':
+            return { tag: name.name, intrinsic: isIntrinsicTagName(name.name) };
+        case 'JSXMemberExpression': {
+            const parts = [];
+            let cursor = name;
+            while (cursor.type === 'JSXMemberExpression') {
+                parts.unshift(cursor.property.name);
+                cursor = cursor.object;
+            }
+            if (cursor.type === 'JSXIdentifier')
+                parts.unshift(cursor.name);
+            // `<Foo.Bar>` is always a component reference, never a host element.
+            return { tag: parts.join('.'), intrinsic: false };
+        }
+        case 'JSXNamespacedName':
+            // `<svg:circle>` only reaches the DOM through `throwIfNamespace: false`
+            // and is vanishingly rare. Declining to stamp is the honest answer.
+            return { tag: `${name.namespace.name}:${name.name.name}`, intrinsic: false };
+        default:
+            return null;
+    }
+}
+function jsxAttributeName(node) {
+    if (node.type !== 'JSXAttribute')
+        return null;
+    const name = node.name;
+    return name.type === 'JSXIdentifier' ? name.name : `${name.namespace.name}:${name.name.name}`;
+}
+export function hasAttribute(node, attribute) {
+    return node.attributes.some((attr) => jsxAttributeName(attr) === attribute);
+}
+/**
+ * doc 02 §2.2: "Skip if a `data-snag` attribute already exists (user override
+ * wins)." Extended to the component attribute too, so `production: 'minimal'`
+ * — where `data-snag` is never emitted — respects an override just the same.
+ */
+export function shouldStamp(node, ctx) {
+    if (ctx.mode === 'off')
+        return false;
+    const info = tagInfo(node.name);
+    if (info === null)
+        return false;
+    if (ctx.intrinsicOnly && !info.intrinsic)
+        return false;
+    if (hasAttribute(node, ctx.attribute))
+        return false;
+    if (hasAttribute(node, ctx.componentAttribute))
+        return false;
+    return true;
+}
+/* --------------------------------------------------------------- the splice */
+export function parserPluginsFor(filename) {
+    const dot = filename.lastIndexOf('.');
+    const ext = dot === -1 ? '' : filename.slice(dot).toLowerCase();
+    const plugins = [];
+    // JSX is not valid in `.ts`/`.mts`/`.cts` — `<T>(x)` there is a type
+    // assertion, and enabling `jsx` would misparse it.
+    const jsxAllowed = ext !== '.ts' && ext !== '.mts' && ext !== '.cts';
+    if (jsxAllowed)
+        plugins.push('jsx');
+    if (ext === '.ts' || ext === '.tsx' || ext === '.mts' || ext === '.cts') {
+        plugins.push('typescript');
+    }
+    return plugins;
+}
+/**
+ * Collect every stamp site in an already-parsed file, in source order.
+ *
+ * The insertion offset is the end of the **last existing attribute**, or the
+ * end of the tag name when there are none. That places the injected attribute
+ * last, after any `{...props}` spread, so the stamp always wins: an element
+ * that receives a forwarded `data-snag` from a parent still reports the line it
+ * is actually written on. It also sidesteps arithmetic on `/>` vs `>`.
+ */
+export function collectStampSites(ast, ctx) {
+    const sites = [];
+    walk(ast, (node, ancestors) => {
+        if (node.type !== 'JSXOpeningElement')
+            return;
+        if (!shouldStamp(node, ctx))
+            return;
+        const loc = node.loc;
+        if (loc === null || loc === undefined)
+            return;
+        const last = node.attributes.length > 0 ? node.attributes[node.attributes.length - 1] : undefined;
+        const offset = last !== undefined ? last.end : node.name.end;
+        if (offset === null || offset === undefined)
+            return;
+        const info = tagInfo(node.name);
+        if (info === null)
+            return;
+        const line = loc.start.line;
+        const col = loc.start.column + 1; // Babel columns are 0-based; ours are not.
+        const component = resolveComponentName(ancestors);
+        const attributes = buildAttributes({ line, col, component }, ctx);
+        if (attributes.length === 0)
+            return;
+        sites.push({ offset, line, col, tag: info.tag, component, attributes });
+    });
+    return sites;
+}
+/**
+ * Transform a JSX/TSX source string.
+ *
+ * Returns `null` when nothing was stamped **and** when the file could not be
+ * parsed. A source transform that throws breaks the user's dev server; this one
+ * fails open and leaves the file exactly as it found it. The cost of a missed
+ * anchor is a tier-3 fallback; the cost of a thrown error is a broken build.
+ */
+export function stampJsx(code, ctx, filename) {
+    const name = filename ?? ctx.file;
+    let ast;
+    try {
+        ast = parse(code, {
+            sourceType: 'unambiguous',
+            allowReturnOutsideFunction: true,
+            allowAwaitOutsideFunction: true,
+            allowSuperOutsideMethod: true,
+            plugins: parserPluginsFor(name),
+        });
+    }
+    catch {
+        return null;
+    }
+    const sites = collectStampSites(ast, ctx);
+    if (sites.length === 0)
+        return null;
+    const s = new MagicString(code);
+    for (const site of sites) {
+        s.appendLeft(site.offset, renderAttributes(site.attributes));
+    }
+    return {
+        code: s.toString(),
+        map: s.generateMap({ hires: true, source: name, includeContent: false }),
+        sites,
+    };
+}
+const CONTEXT_KEY = 'snag-anchor:context';
+/** Ancestors of `path`, outermost first — the shape `resolveComponentName` wants. */
+function ancestorNodes(path) {
+    const out = [];
+    let current = path.parentPath;
+    while (current !== null) {
+        out.push(current.node);
+        current = current.parentPath;
+    }
+    return out.reverse();
+}
+/**
+ * `@frmwrkd/snag-anchor/babel` — usable directly in a `babel.config.js`:
+ *
+ * ```js
+ * plugins: [['@frmwrkd/snag-anchor/babel', { mode: 'full' }]]
+ * ```
+ */
+export default function snagAnchorBabelPlugin() {
+    return {
+        name: 'snag-anchor',
+        pre() {
+            const opts = (this.opts ?? {});
+            const filename = this.filename;
+            const root = resolveRoot(opts.root);
+            const file = opts.file ?? (filename !== undefined ? toRepoRelative(filename, root) : '');
+            // No filename and no explicit `file` means we cannot name a path. Emitting
+            // `":42:7"` would be a fabricated anchor, so stamp nothing at all.
+            const requestedMode = opts.mode ?? 'full';
+            const mode = requestedMode === 'full' && file === '' ? 'off' : requestedMode;
+            const ctx = {
+                file,
+                attribute: opts.attribute ?? DEFAULT_ATTRIBUTE,
+                componentAttribute: opts.componentAttribute ?? DEFAULT_COMPONENT_ATTRIBUTE,
+                intrinsicOnly: opts.intrinsicOnly ?? true,
+                mode,
+            };
+            this.set(CONTEXT_KEY, ctx);
+        },
+        visitor: {
+            JSXOpeningElement(path, state) {
+                const ctx = state.get(CONTEXT_KEY);
+                if (ctx === undefined)
+                    return;
+                if (!shouldStamp(path.node, ctx))
+                    return;
+                const loc = path.node.loc;
+                if (loc === null || loc === undefined)
+                    return;
+                const component = resolveComponentName(ancestorNodes(path));
+                const attributes = buildAttributes({ line: loc.start.line, col: loc.start.column + 1, component }, ctx);
+                if (attributes.length === 0)
+                    return;
+                for (const attr of attributes) {
+                    path.node.attributes.push(jsxAttribute(jsxIdentifier(attr.name), stringLiteral(attr.value)));
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/babel/plugin.js.map

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

package/dist/babel/walk.d.ts

@@ -0,0 +1,8 @@
+import type { Node } from '@babel/types';
+export type NodeVisitor = (node: Node, ancestors: readonly Node[]) => void;
+/**
+ * @param visit Called for every node, with `ancestors` **outermost first**.
+ *   The array is the live traversal stack — read it, do not retain it.
+ */
+export declare function walk(root: Node, visit: NodeVisitor): void;
+//# sourceMappingURL=walk.d.ts.map

package/dist/babel/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/babel/walk.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;AAU3E;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAyBzD"}

package/dist/babel/walk.js

@@ -0,0 +1,50 @@
+/**
+ * A depth-first AST walk that hands each visitor an ancestor stack.
+ *
+ * `@babel/traverse` would do this, but it is a CommonJS module whose ESM
+ * default export is the well-known `traverse.default ?? traverse` footgun, it
+ * builds a `NodePath` and a `Scope` for every node, and it requeues nodes on
+ * mutation. None of that is needed here: this transform never mutates the AST
+ * (it splices the *source string*) and it only needs the ancestor chain of JSX
+ * opening elements.
+ *
+ * Child keys come from `@babel/types`' own `VISITOR_KEYS`, so the walk visits
+ * exactly the nodes Babel considers children — no hand-maintained key table to
+ * drift out of date when a new syntax node lands.
+ */
+import { VISITOR_KEYS } from '@babel/types';
+function isNode(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.type === 'string');
+}
+/**
+ * @param visit Called for every node, with `ancestors` **outermost first**.
+ *   The array is the live traversal stack — read it, do not retain it.
+ */
+export function walk(root, visit) {
+    const ancestors = [];
+    const step = (node) => {
+        visit(node, ancestors);
+        const keys = VISITOR_KEYS[node.type];
+        if (keys === undefined || keys.length === 0)
+            return;
+        ancestors.push(node);
+        const record = node;
+        for (const key of keys) {
+            const value = record[key];
+            if (Array.isArray(value)) {
+                for (const child of value) {
+                    if (isNode(child))
+                        step(child);
+                }
+            }
+            else if (isNode(value)) {
+                step(value);
+            }
+        }
+        ancestors.pop();
+    };
+    step(root);
+}
+//# sourceMappingURL=walk.js.map

package/dist/babel/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/babel/walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAK5C,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,IAAU,EAAE,KAAkB;IACjD,MAAM,SAAS,GAAW,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,CAAC,IAAU,EAAQ,EAAE;QAChC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEvB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEpD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAA0C,CAAC;QAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;oBAC1B,IAAI,MAAM,CAAC,KAAK,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,CAAC;AACb,CAAC"}

package/dist/devtools-json.d.ts

@@ -0,0 +1,45 @@
+export declare const DEVTOOLS_JSON_PATH = "/.well-known/appspecific/com.chrome.devtools.json";
+export interface DevtoolsJson {
+    workspace: {
+        /** Absolute, POSIX-normalised project root. */
+        root: string;
+        uuid: string;
+    };
+}
+/**
+ * UUID v5 (SHA-1, name-based) — deterministic for a given name.
+ *
+ * `node:crypto.randomUUID()` is v4 and would change on every restart, which is
+ * the one thing this value must not do.
+ */
+export declare function uuidV5(name: string, namespace?: string): string;
+/** Stable for a given absolute root; different for every other root. */
+export declare function devtoolsWorkspaceUuid(absoluteRoot: string): string;
+export declare function devtoolsJson(absoluteRoot: string): DevtoolsJson;
+/**
+ * The slice of a Node request/response this middleware actually touches. Typed
+ * structurally so the module does not need `connect`, `vite` or `webpack-dev-server`
+ * types — all three pass something that satisfies this.
+ */
+export interface DevtoolsJsonRequest {
+    url?: string | undefined;
+    method?: string | undefined;
+}
+export interface DevtoolsJsonResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): unknown;
+    end(chunk?: string): unknown;
+}
+export type DevtoolsJsonMiddleware = (req: DevtoolsJsonRequest, res: DevtoolsJsonResponse, next: () => void) => void;
+/**
+ * Connect-style middleware. Responds to GET (and HEAD) on
+ * `/.well-known/appspecific/com.chrome.devtools.json`; delegates everything
+ * else untouched.
+ *
+ * Register it **unmounted** — `server.middlewares.use(mw)`, never
+ * `server.middlewares.use(PATH, mw)`. Connect rewrites `req.url` to `/` for a
+ * mounted middleware, and a handler that also answered `/` would swallow the
+ * application's index route.
+ */
+export declare function createDevtoolsJsonMiddleware(absoluteRoot: string): DevtoolsJsonMiddleware;
+//# sourceMappingURL=devtools-json.d.ts.map

package/dist/devtools-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-json.d.ts","sourceRoot":"","sources":["../src/devtools-json.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,kBAAkB,sDAAsD,CAAC;AAEtF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QACT,+CAA+C;QAC/C,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AA4BD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAsB,GAAG,MAAM,CAY9E;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAO/D;AAID;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,mBAAmB,EACxB,GAAG,EAAE,oBAAoB,EACzB,IAAI,EAAE,MAAM,IAAI,KACb,IAAI,CAAC;AAEV;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,sBAAsB,CAyBzF"}

package/dist/devtools-json.js

@@ -0,0 +1,117 @@
+/**
+ * `/.well-known/appspecific/com.chrome.devtools.json` — doc 02 §2.5.
+ *
+ * ```json
+ * { "workspace": { "root": "/Users/theo/dev/myapp", "uuid": "<stable-uuid>" } }
+ * ```
+ *
+ * ## Why this exists at all
+ *
+ * Every `data-snag` attribute is repo-relative (`src/App.tsx:42:7`) so that the
+ * same string works in a container, on a preview deploy, and on a teammate's
+ * machine. But Claude Code has to *open a file*, and `editor_scheme`'s `{abs}`
+ * placeholder needs an absolute path. This endpoint is the one place the
+ * absolute root is published, once, per origin — the extension fetches it from
+ * the page origin and joins the two halves back together.
+ *
+ * It is served by **this plugin, not by snagd**: the extension reads it from
+ * the app's origin, so it must come from the app's dev server. It only works on
+ * localhost, which is exactly the case that matters.
+ *
+ * ## Why the uuid must be stable across restarts
+ *
+ * Chrome DevTools binds a workspace folder to this uuid. A fresh uuid on every
+ * `vite dev` would silently unbind the folder and the developer would re-approve
+ * the workspace on every restart. So it is not random: it is a **UUID v5**
+ * derived deterministically from the absolute project root, which means the
+ * same checkout always produces the same uuid and two different checkouts never
+ * collide.
+ */
+import { createHash } from 'node:crypto';
+export const DEVTOOLS_JSON_PATH = '/.well-known/appspecific/com.chrome.devtools.json';
+/** RFC 4122 namespace ID for URLs — the namespace UUID v5 is derived under. */
+const URL_NAMESPACE = '6ba7b811-9dad-11d1-80b4-00c04fd430c8';
+function uuidToBytes(uuid) {
+    const hex = uuid.replace(/-/g, '');
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i += 1) {
+        bytes[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToUuid(bytes) {
+    const hex = [];
+    for (let i = 0; i < 16; i += 1) {
+        hex.push((bytes[i] ?? 0).toString(16).padStart(2, '0'));
+    }
+    return [
+        hex.slice(0, 4).join(''),
+        hex.slice(4, 6).join(''),
+        hex.slice(6, 8).join(''),
+        hex.slice(8, 10).join(''),
+        hex.slice(10, 16).join(''),
+    ].join('-');
+}
+/**
+ * UUID v5 (SHA-1, name-based) — deterministic for a given name.
+ *
+ * `node:crypto.randomUUID()` is v4 and would change on every restart, which is
+ * the one thing this value must not do.
+ */
+export function uuidV5(name, namespace = URL_NAMESPACE) {
+    const hash = createHash('sha1');
+    hash.update(uuidToBytes(namespace));
+    hash.update(Buffer.from(name, 'utf8'));
+    const digest = new Uint8Array(hash.digest()).slice(0, 16);
+    // Version 5 …
+    digest[6] = ((digest[6] ?? 0) & 0x0f) | 0x50;
+    // … and the RFC 4122 variant.
+    digest[8] = ((digest[8] ?? 0) & 0x3f) | 0x80;
+    return bytesToUuid(digest);
+}
+/** Stable for a given absolute root; different for every other root. */
+export function devtoolsWorkspaceUuid(absoluteRoot) {
+    return uuidV5(`snag:${absoluteRoot}`);
+}
+export function devtoolsJson(absoluteRoot) {
+    return {
+        workspace: {
+            root: absoluteRoot,
+            uuid: devtoolsWorkspaceUuid(absoluteRoot),
+        },
+    };
+}
+/**
+ * Connect-style middleware. Responds to GET (and HEAD) on
+ * `/.well-known/appspecific/com.chrome.devtools.json`; delegates everything
+ * else untouched.
+ *
+ * Register it **unmounted** — `server.middlewares.use(mw)`, never
+ * `server.middlewares.use(PATH, mw)`. Connect rewrites `req.url` to `/` for a
+ * mounted middleware, and a handler that also answered `/` would swallow the
+ * application's index route.
+ */
+export function createDevtoolsJsonMiddleware(absoluteRoot) {
+    const body = JSON.stringify(devtoolsJson(absoluteRoot));
+    return (req, res, next) => {
+        const method = (req.method ?? 'GET').toUpperCase();
+        if (method !== 'GET' && method !== 'HEAD') {
+            next();
+            return;
+        }
+        const url = req.url ?? '';
+        const pathname = url.split('?')[0]?.split('#')[0] ?? '';
+        if (pathname !== DEVTOOLS_JSON_PATH) {
+            next();
+            return;
+        }
+        res.statusCode = 200;
+        res.setHeader('content-type', 'application/json; charset=utf-8');
+        // Localhost only, but the extension fetches it cross-origin from its own
+        // context; without this the fetch is opaque and the root is unreadable.
+        res.setHeader('access-control-allow-origin', '*');
+        res.setHeader('cache-control', 'no-store');
+        res.end(method === 'HEAD' ? '' : body);
+    };
+}
+//# sourceMappingURL=devtools-json.js.map

package/dist/devtools-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-json.js","sourceRoot":"","sources":["../src/devtools-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,mDAAmD,CAAC;AAUtF,+EAA+E;AAC/E,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAE7D,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAiB;IACpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,YAAoB,aAAa;IACpE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE1D,cAAc;IACd,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,8BAA8B;IAC9B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE7C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,OAAO,MAAM,CAAC,QAAQ,YAAY,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO;QACL,SAAS,EAAE;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,qBAAqB,CAAC,YAAY,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AA0BD;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAAC,YAAoB;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IAExD,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1C,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YACpC,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;QACjE,yEAAyE;QACzE,wEAAwE;QACxE,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esbuild.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./options.js").AnchorOptions | undefined) => import("unplugin").EsbuildPlugin;
+export default _default;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":";AAUA,wBAAoD"}

package/dist/esbuild.js

@@ -0,0 +1,11 @@
+/**
+ * ```ts
+ * import { build } from 'esbuild';
+ * import snagAnchor from '@frmwrkd/snag-anchor/esbuild';
+ * await build({ plugins: [snagAnchor()] });
+ * ```
+ */
+import { createEsbuildPlugin } from 'unplugin';
+import { unpluginFactory } from './index.js';
+export default createEsbuildPlugin(unpluginFactory);
+//# sourceMappingURL=esbuild.js.map

package/dist/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAe,mBAAmB,CAAC,eAAe,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import type { UnpluginFactory, UnpluginInstance } from 'unplugin';
+import type { AnchorOptions } from './options.js';
+export declare const ANCHOR_ATTRIBUTE = "data-snag";
+export declare const COMPONENT_ATTRIBUTE = "data-snag-cmp";
+export type { AnchorOptions, AnchorMode, ResolvedAnchorOptions } from './options.js';
+export { createFilter, DEFAULT_ATTRIBUTE, DEFAULT_COMPONENT_ATTRIBUTE, DEFAULT_EXCLUDE, DEFAULT_INCLUDE, isProductionEnv, normaliseId, resolveMode, resolveOptions, } from './options.js';
+export { findGitRoot, resolveRoot, toPosix, toRepoRelative } from './root.js';
+export type { AnchorAttribute, AnchorSourceMap, StampContext, StampSite } from './stamp.js';
+export { buildAttributes, escapeAttributeValue, renderAttributes } from './stamp.js';
+export { transformSource, stampContextFor } from './transform.js';
+export type { AnchorTransformResult } from './transform.js';
+export { default as snagAnchorBabelPlugin, stampJsx } from './babel/plugin.js';
+export type { SnagBabelPluginOptions, StampResult } from './babel/plugin.js';
+export { resolveComponentName } from './babel/component-name.js';
+export { stampVue, sfcComponentName } from './vue/transform.js';
+export type { VueStampResult } from './vue/transform.js';
+export { createDevtoolsJsonMiddleware, devtoolsJson, devtoolsWorkspaceUuid, DEVTOOLS_JSON_PATH, uuidV5, } from './devtools-json.js';
+export type { DevtoolsJson, DevtoolsJsonMiddleware } from './devtools-json.js';
+export declare const unpluginFactory: UnpluginFactory<AnchorOptions | undefined, false>;
+export declare const unplugin: UnpluginInstance<AnchorOptions | undefined, false>;
+export default unplugin;
+/**
+ * `emitRepoMap` (doc 02 §2.3, "run @frmwrkd/snag-repomap after build") is accepted and
+ * carried on `ResolvedAnchorOptions`, but nothing is wired to it yet:
+ * `@frmwrkd/snag-repomap` is milestone M3 and is not a dependency of this package. The
+ * option exists so a user's config does not have to change when it lands.
+ */
+export declare const EMIT_REPO_MAP_IS_WIRED = false;
+/** Re-exported so integrators can assert the endpoint without importing the module path. */
+export declare const DEVTOOLS_JSON_ENDPOINT = "/.well-known/appspecific/com.chrome.devtools.json";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKlE,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,cAAc,CAAC;AAGzE,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAgB/E,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,aAAa,GAAG,SAAS,EAAE,KAAK,CA8C7E,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,gBAAgB,CAAC,aAAa,GAAG,SAAS,EAAE,KAAK,CACvC,CAAC;AAElC,eAAe,QAAQ,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,sDAAqB,CAAC"}