@edv4h/usketch-plugin-presence-activity 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdV4H
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/activity-overlay.d.ts

@@ -0,0 +1,35 @@
+import type { BoardStore, BoundingBox, ShapeRegistry, Viewport } from "@edv4h/usketch-shared";
+import type { WsProviderHandle } from "@edv4h/usketch-sync";
+import type { AiActivityStore } from "./ai-activity-store.js";
+type Awareness = WsProviderHandle["awareness"];
+interface Participant {
+    clientId: number;
+    name: string;
+    color: string;
+    action: "select" | "edit";
+    /** Per-shape world bounds this participant is selecting/editing. */
+    boxes: BoundingBox[];
+    /** Optional in-progress marquee rect (world coords). */
+    marquee?: BoundingBox;
+}
+/**
+ * Resolve every remote participant's `activity` awareness field into drawable
+ * world-space boxes. Self is skipped. Participants with no resolvable activity
+ * are dropped. Exported for testing the awareness→geometry mapping.
+ */
+export declare function collectParticipants(awareness: Awareness, store: BoardStore, shapes: ShapeRegistry): Participant[];
+/**
+ * Screen-space SVG overlay drawing every remote participant's selection / edit /
+ * marquee in their presence color (feature #960). Mirrors the coordinate math of
+ * `UnconfirmedOverlay`. Re-renders on awareness change (own subscription) and on
+ * viewport change (the fixed layer re-renders and passes a fresh `viewport`).
+ */
+export declare function ActivityOverlay({ store, shapes, viewport, awareness, aiActivityStore, }: {
+    store: BoardStore;
+    shapes: ShapeRegistry;
+    viewport: Viewport;
+    awareness: Awareness;
+    aiActivityStore: AiActivityStore;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=activity-overlay.d.ts.map

package/dist/activity-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-overlay.d.ts","sourceRoot":"","sources":["../src/activity-overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,KAAK,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;AA6B/C,UAAU,WAAW;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,oEAAoE;IACpE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,aAAa,GACnB,WAAW,EAAE,CAqBf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC/B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,eAAe,GACf,EAAE;IACF,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;CACjC,sCAyCA"}

package/dist/activity-overlay.js

@@ -0,0 +1,98 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useReducer, useSyncExternalStore } from "react";
+import { fallbackColor, unionBounds, worldRectToScreen } from "./geometry.js";
+/** Identity of the local in-app AI participant (matches the MCP AI presence). */
+const AI_LABEL = "AI 🤖";
+const AI_COLOR = "#7c3aed";
+/** Resolve shape ids to their world bounds (registered def, else raw x/y/w/h). */
+function resolveBoxes(store, shapes, ids) {
+    const boxes = [];
+    for (const id of ids) {
+        const shape = store.getShape(id);
+        if (!shape)
+            continue;
+        const def = shapes.get(shape.type);
+        boxes.push(def?.getBounds(shape) ?? {
+            x: shape.x,
+            y: shape.y,
+            width: shape.width,
+            height: shape.height,
+        });
+    }
+    return boxes;
+}
+/**
+ * Resolve every remote participant's `activity` awareness field into drawable
+ * world-space boxes. Self is skipped. Participants with no resolvable activity
+ * are dropped. Exported for testing the awareness→geometry mapping.
+ */
+export function collectParticipants(awareness, store, shapes) {
+    const out = [];
+    for (const [clientId, state] of awareness.getStates()) {
+        if (clientId === awareness.doc.clientID)
+            continue;
+        const activity = state.activity;
+        if (!activity)
+            continue;
+        const user = state.user;
+        const boxes = resolveBoxes(store, shapes, activity.shapeIds ?? []);
+        if (boxes.length === 0 && !activity.marquee)
+            continue;
+        out.push({
+            clientId,
+            name: activity.label || user?.name || "",
+            color: user?.color || fallbackColor(clientId),
+            action: activity.action ?? "select",
+            boxes,
+            marquee: activity.marquee,
+        });
+    }
+    return out;
+}
+/**
+ * Screen-space SVG overlay drawing every remote participant's selection / edit /
+ * marquee in their presence color (feature #960). Mirrors the coordinate math of
+ * `UnconfirmedOverlay`. Re-renders on awareness change (own subscription) and on
+ * viewport change (the fixed layer re-renders and passes a fresh `viewport`).
+ */
+export function ActivityOverlay({ store, shapes, viewport, awareness, aiActivityStore, }) {
+    const [, bump] = useReducer((n) => n + 1, 0);
+    useEffect(() => {
+        awareness.on("change", bump);
+        return () => awareness.off("change", bump);
+    }, [awareness]);
+    // Local in-app AI activity (this tab only) — the agent has no awareness presence.
+    const aiActivity = useSyncExternalStore(aiActivityStore.subscribe, aiActivityStore.get);
+    const participants = collectParticipants(awareness, store, shapes);
+    if (aiActivity && aiActivity.shapeIds.length > 0) {
+        const boxes = resolveBoxes(store, shapes, aiActivity.shapeIds);
+        if (boxes.length > 0) {
+            participants.push({
+                clientId: -1,
+                name: AI_LABEL,
+                color: AI_COLOR,
+                action: "edit",
+                boxes,
+            });
+        }
+    }
+    if (participants.length === 0)
+        return null;
+    return (_jsxs("svg", { style: {
+            position: "absolute",
+            inset: 0,
+            width: "100%",
+            height: "100%",
+            pointerEvents: "none",
+        }, children: [_jsx("title", { children: "\u53C2\u52A0\u8005\u306E\u9078\u629E\u30FB\u7DE8\u96C6" }), participants.map((p) => (_jsx(ParticipantActivity, { p: p, viewport: viewport }, p.clientId)))] }));
+}
+const PAD = 3; // outline inflation in screen px, so it hugs outside the shape
+function ParticipantActivity({ p, viewport }) {
+    const editing = p.action === "edit";
+    const rects = p.boxes.map((b) => worldRectToScreen(b, viewport));
+    const union = unionBounds(p.boxes);
+    const badgeAt = union ? worldRectToScreen(union, viewport) : null;
+    const marquee = p.marquee ? worldRectToScreen(p.marquee, viewport) : null;
+    return (_jsxs("g", { children: [rects.map((r, i) => (_jsx("rect", { x: r.x - PAD, y: r.y - PAD, width: r.width + PAD * 2, height: r.height + PAD * 2, fill: "none", stroke: p.color, strokeWidth: 2, rx: 4, opacity: 0.9, children: editing && (_jsx("animate", { attributeName: "opacity", values: "0.35;0.95;0.35", dur: "1.1s", repeatCount: "indefinite" })) }, i))), marquee && (_jsx("rect", { x: marquee.x, y: marquee.y, width: marquee.width, height: marquee.height, fill: p.color, fillOpacity: 0.08, stroke: p.color, strokeWidth: 1.5, strokeDasharray: "6 4" })), badgeAt && p.name && (_jsxs("g", { transform: `translate(${badgeAt.x - PAD}, ${badgeAt.y - PAD - 18})`, children: [_jsx("rect", { width: p.name.length * 7.5 + 16, height: 16, rx: 4, fill: p.color }), _jsx("text", { x: 7, y: 12, fontSize: 11, fontWeight: 600, fill: "#fff", style: { userSelect: "none" }, children: editing ? `${p.name} ✏️` : p.name })] }))] }));
+}
+//# sourceMappingURL=activity-overlay.js.map

package/dist/activity-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-overlay.js","sourceRoot":"","sources":["../src/activity-overlay.tsx"],"names":[],"mappings":"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"}

package/dist/activity.d.ts

@@ -0,0 +1,27 @@
+import type { BoundingBox } from "@edv4h/usketch-shared";
+/**
+ * A participant's live "activity" — what they are currently selecting / editing —
+ * published on the Yjs awareness `activity` field alongside the existing
+ * `user`/`cursor` fields. It is a GENERAL multiplayer channel: every participant
+ * (human or AI) publishes it, and the overlay renders it uniformly. There is no
+ * AI discriminator — the AI is just another participant whose `user.name` is "AI".
+ *
+ * Writers (presence-cursor for humans, the MCP client for AI) set the awareness
+ * field to an object of this shape; the overlay in this package reads it.
+ */
+export interface PresenceActivity {
+    /** Shapes the participant currently has selected / is editing. */
+    shapeIds?: string[];
+    /** In-progress selection rectangle (world coords), while marquee-dragging. */
+    marquee?: BoundingBox;
+    /** What they're doing: `select` = passive highlight, `edit` = actively mutating (pulses). */
+    action?: "select" | "edit";
+    /** Optional label shown on the badge instead of the participant name. */
+    label?: string;
+}
+/** The awareness `user` field this overlay reads (a subset of what presence-cursor writes). */
+export interface PresenceUser {
+    name?: string;
+    color?: string;
+}
+//# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/activity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":""}

package/dist/ai-activity-store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Local (this-tab) AI activity — the in-app AI agent (⌘K → `ai:request`) writes
+ * shapes server-side, so unlike the MCP driver it has no awareness presence of its
+ * own. Instead the plugin mirrors the agent's `ai:response`/`ai:status` events into
+ * this small store, and the overlay renders it as a synthetic "AI" participant
+ * (feature #960). Only the initiating tab sees it (the edits themselves still sync
+ * to everyone via the shape store).
+ */
+export interface AiActivity {
+    /** Shapes the AI just placed/edited (from `ai:response`). */
+    shapeIds: string[];
+}
+export interface AiActivityStore {
+    get(): AiActivity | null;
+    set(next: AiActivity | null): void;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Create a fresh AI-activity store. One is created per plugin `setup()` so activity
+ * is scoped to that app instance — never shared across multiple `createApp()` /
+ * Canvas instances in the same JS runtime, and a teardown can't clear another's.
+ */
+export declare function createAiActivityStore(): AiActivityStore;
+//# sourceMappingURL=ai-activity-store.d.ts.map

package/dist/ai-activity-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-activity-store.d.ts","sourceRoot":"","sources":["../src/ai-activity-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,IAAI,UAAU,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAcvD"}

package/dist/ai-activity-store.js

@@ -0,0 +1,22 @@
+/**
+ * Create a fresh AI-activity store. One is created per plugin `setup()` so activity
+ * is scoped to that app instance — never shared across multiple `createApp()` /
+ * Canvas instances in the same JS runtime, and a teardown can't clear another's.
+ */
+export function createAiActivityStore() {
+    let current = null;
+    const listeners = new Set();
+    return {
+        get: () => current,
+        set(next) {
+            current = next;
+            for (const l of listeners)
+                l();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+//# sourceMappingURL=ai-activity-store.js.map

package/dist/ai-activity-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-activity-store.js","sourceRoot":"","sources":["../src/ai-activity-store.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACpC,IAAI,OAAO,GAAsB,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,OAAO;QACN,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO;QAClB,GAAG,CAAC,IAAI;YACP,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,CAAC,EAAE,CAAC;QAChC,CAAC;QACD,SAAS,CAAC,QAAQ;YACjB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/geometry.d.ts

@@ -0,0 +1,7 @@
+import type { BoundingBox, Viewport } from "@edv4h/usketch-shared";
+/** World-space rect → screen-space rect (same transform the canvas applies). */
+export declare function worldRectToScreen(b: BoundingBox, vp: Viewport): BoundingBox;
+/** Smallest box enclosing all inputs, or `null` when empty. */
+export declare function unionBounds(boxes: readonly BoundingBox[]): BoundingBox | null;
+export declare function fallbackColor(clientId: number): string;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEnE,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,GAAG,WAAW,CAO3E;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,CAa7E;AAaD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/geometry.js

@@ -0,0 +1,40 @@
+/** World-space rect → screen-space rect (same transform the canvas applies). */
+export function worldRectToScreen(b, vp) {
+    return {
+        x: b.x * vp.zoom + vp.x,
+        y: b.y * vp.zoom + vp.y,
+        width: b.width * vp.zoom,
+        height: b.height * vp.zoom,
+    };
+}
+/** Smallest box enclosing all inputs, or `null` when empty. */
+export function unionBounds(boxes) {
+    if (boxes.length === 0)
+        return null;
+    let minX = Number.POSITIVE_INFINITY;
+    let minY = Number.POSITIVE_INFINITY;
+    let maxX = Number.NEGATIVE_INFINITY;
+    let maxY = Number.NEGATIVE_INFINITY;
+    for (const b of boxes) {
+        minX = Math.min(minX, b.x);
+        minY = Math.min(minY, b.y);
+        maxX = Math.max(maxX, b.x + b.width);
+        maxY = Math.max(maxY, b.y + b.height);
+    }
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+/** Deterministic fallback color for a participant with no `user.color`. */
+const PALETTE = [
+    "#e74c3c",
+    "#3498db",
+    "#2ecc71",
+    "#f39c12",
+    "#9b59b6",
+    "#1abc9c",
+    "#e67e22",
+    "#e84393",
+];
+export function fallbackColor(clientId) {
+    return PALETTE[Math.abs(clientId) % PALETTE.length];
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,EAAY;IAC7D,OAAO;QACN,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACvB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI;KAC1B,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,KAA6B;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,IAAI,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,IAAI,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,IAAI,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC;AACtE,CAAC;AAED,2EAA2E;AAC3E,MAAM,OAAO,GAAG;IACf,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACT,CAAC;AACF,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC7C,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { PresenceActivity, PresenceUser } from "./activity.js";
+export { collectParticipants } from "./activity-overlay.js";
+export { type AiActivity, type AiActivityStore, createAiActivityStore, } from "./ai-activity-store.js";
+export { createPresenceActivityPlugin, type PresenceActivityOptions } from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACN,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,qBAAqB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { collectParticipants } from "./activity-overlay.js";
+export { createAiActivityStore, } from "./ai-activity-store.js";
+export { createPresenceActivityPlugin } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAGN,qBAAqB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAgC,MAAM,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,19 @@
+import type { UsketchPlugin } from "@edv4h/usketch-shared";
+import type { WsProviderHandle } from "@edv4h/usketch-sync";
+export interface PresenceActivityOptions {
+    wsProvider: WsProviderHandle;
+}
+/**
+ * Renders every OTHER participant's live selection / edit / marquee on the canvas
+ * (feature #960) by reading the Yjs awareness `activity` field. This is a general
+ * multiplayer capability — humans and the AI participant are drawn identically;
+ * "AI" is just a participant whose `user.name` is "AI". Cursors + the Members
+ * list already come free from `presence-cursor` / `presence-store`; this only
+ * adds the selection/edit outlines.
+ *
+ * It also drives the LOCAL in-app AI: the ⌘K agent writes shapes server-side with
+ * no awareness presence, so its `ai:response` is mirrored into `aiActivityStore`
+ * and drawn as a synthetic "AI" participant on this tab.
+ */
+export declare function createPresenceActivityPlugin(options: PresenceActivityOptions): UsketchPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgB5D,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CAiE5F"}

package/dist/plugin.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ActivityOverlay } from "./activity-overlay.js";
+import { createAiActivityStore } from "./ai-activity-store.js";
+const LAYER_ID = "usketch-presence-activity";
+/** How long the in-app AI highlight lingers after `ai:response` before clearing. */
+const AI_HOLD_MS = 1600;
+/**
+ * Renders every OTHER participant's live selection / edit / marquee on the canvas
+ * (feature #960) by reading the Yjs awareness `activity` field. This is a general
+ * multiplayer capability — humans and the AI participant are drawn identically;
+ * "AI" is just a participant whose `user.name` is "AI". Cursors + the Members
+ * list already come free from `presence-cursor` / `presence-store`; this only
+ * adds the selection/edit outlines.
+ *
+ * It also drives the LOCAL in-app AI: the ⌘K agent writes shapes server-side with
+ * no awareness presence, so its `ai:response` is mirrored into `aiActivityStore`
+ * and drawn as a synthetic "AI" participant on this tab.
+ */
+export function createPresenceActivityPlugin(options) {
+    const { wsProvider } = options;
+    return {
+        id: "usketch-plugin-presence-activity",
+        name: "参加者アクティビティ",
+        setup(ctx) {
+            // Per-instance (not a module singleton) so activity never leaks between
+            // multiple apps/canvases in the same runtime.
+            const aiActivityStore = createAiActivityStore();
+            // Above terrain/base/shapes, alongside the sync divergence overlay (250).
+            ctx.layers.register({
+                id: LAYER_ID,
+                order: 248,
+                fixed: true,
+                render: (renderCtx) => (_jsx(ActivityOverlay, { store: ctx.store, shapes: ctx.shapes, viewport: renderCtx.viewport, awareness: wsProvider.awareness, aiActivityStore: aiActivityStore })),
+            });
+            // ── In-app AI driver (feature #960) ──
+            // The ⌘K AI agent writes shapes server-side and has no awareness presence
+            // of its own, so mirror its `ai:response` (shapes it placed) into the local
+            // aiActivityStore — the overlay draws it as a synthetic "AI" participant on
+            // this tab. Auto-clear after a short hold; drop on error.
+            let clearTimer = null;
+            const cancelTimer = () => {
+                if (clearTimer) {
+                    clearTimeout(clearTimer);
+                    clearTimer = null;
+                }
+            };
+            const offResponse = ctx.events.on("ai:response", (e) => {
+                const ids = (Array.isArray(e.shapes) ? e.shapes : []).map((s) => s.id).filter(Boolean);
+                if (ids.length === 0)
+                    return;
+                aiActivityStore.set({ shapeIds: ids });
+                cancelTimer();
+                clearTimer = setTimeout(() => {
+                    aiActivityStore.set(null);
+                    clearTimer = null;
+                }, AI_HOLD_MS);
+            });
+            const offStatus = ctx.events.on("ai:status", (e) => {
+                if (e.status === "error") {
+                    cancelTimer();
+                    aiActivityStore.set(null);
+                }
+            });
+            return () => {
+                cancelTimer();
+                aiActivityStore.set(null);
+                offResponse();
+                offStatus();
+                ctx.layers.unregister(LAYER_ID);
+            };
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAC7C,oFAAoF;AACpF,MAAM,UAAU,GAAG,IAAI,CAAC;AAcxB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAgC;IAC5E,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC/B,OAAO;QACN,EAAE,EAAE,kCAAkC;QACtC,IAAI,EAAE,YAAY;QAElB,KAAK,CAAC,GAAkB;YACvB,wEAAwE;YACxE,8CAA8C;YAC9C,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;YAEhD,0EAA0E;YAC1E,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACnB,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CACtB,KAAC,eAAe,IACf,KAAK,EAAE,GAAG,CAAC,KAAK,EAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAC5B,SAAS,EAAE,UAAU,CAAC,SAAS,EAC/B,eAAe,EAAE,eAAe,GAC/B,CACF;aACD,CAAC,CAAC;YAEH,wCAAwC;YACxC,0EAA0E;YAC1E,4EAA4E;YAC5E,4EAA4E;YAC5E,0DAA0D;YAC1D,IAAI,UAAU,GAAyC,IAAI,CAAC;YAC5D,MAAM,WAAW,GAAG,GAAG,EAAE;gBACxB,IAAI,UAAU,EAAE,CAAC;oBAChB,YAAY,CAAC,UAAU,CAAC,CAAC;oBACzB,UAAU,GAAG,IAAI,CAAC;gBACnB,CAAC;YACF,CAAC,CAAC;YACF,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAkB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;gBACvE,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAC7B,eAAe,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;gBACvC,WAAW,EAAE,CAAC;gBACd,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC1B,UAAU,GAAG,IAAI,CAAC;gBACnB,CAAC,EAAE,UAAU,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAgB,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;gBACjE,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC1B,WAAW,EAAE,CAAC;oBACd,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;YACF,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACX,WAAW,EAAE,CAAC;gBACd,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1B,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,CAAC;gBACZ,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@edv4h/usketch-plugin-presence-activity",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@edv4h/usketch-shared": "4.11.0",
+    "@edv4h/usketch-sync": "1.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.18",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EdV4H/usketch.git",
+    "directory": "plugins/usketch-plugin-presence-activity"
+  },
+  "homepage": "https://github.com/EdV4H/usketch#readme",
+  "bugs": {
+    "url": "https://github.com/EdV4H/usketch/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}