@nuniapp/widget 0.1.3 → 0.1.4

package/README.md

@@ -60,11 +60,12 @@ Using React? Use [`@nuniapp/react`](https://www.npmjs.com/package/@nuniapp/react
 
 ## Options
 
-| Option                                 | Description                                                                                |
-| -------------------------------------- | ------------------------------------------------------------------------------------------ |
-| `project`                              | Your public project ID. Commit it; it is not a secret.                                     |
-| `getPageKey(url)`                      | Optional. Decide which URLs share comments. Defaults to the path, ignoring query and hash. |
-| `convexUrl`, `convexSiteUrl`, `appUrl` | Optional. For self-hosting or local development.                                           |
+| Option                                 | Description                                                                                                |
+| -------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `project`                              | Your public project ID. Commit it; it is not a secret.                                                     |
+| `getPageKey(url)`                      | Optional. Decide which URLs share comments. Defaults to the path, ignoring query and hash.                 |
+| `convexUrl`, `convexSiteUrl`, `appUrl` | Optional. For self-hosting or local development.                                                           |
+| `capture`                              | Optional. Owner-only page context per comment: `{ console, network, dom, screenshot }`, all on by default. |
 
 `init` returns `{ destroy() }`.
 

package/dist/index.d.ts

@@ -10,13 +10,49 @@ interface NuniOptions {
   appUrl?: string;
   /** Custom page key. Comments are matched by this; defaults to the normalized path. */
   getPageKey?: (url: URL) => string;
+  /**
+   * Extra context attached to each comment for the project owner and their
+   * coding agent. Everything is on by default; set a key to `false` to stop
+   * capturing it.
+   */
+  capture?: {
+    /** Recent console errors and warnings. */
+    console?: boolean;
+    /** Recent failed requests (method, origin + path, status). */
+    network?: boolean;
+    /** The element's markup (form values removed) and key styles. */
+    dom?: boolean;
+    /** An image of the element and its surroundings. */
+    screenshot?: boolean;
+  };
 }
 export declare const VERSION: string;
 //#endregion
-//#region src/index.d.ts
-export interface NuniInstance {
+//#region src/screenshot.d.ts
+/**
+ * Screenshots are loaded lazily (a separate chunk for npm users, a separate
+ * script for the CDN build), so the widget itself stays small.
+ */
+interface ScreenshotOptions {
+  /** Nuni's own host element, left out of the image. */
+  exclude: Element;
+  /** Outline color drawn around the commented element. */
+  accent: string;
+}
+type CaptureScreenshot = (el: Element, options: ScreenshotOptions) => Promise<Blob | null>;
+declare global {
+  interface Window {
+    /** Set by nuni-screenshot.global.js (the CDN build). */
+    __nuniScreenshot?: CaptureScreenshot;
+  }
+}
+//#endregion
+//#region src/mount.d.ts
+interface NuniInstance {
   destroy(): void;
 }
+//#endregion
+//#region src/index.d.ts
 /**
  * Mount Nuni on the page. Call once on the client. Calling it again with the
  * same project shares the mounted widget; it is removed when every handle is
@@ -25,4 +61,4 @@ export interface NuniInstance {
  */
 export declare function init(options: NuniOptions): NuniInstance;
 //#endregion
-export type { NuniOptions };
+export type { NuniInstance, NuniOptions };