agentation 2.3.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,9 +1,14 @@
1
- <img src="https://raw.githubusercontent.com/benjitaylor/agentation/main/package/logo.svg" alt="Agentation" width="50" />
1
+ <picture>
2
+ <source media="(prefers-color-scheme: dark)" srcset="logo-dark.svg">
3
+ <img src="logo.svg" alt="Agentation" width="200">
4
+ </picture>
5
+
6
+ <br>
2
7
 
3
8
  [![npm version](https://img.shields.io/npm/v/agentation)](https://www.npmjs.com/package/agentation)
4
9
  [![downloads](https://img.shields.io/npm/dm/agentation)](https://www.npmjs.com/package/agentation)
5
10
 
6
- **[Agentation](https://agentation.dev)** is an agent-agnostic visual feedback tool. Click elements on your page, add notes, and copy structured output that helps AI coding agents find the exact code you're referring to.
11
+ **[Agentation](https://agentation.com)** is an agent-agnostic visual feedback tool. Click elements on your page, add notes, and copy structured output that helps AI coding agents find the exact code you're referring to.
7
12
 
8
13
  ## Install
9
14
 
@@ -113,7 +118,7 @@ type Annotation = {
113
118
  };
114
119
  ```
115
120
 
116
- > **Note:** This is a simplified type. The full type includes additional fields for Agent Sync (`url`, `status`, `thread`, `reactComponents`, etc.). See [agentation.dev/schema](https://agentation.dev/schema) for the complete schema.
121
+ > **Note:** This is a simplified type. The full type includes additional fields for Agent Sync (`url`, `status`, `thread`, `reactComponents`, etc.). See [agentation.com/schema](https://agentation.com/schema) for the complete schema.
117
122
 
118
123
  ## How it works
119
124
 
@@ -126,7 +131,7 @@ Agentation captures class names, selectors, and element positions so AI agents c
126
131
 
127
132
  ## Docs
128
133
 
129
- Full documentation at [agentation.dev](https://agentation.dev)
134
+ Full documentation at [agentation.com](https://agentation.com)
130
135
 
131
136
  ## License
132
137
 
package/dist/index.d.mts CHANGED
@@ -26,12 +26,38 @@ type Annotation = {
26
26
  isFixed?: boolean;
27
27
  reactComponents?: string;
28
28
  sourceFile?: string;
29
+ drawingIndex?: number;
29
30
  elementBoundingBoxes?: Array<{
30
31
  x: number;
31
32
  y: number;
32
33
  width: number;
33
34
  height: number;
34
35
  }>;
36
+ kind?: "feedback" | "placement" | "rearrange";
37
+ placement?: {
38
+ componentType: string;
39
+ width: number;
40
+ height: number;
41
+ scrollY: number;
42
+ text?: string;
43
+ };
44
+ rearrange?: {
45
+ selector: string;
46
+ label: string;
47
+ tagName: string;
48
+ originalRect: {
49
+ x: number;
50
+ y: number;
51
+ width: number;
52
+ height: number;
53
+ };
54
+ currentRect: {
55
+ x: number;
56
+ y: number;
57
+ width: number;
58
+ height: number;
59
+ };
60
+ };
35
61
  sessionId?: string;
36
62
  url?: string;
37
63
  intent?: AnnotationIntent;
@@ -145,24 +171,25 @@ declare const IconListSparkle: ({ size, style, }: {
145
171
  size?: number;
146
172
  style?: React.CSSProperties;
147
173
  }) => react_jsx_runtime.JSX.Element;
148
- declare const IconHelp: ({ size }: {
174
+ declare const IconHelp: ({ size, ...props }: {
149
175
  size?: number;
150
- }) => react_jsx_runtime.JSX.Element;
176
+ } & React.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
151
177
  declare const IconCheckSmallAnimated: ({ size }: {
152
178
  size?: number;
153
179
  }) => react_jsx_runtime.JSX.Element;
154
180
  declare const IconCopyAlt: ({ size }: {
155
181
  size?: number;
156
182
  }) => react_jsx_runtime.JSX.Element;
157
- declare const IconCopyAnimated: ({ size, copied }: {
183
+ declare const IconCopyAnimated: ({ size, copied, tint, }: {
158
184
  size?: number;
159
185
  copied?: boolean;
186
+ tint?: string;
160
187
  }) => react_jsx_runtime.JSX.Element;
161
- declare const IconSendArrow: ({ size, state }: {
188
+ declare const IconSendArrow: ({ size, state, }: {
162
189
  size?: number;
163
190
  state?: "idle" | "sending" | "sent" | "failed";
164
191
  }) => react_jsx_runtime.JSX.Element;
165
- declare const IconSendAnimated: ({ size, sent }: {
192
+ declare const IconSendAnimated: ({ size, sent, }: {
166
193
  size?: number;
167
194
  sent?: boolean;
168
195
  }) => react_jsx_runtime.JSX.Element;
@@ -175,11 +202,11 @@ declare const IconEyeAlt: ({ size }: {
175
202
  declare const IconEyeClosed: ({ size }: {
176
203
  size?: number;
177
204
  }) => react_jsx_runtime.JSX.Element;
178
- declare const IconEyeAnimated: ({ size, isOpen }: {
205
+ declare const IconEyeAnimated: ({ size, isOpen, }: {
179
206
  size?: number;
180
207
  isOpen?: boolean;
181
208
  }) => react_jsx_runtime.JSX.Element;
182
- declare const IconPausePlayAnimated: ({ size, isPaused }: {
209
+ declare const IconPausePlayAnimated: ({ size, isPaused, }: {
183
210
  size?: number;
184
211
  isPaused?: boolean;
185
212
  }) => react_jsx_runtime.JSX.Element;
@@ -242,6 +269,9 @@ declare const AnimatedBunny: ({ size, color, }: {
242
269
  size?: number;
243
270
  color?: string;
244
271
  }) => react_jsx_runtime.JSX.Element;
272
+ declare const IconLayout: ({ size }: {
273
+ size?: number;
274
+ }) => react_jsx_runtime.JSX.Element;
245
275
 
246
276
  /**
247
277
  * Finds the closest ancestor matching a selector, crossing shadow DOM boundaries.
@@ -284,4 +314,4 @@ declare function getStorageKey(pathname: string): string;
284
314
  declare function loadAnnotations<T = Annotation>(pathname: string): T[];
285
315
  declare function saveAnnotations<T = Annotation>(pathname: string, annotations: T[]): void;
286
316
 
287
- export { PageFeedbackToolbarCSS as Agentation, type AgentationProps, AnimatedBunny, type Annotation, AnnotationPopupCSS, type AnnotationPopupCSSHandle, type AnnotationPopupCSSProps, type DemoAnnotation, IconChatEllipsis, IconCheck, IconCheckSmall, IconCheckSmallAnimated, IconCheckmark, IconCheckmarkCircle, IconCheckmarkLarge, IconChevronLeft, IconChevronRight, IconClose, IconCopyAlt, IconCopyAnimated, IconEdit, IconEye, IconEyeAlt, IconEyeAnimated, IconEyeClosed, IconEyeMinus, IconGear, IconHelp, IconListSparkle, IconMoon, IconPause, IconPauseAlt, IconPausePlayAnimated, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };
317
+ export { PageFeedbackToolbarCSS as Agentation, type AgentationProps, AnimatedBunny, type Annotation, AnnotationPopupCSS, type AnnotationPopupCSSHandle, type AnnotationPopupCSSProps, type DemoAnnotation, IconChatEllipsis, IconCheck, IconCheckSmall, IconCheckSmallAnimated, IconCheckmark, IconCheckmarkCircle, IconCheckmarkLarge, IconChevronLeft, IconChevronRight, IconClose, IconCopyAlt, IconCopyAnimated, IconEdit, IconEye, IconEyeAlt, IconEyeAnimated, IconEyeClosed, IconEyeMinus, IconGear, IconHelp, IconLayout, IconListSparkle, IconMoon, IconPause, IconPauseAlt, IconPausePlayAnimated, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };
package/dist/index.d.ts CHANGED
@@ -26,12 +26,38 @@ type Annotation = {
26
26
  isFixed?: boolean;
27
27
  reactComponents?: string;
28
28
  sourceFile?: string;
29
+ drawingIndex?: number;
29
30
  elementBoundingBoxes?: Array<{
30
31
  x: number;
31
32
  y: number;
32
33
  width: number;
33
34
  height: number;
34
35
  }>;
36
+ kind?: "feedback" | "placement" | "rearrange";
37
+ placement?: {
38
+ componentType: string;
39
+ width: number;
40
+ height: number;
41
+ scrollY: number;
42
+ text?: string;
43
+ };
44
+ rearrange?: {
45
+ selector: string;
46
+ label: string;
47
+ tagName: string;
48
+ originalRect: {
49
+ x: number;
50
+ y: number;
51
+ width: number;
52
+ height: number;
53
+ };
54
+ currentRect: {
55
+ x: number;
56
+ y: number;
57
+ width: number;
58
+ height: number;
59
+ };
60
+ };
35
61
  sessionId?: string;
36
62
  url?: string;
37
63
  intent?: AnnotationIntent;
@@ -145,24 +171,25 @@ declare const IconListSparkle: ({ size, style, }: {
145
171
  size?: number;
146
172
  style?: React.CSSProperties;
147
173
  }) => react_jsx_runtime.JSX.Element;
148
- declare const IconHelp: ({ size }: {
174
+ declare const IconHelp: ({ size, ...props }: {
149
175
  size?: number;
150
- }) => react_jsx_runtime.JSX.Element;
176
+ } & React.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
151
177
  declare const IconCheckSmallAnimated: ({ size }: {
152
178
  size?: number;
153
179
  }) => react_jsx_runtime.JSX.Element;
154
180
  declare const IconCopyAlt: ({ size }: {
155
181
  size?: number;
156
182
  }) => react_jsx_runtime.JSX.Element;
157
- declare const IconCopyAnimated: ({ size, copied }: {
183
+ declare const IconCopyAnimated: ({ size, copied, tint, }: {
158
184
  size?: number;
159
185
  copied?: boolean;
186
+ tint?: string;
160
187
  }) => react_jsx_runtime.JSX.Element;
161
- declare const IconSendArrow: ({ size, state }: {
188
+ declare const IconSendArrow: ({ size, state, }: {
162
189
  size?: number;
163
190
  state?: "idle" | "sending" | "sent" | "failed";
164
191
  }) => react_jsx_runtime.JSX.Element;
165
- declare const IconSendAnimated: ({ size, sent }: {
192
+ declare const IconSendAnimated: ({ size, sent, }: {
166
193
  size?: number;
167
194
  sent?: boolean;
168
195
  }) => react_jsx_runtime.JSX.Element;
@@ -175,11 +202,11 @@ declare const IconEyeAlt: ({ size }: {
175
202
  declare const IconEyeClosed: ({ size }: {
176
203
  size?: number;
177
204
  }) => react_jsx_runtime.JSX.Element;
178
- declare const IconEyeAnimated: ({ size, isOpen }: {
205
+ declare const IconEyeAnimated: ({ size, isOpen, }: {
179
206
  size?: number;
180
207
  isOpen?: boolean;
181
208
  }) => react_jsx_runtime.JSX.Element;
182
- declare const IconPausePlayAnimated: ({ size, isPaused }: {
209
+ declare const IconPausePlayAnimated: ({ size, isPaused, }: {
183
210
  size?: number;
184
211
  isPaused?: boolean;
185
212
  }) => react_jsx_runtime.JSX.Element;
@@ -242,6 +269,9 @@ declare const AnimatedBunny: ({ size, color, }: {
242
269
  size?: number;
243
270
  color?: string;
244
271
  }) => react_jsx_runtime.JSX.Element;
272
+ declare const IconLayout: ({ size }: {
273
+ size?: number;
274
+ }) => react_jsx_runtime.JSX.Element;
245
275
 
246
276
  /**
247
277
  * Finds the closest ancestor matching a selector, crossing shadow DOM boundaries.
@@ -284,4 +314,4 @@ declare function getStorageKey(pathname: string): string;
284
314
  declare function loadAnnotations<T = Annotation>(pathname: string): T[];
285
315
  declare function saveAnnotations<T = Annotation>(pathname: string, annotations: T[]): void;
286
316
 
287
- export { PageFeedbackToolbarCSS as Agentation, type AgentationProps, AnimatedBunny, type Annotation, AnnotationPopupCSS, type AnnotationPopupCSSHandle, type AnnotationPopupCSSProps, type DemoAnnotation, IconChatEllipsis, IconCheck, IconCheckSmall, IconCheckSmallAnimated, IconCheckmark, IconCheckmarkCircle, IconCheckmarkLarge, IconChevronLeft, IconChevronRight, IconClose, IconCopyAlt, IconCopyAnimated, IconEdit, IconEye, IconEyeAlt, IconEyeAnimated, IconEyeClosed, IconEyeMinus, IconGear, IconHelp, IconListSparkle, IconMoon, IconPause, IconPauseAlt, IconPausePlayAnimated, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };
317
+ export { PageFeedbackToolbarCSS as Agentation, type AgentationProps, AnimatedBunny, type Annotation, AnnotationPopupCSS, type AnnotationPopupCSSHandle, type AnnotationPopupCSSProps, type DemoAnnotation, IconChatEllipsis, IconCheck, IconCheckSmall, IconCheckSmallAnimated, IconCheckmark, IconCheckmarkCircle, IconCheckmarkLarge, IconChevronLeft, IconChevronRight, IconClose, IconCopyAlt, IconCopyAnimated, IconEdit, IconEye, IconEyeAlt, IconEyeAnimated, IconEyeClosed, IconEyeMinus, IconGear, IconHelp, IconLayout, IconListSparkle, IconMoon, IconPause, IconPauseAlt, IconPausePlayAnimated, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };