@slowcook-ai/review-overlay 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -11,6 +11,6 @@
  * decode review comments off the PR thread.
  */
 export { PAYLOAD_MARKER, PLATE_REPLY_MARKER, formatReviewComment, parseReviewComment, formatPlateReplyBlock, parsePlateReply, buildPayload, type ReviewCommentPayload, type ViewportInfo, type FormatArgs, type PlateReplyEntry, type PlateReplyPayload, type PlateReplyStatus, } from "./comment-format.js";
-export { extractSelector, resolveStoredSelector, resolveAnchor, extractA11yPath, resolveA11yPath, roleOf, type ExtractedSelector, type A11yPath, type A11ySeg, } from "./selector.js";
+export { extractSelector, resolveStoredSelector, resolveAnchor, extractA11yPath, resolveA11yPath, roleOf, isPillOffViewport, clampPillPosition, type ExtractedSelector, type A11yPath, type A11ySeg, } from "./selector.js";
 export { loadPat, savePat, clearPat, patStorageKey, submitComment, fetchOverlayComments, loadCachedComments, saveCachedComments, commentsCacheKey, fetchAllMockupPrs, fetchScenarioStats, loadCachedScenarioStats, saveCachedScenarioStats, scenarioStatsCacheKey, emptyStats, fetchPrLabels, addLabelsToPr, submitPrApproval, APPROVED_LABEL, type RepoCoord, type SubmitArgs, type SubmitResult, type SubmitOk, type SubmitErr, type OverlayCommentRecord, type ScenarioCommentStats, } from "./github.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,EACN,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -11,6 +11,6 @@
  * decode review comments off the PR thread.
  */
 export { PAYLOAD_MARKER, PLATE_REPLY_MARKER, formatReviewComment, parseReviewComment, formatPlateReplyBlock, parsePlateReply, buildPayload, } from "./comment-format.js";
-export { extractSelector, resolveStoredSelector, resolveAnchor, extractA11yPath, resolveA11yPath, roleOf, } from "./selector.js";
+export { extractSelector, resolveStoredSelector, resolveAnchor, extractA11yPath, resolveA11yPath, roleOf, isPillOffViewport, clampPillPosition, } from "./selector.js";
 export { loadPat, savePat, clearPat, patStorageKey, submitComment, fetchOverlayComments, loadCachedComments, saveCachedComments, commentsCacheKey, fetchAllMockupPrs, fetchScenarioStats, loadCachedScenarioStats, saveCachedScenarioStats, scenarioStatsCacheKey, emptyStats, fetchPrLabels, addLabelsToPr, submitPrApproval, APPROVED_LABEL, } from "./github.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,GAOb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,GAIP,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,GAQf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,GAOb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,GAQf,MAAM,aAAa,CAAC"}

package/dist/primitives.d.ts

@@ -0,0 +1,3 @@
+export { ReviewShell, localStorageStore, type ReviewShellProps, type ReviewComment, type ReviewCommentMeta, type CommentStore, type Corner, } from "./react/review-shell.js";
+export { usePrefersDark, detectPageDark, pillTheme, sheetTheme } from "./react/theme.js";
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,MAAM,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,8 @@
+// ── @slowcook-ai/review-overlay/primitives ──────────────────────────────────
+// The SHELL PRIMITIVES: generic, workflow-free review-surface building blocks.
+// OSS-specific shells (the vibe/plate LCR overlay, the Refine ReviewWidget)
+// and external consumers (dash's RefinePill → pm-/brand-assistant loop) build
+// on these. Nothing here knows about GitHub, PRs, stories, or agents.
+export { ReviewShell, localStorageStore, } from "./react/review-shell.js";
+export { usePrefersDark, detectPageDark, pillTheme, sheetTheme } from "./react/theme.js";
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,sEAAsE;AACtE,OAAO,EACL,WAAW,EACX,iBAAiB,GAMlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react/comet.d.ts

@@ -0,0 +1,30 @@
+import { type RefObject, type JSX } from "react";
+export interface CometLight {
+    /** viewport-space position of the (unseen) light, px. */
+    x: number;
+    y: number;
+    /** 0→1→0 intensity envelope over the comet's flight. */
+    alpha: number;
+    /** the light's colour as an "r,g,b" triplet — usually slowcook coral. */
+    rgb: string;
+}
+type Sub = (l: CometLight | null) => void;
+/** Subscribe to the shared comet light. The driver runs only while ≥1 subscriber. */
+export declare function subscribeComet(cb: Sub): () => void;
+export declare function useCometLight(): CometLight | null;
+/** The reflection an element shows for a given light position — a moving sheen
+ *  whose hotspot tracks the light, fading with distance, plus a border glint. */
+export declare function cometReflection(light: CometLight | null, rect: DOMRect | null): {
+    background: string;
+    boxShadow: string;
+    opacity: number;
+};
+/** Overlay that renders the comet reflection for the pill it's mounted into. It
+ *  subscribes to the light itself, so only THIS node re-renders per frame — the
+ *  parent pill stays put. Mount as an absolute, inset child of the pill. */
+export declare function CometSheen({ pillRef, radius }: {
+    pillRef: RefObject<HTMLElement | null>;
+    radius: number | string;
+}): JSX.Element;
+export {};
+//# sourceMappingURL=comet.d.ts.map

package/dist/react/comet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comet.d.ts","sourceRoot":"","sources":["../../src/react/comet.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAmD,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAElG,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;CACb;AAQD,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;AAqE1C,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,IAAI,CAQlD;AAED,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAIjD;AAED;iFACiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuB1I;AAED;;4EAE4E;AAC5E,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IAAE,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAoBhI"}

package/dist/react/comet.js

@@ -0,0 +1,151 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// A shared "comet light" — an INVISIBLE point of light that, every now and then,
+// streaks across the viewport. You never see the comet itself; you only see its
+// reflection glint across the floating review pills as it passes near them (their
+// background catches the sheen and their borders briefly shine). One driver, many
+// subscribers, so the overlay pill and the Refine pill reflect the SAME comet in
+// sync. Honors prefers-reduced-motion (no comets) and only runs while subscribed.
+import { useEffect, useRef, useState } from "react";
+// The comet's light is USUALLY slowcook coral; once in a while a warm white or a
+// gold streak for variety.
+const CORAL = "255,107,107";
+const COMET_COLORS = [CORAL, CORAL, CORAL, CORAL, "255,224,205", "255,196,120"];
+const pickColor = () => COMET_COLORS[Math.floor(Math.random() * COMET_COLORS.length)];
+const subs = new Set();
+let current = null;
+let raf = 0;
+let timer = 0;
+let started = false;
+const reduced = () => typeof window !== "undefined" &&
+    typeof window.matchMedia === "function" &&
+    window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+function emit(l) {
+    current = l;
+    for (const s of subs)
+        s(l);
+}
+// A point a little outside a random edge of the viewport.
+function edgePoint(W, H) {
+    const pad = 120;
+    switch (Math.floor(Math.random() * 4)) {
+        case 0: return { x: Math.random() * W, y: -pad }; // top
+        case 1: return { x: W + pad, y: Math.random() * H }; // right
+        case 2: return { x: Math.random() * W, y: H + pad }; // bottom
+        default: return { x: -pad, y: Math.random() * H }; // left
+    }
+}
+function launch() {
+    if (typeof window === "undefined")
+        return;
+    const W = window.innerWidth, H = window.innerHeight;
+    // Random direction + path: random entry edge → random exit, re-rolled only if the
+    // streak would be too short to actually cross anything.
+    const start = edgePoint(W, H);
+    let end = edgePoint(W, H);
+    for (let i = 0; i < 4 && Math.hypot(end.x - start.x, end.y - start.y) < Math.max(W, H) * 0.5; i++)
+        end = edgePoint(W, H);
+    const rgb = pickColor();
+    const dur = 2200 + Math.random() * 1300; // 2.2–3.5s flight
+    const t0 = performance.now();
+    const step = (now) => {
+        const p = (now - t0) / dur;
+        if (p >= 1) {
+            emit(null);
+            schedule();
+            return;
+        }
+        emit({
+            x: start.x + (end.x - start.x) * p,
+            y: start.y + (end.y - start.y) * p,
+            alpha: Math.sin(Math.PI * p), // fade in to the middle, fade out
+            rgb,
+        });
+        raf = requestAnimationFrame(step);
+    };
+    raf = requestAnimationFrame(step);
+}
+function schedule() {
+    timer = window.setTimeout(launch, 3500 + Math.random() * 6000); // a comet every ~3.5–9.5s
+}
+function startDriver() {
+    if (started || reduced() || typeof window === "undefined")
+        return;
+    started = true;
+    schedule();
+}
+function stopDriver() {
+    started = false;
+    clearTimeout(timer);
+    cancelAnimationFrame(raf);
+    emit(null);
+}
+/** Subscribe to the shared comet light. The driver runs only while ≥1 subscriber. */
+export function subscribeComet(cb) {
+    subs.add(cb);
+    if (subs.size === 1)
+        startDriver();
+    cb(current);
+    return () => {
+        subs.delete(cb);
+        if (subs.size === 0)
+            stopDriver();
+    };
+}
+export function useCometLight() {
+    const [l, setL] = useState(current);
+    useEffect(() => subscribeComet(setL), []);
+    return l;
+}
+/** The reflection an element shows for a given light position — a moving sheen
+ *  whose hotspot tracks the light, fading with distance, plus a border glint. */
+export function cometReflection(light, rect) {
+    const none = { background: "transparent", boxShadow: "none", opacity: 0 };
+    if (!light || !rect)
+        return none;
+    const cx = rect.left + rect.width / 2, cy = rect.top + rect.height / 2;
+    const dist = Math.hypot(light.x - cx, light.y - cy);
+    const reach = 720; // pills within this radius catch the passing light
+    const prox = Math.max(0, 1 - dist / reach);
+    // gentle (sub-quadratic) falloff so near-misses still glint clearly; proximity
+    // dominates, the flight envelope only modulates, so a close pass is always bright.
+    const k = Math.pow(prox, 1.25) * (0.5 + 0.5 * light.alpha);
+    if (k <= 0.008)
+        return none;
+    const c = light.rgb; // usually slowcook coral
+    const lx = light.x - rect.left, ly = light.y - rect.top; // hotspot in pill-local px
+    // a hot white core fading to coral reads as a bright reflection sweeping the pill.
+    const background = `radial-gradient(210px 210px at ${lx.toFixed(0)}px ${ly.toFixed(0)}px,` +
+        ` rgba(255,255,255,${Math.min(1, 1.0 * k).toFixed(3)}), rgba(${c},${Math.min(1, 1.05 * k).toFixed(3)}) 30%, rgba(${c},0) 68%)`;
+    // the border catches the light: a bright coral ring where the light is, plus a
+    // wide outer glow so the whole pill flares as the comet passes.
+    const boxShadow = `inset 0 0 0 1.5px rgba(${c},${Math.min(1, 1.2 * k).toFixed(3)}),` +
+        ` 0 0 ${(14 + 40 * k).toFixed(0)}px rgba(${c},${Math.min(0.85, 0.7 * k).toFixed(3)})`;
+    return { background, boxShadow, opacity: 1 };
+}
+/** Overlay that renders the comet reflection for the pill it's mounted into. It
+ *  subscribes to the light itself, so only THIS node re-renders per frame — the
+ *  parent pill stays put. Mount as an absolute, inset child of the pill. */
+export function CometSheen({ pillRef, radius }) {
+    const light = useCometLight();
+    const rectRef = useRef(null);
+    // measure once per comet (the pill rarely moves during a ~3s flight).
+    if (light && pillRef.current && !rectRef.current)
+        rectRef.current = pillRef.current.getBoundingClientRect();
+    if (!light)
+        rectRef.current = null;
+    const r = cometReflection(light, rectRef.current);
+    const style = {
+        position: "absolute",
+        inset: 0,
+        borderRadius: radius,
+        pointerEvents: "none",
+        background: r.background,
+        boxShadow: r.boxShadow,
+        opacity: r.opacity,
+        mixBlendMode: "screen",
+        zIndex: 9,
+        transition: "opacity .25s ease",
+    };
+    return _jsx("div", { "aria-hidden": true, "data-comet-sheen": "", style: style });
+}
+//# sourceMappingURL=comet.js.map

package/dist/react/comet.js.map

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

package/dist/react/index.d.ts

@@ -1,5 +1,6 @@
 export { SlowcookReviewOverlay, type SlowcookReviewOverlayProps } from "./overlay.js";
 export { ReviewWidget, type ReviewWidgetProps, type ReviewComment, type Corner } from "./review-widget.js";
+export { ReviewShell, localStorageStore, type ReviewShellProps, type ReviewCommentMeta, type CommentStore } from "./review-shell.js";
 export { usePrefersDark, detectPageDark, pillTheme, sheetTheme } from "./theme.js";
 export { useScenarioCommentStats, type UseScenarioCommentStatsArgs } from "./use-scenario-comment-stats.js";
 export { useStoryMarker, readCurrentStory } from "./use-story-marker.js";

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,KAAK,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrI,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,KAAK,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/index.js

@@ -1,5 +1,6 @@
 export { SlowcookReviewOverlay } from "./overlay.js";
 export { ReviewWidget } from "./review-widget.js";
+export { ReviewShell, localStorageStore } from "./review-shell.js";
 export { usePrefersDark, detectPageDark, pillTheme, sheetTheme } from "./theme.js";
 export { useScenarioCommentStats } from "./use-scenario-comment-stats.js";
 export { useStoryMarker, readCurrentStory } from "./use-story-marker.js";

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAmC,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAA2D,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAoC,MAAM,iCAAiC,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAmC,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAA2D,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAoE,MAAM,mBAAmB,CAAC;AACrI,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAoC,MAAM,iCAAiC,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/react/overlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAA4C,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAW3F,OAAO,EAeL,KAAK,SAAS,EAGf,MAAM,cAAc,CAAC;AAiCtB,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CA25B3F;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAelH"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/react/overlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAA4C,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAY3F,OAAO,EAeL,KAAK,SAAS,EAGf,MAAM,cAAc,CAAC;AAiCtB,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CA25B3F;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAelH"}

package/dist/react/overlay.js

@@ -25,7 +25,8 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useState, useRef, useCallback } from "react";
 import { createPortal } from "react-dom";
-import { extractSelector, resolveAnchor } from "../selector.js";
+import { extractSelector, resolveAnchor, isPillOffViewport, clampPillPosition } from "../selector.js";
+import { CometSheen } from "./comet.js";
 import { buildPayload, formatReviewComment, formatLcrIssue, } from "../comment-format.js";
 import { loadPat, savePat, submitComment, createIssue, fetchOverlayComments, fetchLcrIssues, loadCachedComments, saveCachedComments, fetchPrLabels, addLabelsToPr, submitPrApproval, fetchDocFile, commitDocFile, APPROVED_LABEL, } from "../github.js";
 import { renderMarkdown } from "./markdown.js";
@@ -1046,14 +1047,40 @@ function saveTogglePosition(p) {
         /* ignore quota / private-mode errors */
     }
 }
+// 0.10.1 — a persisted position can fall outside the viewport (the window was
+// resized smaller, or the pill was dragged to an edge). Because the pill is
+// fixed/absolute chrome, an off-screen position is UNREACHABLE — you can't scroll
+// to it. So whenever we restore or the window resizes, snap a stranded pill back
+// to the top-left where it's always grabbable. `margin` keeps a sliver on-screen so
+// a position that's merely flush to an edge still counts as visible.
+function ensureOnScreen(p) {
+    if (typeof window === "undefined")
+        return p;
+    return isPillOffViewport(p.left, p.top, window.innerWidth, window.innerHeight) ? { top: 12, left: 12 } : p;
+}
 function ModeToggle(props) {
     const { mode, armed, onArm, onCancelArm, onChange, disabled, isMobile, isApproved, commentCount, newCount, onListClick, docsEnabled, onDocsClick, surfaces, surfaceManifest, onNavigate, reviewMode, identity, onSignIn, onSignOut, accessory } = props;
     // 0.5.1 — initialise with the default; load saved position from
     // localStorage AFTER mount. Eliminates a hydration mismatch where
     // SSR/first-client render disagreed on the position value.
     const [pos, setPos] = useState({ top: 12, left: 12 });
-    useEffect(() => { setPos(loadTogglePosition()); }, []);
+    // Restore the saved position after mount (avoids an SSR hydration mismatch), but
+    // never restore it off-screen — snap a stranded pill back into view (0.10.1).
+    useEffect(() => { setPos(ensureOnScreen(loadTogglePosition())); }, []);
+    // If the window resizes such that the pill ends up outside the viewport, bring it
+    // back (a fixed pill can't be scrolled to).
+    useEffect(() => {
+        const onResize = () => setPos((p) => {
+            const next = ensureOnScreen(p);
+            if (next !== p)
+                saveTogglePosition(next);
+            return next;
+        });
+        window.addEventListener("resize", onResize);
+        return () => window.removeEventListener("resize", onResize);
+    }, []);
     const dragRef = useRef(null);
+    const pillRef = useRef(null);
     // 0.9.0 — EPSS jump palette open state. The tappable status (right of the
     // pill) opens it; it lists matching states to jump to.
     const [paletteOpen, setPaletteOpen] = useState(false);
@@ -1097,11 +1124,10 @@ function ModeToggle(props) {
         e.preventDefault();
         const dx = e.clientX - dragRef.current.startX;
         const dy = e.clientY - dragRef.current.startY;
-        const newTop = Math.max(0, dragRef.current.startTop + dy);
-        // Allow a slightly-negative left so a clipped (grown-right) pill can be
-        // panned left to reveal its right side; the grip stays grabbable.
-        const newLeft = Math.max(-2000, dragRef.current.startLeft + dx);
-        setPos({ top: newTop, left: newLeft });
+        // 0.10.1 — clamp into the viewport while dragging so the grip can never be
+        // pushed off-screen (it's left-anchored now, so a negative left hides it).
+        const { left, top } = clampPillPosition(dragRef.current.startLeft + dx, dragRef.current.startTop + dy, window.innerWidth, window.innerHeight);
+        setPos({ top, left });
     }, []);
     const onPointerUp = useCallback((e) => {
         if (!dragRef.current)
@@ -1110,7 +1136,7 @@ function ModeToggle(props) {
         dragRef.current = null;
         saveTogglePosition(pos);
     }, [pos]);
-    return (_jsxs("div", { "data-slowcook-overlay-ui": "1", title: isApproved ? "Mockup approved — comments still allowed; plate refuses to amend" : undefined, style: {
+    return (_jsxs("div", { ref: pillRef, "data-slowcook-overlay-ui": "1", title: isApproved ? "Mockup approved — comments still allowed; plate refuses to amend" : undefined, style: {
             position: "absolute",
             top: pos.top,
             left: pos.left,
@@ -1141,7 +1167,7 @@ function ModeToggle(props) {
             fontSize: 13,
             color: T.fg,
             userSelect: "none",
-        }, children: [_jsx("div", { role: "button", "aria-label": "Drag overlay toggle", onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onPointerCancel: onPointerUp, title: "Drag to move", style: {
+        }, children: [_jsx(CometSheen, { pillRef: pillRef, radius: 16 }), _jsx("div", { role: "button", "aria-label": "Drag overlay toggle", onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onPointerCancel: onPointerUp, title: "Drag to move", style: {
                     width: 11,
                     alignSelf: "stretch",
                     minHeight: 22,