refactor(editor): should not rely on doc collection type

blocksuite/affine/block-data-view/src/block-meta/todo.ts

@@ -53,7 +53,7 @@ todoMeta.addProperty({
   metaConfig: propertyPresets.textPropertyConfig,
   get: block => block.doc.meta?.title ?? '',
   updated: (block, callback) => {
-    return block.doc.collection.meta.docMetaUpdated.on(() => {
+    return block.doc.collection.slots.docListUpdated.on(() => {
       callback();
     });
   },

blocksuite/affine/block-embed/src/embed-linked-doc-block/embed-linked-doc-block.ts

@@ -295,7 +295,7 @@ export class EmbedLinkedDocBlockComponent extends EmbedBlockComponent<EmbedLinke
     const linkedDoc = this.linkedDoc;
     if (linkedDoc) {
       this.disposables.add(
-        linkedDoc.collection.meta.docMetaUpdated.on(() => {
+        linkedDoc.collection.slots.docListUpdated.on(() => {
           this._load().catch(e => {
             console.error(e);
             this.isError = true;
@@ -328,7 +328,7 @@ export class EmbedLinkedDocBlockComponent extends EmbedBlockComponent<EmbedLinke
 
       this._setDocUpdatedAt();
       this.disposables.add(
-        this.doc.collection.meta.docMetaUpdated.on(() => {
+        this.doc.collection.slots.docListUpdated.on(() => {
           this._setDocUpdatedAt();
         })
       );

blocksuite/affine/block-embed/src/embed-synced-doc-block/components/embed-synced-doc-card.ts

@@ -100,7 +100,7 @@ export class EmbedSyncedDocCard extends WithDisposable(ShadowlessElement) {
       }
 
       this.disposables.add(
-        syncedDoc.collection.meta.docMetaUpdated.on(() => {
+        syncedDoc.collection.slots.docListUpdated.on(() => {
           renderLinkedDocInCard(this);
         })
       );

blocksuite/affine/block-embed/src/embed-synced-doc-block/embed-synced-doc-block.ts

@@ -475,7 +475,7 @@ export class EmbedSyncedDocBlockComponent extends EmbedBlockComponent<EmbedSynce
 
     this._setDocUpdatedAt();
     this.disposables.add(
-      this.doc.collection.meta.docMetaUpdated.on(() => {
+      this.doc.collection.slots.docListUpdated.on(() => {
         this._setDocUpdatedAt();
       })
     );

blocksuite/affine/components/src/rich-text/inline/presets/nodes/reference-node/reference-node.ts

@@ -221,7 +221,7 @@ export class AffineReference extends WithDisposable(ShadowlessElement) {
     const doc = this.doc;
     if (doc) {
       this._disposables.add(
-        doc.collection.slots.docUpdated.on(() => this._updateRefMeta(doc))
+        doc.collection.slots.docListUpdated.on(() => this._updateRefMeta(doc))
       );
     }
 

blocksuite/affine/shared/src/adapters/attachment.ts

@@ -26,7 +26,6 @@ export type Attachment = File[];
 type AttachmentToSliceSnapshotPayload = {
   file: Attachment;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/affine/shared/src/adapters/html/html.ts

@@ -46,7 +46,6 @@ export type Html = string;
 type HtmlToSliceSnapshotPayload = {
   file: Html;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/affine/shared/src/adapters/image.ts

@@ -26,7 +26,6 @@ export type Image = File[];
 type ImageToSliceSnapshotPayload = {
   file: Image;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/affine/shared/src/adapters/notion-html/notion-html.ts

@@ -41,7 +41,6 @@ export type NotionHtml = string;
 type NotionHtmlToSliceSnapshotPayload = {
   file: NotionHtml;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/affine/shared/src/adapters/plain-text/plain-text.ts

@@ -40,7 +40,6 @@ export type PlainText = string;
 type PlainTextToSliceSnapshotPayload = {
   file: PlainText;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/affine/shared/src/services/doc-display-meta-service.ts

@@ -162,7 +162,7 @@ export class DocDisplayMetaService
     if (!title$) {
       title$ = signal(doc.meta?.title || 'Untitled');
 
-      const disposable = this.std.collection.meta.docMetaUpdated.on(() => {
+      const disposable = this.std.collection.slots.docListUpdated.on(() => {
         title$!.value = doc.meta?.title || 'Untitled';
       });
 

blocksuite/affine/shared/src/utils/model/doc.ts

@@ -1,7 +1,7 @@
-import type { DocCollection } from '@blocksuite/store';
+import type { Workspace } from '@blocksuite/store';
 
 export function createDefaultDoc(
-  collection: DocCollection,
+  collection: Workspace,
   options: { id?: string; title?: string } = {}
 ) {
   const doc = collection.createDoc({ id: options.id });

blocksuite/blocks/src/_common/adapters/mix-text.ts

@@ -31,7 +31,6 @@ export type MixText = string;
 type MixTextToSliceSnapshotPayload = {
   file: MixText;
   assets?: AssetsManager;
-  blockVersions: Record<string, number>;
   workspaceId: string;
   pageId: string;
 };

blocksuite/blocks/src/_common/transformers/html.ts

@@ -1,7 +1,7 @@
 import { HtmlAdapter } from '@blocksuite/affine-shared/adapters';
 import { Container } from '@blocksuite/global/di';
 import { sha } from '@blocksuite/global/utils';
-import type { Doc, DocCollection } from '@blocksuite/store';
+import type { Doc, Workspace } from '@blocksuite/store';
 import { extMimeMap, Job } from '@blocksuite/store';
 
 import { defaultBlockHtmlAdapterMatchers } from '../adapters/html/block-matcher.js';
@@ -16,13 +16,13 @@ import {
 import { createAssetsArchive, download, Unzip } from './utils.js';
 
 type ImportHTMLToDocOptions = {
-  collection: DocCollection;
+  collection: Workspace;
   html: string;
   fileName?: string;
 };
 
 type ImportHTMLZipOptions = {
-  collection: DocCollection;
+  collection: Workspace;
   imported: Blob;
 };
 

blocksuite/blocks/src/_common/transformers/markdown.ts

@@ -2,7 +2,7 @@ import { MarkdownAdapter } from '@blocksuite/affine-shared/adapters';
 import { Container } from '@blocksuite/global/di';
 import { BlockSuiteError, ErrorCode } from '@blocksuite/global/exceptions';
 import { assertExists, sha } from '@blocksuite/global/utils';
-import type { Doc, DocCollection } from '@blocksuite/store';
+import type { Doc, Workspace } from '@blocksuite/store';
 import { extMimeMap, Job } from '@blocksuite/store';
 
 import { defaultBlockMarkdownAdapterMatchers } from '../adapters/index.js';
@@ -34,13 +34,13 @@ type ImportMarkdownToBlockOptions = {
 };
 
 type ImportMarkdownToDocOptions = {
-  collection: DocCollection;
+  collection: Workspace;
   markdown: string;
   fileName?: string;
 };
 
 type ImportMarkdownZipOptions = {
-  collection: DocCollection;
+  collection: Workspace;
   imported: Blob;
 };
 

blocksuite/blocks/src/_common/transformers/notion-html.ts

@@ -1,15 +1,15 @@
 import { NotionHtmlAdapter } from '@blocksuite/affine-shared/adapters';
 import { Container } from '@blocksuite/global/di';
 import { sha } from '@blocksuite/global/utils';
-import { type DocCollection, extMimeMap, Job } from '@blocksuite/store';
+import { extMimeMap, Job, type Workspace } from '@blocksuite/store';
 
 import { defaultBlockNotionHtmlAdapterMatchers } from '../adapters/notion-html/block-matcher.js';
 import { notionHtmlInlineToDeltaMatchers } from '../adapters/notion-html/delta-converter/html-inline.js';
 import { defaultImageProxyMiddleware } from './middlewares.js';
 import { Unzip } from './utils.js';
 
 type ImportNotionZipOptions = {
-  collection: DocCollection;
+  collection: Workspace;
   imported: Blob;
 };
 
@@ -26,12 +26,11 @@ const provider = container.provider();
 /**
  * Imports a Notion zip file into the BlockSuite collection.
  *
- * @param {ImportNotionZipOptions} options - The options for importing.
- * @param {DocCollection} options.collection - The BlockSuite document collection.
- * @param {Blob} options.imported - The imported zip file as a Blob.
+ * @param options - The options for importing.
+ * @param options.collection - The BlockSuite document collection.
+ * @param options.imported - The imported zip file as a Blob.
  *
- * @returns {Promise<{entryId: string | undefined, pageIds: string[], isWorkspaceFile: boolean, hasMarkdown: boolean}>}
- *          A promise that resolves to an object containing:
+ * @returns A promise that resolves to an object containing:
  *          - entryId: The ID of the entry page (if any).
  *          - pageIds: An array of imported page IDs.
  *          - isWorkspaceFile: Whether the imported file is a workspace file.

blocksuite/blocks/src/_common/transformers/zip.ts

@@ -1,11 +1,11 @@
 import { sha } from '@blocksuite/global/utils';
-import type { Doc, DocCollection, DocSnapshot } from '@blocksuite/store';
+import type { Doc, DocSnapshot, Workspace } from '@blocksuite/store';
 import { extMimeMap, getAssetName, Job } from '@blocksuite/store';
 
 import { download, Unzip, Zip } from '../transformers/utils.js';
 import { replaceIdMiddleware, titleMiddleware } from './middlewares.js';
 
-async function exportDocs(collection: DocCollection, docs: Doc[]) {
+async function exportDocs(collection: Workspace, docs: Doc[]) {
   const zip = new Zip();
   const job = new Job({
     schema: collection.schema,
@@ -50,7 +50,7 @@ async function exportDocs(collection: DocCollection, docs: Doc[]) {
   return download(downloadBlob, `${collection.id}.bs.zip`);
 }
 
-async function importDocs(collection: DocCollection, imported: Blob) {
+async function importDocs(collection: Workspace, imported: Blob) {
   const unzip = new Unzip();
   await unzip.load(imported);
 

blocksuite/blocks/src/root-block/widgets/linked-doc/import-doc/import-doc.ts

@@ -8,7 +8,7 @@ import {
 } from '@blocksuite/affine-components/icons';
 import { openFileOrFiles } from '@blocksuite/affine-shared/utils';
 import { WithDisposable } from '@blocksuite/global/utils';
-import type { DocCollection } from '@blocksuite/store';
+import type { Workspace } from '@blocksuite/store';
 import { html, LitElement, type PropertyValues } from 'lit';
 import { query, state } from 'lit/decorators.js';
 
@@ -30,7 +30,7 @@ export class ImportDoc extends WithDisposable(LitElement) {
   static override styles = styles;
 
   constructor(
-    private readonly collection: DocCollection,
+    private readonly collection: Workspace,
     private readonly onSuccess?: OnSuccessHandler,
     private readonly onFail?: OnFailHandler,
     private readonly abortController = new AbortController()

blocksuite/blocks/src/root-block/widgets/linked-doc/import-doc/index.ts

@@ -1,4 +1,4 @@
-import type { DocCollection } from '@blocksuite/store';
+import type { Workspace } from '@blocksuite/store';
 
 import {
   ImportDoc,
@@ -13,7 +13,7 @@ export function showImportModal({
   container = document.body,
   abortController = new AbortController(),
 }: {
-  collection: DocCollection;
+  collection: Workspace;
   onSuccess?: OnSuccessHandler;
   onFail?: OnFailHandler;
   multiple?: boolean;

blocksuite/framework/block-std/src/clipboard/index.ts

@@ -138,7 +138,6 @@ export class Clipboard extends LifeCycleWatcher {
         const payload = {
           file: item,
           assets: job.assetsManager,
-          blockVersions: doc.collection.meta.blockVersions,
           workspaceId: doc.collection.id,
           pageId: doc.id,
         };

blocksuite/framework/store/src/__tests__/collection.unit.spec.ts

@@ -7,7 +7,7 @@ import { applyUpdate, encodeStateAsUpdate } from 'yjs';
 import { COLLECTION_VERSION, PAGE_VERSION } from '../consts.js';
 import type { BlockModel, BlockSchemaType, Doc } from '../index.js';
 import { DocCollection, IdGeneratorType, Schema } from '../index.js';
-import type { DocMeta } from '../store/index.js';
+import type { DocMeta } from '../store/workspace.js';
 import type { BlockSuiteDoc } from '../yjs/index.js';
 import {
   NoteBlockSchema,
@@ -432,7 +432,7 @@ describe('addBlock', () => {
     );
 
     let called = false;
-    collection.meta.docMetaUpdated.on(() => {
+    collection.slots.docListUpdated.on(() => {
       called = true;
     });
 

blocksuite/framework/store/src/store/collection.ts

@@ -22,11 +22,16 @@ import {
   BlockSuiteDoc,
   type RawAwarenessState,
 } from '../yjs/index.js';
-import { BlockCollection, type GetDocOptions } from './doc/block-collection.js';
-import type { Doc, Query } from './doc/index.js';
+import { BlockCollection } from './doc/block-collection.js';
+import type { Doc } from './doc/index.js';
 import type { IdGeneratorType } from './id.js';
 import { pickIdGenerator } from './id.js';
 import { DocCollectionMeta } from './meta.js';
+import type {
+  CreateDocOptions,
+  GetDocOptions,
+  Workspace,
+} from './workspace.js';
 
 export type DocCollectionOptions = {
   schema: Schema;
@@ -69,7 +74,7 @@ export interface StackItem {
   meta: Map<'cursor-location' | 'selection-state', unknown>;
 }
 
-export class DocCollection {
+export class DocCollection implements Workspace {
   protected readonly _schema: Schema;
 
   readonly awarenessStore: AwarenessStore;
@@ -91,7 +96,7 @@ export class DocCollection {
   meta: DocCollectionMeta;
 
   slots = {
-    docUpdated: new Slot(),
+    docListUpdated: new Slot(),
     docRemoved: new Slot<string>(),
     docCreated: new Slot<string>(),
   };
@@ -161,7 +166,7 @@ export class DocCollection {
       this.blockCollections.set(doc.id, doc);
     });
 
-    this.meta.docMetaUpdated.on(() => this.slots.docUpdated.emit());
+    this.meta.docMetaUpdated.on(() => this.slots.docListUpdated.emit());
 
     this.meta.docMetaRemoved.on(id => {
       const space = this.getBlockCollection(id);
@@ -189,8 +194,8 @@ export class DocCollection {
    * If the `init` parameter is passed, a `surface`, `note`, and `paragraph` block
    * will be created in the doc simultaneously.
    */
-  createDoc(options: { id?: string; query?: Query } = {}) {
-    const { id: docId = this.idGenerator(), query } = options;
+  createDoc(options: CreateDocOptions = {}) {
+    const { id: docId = this.idGenerator(), query, readonly } = options;
     if (this._hasDoc(docId)) {
       throw new BlockSuiteError(
         ErrorCode.DocCollectionError,
@@ -205,7 +210,7 @@ export class DocCollection {
       tags: [],
     });
     this.slots.docCreated.emit(docId);
-    return this.getDoc(docId, { query }) as Doc;
+    return this.getDoc(docId, { query, readonly }) as Doc;
   }
 
   dispose() {