@autono/pinbox-toolbar 0.15.0 → 0.17.0

package/dist/{index-BVd-ZD4Y.d.ts → index-DENhglDF.d.ts}

@@ -1,4 +1,5 @@
 import { Attachment, Pin, PinInput, ThreadMessage } from "@autono/pinbox-core/schema";
+import { Session } from "@autono/pinbox-core/sessions";
 //#region src/capture.d.ts
 /**
  * The full browser shapes. `Pin["target"]`/`Pin["env"]` are optional at v1 (core
@@ -20,7 +21,7 @@ interface CaptureResult {
 }
 //#endregion
 //#region src/state.d.ts
-type UiStatus = "open" | "waiting" | "replied" | "resolved" | "verify";
+type UiStatus = "open" | "waiting" | "replied" | "resolved" | "verify" | "note" | "stale";
 interface Draft {
   target: CaptureResult;
   placedAt: {
@@ -50,6 +51,24 @@ interface ToolbarState {
    * pin unhides so the marker you just dropped is never invisible.
    */
   pinsHidden: boolean;
+  /**
+   * Wall clock, refreshed by the element every 30 s while connected (and on connect). 0 until
+   * then, which means "unknown": nothing is ever stale against an unknown clock, so tests that
+   * never tick see exactly the pre-clock behaviour. Living in state, a tick is a render.
+   */
+  clock: number;
+  /**
+   * Is an agent session listening on the hub? From GET /sessions on each (re)connect; null
+   * until the first answer. With nobody listening, a pin goes stale after THINKING_MS instead
+   * of STALE_AFTER_MS — there is no point telling you an agent is thinking when none is there.
+   */
+  agentLive: boolean | null;
+  /**
+   * How new pins get their picture. "dom" (default): a no-permission element snapshot
+   * (screenshot-dom.ts). "tab": real pixels via tab capture — Chrome asks once per page load.
+   * Persisted per endpoint; the bar's camera button flips it.
+   */
+  captureMode: "dom" | "tab";
 }
 interface Store {
   get(): ToolbarState;
@@ -79,15 +98,22 @@ declare function applyHubEvent(store: Store, event: {
   at: string;
   payload: unknown;
 }): void;
+/** What the status derivation needs from state besides the pin: the clock and agent liveness. */
+type StatusView = Pick<ToolbarState, "clock" | "agentLive">;
 /**
  * Wire-status → UI-status mapping:
  * resolved + no verification ⇒ "verify" (accept/reopen prompt);
  * resolved + verification ⇒ "resolved";
+ * open comment pin ⇒ "note" (nobody owes a reply — never "waiting");
+ * open + reply owed too long (pendingKind "stale") ⇒ "stale";
  * open + empty thread or last message human ⇒ "waiting";
  * open + last message agent|mirror ⇒ "replied".
  * The prototype's WORKING/APPLIED chips need an event vocabulary the hub does not emit — excluded here.
  */
-declare function deriveUiStatus(pin: Pin, thread: ThreadMessage[]): UiStatus;
+declare function deriveUiStatus(pin: Pin, thread: ThreadMessage[], view?: StatusView): UiStatus;
+//#endregion
+//#region src/ui/card-parts.d.ts
+type DraftKind = "note" | "comment";
 //#endregion
 //#region src/element.d.ts
 declare const BaseElement: typeof HTMLElement;
@@ -99,9 +125,9 @@ declare class PinboxToolbarElement extends BaseElement {
   readonly store: Store;
   /** Card → transport seam (wired by #startTransport once a config exists). */
   readonly actions: {
-    send?: (pinId: string | "draft", text: string) => void;
+    send?: (pinId: string | "draft", text: string, kind: DraftKind) => void;
     verify?: (pinId: string, outcome: "accepted" | "reopened") => void;
-    resolve?: (pinId: string) => void;
+    resolve?: (pinId: string, note?: string) => void;
   };
   /** Programmatic path (Pinbox.init). The snippet path reads hub/token attributes. */
   configure(config: PinboxConfig): void;
@@ -174,6 +200,8 @@ interface TransportOptions {
   onConnection(state: ConnectionState): void;
   /** Reconciled pin lists: fresh `listPins()` after each reconnect (hub wins on status). */
   onPins?(pins: Pin[]): void;
+  /** Agent sessions, fetched alongside each reconcile — the UI's "is anyone listening" signal. */
+  onSessions?(sessions: Session[]): void;
   /** Queued outbox localIds whenever the set changes — the UI flags them as pending sync. */
   onOutbox?(localIds: string[]): void;
   /** Test seam; default global fetch. */
@@ -223,19 +251,29 @@ interface PinboxConfig {
   /** Reserved; the realtime topic is fixed server-side. */
   project?: string;
   /**
-   * Attach a screenshot to new pins. Default true.
-   *
-   * Capturing one means asking the browser to share the tab, and that permission prompt is the
-   * first thing a visitor sees — fine in a project you already trust, hostile on a public page.
-   * Set false and pins ship with their structured capture (selector, markup, viewport) and no
-   * pixels.
+   * Attach a screenshot to new pins. Default true. Set false and pins ship with their
+   * structured capture (selector, markup, viewport) and no pixels at all.
    */
   screenshots?: boolean;
+  /**
+   * How the screenshot is taken when nothing is persisted yet. Default "dom": a no-permission
+   * snapshot of the element (cloned, styles inlined, drawn to a canvas — images become neutral
+   * boxes). "tab": real pixels via tab capture, which makes Chrome ask to share the tab once per
+   * page load. The visitor can flip this from the bar's camera button; their choice persists per
+   * endpoint and wins over this on reload.
+   */
+  capture?: "dom" | "tab";
   /**
    * Start with the bar collapsed to the floating puck. Default false. A
    * visitor's own choice, persisted per endpoint, wins over this on reload.
    */
   minimized?: boolean;
+  /**
+   * Keyboard shortcuts. Default "all". "escape-only" keeps Esc (dismiss) and hands every
+   * letter back to the host; "off" never reads the keyboard. For hosts whose own hotkeys
+   * collide. A subtree can also opt out with `data-pinbox-ignore-keys`.
+   */
+  shortcuts?: "all" | "escape-only" | "off";
 }
 /** Register <pinbox-toolbar>; no-op outside a browser or when already defined. */
 declare function defineToolbarElement(): void;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { _ as applyHubEvent, a as HubEvent, b as upsertPin, c as WebSocketLike, d as PinboxToolbarElement, f as Draft, g as appendThreadMessage, h as UiStatus, i as ConnectionState, l as HubError, m as ToolbarState, n as PinboxConfig, o as HubTransport, p as Store, r as defineToolbarElement, s as TransportOptions, t as Pinbox, u as StorageLike, v as createStore, x as CaptureResult, y as deriveUiStatus } from "./index-BVd-ZD4Y.js";
+import { _ as applyHubEvent, a as HubEvent, b as upsertPin, c as WebSocketLike, d as PinboxToolbarElement, f as Draft, g as appendThreadMessage, h as UiStatus, i as ConnectionState, l as HubError, m as ToolbarState, n as PinboxConfig, o as HubTransport, p as Store, r as defineToolbarElement, s as TransportOptions, t as Pinbox, u as StorageLike, v as createStore, x as CaptureResult, y as deriveUiStatus } from "./index-DENhglDF.js";
 export { type CaptureResult, type ConnectionState, type Draft, HubError, type HubEvent, HubTransport, Pinbox, PinboxConfig, PinboxToolbarElement, type StorageLike, type Store, type ToolbarState, type TransportOptions, type UiStatus, type WebSocketLike, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, upsertPin };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as HubError, c as createStore, i as HubTransport, l as deriveUiStatus, n as defineToolbarElement, o as appendThreadMessage, r as PinboxToolbarElement, s as applyHubEvent, t as Pinbox, u as upsertPin } from "./src-GX3kPe0X.js";
+import { a as HubError, c as createStore, i as HubTransport, l as deriveUiStatus, n as defineToolbarElement, o as appendThreadMessage, r as PinboxToolbarElement, s as applyHubEvent, t as Pinbox, u as upsertPin } from "./src-BsWnyGwB.js";
 export { HubError, HubTransport, Pinbox, PinboxToolbarElement, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, upsertPin };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { n as PinboxConfig } from "./index-BVd-ZD4Y.js";
+import { n as PinboxConfig } from "./index-DENhglDF.js";
 import { ReactElement } from "react";
 //#region src/react.d.ts
 /**

package/dist/react.js

@@ -1,4 +1,4 @@
-import { n as defineToolbarElement, r as PinboxToolbarElement } from "./src-GX3kPe0X.js";
+import { n as defineToolbarElement, r as PinboxToolbarElement } from "./src-BsWnyGwB.js";
 import { createElement, useEffect, useRef } from "react";
 //#region src/react.ts
 /**
@@ -7,22 +7,18 @@ import { createElement, useEffect, useRef } from "react";
 * reconfiguration; remount with a `key` to change endpoints.
 */
 function PinboxToolbar(props) {
-	const host = useRef(null);
 	const config = useRef(props);
 	config.current = props;
 	useEffect(() => {
 		defineToolbarElement();
 		const el = document.createElement(PinboxToolbarElement.tagName);
 		el.configure(config.current);
-		host.current?.appendChild(el);
+		document.body.appendChild(el);
 		return () => {
 			el.remove();
 		};
 	}, []);
-	return createElement("div", {
-		ref: host,
-		style: { display: "contents" }
-	});
+	return createElement("div", { style: { display: "contents" } });
 }
 //#endregion
 export { PinboxToolbar };