@popmelt.com/core 0.20.3 → 0.21.0

package/dist/media.d.mts

@@ -1,5 +1,5 @@
-import { d as ImageObjectBox, e as VideoSubjectStore, f as VideoObjectBox } from './video-adapter-C5qDzl4Q.mjs';
-export { B as BrowserImageSubjectStoreOptions, g as ImageContentHasher, h as ImageObjectObservation, I as ImageRecognitionProvider, i as ImageSubjectAdapter, b as ImageSubjectAdapterOptions, j as ImageSubjectStore, P as PersistedImageAnalysis, k as PersistedImageSubject, l as PersistedImageSuppression, m as PersistedVideoAnalysis, n as PersistedVideoTrack, o as VideoBackwardAnalysisOptions, p as VideoBackwardAnalysisResult, q as VideoMotionAttempt, r as VideoMotionPolicy, s as VideoMotionPresenceDecision, t as VideoMotionState, u as VideoSegmentationObservation, v as VideoSegmentationPoint, a as VideoSegmentationProvider, w as VideoSubjectAdapter, c as VideoSubjectAdapterOptions, x as VideoTrackKeyframe, y as VideoTrackObservation, z as VideoTrackSegment, A as VideoTrackSmoother, C as VideoTrackingAnchor, D as VideoTrackingAttempt, V as VideoTrackingProvider, E as VideoTrackingSeed, F as VideoTrackingSession, G as createBrowserImageSubjectStore, H as createImageSubjectAdapter, J as createMemoryImageSubjectStore, K as createVideoSubjectAdapter } from './video-adapter-C5qDzl4Q.mjs';
+import { d as ImageObjectBox, e as VideoSubjectStore, f as VideoObjectBox } from './video-adapter-CCLbp86L.mjs';
+export { B as BrowserImageSubjectStoreOptions, g as ImageContentHasher, h as ImageObjectObservation, a as ImageRecognitionProvider, i as ImageSubjectAdapter, I as ImageSubjectAdapterOptions, j as ImageSubjectStore, P as PersistedImageAnalysis, k as PersistedImageSubject, l as PersistedImageSuppression, m as PersistedVideoAnalysis, n as PersistedVideoTrack, o as VideoBackwardAnalysisOptions, p as VideoBackwardAnalysisResult, q as VideoMotionAttempt, r as VideoMotionPolicy, s as VideoMotionPresenceDecision, t as VideoMotionState, u as VideoSegmentationObservation, v as VideoSegmentationPoint, c as VideoSegmentationProvider, w as VideoSubjectAdapter, V as VideoSubjectAdapterOptions, x as VideoTrackKeyframe, y as VideoTrackObservation, z as VideoTrackSegment, A as VideoTrackSmoother, C as VideoTrackingAnchor, D as VideoTrackingAttempt, b as VideoTrackingProvider, E as VideoTrackingSeed, F as VideoTrackingSession, G as createBrowserImageSubjectStore, H as createImageSubjectAdapter, J as createMemoryImageSubjectStore, K as createVideoSubjectAdapter } from './video-adapter-CCLbp86L.mjs';
 import { g as PopmeltSubjectBounds } from './subjects-DzjWdlAk.mjs';
 
 declare function unprojectImagePoint(image: HTMLImageElement, clientPoint: {

package/dist/options-5yRxW1AX.d.mts

@@ -0,0 +1,66 @@
+import { A as Annotation, P as PopmeltSubjectAdapter } from './subjects-DzjWdlAk.mjs';
+import { a as ImageRecognitionProvider, b as VideoTrackingProvider, c as VideoSegmentationProvider, I as ImageSubjectAdapterOptions, V as VideoSubjectAdapterOptions } from './video-adapter-CCLbp86L.mjs';
+
+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';
+    /** Read-only inspection uses the same collector without submitting a comment. */
+    purpose?: 'inspection';
+    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. */
+    dispose?(): void | Promise<void>;
+};
+type PopmeltExtension = {
+    /** Stable package-level identity used to reconcile extension configuration. */
+    id: string;
+    /** Stable signature for configuration changes that require reactivation. */
+    configurationKey: string;
+    /** Activate lazily after the Core provider mounts in the browser. */
+    activate(): PopmeltExtensionRuntime;
+};
+
+/** Host integration options, independent of the UI renderer. */
+type PopmeltOptions = {
+    enabled?: boolean;
+    bridgeUrl?: string;
+    /** Stable project id generated by the framework plugin/bridge startup. */
+    projectId?: string | null;
+    /** Host router navigation, used for multi-page screenshot capture. */
+    navigate?: (url: string) => void | Promise<unknown>;
+    subjectAdapters?: readonly PopmeltSubjectAdapter[];
+    extensions?: readonly PopmeltExtension[];
+    /** Manual media annotation is enabled by default. */
+    imageAnnotation?: boolean | Omit<ImageSubjectAdapterOptions, 'id'>;
+    videoAnnotation?: boolean | Omit<VideoSubjectAdapterOptions, 'id'>;
+    /** Capture application-owned JSON context with each submitted human turn. */
+    getCommentMeta?: GetCommentMeta;
+};
+
+export type { CommentMeta as C, GetCommentMeta as G, PopmeltOptions as P, CommentMetaContext as a, CommentMetaValue as b, PopmeltExtension as c, PopmeltExtensionRuntime as d };

package/dist/plugin-astro.d.mts

@@ -1,14 +1,31 @@
-import { P as PopmeltPluginOptions, D as DevServerLike } from './dev-server-rQIWJcSX.mjs';
+import { P as PopmeltPluginOptions } from './dev-server-rQIWJcSX.mjs';
+import { popmelt as popmelt$1 } from './plugin-vite.mjs';
 import 'node:http';
 
-type AstroIntegration = {
+type PopmeltAstroOptions = PopmeltPluginOptions & {
+    /** Set false when an existing provider mounts the UI. */
+    client?: boolean;
+};
+type AstroSetup = {
+    command: 'dev' | 'build' | 'preview' | 'sync';
+    config: {
+        root: URL;
+    };
+    updateConfig: (config: {
+        vite: {
+            plugins: ReturnType<typeof popmelt$1>[];
+            optimizeDeps: {
+                include: string[];
+            };
+        };
+    }) => unknown;
+    injectScript: (stage: 'page', script: string) => void;
+};
+declare function popmelt(options?: PopmeltAstroOptions): {
     name: string;
     hooks: {
-        'astro:server:setup': (options: {
-            server: DevServerLike;
-        }) => Promise<void>;
+        'astro:config:setup'({ command, config, updateConfig, injectScript, }: AstroSetup): void;
     };
 };
-declare function popmelt(options?: PopmeltPluginOptions): AstroIntegration;
 
-export { popmelt };
+export { type PopmeltAstroOptions, popmelt };

package/dist/plugin-astro.mjs

@@ -1 +1,31 @@
-import{a as p,b as d,c as l,d as g}from"./chunk-MEDUDCL6.mjs";import"./chunk-NOHXTT24.mjs";import{Buffer as c}from"buffer";function u(e){return typeof e=="string"?e:e instanceof Uint8Array?c.from(e).toString("utf8"):String(e??"")}function m(e,t,r){let o=e.url||"";if(r.port===null||!(e.headers.accept?.includes("text/html")||o==="/"||o.endsWith(".html")))return;let a=t.write.bind(t),s=t.end.bind(t),n="";t.write=(i=>(n+=u(i),!0)),t.end=(i=>(i!==void 0&&(n+=u(i)),n=n.replace("<head>",`<head><script type="text/javascript">${g(r)}</script>`),t.getHeader("content-length")&&t.setHeader("content-length",c.byteLength(n)),a(n,"utf8"),s()))}function y(e){let t=e?.basePath??"/popmelt",r={port:null,projectId:null};return{name:"popmelt",hooks:{async"astro:server:setup"({server:o}){r=await p(e,o,4321),await d(r,o);let a=l(t,()=>r);o.middlewares.use((s,n,i)=>{if((s.url||"").startsWith(t))return a(s,n,i);m(s,n,r),i()})}}}}export{y as popmelt};
+import{a as o}from"./chunk-OY63KT72.mjs";import"./chunk-V25ZE6LB.mjs";import"./chunk-NOHXTT24.mjs";import{fileURLToPath as a}from"url";function c(t={}){return{name:"popmelt",hooks:{"astro:config:setup"({command:r,config:i,updateConfig:n,injectScript:p}){if(r!=="dev")return;let{client:e=!0,...s}=t;n({vite:{plugins:[o({...s,projectRoot:t.projectRoot??a(i.root)})],optimizeDeps:{include:e?["react","react/jsx-runtime","react/jsx-dev-runtime","react-dom","react-dom/client","lucide-react"]:[]}}}),p("page",e?d:`
+import { bridgeUrl, projectId } from 'virtual:popmelt/bridge';
+if (bridgeUrl) window.__POPMELT_BRIDGE_URL__ = bridgeUrl;
+if (projectId) window.__POPMELT_PROJECT_ID__ = projectId;
+`)}}}}var d=`
+import { bridgeUrl, projectId } from 'virtual:popmelt/bridge';
+import { navigate } from 'astro:transitions/client';
+let disposed = false;
+let mounting;
+const start = () => {
+  if (disposed || mounting || !bridgeUrl || !projectId) return;
+  mounting = Promise.resolve(import.meta.hot?.data.cleanup).then(async () => {
+    if (disposed) return;
+    const { mountPopmelt } = await import('@popmelt.com/core/browser');
+    if (disposed) return;
+    const handle = await mountPopmelt({ enabled: true, bridgeUrl, projectId, navigate });
+    return handle;
+  }).catch(error => { console.warn('[popmelt] startup failed:', error); });
+};
+// The standalone hosts live outside body, so Astro's body swaps retain them.
+document.addEventListener('astro:page-load', start);
+if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start, { once: true });
+else start();
+import.meta.hot?.dispose(data => {
+  if (disposed) return;
+  disposed = true;
+  document.removeEventListener('astro:page-load', start);
+  document.removeEventListener('DOMContentLoaded', start);
+  data.cleanup = mounting?.then(handle => handle?.unmount());
+});
+`;export{c as popmelt};

package/dist/plugin-nuxt.d.mts

@@ -0,0 +1,8 @@
+import { NuxtModule } from 'nuxt/schema';
+import { P as PopmeltPluginOptions } from './dev-server-rQIWJcSX.mjs';
+import 'node:http';
+
+type PopmeltNuxtOptions = Pick<PopmeltPluginOptions, 'port' | 'projectRoot' | 'bridge'>;
+declare const popmeltNuxt: NuxtModule<PopmeltNuxtOptions>;
+
+export { type PopmeltNuxtOptions, popmeltNuxt as default };

package/dist/plugin-nuxt.mjs

@@ -0,0 +1,29 @@
+import{a as s,b as d}from"./chunk-V25ZE6LB.mjs";import{b as i}from"./chunk-NOHXTT24.mjs";import{addPluginTemplate as l,defineNuxtModule as m}from"nuxt/kit";var a=m({meta:{name:"@popmelt.com/core/nuxt",configKey:"popmelt"},async setup(n,e){if(!e.options.dev)return;let p={config:{server:e.options.devServer},middlewares:{use(){}}},t=await s({...n,projectRoot:n.projectRoot??e.options.rootDir},p,3e3);if(t.port===null)return;e.hook("vite:extend",({config:r})=>{r.optimizeDeps??={},r.optimizeDeps.include=[...new Set([...r.optimizeDeps.include??[],"react","react/jsx-runtime","react/jsx-dev-runtime","react-dom","react-dom/client","lucide-react"])]});let o=await d(t,p),u=o?i(o):void 0;e.hook("close",async()=>{u?.(),await o?.release()}),l({filename:"popmelt.client.mjs",mode:"client",getContents:()=>`import { defineNuxtPlugin } from '#app';
+export default defineNuxtPlugin((nuxtApp) => {
+  let disposed = false;
+  let mounting;
+  const bridgeUrl = ${JSON.stringify(`http://localhost:${t.port}`)};
+  const projectId = ${JSON.stringify(t.projectId)};
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    void mounting?.then(handle => handle?.unmount());
+  };
+  nuxtApp.hook('app:mounted', () => {
+    if (disposed || mounting) return;
+    mounting = import('@popmelt.com/core/browser').then(({ mountPopmelt }) => {
+      if (disposed) return;
+      return mountPopmelt({
+        enabled: true,
+        bridgeUrl,
+        projectId,
+        navigate: (url) => nuxtApp.$router.push(url),
+      });
+    }).then(handle => {
+      if (disposed) handle?.unmount();
+      return handle;
+    }).catch(error => { console.warn('[popmelt] startup failed:', error); });
+  });
+  nuxtApp.vueApp.onUnmount(dispose);
+  import.meta.hot?.dispose(dispose);
+});`})}}),h=a;export{h as default};

package/dist/plugin-vite.d.mts

@@ -3,12 +3,14 @@ import 'node:http';
 
 type Plugin = {
     name: string;
+    resolveId: (id: string) => string | undefined;
+    load: (id: string) => string | undefined;
     configureServer: (server: DevServerLike) => Promise<void>;
     transformIndexHtml: () => {
         tag: string;
         attrs: Record<string, string>;
         children: string;
-        injectTo: string;
+        injectTo: 'head-prepend';
     }[] | undefined;
 };
 declare function popmelt(options?: PopmeltPluginOptions): Plugin;

package/dist/plugin-vite.mjs

@@ -1 +1 @@
-import{a as n,b as i,c as o,d as a}from"./chunk-MEDUDCL6.mjs";import"./chunk-NOHXTT24.mjs";function s(r){let d=r?.basePath??"/popmelt",e={port:null,projectId:null};return{name:"popmelt",async configureServer(t){e=await n(r,t,5173),await i(e,t),t.middlewares.use(o(d,()=>e))},transformIndexHtml(){if(e.port!==null)return[{tag:"script",attrs:{type:"text/javascript"},children:a(e),injectTo:"head-prepend"}]}}}export{s as popmelt};
+import{a}from"./chunk-OY63KT72.mjs";import"./chunk-V25ZE6LB.mjs";import"./chunk-NOHXTT24.mjs";export{a as popmelt};