semantic-inspector 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -2,7 +2,6 @@
 
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
-var modernScreenshot = require('modern-screenshot');
 
 // src/SemanticInspector.tsx
 var Z = 2147483600;
@@ -65,7 +64,10 @@ function tipStyle(r) {
     whiteSpace: "nowrap"
   };
 }
-function Overlay({ target, toast }) {
+var Overlay = react.memo(function Overlay2({
+  target,
+  toast
+}) {
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { style: badge, children: "\u2316 inspect \xB7 click=name \xB7 \u21E7click=shot \xB7 Esc=exit" }),
     target && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
@@ -80,12 +82,21 @@ function Overlay({ target, toast }) {
     ] }),
     toast && /* @__PURE__ */ jsxRuntime.jsx("div", { style: toastStyle, children: toast })
   ] });
-}
+});
+
+// src/clipboard.ts
 async function copyText(text) {
+  if (typeof navigator === "undefined" || !navigator.clipboard) {
+    throw new Error("Clipboard API unavailable (needs a secure context: https or localhost)");
+  }
   await navigator.clipboard.writeText(text);
 }
 async function copyElementShot(el) {
-  const blob = await modernScreenshot.domToBlob(el);
+  if (typeof navigator === "undefined" || !navigator.clipboard?.write || typeof ClipboardItem === "undefined") {
+    throw new Error("Clipboard image write unsupported (needs a secure context: https or localhost)");
+  }
+  const { domToBlob } = await import('modern-screenshot');
+  const blob = await domToBlob(el, { scale: 1 });
   if (!blob) throw new Error("screenshot produced empty blob");
   await navigator.clipboard.write([new ClipboardItem({ "image/png": blob })]);
 }
@@ -108,9 +119,10 @@ function fallbackName(el, loc) {
   return el.tagName.toLowerCase();
 }
 function fiberName(el) {
-  const key = Object.keys(el).find((k) => k.startsWith("__reactFiber$") || k.startsWith("__reactInternalInstance$"));
+  const host = el;
+  const key = Object.keys(host).find((k) => k.startsWith("__reactFiber$") || k.startsWith("__reactInternalInstance$"));
   if (!key) return null;
-  let fiber = el[key] ?? null;
+  let fiber = host[key] ?? null;
   while (fiber) {
     const t = fiber.type;
     const name = t && typeof t !== "string" ? t.displayName ?? t.name : void 0;
@@ -125,15 +137,42 @@ var DEFAULT_HOTKEY = "Alt+Shift+S";
 function defaultFormat(t) {
   return t.loc ? `${t.comp} \u2014 ${t.loc}` : t.comp;
 }
-function matchHotkey(e, hotkey) {
+function parseHotkey(hotkey) {
   const parts = hotkey.split("+").map((p) => p.trim().toLowerCase());
-  const key = parts[parts.length - 1];
-  const want = (m, alt) => parts.includes(m) || (alt ? parts.includes(alt) : false);
-  if (e.altKey !== want("alt")) return false;
-  if (e.shiftKey !== want("shift")) return false;
-  if (e.ctrlKey !== want("ctrl", "control")) return false;
-  if (e.metaKey !== want("meta", "cmd")) return false;
-  return e.key.toLowerCase() === key || e.code.toLowerCase() === `key${key}`;
+  const has = (...names) => names.some((n) => parts.includes(n));
+  const last = parts[parts.length - 1];
+  return {
+    alt: has("alt"),
+    shift: has("shift"),
+    ctrl: has("ctrl", "control"),
+    meta: has("meta", "cmd"),
+    key: last === "" ? "+" : last
+  };
+}
+var CODE_TO_KEY = {
+  slash: "/",
+  backslash: "\\",
+  period: ".",
+  comma: ",",
+  semicolon: ";",
+  quote: "'",
+  backquote: "`",
+  bracketleft: "[",
+  bracketright: "]",
+  minus: "-",
+  equal: "="
+};
+function matchHotkey(e, hk) {
+  if (e.altKey !== hk.alt || e.shiftKey !== hk.shift || e.ctrlKey !== hk.ctrl || e.metaKey !== hk.meta) {
+    return false;
+  }
+  const rawCode = e.code.toLowerCase();
+  const code = CODE_TO_KEY[rawCode] ?? rawCode.replace(/^(key|digit)/, "");
+  return e.key.toLowerCase() === hk.key || code === hk.key;
+}
+function sameTarget(a, b) {
+  if (!a || !b) return a === b;
+  return a.el === b.el && a.rect.left === b.rect.left && a.rect.top === b.rect.top && a.rect.width === b.rect.width && a.rect.height === b.rect.height;
 }
 function useInspector(opts = {}) {
   const { hotkey = DEFAULT_HOTKEY } = opts;
@@ -141,68 +180,77 @@ function useInspector(opts = {}) {
   const [target, setTarget] = react.useState(null);
   const cbRef = react.useRef(opts);
   cbRef.current = opts;
+  const targetRef = react.useRef(null);
+  const hk = react.useMemo(() => parseHotkey(hotkey), [hotkey]);
   react.useEffect(() => {
     function onKey(e) {
-      if (matchHotkey(e, hotkey)) {
+      if (matchHotkey(e, hk)) {
         e.preventDefault();
         setActive((a) => !a);
       } else if (e.key === "Escape") {
-        setActive(false);
+        setActive((a) => a ? false : a);
       }
     }
     window.addEventListener("keydown", onKey);
-    return () => {
-      window.removeEventListener("keydown", onKey);
-    };
-  }, [hotkey]);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [hk]);
   react.useEffect(() => {
     if (!active) {
+      targetRef.current = null;
       setTarget(null);
       return;
     }
+    let rafId = 0;
+    let lastX = 0;
+    let lastY = 0;
+    let shotInFlight = false;
     function onMove(e) {
-      setTarget(resolveTarget(document.elementFromPoint(e.clientX, e.clientY)));
+      lastX = e.clientX;
+      lastY = e.clientY;
+      if (rafId) return;
+      rafId = requestAnimationFrame(() => {
+        rafId = 0;
+        const next = resolveTarget(document.elementFromPoint(lastX, lastY));
+        targetRef.current = next;
+        setTarget((prev) => sameTarget(prev, next) ? prev : next);
+      });
     }
     function onClick(e) {
-      const t = resolveTarget(document.elementFromPoint(e.clientX, e.clientY));
+      const t = targetRef.current ?? resolveTarget(document.elementFromPoint(e.clientX, e.clientY));
       if (!t) return;
       e.preventDefault();
       e.stopPropagation();
       const { formatText = defaultFormat, onCopy, onError } = cbRef.current;
-      const done = (kind, payload) => {
-        onCopy?.(kind, payload);
-      };
+      const done = (kind, payload) => onCopy?.(kind, payload);
       const fail = (kind, err) => {
-        onError?.(kind, err);
+        if (onError) onError(kind, err);
+        else console.warn(`[semantic-inspector] ${kind} copy failed:`, err);
       };
       if (e.shiftKey) {
+        if (shotInFlight) return;
+        shotInFlight = true;
         copyElementShot(t.el).then(
-          () => {
-            done("screenshot", t.comp);
-          },
-          (err) => {
-            fail("screenshot", err);
-          }
-        );
+          () => done("screenshot", t.comp),
+          (err) => fail("screenshot", err)
+        ).finally(() => {
+          shotInFlight = false;
+        });
       } else {
         const text = formatText({ comp: t.comp, loc: t.loc });
         copyText(text).then(
-          () => {
-            done("text", text);
-          },
-          (err) => {
-            fail("text", err);
-          }
+          () => done("text", text),
+          (err) => fail("text", err)
         );
       }
     }
-    window.addEventListener("mousemove", onMove, true);
+    window.addEventListener("mousemove", onMove, { capture: true, passive: true });
     window.addEventListener("click", onClick, true);
     const prevCursor = document.body.style.cursor;
     document.body.style.cursor = "crosshair";
     return () => {
       window.removeEventListener("mousemove", onMove, true);
       window.removeEventListener("click", onClick, true);
+      if (rafId) cancelAnimationFrame(rafId);
       document.body.style.cursor = prevCursor;
     };
   }, [active]);
@@ -211,23 +259,20 @@ function useInspector(opts = {}) {
 var TOAST_MS = 1400;
 function SemanticInspector(props) {
   const [toast, setToast] = react.useState(null);
-  const timer = react.useRef(void 0);
-  const flash = (msg) => {
-    setToast(msg);
-    clearTimeout(timer.current);
-    timer.current = setTimeout(() => {
-      setToast(null);
-    }, TOAST_MS);
-  };
+  react.useEffect(() => {
+    if (toast == null) return;
+    const id = setTimeout(() => setToast(null), TOAST_MS);
+    return () => clearTimeout(id);
+  }, [toast]);
   const { active, target } = useInspector({
     hotkey: props.hotkey,
     formatText: props.formatText,
     onCopy: (kind, payload) => {
-      flash(kind === "text" ? `\u2713 ${payload}` : "\u2713 screenshot copied");
+      setToast(kind === "text" ? `\u2713 ${payload}` : "\u2713 screenshot copied");
       props.onCopy?.(kind, payload);
     },
     onError: (kind, err) => {
-      flash(`\u2717 ${kind} failed`);
+      setToast(`\u2717 ${kind} failed`);
       props.onError?.(kind, err);
     }
   });
@@ -236,9 +281,6 @@ function SemanticInspector(props) {
 }
 
 exports.SemanticInspector = SemanticInspector;
-exports.copyElementShot = copyElementShot;
-exports.copyText = copyText;
-exports.resolveTarget = resolveTarget;
 exports.useInspector = useInspector;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Overlay.tsx","../src/clipboard.ts","../src/resolveTarget.ts","../src/useInspector.ts","../src/SemanticInspector.tsx"],"names":["jsxs","Fragment","jsx","domToBlob","useState","useRef","useEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CSSProperties } from 'react';\nimport type { InspectTarget } from './types';\n\nconst Z = 2147483600;\n\nconst badge: CSSProperties = {\n  position: 'fixed',\n  bottom: 12,\n  left: 12,\n  zIndex: Z + 2,\n  padding: '6px 10px',\n  borderRadius: 6,\n  font: '12px/1.3 ui-monospace, SFMono-Regular, Menlo, monospace',\n  background: 'rgba(17,17,17,0.92)',\n  color: '#fff',\n  pointerEvents: 'none',\n  boxShadow: '0 2px 8px rgba(0,0,0,0.3)'\n};\n\nconst toastStyle: CSSProperties = {\n  position: 'fixed',\n  bottom: 12,\n  right: 12,\n  zIndex: Z + 2,\n  padding: '6px 10px',\n  borderRadius: 6,\n  font: '12px/1.3 ui-monospace, SFMono-Regular, Menlo, monospace',\n  background: 'rgba(22,101,52,0.95)',\n  color: '#fff',\n  pointerEvents: 'none',\n  maxWidth: '60vw',\n  whiteSpace: 'nowrap',\n  overflow: 'hidden',\n  textOverflow: 'ellipsis'\n};\n\nfunction boxStyle(r: DOMRect): CSSProperties {\n  return {\n    position: 'fixed',\n    left: r.left,\n    top: r.top,\n    width: r.width,\n    height: r.height,\n    zIndex: Z,\n    outline: '2px solid #6366f1',\n    background: 'rgba(99,102,241,0.12)',\n    pointerEvents: 'none',\n    transition: 'all 60ms ease-out'\n  };\n}\n\nfunction tipStyle(r: DOMRect): CSSProperties {\n  const top = r.top > 26 ? r.top - 24 : r.bottom + 4;\n  return {\n    position: 'fixed',\n    left: r.left,\n    top,\n    zIndex: Z + 1,\n    padding: '2px 6px',\n    borderRadius: 4,\n    font: '11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace',\n    background: '#6366f1',\n    color: '#fff',\n    pointerEvents: 'none',\n    whiteSpace: 'nowrap'\n  };\n}\n\nexport function Overlay({ target, toast }: { target: InspectTarget | null; toast: string | null }) {\n  return (\n    <>\n      <div style={badge}>⌖ inspect · click=name · ⇧click=shot · Esc=exit</div>\n      {target && (\n        <>\n          <div style={boxStyle(target.rect)} />\n          <div style={tipStyle(target.rect)}>\n            {target.comp}\n            <span style={{ opacity: 0.75 }}> · {target.loc ?? 'no source'}</span>\n          </div>\n        </>\n      )}\n      {toast && <div style={toastStyle}>{toast}</div>}\n    </>\n  );\n}\n","import { domToBlob } from 'modern-screenshot';\n\n/** Текст в буфер. */\nexport async function copyText(text: string): Promise<void> {\n  await navigator.clipboard.writeText(text);\n}\n\n/**\n * PNG-скриншот ТОЛЬКО переданного элемента в буфер (image/png).\n * Должен вызываться из user-gesture (клик), иначе браузер блокит image-копию.\n */\nexport async function copyElementShot(el: Element): Promise<void> {\n  const blob = await domToBlob(el as HTMLElement);\n  if (!blob) throw new Error('screenshot produced empty blob');\n  await navigator.clipboard.write([new ClipboardItem({ 'image/png': blob })]);\n}\n","import type { InspectTarget } from './types';\n\nconst LOC_ATTR = 'data-loc';\nconst COMP_ATTR = 'data-comp';\n\n/**\n * DOM-элемент под курсором → цель инспекции.\n * Идём к ближайшему предку с data-loc (заштампован babel-плагином). Если его нет\n * (prod-билд без штампов / сторонний узел) — best-effort: имя из React fiber,\n * затем имя файла из data-loc, затем имя тега.\n */\nexport function resolveTarget(el: Element | null): InspectTarget | null {\n  if (!el) return null;\n  const target = el.closest(`[${LOC_ATTR}]`) ?? el;\n  const loc = target.getAttribute(LOC_ATTR);\n  const comp = target.getAttribute(COMP_ATTR) ?? fiberName(target) ?? fallbackName(target, loc);\n  return { comp, loc, el: target, rect: target.getBoundingClientRect() };\n}\n\nfunction fallbackName(el: Element, loc: string | null): string {\n  if (loc) {\n    const base = loc\n      .split(':')[0]\n      .split('/')\n      .pop()\n      ?.replace(/\\.[jt]sx?$/, '');\n    if (base) return base;\n  }\n  return el.tagName.toLowerCase();\n}\n\n// React-internals fallback. _debugSource убран в React 19, но имя компонента из\n// fiber.type всё ещё доступно (в dev-билде не минифицировано).\ninterface FiberLike {\n  type: { displayName?: string; name?: string } | string | null | undefined;\n  return: FiberLike | null;\n}\n\nfunction fiberName(el: Element): string | null {\n  const key = Object.keys(el).find((k) => k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$'));\n  if (!key) return null;\n  let fiber = (el as unknown as Record<string, FiberLike | undefined>)[key] ?? null;\n  while (fiber) {\n    const t = fiber.type;\n    const name = t && typeof t !== 'string' ? (t.displayName ?? t.name) : undefined;\n    if (name && /^[A-Z]/.test(name)) return name;\n    fiber = fiber.return;\n  }\n  return null;\n}\n","import { useEffect, useRef, useState } from 'react';\nimport { copyElementShot, copyText } from './clipboard';\nimport { resolveTarget } from './resolveTarget';\nimport type { CopyKind, InspectTarget, SemanticInspectorProps } from './types';\n\nconst DEFAULT_HOTKEY = 'Alt+Shift+S';\n\nfunction defaultFormat(t: { comp: string; loc: string | null }): string {\n  return t.loc ? `${t.comp} — ${t.loc}` : t.comp;\n}\n\n/** 'Alt+Shift+S' → совпадает ли событие keydown. Последний токен — клавиша. */\nfunction matchHotkey(e: KeyboardEvent, hotkey: string): boolean {\n  const parts = hotkey.split('+').map((p) => p.trim().toLowerCase());\n  const key = parts[parts.length - 1];\n  const want = (m: string, alt?: string) => parts.includes(m) || (alt ? parts.includes(alt) : false);\n  if (e.altKey !== want('alt')) return false;\n  if (e.shiftKey !== want('shift')) return false;\n  if (e.ctrlKey !== want('ctrl', 'control')) return false;\n  if (e.metaKey !== want('meta', 'cmd')) return false;\n  return e.key.toLowerCase() === key || e.code.toLowerCase() === `key${key}`;\n}\n\n/**\n * Состояние режима инспекции + слушатели.\n * - keydown: хоткей переключает active, Esc выключает.\n * - active: mousemove обновляет target; click (capture, preventDefault) копирует\n *   текст, Shift+click — скриншот элемента.\n */\nexport function useInspector(opts: SemanticInspectorProps = {}) {\n  const { hotkey = DEFAULT_HOTKEY } = opts;\n  const [active, setActive] = useState(false);\n  const [target, setTarget] = useState<InspectTarget | null>(null);\n\n  // Свежие колбэки без переподписки слушателей.\n  const cbRef = useRef<SemanticInspectorProps>(opts);\n  cbRef.current = opts;\n\n  useEffect(() => {\n    function onKey(e: KeyboardEvent) {\n      if (matchHotkey(e, hotkey)) {\n        e.preventDefault();\n        setActive((a) => !a);\n      } else if (e.key === 'Escape') {\n        setActive(false);\n      }\n    }\n    window.addEventListener('keydown', onKey);\n    return () => {\n      window.removeEventListener('keydown', onKey);\n    };\n  }, [hotkey]);\n\n  useEffect(() => {\n    if (!active) {\n      setTarget(null);\n      return;\n    }\n\n    function onMove(e: MouseEvent) {\n      setTarget(resolveTarget(document.elementFromPoint(e.clientX, e.clientY)));\n    }\n\n    function onClick(e: MouseEvent) {\n      const t = resolveTarget(document.elementFromPoint(e.clientX, e.clientY));\n      if (!t) return;\n      e.preventDefault();\n      e.stopPropagation();\n      const { formatText = defaultFormat, onCopy, onError } = cbRef.current;\n      const done = (kind: CopyKind, payload: string) => {\n        onCopy?.(kind, payload);\n      };\n      const fail = (kind: CopyKind, err: unknown) => {\n        onError?.(kind, err);\n      };\n      if (e.shiftKey) {\n        copyElementShot(t.el).then(\n          () => {\n            done('screenshot', t.comp);\n          },\n          (err: unknown) => {\n            fail('screenshot', err);\n          }\n        );\n      } else {\n        const text = formatText({ comp: t.comp, loc: t.loc });\n        copyText(text).then(\n          () => {\n            done('text', text);\n          },\n          (err: unknown) => {\n            fail('text', err);\n          }\n        );\n      }\n    }\n\n    window.addEventListener('mousemove', onMove, true);\n    window.addEventListener('click', onClick, true);\n    const prevCursor = document.body.style.cursor;\n    document.body.style.cursor = 'crosshair';\n    return () => {\n      window.removeEventListener('mousemove', onMove, true);\n      window.removeEventListener('click', onClick, true);\n      document.body.style.cursor = prevCursor;\n    };\n  }, [active]);\n\n  return { active, target };\n}\n","import { useRef, useState } from 'react';\nimport { Overlay } from './Overlay';\nimport type { CopyKind, SemanticInspectorProps } from './types';\nimport { useInspector } from './useInspector';\n\nconst TOAST_MS = 1400;\n\n/**\n * Семантический инспектор. Сам по себе ничего не показывает, пока не включён\n * хоткеем. Гейтинг (где монтировать) — забота консьюмера: монтируй под своим\n * dev-флагом и желательно через React.lazy, чтобы не тянуть в prod-бандл.\n */\nexport function SemanticInspector(props: SemanticInspectorProps) {\n  const [toast, setToast] = useState<string | null>(null);\n  const timer = useRef<ReturnType<typeof setTimeout>>(undefined);\n\n  const flash = (msg: string) => {\n    setToast(msg);\n    clearTimeout(timer.current);\n    timer.current = setTimeout(() => {\n      setToast(null);\n    }, TOAST_MS);\n  };\n\n  const { active, target } = useInspector({\n    hotkey: props.hotkey,\n    formatText: props.formatText,\n    onCopy: (kind: CopyKind, payload: string) => {\n      flash(kind === 'text' ? `✓ ${payload}` : '✓ screenshot copied');\n      props.onCopy?.(kind, payload);\n    },\n    onError: (kind: CopyKind, err: unknown) => {\n      flash(`✗ ${kind} failed`);\n      props.onError?.(kind, err);\n    }\n  });\n\n  if (!active && !toast) return null;\n  return <Overlay target={active ? target : null} toast={toast} />;\n}\n"]}
+{"version":3,"sources":["../src/Overlay.tsx","../src/clipboard.ts","../src/resolveTarget.ts","../src/useInspector.ts","../src/SemanticInspector.tsx"],"names":["memo","Overlay","jsxs","Fragment","jsx","useState","useRef","useMemo","useEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type CSSProperties, type JSX, type MemoExoticComponent, memo } from 'react';\nimport type { InspectTarget } from './types';\n\n// Just below the 32-bit max so the overlay wins stacking contests, with a small reserved band:\n// Z = highlight box, Z+1 = tip, Z+2 = badge/toast.\nconst Z = 2147483600;\n\nconst badge = {\n  position: 'fixed',\n  bottom: 12,\n  left: 12,\n  zIndex: Z + 2,\n  padding: '6px 10px',\n  borderRadius: 6,\n  font: '12px/1.3 ui-monospace, SFMono-Regular, Menlo, monospace',\n  background: 'rgba(17,17,17,0.92)',\n  color: '#fff',\n  pointerEvents: 'none',\n  boxShadow: '0 2px 8px rgba(0,0,0,0.3)'\n} satisfies CSSProperties;\n\nconst toastStyle = {\n  position: 'fixed',\n  bottom: 12,\n  right: 12,\n  zIndex: Z + 2,\n  padding: '6px 10px',\n  borderRadius: 6,\n  font: '12px/1.3 ui-monospace, SFMono-Regular, Menlo, monospace',\n  background: 'rgba(22,101,52,0.95)',\n  color: '#fff',\n  pointerEvents: 'none',\n  maxWidth: '60vw',\n  whiteSpace: 'nowrap',\n  overflow: 'hidden',\n  textOverflow: 'ellipsis'\n} satisfies CSSProperties;\n\nfunction boxStyle(r: DOMRect): CSSProperties {\n  return {\n    position: 'fixed',\n    left: r.left,\n    top: r.top,\n    width: r.width,\n    height: r.height,\n    zIndex: Z,\n    outline: '2px solid #6366f1',\n    background: 'rgba(99,102,241,0.12)',\n    pointerEvents: 'none',\n    transition: 'all 60ms ease-out'\n  } satisfies CSSProperties;\n}\n\nfunction tipStyle(r: DOMRect): CSSProperties {\n  const top = r.top > 26 ? r.top - 24 : r.bottom + 4;\n  return {\n    position: 'fixed',\n    left: r.left,\n    top,\n    zIndex: Z + 1,\n    padding: '2px 6px',\n    borderRadius: 4,\n    font: '11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace',\n    background: '#6366f1',\n    color: '#fff',\n    pointerEvents: 'none',\n    whiteSpace: 'nowrap'\n  } satisfies CSSProperties;\n}\n\ninterface OverlayProps {\n  target: InspectTarget | null;\n  toast: string | null;\n}\n\nexport const Overlay: MemoExoticComponent<(props: OverlayProps) => JSX.Element> = memo(function Overlay({\n  target,\n  toast\n}: OverlayProps): JSX.Element {\n  return (\n    <>\n      <div style={badge}>⌖ inspect · click=name · ⇧click=shot · Esc=exit</div>\n      {target && (\n        <>\n          <div style={boxStyle(target.rect)} />\n          <div style={tipStyle(target.rect)}>\n            {target.comp}\n            <span style={{ opacity: 0.75 }}> · {target.loc ?? 'no source'}</span>\n          </div>\n        </>\n      )}\n      {toast && <div style={toastStyle}>{toast}</div>}\n    </>\n  );\n});\n","/** Copy text to the clipboard. Requires a secure context (https or localhost). */\nexport async function copyText(text: string): Promise<void> {\n  if (typeof navigator === 'undefined' || !navigator.clipboard) {\n    throw new Error('Clipboard API unavailable (needs a secure context: https or localhost)');\n  }\n  await navigator.clipboard.writeText(text);\n}\n\n/**\n * Copy a PNG screenshot of ONLY the given element to the clipboard (image/png).\n * Must be called from a user gesture (click), or the browser blocks the image write.\n *\n * `modern-screenshot` is imported lazily so it is emitted as a separate chunk and never lands\n * in a consumer's production bundle through the runtime entry.\n */\nexport async function copyElementShot(el: Element): Promise<void> {\n  if (typeof navigator === 'undefined' || !navigator.clipboard?.write || typeof ClipboardItem === 'undefined') {\n    throw new Error('Clipboard image write unsupported (needs a secure context: https or localhost)');\n  }\n  const { domToBlob } = await import('modern-screenshot');\n  // scale: 1 avoids the 4x rasterization cost of devicePixelRatio on Retina displays.\n  const blob = await domToBlob(el as HTMLElement, { scale: 1 });\n  if (!blob) throw new Error('screenshot produced empty blob');\n  await navigator.clipboard.write([new ClipboardItem({ 'image/png': blob })]);\n}\n","import type { InspectTarget } from './types';\n\nconst LOC_ATTR = 'data-loc';\nconst COMP_ATTR = 'data-comp';\n\n/**\n * DOM element under the cursor → inspection target.\n *\n * Walks to the nearest ancestor carrying data-loc (stamped by the Babel plugin). If none\n * exists (prod build without stamps / foreign node), it falls back best-effort to: the name\n * from the React fiber, then the file name from data-loc, then the tag name.\n */\nexport function resolveTarget(el: Element | null): InspectTarget | null {\n  if (!el) return null;\n  const target = el.closest(`[${LOC_ATTR}]`) ?? el;\n  const loc = target.getAttribute(LOC_ATTR);\n  const comp = target.getAttribute(COMP_ATTR) ?? fiberName(target) ?? fallbackName(target, loc);\n  return { comp, loc, el: target, rect: target.getBoundingClientRect() };\n}\n\nfunction fallbackName(el: Element, loc: string | null): string {\n  if (loc) {\n    const base = loc\n      .split(':')[0]\n      .split('/')\n      .pop()\n      ?.replace(/\\.[jt]sx?$/, '');\n    if (base) return base;\n  }\n  return el.tagName.toLowerCase();\n}\n\n// React-internals fallback. _debugSource was removed in React 19, but the component name from\n// fiber.type is still available (not minified in dev builds).\ninterface FiberLike {\n  type: { displayName?: string; name?: string } | string | null | undefined;\n  return: FiberLike | null;\n}\n\nfunction fiberName(el: Element): string | null {\n  const host = el as Element & Record<string, FiberLike | undefined>;\n  const key = Object.keys(host).find((k) => k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$'));\n  if (!key) return null;\n  let fiber: FiberLike | null = host[key] ?? null;\n  while (fiber) {\n    const t = fiber.type;\n    const name = t && typeof t !== 'string' ? (t.displayName ?? t.name) : undefined;\n    if (name && /^[A-Z]/.test(name)) return name;\n    fiber = fiber.return;\n  }\n  return null;\n}\n","import { useEffect, useMemo, useRef, useState } from 'react';\nimport { copyElementShot, copyText } from './clipboard';\nimport { resolveTarget } from './resolveTarget';\nimport type { CopyKind, InspectTarget, LocInfo, SemanticInspectorProps, UseInspectorResult } from './types';\n\nconst DEFAULT_HOTKEY = 'Alt+Shift+S';\n\nfunction defaultFormat(t: LocInfo): string {\n  return t.loc ? `${t.comp} — ${t.loc}` : t.comp;\n}\n\ninterface Hotkey {\n  alt: boolean;\n  shift: boolean;\n  ctrl: boolean;\n  meta: boolean;\n  key: string;\n}\n\n/** Parse 'Alt+Shift+S' into a descriptor. The final token is the key (empty → literal '+'). */\nfunction parseHotkey(hotkey: string): Hotkey {\n  const parts = hotkey.split('+').map((p) => p.trim().toLowerCase());\n  const has = (...names: string[]): boolean => names.some((n) => parts.includes(n));\n  const last = parts[parts.length - 1];\n  return {\n    alt: has('alt'),\n    shift: has('shift'),\n    ctrl: has('ctrl', 'control'),\n    meta: has('meta', 'cmd'),\n    key: last === '' ? '+' : last\n  };\n}\n\n// Physical-key codes whose token differs from the produced character, so a hotkey written with\n// the unshifted glyph still matches when Shift transforms it (e.g. Ctrl+Shift+/ → e.key '?').\nconst CODE_TO_KEY: Record<string, string> = {\n  slash: '/',\n  backslash: '\\\\',\n  period: '.',\n  comma: ',',\n  semicolon: ';',\n  quote: \"'\",\n  backquote: '`',\n  bracketleft: '[',\n  bracketright: ']',\n  minus: '-',\n  equal: '='\n};\n\n/** Whether a keydown event matches the parsed hotkey. */\nfunction matchHotkey(e: KeyboardEvent, hk: Hotkey): boolean {\n  if (e.altKey !== hk.alt || e.shiftKey !== hk.shift || e.ctrlKey !== hk.ctrl || e.metaKey !== hk.meta) {\n    return false;\n  }\n  // Normalize the physical code (KeyA → a, Digit1 → 1, Slash → /) so non-letter keys match too.\n  const rawCode = e.code.toLowerCase();\n  const code = CODE_TO_KEY[rawCode] ?? rawCode.replace(/^(key|digit)/, '');\n  return e.key.toLowerCase() === hk.key || code === hk.key;\n}\n\nfunction sameTarget(a: InspectTarget | null, b: InspectTarget | null): boolean {\n  if (!a || !b) return a === b;\n  return (\n    a.el === b.el &&\n    a.rect.left === b.rect.left &&\n    a.rect.top === b.rect.top &&\n    a.rect.width === b.rect.width &&\n    a.rect.height === b.rect.height\n  );\n}\n\n/**\n * Inspection-mode state + listeners.\n * - keydown: the hotkey toggles `active`; Esc exits.\n * - active: mousemove (rAF-coalesced) updates `target`; click (capture, preventDefault) copies\n *   text, Shift+click copies an element screenshot.\n */\nexport function useInspector(opts: SemanticInspectorProps = {}): UseInspectorResult {\n  const { hotkey = DEFAULT_HOTKEY } = opts;\n  const [active, setActive] = useState(false);\n  const [target, setTarget] = useState<InspectTarget | null>(null);\n\n  // Fresh callbacks without re-subscribing listeners.\n  const cbRef = useRef<SemanticInspectorProps>(opts);\n  cbRef.current = opts;\n\n  // Latest hovered target, so the click handler copies exactly what is highlighted.\n  const targetRef = useRef<InspectTarget | null>(null);\n\n  const hk = useMemo(() => parseHotkey(hotkey), [hotkey]);\n\n  useEffect(() => {\n    function onKey(e: KeyboardEvent): void {\n      if (matchHotkey(e, hk)) {\n        e.preventDefault();\n        setActive((a) => !a);\n      } else if (e.key === 'Escape') {\n        setActive((a) => (a ? false : a));\n      }\n    }\n    window.addEventListener('keydown', onKey);\n    return () => window.removeEventListener('keydown', onKey);\n  }, [hk]);\n\n  useEffect(() => {\n    if (!active) {\n      targetRef.current = null;\n      setTarget(null);\n      return;\n    }\n\n    let rafId = 0;\n    let lastX = 0;\n    let lastY = 0;\n    let shotInFlight = false;\n\n    function onMove(e: MouseEvent): void {\n      lastX = e.clientX;\n      lastY = e.clientY;\n      if (rafId) return; // one update per frame, regardless of input rate\n      rafId = requestAnimationFrame(() => {\n        rafId = 0;\n        const next = resolveTarget(document.elementFromPoint(lastX, lastY));\n        targetRef.current = next;\n        setTarget((prev) => (sameTarget(prev, next) ? prev : next));\n      });\n    }\n\n    function onClick(e: MouseEvent): void {\n      const t = targetRef.current ?? resolveTarget(document.elementFromPoint(e.clientX, e.clientY));\n      if (!t) return;\n      e.preventDefault();\n      e.stopPropagation();\n      const { formatText = defaultFormat, onCopy, onError } = cbRef.current;\n      const done = (kind: CopyKind, payload: string): void => onCopy?.(kind, payload);\n      const fail = (kind: CopyKind, err: unknown): void => {\n        if (onError) onError(kind, err);\n        // Surface failures even without an onError handler (console is the right channel for a dev tool).\n        else console.warn(`[semantic-inspector] ${kind} copy failed:`, err);\n      };\n\n      if (e.shiftKey) {\n        if (shotInFlight) return; // ignore overlapping captures\n        shotInFlight = true;\n        copyElementShot(t.el)\n          .then(\n            () => done('screenshot', t.comp),\n            (err: unknown) => fail('screenshot', err)\n          )\n          .finally(() => {\n            shotInFlight = false;\n          });\n      } else {\n        const text = formatText({ comp: t.comp, loc: t.loc });\n        copyText(text).then(\n          () => done('text', text),\n          (err: unknown) => fail('text', err)\n        );\n      }\n    }\n\n    window.addEventListener('mousemove', onMove, { capture: true, passive: true });\n    window.addEventListener('click', onClick, true);\n    const prevCursor = document.body.style.cursor;\n    document.body.style.cursor = 'crosshair';\n    return () => {\n      window.removeEventListener('mousemove', onMove, true);\n      window.removeEventListener('click', onClick, true);\n      if (rafId) cancelAnimationFrame(rafId);\n      document.body.style.cursor = prevCursor;\n    };\n  }, [active]);\n\n  return { active, target };\n}\n","import { type JSX, useEffect, useState } from 'react';\nimport { Overlay } from './Overlay';\nimport type { CopyKind, SemanticInspectorProps } from './types';\nimport { useInspector } from './useInspector';\n\n// How long the copy toast stays visible (ms).\nconst TOAST_MS = 1400;\n\n/**\n * Semantic inspector. Renders nothing until toggled by the hotkey. Gating (where to mount) is\n * the consumer's responsibility: mount it under your dev flag, ideally via React.lazy, so it is\n * not pulled into the production bundle.\n */\nexport function SemanticInspector(props: SemanticInspectorProps): JSX.Element | null {\n  const [toast, setToast] = useState<string | null>(null);\n\n  // Auto-hide the toast; cleanup cancels the pending timer (including on unmount).\n  // Note: two identical consecutive toasts share one window — acceptable for a dev tool.\n  useEffect(() => {\n    if (toast == null) return;\n    const id = setTimeout(() => setToast(null), TOAST_MS);\n    return () => clearTimeout(id);\n  }, [toast]);\n\n  const { active, target } = useInspector({\n    hotkey: props.hotkey,\n    formatText: props.formatText,\n    onCopy: (kind: CopyKind, payload: string) => {\n      setToast(kind === 'text' ? `✓ ${payload}` : '✓ screenshot copied');\n      props.onCopy?.(kind, payload);\n    },\n    onError: (kind: CopyKind, err: unknown) => {\n      setToast(`✗ ${kind} failed`);\n      props.onError?.(kind, err);\n    }\n  });\n\n  if (!active && !toast) return null;\n  return <Overlay target={active ? target : null} toast={toast} />;\n}\n"]}

package/dist/index.d.cts

@@ -1,62 +1,58 @@
-import * as react from 'react';
+import { JSX } from 'react';
 
 type CopyKind = 'text' | 'screenshot';
-interface InspectTarget {
-    /** Имя компонента (data-comp) или fallback (fiber displayName / имя файла / тег). */
+/** Component name + source location resolved for an inspected element. */
+interface LocInfo {
+    /** Component name (from data-comp) or a fallback (fiber displayName / file name / tag). */
     comp: string;
-    /** "<path>:<line>" из data-loc, либо null если элемент не заштампован. */
+    /** "<path>:<line>:<col>" from data-loc, or null when the element is not stamped. */
     loc: string | null;
-    /** Реальный DOM-элемент (ближайший с data-loc, либо сам). */
+}
+interface InspectTarget extends LocInfo {
+    /** The resolved DOM element (nearest ancestor with data-loc, or the element itself). */
     el: Element;
-    /** Геометрия для оверлея. */
+    /** Geometry for the overlay highlight. */
     rect: DOMRect;
 }
 interface SemanticInspectorProps {
-    /** Хоткей-toggle. Default 'Alt+Shift+S'. Формат: 'Alt+Shift+S', 'Ctrl+Cmd+I'. */
+    /**
+     * Toggle hotkey. Default 'Alt+Shift+S'.
+     *
+     * Format: modifiers (`Alt`, `Shift`, `Ctrl`/`Control`, `Meta`/`Cmd`) joined with `+`
+     * followed by a final key, e.g. 'Ctrl+Cmd+I'. Matching is case-insensitive and also
+     * accepts the physical `event.code` (so layout-shifted glyphs still work). `Esc` always exits.
+     */
     hotkey?: string;
-    /** Формат текста для буфера. Default: `${comp} — ${loc}` (или `${comp}` без loc). */
-    formatText?: (t: {
-        comp: string;
-        loc: string | null;
-    }) => string;
-    /** Колбэк после успешной копии — для телеметрии/тостов апа. */
+    /** Formats the clipboard text. Default: `${comp} — ${loc}` (or `${comp}` when loc is null). */
+    formatText?: (t: LocInfo) => string;
+    /**
+     * Called after a successful copy. For kind `'text'`, `payload` is the copied string; for
+     * kind `'screenshot'`, `payload` is the component name (the PNG itself goes to the clipboard,
+     * not to this callback).
+     */
     onCopy?: (kind: CopyKind, payload: string) => void;
-    /** Колбэк при ошибке копии (clipboard reject / screenshot fail). */
+    /** Called when a copy fails (clipboard rejection / screenshot failure). */
     onError?: (kind: CopyKind, err: unknown) => void;
 }
-
-/**
- * Семантический инспектор. Сам по себе ничего не показывает, пока не включён
- * хоткеем. Гейтинг (где монтировать) — забота консьюмера: монтируй под своим
- * dev-флагом и желательно через React.lazy, чтобы не тянуть в prod-бандл.
- */
-declare function SemanticInspector(props: SemanticInspectorProps): react.JSX.Element | null;
-
-/**
- * Состояние режима инспекции + слушатели.
- * - keydown: хоткей переключает active, Esc выключает.
- * - active: mousemove обновляет target; click (capture, preventDefault) копирует
- *   текст, Shift+click — скриншот элемента.
- */
-declare function useInspector(opts?: SemanticInspectorProps): {
+/** Return value of `useInspector`. */
+interface UseInspectorResult {
     active: boolean;
     target: InspectTarget | null;
-};
+}
 
 /**
- * DOM-элемент под курсором → цель инспекции.
- * Идём к ближайшему предку с data-loc (заштампован babel-плагином). Если его нет
- * (prod-билд без штампов / сторонний узел) — best-effort: имя из React fiber,
- * затем имя файла из data-loc, затем имя тега.
+ * Semantic inspector. Renders nothing until toggled by the hotkey. Gating (where to mount) is
+ * the consumer's responsibility: mount it under your dev flag, ideally via React.lazy, so it is
+ * not pulled into the production bundle.
  */
-declare function resolveTarget(el: Element | null): InspectTarget | null;
+declare function SemanticInspector(props: SemanticInspectorProps): JSX.Element | null;
 
-/** Текст в буфер. */
-declare function copyText(text: string): Promise<void>;
 /**
- * PNG-скриншот ТОЛЬКО переданного элемента в буфер (image/png).
- * Должен вызываться из user-gesture (клик), иначе браузер блокит image-копию.
+ * Inspection-mode state + listeners.
+ * - keydown: the hotkey toggles `active`; Esc exits.
+ * - active: mousemove (rAF-coalesced) updates `target`; click (capture, preventDefault) copies
+ *   text, Shift+click copies an element screenshot.
  */
-declare function copyElementShot(el: Element): Promise<void>;
+declare function useInspector(opts?: SemanticInspectorProps): UseInspectorResult;
 
-export { type CopyKind, type InspectTarget, SemanticInspector, type SemanticInspectorProps, copyElementShot, copyText, resolveTarget, useInspector };
+export { type CopyKind, type InspectTarget, type LocInfo, SemanticInspector, type SemanticInspectorProps, type UseInspectorResult, useInspector };

package/dist/index.d.ts

@@ -1,62 +1,58 @@
-import * as react from 'react';
+import { JSX } from 'react';
 
 type CopyKind = 'text' | 'screenshot';
-interface InspectTarget {
-    /** Имя компонента (data-comp) или fallback (fiber displayName / имя файла / тег). */
+/** Component name + source location resolved for an inspected element. */
+interface LocInfo {
+    /** Component name (from data-comp) or a fallback (fiber displayName / file name / tag). */
     comp: string;
-    /** "<path>:<line>" из data-loc, либо null если элемент не заштампован. */
+    /** "<path>:<line>:<col>" from data-loc, or null when the element is not stamped. */
     loc: string | null;
-    /** Реальный DOM-элемент (ближайший с data-loc, либо сам). */
+}
+interface InspectTarget extends LocInfo {
+    /** The resolved DOM element (nearest ancestor with data-loc, or the element itself). */
     el: Element;
-    /** Геометрия для оверлея. */
+    /** Geometry for the overlay highlight. */
     rect: DOMRect;
 }
 interface SemanticInspectorProps {
-    /** Хоткей-toggle. Default 'Alt+Shift+S'. Формат: 'Alt+Shift+S', 'Ctrl+Cmd+I'. */
+    /**
+     * Toggle hotkey. Default 'Alt+Shift+S'.
+     *
+     * Format: modifiers (`Alt`, `Shift`, `Ctrl`/`Control`, `Meta`/`Cmd`) joined with `+`
+     * followed by a final key, e.g. 'Ctrl+Cmd+I'. Matching is case-insensitive and also
+     * accepts the physical `event.code` (so layout-shifted glyphs still work). `Esc` always exits.
+     */
     hotkey?: string;
-    /** Формат текста для буфера. Default: `${comp} — ${loc}` (или `${comp}` без loc). */
-    formatText?: (t: {
-        comp: string;
-        loc: string | null;
-    }) => string;
-    /** Колбэк после успешной копии — для телеметрии/тостов апа. */
+    /** Formats the clipboard text. Default: `${comp} — ${loc}` (or `${comp}` when loc is null). */
+    formatText?: (t: LocInfo) => string;
+    /**
+     * Called after a successful copy. For kind `'text'`, `payload` is the copied string; for
+     * kind `'screenshot'`, `payload` is the component name (the PNG itself goes to the clipboard,
+     * not to this callback).
+     */
     onCopy?: (kind: CopyKind, payload: string) => void;
-    /** Колбэк при ошибке копии (clipboard reject / screenshot fail). */
+    /** Called when a copy fails (clipboard rejection / screenshot failure). */
     onError?: (kind: CopyKind, err: unknown) => void;
 }
-
-/**
- * Семантический инспектор. Сам по себе ничего не показывает, пока не включён
- * хоткеем. Гейтинг (где монтировать) — забота консьюмера: монтируй под своим
- * dev-флагом и желательно через React.lazy, чтобы не тянуть в prod-бандл.
- */
-declare function SemanticInspector(props: SemanticInspectorProps): react.JSX.Element | null;
-
-/**
- * Состояние режима инспекции + слушатели.
- * - keydown: хоткей переключает active, Esc выключает.
- * - active: mousemove обновляет target; click (capture, preventDefault) копирует
- *   текст, Shift+click — скриншот элемента.
- */
-declare function useInspector(opts?: SemanticInspectorProps): {
+/** Return value of `useInspector`. */
+interface UseInspectorResult {
     active: boolean;
     target: InspectTarget | null;
-};
+}
 
 /**
- * DOM-элемент под курсором → цель инспекции.
- * Идём к ближайшему предку с data-loc (заштампован babel-плагином). Если его нет
- * (prod-билд без штампов / сторонний узел) — best-effort: имя из React fiber,
- * затем имя файла из data-loc, затем имя тега.
+ * Semantic inspector. Renders nothing until toggled by the hotkey. Gating (where to mount) is
+ * the consumer's responsibility: mount it under your dev flag, ideally via React.lazy, so it is
+ * not pulled into the production bundle.
  */
-declare function resolveTarget(el: Element | null): InspectTarget | null;
+declare function SemanticInspector(props: SemanticInspectorProps): JSX.Element | null;
 
-/** Текст в буфер. */
-declare function copyText(text: string): Promise<void>;
 /**
- * PNG-скриншот ТОЛЬКО переданного элемента в буфер (image/png).
- * Должен вызываться из user-gesture (клик), иначе браузер блокит image-копию.
+ * Inspection-mode state + listeners.
+ * - keydown: the hotkey toggles `active`; Esc exits.
+ * - active: mousemove (rAF-coalesced) updates `target`; click (capture, preventDefault) copies
+ *   text, Shift+click copies an element screenshot.
  */
-declare function copyElementShot(el: Element): Promise<void>;
+declare function useInspector(opts?: SemanticInspectorProps): UseInspectorResult;
 
-export { type CopyKind, type InspectTarget, SemanticInspector, type SemanticInspectorProps, copyElementShot, copyText, resolveTarget, useInspector };
+export { type CopyKind, type InspectTarget, type LocInfo, SemanticInspector, type SemanticInspectorProps, type UseInspectorResult, useInspector };