@ytspar/devbar 1.15.0 → 1.18.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { BUTTON_COLORS, CATEGORY_COLORS, DEVBAR_THEME, DEVBAR_THEME_LIGHT, type
 export { DebugLogger, normalizeDebugConfig } from './debug.js';
 export { destroyGlobalDevBar, earlyConsoleCapture, GlobalDevBar, getGlobalDevBar, initGlobalDevBar, } from './GlobalDevBar.js';
 export { getHtml2Canvas } from './lazy/index.js';
+export { type AnnotateOptions, activateAnnotateMode, buildSelector, type DevbarPin, type DevbarPinKind, registerAnnotateControl, submitPin, viewportBucket, } from './modules/annotate.js';
 export { type NetworkEntry, NetworkMonitor, type NetworkState, } from './network.js';
 export { type AppVersionPluginOptions, appVersionPlugin } from './plugins/appVersion.js';
 export { type GitBranchPluginOptions, gitBranchPlugin } from './plugins/gitBranch.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAE7F,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,KAAK,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,UAAU,EACf,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,6 +15,8 @@ export { DebugLogger, normalizeDebugConfig } from './debug.js';
 export { destroyGlobalDevBar, earlyConsoleCapture, GlobalDevBar, getGlobalDevBar, initGlobalDevBar, } from './GlobalDevBar.js';
 // Lazy loading utilities
 export { getHtml2Canvas } from './lazy/index.js';
+// Live visual-feedback annotation (DEV-4516)
+export { activateAnnotateMode, buildSelector, registerAnnotateControl, submitPin, viewportBucket, } from './modules/annotate.js';
 // Network monitoring utilities
 export { NetworkMonitor, } from './network.js';
 // Official plugins

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,sDAAsD;AAEtD,4DAA4D;AAC5D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,2CAA2C,CAAC;AACnD,kFAAkF;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAC7F,gCAAgC;AAChC,OAAO,EAIL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,0CAA0C;AAC1C,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAGlB,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,gBAAgB,CAAC;AACxB,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC/D,yBAAyB;AACzB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,+BAA+B;AAC/B,OAAO,EAEL,cAAc,GAEf,MAAM,cAAc,CAAC;AACtB,mBAAmB;AACnB,OAAO,EAAgC,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAA+B,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAGL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,wBAAwB;AACxB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAGhB,kBAAkB,EAElB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AACvB,+BAA+B;AAC/B,OAAO,EAEL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EAGd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAiBtB,oCAAoC;AACpC,OAAO,EAEL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,sDAAsD;AAEtD,4DAA4D;AAC5D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,2CAA2C,CAAC;AACnD,kFAAkF;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAC7F,gCAAgC;AAChC,OAAO,EAIL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,0CAA0C;AAC1C,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAGlB,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,gBAAgB,CAAC;AACxB,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC/D,yBAAyB;AACzB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,6CAA6C;AAC7C,OAAO,EAEL,oBAAoB,EACpB,aAAa,EAGb,uBAAuB,EACvB,SAAS,EACT,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,+BAA+B;AAC/B,OAAO,EAEL,cAAc,GAEf,MAAM,cAAc,CAAC;AACtB,mBAAmB;AACnB,OAAO,EAAgC,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAA+B,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAGL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,wBAAwB;AACxB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAGhB,kBAAkB,EAElB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AACvB,+BAA+B;AAC/B,OAAO,EAEL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EAGd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAiBtB,oCAAoC;AACpC,OAAO,EAEL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/modules/annotate.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Annotate mode (DEV-4516) — live, in-context visual feedback.
+ *
+ * The companion surface to the `el-visual-evidence` review UI: instead of
+ * annotating captured screenshots after the fact, the devbar lets you pin
+ * region comments directly onto the *running* page during local authoring.
+ * Each pin is POSTed to the `el-visual-evidence review-ui --listen` server,
+ * which merges it into the same `feedback.json` the active Claude Code session
+ * reads on its next capture→fix cycle.
+ *
+ * Pin shape matches the visual-evidence `FeedbackPin` contract (source:"devbar")
+ * documented in `tools/cli/el-visual-evidence/README.md`. We don't import the
+ * type (separate repo) — we construct JSON matching the documented shape.
+ *
+ * Transport: the devbar runs on the host app's origin (e.g. localhost:3003) and
+ * the listener is on another port, so the POST is cross-origin. We send it
+ * fire-and-forget with `mode: "no-cors"` + a `text/plain` body — a "simple"
+ * request that needs no CORS preflight; the review-ui server `JSON.parse`s the
+ * body regardless of content-type. The response is opaque (unreadable), which is
+ * fine for a one-way pin submission.
+ *
+ * Overlay nodes carry `data-devbar` / `data-devbar-overlay` so the
+ * visual-evidence capture pipeline's `HIDE_DEVBAR_CSS` still suppresses them.
+ */
+import type { DevBarControl } from '../types.js';
+export type DevbarPinKind = 'fix' | 'question' | 'praise';
+export interface DevbarPin {
+    id: string;
+    source: 'devbar';
+    kind: DevbarPinKind;
+    comment: string;
+    route?: string;
+    domSelector?: string;
+    viewport?: 'mobile' | 'tablet' | 'desktop';
+    region?: {
+        x: number;
+        y: number;
+        w?: number;
+        h?: number;
+    };
+    createdAt?: string;
+}
+export interface AnnotateOptions {
+    /** review-ui --listen feedback endpoint. Default: http://localhost:3846/api/feedback. */
+    endpoint?: string;
+    /**
+     * Called when annotate mode exits from *inside* the overlay (Escape key), so
+     * the owner (e.g. the toolbar control) can resync its state. Not called when
+     * the owner drives the returned cleanup itself.
+     */
+    onExit?: () => void;
+}
+/**
+ * Build a reasonably-stable CSS selector for an element: prefer `#id`, else a
+ * tag(.class) + `:nth-of-type` path walked up to a capped depth or the nearest
+ * id'd ancestor. Good enough to point a human/Claude at the element; not
+ * guaranteed unique across dynamic re-renders.
+ */
+export declare function buildSelector(el: Element, maxDepth?: number): string;
+/** Viewport bucket from the current window width — mirrors the capture viewports. */
+export declare function viewportBucket(width: number): DevbarPin['viewport'];
+/** POST a pin fire-and-forget to the review-ui listener (no-cors, text/plain). */
+export declare function submitPin(pin: DevbarPin, endpoint: string): Promise<void>;
+/**
+ * Activate annotate mode: hover-highlight elements, click to drop a pin, fill a
+ * comment popover, submit to the listener. Returns a cleanup function that
+ * removes all overlays + listeners. Mirrors `activateRulerMode`'s lifecycle.
+ */
+export declare function activateAnnotateMode(opts?: AnnotateOptions): () => void;
+/**
+ * Register the "Annotate" toolbar control. `register` is injected (typically
+ * `GlobalDevBar.registerControl`) so this module stays free of a GlobalDevBar
+ * import (no cycle). Clicking toggles annotate mode; the control re-registers
+ * itself to flip its `active` highlight. Press Esc (or click again) to exit.
+ */
+export declare function registerAnnotateControl(register: (control: DevBarControl) => void, opts?: AnnotateOptions): void;
+//# sourceMappingURL=annotate.d.ts.map

package/dist/modules/annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../src/modules/annotate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CA4B/D;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAInE;AAOD,kFAAkF;AAClF,wBAAsB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/E;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,eAAoB,GAAG,MAAM,IAAI,CAwP3E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EAC1C,IAAI,GAAE,eAAoB,GACzB,IAAI,CA6BN"}

package/dist/modules/annotate.js

@@ -0,0 +1,368 @@
+/**
+ * Annotate mode (DEV-4516) — live, in-context visual feedback.
+ *
+ * The companion surface to the `el-visual-evidence` review UI: instead of
+ * annotating captured screenshots after the fact, the devbar lets you pin
+ * region comments directly onto the *running* page during local authoring.
+ * Each pin is POSTed to the `el-visual-evidence review-ui --listen` server,
+ * which merges it into the same `feedback.json` the active Claude Code session
+ * reads on its next capture→fix cycle.
+ *
+ * Pin shape matches the visual-evidence `FeedbackPin` contract (source:"devbar")
+ * documented in `tools/cli/el-visual-evidence/README.md`. We don't import the
+ * type (separate repo) — we construct JSON matching the documented shape.
+ *
+ * Transport: the devbar runs on the host app's origin (e.g. localhost:3003) and
+ * the listener is on another port, so the POST is cross-origin. We send it
+ * fire-and-forget with `mode: "no-cors"` + a `text/plain` body — a "simple"
+ * request that needs no CORS preflight; the review-ui server `JSON.parse`s the
+ * body regardless of content-type. The response is opaque (unreadable), which is
+ * fine for a one-way pin submission.
+ *
+ * Overlay nodes carry `data-devbar` / `data-devbar-overlay` so the
+ * visual-evidence capture pipeline's `HIDE_DEVBAR_CSS` still suppresses them.
+ */
+const DEFAULT_ENDPOINT = 'http://localhost:3846/api/feedback';
+const KINDS = ['fix', 'question', 'praise'];
+/**
+ * Build a reasonably-stable CSS selector for an element: prefer `#id`, else a
+ * tag(.class) + `:nth-of-type` path walked up to a capped depth or the nearest
+ * id'd ancestor. Good enough to point a human/Claude at the element; not
+ * guaranteed unique across dynamic re-renders.
+ */
+export function buildSelector(el, maxDepth = 5) {
+    if (el.id)
+        return `#${CSS.escape(el.id)}`;
+    const parts = [];
+    let node = el;
+    let depth = 0;
+    while (node && node.nodeType === 1 && depth < maxDepth) {
+        if (node.id) {
+            parts.unshift(`#${CSS.escape(node.id)}`);
+            break;
+        }
+        let part = node.tagName.toLowerCase();
+        const cls = (node.getAttribute('class') ?? '')
+            .split(/\s+/)
+            .filter((c) => c && !c.startsWith('data-'))
+            .slice(0, 1)
+            .map((c) => `.${CSS.escape(c)}`)
+            .join('');
+        part += cls;
+        const parent = node.parentElement;
+        if (parent) {
+            const siblings = Array.from(parent.children).filter((c) => c.tagName === node?.tagName);
+            if (siblings.length > 1)
+                part += `:nth-of-type(${siblings.indexOf(node) + 1})`;
+        }
+        parts.unshift(part);
+        node = node.parentElement;
+        depth += 1;
+    }
+    return parts.join(' > ');
+}
+/** Viewport bucket from the current window width — mirrors the capture viewports. */
+export function viewportBucket(width) {
+    if (width <= 600)
+        return 'mobile';
+    if (width <= 1024)
+        return 'tablet';
+    return 'desktop';
+}
+function randomId() {
+    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto)
+        return `pin_${crypto.randomUUID()}`;
+    return `pin_${Math.floor(Math.random() * 1e9).toString(16)}`;
+}
+/** POST a pin fire-and-forget to the review-ui listener (no-cors, text/plain). */
+export async function submitPin(pin, endpoint) {
+    try {
+        await fetch(endpoint, {
+            method: 'POST',
+            mode: 'no-cors',
+            headers: { 'content-type': 'text/plain' },
+            body: JSON.stringify({ pins: [pin] }),
+        });
+    }
+    catch {
+        // Opaque/no-cors responses never reject for HTTP status; this only fires on
+        // network failure (listener not running). Swallow — annotate is best-effort.
+    }
+}
+const NS = 'http://www.w3.org/1999/xhtml';
+/**
+ * Activate annotate mode: hover-highlight elements, click to drop a pin, fill a
+ * comment popover, submit to the listener. Returns a cleanup function that
+ * removes all overlays + listeners. Mirrors `activateRulerMode`'s lifecycle.
+ */
+export function activateAnnotateMode(opts = {}) {
+    const endpoint = opts.endpoint ?? DEFAULT_ENDPOINT;
+    const overlay = document.createElementNS(NS, 'div');
+    overlay.setAttribute('data-devbar', 'annotate-overlay');
+    overlay.setAttribute('data-devbar-overlay', '');
+    Object.assign(overlay.style, {
+        position: 'fixed',
+        inset: '0',
+        zIndex: '2147483646',
+        pointerEvents: 'none',
+    });
+    const hover = document.createElement('div');
+    hover.setAttribute('data-devbar-overlay', '');
+    Object.assign(hover.style, {
+        position: 'fixed',
+        border: '2px solid #2f81f7',
+        background: 'rgba(47,129,247,0.12)',
+        borderRadius: '3px',
+        pointerEvents: 'none',
+        transition: 'all 60ms ease-out',
+        display: 'none',
+    });
+    overlay.appendChild(hover);
+    const markers = document.createElement('div');
+    markers.setAttribute('data-devbar-overlay', '');
+    Object.assign(markers.style, { position: 'fixed', inset: '0', pointerEvents: 'none' });
+    overlay.appendChild(markers);
+    document.body.appendChild(overlay);
+    document.body.style.cursor = 'crosshair';
+    let popoverOpen = false;
+    // Short-circuit hover work when the pointer stays within the same element —
+    // avoids a forced layout (getBoundingClientRect) on every mousemove pixel.
+    let lastTarget = null;
+    function isDevbarEl(el) {
+        return !!el.closest('[data-devbar], [data-devbar-overlay], [data-devbar-tooltip], [data-devbar-ruler]');
+    }
+    function onMove(e) {
+        if (popoverOpen)
+            return;
+        const target = e.target;
+        if (!target || isDevbarEl(target)) {
+            hover.style.display = 'none';
+            lastTarget = null;
+            return;
+        }
+        if (target === lastTarget)
+            return;
+        lastTarget = target;
+        const r = target.getBoundingClientRect();
+        if (r.width === 0 && r.height === 0) {
+            hover.style.display = 'none';
+            return;
+        }
+        Object.assign(hover.style, {
+            display: 'block',
+            left: `${r.left}px`,
+            top: `${r.top}px`,
+            width: `${r.width}px`,
+            height: `${r.height}px`,
+        });
+    }
+    function onClick(e) {
+        if (popoverOpen)
+            return;
+        const target = e.target;
+        if (!target || isDevbarEl(target))
+            return;
+        e.preventDefault();
+        e.stopPropagation();
+        const r = target.getBoundingClientRect();
+        // Normalized position of the click within the element.
+        const rx = r.width ? (e.clientX - r.left) / r.width : 0.5;
+        const ry = r.height ? (e.clientY - r.top) / r.height : 0.5;
+        openPopover(target, e.clientX, e.clientY, rx, ry);
+    }
+    function onKey(e) {
+        if (e.key === 'Escape') {
+            e.preventDefault();
+            cleanup();
+            // Exit came from inside the overlay — let the owner (toolbar control)
+            // resync, so the Annotate button doesn't stay stuck in the active state.
+            opts.onExit?.();
+        }
+    }
+    function openPopover(target, px, py, rx, ry) {
+        popoverOpen = true;
+        hover.style.display = 'none';
+        let kind = 'fix';
+        const pop = document.createElement('div');
+        pop.setAttribute('data-devbar-overlay', '');
+        Object.assign(pop.style, {
+            position: 'fixed',
+            left: `${Math.min(px, window.innerWidth - 300)}px`,
+            top: `${Math.min(py, window.innerHeight - 200)}px`,
+            zIndex: '2147483647',
+            width: '288px',
+            background: '#161b22',
+            color: '#e6edf3',
+            border: '1px solid #2f81f7',
+            borderRadius: '8px',
+            padding: '10px',
+            pointerEvents: 'auto',
+            font: '12px ui-monospace, monospace',
+            boxShadow: '0 8px 30px rgba(0,0,0,0.4)',
+        });
+        const kindRow = document.createElement('div');
+        Object.assign(kindRow.style, { display: 'flex', gap: '6px', marginBottom: '8px' });
+        const kindBtns = KINDS.map((k) => {
+            const b = document.createElement('button');
+            b.type = 'button';
+            b.textContent = k;
+            Object.assign(b.style, {
+                flex: '1',
+                padding: '5px',
+                borderRadius: '5px',
+                border: `1px solid ${k === kind ? '#2f81f7' : '#2d333b'}`,
+                background: k === kind ? 'rgba(47,129,247,0.25)' : '#1c2230',
+                color: 'inherit',
+                cursor: 'pointer',
+                font: 'inherit',
+            });
+            b.onclick = () => {
+                kind = k;
+                for (const [i, btn] of kindBtns.entries()) {
+                    const active = KINDS[i] === kind;
+                    btn.style.borderColor = active ? '#2f81f7' : '#2d333b';
+                    btn.style.background = active ? 'rgba(47,129,247,0.25)' : '#1c2230';
+                }
+            };
+            kindRow.appendChild(b);
+            return b;
+        });
+        const ta = document.createElement('textarea');
+        ta.placeholder = "Comment for Claude — e.g. 'this gap should be 16px'";
+        Object.assign(ta.style, {
+            width: '100%',
+            minHeight: '56px',
+            background: '#0d1117',
+            color: 'inherit',
+            border: '1px solid #2d333b',
+            borderRadius: '5px',
+            padding: '7px',
+            font: 'inherit',
+            resize: 'vertical',
+            boxSizing: 'border-box',
+        });
+        const actions = document.createElement('div');
+        Object.assign(actions.style, { display: 'flex', gap: '6px', marginTop: '8px' });
+        const save = document.createElement('button');
+        save.type = 'button';
+        save.textContent = 'Pin';
+        Object.assign(save.style, {
+            padding: '5px 12px',
+            borderRadius: '5px',
+            border: '1px solid #2f81f7',
+            background: '#2f81f7',
+            color: '#fff',
+            cursor: 'pointer',
+            fontWeight: '600',
+            font: 'inherit',
+        });
+        const cancel = document.createElement('button');
+        cancel.type = 'button';
+        cancel.textContent = 'Cancel';
+        Object.assign(cancel.style, {
+            padding: '5px 12px',
+            borderRadius: '5px',
+            border: '1px solid #2d333b',
+            background: '#1c2230',
+            color: 'inherit',
+            cursor: 'pointer',
+            font: 'inherit',
+        });
+        function closePopover() {
+            pop.remove();
+            popoverOpen = false;
+        }
+        cancel.onclick = closePopover;
+        save.onclick = () => {
+            const comment = ta.value.trim();
+            if (!comment)
+                return;
+            const pin = {
+                id: randomId(),
+                source: 'devbar',
+                kind,
+                comment,
+                route: window.location.pathname,
+                domSelector: buildSelector(target),
+                viewport: viewportBucket(window.innerWidth),
+                region: { x: Number(rx.toFixed(4)), y: Number(ry.toFixed(4)) },
+                createdAt: new Date().toISOString(),
+            };
+            void submitPin(pin, endpoint);
+            dropMarker(px, py, kind);
+            closePopover();
+        };
+        actions.append(save, cancel);
+        pop.append(kindRow, ta, actions);
+        overlay.appendChild(pop);
+        ta.focus();
+    }
+    function dropMarker(px, py, kind) {
+        const m = document.createElement('div');
+        m.setAttribute('data-devbar-overlay', '');
+        const color = kind === 'fix' ? '#f85149' : kind === 'question' ? '#a371f7' : '#3fb950';
+        Object.assign(m.style, {
+            position: 'fixed',
+            left: `${px}px`,
+            top: `${py}px`,
+            width: '14px',
+            height: '14px',
+            marginLeft: '-7px',
+            marginTop: '-7px',
+            borderRadius: '999px',
+            background: color,
+            border: '2px solid #fff',
+            pointerEvents: 'none',
+        });
+        markers.appendChild(m);
+    }
+    document.addEventListener('mousemove', onMove, true);
+    document.addEventListener('click', onClick, true);
+    document.addEventListener('keydown', onKey, true);
+    function cleanup() {
+        document.removeEventListener('mousemove', onMove, true);
+        document.removeEventListener('click', onClick, true);
+        document.removeEventListener('keydown', onKey, true);
+        overlay.remove();
+        document.body.style.cursor = '';
+    }
+    return cleanup;
+}
+/**
+ * Register the "Annotate" toolbar control. `register` is injected (typically
+ * `GlobalDevBar.registerControl`) so this module stays free of a GlobalDevBar
+ * import (no cycle). Clicking toggles annotate mode; the control re-registers
+ * itself to flip its `active` highlight. Press Esc (or click again) to exit.
+ */
+export function registerAnnotateControl(register, opts = {}) {
+    let cleanup = null;
+    function build() {
+        return {
+            id: 'annotate',
+            label: 'Annotate',
+            tooltip: 'Pin visual feedback for Claude (Esc to exit)',
+            active: cleanup !== null,
+            variant: 'info',
+            onClick: () => {
+                if (cleanup) {
+                    cleanup();
+                    cleanup = null;
+                }
+                else {
+                    // onExit fires when the user presses Esc inside the overlay; resync the
+                    // control so its active highlight clears without a wasted extra click.
+                    cleanup = activateAnnotateMode({
+                        ...opts,
+                        onExit: () => {
+                            cleanup = null;
+                            register(build());
+                        },
+                    });
+                }
+                register(build());
+            },
+        };
+    }
+    register(build());
+}
+//# sourceMappingURL=annotate.js.map

package/dist/modules/annotate.js.map

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

package/dist/modules/rendering/buttons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/buttons.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AA2B/D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,eAAe,CAoCjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAiJjG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAoE1E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAoCzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAyCxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA4CtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAiDvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAiGxE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA2DtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAiC1E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA2C/E"}
+{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/buttons.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AA2B/D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,eAAe,CAoCjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAiJjG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAoE1E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAoCzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAyCxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA4CtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAiDvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAoGxE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA2DtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAiC1E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CA2C/E"}

package/dist/modules/rendering/buttons.js

@@ -5,6 +5,7 @@ import { preloadAxe } from '../../accessibility.js';
 import { BUTTON_COLORS, CSS_COLORS, PALETTE, withAlpha } from '../../constants.js';
 import { resolveSaveLocation } from '../../settings.js';
 import { createSvgIcon, getButtonStyles } from '../../ui/index.js';
+import { isSafeNavigationUrl } from '../../utils.js';
 import { getDemoArtifactWarning, isDemoArtifactPath, isSweetlinkDemoMode } from '../demoMode.js';
 import { activateRulerMode } from '../ruler.js';
 import { copyPathToClipboard, handleA11yAudit, handleDocumentOutline, handlePageSchema, showDesignReviewConfirmation, } from '../screenshot.js';
@@ -436,8 +437,11 @@ export function createRecordButton(state) {
     });
     btn.onclick = (e) => {
         if (e.shiftKey && state.lastViewerPath && !isActive) {
-            // Open last viewer
-            window.open(state.lastViewerPath, '_blank');
+            // Open last viewer. lastViewerPath is validated at assignment, but guard
+            // here too — never window.open an unvalidated scheme (defense-in-depth).
+            if (isSafeNavigationUrl(state.lastViewerPath)) {
+                window.open(state.lastViewerPath, '_blank');
+            }
             return;
         }
         if (!state.ws || !state.sweetlinkConnected)