agentation 2.3.3 → 3.0.1
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 +9 -4
- package/dist/index.d.mts +36 -6
- package/dist/index.d.ts +36 -6
- package/dist/index.js +7379 -1760
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +7372 -1754
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,9 +1,14 @@
|
|
|
1
|
-
<
|
|
1
|
+
<picture>
|
|
2
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/benjitaylor/agentation/main/package/logo-dark.svg">
|
|
3
|
+
<img src="https://raw.githubusercontent.com/benjitaylor/agentation/main/package/logo.svg" alt="Agentation" width="200">
|
|
4
|
+
</picture>
|
|
5
|
+
|
|
6
|
+
<br>
|
|
2
7
|
|
|
3
8
|
[](https://www.npmjs.com/package/agentation)
|
|
4
9
|
[](https://www.npmjs.com/package/agentation)
|
|
5
10
|
|
|
6
|
-
**[Agentation](https://agentation.
|
|
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.
|
|
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.
|
|
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;
|
|
@@ -154,15 +180,16 @@ declare const IconCheckSmallAnimated: ({ size }: {
|
|
|
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;
|
|
@@ -154,15 +180,16 @@ declare const IconCheckSmallAnimated: ({ size }: {
|
|
|
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 };
|