@popmelt.com/core 0.15.0 → 0.17.0

package/dist/index.d.mts

@@ -1,31 +1,7 @@
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
-
-declare const STICKER_COLOR_NAMES: readonly ["slate", "gray", "zinc", "neutral", "stone", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose"];
-type StickerColorName = (typeof STICKER_COLOR_NAMES)[number];
-declare const STICKER_COLOR_STEPS: readonly [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950];
-type StickerColorStep = (typeof STICKER_COLOR_STEPS)[number];
-
-declare const STICKER_FAMILIES: readonly ["padding", "margin", "border", "radius", "stack", "grid", "text", "color", "transform", "opacity"];
-type StickerFamily = (typeof STICKER_FAMILIES)[number];
-declare const SPACING_STEPS: readonly [0, 1, 2, 3, 4, 6, 8, 10, 12, 16];
-declare const TRANSLATE_STEPS: readonly [-16, -12, -10, -8, -6, -4, -3, -2, -1, 0, 1, 2, 3, 4, 6, 8, 10, 12, 16];
-declare const BORDER_STEPS: readonly [0, 1, 2, 4, 8];
-declare const DIRECTION_STEPS: readonly ["vertical", "horizontal"];
-declare const ALIGN_STEPS: readonly ["stretch", "start", "center", "end", "baseline"];
-declare const JUSTIFY_STEPS: readonly ["start", "center", "end", "between", "around", "evenly"];
-declare const GRID_COUNT_STEPS: readonly [1, 2, 3, 4, 5, 6];
-declare const FONT_SIZE_STEPS: readonly ["xs", "sm", "base", "lg", "xl", "2xl", "3xl", "4xl"];
-declare const FONT_WEIGHT_STEPS: readonly [300, 400, 500, 600, 700, 800];
-declare const LINE_HEIGHT_STEPS: readonly ["none", "tight", "snug", "normal", "relaxed", "loose"];
-declare const LETTER_SPACING_STEPS: readonly ["tighter", "tight", "normal", "wide", "wider", "widest"];
-declare const TEXT_ALIGN_STEPS: readonly ["left", "center", "right", "justify"];
-declare const SCALE_STEPS: readonly [25, 50, 75, 90, 95, 100, 105, 110, 125, 150];
-declare const ROTATE_STEPS: readonly [-180, -90, -45, -25, -12, -6, -3, -2, -1, 0, 1, 2, 3, 6, 12, 25, 45, 90, 180];
-declare const OPACITY_STEPS: readonly [0, 5, 10, 20, 25, 30, 40, 50, 60, 70, 75, 80, 90, 95, 100];
-declare const MIX_BLEND_STEPS: readonly ["normal", "multiply", "screen", "overlay", "darken", "lighten", "color-dodge", "color-burn", "hard-light", "soft-light", "difference", "exclusion", "hue", "saturation", "color", "luminosity"];
-type StickerStep = (typeof SPACING_STEPS)[number] | (typeof BORDER_STEPS)[number] | (typeof DIRECTION_STEPS)[number] | (typeof ALIGN_STEPS)[number] | (typeof JUSTIFY_STEPS)[number] | (typeof GRID_COUNT_STEPS)[number] | (typeof FONT_SIZE_STEPS)[number] | (typeof FONT_WEIGHT_STEPS)[number] | (typeof LINE_HEIGHT_STEPS)[number] | (typeof LETTER_SPACING_STEPS)[number] | (typeof TEXT_ALIGN_STEPS)[number] | (typeof TRANSLATE_STEPS)[number] | (typeof SCALE_STEPS)[number] | (typeof ROTATE_STEPS)[number] | (typeof OPACITY_STEPS)[number] | (typeof MIX_BLEND_STEPS)[number] | StickerColorStep;
-type StickerSubproperty = 'all' | 'x' | 'y' | 'top' | 'right' | 'bottom' | 'left' | 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left' | 'vertical' | 'horizontal' | 'direction' | 'gap' | 'align' | 'justify' | 'rows' | 'columns' | 'size' | 'weight' | 'line-height' | 'letter-spacing' | 'text-align' | 'color' | 'translate' | 'scale' | 'rotate' | 'opacity' | 'mix-blend' | StickerColorName;
+import { I as ImageRecognitionProvider, V as VideoTrackingProvider, P as PopmeltSubjectAdapter, a as ImageSubjectAdapterOptions, b as VideoSubjectAdapterOptions, A as Annotation, E as ElementInfo, c as AnnotationAttachment, S as SubjectFeedbackAttachment, d as StyleModification, T as TextModification, D as DomModification, e as SpacingTokenChange } from './video-adapter-cDwq4uNP.mjs';
+export { f as AnnotationType, B as BridgeStatus, C as ClaudeResponse, g as ImageObjectContext, O as OpaqueTargetReference, h as Point, i as PopmeltSubject, j as PopmeltSubjectBounds, k as PopmeltSubjectCreationSession, l as PopmeltSubjectTrackingAnchor, m as PopmeltSurfaceSnapshot, R as ReactSourceLocation, n as StyleChange, o as ToolType, p as VideoObjectContext } from './video-adapter-cDwq4uNP.mjs';
 
 /** Client-side envelope used for persisted and streaming bridge events. */
 type BridgeEvent = {
@@ -34,207 +10,28 @@ type BridgeEvent = {
     timestamp: number;
 };
 
-type AnnotationLifecycleStatus = 'pending' | 'sending' | 'in_flight' | 'resolved' | 'needs_review' | 'dismissed' | 'waiting_input' | 'failed';
-type ScopeBreadth = 'instance' | 'pattern';
-type ScopeTarget = 'element' | 'component' | 'token';
-type Scope = {
-    breadth: ScopeBreadth;
-    target: ScopeTarget;
-};
-declare const TOOL_TYPES: readonly ["inspector", "sticker", "model"];
-type ToolType = (typeof TOOL_TYPES)[number];
-declare const LEGACY_ANNOTATION_TYPES: readonly ["freehand", "line", "rectangle", "circle"];
-type LegacyAnnotationType = (typeof LEGACY_ANNOTATION_TYPES)[number];
-type AnnotationType = LegacyAnnotationType | 'text';
-type Point = {
-    x: number;
-    y: number;
-};
-type AnnotationRevealStep = {
-    triggerSelector: string;
-    targetSelector?: string;
-    label: string;
-};
-type AnnotationRevealRecipe = {
-    steps: AnnotationRevealStep[];
-    location: string[];
-};
-type ElementInfo = {
-    selector: string;
-    tagName: string;
-    /** Adapter-owned semantic name for a non-DOM subject. */
-    subjectLabel?: string;
-    id?: string;
-    className?: string;
-    textContent?: string;
-    dataAttributes?: Record<string, string>;
-    reactComponent?: string;
-    context?: string;
-    revealRecipe?: AnnotationRevealRecipe;
-};
-/** Renderer-owned identity for a target that does not exist as a DOM node. */
-type OpaqueTargetReference = {
-    adapter: string;
-    key: string;
-};
-type StyleChange = {
-    property: string;
-    original: string;
-    modified: string;
-    token?: string;
-    sticker?: {
-        family: StickerFamily;
-        subproperty: StickerSubproperty;
-        step: StickerStep;
-        axisSteps?: {
-            x: StickerStep;
-            y: StickerStep;
-        };
-    };
-};
-type StyleModification = {
-    selector: string;
-    durableSelector?: string;
-    element: ElementInfo;
-    changes: StyleChange[];
-    createdAt?: number;
-    annotationNumber?: number;
-    captured?: boolean;
-    pathname?: string;
-};
-type TextModification = {
-    selector: string;
-    durableSelector?: string;
-    element: ElementInfo;
-    textNodePath: number[];
-    original: string;
-    modified: string;
-    createdAt?: number;
-    annotationNumber?: number;
-    captured?: boolean;
-    pathname?: string;
-};
-type DomInsertionPlacement = 'before' | 'after';
-type DomModification = {
-    id: string;
-    operation: 'move' | 'copy';
-    selector: string;
-    durableSelector?: string;
-    element: ElementInfo;
-    sourceSelector?: string;
-    sourceDurableSelector?: string;
-    sourceElement?: ElementInfo;
-    originalParentSelector?: string;
-    originalParentDurableSelector?: string;
-    originalIndex?: number;
-    targetParentSelector: string;
-    targetParentDurableSelector?: string;
-    targetIndex: number;
-    referenceSelector?: string;
-    referenceDurableSelector?: string;
-    placement: DomInsertionPlacement;
-    captured?: boolean;
-    pathname?: string;
-};
-type SpacingElementEvidence = {
-    selector: string;
-    reactComponent?: string;
-    className: string;
-    property: string;
-    matchedClass?: string;
-    suggestedClass?: string;
-};
-type SpacingTokenChange = {
-    id: string;
-    tokenPath: string;
-    tokenName: string;
-    originalPx: number;
-    newPx: number;
-    captured?: boolean;
-    affectedElements: SpacingElementEvidence[];
-};
-type AnnotationAttachment = {
-    id: string;
-    name: string;
-    mimeType: string;
-    size: number;
-    kind: 'svg' | 'text';
+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 non-DOM subject adapters contributed by the extension. */
+    subjectAdapters?: readonly PopmeltSubjectAdapter[];
+    /** Release extension-owned resources. */
+    dispose?(): void | Promise<void>;
 };
-type Annotation = {
+type PopmeltExtension = {
+    /** Stable package-level identity used to reconcile extension configuration. */
     id: string;
-    type: AnnotationType;
-    points: Point[];
-    color: string;
-    strokeWidth: number;
-    text?: string;
-    fontSize?: number;
-    timestamp: number;
-    groupId?: string;
-    captured?: boolean;
-    status?: AnnotationLifecycleStatus;
-    question?: string;
-    resolutionSummary?: string;
-    scope?: Scope | null;
-    replyCount?: number;
-    replyJobIds?: string[];
-    threadId?: string;
-    targetBindingId?: string;
-    target?: OpaqueTargetReference;
-    pathname?: string;
-    elements?: ElementInfo[];
-    linkedSelector?: string;
-    linkedAnchor?: 'top-left' | 'bottom-left';
-    imageCount?: number;
-    attachments?: AnnotationAttachment[];
-};
-type BridgeStatus = {
-    ok: boolean;
-    activeJob: {
-        id: string;
-        status: string;
-    } | null;
-    queueDepth: number;
-    sessionId: string | null;
-};
-type ClaudeResponse = {
-    jobId: string;
-    sessionId?: string;
-    text: string;
-    success: boolean;
-    toolsUsed: string[];
+    /** Stable signature for configuration changes that require reactivation. */
+    configurationKey: string;
+    /** Activate lazily after the Core provider mounts in the browser. */
+    activate(): PopmeltExtensionRuntime;
 };
 
-type PopmeltSubjectBounds = {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-};
-type PopmeltSubject = {
-    key: string;
-    label: string;
-    bounds: PopmeltSubjectBounds;
-    context?: string;
-    data?: Record<string, string>;
-};
-type PopmeltSurfaceSnapshot = {
-    element: HTMLCanvasElement;
-    dataUrl: string;
-};
-/**
- * Minimal renderer boundary for non-DOM subjects. The adapter owns hit testing,
- * durable keys, and viewport projection; Popmelt owns annotations and threads.
- */
-type PopmeltSubjectAdapter = {
-    id: string;
-    hitTest(clientPoint: {
-        x: number;
-        y: number;
-    }): PopmeltSubject | null;
-    resolve(key: string): PopmeltSubject | null;
-    /** Optional bitmap capture for renderer surfaces that DOM cloning cannot read. */
-    captureSurfaces?(): readonly PopmeltSurfaceSnapshot[] | Promise<readonly PopmeltSurfaceSnapshot[]>;
-};
+type ImageAnnotationOptions = Omit<ImageSubjectAdapterOptions, 'id'>;
+
+type VideoAnnotationOptions = Omit<VideoSubjectAdapterOptions, 'id'>;
 
 declare global {
     interface Window {
@@ -256,8 +53,14 @@ type PopmeltProviderProps = PropsWithChildren<{
     navigate?: (url: string) => void | Promise<unknown>;
     /** Optional non-DOM renderer adapters, such as Three.js scene subjects. */
     subjectAdapters?: readonly PopmeltSubjectAdapter[];
+    /** Optional packages that contribute perception or additional subject surfaces. */
+    extensions?: readonly PopmeltExtension[];
+    /** Manual image annotation is enabled by default; false disables the built-in adapter. */
+    imageAnnotation?: boolean | ImageAnnotationOptions;
+    /** Manual video annotation is on by default; See may contribute tracking. */
+    videoAnnotation?: boolean | VideoAnnotationOptions;
 }>;
-declare function PopmeltProvider({ children, enabled, bridgeUrl, projectId: projectIdProp, navigate: navigateProp, subjectAdapters, }: PopmeltProviderProps): react.JSX.Element;
+declare function PopmeltProvider({ children, enabled, bridgeUrl, projectId: projectIdProp, navigate: navigateProp, subjectAdapters, extensions, imageAnnotation, videoAnnotation, }: PopmeltProviderProps): react.JSX.Element;
 declare function usePopmelt(): PopmeltContextValue;
 
 type AnnotationData = {
@@ -270,6 +73,7 @@ type AnnotationData = {
     elements: ElementInfo[];
     imageCount?: number;
     attachments?: AnnotationAttachment[];
+    subjectFeedback?: SubjectFeedbackAttachment;
 };
 type FeedbackData = {
     timestamp: string;
@@ -290,4 +94,4 @@ type FeedbackData = {
     spacingTokenChanges?: SpacingTokenChange[];
 };
 
-export { type Annotation, type AnnotationType, type BridgeEvent, type BridgeStatus, type ClaudeResponse, type ElementInfo, type FeedbackData, type OpaqueTargetReference, type Point, PopmeltProvider, type PopmeltSubject, type PopmeltSubjectAdapter, type PopmeltSubjectBounds, type PopmeltSurfaceSnapshot, type StyleChange, type StyleModification, type ToolType, usePopmelt };
+export { Annotation, type BridgeEvent, ElementInfo, type FeedbackData, type ImageAnnotationOptions, type PopmeltExtension, type PopmeltExtensionRuntime, PopmeltProvider, type PopmeltProviderProps, PopmeltSubjectAdapter, StyleModification, type VideoAnnotationOptions, usePopmelt };