@popmelt.com/core 0.18.1 → 0.19.0

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
-import { P as PopmeltSubjectAdapter, A as Annotation, E as ElementInfo, a as AnnotationAttachment, S as SubjectFeedbackAttachment, b as StyleModification, T as TextModification, D as DomModification, c as SpacingTokenChange } from './subjects-CeqtFged.mjs';
-export { d as AnnotationType, B as BridgeStatus, C as ClaudeResponse, I as ImageObjectContext, O as OpaqueTargetReference, e as Point, f as PopmeltSubject, g as PopmeltSubjectBounds, h as PopmeltSubjectCreationSession, i as PopmeltSubjectTrackingAnchor, j as PopmeltSurfaceSnapshot, R as ReactSourceLocation, k as StyleChange, l as ToolType, V as VideoObjectContext } from './subjects-CeqtFged.mjs';
-import { I as ImageRecognitionProvider, V as VideoTrackingProvider, a as ImageSubjectAdapterOptions, b as VideoSubjectAdapterOptions } from './video-adapter-Gq8saCDn.mjs';
+import { A as Annotation, P as PopmeltSubjectAdapter, E as ElementInfo, a as AnnotationAttachment, S as SubjectFeedbackAttachment, b as StyleModification, T as TextModification, D as DomModification, c as SpacingTokenChange } from './subjects-C6Bu8uSX.mjs';
+export { d as AnnotationType, B as BridgeStatus, C as ClaudeResponse, I as ImageObjectContext, O as OpaqueTargetReference, e as Point, f as PopmeltSubject, g as PopmeltSubjectBounds, h as PopmeltSubjectCreationSession, i as PopmeltSubjectOutlinePoint, j as PopmeltSubjectTrackingAnchor, k as PopmeltSurfaceSnapshot, R as ReactSourceLocation, l as StyleChange, m as ToolType, V as VideoObjectContext } from './subjects-C6Bu8uSX.mjs';
+import { I as ImageRecognitionProvider, V as VideoTrackingProvider, a as VideoSegmentationProvider, b as ImageSubjectAdapterOptions, c as VideoSubjectAdapterOptions } from './video-adapter-UZ8OqP0O.mjs';
 
 /** Client-side envelope used for persisted and streaming bridge events. */
 type BridgeEvent = {
@@ -11,11 +11,35 @@ type BridgeEvent = {
     timestamp: number;
 };
 
+type CommentMetaValue = null | boolean | number | string | CommentMetaValue[] | {
+    [key: string]: CommentMetaValue;
+};
+/** User-owned, JSON-serializable context captured with a human comment turn. */
+type CommentMeta = Record<string, CommentMetaValue>;
+type CommentMetaContext = {
+    kind: 'annotation';
+    timestamp: number;
+    url: string;
+    pathname: string;
+    annotations: readonly Readonly<Annotation>[];
+} | {
+    kind: 'reply';
+    timestamp: number;
+    url: string;
+    pathname: string;
+    threadId: string;
+    reply: string;
+    annotations: readonly Readonly<Annotation>[];
+};
+type GetCommentMeta = (context: CommentMetaContext) => CommentMeta | undefined | Promise<CommentMeta | undefined>;
+
 type PopmeltExtensionRuntime = {
     /** Optional perception contribution for Core's built-in image adapter. */
     imageRecognition?: ImageRecognitionProvider;
     /** Optional perception contribution for Core's built-in video adapter. */
     videoTracking?: VideoTrackingProvider;
+    /** Optional point-prompted perception for Core's built-in video adapter. */
+    videoSegmentation?: VideoSegmentationProvider;
     /** Optional non-DOM subject adapters contributed by the extension. */
     subjectAdapters?: readonly PopmeltSubjectAdapter[];
     /** Release extension-owned resources. */
@@ -63,8 +87,10 @@ type PopmeltProviderProps = PropsWithChildren<{
     imageAnnotation?: boolean | ImageAnnotationOptions;
     /** Manual video annotation is on by default; See may contribute tracking. */
     videoAnnotation?: boolean | VideoAnnotationOptions;
+    /** Capture application-owned JSON context with each submitted human turn. */
+    getCommentMeta?: GetCommentMeta;
 }>;
-declare function PopmeltProvider({ children, enabled, bridgeUrl, projectId: projectIdProp, navigate: navigateProp, subjectAdapters, extensions, imageAnnotation, videoAnnotation, }: PopmeltProviderProps): react.JSX.Element;
+declare function PopmeltProvider({ children, enabled, bridgeUrl, projectId: projectIdProp, navigate: navigateProp, subjectAdapters, extensions, imageAnnotation, videoAnnotation, getCommentMeta, }: PopmeltProviderProps): react.JSX.Element;
 
 type AnnotationData = {
     id: string;
@@ -96,6 +122,7 @@ type FeedbackData = {
     domModifications?: DomModification[];
     inspectedElement?: ElementInfo;
     spacingTokenChanges?: SpacingTokenChange[];
+    meta?: CommentMeta;
 };
 
-export { Annotation, type BridgeEvent, ElementInfo, type FeedbackData, type ImageAnnotationOptions, type PopmeltExtension, type PopmeltExtensionRuntime, PopmeltProvider, type PopmeltProviderProps, PopmeltSubjectAdapter, StyleModification, type VideoAnnotationOptions, usePopmelt };
+export { Annotation, type BridgeEvent, type CommentMeta, type CommentMetaContext, type CommentMetaValue, ElementInfo, type FeedbackData, type GetCommentMeta, type ImageAnnotationOptions, type PopmeltExtension, type PopmeltExtensionRuntime, PopmeltProvider, type PopmeltProviderProps, PopmeltSubjectAdapter, StyleModification, type VideoAnnotationOptions, usePopmelt };