@yorkie-js/sdk 0.6.38 → 0.6.40

package/dist/quill.html

@@ -246,6 +246,9 @@
             });
 
             // 03. create an instance of Quill
+            // Track composition state to prevent selection updates during IME input
+            let isComposing = false;
+
             const editorElem = clientElem?.getElementsByClassName('editor')[0];
             Quill.register('modules/cursors', QuillCursors);
             const quill = new Quill(editorElem, {
@@ -292,6 +295,14 @@
             }
 
             // 04. bind the document with the Quill.
+            // Track composition events to prevent selection updates during IME input
+            quill.root.addEventListener('compositionstart', () => {
+              isComposing = true;
+            });
+            quill.root.addEventListener('compositionend', () => {
+              isComposing = false;
+            });
+
             // 04-1. Quill to Document.
             quill
               .on('text-change', (delta, _, source) => {
@@ -354,6 +365,7 @@
                           (typeof op.insert === 'string'
                             ? op.insert.length
                             : 1);
+                        to = from;
                       }
 
                       if (range) {
@@ -380,7 +392,7 @@
                       op.retain !== undefined &&
                       typeof op.retain === 'number'
                     ) {
-                      from = to + op.retain;
+                      from += op.retain;
                       to = from;
                     }
                   }
@@ -391,6 +403,12 @@
                   return;
                 }
 
+                // Ignore selection changes during composition (e.g., Korean IME input)
+                // to prevent cursor position from being broadcast incorrectly to other users
+                if (isComposing) {
+                  return;
+                }
+
                 // NOTE(chacha912): If the selection in the Quill editor does not match the range computed by yorkie,
                 // additional updates are necessary. This condition addresses situations where Quill's selection behaves
                 // differently, such as when inserting text before a range selection made by another user, causing
@@ -420,15 +438,10 @@
 
             // 04-2. document to Quill(remote).
             function handleOperations(quill, ops) {
-              const deltaOperations = [];
-              let prevTo = 0;
               for (const op of ops) {
                 if (op.type === 'edit') {
                   const from = op.from;
                   const to = op.to;
-                  const retainFrom = from - prevTo;
-                  const retainTo = to - from;
-
                   const { insert, attributes } = toDeltaOperation(
                     op.value,
                     true,
@@ -438,14 +451,17 @@
                     'color: skyblue',
                   );
 
-                  if (retainFrom) {
-                    deltaOperations.push({ retain: retainFrom });
+                  const deltaOperations = [];
+
+                  if (from > 0) {
+                    deltaOperations.push({ retain: from });
                   }
-                  if (retainTo) {
-                    deltaOperations.push({ delete: retainTo });
+
+                  const deleteLength = to - from;
+                  if (deleteLength > 0) {
+                    deltaOperations.push({ delete: deleteLength });
                   }
-                  const insertLength =
-                    typeof insert === 'string' ? insert.length : 0;
+
                   if (insert) {
                     const op = { insert };
                     if (attributes) {
@@ -453,43 +469,47 @@
                     }
                     deltaOperations.push(op);
                   }
-                  // Update prevTo considering the actual text change:
-                  // from + length of inserted text (delete is already handled by retainTo)
-                  prevTo = from + insertLength;
+
+                  if (deltaOperations.length > 0) {
+                    console.log(
+                      `%c to quill: ${JSON.stringify(deltaOperations)}`,
+                      'color: green',
+                    );
+                    const delta = new Quill.imports.delta(deltaOperations);
+                    quill.updateContents(delta, 'api');
+                  }
                 } else if (op.type === 'style') {
                   const from = op.from;
                   const to = op.to;
-                  const retainFrom = from - prevTo;
-                  const retainTo = to - from;
                   const { attributes } = toDeltaOperation(op.value, false);
                   console.log(
                     `%c remote: ${from}-${to}: ${JSON.stringify(attributes)}`,
                     'color: skyblue',
                   );
 
-                  if (retainFrom) {
-                    deltaOperations.push({ retain: retainFrom });
-                  }
                   if (attributes) {
-                    const op = { attributes };
-                    if (retainTo) {
-                      op.retain = retainTo;
+                    const deltaOperations = [];
+
+                    if (from > 0) {
+                      deltaOperations.push({ retain: from });
                     }
 
+                    const op = { attributes };
+                    const retainLength = to - from;
+                    if (retainLength > 0) {
+                      op.retain = retainLength;
+                    }
                     deltaOperations.push(op);
+
+                    console.log(
+                      `%c to quill: ${JSON.stringify(deltaOperations)}`,
+                      'color: green',
+                    );
+                    const delta = new Quill.imports.delta(deltaOperations);
+                    quill.updateContents(delta, 'api');
                   }
-                  prevTo = to;
                 }
               }
-
-              if (deltaOperations.length) {
-                console.log(
-                  `%c to quill: ${JSON.stringify(deltaOperations)}`,
-                  'color: green',
-                );
-                const delta = new Quill.imports.delta(deltaOperations);
-                quill.updateContents(delta, 'api');
-              }
             }
 
             // 05. synchronize text of document and Quill.

package/dist/yorkie-js-sdk.d.ts

@@ -9,6 +9,7 @@ import { PartialMessage } from '@bufbuild/protobuf';
 import { PlainMessage } from '@bufbuild/protobuf';
 import { proto3 } from '@bufbuild/protobuf';
 import { Rule } from '@yorkie-js/schema';
+import { Timestamp } from '@bufbuild/protobuf';
 
 /**
  * `ActorID` is used to identify who is making changes to the document.
@@ -1083,6 +1084,22 @@ export declare class Client {
      * `getCondition` returns the condition of this client.
      */
     getCondition(condition: ClientCondition): boolean;
+    /**
+     * `createRevision` creates a new revision for the given document.
+     */
+    createRevision<R, P extends Indexable>(doc: Document_2<R, P>, label: string, description?: string): Promise<RevisionSummary>;
+    /**
+     * `listRevisions` lists all revisions for the given document.
+     */
+    listRevisions<R, P extends Indexable>(doc: Document_2<R, P>, options?: {
+        pageSize?: number;
+        offset?: number;
+        isForward?: boolean;
+    }): Promise<Array<RevisionSummary>>;
+    /**
+     * `restoreRevision` restores the document to the given revision.
+     */
+    restoreRevision<R, P extends Indexable>(doc: Document_2<R, P>, revisionId: string): Promise<void>;
     /**
      * `broadcast` broadcasts the given payload to the given topic.
      */
@@ -1274,6 +1291,7 @@ export declare const converter: {
     versionVectorToHex: typeof versionVectorToHex;
     hexToVersionVector: typeof hexToVersionVector;
     fromSchemaRules: typeof fromSchemaRules;
+    toRevisionSummary: typeof toRevisionSummary;
 };
 
 /**
@@ -4861,6 +4879,69 @@ declare type RemoveOpInfo_2 = {
  */
 declare type ResourceStatus = 'detached' | 'attached' | 'removed';
 
+/**
+ * `RevisionSummary` represents a document revision for version management.
+ * It stores a snapshot of document content at a specific point in time,
+ * enabling features like rollback, audit, and version history tracking.
+ */
+export declare interface RevisionSummary {
+    /**
+     * `id` is the unique identifier of the revision.
+     */
+    id: string;
+    /**
+     * `label` is a user-friendly name for this revision.
+     */
+    label: string;
+    /**
+     * `description` is a detailed explanation of this revision.
+     */
+    description: string;
+    /**
+     * `snapshot` is the serialized document content (JSON format) at this revision point.
+     * This contains only the pure data without CRDT metadata.
+     */
+    snapshot: string;
+    /**
+     * `createdAt` is the time when this revision was created.
+     */
+    createdAt: Date;
+}
+
+/**
+ * @generated from message yorkie.v1.RevisionSummary
+ */
+declare class RevisionSummary_2 extends Message<RevisionSummary_2> {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string label = 2;
+     */
+    label: string;
+    /**
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    /**
+     * @generated from field: string snapshot = 4;
+     */
+    snapshot: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 5;
+     */
+    createdAt?: Timestamp;
+    constructor(data?: PartialMessage<RevisionSummary_2>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "yorkie.v1.RevisionSummary";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RevisionSummary_2;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RevisionSummary_2;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RevisionSummary_2;
+    static equals(a: RevisionSummary_2 | PlainMessage<RevisionSummary_2> | undefined, b: RevisionSummary_2 | PlainMessage<RevisionSummary_2> | undefined): boolean;
+}
+
 /**
  * `RGATreeSplit` is a block-based list with improved index-based lookup in RGA.
  * The difference from RGATreeList is that it has data on a block basis to
@@ -6071,6 +6152,11 @@ declare enum TokenType {
  */
 declare function toOperation(operation: Operation): Operation_2;
 
+/**
+ * `toRevisionSummary` converts a protobuf RevisionSummary to a RevisionSummary.
+ */
+declare function toRevisionSummary(pbRevision: RevisionSummary_2): RevisionSummary;
+
 /**
  * `toTreeNodes` converts the given model to Protobuf format.
  */