@tineira/apc-web 0.0.0-stage → 0.7.1

package/dist/view.d.ts

@@ -0,0 +1,15 @@
+import type { FocusParams } from "@tineira/apc-protocol";
+export interface ReportedView {
+    screen: string;
+    params: FocusParams;
+    selection: {
+        kind: string;
+        id: string;
+    } | null;
+}
+/**
+ * Report the screen as identifiers, debounced (1 s by default) and only while
+ * the tab is visible. The host's endpoint applies the allowlist; this only
+ * avoids sending what would be dropped anyway.
+ */
+export declare function createViewReporter(send: (view: ReportedView) => void, debounceMs?: number): (view: ReportedView) => void;

package/dist/view.js

@@ -0,0 +1,32 @@
+/**
+ * Report the screen as identifiers, debounced (1 s by default) and only while
+ * the tab is visible. The host's endpoint applies the allowlist; this only
+ * avoids sending what would be dropped anyway.
+ */
+export function createViewReporter(send, debounceMs = 1000) {
+    let timer = null;
+    let last = "";
+    let pending = null;
+    const flush = () => {
+        timer = null;
+        if (!pending || document.visibilityState !== "visible")
+            return;
+        const key = JSON.stringify(pending);
+        if (key === last)
+            return;
+        last = key;
+        send(pending);
+    };
+    document.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "visible" && pending) {
+            last = "";
+            flush();
+        }
+    });
+    return (view) => {
+        pending = view;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(flush, debounceMs);
+    };
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@tineira/apc-web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.1",
+  "description": "Agent Pointed Context (APC) for an app's page, in the browser: pinning agents to what the person sees, the agent bar (<apc-agents>), the pin badge, presence and the Direct agents list.",
+  "keywords": [
+    "apc",
+    "agent-pointed-context",
+    "mcp",
+    "ai-agents",
+    "web-components",
+    "browser"
+  ],
+  "homepage": "https://apc.tineira.com/docs",
+  "bugs": {
+    "url": "https://github.com/tineira/agent-pointed-context/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tineira/agent-pointed-context",
+    "directory": "packages/web"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tineira/apc-protocol": "^0.7.1"
+  },
+  "scripts": {},
+  "types": "./dist/index.d.ts"
 }