@templatical/core 0.48.0 → 0.50.0

package/README.md

@@ -45,6 +45,8 @@ watch(editor.content, (next) => {
 
 - `useEditor` — reactive state (content, selection, viewport, darkMode, isDirty) + mutation methods (`addBlock`, `removeBlock`, `moveBlock`, `updateBlock`, `updateSettings`, `selectBlock`, …)
 - `useHistory` — undo/redo stack
+- `useCollaboration` — the real-time collaboration controller over a `CollaborationProvider`: ordered operation batches, block locks, presence, and undo/redo as inverse operations
+- `diffContent` / `invertOperations` — the operations between two contents, and the guarded operations that undo a batch
 - `useHistoryInterceptor` — wraps mutation methods so they push onto the history stack automatically
 - `useBlockActions` — higher-level helpers built on top of `useEditor` (`createAndAddBlock(type)`, `duplicateBlock`, `deleteBlock`, `updateBlockProperty`)
 - `useAutoSave` — debounced save with onSave callback
@@ -55,7 +57,7 @@ watch(editor.content, (next) => {
 
 ## Cloud subpath
 
-The `@templatical/core/cloud` subpath provides Templatical Cloud integrations (Auth, API client, WebSocket, AI chat/rewrite, collaboration, comments, scoring, and `createCloudSavedBlocksProvider`). Used by `@templatical/editor`'s `initCloud()`.
+The `@templatical/core/cloud` subpath provides Templatical Cloud integrations (Auth, API client, WebSocket, comments, and `createCloudSavedBlocksProvider`). Used by `@templatical/editor`'s `initCloud()`.
 
 ## Documentation
 

package/dist/cloud/index.d.ts

@@ -1,6 +1,5 @@
-import { r as UseEditorReturn } from "../editor-Bl4WsPU3.js";
-import { AiChatMessage, AiConfig, AuthConfig, AuthRequestOptions, Block, Collaborator, CommentResponse, CommentsProvider, CustomFont, ExportResult, FontsConfig, HealthCheckResult, MediaProvider, MergeTag, PlanConfig, PlanFeatures, RenderProvider, SavedBlock, SavedBlocksProvider, ScoringCategory, ScoringFinding, ScoringResult, SdkAuthConfig, Template, TemplateContent, TemplateOperationPayload, TemplatePatch, TemplateVersionResponse, TemplatesProvider, TestEmailConfig, TestEmailProvider, UserConfig, VersionHistoryProvider, WebSocketServerConfig } from "@templatical/types";
-import { ComputedRef, Ref, ref } from "vue";
+import { AuthConfig, AuthRequestOptions, Block, CommentResponse, CommentsProvider, CustomFont, ExportResult, FontsConfig, HealthCheckResult, MediaProvider, PlanConfig, PlanFeatures, RenderProvider, SavedBlock, SavedBlocksProvider, SdkAuthConfig, Template, TemplateContent, TemplatePatch, TemplateVersionResponse, TemplatesProvider, TestEmailConfig, TestEmailProvider, UserConfig, VersionHistoryProvider, WebSocketServerConfig } from "@templatical/types";
+import { ComputedRef, Ref } from "vue";
 import { Channel, PresenceChannel } from "pusher-js";
 //#region src/cloud/auth.d.ts
 /**
@@ -234,13 +233,6 @@ export declare const API_ROUTES: {
   readonly "comments.update": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments/{comment}";
   readonly "comments.destroy": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments/{comment}";
   readonly "comments.resolve": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/comments/{comment}/resolve";
-  readonly "ai.generate": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/generate";
-  readonly "ai.conversationMessages": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/conversation-messages";
-  readonly "ai.suggestions": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/suggestions";
-  readonly "ai.rewriteText": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/rewrite-text";
-  readonly "ai.score": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/score";
-  readonly "ai.fixFinding": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/fix-finding";
-  readonly "ai.generateFromDesign": "/api/v1/projects/{project}/tenants/{tenant}/templates/{template}/ai/generate-from-design";
   readonly "media.upload": "/api/v1/projects/{project}/tenants/{tenant}/media/upload";
   readonly "media.browse": "/api/v1/projects/{project}/tenants/{tenant}/media/browse";
   readonly "media.delete": "/api/v1/projects/{project}/tenants/{tenant}/media/delete";
@@ -292,99 +284,6 @@ export declare class WebSocketClient {
   get isConnected(): boolean;
 }
 //#endregion
-//#region src/cloud/mcp-operation-handler.d.ts
-export declare function handleOperation(editor: UseEditorReturn, payload: TemplateOperationPayload): void;
-//#endregion
-//#region src/cloud/ai-chat.d.ts
-interface UseAiChatOptions {
-  authManager: AuthManager;
-  getTemplateId: () => string | null;
-  onApply?: (content: TemplateContent) => void;
-  onError?: (error: Error) => void;
-}
-interface UseAiChatReturn {
-  messages: ReturnType<typeof ref<AiChatMessage[]>>;
-  isGenerating: ReturnType<typeof ref<boolean>>;
-  isLoadingHistory: ReturnType<typeof ref<boolean>>;
-  isLastChangeReverted: ReturnType<typeof ref<boolean>>;
-  lastApplyMessageId: ReturnType<typeof ref<string | null>>;
-  error: ReturnType<typeof ref<string | null>>;
-  failedPrompt: ReturnType<typeof ref<string | null>>;
-  suggestions: ReturnType<typeof ref<string[]>>;
-  isLoadingSuggestions: ReturnType<typeof ref<boolean>>;
-  sendPrompt: (prompt: string, currentContent: TemplateContent, mergeTags: MergeTag[]) => Promise<TemplateContent | null>;
-  toggleLastRevert: () => void;
-  loadConversation: () => Promise<void>;
-  loadSuggestions: (currentContent: TemplateContent, mergeTags: MergeTag[]) => Promise<void>;
-  clearChat: () => void;
-}
-export declare function useAiChat(options: UseAiChatOptions): UseAiChatReturn;
-//#endregion
-//#region src/cloud/ai-rewrite.d.ts
-interface UseAiRewriteOptions {
-  authManager: AuthManager;
-  getTemplateId: () => string | null;
-}
-interface UseAiRewriteReturn {
-  isRewriting: ReturnType<typeof ref<boolean>>;
-  streamingText: ReturnType<typeof ref<string>>;
-  previousContent: ReturnType<typeof ref<string | null>>;
-  rewrittenContent: ReturnType<typeof ref<string | null>>;
-  isReverted: ReturnType<typeof ref<boolean>>;
-  error: ReturnType<typeof ref<string | null>>;
-  rewrite: (content: string, instruction: string, mergeTags: MergeTag[]) => Promise<string | null>;
-  undo: () => string | null;
-  redo: () => string | null;
-  reset: () => void;
-}
-export declare function useAiRewrite(options: UseAiRewriteOptions): UseAiRewriteReturn;
-//#endregion
-//#region src/cloud/ai-config.d.ts
-interface UseAiConfigReturn {
-  isFeatureEnabled: (feature: keyof AiConfig) => boolean;
-  hasAnyMenuFeature: ComputedRef<boolean>;
-}
-export declare function useAiConfig(config?: AiConfig | false): UseAiConfigReturn;
-//#endregion
-//#region src/cloud/template-scoring.d.ts
-interface UseTemplateScoringOptions {
-  authManager: AuthManager;
-  getTemplateId: () => string | null;
-}
-interface UseTemplateScoringReturn {
-  isScoring: ReturnType<typeof ref<boolean>>;
-  scoringResult: ReturnType<typeof ref<ScoringResult | null>>;
-  error: ReturnType<typeof ref<string | null>>;
-  fixingFindingId: ReturnType<typeof ref<string | null>>;
-  fixStreamingText: ReturnType<typeof ref<string>>;
-  fixError: ReturnType<typeof ref<string | null>>;
-  score: (content: TemplateContent, mergeTags: MergeTag[]) => Promise<ScoringResult | null>;
-  fixFinding: (blockContent: string, finding: ScoringFinding, mergeTags: MergeTag[]) => Promise<string | null>;
-  removeFinding: (category: ScoringCategory, findingId: string) => void;
-  reset: () => void;
-}
-export declare function useTemplateScoring(options: UseTemplateScoringOptions): UseTemplateScoringReturn;
-//#endregion
-//#region src/cloud/design-reference.d.ts
-interface UseDesignReferenceOptions {
-  authManager: AuthManager;
-  getTemplateId: () => string | null;
-  onApply?: (content: TemplateContent) => void;
-  onError?: (error: Error) => void;
-}
-interface UseDesignReferenceReturn {
-  isGenerating: ReturnType<typeof ref<boolean>>;
-  error: ReturnType<typeof ref<string | null>>;
-  generate: (input: DesignReferenceInput) => Promise<TemplateContent | null>;
-  reset: () => void;
-}
-interface DesignReferenceInput {
-  prompt?: string;
-  imageUpload?: File;
-  pdfUpload?: File;
-}
-export declare function useDesignReference(options: UseDesignReferenceOptions): UseDesignReferenceReturn;
-//#endregion
 //#region src/cloud/comments-provider.d.ts
 /**
  * The two methods this adapter needs from a Pusher channel, named structurally.
@@ -439,45 +338,6 @@ interface CreateCloudCommentsProviderOptions {
  */
 export declare function createCloudCommentsProvider(options: CreateCloudCommentsProviderOptions): CommentsProvider;
 //#endregion
-//#region src/cloud/collaboration.d.ts
-interface UseCollaborationOptions {
-  authManager: AuthManager;
-  editor: UseEditorReturn;
-  channel: Ref<PresenceChannel | null>;
-  onError?: (error: Error) => void;
-  onCollaboratorJoined?: (collaborator: Collaborator) => void;
-  onCollaboratorLeft?: (collaborator: Collaborator) => void;
-  onBlockLocked?: (event: {
-    blockId: string;
-    collaborator: Collaborator;
-  }) => void;
-  onBlockUnlocked?: (event: {
-    blockId: string;
-    collaborator: Collaborator;
-  }) => void;
-}
-interface UseCollaborationReturn {
-  collaborators: Ref<Collaborator[]>;
-  lockedBlocks: Ref<Map<string, Collaborator>>;
-}
-export declare function useCollaboration(options: UseCollaborationOptions): UseCollaborationReturn & {
-  _broadcastOperation: (payload: TemplateOperationPayload) => void;
-  _isProcessingRemoteOperation: () => boolean;
-};
-//#endregion
-//#region src/cloud/collaboration-broadcast.d.ts
-interface BroadcastTarget {
-  _broadcastOperation: (payload: TemplateOperationPayload) => 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.
- */
-export declare function useCollaborationBroadcast(editor: Pick<UseEditorReturn, "addBlock" | "updateBlock" | "removeBlock" | "moveBlock" | "updateSettings" | "setContent">, collaboration: BroadcastTarget): void;
-//#endregion
 //#region src/cloud/web-socket.d.ts
 interface UseWebSocketOptions {
   authManager: AuthManager;
@@ -733,13 +593,5 @@ interface HealthCheckOptions {
 }
 export declare function performHealthCheck(options?: HealthCheckOptions): Promise<HealthCheckResult>;
 //#endregion
-//#region src/cloud/mcp-listener.d.ts
-interface UseMcpListenerOptions {
-  editor: UseEditorReturn;
-  channel: Ref<PresenceChannel | null>;
-  onOperation?: (payload: TemplateOperationPayload) => void;
-}
-export declare function useMcpListener(options: UseMcpListenerOptions): void;
-//#endregion
-export type { AuthConfig, AuthRequestOptions, CloudMediaBrowseParams, CloudMediaBrowseResponse, CloudMediaFolder, CloudMediaItem, CloudMediaUsageInfo, CloudMediaUsageResponse, CreateCloudCommentsProviderOptions, CreateCloudRenderProviderOptions, CreateCloudTestEmailProviderOptions, DesignReferenceInput, ExportFontsPayload, PresenceMember, RealtimeChannel, SdkAuthConfig, TestEmailConfig, UseAiChatOptions, UseAiChatReturn, UseAiConfigReturn, UseAiRewriteOptions, UseAiRewriteReturn, UseCollaborationOptions, UseCollaborationReturn, UseDesignReferenceOptions, UseDesignReferenceReturn, UseExportOptions, UseExportReturn, UseMcpListenerOptions, UsePlanConfigOptions, UsePlanConfigReturn, UseTemplateScoringOptions, UseTemplateScoringReturn, UseTestEmailOptions, UseTestEmailReturn, UseWebSocketOptions, UseWebSocketReturn, UserConfig, WebSocketClientOptions, WebSocketConfig };
+export type { AuthConfig, AuthRequestOptions, CloudMediaBrowseParams, CloudMediaBrowseResponse, CloudMediaFolder, CloudMediaItem, CloudMediaUsageInfo, CloudMediaUsageResponse, CreateCloudCommentsProviderOptions, CreateCloudRenderProviderOptions, CreateCloudTestEmailProviderOptions, ExportFontsPayload, PresenceMember, RealtimeChannel, SdkAuthConfig, TestEmailConfig, UseExportOptions, UseExportReturn, UsePlanConfigOptions, UsePlanConfigReturn, UseTestEmailOptions, UseTestEmailReturn, UseWebSocketOptions, UseWebSocketReturn, UserConfig, WebSocketClientOptions, WebSocketConfig };
 //# sourceMappingURL=index.d.ts.map