pmx-canvas 0.1.0

package/dist/types/client/nodes/image-warnings.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasNodeState } from '../types';
+export interface ImageNodeWarning {
+    title: string;
+    detail: string;
+}
+export declare function getImageNodeWarnings(node: CanvasNodeState): ImageNodeWarning[];

package/dist/types/client/nodes/inline-editor-commands.d.ts

@@ -0,0 +1,11 @@
+/** Shared contentEditable command helpers used by both the inline editor
+ *  and its floating toolbar. Kept in a module that neither component
+ *  depends on transitively so we don't get a circular import. */
+/** Prompt for a URL and insert it as a link on the current selection.
+ *  Rejects `javascript:` and `data:` schemes so a link can't execute script
+ *  when clicked. */
+export declare function promptAndInsertLink(): void;
+/** Wrap the current non-empty selection in an inline `<code>` element and
+ *  place the caret immediately after the new element. No-op on collapsed
+ *  selections. */
+export declare function wrapSelectionInCode(): void;

package/dist/types/client/nodes/md-format.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Markdown formatting helpers for textarea elements.
+ * Handles: wrap-style formatting (bold, italic, code, strikethrough),
+ * prefix-style formatting (headings, lists, quotes),
+ * Tab/Shift+Tab indentation, and floating toolbar positioning.
+ */
+export interface FormatAction {
+    key: string;
+    label: string;
+    icon: string;
+    shortcut?: string;
+    action: (ta: HTMLTextAreaElement) => void;
+}
+/** Handle Tab/Shift+Tab for indentation on current line(s). */
+export declare function handleTab(ta: HTMLTextAreaElement, shiftKey: boolean): void;
+/** Format actions available in the toolbar. */
+export declare const FORMAT_ACTIONS: FormatAction[];
+/** Handle Cmd/Ctrl+key formatting shortcuts in a textarea. Returns true if handled. */
+export declare function handleFormatShortcut(e: KeyboardEvent, ta: HTMLTextAreaElement): boolean;
+/** Get the screen rect of the current text selection for positioning a floating toolbar. */
+export declare function getSelectionRect(ta: HTMLTextAreaElement): {
+    top: number;
+    left: number;
+    width: number;
+} | null;

package/dist/types/client/state/attention-bridge.d.ts

@@ -0,0 +1,3 @@
+import { type SseMessage } from '../../shared/semantic-attention.js';
+export declare function resetAttentionBridge(): void;
+export declare function syncAttentionFromSse(message: SseMessage): void;

package/dist/types/client/state/attention-store.d.ts

@@ -0,0 +1,25 @@
+import type { SemanticAttentionRegion } from '../../shared/semantic-attention.js';
+export type AttentionTone = 'context' | 'relationship' | 'group' | 'cluster' | 'neighborhood' | 'remove';
+export interface AttentionEntry {
+    id: string;
+    tone: AttentionTone;
+    title: string;
+    detail: string;
+    nodeIds: string[];
+    createdAt: number;
+}
+export declare const attentionToast: import("@preact/signals-core").Signal<AttentionEntry | null>;
+export declare const attentionHistory: import("@preact/signals-core").Signal<AttentionEntry[]>;
+export declare const attentionPrimaryNodeIds: import("@preact/signals-core").Signal<Set<string>>;
+export declare const attentionSecondaryNodeIds: import("@preact/signals-core").Signal<Set<string>>;
+export declare const attentionRegions: import("@preact/signals-core").Signal<SemanticAttentionRegion[]>;
+export declare const attentionPulseNodeIds: import("@preact/signals-core").Signal<Set<string>>;
+export declare const attentionHistoryOpen: import("@preact/signals-core").Signal<boolean>;
+export declare const attentionHistoryUnread: import("@preact/signals-core").Signal<number>;
+export declare function resetAttentionState(): void;
+export declare function openAttentionHistory(): void;
+export declare function closeAttentionHistory(): void;
+export declare function setAttentionFocus(primaryNodeIds: string[], secondaryNodeIds: string[], regions: SemanticAttentionRegion[]): void;
+export declare function setAttentionToast(entry: AttentionEntry | null): void;
+export declare function pushAttentionHistory(entry: AttentionEntry, limit?: number): void;
+export declare function setAttentionPulse(nodeIds: string[]): void;

package/dist/types/client/state/canvas-store.d.ts

@@ -0,0 +1,74 @@
+import type { CanvasEdge, CanvasLayout, CanvasNodeState, ConnectionStatus, ViewportState } from '../types';
+export declare const viewport: import("@preact/signals-core").Signal<ViewportState>;
+export declare const nodes: import("@preact/signals-core").Signal<Map<string, CanvasNodeState>>;
+export declare const edges: import("@preact/signals-core").Signal<Map<string, CanvasEdge>>;
+export declare const activeNodeId: import("@preact/signals-core").Signal<string | null>;
+export declare const connectionStatus: import("@preact/signals-core").Signal<ConnectionStatus>;
+export declare const sessionId: import("@preact/signals-core").Signal<string>;
+export declare const traceEnabled: import("@preact/signals-core").Signal<boolean>;
+export declare const canvasTheme: import("@preact/signals-core").Signal<string>;
+export declare const hasInitialServerLayout: import("@preact/signals-core").Signal<boolean>;
+export declare const expandedNodeId: import("@preact/signals-core").Signal<string | null>;
+export declare const pendingConnection: import("@preact/signals-core").Signal<{
+    from: string;
+} | null>;
+export declare const draggingEdge: import("@preact/signals-core").Signal<{
+    fromId: string;
+    fromX: number;
+    fromY: number;
+    cursorX: number;
+    cursorY: number;
+} | null>;
+export declare const searchHighlightIds: import("@preact/signals-core").Signal<Set<string> | null>;
+export declare const selectedNodeIds: import("@preact/signals-core").Signal<Set<string>>;
+export declare const contextPinnedNodeIds: import("@preact/signals-core").Signal<Set<string>>;
+export declare function getNeighborNodeIds(nodeId: string | null, edgeMap: Map<string, CanvasEdge>): Set<string>;
+export declare const activeNeighborNodeIds: import("@preact/signals-core").ReadonlySignal<Set<string>>;
+export declare function toggleSelected(id: string): void;
+export declare function selectNodes(ids: string[]): void;
+export declare function clearSelection(): void;
+export declare function getSelectedNodes(): CanvasNodeState[];
+export declare function toggleContextPin(id: string): void;
+export declare function addContextPins(ids: string[]): void;
+export declare function clearContextPins(): void;
+export declare function replaceContextPinsFromServer(ids: string[]): void;
+export declare function getContextPinnedNodes(): CanvasNodeState[];
+export declare function addNode(node: CanvasNodeState): void;
+export declare function updateNode(id: string, patch: Partial<CanvasNodeState>): void;
+export declare function updateNodeData(id: string, dataPatch: Record<string, unknown>): void;
+export declare function removeNode(id: string): void;
+export declare function addEdge(edge: CanvasEdge): void;
+export declare function removeEdge(id: string): void;
+export declare function removeEdgesForNode(nodeId: string): void;
+export declare function resizeNode(id: string, size: {
+    width: number;
+    height: number;
+}): void;
+export declare function bringToFront(id: string): void;
+export declare function toggleCollapsed(id: string): void;
+export declare function dockNode(id: string, position: 'left' | 'right'): void;
+export declare function undockNode(id: string): void;
+export declare function setViewport(v: Partial<ViewportState>): void;
+export declare function replaceViewport(next: ViewportState): void;
+export declare function commitViewport(next: ViewportState): void;
+export declare function applyServerCanvasLayout(layout: Pick<CanvasLayout, 'nodes' | 'edges'> & {
+    viewport?: ViewportState;
+}): void;
+/**
+ * Smoothly animate the viewport to a target state.
+ * Cancels any in-flight animation. Direct manipulation (pan/zoom gestures)
+ * should use setViewport() instead for instant response.
+ */
+export declare function animateViewport(target: ViewportState, duration?: number): void;
+/** Cancel any in-flight viewport animation (e.g. when user starts dragging). */
+export declare function cancelViewportAnimation(): void;
+export declare function persistLayout(): void;
+export declare function restoreLayout(): Map<string, Partial<CanvasNodeState>> | null;
+export declare function fitAll(containerW: number, containerH: number): void;
+export declare function focusNode(id: string): void;
+export declare function cycleActiveNode(direction?: 1 | -1): void;
+export declare function walkGraph(direction: 'up' | 'down' | 'left' | 'right'): void;
+export declare function expandNode(id: string): void;
+export declare function collapseExpandedNode(): void;
+export declare function autoArrange(): void;
+export declare function forceDirectedArrange(): void;

package/dist/types/client/state/intent-bridge.d.ts

@@ -0,0 +1,158 @@
+/** Dispatch user intents from the canvas to the server (for TUI consumption). */
+export declare function sendIntent(type: string, payload?: Record<string, unknown>): Promise<{
+    ok: boolean;
+}>;
+/** Fetch rendered markdown HTML from the server. */
+export declare function renderMarkdown(markdown: string): Promise<string>;
+/** Fetch file content from the server. */
+export declare function fetchFile(path: string): Promise<{
+    content: string;
+    provenance?: unknown;
+}>;
+/** Save file content to the server. */
+export declare function saveFile(path: string, content: string): Promise<{
+    ok: boolean;
+    updatedAt?: string;
+}>;
+/** Fetch current workbench state. */
+export declare function fetchWorkbenchState(): Promise<Record<string, unknown>>;
+/** Open a markdown file in the workbench/canvas. */
+export declare function openWorkbenchFile(path: string): Promise<{
+    ok: boolean;
+}>;
+/** Fetch canvas state from server. */
+export declare function fetchCanvasState(): Promise<Record<string, unknown>>;
+/** Fetch available slash commands for prompt completion. */
+export declare function fetchSlashCommands(): Promise<Array<{
+    name: string;
+    description: string;
+}>>;
+/** Submit a new canvas prompt. */
+export declare function submitCanvasPrompt(text: string, position?: {
+    x: number;
+    y: number;
+}, parentNodeId?: string, contextNodeIds?: string[], threadNodeId?: string): Promise<{
+    ok: boolean;
+    nodeId?: string;
+    error?: string;
+}>;
+/** Submit a reply into an existing prompt thread. */
+export declare function submitThreadReply(threadNodeId: string, text: string): Promise<{
+    ok: boolean;
+    nodeId?: string;
+    error?: string;
+}>;
+/** Push canvas node updates to server. */
+export declare function pushCanvasUpdate(updates: Array<{
+    id: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width: number;
+        height: number;
+    };
+    collapsed?: boolean;
+    dockPosition?: 'left' | 'right' | null;
+}>): Promise<void>;
+/** Create a canvas edge via the server. */
+export declare function createEdgeFromClient(from: string, to: string, type: string, label?: string): Promise<{
+    ok: boolean;
+    id?: string;
+}>;
+/** Create a canvas node via the server. Returns the new node ID. */
+export declare function createNodeFromClient(opts: {
+    type?: string;
+    title?: string;
+    content?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}): Promise<{
+    ok: boolean;
+    id?: string;
+}>;
+/** Update a canvas node via the server. */
+export declare function updateNodeFromClient(id: string, patch: {
+    position?: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width: number;
+        height: number;
+    };
+    collapsed?: boolean;
+    pinned?: boolean;
+    dockPosition?: 'left' | 'right' | null;
+    title?: string;
+    content?: string;
+    data?: Record<string, unknown>;
+}): Promise<{
+    ok: boolean;
+    id?: string;
+}>;
+/** Refresh a webpage node from its persisted URL on the server. */
+export declare function refreshWebpageNodeFromClient(id: string, url?: string): Promise<{
+    ok: boolean;
+    id?: string;
+    error?: string;
+}>;
+/** Remove a canvas node via the server. */
+export declare function removeNodeFromClient(id: string): Promise<{
+    ok: boolean;
+    removed?: string;
+}>;
+/** Commit the current viewport to the authoritative server state. */
+export declare function updateViewportFromClient(viewport: {
+    x: number;
+    y: number;
+    scale: number;
+}): Promise<{
+    ok: boolean;
+}>;
+/** Create a group containing the given child node IDs. */
+export declare function createGroupFromClient(opts: {
+    title?: string;
+    childIds?: string[];
+    color?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}): Promise<{
+    ok: boolean;
+    id?: string;
+}>;
+/** Add nodes to an existing group. */
+export declare function addToGroupFromClient(groupId: string, childIds: string[]): Promise<{
+    ok: boolean;
+}>;
+/** Ungroup all children from a group. */
+export declare function ungroupFromClient(groupId: string): Promise<{
+    ok: boolean;
+}>;
+export interface CanvasSnapshotInfo {
+    id: string;
+    name: string;
+    createdAt: string;
+    nodeCount: number;
+    edgeCount: number;
+}
+export declare function listSnapshots(): Promise<CanvasSnapshotInfo[]>;
+export declare function saveSnapshot(name: string): Promise<{
+    ok: boolean;
+    snapshot?: CanvasSnapshotInfo;
+}>;
+export declare function restoreSnapshot(id: string): Promise<{
+    ok: boolean;
+}>;
+export declare function deleteSnapshot(id: string): Promise<{
+    ok: boolean;
+}>;
+/** Remove a canvas edge via the server. */
+export declare function removeEdgeFromClient(edgeId: string): Promise<{
+    ok: boolean;
+}>;

package/dist/types/client/state/sse-bridge.d.ts

@@ -0,0 +1,5 @@
+/** @internal — exported for testing */
+export declare function hashPath(path: string): string;
+/** @internal — exported for testing */
+export declare const EVENT_HANDLERS: Record<string, (data: Record<string, unknown>) => void>;
+export declare function connectSSE(): () => void;

package/dist/types/client/theme/tokens.d.ts

@@ -0,0 +1,27 @@
+/** Canvas design tokens — reads from CSS custom properties for theme support. */
+export interface CanvasTokens {
+    bg: string;
+    panel: string;
+    panelSoft: string;
+    line: string;
+    text: string;
+    textSoft: string;
+    muted: string;
+    dim: string;
+    accent: string;
+    ok: string;
+    warn: string;
+    warnAlt: string;
+    danger: string;
+    purple: string;
+    thinking: string;
+    subagent: string;
+    font: string;
+    mono: string;
+}
+/** Return current canvas tokens (reads computed CSS vars). */
+export declare function getCanvasTokens(): CanvasTokens;
+/** Invalidate the cached tokens (call after theme switch). */
+export declare function invalidateTokenCache(): void;
+/** Agent execution phase → CSS color mapping. Shared by StatusNode and StatusSummary. */
+export declare const PHASE_COLORS: Record<string, string>;

package/dist/types/client/types.d.ts

@@ -0,0 +1,40 @@
+export interface ViewportState {
+    x: number;
+    y: number;
+    scale: number;
+}
+export interface CanvasNodeState {
+    id: string;
+    type: 'markdown' | 'mcp-app' | 'webpage' | 'json-render' | 'graph' | 'prompt' | 'response' | 'status' | 'context' | 'ledger' | 'trace' | 'file' | 'image' | 'group';
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    zIndex: number;
+    collapsed: boolean;
+    pinned: boolean;
+    dockPosition: 'left' | 'right' | null;
+    data: Record<string, unknown>;
+}
+export interface CanvasEdge {
+    id: string;
+    from: string;
+    to: string;
+    type: 'relation' | 'depends-on' | 'flow' | 'references';
+    label?: string;
+    style?: 'solid' | 'dashed' | 'dotted';
+    animated?: boolean;
+}
+export type ConnectionStatus = 'connecting' | 'connected' | 'disconnected';
+export declare const TYPE_LABELS: Record<CanvasNodeState['type'], string>;
+/** Node types that support the full-viewport expand/focus overlay. */
+export declare const EXPANDABLE_TYPES: Set<"markdown" | "mcp-app" | "webpage" | "json-render" | "graph" | "prompt" | "response" | "status" | "context" | "ledger" | "trace" | "file" | "image" | "group">;
+export interface CanvasLayout {
+    viewport: ViewportState;
+    nodes: CanvasNodeState[];
+    edges: CanvasEdge[];
+}

package/dist/types/client/utils/ext-app-tool-result.d.ts

@@ -0,0 +1 @@
+export { normalizeExtAppToolResult, type NormalizeExtAppToolResultInput, } from '../../shared/ext-app-tool-result.js';

package/dist/types/client/utils/placement.d.ts

@@ -0,0 +1 @@
+export { findOpenCanvasPosition, type CanvasPlacementRect, } from '../../shared/placement.js';

package/dist/types/client/utils/platform.d.ts

@@ -0,0 +1,2 @@
+export declare const isMac: boolean;
+export declare const MOD_KEY: string;