feat(json-crdt-extensions): 🎸 improve Fragment code setup

src/json-crdt-extensions/peritext/Peritext.ts

@@ -14,7 +14,7 @@ import {CONST, updateNum} from '../../json-hash';
 import {SESSION} from '../../json-crdt-patch/constants';
 import {s} from '../../json-crdt-patch';
 import {ExtraSlices} from './slice/ExtraSlices';
-import {Fragment} from './block/Blocks';
+import {Fragment} from './block/Fragment';
 import {updateRga} from '../../json-crdt/hash';
 import type {ITimestampStruct} from '../../json-crdt-patch/clock';
 import type {Printable} from 'tree-dump/lib/types';

src/json-crdt-extensions/peritext/block/Blocks.ts → src/json-crdt-extensions/peritext/block/Fragment.ts

@@ -9,6 +9,12 @@ import type {Printable} from 'tree-dump/lib/types';
 import type {Peritext} from '../Peritext';
 import type {Point} from '../rga/Point';
 
+/**
+ * A *fragment* represents a structural slice of a rich-text document. A
+ * fragment can be bound to a specific range of text contents, however it
+ * always constructs a tree of {@link Block}s, which represent the nested
+ * structure of the text contents.
+ */
 export class Fragment implements Printable, Stateful {
   public readonly root: Block;