@dwelle/excalidraw 0.5.0-e05a141 → 0.5.0-e2a82c4d8

package/dist/types/excalidraw/TTA/types.d.ts

@@ -0,0 +1,167 @@
+import type { ExcalidrawElementSkeleton } from "@excalidraw/element";
+import type { ReactNode } from "react";
+import type { AIRateLimitWarningDescriptor } from "../aiWarnings";
+export type AIServerMessageRole = "user" | "assistant";
+export type AIAssistantLifecycleStatus = "pending" | "completed" | "failed" | "aborted";
+export interface AIServerConversationMessage {
+    role: AIServerMessageRole;
+    content: string;
+    images?: string[];
+}
+export interface AIGenerationRetryContext {
+    reason: "user_not_happy" | "generation_error";
+    avoidSimilarity?: boolean;
+    retryAssistantMessageId?: string;
+}
+export interface AIGenerateRequestPayload extends Record<string, unknown> {
+    prompt: string;
+    images?: string[];
+    chatId?: string | null;
+    retry?: AIGenerationRetryContext;
+}
+export interface ExcalidrawServerPayloadBase {
+    skeletons: ExcalidrawElementSkeleton[];
+}
+export interface AIStreamPartialPayload extends ExcalidrawServerPayloadBase {
+    isComplete: boolean;
+}
+export interface AIStreamStartedPayload {
+    chatId: string;
+    turnId: string;
+    messageId: string;
+    lifecycleStatus?: Extract<AIAssistantLifecycleStatus, "pending">;
+    updatedAt?: number | null;
+}
+export interface AIStreamMessagePayload {
+    message: string;
+}
+export interface AIStreamFinalPayload extends AIStreamPartialPayload {
+    chatId?: string | null;
+    turnId?: string | null;
+    messageId?: string | null;
+    lifecycleStatus?: Extract<AIAssistantLifecycleStatus, "completed">;
+    updatedAt?: number | null;
+}
+export declare const AI_ERRORS: {
+    readonly RATE_LIMIT: {
+        readonly code: 429;
+        readonly message: "Rate limit exceeded. Please wait before trying again.";
+    };
+    readonly SERVER_ERROR: {
+        readonly code: 500;
+        readonly message: "An internal server error occurred. Please try again later.";
+    };
+    readonly REQUEST_ERROR: {
+        readonly code: 400;
+        readonly message: "The request could not be processed due to invalid data.";
+    };
+    readonly GENERATION_ERROR: {
+        readonly code: 422;
+        readonly message: "Failed to generate valid content.";
+    };
+};
+export type AI_ERROR_CODE = typeof AI_ERRORS[keyof typeof AI_ERRORS]["code"];
+export type StreamChunk = {
+    type: "started";
+    chatId: string;
+    turnId: string;
+    messageId: string;
+    lifecycleStatus?: Extract<AIAssistantLifecycleStatus, "pending">;
+    updatedAt?: number;
+} | {
+    type: "message";
+    message: string;
+} | {
+    type: "partial";
+    skeletons: ExcalidrawElementSkeleton[];
+} | {
+    type: "done";
+    lifecycleStatus?: Extract<AIAssistantLifecycleStatus, "completed">;
+    finishReason: "stop" | "length" | "content_filter" | "tool_calls" | null;
+    skeletons: ExcalidrawElementSkeleton[];
+    chatId?: string;
+    turnId?: string;
+    messageId?: string;
+    updatedAt?: number;
+} | {
+    type: "error";
+    lifecycleStatus?: Extract<AIAssistantLifecycleStatus, "failed">;
+    error: {
+        code?: number;
+        message: string;
+    };
+};
+export type UserChatMessage = {
+    role: "user";
+    id: string;
+    content: string;
+    images?: string[];
+    createdAt?: number;
+    turnId?: string;
+};
+export type AssistantChatMessage = {
+    id: string;
+    role: "assistant";
+    lifecycleStatus?: AIAssistantLifecycleStatus;
+    statusText?: string;
+    createdAt?: number;
+    turnId?: string;
+    messageId?: string;
+    skeletons?: ReadonlyArray<ExcalidrawElementSkeleton>;
+    parseError?: string;
+    isComplete?: boolean;
+    stopReason?: "user" | "interrupted";
+    warningType?: AIRateLimitWarningDescriptor["variant"];
+    error?: {
+        code?: AI_ERROR_CODE | number;
+        message: string;
+        rateLimit?: number | null;
+        rateLimitRemaining?: number | null;
+    };
+};
+export type ChatMessage = UserChatMessage | AssistantChatMessage;
+export type AssistantChatTurnMessage = {
+    messageId?: string;
+    lifecycleStatus?: AIAssistantLifecycleStatus;
+    statusText?: string;
+    createdAt?: number;
+    skeletons?: ReadonlyArray<ExcalidrawElementSkeleton>;
+    parseError?: string;
+    isComplete?: boolean;
+    stopReason?: "user" | "interrupted";
+    error?: AssistantChatMessage["error"];
+};
+export type ChatTurn = {
+    turnId: string;
+    prompt: string;
+    images?: string[];
+    createdAt?: number;
+    updatedAt?: number;
+    assistantMessages: AssistantChatTurnMessage[];
+};
+export type ChatConversation = {
+    id: string;
+    title: string;
+    turns: ChatTurn[];
+    updatedAt: number;
+};
+export interface TTARateLimits {
+    rateLimit: number;
+    rateLimitRemaining: number;
+}
+export type TTAChatScrollOptions = {
+    keepElementTopVisible?: HTMLElement | null;
+    behavior?: ScrollBehavior;
+};
+export interface TTAPersistenceAdapter {
+    loadHistory(): Promise<ChatConversation[]>;
+    saveHistory(history: ChatConversation[]): Promise<void>;
+}
+/**
+ * Return `undefined` to use the built-in warning/error rendering.
+ * Receives a shared warning descriptor as the first argument.
+ * Returning a node replaces the full assistant message row.
+ */
+export type TTADialogRenderWarning = (warning: AIRateLimitWarningDescriptor, chatMessage: Extract<ChatMessage, {
+    role: "assistant";
+}>) => ReactNode | undefined;

package/dist/types/excalidraw/TTA/useAIAssistantPreview.d.ts

@@ -0,0 +1,18 @@
+import type { ExcalidrawElementSkeleton } from "@excalidraw/element";
+import type { AssistantChatMessage } from "./types";
+import type { AppClassProperties, AppState } from "../types";
+export type AIAssistantPreviewStatus = "idle" | "loading" | "done" | "unavailable";
+type AIAssistantPreviewState = {
+    previewSvg: string | null;
+    status: AIAssistantPreviewStatus;
+};
+type UseAIAssistantPreviewOptions = {
+    enabled?: boolean;
+};
+export declare const renderAIAssistantPreviewDataUrl: ({ app, skeletons, theme, }: {
+    app: AppClassProperties;
+    skeletons: ReadonlyArray<ExcalidrawElementSkeleton>;
+    theme: AppState["theme"];
+}) => Promise<string | null>;
+export declare const useAIAssistantPreview: (message: AssistantChatMessage, options?: UseAIAssistantPreviewOptions) => AIAssistantPreviewState;
+export {};

package/dist/types/excalidraw/TTA/useAIStreamingCanvasPreview.d.ts

@@ -0,0 +1,21 @@
+import type { AIStreamPartialPayload } from "./types";
+import type { AppClassProperties } from "../types";
+type ThrottledStreamingCanvasPreviewRenderer = {
+    (result: AIStreamPartialPayload, messageId: string): void;
+    flush: () => void;
+    cancel: () => void;
+};
+type UseAIStreamingCanvasPreviewOptions = {
+    app: AppClassProperties;
+    removeGeneratedElementsByMessageId: (messageId: string | null) => void;
+    commitQueuedGenerationReplacements: (activeMessageId?: string | null) => void;
+};
+export declare const useAIStreamingCanvasPreview: ({ app, removeGeneratedElementsByMessageId, commitQueuedGenerationReplacements, }: UseAIStreamingCanvasPreviewOptions) => {
+    applyStreamingCanvasPreviewResult: (result: AIStreamPartialPayload, messageId: string) => void;
+    throttledApplyStreamingCanvasPreviewResult: ThrottledStreamingCanvasPreviewRenderer;
+    clearStreamingCanvasPreview: () => void;
+    clearActiveCanvasDraftFromCanvas: () => void;
+    resetActiveCanvasDraft: () => void;
+    resetStreamingCanvasPreviewState: () => void;
+};
+export {};

package/dist/types/excalidraw/TTA/useAIStreamingLifecycle.d.ts

@@ -0,0 +1,34 @@
+import { type AIGenerateRequestPayload, type ChatMessage } from "./types";
+import type { Dispatch, SetStateAction } from "react";
+import type { TTATransportAdapter } from "./client";
+import type { useI18n } from "../i18n";
+import type { AppClassProperties } from "../types";
+type UseAIStreamingLifecycleOptions = {
+    app: AppClassProperties;
+    chatMessages: ChatMessage[];
+    t: ReturnType<typeof useI18n>["t"];
+    setChatMessages: Dispatch<SetStateAction<ChatMessage[]>>;
+    applyServerChatMetadata: (metadata: {
+        chatId?: string | null;
+        turnId?: string | null;
+        messageId?: string | null;
+        updatedAt?: number | null;
+    }) => void;
+    removeGeneratedElementsByMessageId: (messageId: string | null) => void;
+    commitQueuedGenerationReplacements: (activeMessageId?: string | null) => void;
+    streamFetch: TTATransportAdapter["stream"];
+    onRateLimitInfo?: (rateLimitInfo: {
+        rateLimit?: number | null;
+        rateLimitRemaining?: number | null;
+    }) => void;
+};
+export declare const useAIStreamingLifecycle: ({ app, chatMessages, t, setChatMessages, applyServerChatMetadata, removeGeneratedElementsByMessageId, commitQueuedGenerationReplacements, streamFetch, onRateLimitInfo, }: UseAIStreamingLifecycleOptions) => {
+    clearStreamingCanvasPreview: () => void;
+    clearActiveCanvasDraftFromCanvas: () => void;
+    resetActiveCanvasDraft: () => void;
+    cancelActiveStream: () => void;
+    cancelPendingCanvasPreviewRenders: () => void;
+    setStopRequested: (value: boolean) => void;
+    generateResponse: (assistantId: string, payload: AIGenerateRequestPayload) => Promise<void>;
+};
+export {};

package/dist/types/excalidraw/TTA/useTTAChatHistory.d.ts

@@ -0,0 +1,18 @@
+import type { ChatConversation, ChatMessage, TTAPersistenceAdapter } from "./types";
+type UseTTAChatHistoryOptions = {
+    chatMessages: ChatMessage[];
+    persistenceAdapter: TTAPersistenceAdapter;
+};
+type SaveConversationToHistoryOptions = {
+    updatedAt?: number | null;
+};
+export declare const useTTAChatHistory: ({ chatMessages, persistenceAdapter, }: UseTTAChatHistoryOptions) => {
+    activeChatId: string;
+    chatHistory: ChatConversation[];
+    latestHistoryChat: ChatConversation | null;
+    saveConversationToHistory: (chatId: string, messages: ChatMessage[], options?: SaveConversationToHistoryOptions) => void;
+    setActiveChatId: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setActiveChatUpdatedAt: import("react").Dispatch<import("react").SetStateAction<number | null>>;
+    setChatHistory: (args_0: ChatConversation[] | ((prev: ChatConversation[]) => ChatConversation[])) => void;
+};
+export {};

package/dist/types/excalidraw/TTA/utils.d.ts

@@ -0,0 +1,14 @@
+import { type AI_ERROR_CODE } from "./types";
+export declare const AI_CLIENT_ERRORS: {
+    readonly INVALID_RESULT: 1001;
+};
+type AIChatError = {
+    code?: AI_ERROR_CODE | number;
+    message?: string;
+};
+export declare const isLikelyConnectionError: (message: string) => boolean;
+export declare const isLikelyServerUnavailableError: (message: string) => boolean;
+export declare const getAIErrorMessageKey: (error: AIChatError, opts?: {
+    isOffline?: boolean;
+}) => "ai.chat.errors.rateLimit" | "ai.chat.errors.invalidResult" | "ai.chat.errors.serverUnavailable" | "ai.chat.errors.offline" | "ai.chat.errors.connection" | "ai.chat.errors.requestFailed";
+export {};

package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts

@@ -26,6 +26,9 @@ export declare const actionAddToLibrary: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -40,7 +43,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -130,7 +133,7 @@ export declare const actionAddToLibrary: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            fileHandle: import("../data/filesystem").FileSystemHandle | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
@@ -179,6 +182,9 @@ export declare const actionAddToLibrary: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -193,7 +199,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -288,7 +294,7 @@ export declare const actionAddToLibrary: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            fileHandle: import("../data/filesystem").FileSystemHandle | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
@@ -337,6 +343,9 @@ export declare const actionAddToLibrary: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -351,7 +360,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -446,7 +455,7 @@ export declare const actionAddToLibrary: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            fileHandle: import("../data/filesystem").FileSystemHandle | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;

package/dist/types/excalidraw/actions/actionBoundText.d.ts

@@ -1,4 +1,4 @@
-import type { ExcalidrawElement, ExcalidrawLinearElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawTextElement } from "@excalidraw/element/types";
 import type { Mutable } from "@excalidraw/common/utility-types";
 import type { AppState } from "../types";
 export declare const actionUnbindText: {
@@ -46,6 +46,9 @@ export declare const actionBindText: {
             multiElement: import("@excalidraw/element/types").NonDeleted<ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -60,7 +63,7 @@ export declare const actionBindText: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -152,7 +155,7 @@ export declare const actionBindText: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            fileHandle: import("../data/filesystem").FileSystemHandle | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
@@ -216,6 +219,9 @@ export declare const actionWrapTextInContainer: {
             multiElement: import("@excalidraw/element/types").NonDeleted<ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -230,7 +236,7 @@ export declare const actionWrapTextInContainer: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -322,7 +328,7 @@ export declare const actionWrapTextInContainer: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            fileHandle: import("../data/filesystem").FileSystemHandle | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;