@templatical/core 0.0.1 → 0.0.3

package/dist/cloud/index.d.cts

@@ -1,7 +1,9 @@
-import { AuthConfig, TestEmailConfig, UserConfig, SdkAuthConfig, TemplateContent, Template, TemplateSnapshot, CustomFont, Comment, PlanConfig, SavedModule, Block, WebSocketServerConfig, EditorState, ViewportSize, TemplateSettings, TemplateDefaults, McpOperationPayload, MergeTag, AiConfig, ScoringResult, ScoringFinding, ScoringCategory, CommentThread, CommentEvent, Collaborator, ExportResult, FontsConfig, PlanFeatures, HealthCheckResult } from '@templatical/types';
+import { AuthConfig, TestEmailConfig, UserConfig, SdkAuthConfig, TemplateContent, Template, TemplateSnapshot, CustomFont, Comment, PlanConfig, SavedModule, Block, WebSocketServerConfig, EditorState, ViewportSize, UiTheme, TemplateSettings, TemplateDefaults, McpOperationPayload, MergeTag, AiConfig, ScoringResult, ScoringFinding, ScoringCategory, CommentThread, CommentEvent, Collaborator, ExportResult, FontsConfig, PlanFeatures, HealthCheckResult } from '@templatical/types';
 export { AuthConfig, AuthRequestOptions, SdkAuthConfig, TestEmailConfig, UserConfig } from '@templatical/types';
 import { PresenceChannel, Channel } from 'pusher-js';
 import { DeepReadonly, Ref, ref, ComputedRef } from 'vue';
+import { U as UseEditorReturn$1 } from '../editor-K644r-hl.cjs';
+import '@vue/reactivity';
 
 declare class AuthManager {
     private static readonly DEFAULT_BASE_URL;
@@ -196,6 +198,7 @@ interface UseEditorReturn {
     setViewport: (viewport: ViewportSize) => void;
     setDarkMode: (darkMode: boolean) => void;
     setPreviewMode: (previewMode: boolean) => void;
+    setUiTheme: (theme: UiTheme) => void;
     updateBlock: (blockId: string, updates: Partial<Block>) => void;
     updateSettings: (updates: Partial<TemplateSettings>) => void;
     addBlock: (block: Block, targetSectionId?: string, columnIndex?: number, index?: number) => void;
@@ -362,6 +365,18 @@ declare function useCollaboration(options: UseCollaborationOptions): UseCollabor
     _isProcessingRemoteOperation: () => boolean;
 };
 
+interface BroadcastTarget {
+    _broadcastOperation: (payload: McpOperationPayload) => void;
+}
+/**
+ * Wraps editor mutation methods to broadcast operations to collaboration
+ * peers after each mutation executes. Mutates the editor object in place.
+ *
+ * Must be applied **before** the history interceptor so the call chain is:
+ * history.record() → broadcast + original mutation.
+ */
+declare function useCollaborationBroadcast(editor: UseEditorReturn$1, collaboration: BroadcastTarget): void;
+
 interface UseWebSocketOptions {
     authManager: AuthManager;
     onError?: (error: Error) => void;
@@ -462,4 +477,4 @@ interface UseMcpListenerOptions {
 }
 declare function useMcpListener(options: UseMcpListenerOptions): void;
 
-export { API_ROUTES, ApiClient, AuthManager, type CommentBroadcastPayload, type DesignReferenceInput, type PresenceMember, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseEditorOptions, type UseEditorReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseSavedModulesOptions, type UseSavedModulesReturn, type UseSnapshotHistoryOptions, type UseSnapshotHistoryReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createSdkAuthManager, handleOperation, performHealthCheck, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCommentListener, useComments, useDesignReference, useEditor, useExport, useMcpListener, usePlanConfig, useSavedModules, useSnapshotHistory, useTemplateScoring, useTestEmail, useWebSocket };
+export { API_ROUTES, ApiClient, AuthManager, type CommentBroadcastPayload, type DesignReferenceInput, type PresenceMember, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseEditorOptions, type UseEditorReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseSavedModulesOptions, type UseSavedModulesReturn, type UseSnapshotHistoryOptions, type UseSnapshotHistoryReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createSdkAuthManager, handleOperation, performHealthCheck, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useCommentListener, useComments, useDesignReference, useEditor, useExport, useMcpListener, usePlanConfig, useSavedModules, useSnapshotHistory, useTemplateScoring, useTestEmail, useWebSocket };

package/dist/cloud/index.d.ts

@@ -1,7 +1,9 @@
-import { AuthConfig, TestEmailConfig, UserConfig, SdkAuthConfig, TemplateContent, Template, TemplateSnapshot, CustomFont, Comment, PlanConfig, SavedModule, Block, WebSocketServerConfig, EditorState, ViewportSize, TemplateSettings, TemplateDefaults, McpOperationPayload, MergeTag, AiConfig, ScoringResult, ScoringFinding, ScoringCategory, CommentThread, CommentEvent, Collaborator, ExportResult, FontsConfig, PlanFeatures, HealthCheckResult } from '@templatical/types';
+import { AuthConfig, TestEmailConfig, UserConfig, SdkAuthConfig, TemplateContent, Template, TemplateSnapshot, CustomFont, Comment, PlanConfig, SavedModule, Block, WebSocketServerConfig, EditorState, ViewportSize, UiTheme, TemplateSettings, TemplateDefaults, McpOperationPayload, MergeTag, AiConfig, ScoringResult, ScoringFinding, ScoringCategory, CommentThread, CommentEvent, Collaborator, ExportResult, FontsConfig, PlanFeatures, HealthCheckResult } from '@templatical/types';
 export { AuthConfig, AuthRequestOptions, SdkAuthConfig, TestEmailConfig, UserConfig } from '@templatical/types';
 import { PresenceChannel, Channel } from 'pusher-js';
 import { DeepReadonly, Ref, ref, ComputedRef } from 'vue';
+import { U as UseEditorReturn$1 } from '../editor-K644r-hl.js';
+import '@vue/reactivity';
 
 declare class AuthManager {
     private static readonly DEFAULT_BASE_URL;
@@ -196,6 +198,7 @@ interface UseEditorReturn {
     setViewport: (viewport: ViewportSize) => void;
     setDarkMode: (darkMode: boolean) => void;
     setPreviewMode: (previewMode: boolean) => void;
+    setUiTheme: (theme: UiTheme) => void;
     updateBlock: (blockId: string, updates: Partial<Block>) => void;
     updateSettings: (updates: Partial<TemplateSettings>) => void;
     addBlock: (block: Block, targetSectionId?: string, columnIndex?: number, index?: number) => void;
@@ -362,6 +365,18 @@ declare function useCollaboration(options: UseCollaborationOptions): UseCollabor
     _isProcessingRemoteOperation: () => boolean;
 };
 
+interface BroadcastTarget {
+    _broadcastOperation: (payload: McpOperationPayload) => void;
+}
+/**
+ * Wraps editor mutation methods to broadcast operations to collaboration
+ * peers after each mutation executes. Mutates the editor object in place.
+ *
+ * Must be applied **before** the history interceptor so the call chain is:
+ * history.record() → broadcast + original mutation.
+ */
+declare function useCollaborationBroadcast(editor: UseEditorReturn$1, collaboration: BroadcastTarget): void;
+
 interface UseWebSocketOptions {
     authManager: AuthManager;
     onError?: (error: Error) => void;
@@ -462,4 +477,4 @@ interface UseMcpListenerOptions {
 }
 declare function useMcpListener(options: UseMcpListenerOptions): void;
 
-export { API_ROUTES, ApiClient, AuthManager, type CommentBroadcastPayload, type DesignReferenceInput, type PresenceMember, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseEditorOptions, type UseEditorReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseSavedModulesOptions, type UseSavedModulesReturn, type UseSnapshotHistoryOptions, type UseSnapshotHistoryReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createSdkAuthManager, handleOperation, performHealthCheck, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCommentListener, useComments, useDesignReference, useEditor, useExport, useMcpListener, usePlanConfig, useSavedModules, useSnapshotHistory, useTemplateScoring, useTestEmail, useWebSocket };
+export { API_ROUTES, ApiClient, AuthManager, type CommentBroadcastPayload, type DesignReferenceInput, type PresenceMember, type UseAiChatOptions, type UseAiChatReturn, type UseAiConfigReturn, type UseAiRewriteOptions, type UseAiRewriteReturn, type UseCollaborationOptions, type UseCollaborationReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseDesignReferenceOptions, type UseDesignReferenceReturn, type UseEditorOptions, type UseEditorReturn, type UseExportOptions, type UseExportReturn, type UseMcpListenerOptions, type UsePlanConfigOptions, type UsePlanConfigReturn, type UseSavedModulesOptions, type UseSavedModulesReturn, type UseSnapshotHistoryOptions, type UseSnapshotHistoryReturn, type UseTemplateScoringOptions, type UseTemplateScoringReturn, type UseTestEmailOptions, type UseTestEmailReturn, type UseWebSocketOptions, type UseWebSocketReturn, WebSocketClient, type WebSocketClientOptions, type WebSocketConfig, buildUrl, createSdkAuthManager, handleOperation, performHealthCheck, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useCommentListener, useComments, useDesignReference, useEditor, useExport, useMcpListener, usePlanConfig, useSavedModules, useSnapshotHistory, useTemplateScoring, useTestEmail, useWebSocket };

package/dist/cloud/index.js

@@ -1,15 +1,21 @@
 // src/cloud/auth.ts
 import { SdkError } from "@templatical/types";
-var _AuthManager = class _AuthManager {
+var AuthManager = class _AuthManager {
+  static DEFAULT_BASE_URL = "https://templatical.com";
+  accessToken = null;
+  expiresAt = null;
+  _projectId = null;
+  _tenantId = null;
+  _tenantSlug = null;
+  _testEmailConfig = null;
+  _userConfig = null;
+  url;
+  baseUrl;
+  requestOptions;
+  onError;
+  refreshPromise = null;
+  static REFRESH_THRESHOLD_MS = 60 * 1e3;
   constructor(config) {
-    this.accessToken = null;
-    this.expiresAt = null;
-    this._projectId = null;
-    this._tenantId = null;
-    this._tenantSlug = null;
-    this._testEmailConfig = null;
-    this._userConfig = null;
-    this.refreshPromise = null;
     this.url = config.url;
     this.baseUrl = (config.baseUrl ?? _AuthManager.DEFAULT_BASE_URL).replace(
       /\/$/,
@@ -132,7 +138,7 @@ var _AuthManager = class _AuthManager {
       }
       return this.accessToken;
     } catch (error) {
-      const wrappedError = error instanceof Error ? error : new Error("Token refresh failed");
+      const wrappedError = error instanceof Error ? error : new Error("Token refresh failed", { cause: error });
       this.onError?.(wrappedError);
       throw wrappedError;
     }
@@ -157,9 +163,6 @@ var _AuthManager = class _AuthManager {
     return response;
   }
 };
-_AuthManager.DEFAULT_BASE_URL = "https://templatical.com";
-_AuthManager.REFRESH_THRESHOLD_MS = 60 * 1e3;
-var AuthManager = _AuthManager;
 function createSdkAuthManager(config, onError) {
   if (config.mode === "direct") {
     const baseUrl = (config.baseUrl ?? "https://templatical.com").replace(
@@ -503,8 +506,11 @@ function resolveWebSocketConfig(serverConfig) {
   };
 }
 var WebSocketClient = class {
+  pusher = null;
+  authManager;
+  config;
+  onError;
   constructor(options) {
-    this.pusher = null;
     this.authManager = options.authManager;
     this.config = options.config;
     this.onError = options.onError;
@@ -639,7 +645,8 @@ function useEditor(options) {
     previewMode: false,
     isDirty: false,
     isSaving: false,
-    isLoading: false
+    isLoading: false,
+    uiTheme: "auto"
   });
   const content = computed({
     get: () => state.content,
@@ -720,6 +727,9 @@ function useEditor(options) {
   function setDarkMode(darkMode) {
     state.darkMode = darkMode;
   }
+  function setUiTheme(theme) {
+    state.uiTheme = theme;
+  }
   function setPreviewMode(previewMode) {
     state.previewMode = previewMode;
     if (previewMode) {
@@ -875,6 +885,7 @@ function useEditor(options) {
     selectBlock,
     setViewport,
     setDarkMode,
+    setUiTheme,
     setPreviewMode,
     updateBlock,
     updateSettings,
@@ -1137,7 +1148,7 @@ function useAiChat(options) {
       }
       return result;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to generate template");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to generate template", { cause: err });
       error.value = wrappedError.message;
       failedPrompt.value = prompt;
       onError?.(wrappedError);
@@ -1633,7 +1644,9 @@ function useDesignReference(options) {
       }
       return result;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to generate template from design");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to generate template from design", {
+        cause: err
+      });
       error.value = wrappedError.message;
       onError?.(wrappedError);
       return null;
@@ -1737,7 +1750,7 @@ function useComments(options) {
     try {
       comments.value = await api.getComments(templateId);
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to load comments");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to load comments", { cause: err });
       onError?.(wrappedError);
     } finally {
       isLoading.value = false;
@@ -1771,7 +1784,7 @@ function useComments(options) {
       emitEvent("created", comment);
       return comment;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to create comment");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to create comment", { cause: err });
       onError?.(wrappedError);
       return null;
     } finally {
@@ -1798,7 +1811,7 @@ function useComments(options) {
       emitEvent("updated", updated);
       return updated;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to update comment");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to update comment", { cause: err });
       onError?.(wrappedError);
       return null;
     } finally {
@@ -1839,7 +1852,7 @@ function useComments(options) {
       emitEvent("deleted", commentSnapshot);
       return true;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to delete comment");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to delete comment", { cause: err });
       onError?.(wrappedError);
       return false;
     } finally {
@@ -1864,7 +1877,7 @@ function useComments(options) {
       emitEvent(eventType, updated);
       return updated;
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to toggle comment resolution");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to toggle comment resolution", { cause: err });
       onError?.(wrappedError);
       return null;
     } finally {
@@ -2197,6 +2210,73 @@ function useCollaboration(options) {
   };
 }
 
+// src/cloud/collaboration-broadcast.ts
+function useCollaborationBroadcast(editor, collaboration) {
+  const originalAddBlock = editor.addBlock;
+  const originalUpdateBlock = editor.updateBlock;
+  const originalRemoveBlock = editor.removeBlock;
+  const originalMoveBlock = editor.moveBlock;
+  const originalUpdateSettings = editor.updateSettings;
+  const originalSetContent = editor.setContent;
+  editor.addBlock = (block, targetSectionId, columnIndex) => {
+    originalAddBlock(block, targetSectionId, columnIndex);
+    collaboration._broadcastOperation({
+      operation: "add_block",
+      data: {
+        block,
+        section_id: targetSectionId,
+        column_index: columnIndex
+      },
+      timestamp: Date.now()
+    });
+  };
+  editor.updateBlock = (blockId, updates) => {
+    originalUpdateBlock(blockId, updates);
+    collaboration._broadcastOperation({
+      operation: "update_block",
+      data: { block_id: blockId, updates },
+      timestamp: Date.now()
+    });
+  };
+  editor.removeBlock = (blockId) => {
+    originalRemoveBlock(blockId);
+    collaboration._broadcastOperation({
+      operation: "delete_block",
+      data: { block_id: blockId },
+      timestamp: Date.now()
+    });
+  };
+  editor.moveBlock = (blockId, newIndex, targetSectionId, columnIndex) => {
+    originalMoveBlock(blockId, newIndex, targetSectionId, columnIndex);
+    collaboration._broadcastOperation({
+      operation: "move_block",
+      data: {
+        block_id: blockId,
+        index: newIndex,
+        section_id: targetSectionId,
+        column_index: columnIndex
+      },
+      timestamp: Date.now()
+    });
+  };
+  editor.updateSettings = (updates) => {
+    originalUpdateSettings(updates);
+    collaboration._broadcastOperation({
+      operation: "update_settings",
+      data: { updates },
+      timestamp: Date.now()
+    });
+  };
+  editor.setContent = (content, markDirty) => {
+    originalSetContent(content, markDirty);
+    collaboration._broadcastOperation({
+      operation: "set_content",
+      data: { content },
+      timestamp: Date.now()
+    });
+  };
+}
+
 // src/cloud/web-socket.ts
 import { ref as ref7 } from "vue";
 function useWebSocket(options) {
@@ -2406,7 +2486,7 @@ function useTestEmail(options) {
         signature: testEmailConfig.value.signature
       });
     } catch (err) {
-      const wrappedError = err instanceof Error ? err : new Error("Failed to send test email");
+      const wrappedError = err instanceof Error ? err : new Error("Failed to send test email", { cause: err });
       error.value = wrappedError.message;
       onError?.(wrappedError);
       throw wrappedError;
@@ -2474,7 +2554,7 @@ function usePlanConfig(options) {
       config.value = await apiClient.fetchConfig();
     } catch (error) {
       onError?.(
-        error instanceof Error ? error : new Error("Failed to fetch config")
+        error instanceof Error ? error : new Error("Failed to fetch config", { cause: error })
       );
     } finally {
       isLoading.value = false;
@@ -2615,6 +2695,7 @@ export {
   useAiConfig,
   useAiRewrite,
   useCollaboration,
+  useCollaborationBroadcast,
   useCommentListener,
   useComments,
   useDesignReference,