@critique.work/agentation 2.2.2 → 2.4.0

package/dist/index.d.mts

@@ -33,6 +33,9 @@ type Annotation = {
     }>;
     drawingIndex?: number;
     strokeId?: string;
+    lineText?: string;
+    contextBefore?: string[];
+    contextAfter?: string[];
     sessionId?: string;
     url?: string;
     intent?: AnnotationIntent;
@@ -273,6 +276,21 @@ declare function identifyElement(target: HTMLElement): {
  * Gets text content from element and siblings for context
  */
 declare function getNearbyText(element: HTMLElement): string;
+/**
+ * Surrounding context from sibling nodes in a repeated structure.
+ * Walks up the DOM to find the nearest ancestor that is one of many
+ * siblings (e.g. lines in a diff, rows in a table, items in a list),
+ * then collects text from N siblings before and after.
+ */
+interface SurroundingContext {
+    /** Text of the node the annotation is on */
+    lineText: string;
+    /** Text of preceding sibling nodes (oldest first) */
+    contextBefore: string[];
+    /** Text of following sibling nodes (closest first) */
+    contextAfter: string[];
+}
+declare function getSurroundingNodes(element: HTMLElement, radius?: number): SurroundingContext | null;
 /**
  * Simplified element identifier for animation feedback (less verbose)
  */
@@ -286,4 +304,4 @@ declare function getStorageKey(pathname: string): string;
 declare function loadAnnotations<T = Annotation>(pathname: string): T[];
 declare function saveAnnotations<T = Annotation>(pathname: string, annotations: T[]): void;
 
-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, IconPencil, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };
+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, IconPencil, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, type SurroundingContext, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, getSurroundingNodes, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };

package/dist/index.d.ts

@@ -33,6 +33,9 @@ type Annotation = {
     }>;
     drawingIndex?: number;
     strokeId?: string;
+    lineText?: string;
+    contextBefore?: string[];
+    contextAfter?: string[];
     sessionId?: string;
     url?: string;
     intent?: AnnotationIntent;
@@ -273,6 +276,21 @@ declare function identifyElement(target: HTMLElement): {
  * Gets text content from element and siblings for context
  */
 declare function getNearbyText(element: HTMLElement): string;
+/**
+ * Surrounding context from sibling nodes in a repeated structure.
+ * Walks up the DOM to find the nearest ancestor that is one of many
+ * siblings (e.g. lines in a diff, rows in a table, items in a list),
+ * then collects text from N siblings before and after.
+ */
+interface SurroundingContext {
+    /** Text of the node the annotation is on */
+    lineText: string;
+    /** Text of preceding sibling nodes (oldest first) */
+    contextBefore: string[];
+    /** Text of following sibling nodes (closest first) */
+    contextAfter: string[];
+}
+declare function getSurroundingNodes(element: HTMLElement, radius?: number): SurroundingContext | null;
 /**
  * Simplified element identifier for animation feedback (less verbose)
  */
@@ -286,4 +304,4 @@ declare function getStorageKey(pathname: string): string;
 declare function loadAnnotations<T = Annotation>(pathname: string): T[];
 declare function saveAnnotations<T = Annotation>(pathname: string, annotations: T[]): void;
 
-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, IconPencil, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };
+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, IconPencil, IconPlayAlt, IconPlus, IconSendAnimated, IconSendArrow, IconSun, IconTrash, IconTrashAlt, IconXmark, IconXmarkLarge, PageFeedbackToolbarCSS, type SurroundingContext, closestCrossingShadow, getElementClasses, getElementPath, getNearbyText, getShadowHost, getStorageKey, getSurroundingNodes, identifyAnimationElement, identifyElement, isInShadowDOM, loadAnnotations, saveAnnotations };