@formicoidea/labre-core 0.30.1 → 0.31.0

package/dist/_pkgs/std/gfx/selection.js

@@ -1,7 +1,7 @@
 import { DisposableGroup } from '../../global/disposable/index.js';
 import { getCommonBoundWithRotation, } from '../../global/gfx/index.js';
 import { assertType } from '../../global/utils/index.js';
-import groupBy from 'lodash-es/groupBy';
+import groupBy from 'lodash-es/groupBy.js';
 import { Subject } from 'rxjs';
 import { BlockSelection, CursorSelection, SurfaceSelection, TextSelection, } from '../selection/index.js';
 import { GfxExtension, GfxExtensionIdentifier } from './extension.js';

package/dist/_pkgs/std/gfx/viewport-element.d.ts

@@ -1,6 +1,6 @@
-import { type EditorHost, ShadowlessElement } from '../view';
-import { GfxBlockElementModel } from './model/gfx-block-model';
-import { Viewport } from './viewport';
+import { type EditorHost, ShadowlessElement } from '../view/index.js';
+import { GfxBlockElementModel } from './model/gfx-block-model.js';
+import { Viewport } from './viewport.js';
 /**
  * A wrapper around `requestConnectedFrame` that only calls at most once in one frame
  */

package/dist/_pkgs/std/gfx/viewport-element.js

@@ -36,11 +36,11 @@ import { WithDisposable } from '../../global/lit/index.js';
 import { batch } from '@preact/signals-core';
 import { css, html } from 'lit';
 import { property } from 'lit/decorators.js';
-import { isGfxBlockComponent, ShadowlessElement, } from '../view';
-import { PropTypes, requiredProperties } from '../view/decorators/required';
-import { GfxControllerIdentifier } from './identifiers';
-import { GfxBlockElementModel } from './model/gfx-block-model';
-import { Viewport } from './viewport';
+import { isGfxBlockComponent, ShadowlessElement, } from '../view/index.js';
+import { PropTypes, requiredProperties } from '../view/decorators/required.js';
+import { GfxControllerIdentifier } from './identifiers.js';
+import { GfxBlockElementModel } from './model/gfx-block-model.js';
+import { Viewport } from './viewport.js';
 /**
  * A wrapper around `requestConnectedFrame` that only calls at most once in one frame
  */

package/dist/_pkgs/std/gfx/viewport.d.ts

@@ -1,6 +1,6 @@
 import { Bound, type IPoint, type IVec } from '../../global/gfx/index.js';
 import { BehaviorSubject, Subject } from 'rxjs';
-import type { GfxViewportElement } from '.';
+import type { GfxViewportElement } from './index.js';
 export declare const ZOOM_MAX = 6;
 export declare const ZOOM_MIN = 0.1;
 export declare const ZOOM_STEP = 0.25;

package/dist/_pkgs/std/gfx/viewport.js

@@ -1,5 +1,5 @@
 import { Bound, clamp, Vec, } from '../../global/gfx/index.js';
-import debounce from 'lodash-es/debounce';
+import debounce from 'lodash-es/debounce.js';
 import { BehaviorSubject, debounceTime, Subject } from 'rxjs';
 function cutoff(value, ref, sign) {
     if (sign > 0 && value > ref)

package/dist/_pkgs/std/inline/extensions/index.d.ts

@@ -1,4 +1,4 @@
-export * from './inline-manager';
-export * from './inline-spec';
-export * from './markdown-matcher';
-export * from './type';
+export * from './inline-manager.js';
+export * from './inline-spec.js';
+export * from './markdown-matcher.js';
+export * from './type.js';

package/dist/_pkgs/std/inline/extensions/index.js

@@ -1,4 +1,4 @@
-export * from './inline-manager';
-export * from './inline-spec';
-export * from './markdown-matcher';
-export * from './type';
+export * from './inline-manager.js';
+export * from './inline-spec.js';
+export * from './markdown-matcher.js';
+export * from './type.js';

package/dist/_pkgs/std/inline/index.d.ts

@@ -1,8 +1,8 @@
-export * from './components';
-export * from './consts';
-export * from './extensions';
-export * from './inline-editor';
-export * from './range';
-export * from './services';
-export * from './types';
-export * from './utils';
+export * from './components/index.js';
+export * from './consts.js';
+export * from './extensions/index.js';
+export * from './inline-editor.js';
+export * from './range/index.js';
+export * from './services/index.js';
+export * from './types.js';
+export * from './utils/index.js';

package/dist/_pkgs/std/inline/index.js

@@ -1,8 +1,8 @@
-export * from './components';
-export * from './consts';
-export * from './extensions';
-export * from './inline-editor';
-export * from './range';
-export * from './services';
-export * from './types';
-export * from './utils';
+export * from './components/index.js';
+export * from './consts.js';
+export * from './extensions/index.js';
+export * from './inline-editor.js';
+export * from './range/index.js';
+export * from './services/index.js';
+export * from './types.js';
+export * from './utils/index.js';

package/dist/_pkgs/std/inline/range/active.js

@@ -1,4 +1,4 @@
-import { RANGE_SYNC_EXCLUDE_ATTR } from './consts';
+import { RANGE_SYNC_EXCLUDE_ATTR } from './consts.js';
 /**
  * Check if the active element is in the editor host.
  * TODO(@mirone): this is a trade-off, we need to use separate awareness store for every store to make sure the selection is isolated.

package/dist/_pkgs/std/inline/range/range-binding.js

@@ -1,4 +1,4 @@
-import throttle from 'lodash-es/throttle';
+import throttle from 'lodash-es/throttle.js';
 import { TextSelection } from '../../selection/index.js';
 import { EditorHost } from '../../view/index.js';
 import { isActiveInEditor } from './active.js';

package/dist/_pkgs/store/extension/history/history-extension.d.ts

@@ -1,7 +1,7 @@
 import { Subject } from 'rxjs';
 import * as Y from 'yjs';
-import type { Store } from '../../model';
-import { StoreExtension } from '../store-extension';
+import type { Store } from '../../model/index.js';
+import { StoreExtension } from '../store-extension.js';
 export declare class HistoryExtension extends StoreExtension {
     static readonly key = "history";
     private readonly _history;

package/dist/_pkgs/store/extension/history/history-extension.js

@@ -1,7 +1,7 @@
 import { signal } from '@preact/signals-core';
 import { Subject } from 'rxjs';
 import * as Y from 'yjs';
-import { StoreExtension } from '../store-extension';
+import { StoreExtension } from '../store-extension.js';
 export class HistoryExtension extends StoreExtension {
     static { this.key = 'history'; }
     constructor(store) {

package/dist/_pkgs/store/extension/history/index.d.ts

@@ -1 +1 @@
-export * from './history-extension';
+export * from './history-extension.js';

package/dist/_pkgs/store/extension/history/index.js

@@ -1 +1 @@
-export * from './history-extension';
+export * from './history-extension.js';

package/dist/_pkgs/store/extension/index.d.ts

@@ -1,6 +1,6 @@
-export * from './extension';
-export * from './history';
-export * from './schema';
-export * from './selection';
-export * from './store-extension';
-export * from './workspace';
+export * from './extension.js';
+export * from './history/index.js';
+export * from './schema.js';
+export * from './selection/index.js';
+export * from './store-extension.js';
+export * from './workspace/index.js';

package/dist/_pkgs/store/extension/index.js

@@ -1,6 +1,6 @@
-export * from './extension';
-export * from './history';
-export * from './schema';
-export * from './selection';
-export * from './store-extension';
-export * from './workspace';
+export * from './extension.js';
+export * from './history/index.js';
+export * from './schema.js';
+export * from './selection/index.js';
+export * from './store-extension.js';
+export * from './workspace/index.js';

package/dist/_pkgs/store/extension/schema.d.ts

@@ -1,5 +1,5 @@
-import type { BlockSchemaType } from '../model/block/zod';
-import type { ExtensionType } from './extension';
+import type { BlockSchemaType } from '../model/block/zod.js';
+import type { ExtensionType } from './extension.js';
 export declare const BlockSchemaIdentifier: import("../../global/di/types.js").ServiceIdentifier<{
     version: number;
     model: {

package/dist/_pkgs/store/extension/selection/base.d.ts

@@ -1,4 +1,4 @@
-import type { SelectionConstructor } from './types';
+import type { SelectionConstructor } from './types.js';
 export type BaseSelectionOptions = {
     blockId: string;
 };

package/dist/_pkgs/store/extension/selection/identifier.d.ts

@@ -1,4 +1,4 @@
-import type { ExtensionType } from '../extension';
-import type { SelectionConstructor } from './types';
+import type { ExtensionType } from '../extension.js';
+import type { SelectionConstructor } from './types.js';
 export declare const SelectionIdentifier: import("../../../global/di/types.js").ServiceIdentifier<SelectionConstructor<import("./base.js").BaseSelection>> & (<U extends SelectionConstructor<import("./base.js").BaseSelection> = SelectionConstructor<import("./base.js").BaseSelection>>(variant: import("../../../global/di/types.js").ServiceVariant) => import("../../../global/di/types.js").ServiceIdentifier<U>);
 export declare function SelectionExtension(selectionCtor: SelectionConstructor): ExtensionType;

package/dist/_pkgs/store/extension/selection/index.d.ts

@@ -1,4 +1,4 @@
-export * from './base';
-export * from './identifier';
-export * from './selection-extension';
-export * from './types';
+export * from './base.js';
+export * from './identifier.js';
+export * from './selection-extension.js';
+export * from './types.js';

package/dist/_pkgs/store/extension/selection/index.js

@@ -1,4 +1,4 @@
-export * from './base';
-export * from './identifier';
-export * from './selection-extension';
-export * from './types';
+export * from './base.js';
+export * from './identifier.js';
+export * from './selection-extension.js';
+export * from './types.js';

package/dist/_pkgs/store/extension/selection/selection-extension.d.ts

@@ -1,7 +1,7 @@
 import { Subject } from 'rxjs';
-import { StoreExtension } from '../store-extension';
-import type { BaseSelection } from './base';
-import type { SelectionConstructor } from './types';
+import { StoreExtension } from '../store-extension.js';
+import type { BaseSelection } from './base.js';
+import type { SelectionConstructor } from './types.js';
 export declare class StoreSelectionExtension extends StoreExtension {
     static readonly key = "selection";
     private readonly _id;

package/dist/_pkgs/store/extension/selection/selection-extension.js

@@ -1,9 +1,9 @@
 import { BlockSuiteError, ErrorCode } from '../../../global/exceptions/index.js';
 import { computed, signal } from '@preact/signals-core';
 import { Subject } from 'rxjs';
-import { nanoid } from '../../utils/id-generator';
-import { StoreExtension } from '../store-extension';
-import { SelectionIdentifier } from './identifier';
+import { nanoid } from '../../utils/id-generator.js';
+import { StoreExtension } from '../store-extension.js';
+import { SelectionIdentifier } from './identifier.js';
 export class StoreSelectionExtension extends StoreExtension {
     constructor() {
         super(...arguments);

package/dist/_pkgs/store/extension/selection/types.d.ts

@@ -1,4 +1,4 @@
-import type { BaseSelection } from './base';
+import type { BaseSelection } from './base.js';
 export interface SelectionConstructor<T extends BaseSelection = BaseSelection> {
     type: string;
     group: string;

package/dist/_pkgs/store/extension/store-extension.d.ts

@@ -1,6 +1,6 @@
 import { type Container } from '../../global/di/index.js';
-import type { Store } from '../model/store';
-import { Extension } from './extension';
+import type { Store } from '../model/store/index.js';
+import { Extension } from './extension.js';
 export declare const StoreExtensionIdentifier: import("../../global/di/types.js").ServiceIdentifier<StoreExtension> & (<U extends StoreExtension = StoreExtension>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
 export declare const storeExtensionSymbol: unique symbol;
 /**

package/dist/_pkgs/store/extension/store-extension.js

@@ -1,8 +1,8 @@
 var _a;
 import { createIdentifier } from '../../global/di/index.js';
 import { BlockSuiteError, ErrorCode } from '../../global/exceptions/index.js';
-import { StoreIdentifier } from '../model/store/identifier';
-import { Extension } from './extension';
+import { StoreIdentifier } from '../model/store/identifier.js';
+import { Extension } from './extension.js';
 export const StoreExtensionIdentifier = createIdentifier('StoreExtension');
 export const storeExtensionSymbol = Symbol('StoreExtension');
 /**

package/dist/_pkgs/store/extension/workspace/doc.d.ts

@@ -1,6 +1,6 @@
 import type * as Y from 'yjs';
-import type { Store, StoreOptions, YBlock } from '../../model';
-import type { AwarenessStore } from '../../yjs';
+import type { Store, StoreOptions, YBlock } from '../../model/index.js';
+import type { AwarenessStore } from '../../yjs/index.js';
 import type { Workspace } from './workspace.js';
 import type { DocMeta } from './workspace-meta.js';
 export type GetStoreOptions = Omit<StoreOptions, 'schema' | 'doc'>;

package/dist/_pkgs/store/extension/workspace/index.d.ts

@@ -1,3 +1,3 @@
-export * from './doc';
-export * from './workspace';
-export * from './workspace-meta';
+export * from './doc.js';
+export * from './workspace.js';
+export * from './workspace-meta.js';

package/dist/_pkgs/store/extension/workspace/index.js

@@ -1,3 +1,3 @@
-export * from './doc';
-export * from './workspace';
-export * from './workspace-meta';
+export * from './doc.js';
+export * from './workspace.js';
+export * from './workspace-meta.js';

package/dist/_pkgs/store/extension/workspace/workspace.d.ts

@@ -2,7 +2,7 @@ import type { BlobEngine } from '../../../sync/index.js';
 import type { Subject } from 'rxjs';
 import type { Awareness } from 'y-protocols/awareness.js';
 import type * as Y from 'yjs';
-import type { IdGenerator } from '../../utils/id-generator';
+import type { IdGenerator } from '../../utils/id-generator.js';
 import type { Doc } from './doc.js';
 import type { WorkspaceMeta } from './workspace-meta.js';
 export interface Workspace {

package/dist/_pkgs/store/impls/doc.d.ts

@@ -0,0 +1,45 @@
+import * as Y from 'yjs';
+import type { Doc, GetStoreOptions, Workspace } from '../extension/index.js';
+import type { YBlock } from '../model/block/types.js';
+import type { AwarenessStore } from '../yjs/index.js';
+type DocOptions = {
+    id: string;
+    collection: Workspace;
+    doc: Y.Doc;
+    awarenessStore: AwarenessStore;
+};
+export declare class DocImpl implements Doc {
+    private readonly _collection;
+    private readonly _storeContainer;
+    private readonly _initSubDoc;
+    private _loaded;
+    private readonly _onSubdocEvent;
+    /** Indicate whether the block tree is ready */
+    private _ready;
+    protected readonly _yBlocks: Y.Map<YBlock>;
+    /**
+     * @internal Used for convenient access to the underlying Yjs map,
+     * can be used interchangeably with ySpace
+     */
+    protected readonly _ySpaceDoc: Y.Doc;
+    readonly awarenessStore: AwarenessStore;
+    readonly id: string;
+    readonly rootDoc: Y.Doc;
+    get blobSync(): import("../../sync/index.js").BlobEngine;
+    get workspace(): Workspace;
+    get isEmpty(): boolean;
+    get loaded(): boolean;
+    get meta(): import("../index.js").DocMeta | undefined;
+    get ready(): boolean;
+    get spaceDoc(): Y.Doc;
+    get yBlocks(): Y.Map<YBlock>;
+    constructor({ id, collection, doc, awarenessStore }: DocOptions);
+    clear(): void;
+    get removeStore(): ({ readonly, query, id }: import("../index.js").RemoveStoreOptions) => void;
+    private _destroy;
+    dispose(): void;
+    getStore({ readonly, query, provider, extensions, id, }?: GetStoreOptions): import("../index.js").Store;
+    load(initFn?: () => void): this;
+    remove(): void;
+}
+export {};

package/dist/_pkgs/store/impls/doc.js

@@ -0,0 +1,110 @@
+import * as Y from 'yjs';
+import { StoreContainer } from '../model/index.js';
+export class DocImpl {
+    get blobSync() {
+        return this.workspace.blobSync;
+    }
+    get workspace() {
+        return this._collection;
+    }
+    get isEmpty() {
+        return this._yBlocks.size === 0;
+    }
+    get loaded() {
+        return this._loaded;
+    }
+    get meta() {
+        return this.workspace.meta.getDocMeta(this.id);
+    }
+    get ready() {
+        return this._ready;
+    }
+    get spaceDoc() {
+        return this._ySpaceDoc;
+    }
+    get yBlocks() {
+        return this._yBlocks;
+    }
+    constructor({ id, collection, doc, awarenessStore }) {
+        this._initSubDoc = () => {
+            let subDoc = this.rootDoc.getMap('spaces').get(this.id);
+            if (!subDoc) {
+                subDoc = new Y.Doc({
+                    guid: this.id,
+                });
+                this.rootDoc.getMap('spaces').set(this.id, subDoc);
+                this._loaded = true;
+            }
+            else {
+                this._loaded = false;
+                this.rootDoc.on('subdocs', this._onSubdocEvent);
+            }
+            return subDoc;
+        };
+        this._onSubdocEvent = ({ loaded, }) => {
+            const result = Array.from(loaded).find(doc => doc.guid === this._ySpaceDoc.guid);
+            if (!result) {
+                return;
+            }
+            this.rootDoc.off('subdocs', this._onSubdocEvent);
+            this._loaded = true;
+        };
+        /** Indicate whether the block tree is ready */
+        this._ready = false;
+        this.id = id;
+        this.rootDoc = doc;
+        this.awarenessStore = awarenessStore;
+        this._ySpaceDoc = this._initSubDoc();
+        this._yBlocks = this._ySpaceDoc.getMap('blocks');
+        this._collection = collection;
+        this._storeContainer = new StoreContainer(this);
+    }
+    clear() {
+        this._yBlocks.clear();
+    }
+    get removeStore() {
+        return this._storeContainer.removeStore;
+    }
+    _destroy() {
+        this._ySpaceDoc.destroy();
+        this._loaded = false;
+    }
+    dispose() {
+        if (this.ready) {
+            this._yBlocks.clear();
+        }
+    }
+    getStore({ readonly, query, provider, extensions, id, } = {}) {
+        const storeExtensions = this.workspace.storeExtensions.concat(extensions ?? []);
+        let storeId;
+        if (id) {
+            storeId = id;
+        }
+        else if (readonly !== undefined || query) {
+            storeId = id;
+        }
+        else {
+            storeId = this.spaceDoc.guid;
+        }
+        return this._storeContainer.getStore({
+            id: storeId,
+            readonly,
+            query,
+            provider,
+            extensions: storeExtensions,
+        });
+    }
+    load(initFn) {
+        if (this.ready) {
+            return this;
+        }
+        this._ySpaceDoc.load();
+        initFn?.();
+        this._ready = true;
+        return this;
+    }
+    remove() {
+        this._destroy();
+        this.rootDoc.getMap('spaces').delete(this.id);
+    }
+}

package/dist/_pkgs/store/impls/index.d.ts

@@ -0,0 +1,4 @@
+export { DocImpl } from './doc.js';
+export { type DocCollectionOptions, type WorkspaceOptions, } from './workspace-base.js';
+export { WorkspaceImpl } from './workspace.js';
+export { WorkspaceMetaImpl } from './workspace-meta.js';

package/dist/_pkgs/store/impls/index.js

@@ -0,0 +1,4 @@
+export { DocImpl } from './doc.js';
+export {} from './workspace-base.js';
+export { WorkspaceImpl } from './workspace.js';
+export { WorkspaceMetaImpl } from './workspace-meta.js';

package/dist/_pkgs/store/impls/workspace-base.d.ts

@@ -0,0 +1,81 @@
+import { AwarenessEngine, type AwarenessSource, BlobEngine, type BlobSource, DocEngine, type DocSource } from '../../sync/index.js';
+import { Subject } from 'rxjs';
+import * as Y from 'yjs';
+import type { Doc, ExtensionType, Workspace, WorkspaceMeta } from '../extension/index.js';
+import { type IdGenerator } from '../utils/id-generator.js';
+import { AwarenessStore } from '../yjs/index.js';
+import { DocImpl } from './doc.js';
+export type WorkspaceOptions = {
+    id?: string;
+    idGenerator?: IdGenerator;
+    docSources?: {
+        main: DocSource;
+        shadows?: DocSource[];
+    };
+    blobSources?: {
+        main: BlobSource;
+        shadows?: BlobSource[];
+    };
+    awarenessSources?: AwarenessSource[];
+};
+/** @deprecated Kept for backward compatibility; use {@link WorkspaceOptions}. */
+export type DocCollectionOptions = WorkspaceOptions;
+/**
+ * @internal
+ * The self-contained {@link Workspace} implementation shared by the public
+ * {@link WorkspaceImpl} and the test-only `TestWorkspace`. It owns its root
+ * `Y.Doc` and wires `DocEngine`/`AwarenessEngine`/`BlobEngine` from the given
+ * sources — defaulting to in-memory no-ops. Consumers that persist/sync do so
+ * on the exposed `Y.Doc`s (see `.doc` and `getDoc(...).spaceDoc`), or by
+ * passing real `docSources`/`blobSources`.
+ *
+ * Not part of any public entry point; import {@link WorkspaceImpl} instead.
+ */
+export declare class WorkspaceBase implements Workspace {
+    storeExtensions: ExtensionType[];
+    readonly awarenessStore: AwarenessStore;
+    readonly awarenessSync: AwarenessEngine;
+    readonly blobSync: BlobEngine;
+    readonly blockCollections: Map<string, DocImpl>;
+    readonly doc: Y.Doc;
+    readonly docSync: DocEngine;
+    readonly id: string;
+    readonly idGenerator: IdGenerator;
+    meta: WorkspaceMeta;
+    slots: {
+        docListUpdated: Subject<void>;
+    };
+    get docs(): Map<string, DocImpl>;
+    constructor({ id, idGenerator, awarenessSources, docSources, blobSources, }?: WorkspaceOptions);
+    private _bindDocMetaEvents;
+    private _hasDoc;
+    /**
+     * Verify that all data has been successfully saved to the primary storage.
+     * Return true if the data transfer is complete and it is secure to terminate the synchronization operation.
+     */
+    canGracefulStop(): void;
+    /**
+     * By default, only an empty doc will be created.
+     * If the `init` parameter is passed, a `surface`, `note`, and `paragraph` block
+     * will be created in the doc simultaneously.
+     */
+    createDoc(docId?: string): Doc;
+    dispose(): void;
+    /**
+     * Terminate the data sync process forcefully, which may cause data loss.
+     * It is advised to invoke `canGracefulStop` before calling this method.
+     */
+    forceStop(): void;
+    getBlockCollection(docId: string): DocImpl | null;
+    getDoc(docId: string): Doc | null;
+    removeDoc(docId: string): void;
+    /**
+     * Start the data sync process
+     */
+    start(): void;
+    /**
+     * Wait for all data has been successfully saved to the primary storage.
+     */
+    waitForGracefulStop(abort?: AbortSignal): Promise<void>;
+    waitForSynced(): Promise<unknown>;
+}