@pixelatlarge/peanut-gallery-core 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   DEFAULT_THEME: () => DEFAULT_THEME,
   ISSUE_BLOCK_LANG: () => ISSUE_BLOCK_LANG,
   LABELS: () => LABELS,
+  MAX_STEPS: () => MAX_STEPS,
   PALETTE: () => PALETTE,
   buildSelector: () => buildSelector,
   createAnchor: () => createAnchor,
@@ -33,12 +34,19 @@ __export(index_exports, {
   resolveAnchor: () => resolveAnchor,
   resolveTheme: () => resolveTheme,
   sessionToIssue: () => sessionToIssue,
+  stepLabel: () => stepLabel,
   themeToCssVars: () => themeToCssVars,
   uid: () => uid
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/types.ts
+var MAX_STEPS = 5;
+function stepLabel(step) {
+  const t = (step.textFingerprint ?? "").trim();
+  if (t) return `\u201C${t.length > 40 ? t.slice(0, 39) + "\u2026" : t}\u201D`;
+  return step.selector.length > 60 ? step.tag : step.selector;
+}
 var LABELS = {
   root: "peanut-gallery",
   feedback: "peanut-gallery:feedback",
@@ -177,6 +185,7 @@ function sessionToIssue(session) {
     lines.push(`- **Element:** \`${a.anchor.tag ?? "?"}\` \u2192 \`${a.anchor.selector}\``);
     if (a.anchor.textFingerprint) lines.push(`- **Text:** \u201C${a.anchor.textFingerprint}\u201D`);
     if (a.anchor.context) lines.push(`- **Near:** ${a.anchor.context}`);
+    if (a.steps?.length) lines.push(`- **Reached by clicking:** ${a.steps.map(stepLabel).join(" \u2192 ")}`);
     if (a.viewport && Number.isFinite(a.viewport.width) && Number.isFinite(a.viewport.height)) lines.push(`- **Viewport:** ${a.viewport.width}\xD7${a.viewport.height}`);
     lines.push("");
   });
@@ -221,7 +230,8 @@ function newIssueUrl(repo, session, labels = [], maxLen = 7500) {
         context: void 0,
         textFingerprint: a.anchor.textFingerprint.slice(0, 40),
         rect: roundRect(a.anchor.rect)
-      }
+      },
+      steps: a.steps?.map((st) => ({ ...st, context: void 0, textFingerprint: st.textFingerprint.slice(0, 40), rect: roundRect(st.rect) }))
     }))
   };
   url = build(slim);
@@ -327,6 +337,7 @@ function themeToCssVars(theme) {
   DEFAULT_THEME,
   ISSUE_BLOCK_LANG,
   LABELS,
+  MAX_STEPS,
   PALETTE,
   buildSelector,
   createAnchor,
@@ -336,6 +347,7 @@ function themeToCssVars(theme) {
   resolveAnchor,
   resolveTheme,
   sessionToIssue,
+  stepLabel,
   themeToCssVars,
   uid
 });

package/dist/index.d.cts

@@ -39,7 +39,17 @@ interface Annotation {
     author?: string;
     /** Optional free-form tag chosen by the reviewer, e.g. "bug", "copy", "layout". */
     kind?: AnnotationKind;
+    /**
+     * Clicks the reviewer made on this page before leaving the note, oldest first (at most 5,
+     * reset on navigation). Screenshots replay them when the element isn't on the freshly
+     * loaded page, e.g. a note inside a modal. Element identities only, never typed values.
+     */
+    steps?: ElementAnchor[];
 }
+/** Most clicks kept per note. */
+declare const MAX_STEPS = 5;
+/** Short human label for a recorded click, e.g. `“Remove”` or `button#save`. */
+declare function stepLabel(step: Pick<ElementAnchor, 'tag' | 'textFingerprint' | 'selector'>): string;
 type AnnotationKind = 'bug' | 'copy' | 'layout' | 'visual' | 'flow' | 'question' | 'praise';
 interface ReviewSession {
     id: string;
@@ -220,4 +230,4 @@ declare function resolveTheme(overrides?: Partial<Theme>): Theme;
 /** `--pg-primary: #0F7B52; …` for every role. */
 declare function themeToCssVars(theme: Theme): string;
 
-export { type Annotation, type AnnotationKind, DEFAULT_FONTS_URL, DEFAULT_THEME, type ElementAnchor, ISSUE_BLOCK_LANG, LABELS, PALETTE, type Proposal, type ProposalPosition, type ProposalRun, type ReviewSession, type Theme, buildSelector, createAnchor, issueToSession, newIssueUrl, normalizeText, resolveAnchor, resolveTheme, sessionToIssue, themeToCssVars, uid };
+export { type Annotation, type AnnotationKind, DEFAULT_FONTS_URL, DEFAULT_THEME, type ElementAnchor, ISSUE_BLOCK_LANG, LABELS, MAX_STEPS, PALETTE, type Proposal, type ProposalPosition, type ProposalRun, type ReviewSession, type Theme, buildSelector, createAnchor, issueToSession, newIssueUrl, normalizeText, resolveAnchor, resolveTheme, sessionToIssue, stepLabel, themeToCssVars, uid };

package/dist/index.d.ts

@@ -39,7 +39,17 @@ interface Annotation {
     author?: string;
     /** Optional free-form tag chosen by the reviewer, e.g. "bug", "copy", "layout". */
     kind?: AnnotationKind;
+    /**
+     * Clicks the reviewer made on this page before leaving the note, oldest first (at most 5,
+     * reset on navigation). Screenshots replay them when the element isn't on the freshly
+     * loaded page, e.g. a note inside a modal. Element identities only, never typed values.
+     */
+    steps?: ElementAnchor[];
 }
+/** Most clicks kept per note. */
+declare const MAX_STEPS = 5;
+/** Short human label for a recorded click, e.g. `“Remove”` or `button#save`. */
+declare function stepLabel(step: Pick<ElementAnchor, 'tag' | 'textFingerprint' | 'selector'>): string;
 type AnnotationKind = 'bug' | 'copy' | 'layout' | 'visual' | 'flow' | 'question' | 'praise';
 interface ReviewSession {
     id: string;
@@ -220,4 +230,4 @@ declare function resolveTheme(overrides?: Partial<Theme>): Theme;
 /** `--pg-primary: #0F7B52; …` for every role. */
 declare function themeToCssVars(theme: Theme): string;
 
-export { type Annotation, type AnnotationKind, DEFAULT_FONTS_URL, DEFAULT_THEME, type ElementAnchor, ISSUE_BLOCK_LANG, LABELS, PALETTE, type Proposal, type ProposalPosition, type ProposalRun, type ReviewSession, type Theme, buildSelector, createAnchor, issueToSession, newIssueUrl, normalizeText, resolveAnchor, resolveTheme, sessionToIssue, themeToCssVars, uid };
+export { type Annotation, type AnnotationKind, DEFAULT_FONTS_URL, DEFAULT_THEME, type ElementAnchor, ISSUE_BLOCK_LANG, LABELS, MAX_STEPS, PALETTE, type Proposal, type ProposalPosition, type ProposalRun, type ReviewSession, type Theme, buildSelector, createAnchor, issueToSession, newIssueUrl, normalizeText, resolveAnchor, resolveTheme, sessionToIssue, stepLabel, themeToCssVars, uid };

package/dist/index.js

@@ -1,4 +1,10 @@
 // src/types.ts
+var MAX_STEPS = 5;
+function stepLabel(step) {
+  const t = (step.textFingerprint ?? "").trim();
+  if (t) return `\u201C${t.length > 40 ? t.slice(0, 39) + "\u2026" : t}\u201D`;
+  return step.selector.length > 60 ? step.tag : step.selector;
+}
 var LABELS = {
   root: "peanut-gallery",
   feedback: "peanut-gallery:feedback",
@@ -137,6 +143,7 @@ function sessionToIssue(session) {
     lines.push(`- **Element:** \`${a.anchor.tag ?? "?"}\` \u2192 \`${a.anchor.selector}\``);
     if (a.anchor.textFingerprint) lines.push(`- **Text:** \u201C${a.anchor.textFingerprint}\u201D`);
     if (a.anchor.context) lines.push(`- **Near:** ${a.anchor.context}`);
+    if (a.steps?.length) lines.push(`- **Reached by clicking:** ${a.steps.map(stepLabel).join(" \u2192 ")}`);
     if (a.viewport && Number.isFinite(a.viewport.width) && Number.isFinite(a.viewport.height)) lines.push(`- **Viewport:** ${a.viewport.width}\xD7${a.viewport.height}`);
     lines.push("");
   });
@@ -181,7 +188,8 @@ function newIssueUrl(repo, session, labels = [], maxLen = 7500) {
         context: void 0,
         textFingerprint: a.anchor.textFingerprint.slice(0, 40),
         rect: roundRect(a.anchor.rect)
-      }
+      },
+      steps: a.steps?.map((st) => ({ ...st, context: void 0, textFingerprint: st.textFingerprint.slice(0, 40), rect: roundRect(st.rect) }))
     }))
   };
   url = build(slim);
@@ -286,6 +294,7 @@ export {
   DEFAULT_THEME,
   ISSUE_BLOCK_LANG,
   LABELS,
+  MAX_STEPS,
   PALETTE,
   buildSelector,
   createAnchor,
@@ -295,6 +304,7 @@ export {
   resolveAnchor,
   resolveTheme,
   sessionToIssue,
+  stepLabel,
   themeToCssVars,
   uid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelatlarge/peanut-gallery-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Shared types, DOM anchoring, and GitHub issue serialization for peanut-gallery.",
   "keywords": [
     "prototype",