feedtack 0.5.1 → 1.1.0

package/dist/{theme-C-uctIoI.d.ts → types-Cu4Oahg4.d.ts}

@@ -1,4 +1,5 @@
-declare const SCHEMA_VERSION = "1.0.0";
+declare const SCHEMA_VERSION = "2.0.0";
+type FeedtackScope = 'site' | 'page' | 'element';
 interface FeedtackUser {
     /** Unique identifier — used for attribution across pins, replies, resolutions, archives */
     id: string;
@@ -81,17 +82,19 @@ interface FeedtackDeviceMeta {
     platform: string;
     touchEnabled: boolean;
 }
-type FeedtackSentiment = 'satisfied' | 'dissatisfied' | null;
+type FeedtackSentiment = 'good' | 'bad' | null;
 interface FeedtackPayload {
     schemaVersion: string;
     /** Unique feedback ID, e.g. ft_01j... */
     id: string;
     /** ISO 8601 UTC */
     timestamp: string;
+    /** Feedback scope: site-wide, page-level, or element-specific */
+    scope: FeedtackScope;
     submittedBy: FeedtackUser;
     comment: string;
     sentiment: FeedtackSentiment;
-    /** At least one pin required */
+    /** Pins placed on the page. Empty for site/page scope. */
     pins: FeedtackPin[];
     page: FeedtackPageMeta;
     viewport: FeedtackViewportMeta;
@@ -127,6 +130,7 @@ interface FeedtackFilter {
     url?: string;
     pathname?: string;
     userId?: string;
+    scope?: FeedtackScope;
 }
 
 /** Plugin contract — implement this interface to create a custom feedtack backend */
@@ -164,4 +168,41 @@ interface FeedtackTheme {
 /** Maps FeedtackTheme fields to CSS custom properties on #feedtack-root */
 declare function themeToCSS(theme: FeedtackTheme): Record<string, string>;
 
-export { type AncestorNode as A, type FeedtackAdapter as F, SCHEMA_VERSION as S, type FeedtackPayload as a, type FeedtackReply as b, type FeedtackResolution as c, type FeedtackFilter as d, type FeedbackItem as e, type FeedtackDeviceMeta as f, type FeedtackPageMeta as g, type FeedtackViewportMeta as h, type FeedtackPinTarget as i, type FeedtackArchive as j, type FeedtackBoundingRect as k, type FeedtackPin as l, type FeedtackSentiment as m, type FeedtackTheme as n, type FeedtackUser as o, themeToCSS as t };
+declare function generateId(): string;
+interface FeedtackFlushEvent {
+    pathname: string;
+    items: FeedbackItem[];
+}
+interface FeedtackEngineOpts {
+    adapter: FeedtackAdapter;
+    currentUser: FeedtackUser;
+    hotkey?: string;
+    theme?: FeedtackTheme;
+    onError?: (err: Error) => void;
+    disabled?: boolean;
+    onFlush?: (event: FeedtackFlushEvent) => void;
+    flushIdleMs?: number;
+    rescopeRoles?: string[];
+}
+interface FeedtackEngineState {
+    isPinModeActive: boolean;
+    pendingPins: Array<Omit<FeedtackPin, 'index'>>;
+    selectedColor: string;
+    showForm: boolean;
+    comment: string;
+    sentiment: FeedtackSentiment;
+    commentError: boolean;
+    submitting: boolean;
+    feedbackItems: FeedbackItem[];
+    siteFeedback: FeedbackItem[];
+    pageFeedback: FeedbackItem[];
+    loading: boolean;
+    openThreadId: string | null;
+    replyBody: string;
+    isModalOpen: boolean;
+    composeScope: 'site' | 'page';
+    pathname: string;
+}
+type FeedtackStateListener = (state: FeedtackEngineState, changedKeys: Array<keyof FeedtackEngineState>) => void;
+
+export { type AncestorNode as A, type FeedtackAdapter as F, SCHEMA_VERSION as S, type FeedtackPayload as a, type FeedtackReply as b, type FeedtackResolution as c, type FeedtackFilter as d, type FeedbackItem as e, type FeedtackDeviceMeta as f, type FeedtackPageMeta as g, type FeedtackViewportMeta as h, type FeedtackPinTarget as i, type FeedtackEngineOpts as j, type FeedtackEngineState as k, type FeedtackStateListener as l, type FeedtackArchive as m, type FeedtackBoundingRect as n, type FeedtackFlushEvent as o, type FeedtackPin as p, type FeedtackScope as q, type FeedtackSentiment as r, type FeedtackTheme as s, type FeedtackUser as t, generateId as u, themeToCSS as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedtack",
-  "version": "0.5.1",
+  "version": "1.1.0",
   "description": "Click anywhere. Drop a pin. Get a payload a developer can act on.",
   "type": "module",
   "license": "MIT",

package/dist/chunk-PPM4AIJU.js

@@ -1,237 +0,0 @@
-// src/capture/meta.ts
-function getViewportMeta() {
-  return {
-    width: window.innerWidth,
-    height: window.innerHeight,
-    scrollX: window.scrollX,
-    scrollY: window.scrollY,
-    devicePixelRatio: window.devicePixelRatio
-  };
-}
-function getPageMeta() {
-  return {
-    url: window.location.href,
-    pathname: window.location.pathname,
-    title: document.title
-  };
-}
-function getDeviceMeta() {
-  return {
-    userAgent: navigator.userAgent,
-    platform: navigator.platform,
-    touchEnabled: navigator.maxTouchPoints > 0
-  };
-}
-function getPinCoords(event) {
-  const x = event.clientX + window.scrollX;
-  const y = event.clientY + window.scrollY;
-  const docWidth = document.documentElement.scrollWidth;
-  const docHeight = document.documentElement.scrollHeight;
-  return {
-    x,
-    y,
-    xPct: Number((x / docWidth * 100).toFixed(2)),
-    yPct: Number((y / docHeight * 100).toFixed(2))
-  };
-}
-
-// src/capture/fiber.ts
-var fiberKey;
-function getFiberKey(element) {
-  if (fiberKey !== void 0) return fiberKey;
-  const key = Object.keys(element).find((k) => k.startsWith("__reactFiber$"));
-  fiberKey = key ?? null;
-  return fiberKey;
-}
-function getComponentName(element) {
-  try {
-    const key = getFiberKey(element);
-    if (!key) return null;
-    let fiber = element[key];
-    while (fiber) {
-      const type = fiber.type;
-      if (type && typeof type !== "string") {
-        const name = type.displayName ?? type.name;
-        if (name && name !== "Anonymous") return name;
-      }
-      fiber = fiber.return;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-// src/capture/target.ts
-var INTERACTIVE_SELECTOR = "button,a,input,select,textarea,label";
-function resolveTarget(element) {
-  const promoted = element.closest(INTERACTIVE_SELECTOR);
-  return promoted ?? element;
-}
-function attr(el, name) {
-  return el.getAttribute(name);
-}
-function nthChild(el) {
-  let n = 1;
-  let sib = el.previousElementSibling;
-  while (sib) {
-    n++;
-    sib = sib.previousElementSibling;
-  }
-  return n;
-}
-function nthOfType(el) {
-  const tag = el.tagName;
-  let n = 1;
-  let sib = el.previousElementSibling;
-  while (sib) {
-    if (sib.tagName === tag) n++;
-    sib = sib.previousElementSibling;
-  }
-  return n;
-}
-function serializeNode(el) {
-  const id = attr(el, "id");
-  const dataTestId = attr(el, "data-testid") ?? attr(el, "data-test-id");
-  const dataFeedtackComponent = attr(el, "data-feedtack-component");
-  const hasStableId = !!(id || dataTestId);
-  return {
-    tag: el.tagName.toLowerCase(),
-    id,
-    ariaLabel: attr(el, "aria-label"),
-    role: attr(el, "role"),
-    type: attr(el, "type"),
-    name: attr(el, "name"),
-    title: attr(el, "title"),
-    alt: attr(el, "alt"),
-    dataTestId,
-    dataFeedtackComponent,
-    nthChild: hasStableId ? null : nthChild(el),
-    nthOfType: hasStableId ? null : nthOfType(el),
-    componentName: dataFeedtackComponent ?? getComponentName(el)
-  };
-}
-function getAncestorChain(element) {
-  const chain = [];
-  let current = element.parentElement;
-  while (current && current !== document.body && chain.length < 5) {
-    chain.push(serializeNode(current));
-    current = current.parentElement;
-  }
-  return chain;
-}
-function getCSSSelector(element) {
-  const parts = [];
-  let current = element;
-  while (current && current !== document.body) {
-    const id = current.getAttribute("id");
-    const testId = current.getAttribute("data-testid") ?? current.getAttribute("data-test-id");
-    const feedtackComponent = current.getAttribute("data-feedtack-component");
-    if (id) {
-      parts.unshift(`#${id}`);
-      break;
-    } else if (testId) {
-      parts.unshift(`[data-testid="${testId}"]`);
-      break;
-    } else if (feedtackComponent) {
-      parts.unshift(`[data-feedtack-component="${feedtackComponent}"]`);
-      break;
-    } else {
-      const tag = current.tagName.toLowerCase();
-      const parent = current.parentElement;
-      if (parent) {
-        const siblings = Array.from(parent.children).filter(
-          (c) => c.tagName === current.tagName
-        );
-        const index = siblings.indexOf(current) + 1;
-        parts.unshift(
-          siblings.length > 1 ? `${tag}:nth-of-type(${index})` : tag
-        );
-      } else {
-        parts.unshift(tag);
-      }
-    }
-    current = current.parentElement;
-  }
-  return parts.join(" > ");
-}
-function deriveElementPath(target, ancestors) {
-  const dataTestId = target.getAttribute("data-testid") ?? target.getAttribute("data-test-id");
-  if (dataTestId) return null;
-  const targetPart = (() => {
-    const tag = target.tagName.toLowerCase();
-    const classes = Array.from(target.classList).join(".");
-    return classes ? `${tag}.${classes}` : tag;
-  })();
-  const ancestorParts = ancestors.map((a) => {
-    if (a.dataTestId) return `[data-testid="${a.dataTestId}"]`;
-    const classes = "";
-    return classes ? `${a.tag}.${classes}` : a.tag;
-  });
-  return [targetPart, ...ancestorParts].join(" > ");
-}
-function getTargetMeta(element) {
-  const resolved = resolveTarget(element);
-  const id = resolved.getAttribute("id");
-  const dataTestId = resolved.getAttribute("data-testid") ?? resolved.getAttribute("data-test-id");
-  const feedtackComponent = resolved.getAttribute("data-feedtack-component");
-  let selector;
-  let best_effort;
-  if (id) {
-    selector = `#${id}`;
-    best_effort = false;
-  } else if (dataTestId) {
-    selector = `[data-testid="${dataTestId}"]`;
-    best_effort = false;
-  } else if (feedtackComponent) {
-    selector = `[data-feedtack-component="${feedtackComponent}"]`;
-    best_effort = false;
-  } else {
-    selector = getCSSSelector(resolved);
-    best_effort = true;
-  }
-  const ancestors = getAncestorChain(resolved);
-  const rect = resolved.getBoundingClientRect();
-  return {
-    selector,
-    best_effort,
-    dataTestId,
-    elementPath: deriveElementPath(resolved, ancestors),
-    tagName: resolved.tagName,
-    ancestors,
-    boundingRect: {
-      x: rect.x + window.scrollX,
-      y: rect.y + window.scrollY,
-      width: rect.width,
-      height: rect.height
-    }
-  };
-}
-
-// src/types/payload.ts
-var SCHEMA_VERSION = "1.0.0";
-
-// src/types/theme.ts
-function themeToCSS(theme) {
-  const map = {};
-  if (theme.primary) map["--ft-primary"] = theme.primary;
-  if (theme.background) map["--ft-bg"] = theme.background;
-  if (theme.surface) map["--ft-surface"] = theme.surface;
-  if (theme.text) map["--ft-text"] = theme.text;
-  if (theme.textMuted) map["--ft-text-muted"] = theme.textMuted;
-  if (theme.border) map["--ft-border"] = theme.border;
-  if (theme.radius) map["--ft-radius"] = theme.radius;
-  if (theme.badge) map["--ft-badge"] = theme.badge;
-  return map;
-}
-
-export {
-  getViewportMeta,
-  getPageMeta,
-  getDeviceMeta,
-  getPinCoords,
-  getCSSSelector,
-  getTargetMeta,
-  SCHEMA_VERSION,
-  themeToCSS
-};