@dialecte/core 0.7.0 → 0.8.1

package/dist/project/project.d.ts

@@ -1,5 +1,5 @@
 import { Document, ExtensionModules, MergedExtensions, QueryExtensions, Query } from '../document';
-import { InitEmptyDocumentOptions, ImportDocumentOptions, ImportedDocument, ImportEntry, ExportDocumentOptions, ExportBlobOptions, ExportBlobResult, ProjectParams, ProjectState, DocumentRecord } from './types';
+import { InitEmptyDocumentOptions, ImportDocumentOptions, ImportFilesOptions, ImportedDocument, ImportEntry, ProjectExportParams, ProjectExportResult, ProjectExportResultMaybeDocument, ProjectExportResultWithDocument, ProjectExportBlobParams, ExportBlobResult, ProjectParams, ProjectState, DocumentRecord } from './types';
 import { Perf } from '../perf';
 import { Store } from '../store';
 import { AnyDialecteConfig, BlobAttachment, BlobRecord, DialecteHooks } from '../types';
@@ -11,7 +11,10 @@ import { AnyDialecteConfig, BlobAttachment, BlobRecord, DialecteHooks } from '..
  */
 export declare class Project<GenericConfig extends AnyDialecteConfig, GenericModules extends ExtensionModules = Record<never, never>, GenericStore extends Store = Store> {
     private _name?;
+    /** The store of the project last opened: open, or closed once `closing`. */
     private _store?;
+    /** The store of an `open` it refused, closed again: kept only for `destroy()`, the reset of that project. */
+    private refusedStore?;
     /**
      * The project channel: posts this realm's mutations and listens for other
      * realms' (other tab / iframe / second Project instance). BroadcastChannel
@@ -22,17 +25,49 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
     private _channel?;
     /** Set once close()/destroy() begins, to stop new channel-triggered store work. */
     private closing;
-    /** While open: the imports whose heartbeat went stale are swept every `STALE_IMPORT_MS`. */
-    private staleSweep?;
+    /**
+     * Whether the open store announces its changes itself (`Store.subscribe`): the Project then hears them from it,
+     * reposts the other connections' on a channel of its own, and posts its own only when the store told one.
+     */
+    private announcing;
+    /** The store's notices let go: called as the open project closes. */
+    private stopStoreNotices;
+    /**
+     * The changes the store told as this Project's own, waiting for the call that made them to post them (none waiting:
+     * a call changed nothing). Each post takes them all: the call's own posted as the call tells it, the others as the
+     * store told them, folded too (a change no call of the Project's own waits for is folded then).
+     */
+    private ownChangesTold;
+    /**
+     * The open's documents read: calls are taken from then on, and the changes told meanwhile - its own and other
+     * connections' - fold into a state that holds them.
+     */
+    private openSettled;
+    /** Every change told while the project opens, its own and other connections', in the order told: folded once open. */
+    private toldWhileOpening;
+    /** A resync told while the project opens, or more changes than held: its state read again once the open settled. */
+    private resyncWhenSettled;
+    /** The name of the open project's channel (`projectChannelName`), set as it opens. */
+    private _channelName?;
     /** In-flight fire-and-forget work triggered by foreign messages, awaited on teardown. */
     private readonly pendingBroadcastWork;
     private readonly storage;
+    /**
+     * The dialecte the project belongs to (its declaration's `id`), when its factory said: with the name, which
+     * project a store holds. `undefined` for a Project made with no dialecte.
+     */
+    readonly dialecteId: string | undefined;
+    /** The dialecte's version and its engine worker's address, from its factory: what `sqlite` storage runs. */
+    private readonly dialecteVersion;
+    private readonly engineUrl;
     private configs;
     private defaultConfigKey;
     private mergedExtensions?;
     private hooks?;
     /** Single project-lived dev perf helper; frozen no-op unless `dev.perf`. */
     readonly perf: Perf;
+    /** Whether `dev.perf` is on: the store then hands back the timings of each import it runs. */
+    private readonly perfEnabled;
     get name(): string;
     /** The store of an open project: one never opened, closed or destroyed has none to read or write. */
     private get store();
@@ -43,22 +78,91 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
     private importChain;
     /** Run `work` once every import queued before it has settled: one file in flight per project. */
     private enqueueImport;
+    /** The imports queued and not settled yet, the one running included: what a close says it waits for. */
+    private readonly importsInFlight;
+    /**
+     * The Project's `open`, `close` and `destroy`, one at a time in the order called: each runs once the one
+     * called before it has settled, however it settled.
+     */
+    private lifecycle;
+    /** How many times a project was opened in this Project: what a batch import or a Document belongs to. */
+    private opens;
+    /** How many opens, closes and destroys are called and not settled yet, the one running included. */
+    private lifecycleTurns;
+    /** Run `work` in its turn among the Project's opens, closes and destroys. */
+    private inLifecycleTurn;
+    /**
+     * The writes of the open project running (a document made or removed, an undo, a redo, a blob's
+     * change): the whole close waits for them, as for the imports, before it closes the store.
+     */
+    private readonly writes;
+    /** A write of the open project counted in `writes` until the function answered is called (once). */
+    private startCountedWrite;
+    /** Run a write of the open project, counted in `writes`; it reads the store at the call. */
+    private counted;
     /** Resolved once every import queued so far has settled, however it settled. */
     private settledImports;
     private get channel();
     /**
      * Name of this project's BroadcastChannel — the public event contract.
      * Open your own instance (see createChannel) to receive every
-     * ProjectChannelMessage, same-tab and cross-tab.
+     * ProjectChannelEvent (each change, and a resync), same-tab and cross-tab.
      */
     get channelName(): string;
     /**
      * Convenience: a fresh BroadcastChannel on this project's channel.
      * The caller owns it — call channel.close() when done listening.
+     *
+     * @intent listen to project events, receive commits and imports made in other tabs
      */
     createChannel(): BroadcastChannel;
-    /** Post a message on the project channel. */
+    /**
+     * Post a change of this Project's on the project channel. On a store that announces, only what the store told: the
+     * call's own change when the store told it (none: the call changed nothing, nothing posted), and every other change
+     * of the Project's own told meanwhile (a call running beside it, a second step of the same call), each once.
+     */
     private broadcast;
+    /**
+     * Post the changes of this Project's own the store told, each once: `own` (the call's change, its state already
+     * updated) posted as the call made it when told; every other folded into the state, then posted. Without `own`, as
+     * after a write refused with its engine lost: only what the store told is posted, nothing guessed.
+     */
+    private postToldChanges;
+    /**
+     * A notice of the open store: another connection's change folded into this Project's state and reposted to its
+     * listeners; its own kept, posted once the call that made it has updated the state - or, folded, once no call runs
+     * (a write on the store held directly, a call that ended without posting), or at once past `CHANGES_HELD_MAX` (then
+     * before a running call's state holds its own); a resync reads it all again. While the project opens, every change
+     * is held until its documents are read (`holdWhileOpening`). A fold no call awaits that fails (a Document's
+     * subscriber throwing, the store refusing a read) is reported on the console.
+     */
+    private onStoreNotice;
+    /** Another Project's change heard on the name's channel (a store that announces nothing): folded once open. */
+    private onChannelHeard;
+    /**
+     * A change told while the project opens, held: the open reads its documents meanwhile, and a change folded now
+     * would find no entry, or be undone by that read; no call is taken that would claim it. Folded, in the order told,
+     * once the open settled - past `CHANGES_HELD_MAX`, or a resync told meanwhile, the state read again instead.
+     */
+    private holdWhileOpening;
+    /**
+     * A change no call claims folded into this Project's state - reposted first to its listeners where the store
+     * announces (elsewhere the change came on the channel they hear).
+     */
+    private foldTold;
+    /** Whether a call of this Project runs, which posts the changes its store tells it: a write, a Document's commit, an import. */
+    private callsRunning;
+    /**
+     * The changes of this Project's own kept, once no call runs to post them (none made them, or the one that did
+     * ended without posting - a transaction that threw): posted and folded on a microtask. A call running then claims
+     * them instead, posting them once its state holds its own.
+     */
+    private drainWhenIdle;
+    private postUnclaimedChanges;
+    /** Whether the open Project posts what no call claims: once its open settled (its documents read), not while it closes. */
+    private canPost;
+    /** Changes may have been missed: the registry, each document's history read again, every document's view woken. */
+    private resync;
     readonly state: ProjectState;
     /**
      * In-realm reactive registry, keyed by documentId (parallel to `state.documents`).
@@ -71,6 +175,10 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
      */
     private readonly stateSubscribers;
     private subscribeState;
+    /**
+     * Every subscriber of the document told, one that throws stopping no other; the first failure thrown once all are
+     * told - the call that changed the document fails with it, a fold no call awaits reports it.
+     */
     private signalStateChange;
     constructor(params: {
         configs: Record<string, GenericConfig>;
@@ -84,12 +192,31 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
         dev?: {
             perf?: boolean;
         };
+        dialecteId?: ProjectParams<GenericConfig>['dialecteId'];
+        dialecteVersion?: ProjectParams<GenericConfig>['dialecteVersion'];
+        engineUrl?: ProjectParams<GenericConfig>['engineUrl'];
     });
     /**
      * Open a named project: resolve store, open DB connection, hydrate state.
      * Must be called before import/export/openDocument.
+     *
+     * Runs in turn with the Project's other `open`, `close` and `destroy` calls. On a Project already open -
+     * on another project or on the same one - it first closes it as `close()` does, and a call made from the
+     * `open` call on is refused until the last `open`, `close` or `destroy` called has settled; a Document of that
+     * open answers `STORE_CLOSED` when the store is made for each open (`local`, `sqlite`, `inMemory`) - a `custom` store is
+     * the same one opened again: open the Documents again. An open whose store refuses, or whose documents cannot
+     * be read, leaves the Project closed; `destroy()` on it still removes that project (the reset of
+     * `PROJECT_DATABASE_LOST`), then `open` makes it again, empty.
+     *
+     * Never await `open`, `close` or `destroy` inside a hook or a transaction callback: the close waits for that
+     * work, which waits for the close (after 10 seconds the console says what it waits for).
+     *
+     * @intent open or create a project database, start working on a project, reopen a project after close
      */
     open(name: string): Promise<this>;
+    private openNow;
+    /** The store of the project named, resolved from the storage option and never opened here. */
+    private resolveProjectStore;
     /**
      * Fold an incoming channel message into project state. This realm never
      * receives its own posts (BroadcastChannel withholds them from the posting
@@ -97,33 +224,80 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
      * iframe, or a second Project instance. Local mutations maintain state inline.
      */
     private onChannelMessage;
+    /** The open store's notices let go. */
+    private stopListeningToStore;
     /**
      * Track channel-triggered fire-and-forget work so `close`/`destroy` can wait for
      * it to settle before tearing down the store. A foreign message delivered as the
      * project is closing would otherwise read or reconcile the store after it was
-     * closed/deleted — surfacing as DatabaseClosedError or ConstraintError. The work
-     * keeps its own error swallowing; here it is only awaited, never rethrown.
+     * closed/deleted — surfacing as DatabaseClosedError or ConstraintError. A failure
+     * is reported unless the project closes; never rethrown.
      */
     private trackBroadcastWork;
+    /**
+     * A change of its store no call awaits, failing as it is folded in - a Document's subscriber throwing, or the store
+     * refusing a read: told on the console, the other changes folded all the same.
+     */
+    private reportFoldFailure;
+    /** A document's registry entry read again (another view renamed or moved it): its view woken. */
+    private refreshDocumentRecord;
     /** Recompute canUndo/canRedo for a document from the store's history. */
     private refreshHistoryStatus;
+    /** A document's canUndo/canRedo read from `store` into its entry (the open's own read, before calls are taken). */
+    private readHistoryStatus;
     /**
-     * Close the store and release resources, once the imports in flight have landed - they
-     * broadcast on the live channel. From the call on, the project is closed: a new call throws
-     * `PROJECT_NOT_OPENED`.
+     * Close the store and release resources, once the imports in flight (running and queued), the project's
+     * writes running (a Document's transaction or prepared commit included) and the work other realms' messages
+     * started have settled. Then the channel and the store
+     * are closed, `state.documents` is emptied and the Documents' subscriptions are dropped. From the call on,
+     * the project is closed: a new call throws `PROJECT_NOT_OPENED`, a Document opened before answers
+     * `STORE_CLOSED` (on a `custom` store opened again it writes but tells nothing: open it again). The stored documents stay.
+     * Runs in turn with the Project's other `open`, `close` and `destroy` calls.
+     *
+     * Never await it inside a hook or a transaction callback: the close waits for that work, which waits for it.
+     * An import whose dialecte hook never settles keeps it waiting too (nothing aborts a hook): after
+     * `CLOSE_WAIT_REPORT_MS` the console names the files of the imports it waits for.
+     *
+     * @intent close a project, release the database connection when leaving a page
      */
     close(): Promise<void>;
+    /** The whole close of an open project (the channel is there only while one is); nothing when none is open. */
+    private closeNow;
     /**
-     * Destroy the project - deletes the database entirely, once the imports in flight have landed.
+     * What a close still waits for, told once on the console - the files of the imports by name: a close that
+     * never ends is an import whose dialecte hook never settles, or a call awaited inside the work it waits for.
+     */
+    private reportCloseWait;
+    /**
+     * Destroy the project - deletes the database entirely, every document with its history and blobs,
+     * once the imports in flight have landed; refused `PROJECT_OPEN_ELSEWHERE`, nothing removed, while another
+     * connection - a project or store of the name, in this page or another tab - has it open. To delete one
+     * document, use `removeDocument`.
+     *
+     * The project destroyed is the one this Project last opened, or the one whose `open` its store refused
+     * (`PROJECT_DATABASE_LOST`): that store is not opened again, and `open` then makes the project again, empty.
+     * Refused, the project is closed all the same, as by `close()`: a `destroy()` called again once the other
+     * connection closed removes it.
+     * Runs in turn with the Project's other `open`, `close` and `destroy` calls.
+     *
+     * Never await it inside a hook or a transaction callback: the close waits for that work, which waits for it.
+     *
+     * @intent delete a whole project, wipe the project database with every document
      */
     destroy(): Promise<void>;
+    private destroyNow;
     /**
      * Register a new empty document in the project.
      * Returns the new documentId. Records are added later via import or transactions.
+     *
+     * @intent create a new empty document, start a document from scratch without a file
      */
     initEmptyDocument(options?: InitEmptyDocumentOptions): Promise<string>;
     /**
-     * Remove a file and all its records.
+     * Remove one document from the project - its records, history and blobs - and tell other tabs. The
+     * other documents stay.
+     *
+     * @intent delete a document from the project, remove one file and its records
      */
     removeDocument(documentId: string): Promise<void>;
     /**
@@ -136,30 +310,69 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
      * Import Files into the project: one entry per file, in the order given. The files are imported
      * one after the other - memory is bounded by one file's batches, the registry sees one import -
      * and a file that fails is its own `failed` entry, the next file still attempted: nothing of a
-     * failed file lands. The call itself rejects only for what is about the call: an unknown
-     * `configKey`, a project not open.
+     * failed file lands (but an import whose engine was lost after it landed: see `importFile`). The call itself rejects only for what is about the call: an unknown
+     * `configKey`, a project not open, a `path` (`DOCUMENT_PATH_INVALID`: a path names one file,
+     * `importFile` takes it).
+     *
+     * @intent import several XML files at once, get one result per file without a throw for a failed file
      */
-    import(files: File[], options?: ImportDocumentOptions): Promise<ImportEntry[]>;
+    import(files: File[], options?: ImportFilesOptions): Promise<ImportEntry[]>;
     /**
-     * Import one File into the project: register, parse XML, persist records. The document is in
-     * the project state and broadcast once its last record is stored; whatever fails before that
-     * removes it again and is thrown (`PARSE_ERROR` for a malformed file). One file is in flight
-     * per project: a call made while another import runs waits for it.
+     * Import one File into the project: the store registers, parses and stores it next to the data.
+     * The document is in the project state and broadcast once the store answers it `ready`; whatever
+     * fails before that, or an abort through `options.signal`, leaves nothing and is thrown
+     * (`PARSE_ERROR` for a malformed file, `IMPORT_ABORTED`, `IMPORT_FAILED` wrapping a foreign
+     * error). One refusal leaves its document: an import whose engine was lost after it landed is
+     * refused `STORE_ENGINE_LOST`, `meta.outcome` `applied`, its document in the state and broadcast. `options.onProgress` is told after each stored batch, never awaited. One file is in
+     * flight per project: a call made while another import runs waits for it.
+     *
+     * @intent import an XML file, load a file into the project, parse XML into records
      */
     importFile(file: File, options?: ImportDocumentOptions): Promise<ImportedDocument>;
     private importOne;
     /**
-     * Export a document as an XMLDocument built from stored records.
+     * A write of the project with no id to ask its outcome by (an undo, a redo, a removal): refused `STORE_ENGINE_LOST`
+     * it may have landed, so the project's documents (and the document's history) are read again before the refusal is
+     * thrown - never made again. The change the store told before its engine went is posted to the listeners.
+     */
+    private writeOrReadAgain;
+    /**
+     * An import refused `STORE_ENGINE_LOST`: its outcome asked once by its id; landed, its document read into the
+     * project's state (its diagnostics went with the lost answer, so it is no entry) and posted to the listeners - the
+     * refusal says which outcome, and the document it made (none when the documents could not be read again).
+     */
+    private lostImportError;
+    /**
+     * Export a document through the store: its file (`Blob`, formatted unless `indent: false`) and filename. On the
+     * page, `xmlDocument: true` also answers its DOM (parsed from the compact file: pass `indent: false` to export
+     * once) and `download` saves the formatted file (the save dialog is asked first). Two store exports made for one
+     * call may see two states of the document if a commit lands between them.
+     *
+     * @intent export a document to an XML file, get a document as a Blob, download a document, save a document as XML, read the exported XML as a DOM
+     */
+    export(params: ProjectExportParams & {
+        xmlDocument: true;
+    }): Promise<ProjectExportResultWithDocument>;
+    export(params: ProjectExportParams & {
+        xmlDocument?: false;
+    }): Promise<ProjectExportResult>;
+    export(params: ProjectExportParams): Promise<ProjectExportResultMaybeDocument>;
+    /**
+     * The documents of the project; one still importing - here or in another realm - is not among them.
+     *
+     * @intent list the documents of a project, show the files a project holds
      */
-    export(documentId: string, options?: ExportDocumentOptions): Promise<{
-        xmlDocument: XMLDocument;
-        filename: string;
-    }>;
-    /** The documents of the project; one still importing - here or in another realm - is not among them. */
     getDocuments(): Promise<DocumentRecord[]>;
+    /**
+     * The metadata record of one document of the project, or `undefined` when it is unknown or still importing.
+     *
+     * @intent check a document exists, read a document's name or config key by id
+     */
     getDocument(documentId: string): Promise<DocumentRecord | undefined>;
     /**
      * Open a file-scoped Document for querying and mutating a specific file.
+     *
+     * @intent open a document to read or write it, get the Document of an id
      */
     openDocument(documentId: string): Document<GenericConfig, MergedExtensions<GenericModules>>;
     /**
@@ -174,52 +387,123 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
      * arrives in another realm, even before the import broadcast has been folded
      * in. Returns `{ live: false, ready: false }` for an unknown document rather
      * than throwing.
+     *
+     * @intent check that a document imported in another tab can be opened, wait for a document from another realm
      */
     getDocumentStatus(documentId: string): Promise<{
         live: boolean;
         ready: boolean;
     }>;
     /**
-     * Get the config for a specific file.
+     * Get the dialecte config a document uses, or `undefined` for a document the project does not know.
+     *
+     * @intent get the dialecte config of a document, know which schema a document uses
      */
     getDocumentConfig(documentId: string): GenericConfig | undefined;
+    /**
+     * Revert the last committed transaction of a document and tell other tabs. Does nothing when there is nothing to undo.
+     *
+     * @intent undo the last change to a document, roll back a commit
+     */
     undo(documentId: string): Promise<void>;
+    /**
+     * Re-apply the last undone transaction of a document and tell other tabs. Does nothing when there is nothing to redo.
+     *
+     * @intent redo an undone change to a document
+     */
     redo(documentId: string): Promise<void>;
     /**
      * Add a blob owned by `documentId`. The binary lives in `blob_{documentId}`.
      * Returns the generated blob id.
+     *
+     * @intent store a binary file in the project, add an attachment owned by a document
      */
     addBlob(documentId: string, file: File, attachedTo?: BlobAttachment[]): Promise<string>;
+    /**
+     * Read a stored blob: its metadata entry and its binary data, or `undefined` when the id is unknown.
+     *
+     * @intent read an attached file's content, load a blob by id
+     */
     getBlob(blobId: string): Promise<{
         entry: BlobRecord;
         data: Blob;
     } | undefined>;
     /**
-     * Export a blob from the store. Mirrors `export(documentId)` for blobs:
-     * returns `{ entry, data, filename }` and optionally triggers a download via
-     * `options.withDownload`.
+     * Export a blob from the store: `{ entry, data, filename }`; `download` also saves it (the save dialog, or a
+     * browser download), under its name or the one given.
+     *
+     * @intent download a stored file, save a blob to disk, read a blob with its file name
+     */
+    exportBlob(params: ProjectExportBlobParams): Promise<ExportBlobResult>;
+    /**
+     * The blobs referenced from a document (any of their attachments points into it).
+     *
+     * @intent list the files attached to a document
      */
-    exportBlob(blobId: string, options?: ExportBlobOptions): Promise<ExportBlobResult>;
     getBlobsByDocument(documentId: string): Promise<BlobRecord[]>;
+    /**
+     * The blobs referenced from one element of a document.
+     *
+     * @intent list the files attached to one element
+     */
     getBlobsByRecord(documentId: string, recordRef: string): Promise<BlobRecord[]>;
+    /**
+     * The blobs of the project that no document references (no attachment).
+     *
+     * @intent list unattached files, find orphan blobs to clean up
+     */
     getStandaloneBlobs(): Promise<BlobRecord[]>;
+    /**
+     * Reference an existing blob from an element of a document (optionally from one of its attributes) and tell other tabs.
+     *
+     * @intent link a stored file to an element, attach a blob to a record
+     */
     attachBlob(blobId: string, ref: BlobAttachment): Promise<void>;
+    /**
+     * Drop the reference from an element of a document to a blob; the blob itself stays stored.
+     *
+     * @intent unlink a file from an element, detach a blob from a record
+     */
     detachBlob(blobId: string, ref: {
         documentId: string;
         recordRef: string;
     }): Promise<void>;
+    /**
+     * Delete a blob and its binary data from the project and tell other tabs. Does nothing when the id is unknown.
+     *
+     * @intent delete a stored file, remove a blob for good
+     */
     removeBlob(blobId: string): Promise<void>;
     /**
      * Run a query function across all documents, return the first non-undefined result.
      * Iterates documents sequentially; stops at the first match.
+     *
+     * @intent find the first match across every document, search all documents of a project
      */
     queryFirst<Result>(queryFunction: (query: Query<GenericConfig> & QueryExtensions<MergedExtensions<GenericModules>>) => Promise<Result | undefined>): Promise<Result | undefined>;
     /**
      * Run a query function across all documents, collect and flatten results.
      * Iterates documents sequentially; merges all non-empty arrays.
+     *
+     * @intent collect results from every document, run one query over all documents
      */
     queryAll<Result>(queryFunction: (query: Query<GenericConfig> & QueryExtensions<MergedExtensions<GenericModules>>) => Promise<Result[]>): Promise<Result[]>;
-    /** Expose the underlying database instance. Return type is inferred from the store (Dexie for local storage). */
+    /**
+     * Visit each document of the open project in turn, until `visit` answers `true`: the ids taken at the call, a
+     * document removed meanwhile skipped; refused `PROJECT_NOT_OPENED` once that open closes or another one opens,
+     * never a partial answer or one mixing two opens.
+     */
+    private visitOpenDocuments;
+    /** Whether the open a Document was made in is still the open one, its channel there. */
+    private isCurrentOpen;
+    /** `PROJECT_NOT_OPENED` once the open a call was made in has closed, or another one opened. */
+    private refuseClosedOpen;
+    /**
+     * Expose the store's own database object, for debugging: the Dexie instance on `local` (cast it: the type is the
+     * store's, `unknown` unless the Project's store type is given), `null` on `sqlite` and `inMemory`.
+     *
+     * @intent inspect the underlying database, debug what the store holds
+     */
     getDatabaseInstance(): ReturnType<GenericStore['getDatabaseInstance']>;
     private refreshState;
     /**

package/dist/project/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"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"}

package/dist/project/state/document-lifecycle.d.ts

@@ -1,18 +1,6 @@
 import { DocumentRecord } from '../types';
-/** How often an import says it is still alive, through `DocumentRecord.importingAt`. */
-export declare const IMPORT_HEARTBEAT_MS = 2000;
-/**
- * An import whose last heartbeat is older than this was left by a realm that died (a tab closed
- * mid-import): `open()` removes it. Generous on purpose - a false "dead" loses a running import, a
- * false "alive" only keeps a hidden leftover a few minutes longer: a hidden tab's timers are
- * throttled to once a minute by the browser, and a dialecte's `afterImport` on a very large file
- * may hold the main thread for tens of seconds.
- */
-export declare const STALE_IMPORT_MS: number;
 /** A document whose records are still being stored - by this realm or another one. */
 export declare function isImporting(record: DocumentRecord): boolean;
-/** An import nobody is running any more: still `importing`, its heartbeat long gone. */
-export declare function isStaleImport(record: DocumentRecord, now?: number): boolean;
 /** The documents a project opens, lists and serves: nothing half-imported is ever visible. */
 export declare function openableDocuments(records: readonly DocumentRecord[]): DocumentRecord[];
 //# sourceMappingURL=document-lifecycle.d.ts.map

package/dist/project/state/document-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/project/state/document-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,OAAQ,CAAA;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAa,CAAA;AAEzC,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE3D;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,OAAO,CAE/E;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAEtF"}
+{"version":3,"file":"document-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/project/state/document-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE3D;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAEtF"}

package/dist/project/state/document-state.d.ts

@@ -1,11 +1,15 @@
 import { DocumentEntry, DocumentRecord } from '..';
 /**
  * Build the initial DocumentState for a newly registered document.
+ *
+ * @internal the project's in-memory document registry entry
  */
 export declare function buildDocumentState(document: DocumentRecord): DocumentEntry;
 /**
  * Reconcile in-memory document state Map with the current store contents.
  * Adds new documents, removes stale ones. Returns the mutated map for convenience.
+ *
+ * @internal the project's in-memory document registry sync
  */
 export declare function reconcileDocumentState(state: Map<string, DocumentEntry>, storeDocuments: DocumentRecord[]): Map<string, DocumentEntry>;
 //# sourceMappingURL=document-state.d.ts.map

package/dist/project/state/document-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-state.d.ts","sourceRoot":"","sources":["../../../src/project/state/document-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAW1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACjC,cAAc,EAAE,cAAc,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAgB5B"}
+{"version":3,"file":"document-state.d.ts","sourceRoot":"","sources":["../../../src/project/state/document-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAW1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACjC,cAAc,EAAE,cAAc,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAgB5B"}